InsurancePolicyTransactionService:reverseTransaction

此服務會為保單交易建立「反向」交易。它也會根據原始交易建立時原始原則的快照重新建立原則。

類別:InsurancePolicyTransactionService

方法:reverseTransaction

運作方式

若要撤銷保單交易,此服務會:

1. 驗證指定的輸入 Id 是 InsurancePolicyTransaction 物件的例項。

2. 取得 InsurancePolicyTransaction 記錄,並驗證要撤銷的交易是:

   • 保單的最新交易。

   • 連結至啟用的 (非回復的) 原則。

   • 連結至最新啟用中原則版本。

   • 連結至原則快照。

     連結至原則快照的記錄具有名為 <policyId>_PolicySnapshot 的附件。系統會針對建立交易的服務啟用原則快照,特別是 InsPolicyService:createUpdatePolicy、InsPolicyService:createPolicyVersion、InsPolicyService:cancelPolicy 和 InsPolicyService:createTransaction。

   • 無反向交易。

3. 建立具有下列項目的反向交易記錄:

   • 來自原始交易的負數金額。

   • transactionDate 和 postDate 值根據指定的選項。

   • 交易類型和名稱設定為「撤銷」。

   • parentTransactionId 等於遭回復交易的交易識別碼。

   • policyVersionId 等於快照的原則識別碼。

4. 將目前原則的狀態和快照原則設定為「已撤銷」。

5. 根據快照重新建立原則。服務:

   • 移除現有識別碼,以便在儲存時建立新記錄。

   • 透過 delete-insert 重新建立「付款」與「收入」排程,以保留交易的原始對應。

6. 呼叫 InsuranceCommissionDataService.reverseCommissions 建立並儲存與原始交易相關的撤銷佣金。

輸入

遠端選項

所有遠端選項皆為選擇性。

輸出

輸入 JSON

以下是設定輸入 JSON 格式的方式。

{
    "Id": <transaction id>
}

以下是設定選項格式的方式。

{
    "effectiveDate": <Date>,
    "postDate" : <Date>,
    "getCustomClassname" : <String>,
    "postPolicyCustomClassName" : <String>,
    "postTxnCustomClassName" : <String>
}

以下是輸入範例。

{
    "Id": "0k9R000000003KjIAI"
}

以下是輸入選項的範例。

{
    "effectiveDate": "4/1/2021",
    "postDate" : "4/5/2021",
    "getCustomClassname" : "GetPolicyTransactionReversalFields",
    "postPolicyCustomClassName" : "PostInsurancePolicy",
    "postTxnCustomClassName" : "PostInsurancePolicyTransaction"
}

輸出 JSON

以下是輸出 JSON 的格式。

{
    "transactionIdForReversal": <transaction id>,
    "reversalCommissionId": <commission id>,
    "reversedCommissionAmount": <Decimal>
}

以下是輸出的範例。

{
    "transactionIdForReversal": "0k9R000000003KjIAI",
    "reversalCommissionId": "0k9R000000003KjIAI",
    "reversedCommissionAmount": 123.00
}