您位於此處：
InsPolicyService:prepareToCancelPolicy
取消保單前,請使用此服務計算保費價格差額。服務會按比例分配保費、費用和稅額,並計算保費、費用和稅額退款。
必須在 InsPolicyService:cancelPolicy 服務之前叫用此服務。
方法:prepareToCancelPolicy
運作方式
-
取得
assetId或policyId,並尋找要取消的原則。 -
根據
useIsPaidFlag值使用適當的計算流程。設定為 false (取消選取) 的
useIsPaidFlag時,服務會按比例分配保單的「期限總保費」、「期限總費用」和「期限總稅金」,並根據「取消日期」和「保單支付日期」計算退款金額。如果「付款日期保單」為空值,則服務會考量已完全付款保單,並使用「到期日期」。當設定為
true的useIsPaidFlag(已選取) 時,服務會:-
使用付款排程計算已支付保單的總金額。保單的已支付總金額等於付款排程中的金額總和,且「已付款」設定為 true (已選取)。此金額用於退款計算。
-
按比例分配保單的「期限總保費」、「期限總費用」和「期限總稅」,並根據「取消日期」和已為保單支付的總金額計算退款金額。
-
-
此服務會考量費用或稅額是否可退款。
-
傳回原始保單總保費與輸出 JSON 中取消的原則之間的價格差異。
-
退款金額來自保單持有者的觀點。正數金額代表退款給保單持有人。負數金額表示保單持有人未支付的金額。
-
-
如果此原則中包含稅金和費用,則輸出 JSON 中也會包含
Total Tax For Term、Total Fee For Term、refundedTax和/或refundedFee。如果服務取消的原則未包含稅金或費用,則這些欄位會從輸出 JSON 中省略。
附加費 (稅金與費用)
此服務 (連同 InsPolicyService:cancelPolicy 服務) 可在保單取消時協助按比例分配稅金和費用並退款。運作方式如下:
-
priceDiff基本上是退款金額,並使用公式 = (舊GrossWrittenPremium- 已更新GrossWrittenPremium) +refundedTax+refundedFee。 -
更新的
GrossWrittenPremium是按保單生效日期和取消日期分配的PremiumAmount。 -
新總金額等於目標保單的
PremiumAmount加上StandardTaxAmount加上StandardFeeAmount,全部按取消日期進行比例分配。 -
如果目標原則有
StandardTaxAmount,則該值會按取消日期比例分配,並透過輸出中的TermTaxAmount欄位傳回。 -
如果目標原則有
StandardFeeAmount,則該值會按取消日期比例分配,並透過輸出中的TermFeeAmount欄位傳回。 -
如果目標原則具有可退款的
InsurancePolicySurcharge或AssetPricingAdjustment__c記錄,則會透過輸出中的refundedTax和refundedFee欄位來傳回按比例分配的退款金額。如果相關聯的PriceListEntry__c可退款,則InsurancePolicySurcharge或AssetPricingAdjustment__c可退款。按比例分配的退款金額會計算在取消日期與原始到期日期之間。
遠端選項
輸入 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"
}
}