Loading
保險
InsClaimItemService:cancelPayments

InsClaimItemService:cancelPayments

使用此服務可取消索賠損失與費用付款。

此服務:

  • 將索賠付款記錄的狀態更新為「已取消」。

  • 建立抵銷追蹤項目,有效移除索賠財務與保單條款狀態的付款。

類別:InsClaimItemService

方法:cancelPayments

運作方式

  1. 當使用者在索賠的「財務」 索引標籤上按一下一或多個付款詳細資料的「取消」 時,名為 InsClaimItemService: invokeInitiateCancelPaymentIP 的內部服務會起始取消流程。

  2. InsClaimItemService: invokeInitiateCancelPaymentIP 內部服務依賴您設定的 ClaimInitiateCancelPaymentIP 自訂設定和整合程序,會叫用 InsClaimItemService: cancelPayments。

    若要瞭解如何設定 ClaimInitiateCancelPaymentIP 自訂設定和整合程序,請參閱 設定取消付款動作。

  3. InsClaimItemService: cancelPayments 服務會剖析提供的 itemIds 或 paymentIds、提取對應的資料,並查詢對應的 ClaimCoveragePaymentDetail 或 ClaimPaymentSummary 記錄。

    服務會在以下情況產生錯誤:

    • 屬於連結付款一部分的 ClaimCoveragePaymentDetail 記錄缺少任何 lineItemIds。

    • 不會支付任何的 ClaimCoveragePaymentDetail 記錄。

  4. 除非您針對 status 遠端選項輸入不同的值,否則服務會將 ClaimCoveragePaymentDetail 記錄的狀態更新為 Cancelled。

  5. 服務會建立與原始記錄相同和相反版本的 ClaimCoveragePaymentDetail 記錄。新記錄有:

    • 設為 Reverted 的狀態。

    • 負 Amount 值。

  6. 此服務會回復適用的「扣款」、「共同支付」、「共同保險」或「現金缺口最大功率」屬性金額,並建立對應的期限追蹤項目。

  7. 服務會根據 groupPayments 輸入更新 ClaimPaymentSummary 記錄。其:

    • 將 Payment Status 設為 Cancelled,除非您針對 status 遠端選項輸入不同的值。

    • 將 Cancellation Date 設為取消的日期和時間。

  8. 此服務會回復適用的「滾動」、「留存時間」和「行事曆限制」動力屬性金額,並建立對應的字詞追蹤項目。

遠端選項

遠端選項

描述

itemIds 或 paymentIds

必要。

要取消的付款詳細資料或付款摘要清單。指定 itemIds 或 paymentIds,而非兩者。

針對 itemIds,指定 ClaimCoveragePaymentDetail 識別碼清單。

針對 paymentIds,指定 ClaimPaymentSummary 識別碼清單。

groupPayments

必要。

處理多個損失或費用條列項目時,是否依收件者將付款分組。

  • 如果為 true (預設),則服務會為每個收件者為多個條列項目付款建立單一 ClaimPaymentSummary 記錄。

  • 如果為 false,則服務會為每個條列項目建立單一 ClaimPaymentSummary 記錄。

status

選擇性。

為每個取消的 ClaimCoveragePaymentDetail 或 ClaimPaymentSummary 設定的狀態值。預設值為 Cancelled。

輸入 JSON

如果您使用 itemIds,則輸入 JSON 的格式如下:

{
    "groupPayments": <Boolean>,
    "itemIds": [
        {
            "Id" : <Id>
        },
        {
            "Id" : <Id>
        }
    ]
}

以下是輸入 JSON 與 itemIds 的範例:

{
    "groupPayments": true,
    "itemIds": [
        {
            "Id" : "01t000000000000003"
        },
        {
            "Id" : "01t000000000000004"
        }
    ]
}

如果您使用 paymentIds,則輸入 JSON 的格式如下:

{
    "groupPayments": <Boolean>,
    "paymentIds": [
        {
            "Id" : <Id>
        },
        {
            "Id" : <Id>
        }
    ]
}

以下是輸入 JSON 與 paymentIds 的範例:

{
    "groupPayments": false,
    "paymentIds": [
        {
            "Id" : "0l8RN0000000000005"
        },
        {
            "Id" : "0l8RN0000000000006"
        }
    ]
}

輸出 JSON

沒有與此服務相關聯的輸出 JSON。

 
正在載入
Salesforce Help | Article