Loading
保險
InsPolicyService:getPolicyDetails

您位於此處：

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

InsPolicyService:getPolicyDetails

使用此服務取得現有保單的涵蓋範圍、投保項目、定價及其他資訊,包括未選取的選用涵蓋範圍。

備註
備註

若要取得保單詳細資料,您必須擁有「保單」記錄的讀取存取權。設定您的共用設定和共用規則,以提供對要求原則記錄的存取權。請參閱「共用物件和欄位」。

例如,您可以使用此服務在原則修改 OmniScript 或整合程序中取得並顯示現有原則詳細資料。

類別:InsPolicyService

方法:getPolicyDetails

運作方式

  1. 使用 policyId 或 assetId 取得保單記錄及其相關聯的涵蓋範圍和投保項目。

  2. 移至與原則相關聯的產品規格,以取得未選取的選用涵蓋範圍規格。

  3. 傳回包含保險項目、保單涵蓋範圍和選用涵蓋範圍的 JSON 結構。

附加費

如果使用 calculateTaxesAndFees 服務,則會針對下列記錄和原則傳回下列欄位:

針對每個 AssetCoverage__c、AssetInsuredItem__c 和 AssetPartyRelationship__c 記錄,只要欄位不是空值,就會傳回下列欄位:

  • taxAmount 和 TaxAmount__c (值相等)

  • feeAmount 和 FeeAmount__c (值相等)

  • totalTaxFeeAmount__c 和 totalTaxFeeAmount (等同於 TaxAmount__c + FeeAmount__c)

  • ProratedTaxAmount__c

  • ProratedFeeAmount__c

  • TotalAmount__c

  • TotalProratedAmount__c

如果欄位不是空值,則會針對原則傳回下列欄位:

  • TotalTaxAmount__c

  • TotalFeeAmount__c

  • totalTaxFeeAmount__c 和 TotalTaxFeeAmount (等同於 TotalTaxAmount__c + TotalFeeAmount__c)

  • TotalTaxForTerm__c

  • TotalFeeForTerm__c

  • TotalAmount__c

  • TotalAmountForTerm__c

遠端選項

選項

描述

assetId

或

policyId

必要。

要取得詳細資料之原則 (資產) 的識別碼。

此識別碼的 sObject 類型決定服務使用的資料模型「資產型」或「Salesforce FSC」。

如果您在未指定 getDataDRBundleName 或 getDataCustomClassNameDR 的情況下提供 assetId,則服務會自動使用「資產」資料模型。

如果您在未指定 getDataDRBundleName 或 getDataCustomClassNameDR 的情況下提供 policyId,則服務會自動使用 Salesforce FSC 資料模型。

getCoverages

%instanceKey%

僅傳回指定例項的涵蓋範圍詳細資料。

getDataDRBundleName

選擇性。

輸入 DataRaptor 以供用於來取回原則 (資產) 資訊。

如果您指定 getDataDRBundleName 與 getDataCustomClassName,則服務會使用指定的 DataRaptor,而非自訂類別。如果您指定 getDataDRBundleName 但未指定 getDataCustomClassName,則服務會使用指定的 DataRaptor,而非預設類別。

getDataCustomClassName

選擇性。

輸入要用來取得原則 (資產) 資訊的自訂類別。此值會覆寫用於檢取資訊的預設類別。

includeTaxesAndFees

true 或 false

預設為 true。

設定為 true 時,傳回原則 JSON 中的稅額和費用欄位。

如果提供並設定為 true,則會透過 taxesAndFees 欄位傳回與每個 AssetCoverage__c、AssetInsuredItem__c、AssetPartyRelationship__c 或 Policy 相關聯的 AssetPricingAdjustment__c 記錄。

omitAttributeCategory

true 或 false

設定為 true 時,服務不會傳回保單中產品 (受保項目、受保對象、涵蓋範圍) 的屬性。

omitCoverages

true 或 false

設定為 true 時,服務會退回投保項目、投保對象子系投保項目,但不會退回保險。

輸入 JSON

此服務不使用輸入 JSON。

輸出 JSON

服務會從原則 (資產) 物件傳回記錄陣列。這些記錄的結構與產品記錄類似,但包含其他欄位。

服務也會傳回從產品提取的記錄,包括不屬於原則物件的選擇性涵蓋範圍 (未選取為此原則的涵蓋範圍)。

"totalSize": 1,
"records": [{
    "displaySequence": -1,
    "Id": "02if4000001vM1LAAU",
    "productId": "01tf4000001lKNQAA2",
    "productName": "Watercraft",
    "EffectiveStart": "2018-05-21",
    "EffectiveEnd": "2019-05-20",
    "Price": 20,
    "PricingFormula__c": "wcPropertyNet + wcLiabilityNet + wcUninsuredNet + wcMedPaymentsNet + wcPersonalEffectsNet + wcTrailerNet + wcTowingNet + wcFishingEquipNet + wcBoatLiftNet",
    "ProductCode": "Watercraft",
    "CalculatedPriceData": {
      "ID": "0",
      "wcBoatLiftNet": 20
    },
    "childProducts": {
      "totalSize": 1,
      "records": [...]
    ]

除了「產品 JSON 結構模型」中所述的欄位外,此服務的輸出 JSON 包含來自原則 (資產) 物件 (使用 GetPolicyDetailsFields 欄位集) 的下列欄位:

  • productId

  • productName

  • EffectiveStart

  • EffectiveEnd

  • StandardPremium__c

  • PricingSource__c

  • PricingFormula__c

  • productCode

  • term

  • AssetCoverage__c

    所有可存取的欄位

  • AssetInsuredItem__c

    所有可存取的欄位

範例

此服務通常用於修改或取消原則的 OmniScript。

 
正在載入
Salesforce Help | Article