Sie befinden sich hier:
InsPolicyService:cancelPolicy
Verwenden Sie diesen Service, um eine bestehende Versicherungspolice zu kündigen.
Dieser Service arbeitet mit dem InsPolicyService:prepareToCancelPolicy und dem InsPolicyRevenueScheduleService:cancelRevenueSchedule zusammen, um alle Änderungen vorzunehmen, die erforderlich sind, um eine Police zu stornieren, einen Rückerstattungsbetrag bereitzustellen und den Umsatzplan (falls erforderlich) zu beenden.
Methode: cancelPolicy
Funktionsweise
-
Gibt die
assetIdoderpolicyIdder zu kündigenden Police und deneffectiveDatean, zu dem die Kündigung in Kraft tritt.
Hinweis Das Stornierungsdatum des Inkrafttretens kann nicht größer sein als heute. -
Aktualisiert den Policenstatus auf
Canceled, das ursprüngliche Ablaufdatum auf den aktuellen Wert des Ablaufdatums und das Ablaufdatum auf einen Tag vor dem Stornierungsdatum (mit dem Zeitstempel 23:59 Uhr). -
Ändert das Ablaufdatum zu dem an den Service übergebenen
effectiveDatemit dem Zeitstempel 23:59 Uhr. -
Verwendet den entsprechenden Berechnungsprozess anhand des
useIsPaidFlag.Wenn die
useIsPaidFlagauf "false" (deaktiviert) festgelegt ist, verrechnet der Service die Gesamtprämie für die Laufzeit, die Gesamtgebühr für die Laufzeit und die Gesamtsteuer für die Laufzeit der Police und berechnet die erstatteten Beträge anhand des Stornierungsdatums und der bis zum Datum der Zahlung der Police. Wenn "Police Paid To Date" (Police für bezahltes Datum) Null ist, berücksichtigt der Service die vollständig bezahlte Police und verwendet "Expiration Date" (Ablaufdatum).Wenn der
useIsPaidFlagauftruefestgelegt ist (ausgewählt), hat der Service Folgendes:-
Verwendet den Zahlungsplan, um den bereits für die Police gezahlten Gesamtbetrag zu berechnen. Der für die Police gezahlte Gesamtbetrag entspricht der Summe der Beträge in Zahlungsplänen, wobei "Ist bezahlt" auf "true" (wahr) festgelegt ist. Dieser Betrag wird bei Rückerstattungsberechnungen verwendet.
-
Verrechnet die Gesamtprämie für die Laufzeit, die Gesamtgebühr für die Laufzeit und die Gesamtsteuer für die Laufzeit der Police und berechnet Rückerstattungsbeträge auf der Grundlage des Stornierungsdatums und des bereits für die Police gezahlten Gesamtbetrags.
-
Passt Zahlungspläne entweder anhand des aktuellen Datums oder anhand des Stornierungsdatums an, je nachdem, welcher Zeitpunkt später liegt. Wenn für Zahlungspläne am oder nach diesem Datum "Ist bezahlt" auf "false" (deaktiviert) festgelegt ist, werden sie vom Service gelöscht.
-
Aktualisiert den Status aller nicht bezahlten Zahlungspläne (die sich seit
cancellationDatein der Vergangenheit befinden) aufInvalid. Der nicht gezahlte Betrag wird dem neuen Zahlungsplan hinzugefügt. -
Erstellt einen neuen Zahlungsplan für das aktuelle Datum mit einem Betrag, der dem bereits berechneten Rückerstattungsbetrag entspricht, und markiert den Status als
Valid. Wenn "createTransaction" wahr ist, erstellt der Service eine Stornierungstransaktion. -
Aktualisiert alle künftigen Policenversionen mit Stornierungsinformationen:
-
Status: Abgebrochen
-
Stornierungsdatum: Die an den Service übergebene
effectiveDate -
Laufzeitprämie, Laufzeitsteuer und Laufzeitgebühr: 0
-
Ablaufdatum: Tag, bevor die
effectiveDatean den Service übergeben wurde, mit einem Zeitstempel von 23:59 Uhr
-
-
-
Überträgt den anteiligen TotalPremiumForTerm in die Datenbank.
Wenn createTransaction=true und die übergebene ID assetId lautet, erstellt AssetTransaction_c (Betrag_c=Erstattung, postDate_c und transactionDate_c=effektivesDate, type=transactionType (standardmäßig "Abgebrochen"). Wenn createTransaction=true und die übergebene ID policyId lautet, erstellt der Service InsurancePolicyTransaction_c oder InsurancePolicyTransaction (Betrag_c=Erstattung, postDate_c und transactionDate_c=effektivesDatum, type=transactionType (standardmäßig "Abgebrochen").
Der Service füllt auch Transaktionsaufschlüsselungsdaten in das Transaktionsdetailobjekt auf. Sie zeigt Daten dazu an, wie viel jeder Vermögenswert, jeder Teilnehmer und jede Abdeckung zum Transaktionsgesamtbetrag in Form von Prämien, Steuern und Gebühren beiträgt. Es werden nur die Vermögenswerte, Teilnehmer und Abdeckungen angezeigt, die mindestens einen Wert ungleich null für Prämien, Steuern und Gebühren aufweisen.-
Ruft InsPolicyRevenueScheduleService:cancel mit dem
assetIdund dem neu erstelltentransactionIdauf. -
The InsPolicyRevenueScheduleService: Der Stornierungsservice berechnet das Ende des Umsatzplans und bucht die Ergebnisse im Abschnitt "Umsatzplan" der Richtlinie. Die Rückerstattungsbeträge stammen aus der Perspektive der Versicherungsgesellschaft. Ein negativer Betrag führt zu einer Rückerstattung an den Versicherungsnehmer und ein positiver Betrag stellt einen nicht bezahlten Betrag des Versicherungsnehmers dar.
Der Service unterstützt zudem die Kündigung von Policen, bei denen die ursprüngliche Policenversion 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.
Zuschläge (Steuern und Gebühren)
Dieser Service (zusammen mit dem prepareToCancel-Service) erleichtert die anteilige Zuordnung und Erstattung von Steuern und Gebühren, wenn eine Police storniert wird. So funktioniert das:
-
Wenn die Zielrichtlinie eine
TotalTaxAmount__caufweist, wird dieser Wert über das Stornierungsdatum anteilig zugeordnet und im Feld "TotalTaxForTerm__c" festgelegt. -
Wenn die Zielrichtlinie eine
TotalFeeAmount__caufweist, wird dieser Wert über das Stornierungsdatum anteilig zugeordnet und im Feld "TotalFeeForTerm__c" festgelegt. -
Wenn die Option "
createTransaction" (siehe unten) auf "true" festgelegt ist und die Zielrichtlinie über erstattungsfähigeAssetPricingAdjustment__cverfügt, werden die anteiligen Rückerstattungsbeträge in denTaxAmount__c- undFeeAmount__cder Transaktion festgelegt.
Wenn Sie das Objektmodell "Versicherungspolice" (anstelle des Objektmodells "Vermögenswert") verwenden, unterscheiden sich die Feldnamen:
-
TotalTaxAmount__c=StandardTaxAmount -
TotalTaxForTerm__c=TermTaxAmount -
TotalFeeAmount__c=StandardFeeAmount -
TotalFeeForTerm__c=TermFeeAmount -
AssetPricingAdjustment__c=InsurancePolicySurcharge -
TaxAmount__c=TransactionTaxAmount -
FeeAmount__c=TransactionFeeAmount
Möchten Sie mehr über den Wechsel vom Objektmodell "Vermögenswert" zum Objektmodell "Versicherungspolice" erfahren? Lesen Sie Harmonisieren von Versicherungspolicen.
Remote-Optionen
Ausgabe-JSON
Wenn Sie das Vermögenswert-Objektmodell verwenden, gibt dieser Service einen JSON-output zurück. Beispiel:
{
"output": {
"records": [
{
"instest10__TotalAmount__c": 420.97,
"instest10__TaxAmount__c": 37.93,
"instest10__FeeAmount__c": 3.68,
"instest10__Amount__c": 379.36,
"Id": "a416g0000002CZpAAM"
}
],
"totalSize": 1
}
}Wenn Sie das Objektmodell "Versicherungspolice" verwenden, gibt dieser Service einen JSON-results zurück. Beispiel:
{
"result": {
"type": "Cancelled",
"transactionNumber": null,
"transactionDate":
"totalAmount": null,
"taxAmount": null,
"postDate": "2021-09-01T07:00:00.000Z",
"name": "Cancelled"
"Id": null,
"feeAmount": null,
"amount": -133.4,
"additionalInfo": null
},
"error": "OK"
}