Loading
Verzekering
InsQuoteService:getQuoteDetail

U bent hier:

  1. Help van Salesforce
  2. Documenten
  3. Digitale verzekering

InsQuoteService:getQuoteDetail

Gebruik deze service om alle offertedetails op te halen als JSON.

Deze service werkt goed voor stromen die een opgeslagen offerte accepteren en er een verzekeringspolis of een gezondheidsplan van maken.

Klasse: InsQuoteService

Methode: getQuoteDetail

De manier waarop het werkt...

  1. De service neemt een quoteId en vindt de offerte.

  2. De service retourneert JSON die deze sleutel bevat: values:

    • quoteDetails: Waarden van offertevelden

      Omvat offerteveldwaarden met kenmerken.

    • insuredItems: Verzekerden en verzekerden

      Omvat offerteregeldetails van InsuredItemSpec en InsuredPartySpec. (Niet van toepassing op Vlocity Health.)

    • productConfigurationDetail: Productconfiguraties

      Product-JSON-structuurmodel

Belastingen en toeslagen

Deze service werkt als volgt:

  • De velden taxAmount, TaxAmount__c, feeAmount, FeeAmount__c en TotalAmount__c worden voor elke QuoteLineItem geretourneerd, als de velden niet null zijn.

  • De velden TotalTaxAmount__c, TotalFeeAmount__c en TotalAmount__c worden geretourneerd voor de offerte, als de velden niet null zijn.

  • De totalTaxFeeAmount = TaxAmount__c + FeeAmount__c

Invoer

De service vereist deze invoer als de externe optie isForExternal is ingesteld op true (waar). Laat deze invoer weg als isForExternal leeg is of is ingesteld op false (onwaar).

Optie

Beschrijving
action

Verplicht wanneer isForExternal=true.

De service gebruikt deze waarde om het actieknooppunt te maken dat vereist is voor de externe prijsstellings-API.

Mogelijke waarden:

  • submit
  • reprice
quoteId

Verplicht wanneer isForExternal=true.

De ID van de offerte waarvoor details moeten worden opgehaald.

Externe opties

Optie

Beschrijving

action

Verplicht wanneer isForExternal=true.

Geeft de actie voor de externe server aan die met de offerte te maken heeft.

Mogelijke waarden:

  • submit
  • reprice

Voor indienen wordt de sourceSystemIdentifer van de Quote doorgegeven. Voor herprijs wordt de SourceSystemIdentifer van de Root QuoteLineItem doorgegeven die opnieuw moet worden geprijsd of beoordeeld.

disableAttributeCategories

Optioneel.

Toon attributeCategories in uitvoer-JSON.

Als deze vlag is ingesteld op true (waar), laat de getQuoteDetail het attributeCategory weg uit de respons en kan de createPolicyVersion geen beleidstermen maken. Als u er zeker van wilt zijn dat de createPolicyVersion beleidsvoorwaarden maakt, stelt u deze vlag in op false (onwaar).

disableChildProducts

Optioneel.

Records onder childProduct tonen in uitvoer-JSON.

disableOptionalCoverages

Optioneel.

Indien ingesteld op true (waar), worden optionele dekkingen niet weergegeven als onderdeel van een offerte in een OmniScript.

includeOriginalPlan

Indien ingesteld op true, omvat het originele producten in een verlenging.

Anders worden alleen vervangende producten getoond.

includeOpportunity

Indien ingesteld op true, retourneert u de opportunitydetails van de offerte in een afzonderlijk JSON-knooppunt. Welke velden worden geretourneerd, wordt bepaald door de OpportunityDetail van de veldset.

De standaardwaarde is false.

instanceKey

Een unieke identifier die is gekoppeld aan het offerteregelitem en die wordt gebruikt om het exemplaar van een product te identificeren. De instanceKey wordt handmatig of door het systeem gegenereerd opgegeven.

isMultiRoot

true of false

Ingesteld op true voor offertes die meer dan één verzekeringsproduct (plan) bevatten.

Zo moet voor een offerte met een gezondheidsplan, een tandartsplan en een visieplan deze optie zijn ingesteld op true om de details van de plannen te retourneren.

isForExternal

Indien ingesteld op true, retourneert de service de vereenvoudigde JSON voor eenvoudige toewijzing aan een extern beleidbeheersysteem.

productCode

Code van het product dat is gekoppeld aan een offerteregelitem.

productSpecId

ID van het product dat is gekoppeld aan een offerteregelitem.

quoteId

Verplicht.

De QuoteId, of de versleutelde QuoteId als het verzoek voor een klant is.

quoteLineItemId

ID van het offerteregelitem. Retourneert slechts één offerteregelitem met exact dezelfde overeenkomende ID. Als het verzoek andere filters bevat die niet voldoen aan de details van het geretourneerde item, worden er geen items geretourneerd.

Invoer-JSON

Hier is de indeling van de invoer-JSON:

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

Hier is een voorbeeld van de invoer-JSON:

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

Uitvoer-JSON (verzekering)

De service retourneert een JSON die deze knooppunten bevat:

  • Verzekerden en verzekerden

  • Veldset Offertedetails

  • Productconfiguratiedetails

Tip
Tip

De veldset quoteDetail bestaat voor verschillende objecten, maar de service InsQuoteService:getQuoteDetail leest alleen de veldset voor het object Offerteregelitem wanneer het productConfigurationDetail in de JSON-respons wordt samengesteld. Veldsets voor het object Product2 worden door deze service genegeerd.

Als u de payloadgrootte wilt verlagen en de Omniscript-prestaties wilt verbeteren, voegt u velden toe aan of verwijdert u ze uit de quoteDetail. Standaard worden enkele velden voor Offerteregelitem opgenomen, zoals Productnaam, Productcode, Product-ID. U wordt aangeraden deze sets ongewijzigd te laten, omdat ze essentieel zijn voor een offerte.

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

Uitvoer-JSON (gezondheid)

De service retourneert een JSON die deze knooppunten bevat:

  • Veldset Offertedetails

  • Productconfiguratiedetails

{
  "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"
}
 
Wordt geladen
Salesforce Help | Article