Loading
Assicurazioni
InsQuoteService:getQuoteDetail

InsQuoteService:getQuoteDetail

Utilizzare questo servizio per ottenere tutti i dettagli del preventivo come JSON.

Questo servizio funziona bene per i flussi che prendono un preventivo salvato e creano una polizza assicurativa o un'assicurazione sanitaria da esso.

Classe: InsQuoteService

Metodo: getQuoteDetail

Funzionamento

  1. Il servizio prende una quoteId e trova il preventivo.

  2. Il servizio restituisce JSON che include questi valori chiave:

    • quoteDetails: Valori dei campi preventivo

      Include i valori dei campi preventivo con attributi.

    • insuredItems: Voci assicurate e assicurati

      Include i dettagli delle voci preventivo InsuredItemSpec e InsuredPartySpec. (Non applicabile per Vlocity Health.)

    • productConfigurationDetail: Configurazioni dei prodotti

      Modello di struttura JSON del prodotto

Tasse e commissioni

Ecco come funziona questo servizio:

  • I campi taxAmount, TaxAmount__c, feeAmount, FeeAmount__c e TotalAmount__c vengono restituiti per ogni QuoteLineItem, se i campi non sono nulli.

  • I campi TotalTaxAmount__c, TotalFeeAmount__c e TotalAmount__c vengono restituiti per il preventivo, se i campi non sono nulli.

  • Il totalTaxFeeAmount = TaxAmount__c + FeeAmount__c

Input

Il servizio richiede questi input se l'opzione isForExternal remoto è impostata su true. Omettere questi input se isForExternal è vuoto o impostato su false.

Opzione

Descrizione

action

Obbligatorio quando isForExternal=true.

Il servizio utilizza questo valore per creare il nodo Azione richiesto per l'API prezzi esterni.

Valori possibili:

  • submit
  • reprice
quoteId

Obbligatorio quando isForExternal=true.

ID del preventivo per cui recuperare i dettagli.

Opzioni remote

Opzione

Descrizione

action

Obbligatorio quando isForExternal=true.

Indica l'azione che il server esterno deve eseguire con il preventivo.

Valori possibili:

  • submit
  • reprice

Per l'invio, viene superato il sourceSystemIdentifer del Quote. Per il reprice, viene passato il SourceSystemIdentifer del Root QuoteLineItem da repriced o da valutare.

disableAttributeCategories

Facoltativo.

Mostra attributeCategories nel JSON di output.

Se questo flag è impostato su true, il servizio getQuoteDetail omette il nodo attributeCategory dalla risposta e il servizio createPolicyVersion non riesce a creare i termini della policy. Per assicurarsi che il servizio createPolicyVersion crei i termini della policy, impostare questo flag su false.

disableChildProducts

Facoltativo.

Mostra i record in childProduct nel JSON di output.

disableOptionalCoverages

Facoltativo.

Se impostata su true, le coperture facoltative non vengono visualizzate come parte di un preventivo in un OmniScript.

includeOriginalPlan

Se impostata su true, include i prodotti originali in un rinnovo.

In caso contrario, vengono visualizzati solo i prodotti sostitutivi.

includeOpportunity

Se impostato su true, restituire i dettagli dell'opportunità del preventivo in un nodo JSON separato. I campi restituiti sono determinati dalla OpportunityDetail dell'insieme di campi.

Il valore predefinito è false.

instanceKey

Identificatore univoco associato alla voce preventivo utilizzato per identificare l'istanza di un prodotto. instanceKey viene specificato manualmente o generato dal sistema.

isMultiRoot

true o false

Impostare su true per i preventivi che includono più di un prodotto assicurativo (piano).

Ad esempio, un preventivo che include un'assicurazione sanitaria, un piano dentistico e un piano di visione deve avere questa opzione impostata su true per restituire i dettagli dei piani.

isForExternal

Se impostato su true, il servizio restituisce il JSON semplificato per facilitare la mappatura a un sistema di amministrazione di policy esterne.

productCode

Codice del prodotto associato a una Voce preventivo.

productSpecId

ID del prodotto associato a una Voce preventivo.

quoteId

Obbligatorio.

Il QuoteId o il QuoteId crittografato se la richiesta è per un cliente.

quoteLineItemId

ID della voce preventivo. Restituisce una sola Voce preventivo con l'ID esatto corrispondente. Se nella richiesta sono inclusi altri filtri che non soddisfano i dettagli dell'articolo restituito, non viene restituito alcun articolo.

Input JSON

Di seguito è riportato il formato del JSON di input:

{
  "quoteId": "...",
  "action":  "..."
}

Di seguito è riportato un esempio di JSON di input:

{
  "quoteId":"0Q06g0000009YA3CAM"
  "action": "submit"
}

JSON di output (assicurazioni)

Il servizio restituisce un JSON contenente i seguenti nodi:

  • Assicurati e voci assicurate

  • Insieme di campi Dettagli preventivo

  • Dettagli configurazione prodotto

Suggerimento
Suggerimento

L'insieme di campi quoteDetail esiste in diversi oggetti, ma il servizio InsQuoteService:getQuoteDetail legge solo il campo impostato nell'oggetto Voce preventivo quando crea il nodo productConfigurationDetail nella risposta JSON. Gli insiemi di campi sull'oggetto Product2 vengono ignorati da questo servizio.

Per ridurre le dimensioni del payload e migliorare le prestazioni di OmniScript, aggiungere o rimuovere i campi nell'insieme di campi quoteDetail. Alcuni campi Voce preventivo come Nome prodotto, Codice prodotto, ID prodotto sono inclusi per impostazione predefinita. Si consiglia di mantenere invariati questi insiemi perché sono essenziali per un preventivo.

{
  "productConfigurationDetail": {
    "records": [...]
    "totalSize": 1
  },
  "insuredItems": {
    "Driver": [{
        "instanceKey": "Joan Smith",
        "isPrimary": false,
        "isParent": false,
        "LN": "Smith",
        "AGE": 20,
        "FN": "Joan",
        "GENDER": "Female",
        "FirstName": "Joan",
        "LastName": "Smith"
      },
      {
        ...
      }
    ],
    "Auto": [{
        "instanceKey": "2015 Lexus LX250",
        "autoAntiTheft": true,
        "est_annual_mileage": "1-10000",
        "autoLicNum": "Lexus",
        "autoModel": "LX250",
        "autoYear": 2015,
        "BodyClass": "Sedan/Saloon",
        "VehicleType": "PASSENGER CAR",
        "isPrimary": true
        "isParent": false,
      },
      {
        ...
      }
    ]
  },
  "quoteDetail": {
    "attributes": {
      "type": "Quote",
      "url": "/services/data/v43.0/sobjects/Quote/0Q01I000000qeWLSAY"
    },
    "ins_daily4__EffectiveDate__c": "2018-07-27",
    "ins_daily4__TotalSumInsured__c": 0,
    "AccountId": "0011I00000QknfjQAB",
    "ins_daily4__RootItemTotal__c": 0,
    "Id": "0Q01I000000qeWLSAY"
  },
  "error": "OK"
}

JSON di output (Salute)

Il servizio restituisce un JSON contenente i seguenti nodi:

  • Insieme di campi Dettagli preventivo

  • Dettagli configurazione prodotto

{
  "productConfigurationDetail": {
    "records": [...]
    "totalSize": 1
  },
  "quoteDetail": {
    "attributes": {
      "type": "Quote",
      "url": "/services/data/v43.0/sobjects/Quote/0Q01I000000qeWLSAY"
    },
    "ins_daily4__EffectiveDate__c": "2018-07-27",
    "ins_daily4__TotalSumInsured__c": 0,
    "AccountId": "0011I00000QknfjQAB",
    "ins_daily4__RootItemTotal__c": 0,
    "Id": "0Q01I000000qeWLSAY"
  },
  "error": "OK"
}
 
Caricamento
Salesforce Help | Article