Ti trovi qui:
InsPolicyService:createOutOfSequencePolicyVersion
Utilizzare questo servizio per avviare una conferma fuori sequenza per una determinata polizza.
Classe: InsPolicyService
Metodo: createOutOfSequencePolicyVersion
Il servizio crea queste transazioni per una conferma fuori sequenza:
-
Fuori sequenza modificato/confermato: Modifica totale del premio per l'anno di polizza a seguito della conferma. In caso di impatto sulle polizze multi-termine, la transazione viene creata per ogni termine.
-
Conferma fuori sequenza: Rettifica del premio per il piano di pagamento quando viene eseguita la conferma. È solo per il termine corrente. La data di immissione del piano di pagamento è la data o la data di funzionamento corrente quando la fuori sequenza è effettiva tra una data passata e la data corrente. Per una data futura, la data di immissione del piano di pagamento è la data effettiva della conferma fuori sequenza.
Importante Il Numero polizza di riferimento deve essere compilato in tutte le versioni della polizza in tutti i termini.
Funzionamento
-
Il servizio utilizza il
policyIddella policy corrente, la data effettiva della conferma fuori sequenza e il JSON specificato dalinputKey. -
Se
createTransactionètrue, il servizio crea una transazione fuori sequenza di tipoOut-of-Sequence Changed/Endorsede i dettagli della transazione. -
Se
includePaymentScheduleètrue, il servizio genera o aggiorna le pianificazioni di pagamento e i dettagli di immissione delle pianificazioni di pagamento. Il calcolo viene eseguito in base ai valori selezionati per le opzionipaymentCalculationMethodepaymentFrequencycorrispondenti. La pianificazione di pagamento segue le regole della pianificazione di pagamento esistenti:-
Vengono aggiornate solo le pianificazioni di pagamento non pagate con data futura.
-
Le pianificazioni di pagamento precedenti, pagate o non pagate, non vengono mai aggiornate.
-
Eventuali rettifiche per il pagamento passato e lo schema di pagamento pagato sono incluse nella transazione Conferma fuori sequenza.
-
-
Il servizio aggiorna il valore del campo
IsPolicyEditLockedatruenelle versioni delle polizze assicurative correlate. Tutte le versioni della policy vengono bloccate fino al completamento della transazione di conferma fuori sequenza.
Il servizio supporta inoltre le conferme fuori sequenza quando la versione originale della policy ha una durata inferiore a 365 giorni o inferiore a 366 giorni in un anno bisestile. Vedere Considerazioni e limitazioni per le polizze assicurative.
Supporto per i campi personalizzati
-
Memorizzare i campi personalizzati dell'oggetto Polizza assicurativa nell'insieme di campi OutOfSequenceEndorsementCustomFields.
-
Compilare i campi personalizzati come coppie chiave/valore nella sezione
additionalFields. Vedere JSON di input. -
Utilizzare questo insieme di campi OutOfSequenceEndorsementCustomFields per copiare i dati personalizzati dalla versione annullata alla nuova versione della policy durante una conferma fuori sequenza.
Opzioni remote
Opzione |
Descrizione |
|---|---|
policyId
|
Obbligatorio. ID di una policy esistente che il servizio aggiorna in base a informazioni nuove o aggiornate. |
createContactForParticipants
|
Facoltativo. |
createInsuredItemsRelationships
|
Facoltativo.
Se questa opzione è Questa opzione supporta le relazioni voce controllante > controllato e controllante > controllato > assicurato nipote. |
createTransaction
|
Facoltativo.
Per impostazione predefinita, Se |
effectiveDate
|
Obbligatorio.
Data a partire dalla quale si applicano le modifiche delle conferme fuori sequenza. |
includePaymentSchedule
|
Facoltativo.
Il valore predefinito è |
inputKey
|
Obbligatorio.
JSON con gli input necessari per creare o aggiornare una policy. È possibile specificare uno dei seguenti valori:
|
paymentCalculationMethod
|
Obbligatorio se includePaymentSchedule è true. Questa opzione sostituisce il valore del metodo di calcolo del premio della polizza. |
paymentFrequency
|
Obbligatorio se includePaymentSchedule è true. Questa opzione sostituisce il valore di frequenza premium della polizza. |
paymentType
|
Obbligatorio se includePaymentSchedule è true. Questa opzione sostituisce il valore del tipo di pagamento premium della polizza. |
postDataCustomClassName
|
Facoltativo. Nome della classe personalizzata utilizzata dal servizio per salvare la nuova versione della policy. È necessario specificare questa opzione o Il valore predefinito è PostInsurancePolicy. |
postDataDRBundleName
|
Facoltativo. Nome del Data Mapper Omnistudio utilizzato dal servizio per salvare la nuova versione della policy. È necessario specificare questa opzione o
|
transactionType
|
Facoltativo. Se non viene fornito alcun valore per |
term
|
Termine della policy creata dal servizio. InsPolicyService:createOutOfSequencePolicyVersion supporta solo le condizioni delle polizze annuali. |
Input JSON
Il servizio cerca le inputKey specificate nel JSON del prodotto. Di seguito è riportato il JSON di input di esempio:
"newPolicyJSON": {
"accountId": "001f400000RrQSrAAN",
"term": "Annual",
"productConfigurationDetail": {
...
},
"insuredItems": {
...
},
"additionalFields": {
"vlocity_ins__Type__c": "AUTO",
},
}Di seguito sono riportati alcuni esempi di opzioni JSON:
{
"effectiveDate": "2023-03-01",
"inputKey": "quotepolicyJson",
"policyId": "0YT3t000000uUz6GAE",
"includePaymentSchedule": true,
"createTransaction": true,
"paymentFrequency": "Monthly",
"paymentCalculationMethod": "Modal"
}JSON di output
Di seguito è riportato il JSON di output di esempio quando il servizio avvia una conferma fuori sequenza e genera correttamente l'ID processo:
{
"jobId": "7073t0000BNGivxAQD",
"errorCode": "INVOKE-200",
"error": "OK"
}Di seguito è riportato il JSON di output di esempio quando il servizio restituisce un errore:
{
"errorCode": "ERROR-CODE",
"error": "error message"
}