Loading
Verzekering
InsPolicyService:createRenewalQuote

InsPolicyService:createRenewalQuote

Gebruik deze service om een verlengingsofferte te maken voor een bestaande polis.

Klasse: InsPolicyService

Methode: createRenewalQuote

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 offerteobject 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 maakt een opportunityrecord met behulp van het OpportunityDetails JSON vanuit de invoer. Zie voorbeeld van invoer-JSON. Dit knooppunt accepteert alleen deze drie verplichte velden:

    • Naam

    • StageName

    • CloseDate

    Opmerking
    Opmerking Extra opportunityvelden kunnen niet worden opgenomen in dit knooppunt. U kunt de opportunityrecord echter bijwerken met aanvullende details nadat de verlengingsofferte is gegenereerd.
  5. De service maakt een offerte van het type 'Verlenging' en koppelt deze aan de opportunityrecord die in de vorige stap is gemaakt.

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.

additionalFields

Optioneel

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

opportunityDetails

De details van de verlengingsopportunity, die is gekoppeld aan de verlengingsofferte. Als dit knooppunt niet aanwezig is, neemt de service de opportunitydetails op uit de opportunity die is gekoppeld aan de bronofferte van de oorspronkelijke polis.

Externe opties

Externe optie

Beschrijving

renewalEffectiveDate

Optioneel

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

Vervaldatum van bestaande polis + 1 dag

renewalExpirationDate

Optioneel

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

Ingangsdatum nieuwe polis + Looptijd nieuwe polis

term

Optioneel

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

pricebook

Optioneel

De naam van de PriceBook2 die is toegewezen aan Quote.Pricebook2Id. De standaardinstelling is standaard.

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 reeks dekkingspremies per instanceKey. Deze array wordt doorgegeven aan de berekeningsprocedure zodat premies correct worden berekend.

De service gebruikt deze optie om de prijs van de polis opnieuw te bepalen.

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 deze optie om de prijs van de polis opnieuw te bepalen.

failOnRatingFailure

Optioneel

Geeft aan of de service moet mislukken als beoordeling geen resultaat oplevert tijdens verlenging.

Indien true (waar), stopt de service en wordt er een fout geretourneerd. Indien false (onwaar), gaat de service door en wordt de verlengingsofferte gemaakt zonder beoordelingsresultaat.

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"
    },
    "OpportunityDetails": {
      "Name": "Renewal Opportunity",
      "StageName": "Qualification",
      "CloseDate": "2023-04-04"
    }
}

Uitvoer-JSON

De quoteId en opportunityId van de verlengingsofferte.

Hier is een voorbeeld van de uitvoer-JSON:

{
  "quoteId": "0Q0B0000000A0YEKA0",
  "opportunityId": "006B0000006zdiAIAQ",
}
 
Wordt geladen
Salesforce Help | Article