Loading
Försäkring
InsQuoteService:getQuoteDetail

InsQuoteService:getQuoteDetail

Använd denna tjänst för att få alla offertdetaljer som JSON.

Denna tjänst fungerar bra för flöden som tar en sparad offert och skapar antingen en försäkringspolicy eller en hälsoplan från den.

Klass: InsQuoteService

Metod: getQuoteDetail

Så här fungerar det

  1. Tjänsten tar en quoteId och hittar offerten.

  2. Tjänsten returnerar JSON som innehåller dessa nycklar: värden:

    • quoteDetails: Offertfältvärden

      Inkluderar offertfältvärden med attribut.

    • insuredItems: Försäkrade objekt och försäkrade

      Inkluderar detaljer om offertraden InsuredItemSpec och InsuredPartySpec. (Gäller inte för Vlocity Health.)

    • productConfigurationDetail: Produktkonfigurationer

      Produkt JSON-strukturmodell

Skatter och avgifter

Så här fungerar denna tjänst:

  • Fälten taxAmount, TaxAmount__c, feeAmount, FeeAmount__c och TotalAmount__c returneras för varje QuoteLineItem om fälten inte är null.

  • Fälten TotalTaxAmount__c, TotalFeeAmount__c och TotalAmount__c returneras för offerten om fälten inte är null.

  • totalTaxFeeAmount= TaxAmount__c + FeeAmount__c

Indata

Tjänsten kräver dessa indata om alternativet isForExternal är inställt till sant. Utelämna dessa indata om isForExternal är tomt eller inställt till falskt.

Alternativ

Beskrivning

action

Krävs när isForExternal=true.

Tjänsten använder detta värde för att skapa den åtgärdsnod som krävs för API för extern prissättning.

Möjliga värden:

  • submit
  • reprice
quoteId

Krävs när isForExternal=true.

ID för offerten att hämta detaljer för.

Fjärralternativ

Alternativ

Beskrivning

action

Krävs när isForExternal=true.

Indikerar åtgärden för den externa servern att göra med Offerten.

Möjliga värden:

  • submit
  • reprice

För att skicka skickas Quote sourceSystemIdentifer. För ompris skickas SourceSystemIdentifer för Root QuoteLineItem som ska omprissättas eller betygsättas.

disableAttributeCategories

Valfritt.

Visa attributeCategories i JSON för utdata.

Om flaggan är inställd på sant utelämnar getQuoteDetail attributeCategory från svaret och createPolicyVersion skapar inte policytermer. För att se till att createPolicyVersion skapar policytermer, sätt denna flagga till false.

disableChildProducts

Valfritt.

Visa poster under childProduct i JSON för utdata.

disableOptionalCoverages

Valfritt.

När satt till sant visas inte valfria täckningar som en del av en offert i ett OmniScript.

includeOriginalPlan

Om satt till true, inkluderas originalprodukter i en förnyelse.

Annars visas endast ersättningsprodukter.

includeOpportunity

Om satt till true, returnera offertens säljprojektdetaljer i en separat JSON-nod. Vilka fält som returneras avgörs av fältuppsättningens OpportunityDetail.

Standardvärdet är false.

instanceKey

En unik identifierare associerad med offertradartikeln som används för att identifiera instansen av en produkt. instanceKey specificeras manuellt eller systemgenererat.

isMultiRoot

true eller false

Sätt till true för offerter som innehåller mer än en försäkringsprodukt (plan).

Till exempel måste en offert som innehåller en hälsoplan, en tandvårdsplan och en visionsplan ha detta alternativ satt till true för att returnera detaljerna för planerna.

isForExternal

Om satt till true returnerar tjänsten den förenklade JSON för att underlätta mappning till ett administratörssystem för externa policyer.

productCode

Kod för produkten som är associerad med en offertradartikel.

productSpecId

ID för produkten som är associerad med en offertradartikel.

quoteId

Obligatoriskt.

QuoteId, eller den krypterade QuoteId om begäran är till en kund.

quoteLineItemId

ID för offertradartikeln. Returnerar endast en offertradartikel med exakt matchande ID. Om andra filter inkluderas i begäran som inte uppfyller det returnerade objektets detaljer returneras inga objekt.

Indata-JSON

Här är formatet för indata-JSON:

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

Här är ett exempel på indata-JSON:

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

JSON för utdata (försäkring)

Tjänsten returnerar en JSON som innehåller dessa noder:

  • Försäkrade och försäkrade objekt

  • Fältuppsättning för offertdetaljer

  • Detaljer om produktkonfiguration

Tips
Tips

Fältuppsättningen quoteDetail finns på flera objekt, men tjänsten InsQuoteService:getQuoteDetail läser endast fältuppsättningen på objektet Offertradartikel när den bygger productConfigurationDetail i JSON-svaret. Fältuppsättningar i objektet Product2 ignoreras av denna tjänst.

För att minska storleken på belastningen och förbättra Omniscript-prestandan, lägg till eller ta bort fält i quoteDetail. Några offertradartikelfält som Produktnamn, Produktkod, Produkt-ID inkluderas som standard. Vi rekommenderar att du behåller dessa uppsättningar oförändrade eftersom de är viktiga för en offert.

{
  "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 för utdata (Hälsa)

Tjänsten returnerar en JSON som innehåller dessa noder:

  • Fältuppsättning för offertdetaljer

  • Detaljer om produktkonfiguration

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