Loading
보험
InsPolicyService:createRenewalPolicy

InsPolicyService:createRenewalPolicy

이 서비스를 사용하여 기존 정책에서 갱신 정책을 만듭니다.

클래스: InsPolicyService

방법: createRenewalPolicy

작동 방법

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

    노트
    노트

    서비스는 가격 재계산을 위한 추가 등급 요소를 결정하기 위해 userInputs을 전달합니다. 또한 서비스는 additionalFields 노드를 사용하여 정책 개체의 추가 필드를 채우며, 이 서비스에는 포함되지 않습니다.

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

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

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

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

  4. 서비스는 includePaymentSchedule 및 includeRevenueSchedule을 사용하여 지불 일정 및 매출 일정이 갱신된 정책에 대해 생성되어야 하는지 여부를 결정합니다. 옵션이 지정되지 않은 경우 이전 정책에서 동일한 설정이 승계됩니다.

  5. 서비스에서 정책을 만들고 갱신된 정책으로 표시합니다.

노트
노트

또한 서비스는 원래 증권 버전의 기간이 365일 미만이거나 해당 연도의 기간이 366일 미만인 증권의 갱신을 지원합니다. 그러나 갱신 시 증권 기간은 365일이며, 윤년의 경우 366일입니다. 보험 증권에 대한 고려 사항 및 제한 사항을 참조하십시오.

입력

입력

설명

policyId

필수

갱신할 정책의 ID입니다.

userInputs

선택 사항

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

userInputs가 제공되지 않을 경우 갱신 서비스는 기존 정책의 정보를 가져와서 갱신된 정책에 복제합니다.

additionalFields

선택 사항

이 서비스의 일부가 아닌 추가 필드의 키-값 쌍입니다. 이러한 필드는 정책 개체에 채워집니다.

원격 옵션

노트
노트 InsProductService:repriceProduct에서 사용되는 모든 원격 옵션도 이 서비스와 함께 사용할 수 있습니다.

원격 옵션

설명

renewalExpirationDate

선택 사항

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

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

renewalEffectiveDate

선택 사항

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

기존 정책 만료 날짜 + 1일

Insurance Industries Extension 패키지를 사용하는 경우 renewalEffectiveDate 옵션의 타임스탬프 값이 무시됩니다. 대신 유효 일자 타임스탬프 값은 선택한 유효 일자의 오전 12시로 설정되고, 선택한 만료 일자의 만료 일자 값은 오후 11시 59분으로 설정됩니다. 타임스탬프는 사용자의 지정된 시간대를 사용하여 설정됩니다.

aggByKey

필수

PRODUCT.instanceKey

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

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

서비스는 이 값을 사용하여 정책을 다시 지정합니다.

calculateTaxesAndFees

(선택 사항)

기본값은 true입니다.

세금 및 수수료를 계산하려면 true로 설정합니다.

createTransaction

(선택 사항)

True 또는 False

기본값은 False입니다.

true인 경우 서비스가 매출 일정 서비스에서 사용되는 트랜잭션을 만듭니다.

includeInputKeys

필수

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

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

계산 절차에 사용된 키만 결과에 값을 포함합니다.

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

includePaymentSchedule

선택 사항

true인 경우 서비스에서 갱신된 증권에 대한 결제 일정을 만듭니다. 값이 제공되지 않을 경우 원래 정책에 대한 값이 있는 경우에만 서비스에서 갱신된 증권에 대한 결제 일정을 만듭니다.

includeRevenueSchedule

선택 사항

true이면 서비스에서 갱신된 증권에 대한 매출 일정을 만듭니다. 값이 제공되지 않을 경우 서비스는 원래 정책에 대한 결제 일정이 있는 경우에만 갱신된 증권에 대한 결제 일정을 만듭니다.

paymentCalculationMethod

includePaymentSchedule 값이 true인 경우 필수 항목입니다.

정책의 Premium Calculation Method 값을 재정의합니다.

paymentFrequency

includePaymentSchedule 값이 true인 경우 필수 항목입니다.

정책의 PremiumFrequency 값을 재정의합니다.

paymentType

includePaymentSchedule 값이 true인 경우 필수 항목입니다.

정책의 Premium Payment Type 값을 재정의합니다.

ratingDate

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

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

term

선택 사항

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

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
      }
    ],
   "additionalFields": {
      "BillingName": "John Smith",
      "Description": "This is a renewal quote",
      "Phone": "123456789"
    }
}    

출력 JSON

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

{
  "snapshotId": [
    "00P5w00001fKlqEEAS"
  ],
  "InsurancePolicy": [
    "0YT5w000000Y8tTGAS"
  ]
  "error": "OK"
}
 
로드 중
Salesforce Help | Article