Loading
Assicurazioni
InsPolicyService:createRenewalPolicy

InsPolicyService:createRenewalPolicy

Utilizzare questo servizio per creare una policy di rinnovo da una policy esistente.

Classe: InsPolicyService

Metodo: createRenewalPolicy

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 ulteriori campi nell'oggetto policy, 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 utilizza includePaymentSchedule e includeRevenueSchedule per determinare se la pianificazione di pagamento e la pianificazione del reddito devono essere create per la polizza rinnovata. Se non sono specificate opzioni, le stesse impostazioni vengono ereditate dalla policy precedente.

  5. Il servizio crea una policy e la contrassegna come policy rinnovata.

Nota
Nota

Il servizio supporta inoltre il rinnovo delle polizze in cui la versione originale della polizza ha una durata inferiore a 365 giorni o inferiore a 366 giorni in un anno bisestile. Tuttavia, al rinnovo la durata della polizza è 365 giorni, o 366 giorni per un anno bisestile. Vedere Considerazioni e limitazioni per le polizze assicurative.

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.

Se non vengono forniti userInput, il servizio di rinnovo prende le informazioni della policy esistente e le riproduce nella policy rinnovata.

additionalFields

Facoltativo

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

Opzioni remote

Nota
Nota Tutte le opzioni remote utilizzate in InsProductService:repriceProduct possono essere utilizzate anche con questo servizio.

Opzione remota

Descrizione

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

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

Se si utilizza il pacchetto Insurance Industries Extension, il valore di indicazione oraria nell'opzione renewalEffectiveDate viene ignorato. Il valore dell'indicazione oraria della data effettiva è invece impostato sulle 00:00 della data effettiva selezionata e il valore della data di scadenza è impostato sulle 23:59 della data di scadenza selezionata. L'indicazione oraria viene impostata utilizzando il fuso orario specificato dall'utente.

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. aggByKey prende tutte le chiavi istanza per i veicoli e crea un array 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 questo valore per rivalutare la polizza.

calculateTaxesAndFees

Facoltativo.

Il valore predefinito è true.

Impostare su true per calcolare imposte e spese.

createTransaction

Facoltativo.

Vero o Falso

L'impostazione predefinita è False.

Se true, il servizio crea una transazione utilizzata dai servizi di pianificazione del reddito.

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 includeInputKeys per rivalutare la polizza.

includePaymentSchedule

Facoltativo

Se true, il servizio crea una pianificazione di pagamento per la polizza rinnovata. Se non viene fornito alcun valore, il servizio crea una pianificazione di pagamento per la polizza rinnovata solo se è presente per la polizza originale.

includeRevenueSchedule

Facoltativo

Se true, il servizio crea una pianificazione del reddito per la polizza rinnovata. Se non viene fornito alcun valore, i servizi creano una pianificazione di pagamento per la polizza rinnovata solo se è presente per la polizza originale.

paymentCalculationMethod

Obbligatorio, se il valore di includePaymentSchedule è true.

Ignora il valore di Premium Calculation Method della policy.

paymentFrequency

Obbligatorio se il valore di includePaymentSchedule è true.

Ignora il valore di PremiumFrequency della policy.

paymentType

Obbligatorio se il valore di includePaymentSchedule è true.

Ignora il valore di Premium Payment Type della policy.

ratingDate

Determina la procedura di valutazione dei prezzi della polizza rinnovata. Se non viene fornita, i prezzi vengono calcolati in base alla data di validità della polizza rinnovata.

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.

term

Facoltativo

Termine della polizza. Aiuta a calcolare i renewalExpirationDate, se non è specificato nelle opzioni remote. InsPolicyService:createRenewalPolicy 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
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}    

JSON di output

Di seguito è riportato un esempio di JSON di output:

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