InsPolicyService:createUpdatePolicy

Sie befinden sich hier:

InsPolicyService:createUpdatePolicy

Verwenden Sie diesen Service, um eine neue Versicherungspolice zu erstellen oder eine vorhandene Police mit neuen Informationen zu aktualisieren.

Dieser Service kann mit Salesforce Financial Services Cloud für die optionale Unterstützung bei der Erstellung von Zahlungsplänen verwendet werden.

Klasse: InsPolicyService

Methode: createUpdatePolicy

Funktionsweise

Der Service durchsucht die Eingabe-JSON nach dem inputKey. Der inputKey-Knoten enthält die Informationen, die der Service zum Erstellen oder Aktualisieren einer Richtlinie benötigt. Zu den Informationen, die dieser Service benötigt, zählen:
- accountId
- term
- productConfigurationDetail Datensätze
- insuredItems (optional)
- endDate
- effectiveDate
Erstellt ein Policenobjekt (Vermögenswert).
Wenn für die Richtlinie ein Zahlungsplan vorhanden ist, gibt der Service eine Fehlermeldung zurück.
Wenn eine erste Zahlung erfolgt, wird eine InsurancePolicyTransaction erstellt. 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. Sie müssen der Themenliste für Transaktionen das Transaktionsdetailsobjekt hinzufügen.
Beim Speichern des Zahlungsplans werden die Datensätze mit der ursprünglichen Policen-ID der Police verknüpft.
Wenn in der Eingabe-JSON taxesAndfees-, taxAmount- und/oder feeAmount vorhanden sind, werden die Steuer- und/oder Gebührendatensätze erstellt.
Gibt eine Richtlinien-ID in der Ausgabe-JSON zurück, wenn dem Service keine assetId übergeben wird.

Wenn dem Service ein assetId in der Eingabe-JSON übergeben wird, wird der vom assetId angegebene Datenbestand aktualisiert.
If calculateCommission=true: der Service ruft InsurancePolicyService.calculateAndSaveCommission auf, wodurch die Eingabe für die InsCommissionService.calculate- und InsCommissionService.saveCommissions vorbereitet wird. Nachdem der Berechnungsservice die Eingabe verarbeitet hat, speichert der Speicherservice den berechneten Wert in TotalCommissionAmount.
- Der Service ruft InsurancePolicyService.calculateAndSaveCommission auf, wodurch die Eingabe für die InsCommissionService.calculate- und InsCommissionService.saveCommissions vorbereitet wird.
- Der Provisionstyp (z. B. Provision oder Bonus) wird als commissionType an den InsCommissionService.saveCommissions übergeben.
- Der Provisionsstatus (z. B. "Verzichtet" oder "Bezahlt") wird als commissionStatus an den InsCommissionService.saveCommissions übergeben.
Nachdem der Berechnungsservice die Eingabe verarbeitet hat, speichert der Speicherservice den berechneten Wert in TotalCommissionAmount.

Hinweis Die endDate und effectiveDate bestimmen die Policendauer. Die Dauer der ersten Policenversion kann weniger als 365 Tage oder weniger als 366 Tage in einem Schaltjahr betragen. Entsprechende Informationen finden Sie unter Überlegungen und Einschränkungen für Versicherungspolicen.

Steuern und Gebühren

So funktioniert dieser Service, wenn Steuern und Gebühren verwendet werden:

Wenn das Feld taxesAndFees in einem JSON-Datensatz angegeben ist, wird für jedes Element in der taxesAndFees ein entsprechender AssetPricingAdjustment__c beibehalten.
Wenn das Feld taxAmount in einem JSON-Datensatz angegeben ist, wird das Feld TaxAmount__c auf den Wert des Felds taxAmount im erstellten AssetItem festgelegt.
Wenn das Feld feeAmount in einem JSON-Datensatz angegeben ist, wird das Feld FeeAmount__c auf den Wert des Felds feeAmount im AssetItem festgelegt.

Remote-Optionen

Option	Beschreibung
`assetId`	Optional. Die ID einer vorhandenen Richtlinie, die dieser Service anhand neuer oder aktualisierter Informationen aktualisiert. Wird verwendet, wenn der Service eine vorhandene Richtlinie aktualisieren muss.
`createContactForParticipants`	Optional. `true` oder `false` Standardmäßig wird `true` verwendet. Falls `false`, erstellt der Service keine Kontaktdatensätze.
`createInsuredItemsRelationships`	`true` oder `false` Wenn diese Option auf "true" festgelegt ist, können Sie eine Liste der `instanceKey` > `parentInstanceKey` zwischen versicherten Posten angeben. Diese Option unterstützt Beziehungen zwischen übergeordneten > untergeordneten und übergeordneten > untergeordneten > untergeordneten versicherten Artikeln.
`createTransaction`	Optional. `true` oder `false` Standardmäßig wird `false` verwendet. Falls `true`, erstellt der Service eine Transaktion, die von den Umsatzplanservices verwendet wird. 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-, Steuer- und Gebührenbeträge aufweisen. Das Transaktionsdetailobjekt muss der Themenliste der Transaktionen hinzugefügt werden.
`coolingOffPeriod`	Optional Die Anzahl der Tage, die Sie mit der ersten Zahlungsplaneingabe verzögern können. Bei einer Wartezeit wird das Datum des ersten Zahlungsplans der Police als Datum des Inkrafttretens + Anzahl der Tage berechnet. Es gibt beispielsweise eine monatliche Zahlungshäufigkeit, bei der das Datum des Inkrafttretens der 5. Januar und das Datum des ersten Zahlungsplans der 5. Januar ist. Wenn wir einen Cooling-Off-Zeitraum von 14 Tagen anwenden, ändert sich der erste Zahlungsplaneintrag vom 5. Januar zum 19. Januar. Die restlichen monatlichen Zahlungsplandaten bleiben unverändert. Hinweis Die Wartezeit muss zwischen 1 und 28 Tagen ab dem Startdatum der Police liegen.
`effectiveDate`	%"JJJ-MM-TT HH:MM:SS" oder %OmniScriptDataElement% Das Datum, an dem die Richtlinie (oder Richtlinienaktualisierung) in Kraft tritt. Wenn auf der Optionskarte kein `effectiveDate` vorhanden ist, sucht der Service auf der `rootAttributes` danach. Wenn der Service dort keine `effectiveDate` finden kann, wird das heutige Datum verwendet. Wenn Sie das Paket "Erweiterung für Versicherungsbranchen" verwenden, wird der Zeitstempelwert in der Option "`effectiveDate`" ignoriert. Stattdessen wird der Zeitstempelwert für das Inkrafttreten auf 00:00 Uhr des ausgewählten Datums für das Inkrafttreten und der Wert für das Ablaufdatum auf 23:59 Uhr für das ausgewählte Ablaufdatum festgelegt. Der Zeitstempel wird mithilfe der vom Benutzer angegebenen Zeitzone festgelegt.
`generatePolicyNumber`	true oder false Bei `true` verwendet diese Option die `UniqueIdGenerator` zum Erstellen einer eindeutigen Policennummer. Diese Nummer wird als `Asset.SerialNumber` gespeichert.
`includePaymentSchedule`	Optional. `True`, ob der Zahlungsplan für die Police erstellt wird. Der Standardwert ist `false`.
`includeRevenueSchedule`	Optional. `true` oder `false` Bei `true` ruft diese Option den InsPolicyRevenueScheduleService auf: createRevenueSchedule-Service zum Erstellen eines Umsatzplans oder InsPolicyRevenueScheduleService: modifiedRevenueSchedule, wenn die Richtlinie aktualisiert wird. Falls `false`, erstellt der Service keinen Umsatzplan für diese Richtlinie.
`initialPaymentRule`	Optional. Prozentsatz, Monate oder Tage.
`initialTransactionName`	Optional. Der Transaktionsname. Standardmäßig wird derselbe Wert wie `initialPaymentTransactionType` verwendet.
`initialPaymentTransactionType`	Optional. Der Transaktionstyp. Der Standardwert lautet Premium Charge.
`initialPaymentValue`	Erforderlich, wenn die `initialPaymentRule` angegeben ist. Der Prozentwert oder die Anzahl der Monate oder Tage.
`inputKey`	Pflichtangabe. Eine JSON, aus der dieser Service die erforderlichen Informationen abruft, um eine Richtlinie zu erstellen oder zu aktualisieren.
`isCreatingPolicyTerms`	`true` oder `false` Wenn er auf `true` festgelegt ist, gibt der Service einen `policyTermIds`-Knoten in der Ausgabe-JSON zurück.
`isFsc`	Optional. `True`, ob es sich bei der zu erstellenden Police um ein Objekt vom Typ "Versicherungspolicen" handelt. Der Standardwert ist `false`. Sie können entweder`postDataCustomClassName` oder `postDataDRBundleName` angeben. Wenn Sie keine dieser Optionen angeben, wird standardmäßig `postDataCustomClassName` verwendet.
`paymentCalculationMethod`	Erforderlich, wenn `includePaymentSchedule` `true` ist. Überschreibt den Wert der Prämienberechnungsmethode der Police.
`paymentFrequency`	Erforderlich, wenn `includePaymentSchedule` `true` ist. Überschreibt den Wert PremiumFrequency der Richtlinie.
`paymentStartDate`	Optional. Das Datum des ersten Zahlungsplaneintrags. "Standard" ist das Datum des Inkrafttretens der Richtlinie.
`paymentType`	Erforderlich, wenn `includePaymentSchedule` `true` ist. Überschreibt den Wert für "Prämienzahlungstyp" der Police.
`postDataCustomClassName`	Optional. Sie müssen diese Option oder `postDataDRBundleName` angeben. Der Standardwert ist auf PostInsurancePolicy festgelegt.
`postDataDRBundleName`	Optional. Sie müssen diese Option oder `postDataCustomClassName` angeben. Wenn Sie diese Option nicht angeben, lautet die Standardeinstellung `postDataCustomClassName`.
`transactionType`	%OmniScriptDataElement% Wird verwendet, wenn `includeRevenueSchedule` auf true festgelegt ist. Wenn kein Wert festgelegt ist, wird standardmäßig "Verkaufsrichtlinie" verwendet.
`calculateCommission`	`true` oder `false` Wenn er auf `true` festgelegt ist, berechnet der Service Provisionen für die Stammelemente und speichert den Gesamtbetrag in `TotalCommissionAmount`. Wenn der Service auf `false` (Standard) festgelegt ist, berechnet er keine Provisionen. Hinweis Wenn Sie diese Option auf "true" festlegen, benötigt der Service mindestens einen der Produzenten- oder Produktionscodewerte: `producerId` , `productionCodeId` oder `productionCodeName`.
`commissionType`	Optional Provisionstyp (z. B. Bonus oder Standard).
`commissionStatus`	Optional Status der Provision (z. B. "Ausstehend", "Bezahlt" oder "Verzicht").
`producerId`	Optional Die Verarbeitungsproduzenten-ID, d. h. der Produzent, der zum Abrufen der ProvisionScheduleId und Berechnen des Provisionsbetrags verwendet wird. Wird `InsurancePolicy.ProducerId` zugewiesen.
`productionCodeId`	Optional Die Produktionscode-ID. `InsurancePolicy.ProductionCodeId__c` zugewiesen.
`productionCodeName`	Optional Der an den Service InsCommissionService.calculate übergebene Name des Produktionscodes. Wenn Sie keine `productionCodeId` eingeben, verwendet der Service `productionCodeName` zum Nachschlagen der `productionCodeId`. Wenn Sie beide Werte eingeben, sie jedoch nicht übereinstimmen, hat die `productionCodeId` Vorrang.
`memberPlanIntegrationProcedure`	Initiiert ein benutzerdefiniertes Integrationsverfahren anhand der Benutzerkonfiguration. Wenn Sie diese Option verwenden, werden alle Optionen des Service an das benutzerdefinierte Integrationsverfahren und alle Policen-IDs als Eingabe für die Integration in das Objekt übergeben, beispielsweise das Objekt "Versicherungspolice" mit dem Mitgliedsplan.
`ratingDate`	Das Bewertungsdatum, das zum Bepreisen der Eingabe-JSON verwendet wurde. Hinweis Es ist nicht möglich, eine bestimmte Zeit für ratingField zu übergeben, da der Feldtyp "Datum" lautet. Der Zeitstempel für das Bewertungsdatum ist standardmäßig auf 00:00 Uhr festgelegt.
`term`	Die Laufzeit der Richtlinie, die der Service erstellt. "InsPolicyService:createUpdatePolicy" unterstützt nur die Laufzeiten der jährlichen Police.
`useIsPaidFlag`	Optional Wenn "true" und "`includePaymentSchedule`" ebenfalls auf "true" festgelegt sind, erstellt der Service Beitragsdatensätze von Policenkomponenten für jeden Zahlungsplaneintrag. Der Standardwert lautet "false".

Input JSON

Dieser Service sucht nach dem Wert des inputKey.

In diesem Beispiel ist 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"
  },
}

Die JSON im inputKey enthält mehrere Schlüssel-Wert-Paare, die der Service zum Erstellen oder Aktualisieren einer Richtlinie benötigt. Sie enthält auch die Produkt-JSON mit Preisen für die versicherten Artikel und die Gesamtpolice.

Schlüssel	Wert
`accountId`	Die generierte Account-ID für den Vermögenswert.
`additionalFields`	Optional. Schlüssel-Wert-Paare, einschließlich aller Policenfelder (Vermögenswertfelder), die nicht Teil des Service sind.
`endDate`	Optional. Das Datum, an dem die Richtlinie abläuft.
`effectiveDate`	Das Datum, an dem die Richtlinie in Kraft tritt. Wenn auf der Optionskarte kein `effectiveDate` vorhanden ist, sucht der Service auf der `rootAttributes` danach. Wenn der Service dort keine `effectiveDate` finden kann, wird das heutige Datum verwendet.
`insuredItems`	Die Schlüssel-Wert-Paare der versicherten Posten, die der Service zum Erstellen der Police verwendet.
`modificationDate`	Das Datum, an dem die Richtlinie geändert wurde
`productConfigurationDetail`	Eine Reihe von Datensätzen, die dem JSON-Strukturmodell des Produkts folgen.
`term`	Die Laufzeit der Richtlinie, die der Service erstellt.

Die insuredItems für dieses Beispiel enthalten die versicherten Posten und die vom Benutzer für jeden ausgewählten Werte.

In diesem Beispiel ist 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"

Ausgabe-JSON

Der Service gibt die Richtlinien-ID der neu erstellten Richtlinie zurück.

{
    "policyId": "02if4000001uCZXAA2",
    "error": "OK"
}

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"
  ]
}

Beispiele

Der Service wird in der Regel im OmniScript-Muster für die Angebotserstellung zu Policen verwendet.

Konnten Sie Ihr Problem mithilfe dieses Artikels lösen?

Geben Sie uns Feedback, damit wir uns verbessern können.

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.

InsPolicyService:createUpdatePolicy

Funktionsweise

Remote-Optionen

Input JSON

Ausgabe-JSON

Beispiele

General Information

Required Cookies

Functional Cookies

Advertising Cookies

General Information

Required Cookies

Functional Cookies

Advertising Cookies

Cookie List

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.Zu Englisch wechselnNicht jetzt

Produktbereich

Auswirkungen auf Funktionen

Edition

Erfahrung

InsPolicyService:createUpdatePolicy

Funktionsweise

Remote-Optionen

Input JSON

Ausgabe-JSON

Beispiele

Dieser Text wurde mit dem maschinellen Übersetzungssystem von Salesforce übersetzt. Weitere Details finden Sie hier.