Sie befinden sich hier:
InsPolicyService:createOutOfSequencePolicyVersion
Verwenden Sie diesen Service, um eine Bestätigung außerhalb der Reihenfolge für eine bestimmte Richtlinie zu initiieren.
Klasse: InsPolicyService
Methode: createOutOfSequencePolicyVersion
Der Service erstellt die folgenden Transaktionen für eine Bestätigung außerhalb der Reihenfolge:
-
Geändert/Bestätigt außerhalb der Reihenfolge: Gesamtbetrag der Änderung der Prämie für das Policenjahr infolge der Bestätigung. Falls mehrfristige Policen betroffen sind, wird die Transaktion für jede Laufzeit erstellt.
-
Bestätigung außerhalb der Reihenfolge: Die Prämienanpassung für den Zahlungsplan bei der Durchführung der Bestätigung. Sie gilt nur für die aktuelle Laufzeit. Das Eintrittsdatum des Zahlungsplans ist das aktuelle Datum oder das Datum des Vorgangs, an dem die Reihenfolgeveränderung zwischen einem vergangenen Datum und dem aktuellen Datum wirksam ist. Bei einem künftigen Datum ist das Datum des Eintritts in den Zahlungsplan das Datum des Inkrafttretens der Bestätigung außerhalb der Reihenfolge.
Wichtig Die Referenzpolicennummer muss in allen Policenversionen bedingungsübergreifend ausgefüllt sein.
Funktionsweise
-
Der Service
policyIddie aktuelle Richtlinie, das Datum des Inkrafttretens der Bestätigung außerhalb der Sequenz und die von derinputKeyangegebene JSON. -
Wenn es sich bei
createTransactionumtruehandelt, erstellt der Service eine Transaktion vom Typ "Out-of-Sequence Changed/Endorsed" und die Transaktionsdetails. -
Wenn "
includePaymentSchedule"trueist, generiert oder aktualisiert der Service Zahlungspläne und Zahlungsplan-Eingabedetails. Die Berechnung erfolgt anhand der für die entsprechendenpaymentCalculationMethod- undpaymentFrequencyausgewählten Werte. Der Zahlungsplan folgt den vorhandenen Zahlungsplanregeln:-
Es werden nur zukünftige nicht bezahlte Zahlungspläne aktualisiert.
-
Vergangene Zahlungspläne, bezahlt oder nicht bezahlt, werden nie aktualisiert.
-
Alle Anpassungen für die vergangene Zahlung und den bezahlten Zahlungsplan sind in der Transaktion "Bestätigung außerhalb der Reihenfolge" enthalten.
-
-
Der Service aktualisiert den Wert des Felds "
IsPolicyEditLocked" auftruein den zugehörigen Versicherungspolicenversionen. Alle Richtlinienversionen sind gesperrt, bis die Bestätigungstransaktion außerhalb der Reihenfolge abgeschlossen ist.
Der Service unterstützt auch Bestätigungen außerhalb der Reihenfolge, wenn die ursprüngliche Richtlinienversion weniger als 365 Tage oder weniger als 366 Tage in einem Schaltjahr dauert. Entsprechende Informationen finden Sie unter Überlegungen und Einschränkungen für Versicherungspolicen.
Unterstützung für benutzerdefinierte Felder
-
Speichern Sie die benutzerdefinierten Felder des Objekts "Versicherungspolice" im Feldset "OutOfSequenceEndorsementCustomFields".
-
Füllen Sie die benutzerdefinierten Felder im Abschnitt "
additionalFields" als Schlüssel/Wert-Paare aus. Siehe Eingabe-JSON. -
Verwenden Sie dieses Feldset OutOfSequenceEndorsementCustomFields, um benutzerdefinierte Daten aus der abgebrochenen in die neue Richtlinienversion zu kopieren, während eine Bestätigung außerhalb der Sequenz erfolgt.
Remote-Optionen
Option |
Beschreibung |
|---|---|
policyId
|
Pflichtangabe. Die ID einer vorhandenen Richtlinie, die der Service anhand neuer oder aktualisierter Informationen aktualisiert. |
createContactForParticipants
|
Optional. |
createInsuredItemsRelationships
|
Optional.
Wenn diese Option Diese Option unterstützt Beziehungen zwischen übergeordneten > untergeordneten und übergeordneten > untergeordneten > untergeordneten versicherten Artikeln. |
createTransaction
|
Optional.
Standardmäßig wird Bei |
effectiveDate
|
Pflichtangabe.
Das Datum, ab dem Änderungen der Bestätigung außerhalb der Reihenfolge gelten. |
includePaymentSchedule
|
Optional.
Der Standardwert ist |
inputKey
|
Pflichtangabe.
Eine JSON mit den erforderlichen Eingaben zum Erstellen oder Aktualisieren einer Richtlinie. Sie können einen der folgenden Werte angeben:
|
paymentCalculationMethod
|
Erforderlich, wenn includePaymentSchedule wahr ist. Diese Option überschreibt den Wert der Prämienberechnungsmethode der Police. |
paymentFrequency
|
Erforderlich, wenn includePaymentSchedule wahr ist. Diese Option überschreibt den Wert der Prämienhäufigkeit der Police. |
paymentType
|
Erforderlich, wenn includePaymentSchedule wahr ist. Diese Option überschreibt den Wert der Prämienzahlungsart der Police. |
postDataCustomClassName
|
Optional. Der Name der benutzerdefinierten Klasse, die der Service zum Speichern der neuen Richtlinienversion verwendet. Sie müssen diese Option oder Der Standardwert lautet PostInsurancePolicy. |
postDataDRBundleName
|
Optional. Der Name der OmniStudio-Datenzuordnung, die der Service zum Speichern der neuen Richtlinienversion verwendet. Sie müssen diese Option oder
|
transactionType
|
Optional. Wenn für |
term
|
Die Laufzeit der Richtlinie, die der Service erstellt. "InsPolicyService:createOutOfSequencePolicyVersion" unterstützt nur die Policenlaufzeit pro Jahr. |
Input JSON
Der Service sucht nach den in der Produkt-JSON angegebenen inputKey. Hier ist die Beispiel-Eingabe-JSON:
"newPolicyJSON": {
"accountId": "001f400000RrQSrAAN",
"term": "Annual",
"productConfigurationDetail": {
...
},
"insuredItems": {
...
},
"additionalFields": {
"vlocity_ins__Type__c": "AUTO",
},
}Im Folgenden finden Sie die JSON-Beispieloptionen:
{
"effectiveDate": "2023-03-01",
"inputKey": "quotepolicyJson",
"policyId": "0YT3t000000uUz6GAE",
"includePaymentSchedule": true,
"createTransaction": true,
"paymentFrequency": "Monthly",
"paymentCalculationMethod": "Modal"
}Ausgabe-JSON
Hier sehen Sie die JSON-Beispielausgabe, wenn der Service eine Bestätigung außerhalb der Reihenfolge initiiert und die Auftrags-ID erfolgreich generiert:
{
"jobId": "7073t0000BNGivxAQD",
"errorCode": "INVOKE-200",
"error": "OK"
}Hier sehen Sie die JSON-Beispielausgabe, wenn der Service einen Fehler zurückgibt:
{
"errorCode": "ERROR-CODE",
"error": "error message"
}