InsPolicyService:prepareToCancelPolicy

このサービスは、InsPolicyService:cancelPolicy サービスの前に呼び出す必要があります。

このサービスは、Salesforce Financial Services Cloud と連携します。

クラス: InsPolicyService

方法: prepareToCancelPolicy

操作手順

1. assetIdまたはpolicyIdを取得し、キャンセルするポリシーを見つけます。

2. useIsPaidFlag値に基づいて適切な計算プロセスを使用します。

   [useIsPaidFlag] を false (選択解除) に設定すると、サービスは保険契約の [期間の保険料合計]、[期間の手数料合計]、および [期間の税金合計] を按分し、[キャンセル日] と [保険契約の支払日] に基づいて返金金額を計算します。[Policy Paid To Date (支払済み保険契約日)] が Null の場合、サービスは全額支払われた保険契約を考慮し、[有効期限] を使用します。

   [useIsPaidFlag] を [true] に設定 (選択) すると、このサービスは次の処理を実行します。

   1. 支払スケジュールを使用して、保険契約に対してすでに支払われた総額を計算します。ポリシーの支払総額が、[支払済み] が true (選択済み) に設定された支払スケジュールの金額の合計と等しくなる。この金額は返金の計算に使用されます。

   2. 保険契約の [期間の保険料合計]、[期間の手数料合計]、および [期間の税額合計] を按分し、[キャンセル日] と保険契約のすでに支払われている総額に基づいて返金金額を計算します。

3. このサービスでは、手数料または税金が返金可能かどうかが考慮されます。

4. 保険契約の元の保険料合計とキャンセルされた保険契約の価格差を出力 JSON で返します。

   • 返金金額は保険契約者の観点です。正の金額は、保険契約者への返金を表します。負の金額は、保険契約者の未払い金額を示します。

5. このポリシーに税金と手数料が含まれている場合、Total Tax For Term、Total Fee For Term、refundedTax、refundedFeeも出力 JSON に含まれます。

   サービスがキャンセルする保険契約に税金や手数料が含まれていない場合、これらの項目は出力 JSON から除外されます。

追加料金 (税金および手数料)

このサービス(およびInsPolicyService:cancelPolicyサービス)は、保険契約がキャンセルされたときに税金と手数料の按分と返金を促進します。そのしくみを次に示します。

• priceDiffは、基本的に返金金額であり、数式 = (古いGrossWrittenPremium - 更新されたGrossWrittenPremium) + refundedTax + refundedFee を使用します。

• 更新されたGrossWrittenPremiumは、ポリシーの発効日とキャンセル日に按分されたPremiumAmountです。

• 新しい総額は、対象保険契約のPremiumAmount + StandardTaxAmount + StandardFeeAmount に等しく、すべてキャンセル日に按分されます。

• 対象ポリシーにStandardTaxAmountがある場合、その値はキャンセル日に按分され、出力の TermTaxAmount フィールドを介して返されます。

• 対象ポリシーにStandardFeeAmountがある場合、その値はキャンセル日に按分され、出力の TermFeeAmount フィールドを介して返されます。

• 対象ポリシーに返金可能なInsurancePolicySurchargeまたはAssetPricingAdjustment__cレコードがある場合、按分の返金金額は出力の [refundedTax] 項目と [refundedFee] 項目を介して返されます。関連付けられたInsurancePolicySurchargeまたはAssetPricingAdjustment__cが返金可能な場合、そのPriceListEntry__cは返金可能です。按分された返金金額は、キャンセル日と元の有効期限にわたって計算されます。

リモートオプション

Input JSON

このサービスは、effectiveDate (キャンセルする日付) を含む入力 JSON を取得します。

{
    "Id": "02i6g000002f07VAAQ",
    "effectiveDate": "08/12/2019"
}

出力 JSON

このサービスは、新しいキャンセル日がある保険契約に対して計算された価格差を返します。

{
  "Id": "02i6g000002f07VAAQ",
  "output": {
    "refundedFee": -3.68,
    "totalFeeForTerm": 14.06,
    "refundedTax": -37.93,
    "totalTaxForTerm": 144.84,
    "aggregateTotalPremiumForTerms": 4002.28,
    "priceDiff": -420.97,
    "totalPremiumForTerm": 1448.44,
    "errorCode": "INVOKE-200",
    "error": "OK"
  }
}

出力キーと値