Loading
Verzekering
InsPolicyService:createRenewalPolicy

InsPolicyService:createRenewalPolicy

Gebruik deze service om een verlengingsbeleid te maken op basis van een bestaand beleid.

Klasse: InsPolicyService

Methode: createRenewalPolicy

Hoe het werkt

  1. De service accepteert de policyId van de te verlengen polis.

    Opmerking
    Opmerking

    De service geeft userInputs door om extra beoordelingsfactoren te bepalen voor het opnieuw berekenen van de prijs. De service gebruikt ook het knooppunt additionalFields om extra velden voor het beleidsobject in te vullen, die anders geen deel uitmaken van deze service.

  2. De service controleert op de ingangsdatum en vervaldatum van de verlengde polis. Indien niet opgegeven, berekent de service deze datums met behulp van de volgende logica:

    • Ingangsdatum = Vervaldatum van oorspronkelijke polis + 1 dag

    • Vervaldatum = Ingangsdatum van nieuwe polis + Looptijd van de nieuwe polis

  3. Prijst het polisproduct opnieuw met behulp van aggByKey en includeInputKey.

  4. De service gebruikt includePaymentSchedule en includeRevenueSchedule om te bepalen of de betalingsplanning en de omzetplanning moeten worden gemaakt bij een vernieuwde polis. Als er geen opties zijn opgegeven, worden dezelfde instellingen overgenomen van het vorige beleid.

  5. De service maakt een beleid en markeert dit als vernieuwd beleid.

Opmerking
Opmerking

De service ondersteunt bovendien verlenging van polissen wanneer de oorspronkelijke polisversie een duur van minder dan 365 dagen of minder dan 366 dagen in een schrikkeljaar heeft. Bij verlenging is de polisduur echter 365 dagen of 366 dagen voor een schrikkeljaar. Zie Overwegingen en beperkingen bij verzekeringspolissen.

Invoer

Invoer

Beschrijving

policyId

Verplicht

De ID van de polis die moet worden verlengd.

userInputs

Optioneel

De details van de producten die aan de polis zijn gekoppeld. Voor elk product wordt de doelindeling voor het userInputs verkregen uit de servicevermelding op het tabblad API van de productweergave. De objectsleutels hebben de indeling ProductCode.AttributeCode waarbij de ProductCode de productcode, gekoppelde dekkingsspecificaties, specificaties van verzekerde items of beoordelingsfeiten is.

Als er geen userInputs worden geleverd, neemt de verlengingsservice de informatie van de bestaande polis en reproduceert deze in de vernieuwde polis.

additionalFields

Optioneel

De sleutel-waardeparen van de extra velden die geen deel uitmaken van deze service. Deze velden worden ingevuld voor het beleidsobject.

Externe opties

Opmerking
Opmerking Alle externe opties die in InsProductService:repriceProduct worden gebruikt, kunnen ook met deze service worden gebruikt.

Externe optie

Beschrijving

renewalExpirationDate

Optioneel

De vervaldatum van de verlengde polis. Indien niet opgegeven, wordt de waarde ingesteld met behulp van de volgende logica:

Ingangsdatum nieuwe polis + Looptijd nieuwe polis

renewalEffectiveDate

Optioneel

De ingangsdatum van de verlengde polis. Indien niet opgegeven, wordt de waarde berekend met behulp van de volgende logica:

Vervaldatum van bestaande polis + 1 dag

Als u het pakket Insurance Industries Extension gebruikt, wordt de tijdstempelwaarde in de optie renewalEffectiveDate genegeerd. In plaats daarvan wordt de tijdstempelwaarde van de ingangsdatum ingesteld op 12:00 uur van de geselecteerde ingangsdatum en wordt de waarde van de vervaldatum ingesteld op 23:59 uur voor de geselecteerde vervaldatum. Het tijdstempel wordt ingesteld met behulp van de opgegeven tijdzone van de gebruiker.

aggByKey

Verplicht

PRODUCT.instanceKey

De service verzendt deze optie als invoer naar de berekeningsprocedure, die deze gebruikt om de berekening met aggregatie te voltooien.

Een autoverzekering heeft bijvoorbeeld meerdere bestuurders gekoppeld aan elk verzekerd voertuig. Het verzekerde voertuig heeft een afzonderlijke instantieKey voor elk exemplaar in de polis. De aggByKey neemt alle instantiesleutels voor de voertuigen en maakt een array van dekkingspremies per instantieKey. Deze array wordt doorgegeven aan de berekeningsprocedure zodat premies correct worden berekend.

De service gebruikt deze waarde om de polis opnieuw te prijzen.

calculateTaxesAndFees

Optioneel.

De standaardwaarde is true.

Stel in op true om belastingen en vergoedingen te berekenen.

createTransaction

Optioneel.

Waar of Onwaar

De standaardwaarde is False.

Indien true (waar), maakt de service een transactie die wordt gebruikt door de omzetplanningsservices.

includeInputKeys

Verplicht

Een reeks met komma's gescheiden sleutel-waardeparen die de service in en uit de berekeningsprocedure doorgeeft.

Deze sleutel-waardeparen worden opgenomen in het uitvoerproductobject binnen het CalculatedPriceData. Ze helpen u bij het parseren van de berekeningsresultaten.

Alleen sleutels die door de berekeningsprocedure worden gebruikt, hebben een waarde in de resultaten.

De service gebruikt includeInputKeys om de polis opnieuw te prijzen.

includePaymentSchedule

Optioneel

Indien true (waar), maakt de service een betalingsschema voor de verlengde polis. Als er geen waarde wordt opgegeven, maakt de service alleen een betalingsschema voor de verlengde polis als deze aanwezig is voor de oorspronkelijke polis.

includeRevenueSchedule

Optioneel

Indien true (waar), maakt de service een omzetplanning voor vernieuwde polis. Als er geen waarde wordt opgegeven, maken de services alleen een betalingsschema voor de verlengde polis als deze aanwezig is voor de oorspronkelijke polis.

paymentCalculationMethod

Verplicht, als de waarde van includePaymentSchedule true (waar) is.

Overschrijft de Premium Calculation Method van het beleid.

paymentFrequency

Verplicht als de waarde van includePaymentSchedule true (waar) is.

Overschrijft de PremiumFrequency van het beleid.

paymentType

Verplicht als de waarde van includePaymentSchedule true (waar) is.

Overschrijft de Premium Payment Type van het beleid.

ratingDate

Bepaalt de beoordelingsprocedure voor de prijsstelling van de verlengde polis. Indien niet opgegeven, vindt de prijsstelling plaats op basis van de ingangsdatum van de verlengde polis.

Opmerking
Opmerking U kunt geen specifieke tijd doorgeven voor ratingField, aangezien het veldtype Datum is. Het tijdstempel van de beoordelingsdatum wordt dus standaard ingesteld op 12:00 uur.

term

Optioneel

De duur van de polis. Het helpt bij het berekenen van renewalExpirationDate, indien niet voorzien in de externe opties. InsPolicyService:createRenewalPolicy ondersteunt alleen jaarlijkse beleidsvoorwaarden.

useLocalTimezone

Waar of Onwaar

De standaardwaarde is true (waar).

Wanneer de waarde is ingesteld op true (waar), gebruikt de service de lokale tijdzone waarin het beleid is gemaakt.

Wanneer de waarde is ingesteld op false (onwaar), gebruiken de services GMT als tijdzone.

Invoer-JSON

Hier is een voorbeeld van de invoer-JSON:

{
   "policyId": "0YT5w000000Y8MNGA0",
   "userInputs": [
      {
        "DRIVER.instanceKey": "Bob Jones",
        "DRIVER.LN": "Jones",
        "DRIVER.GENDER": "Male",
        "DRIVER.FN": "Bobby",
        "DRIVER.AGE": 30,
        "AUTO.instanceKey": "2018 Audi A3",
        "AUTO.autoYear": 2018,
        "AUTO.autoModel": "A4",
        "perAccident": 500
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}    

Uitvoer-JSON

Hier is een voorbeeld van de uitvoer-JSON:

{
  "snapshotId": [
    "00P5w00001fKlqEEAS"
  ],
  "InsurancePolicy": [
    "0YT5w000000Y8tTGAS"
  ]
  "error": "OK"
}
 
Wordt geladen
Salesforce Help | Article