Loading
Assicurazioni
InsPolicyService:getPolicyDetails

Ti trovi qui:

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

InsPolicyService:getPolicyDetails

Utilizzare questo servizio per ottenere le coperture, le voci assicurate, i prezzi e altre informazioni per una polizza assicurativa esistente, incluse le coperture facoltative non selezionate.

Nota
Nota

Per ottenere i dettagli della polizza, è necessario disporre dell'accesso in lettura ai record Polizza assicurativa. Configurare le impostazioni di condivisione e le regole di condivisione per consentire l'accesso al record della policy richiesta. Vedere Condivisione di oggetti e campi.

Ad esempio, è possibile utilizzare questo servizio per ottenere e visualizzare i dettagli delle policy esistenti in un OmniScript o in una procedura di integrazione per la modifica delle policy.

Classe: InsPolicyService

Metodo: getPolicyDetails

Funzionamento

  1. Utilizza il policyId o il assetId per ottenere il record polizza e le relative coperture e voci assicurate.

  2. Passa alla specifica del prodotto associata alla polizza per ottenere specifiche di copertura facoltative deselezionate.

  3. Restituisce una struttura JSON che include voci assicurate, coperture di polizze e coperture facoltative.

Supplementi

Se si utilizza il servizio calculateTaxesAndFees, vengono restituiti i seguenti campi per i record seguenti e per la policy:

Per ogni record AssetCoverage__c, AssetInsuredItem__c e AssetPartyRelationship__c vengono restituiti i seguenti campi, a condizione che non siano nulli:

  • taxAmount e TaxAmount__c (valori equivalenti)

  • feeAmount e FeeAmount__c (valori equivalenti)

  • totalTaxFeeAmount__c e totalTaxFeeAmount (equivalente a TaxAmount__c + FeeAmount__c)

  • ProratedTaxAmount__c

  • ProratedFeeAmount__c

  • TotalAmount__c

  • TotalProratedAmount__c

Per la policy vengono restituiti i seguenti campi se i campi non sono nulli:

  • TotalTaxAmount__c

  • TotalFeeAmount__c

  • totalTaxFeeAmount__c e TotalTaxFeeAmount (equivalente a TotalTaxAmount__c + TotalFeeAmount__c)

  • TotalTaxForTerm__c

  • TotalFeeForTerm__c

  • TotalAmount__c

  • TotalAmountForTerm__c

Opzioni remote

Opzione

Descrizione

assetId

oppure

policyId

Obbligatorio.

ID della polizza (asset) per cui ottenere i dettagli.

Il tipo sObject di questo ID determina quale modello di dati utilizza il servizio, basato su asset o Salesforce FSC.

Se si specifica un'assetId senza specificare getDataDRBundleName o getDataCustomClassNameDR, il servizio utilizza automaticamente il modello di dati basato su asset.

Se si fornisce un policyId senza specificare getDataDRBundleName o getDataCustomClassNameDR, il servizio utilizza automaticamente il modello di dati Salesforce FSC.

getCoverages

%instanceKey%

Restituisce i dettagli della copertura solo per l'istanza specificata.

getDataDRBundleName

Facoltativo.

Immettere un DataRaptor da utilizzare per recuperare le informazioni sulle policy (asset).

Se si specificano sia getDataDRBundleName che getDataCustomClassName, il servizio utilizza il DataRaptor specificato, non la classe personalizzata. Se si specifica getDataDRBundleName ma non getDataCustomClassName, il servizio utilizza il DataRaptor specificato, non la classe predefinita.

getDataCustomClassName

Facoltativo.

Immettere una classe personalizzata da utilizzare per recuperare le informazioni sulla policy (asset). Questo valore sostituisce la classe predefinita utilizzata per recuperare le informazioni.

includeTaxesAndFees

true o false

Per impostazione predefinita, true.

Quando è impostato su true, restituisce i campi imposta e spesa nel JSON della policy.

Se specificato e impostato su true, restituisce i record AssetPricingAdjustment__c associati a ogni AssetCoverage__c, AssetInsuredItem__c, AssetPartyRelationship__c o policy tramite il campo taxesAndFees.

omitAttributeCategory

true o false

Se impostato su true, il servizio non restituisce attributi per i prodotti (articoli assicurati, assicurati, coperture) nella polizza.

omitCoverages

true o false

Se impostato su true, il servizio restituisce gli articoli assicurati, gli assicurati gli articoli assicurati secondari ma non le coperture.

Input JSON

Questo servizio non utilizza il JSON di input.

JSON di output

Il servizio restituisce una matrice di record dell'oggetto policy (asset). Questi record sono strutturati in modo simile ai record prodotto, ma includono campi aggiuntivi.

Il servizio restituisce anche i record estratti dal prodotto, incluse le coperture facoltative che non fanno parte dell'oggetto polizza (non sono state selezionate come coperture per questa polizza).

"totalSize": 1,
"records": [{
    "displaySequence": -1,
    "Id": "02if4000001vM1LAAU",
    "productId": "01tf4000001lKNQAA2",
    "productName": "Watercraft",
    "EffectiveStart": "2018-05-21",
    "EffectiveEnd": "2019-05-20",
    "Price": 20,
    "PricingFormula__c": "wcPropertyNet + wcLiabilityNet + wcUninsuredNet + wcMedPaymentsNet + wcPersonalEffectsNet + wcTrailerNet + wcTowingNet + wcFishingEquipNet + wcBoatLiftNet",
    "ProductCode": "Watercraft",
    "CalculatedPriceData": {
      "ID": "0",
      "wcBoatLiftNet": 20
    },
    "childProducts": {
      "totalSize": 1,
      "records": [...]
    ]

Oltre ai campi descritti nel modello di struttura JSON prodotto, il JSON di output per questo servizio include i seguenti campi dell'oggetto policy (asset) (utilizzando l'insieme di campi GetPolicyDetailsFields):

  • productId

  • productName

  • EffectiveStart

  • EffectiveEnd

  • StandardPremium__c

  • PricingSource__c

  • PricingFormula__c

  • productCode

  • term

  • AssetCoverage__c

    Tutti i campi accessibili

  • AssetInsuredItem__c

    Tutti i campi accessibili

Esempi

Il servizio viene in genere utilizzato negli OmniScript che modificano o annullano le policy.

 
Caricamento
Salesforce Help | Article