Loading
Assicurazioni
InsClaimItemService:add

InsClaimItemService:add

Utilizzare questo servizio per aggiungere una voce richiesta a un oggetto voce richiesta specificato.

Questo servizio può creare una voce richiesta di tipo Perdita o una voce richiesta di tipo Spesa, a seconda delle opzioni che ricevono input.

Nota
Nota

Se il servizio riceve input sia per le voci richiesta di tipo Perdita che per le voci richiesta di tipo Spesa, crea una voce richiesta di tipo Perdita.

Classe: InsClaimItemService

Metodo: add

Come funziona

Il servizio utilizza i nomi dei campi dell'interfaccia oggetto come input e output predefiniti per i campi comuni nei modelli di dati Vlocity (ClaimLineItem__c) e Salesforce FSC (ClaimCoveragePaymentDetail).

  • Prende il claimId e ottiene il record richiesta, il record polizza associato e i valori degli attributi sia per la richiesta che per la polizza.

  • Se type = Perdita, chiama il servizio InsPolicyTermsService: process.

    Questo servizio calcola tutti gli importi delle obbligazioni assicurate (copay/coassicurazione, franchigia e massimo di tasca)

    Se type = Spesa, passa al punto 3.

  • Salva la voce richiesta.

    Se type = Spesa, è l'ultima fase eseguita dal servizio.

  • Converte l'elenco degli importi delle obbligazioni assicurate restituiti nel passaggio 2 in record controllati della voce richiesta come tipo di record Rettifiche riga.

    Nota
    Nota

    Out of pocket max non viene salvato come rettifica della linea.

  • Salva le rettifiche di riga.

  • Salva gli importi dell'obbligazione assicurata e il numero massimo di titoli di tasca come record AssetTermTrackingEntry.

Opzioni remote

Opzione

Descrizione

claimId

Obbligatorio.

ID della richiesta a cui il servizio aggiunge una voce.

claimCoverageId

Obbligatorio.

ID della copertura utilizzata dal servizio per creare questa voce richiesta.

type

Loss o Expense

Tipo di voce richiesta da creare.

additionalInput

Obbligatorio.

JSON del possibile input aggiuntivo da salvare nel record Voce richiesta o da utilizzare nella formula di calcolo della copertura/copertura totale. Deve avere i seguenti input:

  • ClaimLineItem.claimAmount

  • ClaimLineItem.recipientId

Utilizza i nomi dei campi dell'interfaccia nell'input e nell'output per i campi comuni nei modelli di dati Vlocity ClaimLineItem__c e Salesforce FSC ClaimCoveragePaymentDetail. Per i dettagli, vedere la tabella successiva.

Tutti i campi personalizzati Vlocity o creati dal cliente immessi per il valore di questa opzione devono seguire questo formato, incluso il nome API del campo completo:

{

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

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

}

Gli attributi prefissi con ClaimLineItem che hanno l'API della voce richiesta vengono salvati nella voce richiesta creata.

Questo JSON può anche includere valori che calcolano l'ammontare della copertura della voce richiesta, se la nuova voce richiesta è una Perdita.

Se in questo JSON viene passato un ammontare di copertura o un ammontare rettificato o un ammontare della richiesta, questo servizio restituisce questi importi. Non li ricalcolerà.

Se non è elencato in questa tabella, utilizzare il nome completo del campo.

Nome campo interfaccia utente

Campi comuni nei modelli di dati Vlocity ClaimLineItem__c e Salesforce FSC ClaimCoveragePaymentDetail

ClaimLineItem.name

Utilizzare per ClaimCoveragePaymentDetail.Name ClaimLineItem__c.Name and

ClaimLineItem.claimAmount

Utilizzo per ClaimLineItem__c.ClaimAmount__c  e ClaimCoveragePaymentDetail.ClaimedAmount

ClaimLineItem.description

Utilizzare per ClaimCoveragePaymentDetail.Description ClaimLineItem__c.Description__c and

ClaimLineItem.recipientId

Utilizzare per ClaimLineItem__c.PayeeAcccountId__c, ClaimLineItem__c.PayeeContactId__c, ClaimCoveragePaymentDetail.ClaimParticipantRecipientId ClaimLineItem.PayeeAccountId__c__c, and

ClaimLineItem.benefitType

Utilizzare per ClaimCoveragePaymentDetail.BenefitName ClaimLineItem__c.BenefitType__c and

ClaimLineItem.reserveAmount

Utilizzo per ClaimLineItem__c.ReserveAmount__c  e ClaimCoveragePaymentDetail.ClaimCoverageReserveDetailId.ReserveAmount

ClaimLineItem.status

Utilizzare per ClaimCoveragePaymentDetail.Status ClaimLineItem__c.Status__c and

ClaimLineItem.type

Utilizzare per ClaimCoveragePaymentDetail.Type ClaimLineItem__c.Type__c and

ClaimLineItem.unitCount

Utilizzare per ClaimCoveragePaymentDetail.LimitUnitCount ClaimLineItem__c.Quantity__c and

ClaimLineItem.uom

Utilizzare per ClaimCoveragePaymentDetail.LimitUnitOfMeasure

ClaimLineItem.currencyIsoCode

Utilizzo per ClaimLineItem__c.CurrencyIsoCode e ClaimCoveragePaymentDetail.CurrencyIsoCode

Input JSON

Questo servizio può assumere un additionalInput JSON facoltativo che aggiunge ulteriori dati alla voce richiesta.

Di seguito è riportato il formato del JSON di input:

{ 
	"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.
	}
}

Ed ecco un esempio di JSON di input:

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

JSON di output

Di seguito è riportato il formato del JSON di output:

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

Il nodo childClaimItems è applicabile solo quando type = Perdita.

Di seguito è riportato un esempio di JSON di output:

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