Loading
Assicurazioni
InsPolicyService:removeInsuredItem

InsPolicyService:removeInsuredItem

Utilizzare questo servizio per rimuovere un articolo assicurato da una polizza esistente.

Questo servizio può far parte di OmniScript e procedure di integrazione della policy di modifica. Funziona meglio con altri servizi che formano flussi completi di modifica delle policy. Ad esempio, può venire dopo getInsuredItems e prima di createPolicyVersion.

Questo servizio funziona con Salesforce Financial Services Cloud.

Classe: InsPolicyService

Metodo: removeInsuredItem

Funzionamento

  1. Il servizio prende il insuredItemId e il effectiveDate.

  2. Rimuove l'articolo assicurato dal JSON della polizza.

  3. Ricalcola il premio della polizza e restituisce la differenza di prezzo e il JSON della polizza modificata.

    Se il JSON della polizza include imposte e/o spese, il JSON della polizza include e aggiorna i campi taxesAndFees, taxAmount, feeAmount, totalTaxForTermDiff e/o totalFeeForTermDiff (a seconda di quale dei due venga utilizzato).

Nota
Nota

Tutte le opzioni remote utilizzate nel servizio InsProductService:getRatedProducts possono essere utilizzate anche qui.

Opzioni remote

Opzione

Descrizione

aggByKey

PRODUCT.instanceKey

Il servizio invia questa opzione a una procedura di calcolo che include una fase di aggregazione, in modo che la procedura di calcolo restituisca l'ammontare corretto.

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 una matrice di premi di copertura per instanceKey e le passa alla procedura di calcolo in modo che i premi possano essere calcolati correttamente.

calculateTaxesAndFees

true o false

Calcola le imposte e le spese sul prodotto di destinazione.

Se impostata su true, ricalcola le imposte e le spese per la polizza modificata.

Se si utilizza Salesforce FSC e si imposta questa opzione su true, è necessario specificare anche l'opzione getDataDRBundleName o getDataCustomClassName.

effectiveDate

Obbligatorio.

“YYYY-MM-DD HH:MM:SS” o %OmniScriptDataElement%

Per impostazione predefinita, la data odierna.

La data in cui avrà effetto la rimozione di questo articolo assicurato.

getDataDRBundleName

Nome del Data Mapper Omnistudio utilizzato da questo servizio per recuperare le informazioni sulle policy (asset).

Se si utilizza Salesforce FSC, è necessario specificare questa opzione o getDataCustomClassName.

getDataCustomClassName

Nome della classe personalizzata utilizzata da questo servizio per recuperare le informazioni sulla policy (asset).

Se si utilizza Salesforce FSC, è necessario specificare questa opzione o getDataDRBundleName.

includeInputKeys

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 di input utilizzate dalla procedura di calcolo hanno un valore nei risultati.

insuredItemId

Obbligatorio.

%theIdYouNeed%

ID dell'articolo assicurato da rimuovere dalla polizza.

policyId

Obbligatorio solo se si utilizza Salesforce FSC.

ID della InsurancePolicy.

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.

Input JSON

Questo servizio non accetta un JSON di input.

JSON di output

Il servizio restituisce un JSON di output senza i record dell'articolo rimosso e le informazioni sul premio ricalcolate.

Per le imposte e le spese, in particolare, i campi totalTaxForTermDiff e totalFeeForTermDiff vengono restituiti e vengono visualizzati solo durante il calcolo delle imposte e delle spese. Rappresentano la differenza tra l'imposta/commissione ripartita della polizza target e l'imposta/commissione ripartita della polizza modificata (simile al campo totalPremiumForTermDiff).

Le seguenti chiavi e i relativi valori sono inclusi nell'output:

  • priceDiff

  • totalPremiumForTermDiff

"totalSize": 0,
"records": [{
    "displaySequence": -1,
    "Id": "02i1I000001jL2WQAU",
    "productId": "01t1I000002fuBoQAI",
    "accountId": "0011I00000QknfjQAB",
    "policyNumber": "AUTOROOT-000154-2019-",
    "productName": "Auto Root",
    "EffectiveStart": "2018-08-15",
    "EffectiveEnd": "2019-01-29",
    "Price": 440,
    "PricingFormula__c": "SUM(AutoPremium__autoPremium + rentalTotal + medicalTotal + roadsideTotal + dedWaiverTotal + uninsuredMotoristPDTotal + uninsuredMotoristBITotal)",
    "ProductCode": "AUTOROOT",
    "term": "Semi-Annual",
    "TotalPremiumForTerm__c": 1661.74,
    "CalculatedPriceData": {
      "2015 Lexus LX250": {
        "DRIVER.LN": null,
        "DRIVER.FN": null,
        "AUTO.instanceKey": "2015 Lexus LX250",
        "uninsuredMotoristBITotal": 100,
        "uninsuredMotoristPDTotal": 0,
        "dedWaiverTotal": 10,
        "roadsideTotal": 10,
        "medicalTotal": 10,
        "rentalTotal": 40,
        "comprehensiveTotal": 500,
        "ID": "0"
      },
      "2006 Honda Odyssey": {
        ...
      },
      "2018 530 BMW": {
        ...
      },
      "2016 Camry Toyota": {
        ...
      }
    },
    "priceDiff": -1380,
    "totalPremiumForTermDiff": -904.32,
    "attributeCategories": {
      ...
    }
    "childProducts": {
      ...
    }
 
Caricamento
Salesforce Help | Article