Loading
Assicurazioni
InsPolicyService:prepareToRenewPolicy

Ti trovi qui:

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

InsPolicyService:prepareToRenewPolicy

Utilizzare questo servizio per calcolare l'ammontare richiesto per il rinnovo di una polizza esistente. Questo servizio restituisce il premio di rinnovo, le imposte e le spese o il JSON della policy di rinnovo senza creare una policy.

Classe: InsPolicyService

Metodo: prepareToRenewPolicy

Funzionamento

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

  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. Utilizza getPolicyJson per determinare se devono essere restituiti solo i componenti ammontare rinnovo o se nella risposta viene inviato un JSON polizza completo.

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 il ProductCode è il codice del prodotto, le specifiche di copertura associate, le specifiche dell'articolo assicurato o i dati di valutazione.

Opzioni remote

Opzione remota

Descrizione

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 per 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.

calculateTaxesAndFees

Facoltativo

true o false

Impostato su true per calcolare le imposte e le spese sulla polizza rinnovata.

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.

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

getPolicyJson

Facoltativo

Flag booleano per determinare se solo i componenti ammontare rinnovo devono essere restituiti in risposta o se deve essere restituito il JSON della polizza completo.

ratingDate

Determina la procedura di valutazione per la ridefinizione del prezzo della polizza. Se non viene fornita, i prezzi vengono calcolati in base alla data di validità della policy modificata.

Nota
Nota Non è possibile passare un'ora specifica per ratingField poiché il tipo di campo è Data. Pertanto, l'indicazione oraria della data di valutazione viene impostata automaticamente sulle 00:00.

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:prepareToRenewPolicy supporta solo i termini delle polizze annuali.

useLocalTimezone

Vero o Falso

Il valore predefinito è true.

Quando il valore è impostato su true, il servizio utilizza il fuso orario locale in cui viene creata la policy.

Quando il valore è impostato su false, i servizi utilizzano GMT come fuso orario.

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

JSON di output

Di seguito è riportato un esempio di JSON di output:

{
  "totalFeeForTermDiff": -0.07,
  "totalTaxForTermDiff": 0,
  "totalPremiumForTermDiff": -2.73,
  "newFeeForTerm": 24.93,
  "newTaxForTerm": 0,
  "newPremiumForTerm": 997.27,
  "newFee": 25,
  "newTax": 0,
  "newStandardPremium": 1000
}
 
Caricamento
Salesforce Help | Article