InsPolicyService:cancelPolicy

このサービスは、InsPolicyService:prepareToCancelPolicyサービスおよびInsPolicyRevenueScheduleService:cancelRevenueScheduleサービスと連携して、ポリシーのキャンセル、返金金額の提供、収益スケジュールの終了 (必要な場合) に必要なすべての変更を完了します。

クラス: InsPolicyService

方法: cancelPolicy

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

操作手順

1. キャンセルするポリシーのassetIdまたはpolicyIdと、キャンセルが有効になるeffectiveDateを使用します。

   

   メモ 有効なキャンセル日を今日より前にすることはできません。

2. ポリシー状況を [Canceled]、[元の有効期限] を [有効期限] の現在の値に、[有効期限] を [キャンセル日] の前日 (タイムスタンプは午後 11 時 59 分) に更新します。

3. 有効期限を、タイムスタンプが午後 11 時 59 分のサービスに渡されるeffectiveDateに変更します。

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

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

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

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

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

   3. 現在の日付またはキャンセル日のいずれか遅い日付に基づいて支払スケジュールを調整します。この日付以降の支払スケジュールが [支払済み] で false (選択解除) に設定されている場合、サービスはスケジュールを削除します。

   4. すべての未払い支払スケジュールの状況 (cancellationDate から過去) を Invalid に更新します。未払金額が新しい支払スケジュールに追加されます。

   5. すでに計算された返金金額と同じ金額で現在の日付の新しい支払スケジュールを作成し、状況をValidとしてマークします。createTransaction が true の場合、サービスはキャンセルトランザクションを作成します。

   6. キャンセル情報で今後のすべての保険契約バージョンを更新します。

      • 状況: キャンセル

      • キャンセル日: サービスに渡されたeffectiveDate

      • 期間保険料、期間税金、期間手数料: 0

      • 有効期限: effectiveDateがサービスに渡される前日 (タイムスタンプは 11:59 PM)

5. 按分された TotalPremiumForTerm をデータベースにコミットします。

6. createTransaction=true で、渡された ID が assetId の場合、AssetTransaction_c (Amount_c=refund, postDate_c および transactionDate_c=effectiveDate, type=transactionType (デフォルトは Canceled)) が作成されます。createTransaction=true で、渡される ID が policyId の場合、サービスは InsurancePolicyTransaction_c または InsurancePolicyTransaction (Amount_c=refund, postDate_c および transactionDate_c=effectiveDate, type=transactionType (デフォルトは Canceled)) を作成します。

   また、取引の詳細オブジェクトに取引内訳データも入力されます。各納入商品、関係者、補償範囲が取引総額にどの程度寄与しているかについて、保険料、税金、手数料の観点でデータが表示されます。保険料、税金、手数料の値が 0 以外の納入商品、関係者、補償のみが表示されています。

7. assetId と新しく作成されたtransactionIdを使用して InsPolicyRevenueScheduleService:cancel をコールします。

8. InsPolicyRevenueScheduleService: キャンセルサービスは、収益スケジュールの終了を計算し、結果をポリシーの収益スケジュールセクションに POST します。返金金額は保険会社の観点です。負の金額は保険契約者に返金され、正の金額は保険契約者の未払い金額を表します。

メモ

このサービスでは、元の保険契約バージョンの期間が 365 日未満 (うるう年の期間が 366 日未満) の保険契約のキャンセルもサポートされます。「保険契約の考慮事項と制限」を参照してください。

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

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

• 対象ポリシーにTotalTaxAmount__cがある場合、その値はキャンセル日に按分され、[TotalTaxForTerm__c] フィールドに設定されます。

• 対象ポリシーにTotalFeeAmount__cがある場合、その値はキャンセル日に按分され、[TotalFeeForTerm__c] フィールドに設定されます。

• [createTransaction] オプション (下記を参照) が true に設定されていて、対象ポリシーに返金可能なAssetPricingAdjustment__cレコードがある場合、按分の返金金額はトランザクションの [TaxAmount__c] 項目と [FeeAmount__c] 項目に設定されます。

(納入商品オブジェクトモデルではなく) 保険契約オブジェクトモデルを使用している場合、項目名は異なります。

• TotalTaxAmount__c = StandardTaxAmount

• TotalTaxForTerm__c = TermTaxAmount

• TotalFeeAmount__c = StandardFeeAmount

• TotalFeeForTerm__c = TermFeeAmount

• AssetPricingAdjustment__c = InsurancePolicySurcharge

• TaxAmount__c = TransactionTaxAmount

• FeeAmount__c = TransactionFeeAmount

ヒント

資産オブジェクトモデルから保険契約オブジェクトモデルへの移行について学習したいですか?「Harmonize Insurance Policies (保険契約の調和)」を参照してください。

リモートオプション

  "additionalFees": {
    "Cancellation Fee": 20,
    "Admin Fee": 10
  }

Input JSON

このサービスは入力 JSON を取りません。

出力 JSON

納入商品オブジェクトモデルを使用している場合、このサービスは JSON outputノードを返します。次に例を示します。

{
  "output": {
    "records": [
      {
        "instest10__TotalAmount__c": 420.97,
        "instest10__TaxAmount__c": 37.93,
        "instest10__FeeAmount__c": 3.68,
        "instest10__Amount__c": 379.36,
        "Id": "a416g0000002CZpAAM"
      }
    ],
    "totalSize": 1
  }
}

保険契約オブジェクトモデルを使用している場合、このサービスは JSON resultsノードを返します。次に例を示します。

{
    "result": {
        "type": "Cancelled",
        "transactionNumber": null,
        "transactionDate": 
        "totalAmount": null,
        "taxAmount": null,
        "postDate": "2021-09-01T07:00:00.000Z",
        "name": "Cancelled"
        "Id": null,
        "feeAmount": null,
        "amount": -133.4,
        "additionalInfo": null
    },
    "error": "OK"
}