Loading
Forsikring
InsClaimService:createUpdateClaim

InsClaimService:createUpdateClaim

Brug denne tjeneste til at oprette eller opdatere en fordring.

Kategori: InsClaimService

Metode: createUpdateClaim

Sådan fungerer det

Salesforce-kravsproduktet understøtter både den eksisterende Vlocity-objektmodel (tilpassede objekter i den administrerede pakke) og den nye Salesforce-objektmodel (Salesforce-standardobjekter). Vlocity-modellen understøtter relationen Aktiv → InsuranceClaim mellem policer og skader. Salesforce-modellen understøtter InsurancePolicy → Claim-relationen mellem policer og skader.

  1. Henter en præ-transformeret JSON kaldt af inputKey. Derefter kontrollerer tjenesten policyId-elementet i input-JSON for at bestemme, om tjenesten opretter et Vlocity- eller et Salesforce FSC-krav:

    • Hvis policyId hører til en aktivregistrering, opretter tjenesten Vlocity-kravobjekter - InsuranceClaim__c, InsuranceClaimInvolvedInjury__c, InsuranceClaimInvolvedProperty__c og InsuranceClaimPartyRelationship__c.

    • Hvis policyId hører til en InsurancePolicy, opretter tjenesten disse Salesforce FSC-kravobjekter: Claim, ClaimItem og ClaimParticipant.

    • Hvis policyId-elementet ikke er tilgængeligt i input-JSON, eller hvis dets værdi er tom, markeres fjernindstillingen isAssetInsuranceClaim. Hvis dens værdi er true, opretter tjenesten Vlocity-kravobjekter, ellers opretter den FSC-kravobjekter. Hvis policyId ikke har nogen værdi, og isAssetInsuranceClaim ikke er angivet, er standardværdien for isAssetInsuranceClaim false.

  2. Hvis der ikke overføres nogen claimId, opretter tjenesten et kravobjekt.

    Hvis der overføres en claimId, opdaterer tjenesten kravobjektet.

  3. Hvis generateClaimNumber eller uniqueIdGeneratorObjectSetting eller begge indstillinger er angivet, bruger tjenesten dem til at oprette en claimNumber (feltet Navn).

    Som en bedste fremgangsmåde skal du tildele et entydigt skadesnummer til hver skade. Brug fjernindstillinger til at opfylde denne anbefaling, og sørg for, at alle tilpassede arbejdsflows genererer entydige claimNumber-værdier. Hvis der ikke er konfigureret en entydig værdi, indstiller systemet skadesnumrene for alle skader til den samme værdi.

  4. Returnerer claimId, policyHolderClaimantId (eller policyholderClaimParticipantId, hvis det er et FSC-krav) og involvedItems i output-JSON.

Fjernindstillinger

Indstilling

Beskrivelse

inputKey

Påkrævet.

Henter en liste over prætransformerede JSON-strukturer, der indeholder oplysninger, som tjenesten har brug for. Afhængig af policyId bruger claimJson en af følgende objektmodeller:

  • Salesforce FSC-kravobjektmodel

  • Objektmodel for Vlocity-krav

claimId

Valgfrit.

Hvis claimId overføres, opdaterer tjenesten kravet.

Hvis claimId ikke videregives, opretter tjenesten et krav.

generateClaimNumber

Valgfrit.

Hvis true, bruger tjenesten UniqueIdGeneratorService til at generere en entydig nøgle og til at indstille Name til denne entydige nøgle.

uniqueIdGeneratorObjectSetting

Valgfrit.

Hvis generateClaimNumber er true og denne parameter =null, finder tjenesten indstillingen Vlocity UniqueId Generator med Object Type = Claim.

Hvis tjenesten finder flere indstillinger, returnerer tjenesten en fejl.

Hvis tjenesten finder en indstilling, bruger tjenesten denne indstilling.

Hvis generateClaimNumber er true, og denne parameter ikke er = null, finder tjenesten Vlocity UniqueId Generator Indstilling med Name = < denne parameterværdi > og Object Type = Claim. Den bruger derefter denne indstilling til at generere den entydige nøgle.

isAssetInsuranceClaim

Valgfrit.

Bestemmer, om tjenesten opretter et Vlocity-krav eller et Salesforce FSC-krav.

  • Hvis værdien er true, opretter tjenesten Vlocity-krav.

  • Hvis værdien er false, opretter tjenesten et Salesforce FSC-krav.

Input JSON (Salesforce FSC Claim Object Model)

Denne model er anvendelig i en af følgende to situationer:

  • policyID i claimJson tilhører et InsuranceClaim-objekt.

  • Værdien af isAssetInsuranceClaim-fjernanmodningen er false.

    Bemærk
    Bemærk

    Indstillingen isAssetInsuranceClaim-fjernanmodning anvendes kun, når policyId ikke findes i input-JSON, eller når den har en tom værdi. Når policyId ikke har nogen værdi, og isAssetInsuranceClaim ikke er angivet, er standardværdien for isAssetInsuranceClaim false.

Tjenesten bruger inputKey til at få en prætransformeret JSON til at bruge som input. Denne tjeneste kan også tage specifikationen for det forsikrede element direkte fra produktet og oprette en forsikret part eller ejendom.

I dette eksempel inputKey = claimJson.

Input

Beskrivelse

inputKey = claimJson

claimJSON

Inputelementerne i JSON-strukturen:

  • policyholderInsurancePolicyParticipantId: Id'et på forsikringsejerens forsikringsdeltager.

  • policyholderClaimParticipantRole: En liste over rollerne for policeholderens skadesdeltager. Indsæt en semikolon afgrænsning mellem hver værdi.

    Eksempel: "Insured;Claimant"

  • lossDate: Krævet, når krav konfigureres med tidsfølsom attributklasse, f.eks. Rullende og Kalenderår. Hvis der ikke angives en dato, oprettes politikvilkår med varighedstypen Rullende og Kalenderår ikke.

claimPropertyItems eller claimPartyItems

Listen over ejendoms- og skadeinput. Denne inputparameter er en del af claimJSON.

  • insurancePolicyParticipantId: Id'et på den policedeltager, der enten er blevet såret eller har lidt et ejendomstab. Hvis du angiver dette id, bruger tjenesten de relevante ContactId og AccountId fra InsurancePolicyParticipant. Du kan udelade contactId og accountId, hvis du angiver insurancePolicyParticipantId.

  • contactId: Id'et på den kontaktperson, der enten er blevet såret eller har lidt et ejendomstab. Angiv contactId, hvis ansøgeren ikke har et policedeltager-id. Hvis du angiver dette id, bruger tjenesten de relevante AccountId fra kontaktregistreringen. Du kan udelade accountId, hvis du angiver contactId.

  • accountId: Id'et på kontoen. Angiv accountId, hvis ansøgeren ikke har et policedeltager-id, og du ikke angiver contactId.

  • claimParticipantRoles: En liste over rollerne for policeholderens skadesdeltager. Indsæt en semikolon afgrænsning mellem hver værdi.

    Eksempel: "Insured;Claimant"

  • insuredItemId: Dette input accepterer id'et for en InsurancePolicyAsset-registrering.

additionalClaimParticipants

Listen over yderligere skadesdeltagere. Denne inputparameter er en del af claimJSON.

Angiv mindst et af id-felterne: insurancePolicyParticipantId, contactId, eller accountId.

  • insurancePolicyParticipantId: Id'et på en yderligere deltager på dette krav. Hvis du angiver dette id, bruger tjenesten de relevante ContactId og AccountId fra InsurancePolicyParticipant. Du kan udelade contactId og accountId, hvis du angiver insurancePolicyParticipantId.

  • contactId: Id'et på den kontakt, der er en yderligere deltager på dette krav. Hvis du angiver dette id, men ikke insurancePolicyParticipantId, bruger tjenesten de relevante AccountId fra kontaktregistreringen. Du kan udelade accountId, hvis du angiver contactId.

  • accountId: Id'et på kontoen.

  • claimParticipantRoles: En liste over skadesdeltagerens roller. Indsæt en semikolon afgrænsning mellem hver værdi.

    Eksempel: "Claimant;Payee;Witness"

Her er et eksempel på input-JSON for et Salesforce FSC-krav:

{ 
 "claimJson": {
  "claimAttributes": {
     "amountDeductible": "500.00"
  },
  "claimPropertyItems": { 
   "autoClaimInvolvedVehicle": [ 
     {
      "claimParticipantRoles": "First Party Claimant; Insured",          
      "insurancePolicyParticipantId": "0ao5w0000000Cl7AAE",          
      "contactId": null,          
      "accountId": null,
      "insuredItemId": "0YW5w0000000HLKGA2",          
      "additionalFields": {},          
      "productCode": "autoClaimInvolvedVehicle",           
      "avMake": "Jeep",           
      "avModel": "Wrangler",          
      "avLicNum": "49J9384",           
      "avLicState": "CA",          
      "avYear": "2019",           
      "avColor": "Red",          
      "claimInsuredProp": true,          
      "claimEstimate": null,          
      "claimPropertyLoc": null,          
      "claimSeverity": null,          
      "claimDamage": "Front End Damage",          
      "claimDamageLoc": null,          
      "claimDrivable": false
     },        
      {          
       "claimParticipantRoles": "Third Party Claimant",          
       "insurancePolicyParticipantId": null,          
       "contactId": "0ao5w0000000J47AX5",          
       "accountId": null,          
       "insuredItemId": null,          
       "additionalFields": {},          
       "productCode": "autoClaimInvolvedVehicle",
       "avMake": "Audi",          
       "avModel": "A5",          
       "avLicNum": "48H03949",          
       "avLicState": "WA",          
       "avYear": "2015",          
       "avColor": "Blue",          
       "claimInsuredProp": false,          
       "claimEstimate": null,          
       "claimPropertyLoc": null,           
       "claimSeverity": null,          
       "claimDamage": "Rear End Damage",          
       "claimDamageLoc": null,          
       "claimDrivable": false
      }      
     ]    
    },    
    "claimPartyItems": {      
    "claimInjuredPerson": [        
    {          
     "claimParticipantRoles": "Third Party Claimant",          
     "contactId": "0ao5w0000000J47AX5",          
     "accountId": null,          
     "insurancePolicyParticipantId": null,          
     "additionalFields": {},          
     "productCode": "claimParticipantPerson",          
     "injDescription": "Whiplash"        
    }      
   ],    
    "additionalClaimParticipants": [
     {
      "Id": null,
      "insurancePolicyParticipantId":  null,
      "contactId": null,
      "accountId": "0015g00000H480EAAR",
      "claimParticipantRoles": "Witness", 
      "additionalFields": {}
     }
    ]
   },
  "additionalFields": {},    
  "policyholderClaimParticipantRole": "Insured",    
  "policyholderInsurancePolicyParticipantId": "0ao5w0000000Cl7AAE",    
  "policyId": "0YT5w0000000ieyGAA",    
  "lossDate": "2021-03-29T16:00:00.000Z",    
  "productCode": "autoClaimProduct"  
 } 
} 

Output JSON

Her er et eksempel på en output-JSON for et Salesforce FSC-krav:

{  
 "CreateUpdateClaimRemoteAction": {    
  "involvedItems": [      
    {       
     "insuredItemId": "0YW5w0000000HLKGA2",     
     "claimItemId": "0dq5w0000008PrNAAU",    
     "accountId": "0035w000034fL4YAK",    
     "contactId": "0035w000039cfL2AAI",   
     "insurancePolicyParticipantId": "0ao5w0000000Cl7AAE",      
     "claimParticipantRoles": "First Party Claimant; Insured",   
     "claimParticipantId": "0aS5w00000007r3EAA"    
    },      
    {
     "insuredItemId": null,    
     "claimItemId": "0dq5w0000008PrNAAU",    
     "accountId": null,   
     "contactId": "0035w000039cfL2AAI",   
     "insurancePolicyParticipantId": "0ao5w0000000Cl7AAE",  
     "claimParticipantRoles": "Third Party Claimant", 
     "claimParticipantId": "0aS5w00000004K59dD"      
    }    
   ],
   "policyholderClaimParticipantId": "0ao5w0000000Cl7AAE",    
   "claimId": "0Zk5w0000000IOVCA2"  
  },
  "policyTermIds": [     
   "a6Q5w0000002x6oEAA", 
   "a6Q5w0000002x6pEAA", 
   "a6Q5w0000002x6qEAA", 
   "a6Q5w0000002x6rEAA", 
   "a6Q5w0000002x6sEAA", 
   "a6Q5w0000002x6tEAA"  
  ]
 }

Input JSON (Vlocity Claim Object Model)

Denne model er anvendelig i en af følgende to situationer:

  • policyID i claimJson tilhører et aktivobjekt.

  • Værdien af isAssetInsuranceClaim-fjernanmodningen er true.

    Bemærk
    Bemærk

    Indstillingen isAssetInsuranceClaim-fjernanmodning anvendes kun, når policyId ikke findes i input-JSON, eller når den har en tom værdi. Når policyId ikke har nogen værdi, og isAssetInsuranceClaim ikke er angivet, er standardværdien for isAssetInsuranceClaim false.

Tjenesten bruger inputKey til at få en prætransformeret JSON til at bruge som input. Denne tjeneste kan også tage specifikationen for det forsikrede element direkte fra produktet og oprette en forsikret part eller ejendom.

I dette eksempel inputKey = claimJson.

Input

Beskrivelse

inputKey = claimJson.

claimJSON

Inputelementerne i JSON-strukturen:

  • policyHolderPartyId: Part-id baseret på id'et for objektet Part (Party__c).

  • policyHolderPartyName: Partnavn baseret på navnet på partobjektet (Party__c). Det skal være navnet på en eksisterende Party__c.

  • policyHolderPartyRelationshipTypeId: Relationstype-id baseret på id'et for objektet Relationstype for Vlocity-part (PartyRelationshipType__c).

  • policyHolderPartyRelationshipType: Relationstypenavn baseret på navnet på objektet Relationstype for Vlocity-part (PartyRelationshipType__c). Det skal være navnet på den eksisterende PartyRelationshipType__c.

claimPropertyItems eller claimPartyItems

Listen over ejendoms- og skadeinput. Denne inputparameter er en del af claimJSON.

Egenskab

  • claimantPartyId

  • claimantPartyName

  • claimantPartyRelationshipTypeId

  • claimantPartyRelationshipTypeName

  • insuredItemId

Skade

  • partyId

  • partyName

  • claimPartyRelationshipTypeId

  • claimPartyRelationshipTypeName

Til claimantPartyRelationshipTypeID og claimantPartyRelationshipTypeName skal du kun bruge et af disse to elementer.

Til claimantPartyName og claimantPartyID skal du kun bruge et af disse to elementer.

Du skal have en pakke med et af hvert af disse input, der matcher.

Hvis det er en ny kombination, indsætter den en registrering. Hvis det ikke er en ny kombination, bruger den den eksisterende registrering til kombinationen.

Outputtet er en claimantId (ikke en partyId).

Her er formatet på input-JSON for et Vlocity-krav:

{
  "input": {
    "claimJson": {
      "claimAttributes": {
        "amountDeductible": <Decimal>
      },
      "claimPropertyItems": {
        "homeUnit": [
          {
            "Id": <Id>,
            "claimantPartyRelationshipTypeName": <String>,
            "claimantPartyRelationshipTypeId": <Id>,
            "claimantPartyName": <String>,
            "claimantPartyId": <Id>,
            "insuredItemId": <Id>,
            "additionalFields": {},
            "productCode": <String>,
            "productName": <String>,
            "productId": <Id>
          }
        ],
  		"claimClaimantPerson": [
    		"additionalFields": {
      		"Name": <String>
    		},
    		"productCode": <String>,
    		"persPhone": <String>,
    		"persLastName": <String>,
    		"persName": <String>,
    		"persFirstName": <String>,
    		"persEmail": <String>,
    		"claimInjury": <String>,
    		"claimPartyRelationshipTypeName": <String>,
			"claimPartyRelationshipTypeId": <Id>,
			"partyName": <String>
    		"partyId": <Id>
  		]
      },
      "additionalFields": {},
      "policyHolderPartyRelationshipType": <String>,
      "policyHolderPartyRelationshipTypeId": <Id>,
      "policyHolderPartyName": <String>,
      "policyHolderPartyId": <Id>,
      "policyId": <Id>,
      "policyNumber": <String>,
      "lossDate": <Date>,
      "productCode": "deluxeHomeowners",
      "productName": "Deluxe Homeowners",
      "productId": <Id>
    	}
	}
}

Output JSON

Her er formatet på output-JSON for et Vlocity-krav:

{  
   "output": {
    "claimId": <String>,
    "policyHolderClaimantId": <Id>,
    "involvedItems": [
      {
        "insuredItemId": <Id>,
        "claimantPartyAccountName": <String>,
        "claimantPartyContactName": <String>,
        "claimantPartyId": <Id>,
        "claimantId": <Id>,
        "involvedItemId": <Id>
      },
      {
        "heldProductRelationshipId": <Id>,
        "claimantPartyAccountName": <String>,
        "claimantPartyContactName": <String>,
        "claimantPartyId": <Id>,
        "claimantId": <Id>,
        "involvedInjuryId": <Id>
      }
    ]
  }
}

Eksempelgrænseflade (Vlocity Claim Object Model)

{
  "input": {
    "claimJson": {
      "claimPropertyItems": {
        "claimVehicle": [
          {
            "insuredItemId": null,
            "claimantPartyId":null,
            "claimantPartyName":null,
            "claimantPartyRelationshipTypeId":null,
            "claimantPartyRelationshipTypeName":null,
            "additionalFields": {},
            "productCode": "claimVehicle",
            "productName": "Damaged Vehicle",
            "productId": "01t3i0000001cWAAAY",
            "autoBodyType": null,
            "autoColor": null,
            "autoLicNum": null,
            "autoLicState": null,
            "autoMake": null,
            "autoModel": null,
            "autoVIN": null,
            "autoYear": null,
            "claimDamage": null,
            "claimDamageLoc": null,
            "claimDrivable": false,
            "claimImage": null,
            "claimInsuredProp": false,
            "claimEstimate": null,
            "claimPropertyLoc": null,
            "claimSeverity": null
          }
        ]
      },
      "claimPartyItems": {
        "claimWitness": [
          {
            "heldProductRelationshipId": null,
            "partyId": null,
            "partyName": null,
            "claimPartyRelationshipTypeId":null,
            "claimPartyRelationshipTypeName":null,
            "additionalFields": {},
            "productCode": "claimWitness",
            "productName": "Witness",
            "productId": "01t3i0000001cWCAAY",
            "claimRel": null,
            "claimStatement": null,
            "claimTestify": false,
            "persPhone": null,
            "persSalutation": null,
            "persAddress": null,
            "persBirthdate": null,
            "persEmail": null,
            "persFirstName": null,
            "persLastName": null,
            "persMiddleName": null,
            "persName": null
          }
        ],
        "claimInjuredPerson": [
          {
            "heldProductRelationshipId": null,
            "partyId": null,
            "partyName": null,
            "claimPartyRelationshipTypeId":null,
            "claimPartyRelationshipTypeName":null,
            "additionalFields": {},
            "productCode": "claimInjuredPerson",
            "productName": "Injured Person",
            "productId": "01t3i0000001cWEAAY",
            "claimCarrier": null,
            "claimInjury": null,
            "claimPhysician": null,
            "claimPolicyNumber": null,
            "claimRel": null,
            "claimStatement": null,
            "claimTreatLoc": null,
            "claimInsuredProp": false,
            "claimEstimate": null,
            "claimSeverity": null,
            "persAddress": null,
            "persBirthdate": null,
            "persEmail": null,
            "persFirstName": null,
            "persLastName": null,
            "persMiddleName": null,
            "persName": null,
            "persPhone": null,
            "persSalutation": null,
            "claimantPartyRelationshipTypeId":null
          }
        ],
        "claimDriver": [
          {
            "heldProductRelationshipId": null,
            "partyId": null,
            "partyName": null,
            "claimPartyRelationshipTypeId":null,
            "claimPartyRelationshipTypeName":null,
            "additionalFields": {},
            "productCode": "claimDriver",
            "productName": "Driver",
            "productId": "01t3i0000001cWBAAY",
            "persAddress": null,
            "Birthdate": null,
            "persEmail": null,
            "First Name": null,
            "persIDJuris": null,
            "perIDNumber": null,
            "persIDType": null,
            "LastName": null,
            "MiddleName": null,
            "NAME": null,
            "persPhone": null,
            "persSalutation": null,
            "claimCarrier": null,
            "claimInjury": null,
            "claimInsured": false,
            "claimPhysician": null,
            "claimPolicyNumber": null,
            "claimRel": null,
            "claimStatement": null,
            "claimTestify": false,
            "claimTreatLoc": null
          }
        ]
      },
      "additionalFields": {},
      "policyHolderPartyId": null,
      "policyHolderPartyName": null,
      "policyHolderPartyRelationshipTypeId": null,
      "policyHolderPartyRelationshipType": null,
      "policyId": null,
      "policyNumber": null,
      "lossDate": null,
      "productCode": "claimPerilAutoCollision",
      "productName": "Auto Collision",
      "productId": null
    }
  }
}
 
Indlæser
Salesforce Help | Article