Loading
保險
InsQuoteService:getQuoteDetail

您位於此處：

  1. Salesforce 說明
  2. 文件
  3. 數位保險

InsQuoteService:getQuoteDetail

使用此服務以 JSON 取得所有報價詳細資料。

此服務適用於採用已儲存報價並從中建立保單或健康計畫的流程。

類別:InsQuoteService

方法:getQuoteDetail

運作方式

  1. 服務會進行 quoteId 並尋找報價。

  2. 服務會傳回包含以下 金鑰的 JSON:值:

    • quoteDetails:報價欄位值

      包含具有屬性的報價欄位值。

    • insuredItems:投保項目與投保對象

      包含 InsuredItemSpec 和 InsuredPartySpec 報價條列詳細資料。(不適用於 Vlocity Health。)

    • productConfigurationDetail:產品組態

      產品 JSON 結構模型

稅金與費用

此服務的運作方式如下:

  • 如果欄位不是空值,則會針對每個 QuoteLineItem 傳回 taxAmount、TaxAmount__c、feeAmount、FeeAmount__c 和 TotalAmount__c 欄位。

  • 如果欄位不是空值,則會針對報價傳回 TotalTaxAmount__c、TotalFeeAmount__c 和 TotalAmount__c 欄位。

  • totalTaxFeeAmount= TaxAmount__c + FeeAmount__c

輸入

如果 isForExternal 遠端選項設定為 true,則服務需要這些輸入。如果 isForExternal 為空白或設定為 false,請省略這些輸入。

選項

描述
action

isForExternal=true 時為必要。

服務會使用此值建立外部定價 API 所需的「動作」節點。

可能的值

  • submit
  • reprice
quoteId

isForExternal=true 時為必要。

要取用詳細資料的報價識別碼。

遠端選項

選項

描述

action

isForExternal=true 時為必要。

表示外部伺服器要處理報價的動作。

可能的值

  • submit
  • reprice

針對提交,會傳遞 Quote 的 sourceSystemIdentifer。針對重新定價,會通過要重新定價或評價的 Root QuoteLineItem SourceSystemIdentifer。

disableAttributeCategories

選擇性。

在輸出 JSON 中顯示 attributeCategories。

如果此標記設定為 True,則 getQuoteDetail 服務會從回應中省略 attributeCategory 節點,且 createPolicyVersion 服務無法建立原則字詞。若要確保 createPolicyVersion 服務建立原則字詞,請將此標記設定為 false。

disableChildProducts

選擇性。

在輸出 JSON 的 childProduct 下顯示記錄。

disableOptionalCoverages

選擇性。

設定為 true 時,選擇性涵蓋不會在 OmniScript 中顯示為報價的一部分。

includeOriginalPlan

若設定為 true,則在續約中包含原始產品。

否則只會顯示取代產品。

includeOpportunity

如果設定為 true,則會在個別的 JSON 節點中傳回報價的機會詳細資料。傳回的欄位由欄位集 OpportunityDetail 決定。

預設值為 false。

instanceKey

與報價條列項目相關聯的唯一識別碼,用於識別產品的例項。instanceKey 是手動指定的或由系統產生的。

isMultiRoot

true 或 false

針對包含多個保險產品 (計畫) 的報價設定為 true。

例如,包含健康計畫、牙科計畫和願景計畫的報價必須將此選項設為「true」,才能傳回計畫的詳細資料。

isForExternal

如果設定為 true,則服務會傳回簡化的 JSON,以便對應至外部原則管理系統。

productCode

與「報價條列項目」相關聯的產品代碼。

productSpecId

與「報價條列項目」相關聯產品的識別碼。

quoteId

必要。

QuoteId,如果要求是針對客戶,則為加密的 QuoteId。

quoteLineItemId

報價條列項目的識別碼。僅傳回一個具有完全相符識別碼的「報價條列項目」。如果要求中包含其他不符合退貨項目詳細資料的篩選條件,則不會傳回任何項目。

輸入 JSON

以下是輸入 JSON 的格式:

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

以下是輸入 JSON 的範例:

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

輸出 JSON (保險)

服務會傳回包含以下節點的 JSON:

  • 受保者與受保項目

  • 報價詳細資料欄位集

  • 產品組態詳細資料

小秘訣
小秘訣

quoteDetail 欄位集存在於多個物件上,但在建立 JSON 回應中的 productConfigurationDetail 節點時,InsQuoteService:getQuoteDetail 服務只會讀取在「報價條列項目」物件上設定的欄位。此服務會忽略 Product2 物件上的欄位集。

若要減少裝載大小並改善 Omniscript 效能,請在 quoteDetail 欄位集中新增或移除欄位。預設會包含一些「報價條列項目」欄位,例如「產品名稱」、「產品代碼」、「產品識別碼」。我們建議您將這些集保持不變,因為這些集對報價至關重要。

{
  "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 (健康狀況)

服務會傳回包含以下節點的 JSON:

  • 報價詳細資料欄位集

  • 產品組態詳細資料

{
  "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"
}
 
正在載入
Salesforce Help | Article