Sie befinden sich hier:
InsPolicyService:createPolicyVersion
Verwenden Sie diesen Service, um eine neue Version einer vorhandenen Richtlinie zu erstellen und gleichzeitig den vorhandenen Richtliniendatensatz unverändert beizubehalten.
Dieser Service aktiviert die Richtlinienversionierung. Alle Änderungen an einer Richtlinie werden in verschiedenen Versionen dieser Richtlinie verfolgt. Sie können sie in OmniScripts und Integrationsverfahren für Änderungsrichtlinien und Stornierungsrichtlinien verwenden. Sie können diesen Service auch verwenden, um abgelaufene und stornierte Policen wiederherzustellen.
Dieser Service funktioniert mit der Salesforce Financial Services Cloud für die optionale Unterstützung bei der Erstellung von Zahlungsplänen.
Funktionsweise
-
Enthält die
assetIdoderpolicyIdder aktuellen Richtlinie und die durch dieinputKeyangegebene JSON. -
Erstellt ein Duplikat der ursprünglichen Richtlinie.
-
Wenn ein Zahlungsplan vorhanden ist, aktualisiert der Service den Zahlungsplan und erstellt einen Zahlungsplaneintrag am Datum des Inkrafttretens der Bestätigung. Wenn "
useIsPaidFlag" auf "true" festgelegt ist, werden alle künftigen Zahlungsplaneinträge (ab Inkrafttreten) ohne Transaktionen (für die das Statusfeld "Valid" und dasisPaiddeaktiviert ist) anhand neuerer Prämien-, Steuer- und Gebührenwerte aktualisiert. Der neue Zahlungsplaneintrag enthält die angepassten Werte für Prämie, Steuern und Gebühr basierend auf neuen Prämien, Steuern und Gebühren und aktualisierten Zahlungsplaneinträgen. Außerdem werden die Beitragsdatensätze der Policenkomponenten in jedem Zahlungsplaneintrag aktualisiert. -
Der Service verwendet die Prämienberechnungsmethode, den Zahlungstyp und die Prämienhäufigkeit der vorherigen Police sowie die Gesamtprämie für Laufzeit, die Gesamtgebühr für Laufzeit und die Gesamtsteuer für Laufzeit, um den geänderten Zahlungsplan zu generieren. Zusätzlich zur Erstellung der Transaktion werden Daten zur Transaktionsaufschlüsselung in das Transaktionsdetailseitenobjekt eingetragen. Dieses Objekt speichert Daten dazu, wie viel jeder Vermögenswert, jeder Teilnehmer oder jede Abdeckung in Bezug auf Prämien, Steuern und Gebühren zum Gesamtbetrag der Transaktion beiträgt. Es werden nur Vermögenswerte, Teilnehmer und Abdeckungen mit mindestens einem Wert größer null für Prämien, Steuern oder Gebühren angezeigt.
Hinweis "Prämienberechnungsmethode", "Zahlungstyp" und "Prämienhäufigkeit" werden nicht aus der vorherigen Richtlinie kopiert und müssen als Eingaben über die JSON an den Service übergeben werden. -
Wenn
includeRevenueScheduleauf true festgelegt ist, wird der Umsatzplanservice aufgerufen, um den Umsatzplan zu ändern. -
Wenn es sich um die erste Änderung dieser Richtlinie handelt, werden die
originalVersionId__cundpreviousVersionId__cvom Service mit demselbenassetIdversehen. Wenn dies nicht die erste Änderung dieser Richtlinie ist, übernimmt der Service dieOriginalVersionId__cauf die neue Version und stempelt die vorherigeassetIdauf diePreviousVersionId__cin der neuen Richtlinie. -
Wenn die
taxesAndFees-,taxAmount- und/oderfeeAmount-Knoten in der Eingabe-JSON enthalten sind, werden die entsprechenden Steuer-/Gebührenfelder und/oder Datensätze in der neuen Version der Richtlinie erstellt und anteilig zugeordnet. -
Gegebenenfalls wird eine InsurancePolicyTransaction für die Zahlungsanpassung erstellt.
-
Wenn
calculateCommissiontrueist, ruft der ServiceInsurancePolicyService.calculateAndSaveCommissionauf, wodurch die Eingabe für dieInsCommissionService.calculate- undInsCommissionService.saveCommissionsvorbereitet wird. Nachdem der Berechnungsservice die Eingabe verarbeitet hat, speichert der Speicherservice den berechneten Wert inTotalCommissionAmount, rollt den Wert zusammen und fügt ihn demTotalCommissionAmountder ursprünglichen Richtlinie hinzu. - Wenn die
disableAttributeCategoriesimgetquotedetail-Service auf true festgelegt ist, lässt der Service den Knoten attributeCategory in der Antwort aus und dercreatePolicyVersion-Service erstellt keine Richtlinienbedingungen. Um sicherzustellen, dass dercreatePolicyVersion-Service Policenbedingungen erstellt, legen Sie diedisableAttributeCategoriesimgetQuoteDetail-Service auf false fest.
Steuern und Gebühren
So funktioniert dieser Service für Steuern und Gebühren:
-
Wenn das Feld
taxesAndFeesin einem JSON-Datensatz angegeben ist, wird für jedes Element in dertaxesAndFeesein entsprechenderAssetPricingAdjustment__cbeibehalten. -
Wenn das Feld
taxAmountin einem JSON-Datensatz angegeben ist, wird das FeldTaxAmount__cauf den Wert des FeldstaxAmountim erstelltenAssetItem-Objekt festgelegt. -
Wenn das Feld
feeAmountin einem JSON-Datensatz angegeben ist, wird das FeldFeeAmount__cauf den Wert des FeldsfeeAmountim erstelltenAssetItemfestgelegt.
Was die aktuelle (neu erstellte) Richtlinie betrifft:
-
Wenn die aktuelle Richtlinie eine
TotalTaxAmount__caufweist, wird dieser Wert auf das Datum des Inkrafttretens und das Enddatum anteilig angerechnet und im Feld "TotalTaxForTerm__c" festgelegt. -
Wenn die aktuelle Richtlinie eine
TotalFeeAmount__caufweist, wird dieser Wert auf das Datum des Inkrafttretens und das Enddatum anteilig angerechnet und im Feld "TotalFeeForTerm__c" festgelegt. -
Wenn der
AssetItemfür die aktuelle Richtlinie eineTaxAmount__caufweist, wird dieser Wert über das Datum des Inkrafttretens und das Enddatum anteilig zugeordnet und im Feld "ProratedTaxAmount__c" festgelegt. -
Wenn der
AssetItemfür die aktuelle Richtlinie eineFeeAmount__caufweist, wird dieser Wert über das Datum des Inkrafttretens und das Enddatum anteilig zugeordnet und im Feld "ProratedFeeAmount__c" festgelegt.
Bei bereits erstellten Policen werden Steuern und Gebühren wie folgt weitergegeben:
-
Wenn die vorherige Richtlinie eine
TotalTaxAmount__caufweist, wird dieser Wert auf das neue Datum des Inkrafttretens und das neue Enddatum anteilig angerechnet und im Feld "TotalTaxForTerm__c" festgelegt. -
Wenn die vorherige Richtlinie eine
TotalFeeAmount__caufweist, wird dieser Wert auf das neue Datum des Inkrafttretens und das neue Enddatum anteilig angerechnet und im Feld "TotalFeeForTerm__c" festgelegt. -
Wenn die Felder vom Typ "AssetItem" eine
TaxAmount__caufweisen, wird dieser Wert auf das neue Datum des Inkrafttretens und das neue Enddatum anteilig angerechnet und für das Feld "ProratedTaxAmount__c" festgelegt. -
Wenn die
AssetItemin der vorherigen Richtlinie eineFeeAmount__caufweisen, wird dieser Wert auf das neue Datum des Inkrafttretens und das neue Enddatum anteilig angerechnet und im Feld "ProratedFeeAmount__c" festgelegt.
Wenn die Option "createTransaction" (siehe unten) auf "true" festgelegt ist und der neuen Policenversion Steuern und Gebühren zugeordnet sind, werden die TaxAmount__c- und FeeAmount__c für die erstellte Transaktion auf die Differenz zwischen der neuen (aktuellen) Police und den TotalTaxForTerm__c und TotalFeeForTerm__c der vorherigen Police festgelegt.
Remote-Optionen
Input JSON
Dieser Service sucht nach den in der Produkt-JSON angegebenen inputKey.
"policyJson": {
"productConfigurationDetail": {
"insuredItems": {
"Auto": [{
"instanceKey": "2015 Lexus LX250",
"autoLicNum": "Lexus",
"autoModel": "LX150",
"autoYear": 2015,
"BodyClass": "Sedan/Saloon",
"VehicleType": "PASSENGER CAR",
"isPrimary": true
"isParent": true
},
{
"instanceKey": "2006 Honda Odyssey",
"autoLicNum": "Honda",
"autoModel": "Odyssey",
"autoYear": 2006,
"BodyClass": "Minivan",
"VehicleType": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
"isPrimary": true
"isParent": true
},
{
"instanceKey": "2018 530 BMW",
"autoLicNum": "530",
"autoModel": "BMW",
"autoYear": 2018,
"BodyClass": "Sedan/Saloon",
"VehicleType": "PASSENGER CAR",
"isPrimary": true
"isParent": true
},
{
"instanceKey": "2016 Camry Toyota",
"autoLicNum": "Camry",
"autoModel": "Toyota",
"autoYear": 2016,
"BodyClass": "Sedan/Saloon",
"VehicleType": "PASSENGER CAR",
"isPrimary": true
"isParent": true
}
],
"Driver": [{
"AGE": 20,
"instanceKey": "Joan Smith",
"FN": "Joan",
"GENDER": "Female",
"LN": "Smith",
"isPrimary": false
"isParent": false
},
{
"AGE": 30,
"instanceKey": "John Smith",
"FN": "John",
"GENDER": "Male",
"LN": "Smith",
"isPrimary": false
"isParent": false
},
{
"AGE": 30,
"instanceKey": "Robert Henderson",
"FN": "Robert",
"GENDER": "Male",
"LN": "Henderson",
"isPrimary": false
"isParent": false
},
{
"AGE": 20,
"instanceKey": "Kinsey Schell",
"FN": "Kinsey",
"GENDER": "Female",
"LN": "Schell",
"isPrimary": false
"isParent": false
}
]
},
"accountId": "001f400000RrQSrAAN"
}Wenn die Remote-Option "isCreatingPolicyTerms" auf "true" festgelegt ist, ist ein policyTermIds enthalten. Hier ein Beispiel für einen policyTermIds:
{
"policyId": "02i6g000000h110AAA",
"policyTermIds": [
"a5X6g000001LeUUEA0",
"a5X6g000001LeUVEA0",
"a5X6g000001LeUWEA0",
"a5X6g000001LeUXEA0",
"a5X6g000001LeUYEA0",
"a5X6g000001LeUZEA0",
"a5X6g000001LeUaEAK",
"a5X6g000001LeUbEAK",
"a5X6g000001LeUcEAK",
"a5X6g000001LeUdEAK",
"a5X6g000001LeUeEAK",
"a5X6g000001LeUfEAK"
]
}