您位於此處:
InsPolicyService:createPaymentSchedule
InsPolicyService:createPaymentSchedule 服務會為目標原則建立付款排程 (並選擇性地建立初始付款交易)。這僅適用於「保單」物件。不支援「原則 (資產)」物件。
方法:createPaymentSchedule
運作方式
-
服務會取得 InsurancePolicy 識別碼,並使用保單資訊和選用參數建立付款排程。
-
如果原則的 原始保單識別碼已有現有的付款排程,則服務會傳回錯誤訊息。
-
如果有初始付款,則會建立「保單交易」。
-
儲存付款排程時,記錄會連結至 原始保單識別碼。
-
付款排程會新增至 JSON 結果。
遠端選項
遠端選項 |
描述 |
|---|---|
coolingOffPeriod
|
選擇性 您可以延遲第一個付款排程項目的天數。 若是冷卻期間,則原則的第一個付款排程日期會計算為生效日期 + 天數。 例如,有一個每月付款頻率,生效日期為 1 月 5 日,第一個付款排程日期為 1 月 5 日。如果我們套用 14 天的冷卻期間,則第一個付款排程項目會從 1 月 5 日變更為 1 月 19 日。剩餘的每月付款排程日期會保持不變。 備註 冷卻期間必須在原則開始日期的 1 到 28 天之間。 |
|
選擇性。 此自訂類別可用來取回「保單」記錄。 預設為 GetInsurancePolicy。 |
|
選擇性。 Omnistudio 資料對應器,用於取用付款排程。 |
|
選擇性。 用於初始付款的付款規則。範例:天數、月數或百分比。 |
|
選擇性。 交易名稱。 預設值為使用與 |
|
選擇性。 交易類型。 預設為「保費」。 |
|
選擇性。 百分比值,或「月數」或「天數」。 使用 |
|
選擇性。 覆寫原則的「保費計算方法」 值。 |
|
選擇性。 覆寫原則的「保費頻率」 值。 |
|
選擇性。 第一個付款排程項目的日期。 預設為原則生效日期。 |
|
選擇性。 覆寫原則的「保費類型」 值。 |
|
必要。 用於建立付款排程的 InsurancePolicy 識別碼。 |
|
選擇性。 用於儲存付款排程的自訂類別。 預設為 PostInsurancePolicyPaymentSchedule |
|
選擇性。 用於儲存付款排程的「資料對應器」。 |
|
選擇性。 儲存付款排程記錄時為 True。 預設為 |
輸入 JSON
{
"policyId": "0YT5w000000UHv6GAG",
"paymentFrequency": "Monthly",
"paymentCalculationMethod": "Daily",
"paymentType": "Advanced",
"paymentStartDate": "1/1/2020",
"initialPaymentRule": "Percentage",
"initialPaymentValue": "10",
"initialPaymentTransactionType": "Premium Charge",
"initialPaymentTransactionName": "",
"postPaymentSchedule": "true"
}輸出 JSON
{
"output": {
"paymentSchedule": [
{
"totalAmount": 571.5,
"toDelete": null,
"taxAmount": 51.5,
"scheduleDate": "2020-06-21",
"premiumAmount": 515,
"insTransaction": {
"type": "Premium Charge",
"transactionNumber": null,
"transactionDate": null,
"totalAmount": 571.5,
"taxAmount": 51.5,
"postDate": null,
"name": "Premium Charge",
"Id": null,
"feeAmount": 5,
"amount": 515,
"additionalInfo": null
},
"Id": null,
"feeAmount": 5
},
{
"totalAmount": 2578.79,
"toDelete": null,
"taxAmount": 232.38,
"scheduleDate": "2020-09-21",
"premiumAmount": 2323.85,
"insTransaction": null,
"Id": null,
"feeAmount": 22.56
},
{
"totalAmount": 1268.27,
"toDelete": null,
"taxAmount": 114.29,
"scheduleDate": "2020-12-21",
"premiumAmount": 1142.88,
"insTransaction": null,
"Id": null,
"feeAmount": 11.1
},
{
"totalAmount": 1296.44,
"toDelete": null,
"taxAmount": 116.83,
"scheduleDate": "2021-03-21",
"premiumAmount": 1168.27,
"insTransaction": null,
"Id": null,
"feeAmount": 11.34
}
],
"errorCode": "INVOKE-200",
"error": "OK"
}
}