위치:
InsPolicyService:createOutOfSequencePolicyVersion
이 서비스를 사용하여 주어진 정책에 대한 순서 외 추천을 시작합니다.
클래스: InsPolicyService
방법: createOutOfSequencePolicyVersion
서비스는 순서 외 추천에 대해 다음 트랜잭션을 만듭니다.
-
순서 외 변경됨/승인됨: 추천으로 인해 증권 연도의 보험료 총액 변경 다중 기간 정책이 영향을 받는 경우 각 기간에 대해 트랜잭션이 생성됩니다.
-
순서 외 추천: 추천이 수행될 때 결제 일정에 대한 보험료 조정액입니다. 이는 현재 기간에만 적용됩니다. 결제 일정 시작 일자는 지난 날짜와 현재 날짜 사이에 순서 외가가 적용되는 현재 날짜 또는 작업 일자입니다. 향후 날짜의 경우 결제 일정 시작 일자는 순서 외 추천의 유효 일자입니다.
중요 조건 전반의 모든 정책 버전에 참조 정책 번호를 채워야 합니다.
작동 방법
-
서비스는 현재 정책, 순차적으로 승인되는 날짜 및
inputKey에서 지정한 JSON을policyId합니다. -
createTransaction가true인 경우 서비스가Out-of-Sequence Changed/Endorsed유형 및 트랜잭션 세부 사항의 순서가 없는 트랜잭션을 만듭니다. -
includePaymentSchedule가true인 경우 서비스에서 결제 일정 및 결제 일정 입력 세부 사항을 생성하거나 업데이트합니다. 계산은 해당paymentCalculationMethod및paymentFrequency옵션에 대해 선택된 값을 기반으로 합니다. 결제 일정은 기존 결제 일정 규칙을 따릅니다.-
향후 날짜가 기록된 지불되지 않은 결제 일정만 업데이트됩니다.
-
지불 또는 미지불인 지난 결제 일정은 업데이트되지 않습니다.
-
지난 날짜 결제 및 결제 일정에 대한 조정 내용은 순서 외 추천 트랜잭션에 포함됩니다.
-
-
서비스는 관련 보험 증권 버전의
IsPolicyEditLocked필드 값을true로 업데이트합니다. 모든 증권 버전은 순서가 없는 보증 트랜잭션이 완료될 때까지 잠깁니다.
또한 서비스는 원래 증권 버전의 기간이 365일 미만이거나 하위 연도의 기간이 366일 미만인 경우 순차적으로 추천을 지원합니다. 보험 증권에 대한 고려 사항 및 제한 사항을 참조하십시오.
사용자 정의 필드 지원
-
보험 증권 개체의 사용자 정의 필드를 OutOfSequenceEndorsementCustomFields 필드 집합에 저장합니다.
-
additionalFields섹션에서 사용자 정의 필드를 키/값 쌍으로 채웁니다. 입력 JSON을 참조하십시오. -
이 OutOfSequenceEndorsementCustomFields 필드 집합을 사용하여 사용자 정의 데이터를 취소된 정책 버전에서 새 정책 버전으로 복사합니다.
원격 옵션
옵션 |
설명 |
|---|---|
policyId
|
(필수) 신규 또는 업데이트된 정보를 기반으로 서비스가 업데이트하는 기존 정책의 ID입니다. |
createContactForParticipants
|
(선택 사항) |
createInsuredItemsRelationships
|
(선택 사항)
이 옵션이 이 옵션은 상위 > 하위 및 상위 > 하위 > 손자 보험 항목 관계를 지원합니다. |
createTransaction
|
(선택 사항)
기본값은
|
effectiveDate
|
(필수)
순서가 없는 추천 변경 사항이 적용되는 날짜입니다. |
includePaymentSchedule
|
(선택 사항) 정책에 대한 지불 일정이 생성되거나 업데이트된 경우의 기본값은 |
inputKey
|
(필수)
정책을 만들거나 업데이트하는 데 필요한 입력이 있는 JSON입니다. 다음 값 중 하나를 지정할 수 있습니다.
|
paymentCalculationMethod
|
includePaymentSchedule가 true인 경우 필수 항목입니다. 이 옵션은 정책의 보험료 계산 방법 값을 재정의합니다. |
paymentFrequency
|
includePaymentSchedule가 true인 경우 필수 항목입니다. 이 옵션은 정책의 보험료 빈도 값을 재정의합니다. |
paymentType
|
includePaymentSchedule가 true인 경우 필수 항목입니다. 이 옵션은 정책의 보험료 결제 유형 값을 재정의합니다. |
postDataCustomClassName
|
(선택 사항) 서비스에서 새 정책 버전을 저장하는 데 사용하는 사용자 정의 클래스의 이름입니다. 이 옵션 또는 기본값은 PostInsurancePolicy입니다. |
postDataDRBundleName
|
(선택 사항) 서비스에서 새 정책 버전을 저장하는 데 사용하는 Omnistudio 데이터 매퍼의 이름입니다. 이 옵션 또는
|
transactionType
|
(선택 사항)
|
term
|
서비스에서 만든 정책의 기간입니다. InsPolicyService:createOutOfSequencePolicyVersion은 연간 증권 조건만 지원합니다. |
입력 JSON
서비스는 제품 JSON 내에서 지정된 inputKey을 찾습니다. 다음은 샘플 입력 JSON입니다.
"newPolicyJSON": {
"accountId": "001f400000RrQSrAAN",
"term": "Annual",
"productConfigurationDetail": {
...
},
"insuredItems": {
...
},
"additionalFields": {
"vlocity_ins__Type__c": "AUTO",
},
}다음은 JSON 옵션 샘플입니다.
{
"effectiveDate": "2023-03-01",
"inputKey": "quotepolicyJson",
"policyId": "0YT3t000000uUz6GAE",
"includePaymentSchedule": true,
"createTransaction": true,
"paymentFrequency": "Monthly",
"paymentCalculationMethod": "Modal"
}출력 JSON
다음은 서비스가 순서 외 추천을 시작하고 작업 ID를 성공적으로 생성할 때 JSON을 출력하는 샘플입니다.
{
"jobId": "7073t0000BNGivxAQD",
"errorCode": "INVOKE-200",
"error": "OK"
}다음은 서비스에서 오류를 반환할 때 JSON을 출력하는 샘플입니다.
{
"errorCode": "ERROR-CODE",
"error": "error message"
}