Loading
メールアドレスがデフォルトのログイン方式となります 続きを読む
Insurance
InsPolicyService:removeInsuredItem

InsPolicyService:removeInsuredItem

このサービスを使用して、既存の保険契約から保険項目を削除します。

このサービスは、ポリシー OmniScript および Integration Procedure の変更に含めることができます。これは、完全なポリシー変更フローを形成する他のサービスで最適に機能します。たとえば、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%

保険契約から削除される保険項目の ID。

policyId

Salesforce FSC を使用する場合にのみ必要です。

InsurancePolicy の ID。

ratingDate

ポリシーを複製するための評価手順を決定します。提供しない場合、変更後のポリシーの発効日に基づいて価格が設定されます。

メモ
メモ データ型が日付であるため、 ratingField に特定の時間を渡すことはできません。そのため、評価のタイムスタンプはデフォルトで午前 12 時になります。

Input 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": {
      ...
    }
 
読み込み中
Salesforce Help | Article