Loading
Insurance
Table of Contents
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

          Search all of Salesforce Help
          InsClaimItemService:update

          InsClaimItemService:update

          Use this service to update a claim line item to a specified claim item object.

          This service can update either a Loss type claim line item or an Expense type claim line item, depending on which options to get inputs.

          Note
          Note

          If the service receives inputs for both Loss and Expense type claim line items, it updates the claim line item as a Loss.

          Class: InsClaimItemService

          Method: update

          How It Works

          The service uses object interface field names as default input and output for common fields in both Vlocity (ClaimLineItem__c) and Salesforce FSC (ClaimCoveragePaymentDetail) data models.

          1. Takes the claimId and the claimItemId and gets the claim line item record, claim record, the associated policy record, and attribute values for both the claim and the policy.

          2. If type = Loss, calls the InsPolicyTermsService: process service.

            This service calculates all insured obligation amounts (copay/coinsurance, deductible, and out-of-pocket max.)

            If type = Expense, skip to step 3.

          3. Updates the claim line item.

            If type = Expense, it is the last step the service takes.

          4. Deletes old child Line Adjustments, if any.

          5. Converts the list of insured obligation amounts returned in step 2 into child records of the claim line item as Line Adjustments record type.

            Note
            Note

            Out-of-pocket max isn’t saved as a line adjustment.

          6. Saves the new Line Adjustments.

          7. Saves the insured obligation amounts and out of pocket max as new AssetTermTrackingEntry records.

          Remote Options

          Option

          Description

          claimId

          Required.

          The Id of the claim the service updates a line item for.

          claimCoverageId

          Required.

          The Id of the coverage the service uses to create this claim line item.

          claimItemId

          Required.

          The Id of the claim line item the service updates.

          type

          Required.

          Valid values for this field are Loss or Expense.

          additionalInput

          Required.

          JSON of possible additional input to be updated in the Claim Line Item record. It must have the following inputs:

          • ClaimLineItem.claimAmount

          • ClaimLineItem.recipientID

          Uses interface field names in the input and output for common fields in Vlocity ClaimLineItem__c and Salesforce FSC ClaimCoveragePaymentDetail data models. See the next table for more fields.

          Any Vlocity or customer-created custom field you enter for the value of this option must follow this format, including the fully qualified field API name:

          {

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

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

          }

          Attributes prefixed with ClaimLineItem that have with claim line item's API are saved to the claim line item that is updated.

          This JSON can also include values that calculate the claim line item's coverage amount, if the claim line item is a Loss.

          If a coverage amount or an adjusted amount or a claim amount are passed in this JSON, this service will return these amounts. It will not recalculate them.

          If the user interface field name isn't listed in the this table, use the fully qualified name of the field.

          User Interface Field Name

          Common Fields in Vlocity ClaimLineItem__c and Salesforce FSC ClaimCoveragePaymentDetail Data Models

          ClaimLineItem.name

          Use for ClaimLineItem__c.Name and ClaimCoveragePaymentDetail.Name

          ClaimLineItem.claimAmount

          Use for ClaimLineItem__c.ClaimAmount__c  and ClaimCoveragePaymentDetail.ClaimedAmount

          ClaimLineItem.description

          Use for ClaimLineItem__c.Description__c and ClaimCoveragePaymentDetail.Description

          ClaimLineItem.recipientId

          Use for ClaimLineItem__c.PayeeAcccountId__c, ClaimLineItem__c.PayeeContactId__cClaimLineItem.PayeeAccountId__c__c, and ClaimCoveragePaymentDetail.ClaimParticipantRecipientId

          ClaimLineItem.benefitType

          Use for ClaimLineItem__c.BenefitType__c and ClaimCoveragePaymentDetail.BenefitName

          ClaimLineItem.reserveAmount

          Use for ClaimLineItem__c.ReserveAmount__c  and ClaimCoveragePaymentDetail.ClaimCoverageReserveDetailId.ReserveAmount

          ClaimLineItem.status

          Use for ClaimLineItem__c.Status__c and ClaimCoveragePaymentDetail.Status

          ClaimLineItem.type

          Use for ClaimLineItem__c.Type__c and ClaimCoveragePaymentDetail.Type

          ClaimLineItem.unitCount

          Use for ClaimLineItem__c.Quantity__c and ClaimCoveragePaymentDetail.LimitUnitCount

          ClaimLineItem.uom

          Use for ClaimCoveragePaymentDetail.LimitUnitOfMeasure

          ClaimLineItem.currencyIsoCode

          Use for ClaimLineItem__c.CurrencyIsoCode and ClaimCoveragePaymentDetail.CurrencyIsoCode

          Input JSON

          This service can take an optional additionalInput JSON that will add additional data to the claim line item.

          Here's the format of the input 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.
          	}
          }

          Here's a sample input 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"
          	}
          }

          Output JSON

          Here's the format of the output JSON:

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

          The childClaimItems node is applicable only when type = Loss.

          Here's a sample output JSON:

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