您位於此處:
InsPolicyService:cancelPoliciesInBulk
使用此服務大量取消保單記錄 (InsurancePolicy)。此服務使用 InsPolicyService:cancelPolicy 服務和 Vlocity 批次架構,以非同步方式處理多個原則的取消。
此服務使用「契約群組計畫」,且為「群組福利」功能所特有。
類別:InsPolicyService
方法:cancelPoliciesInBulk
運作方式
服務會取得原則詳細資料清單 (policyId 與 effectiveDate),然後建立批次工作來大量取消原則。batchSize 會作為選項中的輸入參數提供。如果未提供值,則服務會使用 12 作為預設批次大小。服務只會處理清單中的有效原則詳細資料,並在輸出中傳回無效的原則詳細資料。如果 policyId 或 effectiveDate 為空值/空白,則原則會被視為取消無效。
此服務支援的最大批次大小為 12。超過 12 個的任何批次大小都會引發錯誤。
輸入選項
| 選項 | 描述 |
|---|---|
policyId
|
必要 要取消之原則的識別碼。 |
effectiveDate
|
必要 保單取消生效的日期。支援的格式為 |
batchSize
|
選擇性 要處理的批次大小。支援的批次大小上限為 12 個。 |
遠端選項
選項 |
描述 |
|---|---|
batchSize
|
選擇性。 要處理的批次大小。支援的批次大小上限為 12 個。 |
範例輸入與輸出 JSON 格式
輸入 JSON
inputs :
{
"policies": [
{
"policyId" : "0YTR00000000000000",
"effectiveDate" : "12/22/2022"
},
{
"policyId" : "0YTR00000000000001",
"effectiveDate" : "12/22/2022"
},
{
"policyId" : null, //invalid policy detail
"effectiveDate" : "12/22/2022"
},
]
}
options :
{
"batchSize" : 1
}
輸出 JSON
{
"invalidPolicies" : [
{
"policyId" : null, //invalid policy detail
"effectiveDate" : "12/22/2022"
}
]
}輸入 JSON
inputs :
{
"policies": [
{
"policyId" : "0YTR00000000000000",
"effectiveDate" : "12/22/2022"
},
{
"policyId" : "0YTR00000000000001",
"effectiveDate" : "12/22/2022"
},
{
"policyId" : null, //invalid policy detail
"effectiveDate" : "12/22/2022"
},
]
}
options :
{
"batchSize" : 13
}輸出 JSON
{
"error": "batchSize should not be greater than 12/null/non-zero"
}