Loading
Assicurazioni
InsPolicyService:createRenewalQuote

Ti trovi qui:

  1. Guida di Salesforce
  2. Documenti
  3. Assicurazione digitale

InsPolicyService:createRenewalQuote

Utilizzare questo servizio per creare un preventivo di rinnovo per una polizza esistente.

Classe: InsPolicyService

Metodo: createRenewalQuote

Funzionamento

  1. Il servizio accetta i policyId della polizza da rinnovare.

    Nota
    Nota

    Il servizio passa userInputs per determinare ulteriori fattori di valutazione per il ricalcolo del prezzo. Inoltre, il servizio utilizza il nodo additionalFields per compilare campi aggiuntivi nell'oggetto preventivo, che altrimenti non fanno parte di questo servizio.

  2. Il servizio verifica la data effettiva e la data di scadenza della policy rinnovata. Se non viene fornito, il servizio calcola queste date utilizzando la seguente logica:

    • Data effettiva = Data di scadenza della polizza originale + 1 giorno

    • Data di scadenza = Data effettiva della nuova polizza + Durata della nuova polizza

  3. Rivaluta il prezzo del prodotto della polizza utilizzando le opzioni aggByKey e includeInputKey.

  4. Il servizio crea un record Opportunità utilizzando il nodo OpportunityDetails JSON dall'input. Vedere JSON di input di esempio. Questo nodo accetta solo questi tre campi obbligatori:

    • Nome

    • StageName

    • CloseDate

    Nota
    Nota Non è possibile includere ulteriori campi opportunità in questo nodo. Tuttavia, è possibile aggiornare il record opportunità con ulteriori dettagli dopo la generazione del preventivo di rinnovo.

  5. Il servizio crea un preventivo di tipo 'Rinnovamento' e lo collega al record opportunità creato nel passaggio precedente.

Input

Input

Descrizione

policyId

Obbligatorio

ID della policy da rinnovare.

userInputs

Facoltativo

Dettagli dei prodotti associati alla policy. Per qualsiasi prodotto, il formato di destinazione dell'oggetto userInputs è ricavato dall'elenco dei servizi nella scheda API della visualizzazione prodotto. Le chiavi oggetto sono nel ProductCode.AttributeCode di formato in cui ProductCode è il codice del prodotto, le specifiche di copertura associate, le specifiche dell'articolo assicurato o i dati di valutazione.

additionalFields

Facoltativo

Coppie chiave-valore dei campi aggiuntivi che non fanno parte di questo servizio. Questi campi vengono compilati nell'oggetto preventivo.

opportunityDetails

Dettagli dell'opportunità di rinnovo, collegata al preventivo di rinnovo. Se questo nodo non è presente, il servizio riprende i dettagli dell'opportunità collegati al preventivo di origine della policy originale.

Opzioni remote

Opzione remota

Descrizione

renewalEffectiveDate

Facoltativo

Data di validità della polizza rinnovata. Se non specificato, il valore viene calcolato utilizzando la seguente logica:

Data di scadenza della polizza esistente + 1 giorno

renewalExpirationDate

Facoltativo

Data di scadenza della polizza rinnovata. Se non specificato, il valore viene impostato utilizzando la seguente logica:

Data effettiva della nuova polizza + Durata della nuova polizza

term

Facoltativo

Termine della polizza. Aiuta a calcolare i renewalExpirationDate, se non è specificato nelle opzioni remote. InsPolicyService:createRenewalQuote supporta solo i termini delle polizze annuali.

pricebook

Facoltativo

Nome del record PriceBook2 assegnato a Quote.Pricebook2Id. L'impostazione predefinita è standard.

aggByKey

Obbligatorio

PRODUCT.instanceKey

Il servizio invia questa opzione come input alla procedura di calcolo, che la utilizza per completare il calcolo con l'aggregazione.

Ad esempio, una polizza assicurativa auto ha più conducenti collegati a ogni veicolo assicurato. Il veicolo assicurato ha un instanceKey separato per ogni istanza della polizza. Il aggByKey prende tutte le chiavi istanza per i veicoli e crea una serie di premi di copertura al instanceKey. Questa matrice viene passata alla procedura di calcolo in modo che i premi vengano calcolati correttamente.

Il servizio utilizza questa opzione per modificare il prezzo della polizza.

includeInputKeys

Obbligatorio

Stringa di coppie chiave-valore separate da virgole che il servizio trasmette all'interno e all'esterno della procedura di calcolo.

Queste coppie chiave-valore sono incluse nell'oggetto prodotto di output all'interno dell'oggetto CalculatedPriceData. Sono disponibili per facilitare l'analisi dei risultati dei calcoli.

Solo le chiavi utilizzate dalla procedura di calcolo hanno un valore nei risultati.

Il servizio utilizza questa opzione per modificare il prezzo della polizza.
failOnRatingFailure

Facoltativo

Specifica se il servizio deve fallire se la valutazione non restituisce un risultato durante il rinnovo.

Se true, il servizio si arresta e restituisce un errore. Se false, il servizio continua e crea il preventivo di rinnovo senza un risultato di valutazione.

Input JSON

Di seguito è riportato un esempio di JSON di input:

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

JSON di output

quoteId e opportunityId del preventivo di rinnovo.

Di seguito è riportato un esempio di JSON di output:

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