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 值使用適當的計算流程。

   設定為 false (取消選取) 的 useIsPaidFlag 時,服務會按比例分配保單的「期限總保費」、「期限總費用」和「期限總稅金」,並根據「取消日期」和「保單支付日期」計算退款金額。如果「付款日期保單」為空值,則服務會考量已完全付款保單,並使用「到期日期」。

   當設定為 true 的 useIsPaidFlag (已選取) 時,服務會:

   1. 使用付款排程計算已支付保單的總金額。保單的已支付總金額等於付款排程中的金額總和,且「已付款」設定為 true (已選取)。此金額用於退款計算。

   2. 按比例分配保單的「期限總保費」、「期限總費用」和「期限總稅」,並根據「取消日期」和已為保單支付的總金額計算退款金額。

   3. 根據目前日期或取消日期調整付款排程,取決於晚於何日。如果此日期或之後的付款排程已將「已付款」設定為 false (取消選取),則服務會將其刪除。

   4. 將所有未支付付款排程 (從 cancellationDate 過期的付款排程) 的狀態更新為 Invalid。未支付的金額會新增至新的付款排程。

   5. 為目前日期建立新的付款排程,其金額等於已計算的退款金額,並將狀態標記為 Valid。如果 createTransaction 為 true,則服務會建立取消交易。

   6. 使用取消資訊更新所有未來保單版本:

      • 狀態：已取消

      • 取消日期:傳送至服務的 effectiveDate

      • 期限保費、期限稅與期限費用:0 次

      • 到期日期:前往服務的 effectiveDate 前一天,其時間戳記為下午 11:59

5. 將按比例分配的 TotalPremiumForTerm 認可至資料庫。

6. 如果 createTransaction=true 且傳送的識別碼是 assetId,則會建立 AssetTransaction_c (Amount_c=refund, postDate_c and transactionDate_c=effectiveDate, type=transactionType (預設為「已取消」)。如果 createTransaction=true 且傳送的識別碼是 policyId,則服務會建立 InsurancePolicyTransaction_c 或 InsurancePolicyTransaction (Amount_c=refund、postDate_c 和 transactionDate_c=effectiveDate、type=transactionType (預設為「已取消」)。

   此服務也會將交易細目資料填入交易詳細資料物件。它會顯示關於每個資產、參與者和涵蓋範圍在保費、稅金和費用的總交易金額貢獻的資料。只會顯示具有至少一個保費、稅金和費用的非零值的資產、參與者和涵蓋範圍。

7. 使用 assetId 和新建立的 transactionId 呼叫 InsPolicyRevenueScheduleService:cancel 。

8. InsPolicyRevenueScheduleService:cancel service 會計算收入排程的結束時間,並將結果張貼在原則的收入排程區段中。退款金額來自保險公司的觀點。負金額會導致退款給保單持有人,負金額代表保單持有人未支付的金額。

備註

此服務也支援取消原始保單版本的保單,其持續期間少於 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

小秘訣

想要瞭解如何從「資產」物件模型轉換至「保單」物件模型?請參閱「協調保單」。

遠端選項

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

輸入 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"
}