위치:
InsPolicyService:createRenewalQuote
이 서비스를 사용하여 기존 정책에 대한 갱신 견적서를 만듭니다.
작동 방법
-
서비스는 갱신할 정책의
policyId에 동의합니다.
노트서비스는 가격 재계산을 위한 추가 평가 요소를 결정하기 위해
userInputs을 전달합니다. 또한 서비스는additionalFields노드를 사용하여 이 서비스의 일부가 아닌 견적서 개체의 추가 필드를 채웁니다. -
서비스에서 갱신된 정책의 유효 일자 및 만료 일자를 확인합니다. 제공되지 않은 경우 서비스는 다음 논리를 사용하여 다음 날짜를 계산합니다.
-
유효 일자 = 원래 정책의 만료 일자 + 1일
-
만료 일자 = 새 정책의 유효 일자 + 새 정책의 기간
-
-
aggByKey및includeInputKey옵션을 사용하여 정책 제품의 가격을 변경합니다. -
서비스는 입력의
OpportunityDetails JSON노드를 사용하여 기회 레코드를 만듭니다. 샘플 입력 JSON을 참조하십시오. 이 노드는 다음 세 가지 필수 필드만 허용합니다.-
이름
-
단계 이름
-
종료 날짜
노트 이 노드에는 추가 기회 필드를 포함할 수 없습니다. 그러나 갱신 견적서가 생성된 후 추가 세부 사항으로 기회 레코드를 업데이트할 수 있습니다. -
-
서비스에서 '갱신' 유형의 견적서를 만들고 이전 단계에서 생성된 기회 레코드에 연결합니다.
입력
입력 |
설명 |
|---|---|
|
필수 갱신할 정책의 ID입니다. |
|
선택 사항 정책과 연결된 제품의 세부 사항입니다. 모든 제품의 경우 제품 보기의 API 탭에 있는 서비스 목록에서 |
|
선택 사항 이 서비스의 일부가 아닌 추가 필드의 키-값 쌍입니다. 다음 필드는 견적서 개체에 채워집니다. |
|
갱신 견적서에 연결된 갱신 기회의 세부 사항입니다. 이 노드가 없는 경우 서비스는 원래 정책의 소스 견적서에 연결된 기회의 기회 세부 사항을 수집합니다. |
원격 옵션
원격 옵션 |
설명 |
|---|---|
|
선택 사항 갱신된 정책의 유효 일자입니다. 제공되지 않은 경우 다음 논리를 사용하여 값이 계산됩니다. 기존 정책 만료 날짜 + 1일 |
|
선택 사항 갱신된 정책의 만료 일자입니다. 제공되지 않은 경우 다음 논리를 사용하여 값이 설정됩니다. 새 정책의 유효 일자 + 새 정책의 기간 |
|
선택 사항 정책의 기간입니다. 원격 옵션에 제공되지 않은 경우 |
|
선택 사항
|
|
필수
서비스에서 이 옵션을 계산 절차에 대한 입력으로 보내 집계를 통해 계산을 완료하는 데 사용합니다. 예를 들어 자동차 보험 증권에 보장되는 각 차량에 여러 운전자가 첨부되어 있는 경우 보험 차량에는 증권의 각 인스턴스에 대해 별도의 instanceKey가 있습니다. 서비스는 이 옵션을 사용하여 정책을 변경합니다. |
|
필수 서비스가 계산 절차에 들어오거나 나가는 쉼표로 구분된 키-값 쌍의 문자열입니다. 이러한 키-값 쌍은 계산 절차에 사용된 키만 결과에 값을 포함합니다. |
| failOnRatingFailure | 선택 사항 갱신 중 평가가 결과를 반환하지 않는 경우 서비스가 실패해야 하는지 여부를 지정합니다. true이면 서비스가 중지되고 오류가 반환됩니다. false이면 서비스가 계속 진행되고 등급 결과 없이 갱신 견적서가 생성됩니다. |
입력 JSON
다음은 입력 JSON의 예입니다.
{
"policyId": "0YT5w000000Y8MNGA0",
"userInputs": [
{
"DRIVER.instanceKey": "Bob Jones",
"DRIVER.LN": "Jones",
"DRIVER.GENDER": "Male",
"DRIVER.FN": "Bobby",
"DRIVER.AGE": 30,
"AUTO.instanceKey": "2018 Audi A3",
"AUTO.autoYear": 2018,
"AUTO.autoModel": "A4",
"perAccident": 500
}
],
"additionalFields": {
"BillingName": "John Smith",
"Description": "This is a renewal quote",
"Phone": "123456789"
},
"OpportunityDetails": {
"Name": "Renewal Opportunity",
"StageName": "Qualification",
"CloseDate": "2023-04-04"
}
}