Loading
保險
InsClaimItemService:update

InsClaimItemService:update

使用此服務可將索賠條列項目更新為指定的索賠項目物件。

此服務可以更新「損失」類型的索賠條列項目或「費用」類型的索賠條列項目,視要取得輸入的選項而定。

備註
備註

如果服務接收「損失」與「費用」類型的索賠條列項目輸入,則會將索賠條列項目更新為「損失」。

類別:InsClaimItemService

方法:update

運作方式

此服務使用物件介面欄位名稱作為 Vlocity (ClaimLineItem__c) 和 Salesforce FSC (ClaimCoveragePaymentDetail) 資料模型中常見欄位的預設輸入和輸出。

  1. 取得 claimId 和 claimItemId,並取得索賠條列項目記錄、索賠記錄、相關聯的原則記錄,以及索賠與原則的屬性值。

  2. 如果 type = 損失,則呼叫 InsPolicyTermsService:處理服務。

    此服務會計算所有投保義務金額 (copay/coinsurance、可扣除和現金上限)。

    如果 type = 費用,請跳到步驟 3。

  3. 更新索賠條列項目。

    如果 type = 費用,則此為服務所採取的最後一個步驟。

  4. 刪除舊的子系條列調整 (若有的話)。

  5. 將步驟 2 中退貨的保險責任金額清單轉換為索賠條列項目的子系記錄,作為「條列調整」記錄類型。

    備註
    備註

    現有最大值不會儲存為條列調整。

  6. 儲存新的「條列調整」。

  7. 以新的 AssetTermTrackingEntry 記錄儲存已投保的義務金額,並使其達到頭限。

遠端選項

選項

描述

claimId

必要。

服務更新條列項目的索賠識別碼。

claimCoverageId

必要。

服務用來建立此索賠條列項目的涵蓋範圍識別碼。

claimItemId

必要。

服務更新之索賠條列項目的識別碼。

type

必要。

此欄位的有效值為 Loss 或 Expense。

additionalInput

必要。

可能要在「索賠條列項目」記錄中更新之其他輸入的 JSON。它必須有下列輸入:

  • ClaimLineItem.claimAmount

  • ClaimLineItem.recipientID

針對 Vlocity ClaimLineItem__c 和 Salesforce FSC ClaimCoveragePaymentDetail 資料模型中的通用欄位,在輸入和輸出中使用介面欄位名稱。請參閱下表以取得更多欄位。

您針對此選項值輸入的任何 Vlocity 或客戶建立的自訂欄位必須遵循此格式,包括完全合格欄位 API 名稱:

{

"ClaimLineItem.<fully qualified name / field API name>": "some random value",

"ClaimLineItem.Customer_Custom_Field__c" : "some other random value" // customer added field

}

以 ClaimLineItem 為字首且具有具有索賠條列項目 API 的屬性會儲存至更新後的索賠條列項目。

如果索賠條列項目為「損失」,則此 JSON 也可包含計算索賠條列項目涵蓋範圍金額的值。

如果在此 JSON 中傳遞涵蓋範圍金額或調整金額或索賠金額,則此服務會傳回這些金額。它不會重新計算這些項目。

如果此表格中未列出使用者介面欄位名稱,請使用欄位的完全合格名稱。

使用者介面欄位名稱

Vlocity ClaimLineItem__c 和 Salesforce FSC ClaimCoveragePaymentDetail 資料模型中的常用欄位

ClaimLineItem.name

用於 ClaimLineItem__c.Name and ClaimCoveragePaymentDetail.Name

ClaimLineItem.claimAmount

用於 ClaimLineItem__c.ClaimAmount__c  ClaimCoveragePaymentDetail.ClaimedAmount

ClaimLineItem.description

用於 ClaimLineItem__c.Description__c and ClaimCoveragePaymentDetail.Description

ClaimLineItem.recipientId

用於 ClaimLineItem__c.PayeeAcccountId__c、ClaimLineItem__c.PayeeContactId__c、ClaimLineItem.PayeeAccountId__c__c, and ClaimCoveragePaymentDetail.ClaimParticipantRecipientId

ClaimLineItem.benefitType

用於 ClaimLineItem__c.BenefitType__c and ClaimCoveragePaymentDetail.BenefitName

ClaimLineItem.reserveAmount

用於 ClaimLineItem__c.ReserveAmount__c  ClaimCoveragePaymentDetail.ClaimCoverageReserveDetailId.ReserveAmount

ClaimLineItem.status

用於 ClaimLineItem__c.Status__c and ClaimCoveragePaymentDetail.Status

ClaimLineItem.type

用於 ClaimLineItem__c.Type__c and ClaimCoveragePaymentDetail.Type

ClaimLineItem.unitCount

用於 ClaimLineItem__c.Quantity__c and ClaimCoveragePaymentDetail.LimitUnitCount

ClaimLineItem.uom

用於 ClaimCoveragePaymentDetail.LimitUnitOfMeasure

ClaimLineItem.currencyIsoCode

用於 ClaimLineItem__c.CurrencyIsoCode ClaimCoveragePaymentDetail.CurrencyIsoCode

輸入 JSON

此服務可採用可將其他資料新增至索賠條列項目的選擇性 additionalInput JSON。

以下是輸入 JSON 的格式:

{ 
	"claimId: <Id>,
	"claimCoverageId: <Id>,
	"type": "Loss",
	"additionalInput": {
		"ClaimLineItem." + <fully qualified fieldname>: <values>, 
		"ClaimLineItem.claimAmount": <decimal> // example
		"ClaimLineItem.recipientId": <id> // example
		...	
		// other claim line item fields that need to be saved.
	}
}

以下是輸入 JSON 範例:

{ 
	"claimId": "01t000000000000001",
	"claimCoverageId": "01t000000000000002",
	"claimItemId": "01t000000000000004",
	"type": "Loss",
	"additionalInput": {
		"ClaimLineItem.claimAmount": 500
		"ClaimLineItem.description": "line item description"
		"ClaimLineItem.recipientId": "01t000000000000003",
        "ClaimLineItem.vlocity_ins__ProcedureCodeId__c": "01t000000000000004"
	}
}

輸出 JSON

以下是輸出 JSON 的格式:

{  
   	"adjustedAmount": <decimal>,
	"claimItemId": <id>, // if add/update,
	"claimItem" : {
		"adjustedAmount" : <decimal>,
		"description" : <string>,
		...
	}
	"childClaimItems": [
		{
			"adjustedAmount" : <decimal>,
			"adjustmentReason" : <string>
		}
	]
}
備註
備註

childClaimItems 節點僅在 type = Loss 時適用。

以下是範例輸出 JSON:

{  
   	"adjustedAmount": 200,
	"claimItemId": "01t000000000000004", // if add/update,
	"claimItem" : {
		"adjustedAmount" : 200,
		"description" : <string>
	},
	"childClaimItems": [
		{
			"adjustedAmount" : 200,
			"adjustmentReason" : "Deductible"
		},
		
		{
			"adjustedAmount" : 100,
			"adjustmentReason" : "Coinsurance"
		}
	]
}
 
正在載入
Salesforce Help | Article