Loading
Forsikring
InsQuoteService:getQuoteDetail

InsQuoteService:getQuoteDetail

Brug denne tjeneste til at hente alle tilbudsdetaljer som JSON.

Denne tjeneste fungerer godt for forløb, der tager et gemt tilbud og opretter enten en forsikringspolice eller en helbredsplan fra den.

Kategori: InsQuoteService

Metode: getQuoteDetail

Sådan fungerer det

  1. Tjenesten tager en quoteId og finder tilbuddet.

  2. Tjenesten returnerer JSON, der indeholder disse nøgler: værdier:

    • quoteDetails: Tilbudsfeltværdier

      Inkluderer tilbudsfeltværdier med attributter.

    • insuredItems: Forsikrede elementer og forsikrede parter

      Inkluderer InsuredItemSpec- og InsuredPartySpec- tilbudslinjeoplysninger. (Ikke gældende for Vlocity-tilstand).

    • productConfigurationDetail: Produktkonfigurationer

      Produkt-JSON-strukturmodel

Skatter og gebyrer

Sådan fungerer denne tjeneste:

  • Felterne taxAmount, TaxAmount__c, feeAmount, FeeAmount__c og TotalAmount__c returneres for hver QuoteLineItem, hvis felterne ikke er nul.

  • Felterne TotalTaxAmount__c, TotalFeeAmount__c og TotalAmount__c returneres for tilbuddet, hvis felterne ikke er nul.

  • totalTaxFeeAmount= TaxAmount__c + FeeAmount__c

Input

Tjenesten kræver disse input, hvis isForExternal-fjernindstillingen er indstillet til true. Udelad disse input, hvis isForExternal er tomt eller indstillet til falsk.

Indstilling

Beskrivelse

action

Krævet, når isForExternal=true.

Tjenesten bruger denne værdi til at oprette den handlingsnode, der er påkrævet for den eksterne prissætnings-API.

Mulige værdier:

  • submit
  • reprice
quoteId

Krævet, når isForExternal=true.

Id'et på det tilbud, der skal hentes detaljer for.

Fjernindstillinger

Indstilling

Beskrivelse

action

Krævet, når isForExternal=true.

Angiver den handling, som den eksterne server skal udføre med tilbuddet.

Mulige værdier:

  • submit
  • reprice

Til indsendelse videregives Quote sourceSystemIdentifer. Til gengæld passeres SourceSystemIdentifer for den Root QuoteLineItem, der skal omprissættes eller noteres.

disableAttributeCategories

Valgfrit.

Vis attributeCategories i output JSON.

Hvis dette flag er indstillet til true, udelader getQuoteDetail attributeCategory-noden fra svaret, og createPolicyVersion kan ikke oprette politikudtryk. Hvis du vil sikre, at createPolicyVersion opretter politikbetingelser, skal du indstille dette flag til falsk.

disableChildProducts

Valgfrit.

Vis registreringer under childProduct i output JSON.

disableOptionalCoverages

Valgfrit.

Når den er indstillet til true, vises valgfri dækninger ikke som en del af et tilbud i et OmniScript.

includeOriginalPlan

Hvis den er indstillet til true, inkluderes de oprindelige produkter i en fornyelse.

Ellers vises kun erstatningsprodukter.

includeOpportunity

Hvis den er indstillet til true, skal du returnere tilbuddets salgsmulighedsdetaljer i en separat JSON-node. De returnerede felter bestemmes af feltsættets OpportunityDetail.

Standardværdien er false.

instanceKey

En entydig identifikator, der er knyttet til tilbudslinjevaren, der bruges til at identificere forekomsten af et produkt. instanceKey angives manuelt eller genereres af systemet.

isMultiRoot

true eller false

Indstillet til true for tilbud, der inkluderer mere end et forsikringsprodukt (plan).

F.eks. skal et tilbud, der inkluderer en sundhedsplan, en tandplan og en visionsplan, have denne indstilling indstillet til true for at returnere detaljerne for planerne.

isForExternal

Hvis den er indstillet til true, returnerer tjenesten den forenklede JSON for nem tilknytning til et eksternt politikadministratorsystem.

productCode

Kode på det produkt, der er knyttet til en tilbudslinjevare.

productSpecId

Id for det produkt, der er knyttet til en tilbudslinjevare.

quoteId

Påkrævet.

QuoteId eller den krypterede QuoteId, hvis anmodningen er til en kunde.

quoteLineItemId

Id for tilbudslinjevare. Returnerer kun en tilbudslinjevare med det nøjagtige matchende id. Hvis der er andre filtre inkluderet i anmodningen, der ikke opfylder det returnerede elements detaljer, returneres der ingen elementer.

Input JSON

Her er formatet på input-JSON:

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

Her er et eksempel på input-JSON:

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

Output JSON (Insurance)

Tjenesten returnerer en JSON, der indeholder disse noder:

  • Sikrede parter og forsikrede elementer

  • Feltsæt til tilbudsdetaljer

  • Produktkonfigurationsdetaljer

Tip
Tip

Feltsættet quoteDetail findes på flere objekter, men tjenesten InsQuoteService:getQuoteDetail læser kun det felt, der er angivet på objektet Tilbudslinjevare, når den opbygger productConfigurationDetail i JSON-svaret. Feltsæt på Product2-objekt ignoreres af denne tjeneste.

Hvis du vil reducere størrelse på dataene og forbedre Omniscript-ydeevnen, skal du tilføje eller fjerne felter i feltsættet quoteDetail. Nogle få Felter for tilbudslinjevare, f.eks. Produktnavn, Produktkode, Produkt-id er som standard inkluderet. Vi anbefaler, at du bevarer disse sæt uændrede, da de er vigtige for et tilbud.

{
  "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"
}

Output-JSON (Health)

Tjenesten returnerer en JSON, der indeholder disse noder:

  • Feltsæt til tilbudsdetaljer

  • Produktkonfigurationsdetaljer

{
  "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"
}
 
Indlæser
Salesforce Help | Article