InsPolicyService:removeInsuredItem

此服務可以是修改原則 OmniScript 和「整合程序」的一部分。其最適用於形成完整原則修改流程的其他服務。例如,它可以出現在 getInsuredItems 之後和 createPolicyVersion 之前。

此服務適用於 Salesforce Financial Services Cloud。

類別:InsPolicyService

方法:removeInsuredItem

運作方式

1. 服務會取得 insuredItemId 和 effectiveDate。

2. 將投保項目從原則 JSON 中移除。

3. 重新計算原則的保費,並傳回價格差異和修改後的原則 JSON。

   如果原則 JSON 包含稅金和/或費用,則原則 JSON 會包含並更新 taxesAndFees、taxAmount、feeAmount、totalTaxForTermDiff 和/或 totalFeeForTermDiff 欄位 (視使用的欄位而定)。

備註

您也可以在此使用 InsProductService:getRatedProducts 服務中使用的所有遠端選項。

遠端選項

選項	描述
aggByKey	PRODUCT.instanceKey 服務會將此選項傳送至包含彙總步驟的計算程序,以便計算程序傳回正確的金額。 例如,汽車保險保單會將多個司機附加至每部受保車輛。受保車輛針對原則中的每個例項有個別的 instanceKey。aggByKey 會取得車輛的所有例項金鑰,並為每個 instanceKey 建立涵蓋範圍保費陣列,並將其傳送至計算程序,以便正確計算保費。
calculateTaxesAndFees	true 或 false 計算目標產品的稅額和費用。 如果設定為 true,則會重新計算已修改原則的稅額和費用。 如果您使用 Salesforce FSC 並將此選項設為 true,則您也必須指定 getDataDRBundleName 或 getDataCustomClassName 選項。
effectiveDate	必要。 “YYYY-MM-DD HH:MM:SS” 或 %OmniScriptDataElement% 預設為今天日期。 移除此保險項目的生效日期。
getDataDRBundleName	Omnistudio 資料對應器的名稱,此服務會用來取得原則 (資產) 資訊。 如果您使用 Salesforce FSC,則必須指定此選項或 getDataCustomClassName。
getDataCustomClassName	此服務使用的自訂類別名稱,此名稱會用於取得原則 (資產) 資訊。 如果您使用 Salesforce FSC,則必須指定此選項或 getDataDRBundleName。
includeInputKeys	服務傳入和傳出計算程序之以逗號分隔金鑰/值配對的字串。 這些金鑰/值配對包含在 CalculatedPriceData 物件內的輸出產品物件中。他們可以幫助您剖析計算結果。 只有計算程序使用的輸入索引鍵在結果中具有值。
insuredItemId	必要。 %theIdYouNeed% 要從原則中移除之保險項目的識別碼。
policyId	只有在您使用 Salesforce FSC 時才需要。 InsurancePolicy 的識別碼。
ratingDate	決定重新定價原則的等級程序。若未提供,則會根據修改原則的生效日期完成定價。 備註 您無法傳遞 ratingField 的特定時間,因為欄位類型為 Date。因此,等級日期時間戳記預設為 12:00 am。

輸入 JSON

此服務不會取得輸入 JSON。

輸出 JSON

服務會傳回輸出 JSON,不含已移除的項目記錄和重新計算的保費資訊。

尤其是針對稅金和費用,會傳回「totalTaxForTermDiff」和「totalFeeForTermDiff」欄位,且只會在計算稅金和費用時顯示。 它們代表目標原則的按比例稅金/費用與修改原則的按比例稅金/費用之間的差異 (類似於 totalPremiumForTermDiff 欄位)。

輸出中包含下列金鑰及其值:

• priceDiff

• totalPremiumForTermDiff

"totalSize": 0,
"records": [{
    "displaySequence": -1,
    "Id": "02i1I000001jL2WQAU",
    "productId": "01t1I000002fuBoQAI",
    "accountId": "0011I00000QknfjQAB",
    "policyNumber": "AUTOROOT-000154-2019-",
    "productName": "Auto Root",
    "EffectiveStart": "2018-08-15",
    "EffectiveEnd": "2019-01-29",
    "Price": 440,
    "PricingFormula__c": "SUM(AutoPremium__autoPremium + rentalTotal + medicalTotal + roadsideTotal + dedWaiverTotal + uninsuredMotoristPDTotal + uninsuredMotoristBITotal)",
    "ProductCode": "AUTOROOT",
    "term": "Semi-Annual",
    "TotalPremiumForTerm__c": 1661.74,
    "CalculatedPriceData": {
      "2015 Lexus LX250": {
        "DRIVER.LN": null,
        "DRIVER.FN": null,
        "AUTO.instanceKey": "2015 Lexus LX250",
        "uninsuredMotoristBITotal": 100,
        "uninsuredMotoristPDTotal": 0,
        "dedWaiverTotal": 10,
        "roadsideTotal": 10,
        "medicalTotal": 10,
        "rentalTotal": 40,
        "comprehensiveTotal": 500,
        "ID": "0"
      },
      "2006 Honda Odyssey": {
        ...
      },
      "2018 530 BMW": {
        ...
      },
      "2016 Camry Toyota": {
        ...
      }
    },
    "priceDiff": -1380,
    "totalPremiumForTermDiff": -904.32,
    "attributeCategories": {
      ...
    }
    "childProducts": {
      ...
    }