Loading
保險
InsPolicyService:createReinstatementPolicy

InsPolicyService:createReinstatementPolicy

使用此服務來還原已取消的原則。

類別:InsPolicyService

方法:createReinstatementPolicy

此服務會在還原原原則時建立以下交易:

  • 恢復:依預設,會根據已還原保單版本的保費期限,在應付的完整金額上產生重設交易。

  • 依付款排程的恢復:此交易會顯示為付款排程項目。系統會根據取消交易的退款或收費金額,以及取消生效日期與恢復生效日期之間的遺漏付款來計算交易。

運作方式

  1. 服務會取得已取消原則的 policyId 作為輸入。

  2. 服務接受交易生效日期的輸入 reinstatementEffectiveDate。

  3. 服務接受原則狀態作為建立新原則狀態的輸入。

  4. 服務會建立已取消原則版本的新複製版本,其生效日期為已取消原則版本的 endDate + 1 天。

  5. 此服務會在還原原原則時建立以下交易:

    1. 重新設定:如果 createTransaction 標記為 true,則服務會建立交易類型作為保費條款變更的還原。

    2. 依付款排程恢復:如果 createTransaction 標記與 includePaymentSchedule 標記皆為 true:

      1. 服務會根據在下列時間後的付款頻率建立所有未來付款排程

        reinstatementEffectiveDate.
      2. 在合併項目的reinstatementEffectiveDate後,取消日期和下一個付款排程日期之間持續期間的未付款服務帳戶。此付款排程的排程日期為 reinstatementEffectiveDate,狀態為 Valid。

      3. 如果付款排程在取消時未支付,則不會清償取消。在此情況下,付款排程 (取消) 的狀態為 Invalid,且未支付的金額會列入已恢復原則的新付款排程中。

      4. 服務會建立附加至合併付款排程的交易類型 Reinstatement by Payment Schedule。

      5. 如果取消期間的付款排程未支付,則服務會將付款排程的狀態更新為「Invalid」,並在合併付款排程項目中包含未償還金額。

      6. 如果 useIsPaidFlag 為 true,則服務會為付款排程項目建立「付款排程項目詳細資料」,並為交易建立交易細目。

備註
備註

此外,此服務支援原始保單版本的持續期間少於 365 天,或年份內少於 366 天的保單恢復。請參閱保單的 考量事項與限制。

遠端選項

選項

描述

reinstatementEffectiveDate

選擇性

恢復交易生效日期。如果未提供值,則預設值為原則恢復的日期。

如果您使用的是 Insurance Industries Extension 封裝,則會忽略 reinstatementEffectiveDate 選項中的時間戳記值。而是會將有效日期時間戳記值設定為所選有效日期的凌晨 12:00,並將所選到期日期的到期日期值設定為下午 11:59。時間戳記是使用使用者指定的時區來設定。

policyStatus

選擇性

新原則的狀態。如果未提供值,則狀態預設為初始值。

createTransaction

選擇性

如果為 true,則服務會建立恢復交易。預設值為 true。

includePaymentSchedule

選擇性

如果為 true,則服務會建立付款排程項目。預設值為 False。

useIsPaidFlag

選擇性

如果為 true,則服務會建立付款排程項目詳細資料。預設值為 False。

includeRevenueSchedule

選擇性

此選項在 createTransaction 為 true 時套用。

如果此選項的值為 true,則服務會呼叫 InsPolicyRevenueScheduleService:modifyRevenueSchedule。預設值為 False。

isCreatingPolicyTerms

選擇性

如果為 true,則服務會在輸出 JSON 中傳回 policyTermIds 節點。預設值為 true。

createContactForParticipants

選擇性

如果為 true,則服務會為「受保者」建立新的「連絡人」記錄 (如果連絡人不存在)。預設值為 true。

輸入 JSON 和選項 JSON

以下是範例輸入 JSON 和選項 JSON:

輸入 JSON

{
	"policyId":"0YTRN0000000CjG4AU"
}

選項 JSON

{
    "reinstatementEffectiveDate": "4/28/2023",
    "includePaymentSchedule": true,
    "useLocalTimeZone": true,
    "includeRevenueSchedule": false,
    "isCreatingPolicyTerms": false,
    "createTransaction": true,
    "useIsPaidFlag": true
  }

輸出 JSON

{
  "policyTermIds": [
    "a6ERN00000003RO2AY"
  ],
  "snapshotId": [
    "00PRN000000c9hn2AA"
  ],
  "InsurancePolicy": [
    "0YTRN0000000CjG4AU"
  ]
}
 
正在載入
Salesforce Help | Article