Loading
보험
InsPolicyService:prepareToRenewPolicy

위치:

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

InsPolicyService:prepareToRenewPolicy

이 서비스를 사용하여 기존 증권을 갱신하는 데 필요한 금액을 계산합니다. 이 서비스는 정책을 만들지 않고 갱신 보험료, 세금, 수수료 또는 갱신 정책 JSON을 반환합니다.

클래스: InsPolicyService

방법: prepareToRenewPolicy

작동 방법

  1. 서비스는 갱신할 정책의 policyId에 동의합니다.

  2. 서비스에서 갱신된 정책의 유효 일자 및 만료 일자를 확인합니다. 제공되지 않은 경우 서비스는 다음 논리를 사용하여 다음 날짜를 계산합니다.

    • 유효 일자 = 원래 정책의 만료 일자 + 1일

    • 만료 일자 = 새 정책의 유효 일자 + 새 정책의 기간

  3. aggByKey 및 includeInputKey 옵션을 사용하여 정책 제품의 가격을 변경합니다.

  4. getPolicyJson를 사용하여 갱신 금액 구성 요소만 반환해야 하는지 또는 전체 정책 JSON이 응답에 전송되는지 여부를 결정합니다.

입력

입력

설명

policyId

필수

갱신할 정책의 ID입니다.

userInputs

선택 사항

정책과 연결된 제품의 세부 사항입니다. 모든 제품의 경우 제품 보기의 API 탭에 있는 서비스 목록에서 userInputs 개체의 대상 형식을 가져옵니다. 객체 키는 ProductCode가 제품 코드, 관련 보장 사양, 보험 항목 사양 또는 등급 사실인 형식의 ProductCode.AttributeCode입니다.

원격 옵션

원격 옵션

설명

aggByKey

필수

PRODUCT.instanceKey

서비스에서 이 옵션을 계산 절차에 입력으로 보내 집계를 통해 계산을 완료하는 데 사용합니다.

예를 들어 자동차 보험 증권에 보장되는 각 차량에 여러 운전자가 첨부되어 있는 경우 보험 차량에는 증권의 각 인스턴스에 대해 별도의 instanceKey가 있습니다. aggByKey는 차량의 모든 인스턴스 키를 가져와서 instanceKey당 보장 보험료의 배열을 만듭니다. 이 배열은 계산 절차에 전달되므로 보험료가 올바르게 계산됩니다.

서비스는 이 옵션을 사용하여 정책을 변경합니다.

calculateTaxesAndFees

선택 사항

true 또는 false

true로 설정하여 갱신된 증권에 대한 세금 및 수수료를 계산합니다.

includeInputKeys

필수

서비스가 계산 절차에 들어오거나 나가는 쉼표로 구분된 키-값 쌍의 문자열입니다.

이러한 키-값 쌍은 CalculatedPriceData 객체 내의 출력 제품 개체에 포함됩니다. 이를 통해 계산 결과를 구문 분석할 수 있습니다.

서비스는 이 옵션을 사용하여 정책을 변경합니다.

getPolicyJson

선택 사항

갱신 금액 구성 요소만 응답으로 반환해야 하는지 또는 전체 정책 JSON을 반환해야 하는지를 결정하는 부울 플래그입니다.

ratingDate

정책 재평가를 위한 평가 절차를 결정합니다. 제공되지 않은 경우 수정된 정책의 유효 일자를 기반으로 가격 책정이 완료됩니다.

노트
노트 필드 유형이 날짜이므로 ratingField에 대한 특정 시간을 경과할 수 없습니다. 따라서 등급 날짜 타임스탬프는 기본적으로 오전 12시로 지정됩니다.

renewalEffectiveDate

선택 사항

갱신된 정책의 유효 일자입니다. 제공되지 않은 경우 다음 논리를 사용하여 값이 계산됩니다.

기존 정책 만료 날짜 + 1일

renewalExpirationDate

선택 사항

갱신된 정책의 만료 일자입니다. 제공되지 않은 경우 다음 논리를 사용하여 값이 설정됩니다.

새 정책의 유효 일자 + 새 정책의 기간

term

선택 사항

정책의 기간입니다. 원격 옵션에 제공되지 않은 경우 renewalExpirationDate을 계산하는 데 도움이 됩니다. InsPolicyService:prepareToRenewPolicy는 연간 증권 조건만 지원합니다.

useLocalTimezone

True 또는 False

기본값은 true입니다.

값이 true로 설정되면 서비스에서 정책이 생성된 로컬 시간대를 사용합니다.

값이 false로 설정되면 서비스에서 GMT를 시간대로 사용합니다.

입력 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
      }
    ]
}

출력 JSON

다음은 출력 JSON의 예입니다.

{
  "totalFeeForTermDiff": -0.07,
  "totalTaxForTermDiff": 0,
  "totalPremiumForTermDiff": -2.73,
  "newFeeForTerm": 24.93,
  "newTaxForTerm": 0,
  "newPremiumForTerm": 997.27,
  "newFee": 25,
  "newTax": 0,
  "newStandardPremium": 1000
}
 
로드 중
Salesforce Help | Article