New Business API
New Business
Value | |
---|---|
Method | POST |
URL | /newbusiness |
The requirements for the request are set out in the BNP documentation, including field lengths and allowed values.
Some guidelines are provided below to help with constructing the request.
Optional Sections
Depending on the setup of the product and the value of the request the following sections may not be needed for personal line application for an individual.
- Affordability
- Marketing
Mapping Extensions
Provides a set of helpers for mapping from alternative input lists.
Complete Request Example
{
"clientCode": "Provided by BNPP PF",
"shopCode": "Provided by BNPP PF",
"newBusinessRequestType": {
"application": {
"brokerReference": "BROKERREF01",
"accountNumber": null,
"insuranceType": 1,
"isRenewal": false,
"allowSearchAuthorisation": true,
"isCustomerPresent": true,
"hasCustomerDeclaration": true
},
"policy": {
"policyInceptionDate": "2020-11-04",
"policyRenewalDate": "2021-11-04",
"totalCashPrice": 1320.00,
"deposit": 132.00,
"creditProductCode": "TIN1",
"term": 10,
"preferredPaymentDay": 15,
"policyPremiumAmount": 132.00,
"brokerCreditFeeAmount": 10.0,
"brokerCreditFeeDescription": "fees",
"brokerFeeAmount": 120.0,
"brokerFeeAmountDescription": "discount applicable",
"addOnAmount": 5.0,
"addOnAmountDescription": "Heavy Duty",
"discountAmount": 1.0,
"discountAmountDescription": "Discount",
"premiumDescription": "1",
"policyType": 1,
"policyNumber": "mh-123456",
"insuranceCompany": "7",
"ropRateType": 1,
"isEdiFlag": false
},
"applicant": {
"customer": {
"title": "Mr",
"firstName": "Test01FN",
"lastName": "Test01LN",
"dateOfBirth": "1966-10-09",
"nationality": "GBR",
"countryOfBirth": "GBR",
"email": "[email protected]",
"policyholderName": "MW FORREST",
"address": {
"houseName": null,
"houseNumber": "1",
"streetName": "CROMWELL ROAD",
"townland": "ELY",
"postTown": "ELY",
"county": null,
"postCode": "CB6 1AS",
"addressLineOne": null
},
"yearsAtAddress": 2,
"previousAddress": {
"houseName": null,
"houseNumber": "1",
"streetName": "CROMWELL ROAD",
"townland": "ELY",
"postTown": "ELY",
"county": null,
"postCode": "CB6 1AS",
"addressLineOne": null
},
"telephone": {
"mobileNumber": "07700900624",
"phoneNumber": "01632960183"
},
"employment": {
"employmentStatusCDLCode": "Employee",
"employmentStatus": "FT",
"employmentLevel": false,
"employmentAbiCode":null,
"industrySector": "1",
"employmentSector": "1"
}
},
"payment": {
"isJointAccount": false,
"isApplicantAccount": true,
"thirdPartyAccountName": null,
"thirdPartyApplicantAddress": null
},
"bank": {
"bankAccountNumber": "41011166",
"bankSortCode": "201596",
"iban": null,
"bic": null
},
"marketing": {
"isMarketingOptInEmail": false,
"isMarketingOptInSms": false,
"isMarketingOptInPost": false,
"isMarketingOptInPhone": false
},
"income": {
"netMonthlyIncome": 27800.00
},
"affordability": {
"netMonthlyIncome": 27800.00,
"spousePartnerNetMonthyIncome": 2000.0,
"monthlyMortgageRentRepayment": 100.0,
"maritalStatus": "M",
"residentialStatus": "F",
"numberOfDependants": 0
}
}
}
}
{
"clientCode": "Provided by BNPP PF",
"shopCode": "Provided by BNPP PF",
"newBusinessRequestType": {
"application": {
"brokerReference": "BROKERREF01",
"accountNumber": null,
"insuranceType": 1,
"isRenewal": false,
"allowSearchAuthorisation": true,
"isCustomerPresent": true,
"hasCustomerDeclaration": true
},
"policy": {
"policyInceptionDate": "2020-11-04",
"policyRenewalDate": "2021-11-04",
"totalCashPrice": 1320.00,
"deposit": 132.00,
"creditProductCode": "TIN1",
"term": 10,
"preferredPaymentDay": 15,
"policyPremiumAmount": 132.00,
"brokerCreditFeeAmount": 10.0,
"brokerCreditFeeDescription": "fees",
"brokerFeeAmount": 120.0,
"brokerFeeAmountDescription": "discount applicable",
"addOnAmount": 5.0,
"addOnAmountDescription": "Heavy Duty",
"discountAmount": 1.0,
"discountAmountDescription": "Discount",
"premiumDescription": "1",
"policyType": 1,
"policyNumber": "mh-123456",
"insuranceCompany": "7",
"ropRateType": 1,
"isEdiFlag": false
},
"applicant": {
"customer": {
"title": "Mr",
"firstName": "Test01FN",
"lastName": "Test01LN",
"dateOfBirth": "1966-10-09",
"nationality": "GBR",
"countryOfBirth": "GBR",
"email": "[email protected]",
"policyholderName": "MW FORREST",
"address": {
"houseName": null,
"houseNumber": "1",
"streetName": "CROMWELL ROAD",
"townland": "ELY",
"postTown": "ELY",
"county": null,
"postCode": "CB6 1AS",
"addressLineOne": null
},
"yearsAtAddress": 2,
"previousAddress": {
"houseName": null,
"houseNumber": "1",
"streetName": "CROMWELL ROAD",
"townland": "ELY",
"postTown": "ELY",
"county": null,
"postCode": "CB6 1AS",
"addressLineOne": null
},
"telephone": {
"mobileNumber": "07700900624",
"phoneNumber": "01632960183"
},
"employment": {
"employmentStatus": "FT",
"employmentLevelSpecified": false,
"industrySector": "1",
"employmentSector": "1"
}
},
"payment": {
"isJointAccount": false,
"isApplicantAccount": true,
"thirdPartyAccountName": null,
"thirdPartyApplicantAddress": null
},
"bank": {
"bankAccountNumber": "41011166",
"bankSortCode": "201596",
"iban": null,
"bic": null
},
"income": {
"netMonthlyIncome": 27800.00
}
}
}
}
Response Example
{
"data": {
"newBusinessResponseType": {
"brokerReference": "BROKERREF01",
"accountNumber": "910000014759",
"decision": 1,
"pdf": "",//base64 encoded bytes for a pdf
"responseStatus": 1
},
"errors": null
},
"validationErrors": [],
"error": -1,
"error_description": null,
"successful": true
}
Updated about 2 years ago