Loading
시스템 관리자에 대한 피싱 방지 MFA 및 전 직원사용자 MFA 적용 안내 더 많이 읽기
보험
InsClaimService:createUpdateClaim

위치:

  1. Salesforce 도움말
  2. 문서
  3. 디지털 보험

InsClaimService:createUpdateClaim

이 서비스를 사용하여 청구를 만들거나 업데이트합니다.

클래스: InsClaimService

방법: createUpdateClaim

작동 방법

Salesforce 청구 제품은 기존 Vlocity 개체 모델(관리 패키지의 사용자 정의 개체)과 새 Salesforce 개체 모델(표준 Salesforce 개체)을 모두 지원합니다. Vlocity 모델은 증권과 청구 간의 Asset → InsuranceClaim 관계를 지원합니다. Salesforce 모델은 증권과 청구 간의 InsurancePolicy → 청구 관계를 지원합니다.

  1. inputKey에서 호출한 미리 변환된 JSON을 가져옵니다. 그런 다음 서비스는 입력 JSON의 policyId 요소를 확인하여 서비스가 Vlocity 또는 Salesforce FSC 클레임을 생성하는지 확인합니다.

    • policyId가 자산 레코드에 속하는 경우 서비스에서 InsuranceClaim__c, InsuranceClaimInvolvedInjury__c, InsuranceClaimInvolvedProperty__c 및 InsuranceClaimPartyRelationship__c Vlocity 클레임 개체를 만듭니다.

    • policyId가 InsurancePolicy 레코드에 속하는 경우 서비스에서 다음의 Salesforce FSC 클레임 개체를 만듭니다. Claim, ClaimItem, ClaimParticipant.

    • 입력 JSON에서 policyId 요소를 사용할 수 없거나 해당 값이 비어 있는 경우 원격 옵션 isAssetInsuranceClaim이 선택됩니다. 값이 true이면 서비스가 Vlocity 클레임 개체를 생성하고, 그렇지 않으면 FSC 클레임 개체를 생성합니다. policyId에 값이 없고 isAssetInsuranceClaim가 설정되지 않은 경우 isAssetInsuranceClaim의 기본값은 false입니다.

  2. claimId가 전달되지 않으면 서비스가 청구 개체를 만듭니다.

    claimId가 전달되면 서비스가 청구 개체를 업데이트합니다.

  3. generateClaimNumber 또는 uniqueIdGeneratorObjectSetting 또는 두 옵션을 모두 설정한 경우 서비스에서 해당 옵션을 사용하여 claimNumber(이름 필드)를 만듭니다.

    가장 좋은 방법은 모든 청구에 고유한 청구 번호를 할당하는 것입니다. 원격 옵션을 사용하여 이 권장 사항을 충족하고 사용자 정의 워크플로가 고유한 claimNumber 값을 생성하는지 확인합니다. 고유 값이 구성되지 않은 경우 모든 클레임에 대한 청구 번호가 동일한 값으로 설정됩니다.

  4. 출력 JSON에서 claimId, policyHolderClaimantId(또는 FSC 클레임인 경우 policyholderClaimParticipantId) 및 involvedItems 노드를 반환합니다.

원격 옵션

옵션

설명

inputKey

(필수)

서비스에 필요한 정보가 포함된 사전 변환된 JSON 구조 목록을 가져옵니다. claimJson는 policyId에 따라 다음의 청구 대상 모델 중 하나를 사용합니다.

  • Salesforce FSC 청구 개체 모델

  • Vlocity 클레임 개체 모델

claimId

(선택 사항)

claimId가 전달되면 서비스에서 청구를 업데이트합니다.

claimId가 전달되지 않으면 서비스에서 청구를 생성합니다.

generateClaimNumber

(선택 사항)

true인 경우 서비스에서 UniqueIdGeneratorService을 사용하여 고유한 키를 생성하고 Name 필드를 해당 고유한 키로 설정합니다.

uniqueIdGeneratorObjectSetting

(선택 사항)

generateClaimNumber가 true이고 이 매개 변수가 =null인 경우 서비스에서 Object Type = Claim인 Vlocity UniqueId Generator 설정을 찾습니다.

서비스에서 여러 설정을 찾으면 오류가 반환됩니다.

서비스에서 하나의 설정을 찾으면 서비스에서 해당 설정을 사용합니다.

generateClaimNumber가 true이고 이 매개 변수가 = null가 아닌 경우 서비스는 Name = < this parameter value > 및 Object Type = Claim로 Vlocity UniqueId Generator Setting을 찾습니다. 그런 다음, 해당 설정을 사용하여 고유한 키를 생성합니다.

isAssetInsuranceClaim

(선택 사항)

서비스에서 Vlocity 클레임 또는 Salesforce FSC 클레임을 생성하는지 여부를 결정합니다.

  • 값이 true이면 서비스가 Vlocity 클레임을 만듭니다.

  • 값이 false인 경우 서비스가 Salesforce FSC 클레임을 만듭니다.

입력 JSON(Salesforce FSC 클레임 개체 모델)

이 모델은 다음 두 가지 사례 중 하나에 적용됩니다.

  • claimJson의 policyID는 InsuranceClaim 개체에 속합니다.

  • isAssetInsuranceClaim 원격 옵션의 값은 false입니다.

    노트
    노트

    isAssetInsuranceClaim 원격 옵션은 입력 JSON에 policyId가 없거나 빈 값이 있는 경우에만 적용됩니다. 또한 policyId에 값이 없고 isAssetInsuranceClaim가 설정되지 않은 경우 isAssetInsuranceClaim의 기본값은 false입니다.

서비스는 inputKey을 사용하여 미리 변환된 JSON을 입력으로 사용할 수 있습니다. 이 서비스는 제품에서 직접 보험 항목 사양을 가져와 보험 당사자 또는 부동산을 만들 수도 있습니다.

이 예에서는 inputKey = claimJson입니다.

입력

상세 설명

inputKey = claimJson

claimJSON

JSON 구조 내의 입력 요소:

  • policyholderInsurancePolicyParticipantId: 보험 소유자의 보험 참가자 ID입니다.

  • policyholderClaimParticipantRole: 보험 소유자의 청구 참가자의 역할 목록입니다. 각 값 사이에 세미콜론 구분 기호를 삽입합니다.

    예: "Insured;Claimant"

  • lossDate: 롤링 및 달력 연도와 같은 시간이 중요한 특성 클래스를 사용하여 클레임이 구성된 경우 필요합니다. 날짜가 제공되지 않은 경우 기간 유형이 롤링 및 달력 연도인 증권 조건이 생성되지 않습니다.

claimPropertyItems 또는 claimPartyItems

부동산 및 부하 입력 목록입니다. 이 입력 매개 변수는 claimJSON의 일부입니다.

  • insurancePolicyParticipantId: 부상되었거나 재산 손실을 입은 증권 참가자의 ID입니다. 이 ID를 제공하는 경우 서비스는 InsurancePolicyParticipant 레코드의 적절한 ContactId 및 AccountId을 사용합니다. insurancePolicyParticipantId를 제공하는 경우 contactId 및 accountId을 제외할 수 있습니다.

  • contactId: 부상을 입었거나 재산 손실을 입은 연락처의 ID입니다. 청구자가 증권 참가자 ID가 없는 경우 contactId를 제공합니다. 이 ID를 제공하는 경우 서비스에서 연락처 레코드의 적절한 AccountId를 사용합니다. contactId를 제공하는 경우 accountId를 제외할 수 있습니다.

  • accountId: 계정의 ID입니다. 청구자에게 증권 참가자 ID가 없고 귀하가 contactId를 제공하지 않는 경우 accountId를 제공합니다.

  • claimParticipantRoles: 보험 소유자의 청구 참가자의 역할 목록입니다. 각 값 사이에 세미콜론 구분 기호를 삽입합니다.

    예: "Insured;Claimant"

  • insuredItemId: 이 입력은 InsurancePolicyAsset 레코드의 ID를 허용합니다.

additionalClaimParticipants

추가 청구 참가자 목록입니다. 이 입력 매개 변수는 claimJSON의 일부입니다.

ID 필드 insurancePolicyParticipantId, contactId, 또는 accountId 중 하나 이상을 지정합니다.

  • insurancePolicyParticipantId: 이 청구에 대한 추가 참가자의 ID입니다. 이 ID를 제공하는 경우 서비스는 InsurancePolicyParticipant 레코드의 적절한 ContactId 및 AccountId을 사용합니다. insurancePolicyParticipantId를 제공하는 경우 contactId 및 accountId을 제외할 수 있습니다.

  • contactId: 이 청구에 대한 추가 참가자인 연락처의 ID입니다. 이 ID를 제공하지만 insurancePolicyParticipantId는 제공하지 않으면 서비스에서 연락처 레코드의 해당 AccountId를 사용합니다. contactId를 제공하는 경우 accountId를 제외할 수 있습니다.

  • accountId: 계정의 ID입니다.

  • claimParticipantRoles: 청구 참가자의 역할 목록입니다. 각 값 사이에 세미콜론 구분 기호를 삽입합니다.

    예: "Claimant;Payee;Witness"

다음은 Salesforce FSC 클레임에 대한 입력 JSON의 예입니다.

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

출력 JSON

다음은 Salesforce FSC 클레임에 대한 출력 JSON의 예입니다.

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

입력 JSON(Vlocity 클레임 개체 모델)

이 모델은 다음 두 가지 사례 중 하나에 적용됩니다.

  • claimJson의 policyID은 Asset 개체에 속합니다.

  • isAssetInsuranceClaim 원격 옵션의 값은 true입니다.

    노트
    노트

    isAssetInsuranceClaim 원격 옵션은 입력 JSON에 policyId가 없거나 빈 값이 있는 경우에만 적용됩니다. 또한 policyId에 값이 없고 isAssetInsuranceClaim가 설정되지 않은 경우 isAssetInsuranceClaim의 기본값은 false입니다.

서비스는 inputKey을 사용하여 미리 변환된 JSON을 입력으로 사용할 수 있습니다. 이 서비스는 제품에서 직접 보험 항목 사양을 가져와 보험 당사자 또는 부동산을 만들 수도 있습니다.

이 예에서는 inputKey = claimJson입니다.

입력

상세 설명

inputKey = claimJson.

claimJSON

JSON 구조 내의 입력 요소:

  • policyHolderPartyId: 당사자 개체(Party__c)의 ID를 기반으로 하는 당사자 ID입니다.

  • policyHolderPartyName: 당사자 개체(Party__c)의 이름을 기반으로 하는 당사자 이름입니다. 기존 Party__c 레코드의 이름이어야 합니다.

  • policyHolderPartyRelationshipTypeId: Vlocity 당사자 관계 유형 개체(PartyRelationshipType__c)의 ID를 기반으로 하는 관계 유형 ID입니다.

  • policyHolderPartyRelationshipType: Vlocity 당사자 관계 유형 개체(PartyRelationshipType__c))의 이름을 기반으로 하는 관계 유형 이름입니다. 기존 PartyRelationshipType__c 레코드의 이름이어야 합니다.

claimPropertyItems 또는 claimPartyItems

부동산 및 부하 입력 목록입니다. 이 입력 매개 변수는 claimJSON의 일부입니다.

속성

  • claimantPartyId

  • claimantPartyName

  • claimantPartyRelationshipTypeId

  • claimantPartyRelationshipTypeName

  • insuredItemId

부상

  • partyId

  • partyName

  • claimPartyRelationshipTypeId

  • claimPartyRelationshipTypeName

claimantPartyRelationshipTypeID 및 claimantPartyRelationshipTypeName에는 이 두 요소 중 하나만 필요합니다.

claimantPartyName 및 claimantPartyID에는 이 두 요소 중 하나만 필요합니다.

일치하는 각 입력 중 하나의 패키지가 있어야 합니다.

새 조합인 경우 레코드를 삽입합니다. 새 콤보가 아닌 경우 콤보에 기존 레코드를 사용합니다.

출력은 claimantId(partyId 아님)입니다.

다음은 Vlocity 클레임에 대한 입력 JSON 형식입니다.

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

출력 JSON

다음은 Vlocity 클레임의 출력 JSON 형식입니다.

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

샘플 인터페이스(Vlocity 클레임 개체 모델)

{
  "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
    }
  }
}
 
로드 중
Salesforce Help | Article