U bent hier:
InsPolicyService:createUpdatePolicy
Gebruik deze service om een nieuwe verzekeringspolis te maken of om een bestaande polis bij te werken met nieuwe informatie.
Deze service kan worden gebruikt met Salesforce Financial Services Cloud voor optionele ondersteuning voor het maken van betalingsschema's.
Hoe het werkt
-
De service zoekt in de invoer-JSON naar de
inputKey. HetinputKeybevat de informatie die de service nodig heeft om een beleid te maken of bij te werken. De informatie die deze service vereist, omvat:-
accountId -
term -
Records
productConfigurationDetail -
insuredItems(optioneel) -
endDate -
effectiveDate
-
-
Maakt een object Polis (activum).
-
Als er een bestaande betalingsplanning voor de polis is, retourneert de service een foutbericht.
-
Als er een initiële betaling is, wordt er een InsurancePolicyTransaction gemaakt. Naast het maken van de transactie worden transactiesplitsingsgegevens ingevuld in het transactiedetailobject. Dit object slaat gegevens op over hoeveel elk activum, elke deelnemer of elke dekking bijdraagt aan de totale transactiebedragen in termen van premie, belasting en kosten. Alleen activa, deelnemers en dekkingen met minstens één waarde groter dan nul voor premie, belasting of kosten worden weergegeven. U moet het transactiedetailobject toevoegen aan de gerelateerde lijst voor transactie.
-
Als u de betalingsplanning opslaat, worden de records gekoppeld aan de oorspronkelijke polis-ID van de polis.
-
Als
taxesAndfees,taxAmounten/offeeAmountaanwezig zijn in de invoer-JSON, worden de belasting- en/of kostenrecords gemaakt. -
Retourneert een beleids-ID in de uitvoer-JSON als de service geen
assetIdwordt doorgegeven.Als aan de service een
assetIdwordt doorgegeven in de invoer-JSON, werkt deze het activum bij dat door deassetIdis opgegeven. -
Indien
calculateCommission=true: de service roeptInsurancePolicyService.calculateAndSaveCommissionaan, die de invoer voorbereidt voor deInsCommissionService.calculateenInsCommissionService.saveCommissions. Nadat de berekeningsservice de invoer heeft verwerkt, slaat de opslagservice de berekende waarde op inTotalCommissionAmount.-
De service roept
InsurancePolicyService.calculateAndSaveCommissionaan, die de invoer voorbereidt voor deInsCommissionService.calculateenInsCommissionService.saveCommissions. -
Het commissietype (bijvoorbeeld Commissie of Bonus) wordt doorgegeven aan de
InsCommissionService.saveCommissionsalscommissionType. -
De commissiestatus (bijvoorbeeld Vrijgesteld of Betaald) wordt doorgegeven aan de
InsCommissionService.saveCommissionsalscommissionStatus.
Nadat de berekeningsservice de invoer heeft verwerkt, slaat de opslagservice de berekende waarde op in
TotalCommissionAmount. -
endDate en effectiveDate bepalen de polisduur. De duur van de eerste polisversie kan minder dan 365 dagen zijn, of minder dan 366 dagen in een schrikkeljaar. Zie Overwegingen en beperkingen bij verzekeringspolissen.Belastingen en toeslagen
Deze service werkt als volgt als belastingen en toeslagen worden gebruikt:
Als het veld
taxesAndFeesis opgegeven voor een JSON-record, blijft er een overeenkomendeAssetPricingAdjustment__cbestaan voor elk item in detaxesAndFees.Als het veld
taxAmountis opgegeven voor een JSON-record, wordt het veldTaxAmount__cingesteld op de waarde van het veld taxAmount voor de gemaakteAssetItem.Als het veld
feeAmountis opgegeven voor een JSON-record, wordt het veldFeeAmount__cingesteld op de waarde van het veldfeeAmountaan deAssetItem.
Externe opties
Invoer-JSON
Deze service zoekt naar de waarde van de inputKey.
In dit voorbeeld is inputKey = newPolicyJSON.
"newPolicyJSON": {
"accountId": "001f400000OSHq2AAH",
"term": "Annual",
"endDate": "2019-05-14T07:00:00.000Z",
"effectiveDate": "2018-05-15T07:00:00.000Z",
"productConfigurationDetail": {
...
},
"insuredItems": {
...
},
"additionalFields": {
"SerialNumber": "AUTO-123",
"Status": "InForce",
"vlocityins2__Type__c": "AUTO",
"vlocityins2__PaymentMethodId__c": "a2Rf40000002NrgEAE"
},
}De JSON binnen de inputKey omvat diverse sleutel-/waardeparen die de service nodig heeft om een beleid te maken of bij te werken. Het omvat ook het product JSON, met prijzen voor de verzekerde items en de totale polis.
Sleutel |
Waarde |
|---|---|
|
De gegenereerde account-ID voor het activum. |
|
Optioneel. Sleutel-/waardeparen inclusief alle polisvelden (activa) die geen deel uitmaken van de service. |
|
Optioneel. De datum waarop de polis komt te vervallen. |
|
De datum waarop de polis van kracht wordt. Als er geen |
|
De sleutel-/waardeparen van de verzekerde items die de service gebruikt om de polis te maken. |
|
De datum waarop het beleid is gewijzigd |
|
Een array van records die het product-JSON-structuurmodel volgen. |
|
De termijn van het beleid dat de service gaat maken. |
De insuredItems voor dit voorbeeld omvat de verzekerde items en de waarden die de gebruiker voor elk item heeft geselecteerd.
In dit voorbeeld is inputKey = quotepolicyJSON.
"quotepolicyJson": {
"productConfigurationDetail": {
...
}
"insuredItems": {
"DRIVER": [{
"GENDER": "Female",
"FN": "Joan",
"AGE": 20,
"LN": "Smith",
"instanceKey": "Joan Smith",
"isPrimary": false
"isParent": false
},
{
"GENDER": "Male",
"FN": "John",
"AGE": 30,
"LN": "Smith",
"instanceKey": "John Smith",
"isPrimary": false
"isParent": false
},
{
"GENDER": "Male",
"FN": "Robert",
"AGE": 30,
"LN": "Henderson",
"instanceKey": "Robert Henderson",
"isPrimary": false
"isParent": false
},
{
"GENDER": "Female",
"FN": "Kinsey",
"AGE": 20,
"LN": "Schell",
"instanceKey": "Kinsey Schell",
"isPrimary": false
"isParent": false
}
],
"AUTO": [{
"autoLicNum": "Lexus",
"autoModel": "LX250",
"autoYear": 2015,
"instanceKey": "2015 Lexus LX250",
"BodyClass": "Sedan/Saloon",
"VehicleType": "PASSENGER CAR",
"isPrimary": true
"isParent": true
},
{
"autoLicNum": "Honda",
"autoModel": "Odyssey",
"autoYear": 2006,
"instanceKey": "2006 Honda Odyssey",
"BodyClass": "Minivan",
"VehicleType": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
"isPrimary": true
"isParent": true
}
]
},
"accountId": "0011I00000QknfjQAB",
"opportunityId": "0061I00000AV8gBQAT"
},
"quoteId": "0Q01I000000206USAQ",
"error": "OK"Uitvoer-JSON
De service retourneert de polis-ID van de nieuw gemaakte polis.
{
"policyId": "02if4000001uCZXAA2",
"error": "OK"
}Als de externe optie isCreatingPolicyTerms is ingesteld op true, wordt er een policyTermIds opgenomen. Hier is een voorbeeld van een policyTermIds:
{
"policyId": "02i6g000000h110AAA",
"policyTermIds": [
"a5X6g000001LeUUEA0",
"a5X6g000001LeUVEA0",
"a5X6g000001LeUWEA0",
"a5X6g000001LeUXEA0",
"a5X6g000001LeUYEA0",
"a5X6g000001LeUZEA0",
"a5X6g000001LeUaEAK",
"a5X6g000001LeUbEAK",
"a5X6g000001LeUcEAK",
"a5X6g000001LeUdEAK",
"a5X6g000001LeUeEAK",
"a5X6g000001LeUfEAK"
]
}