위치:
InsPolicyService:createPaymentSchedule
InsPolicyService:createPaymentSchedule 서비스는 대상 정책에 대한 결제 일정을 만들고 경우에 따라 초기 결제 트랜잭션을 만듭니다. 이는 보험 증권 개체에만 적용됩니다. 정책(자산) 개체는 지원되지 않습니다.
메서드: createPaymentSchedule
작동 방법
-
서비스는 InsurancePolicy ID를 가져와 증권 정보 및 옵션 매개 변수를 사용하여 결제 일정을 만듭니다.
-
정책의 원본 증권 ID에 이미 기존 결제 일정이 있는 경우 서비스에서 오류 메시지를 반환합니다.
-
초기 지불이 발생하면 보험 증권 거래가 생성됩니다.
-
결제 일정 저장 시 레코드는 정책의 원래 증권 ID에 연결됩니다.
-
결제 일정이 JSON 결과에 추가됩니다.
원격 옵션
원격 옵션 |
설명 |
|---|---|
coolingOffPeriod
|
선택 사항 첫 번째 결제 일정 항목을 지연할 수 있는 일수입니다. 냉각 기간을 사용하면 정책의 첫 번째 결제 일정 날짜가 유효 날짜 + 일 수로 계산됩니다. 예를 들어, 유효 일자가 1월 5일이고 첫 번째 결제 일정 일자가 1월 5일인 월별 결제 빈도가 있습니다. 냉각 기간이 14일인 경우 첫 번째 결제 일정 항목이 1월 5일부터 1월 19일까지 변경됩니다. 나머지 월별 결제 일정 날짜는 그대로 유지됩니다. 노트 냉각 기간은 정책 시작 일자로부터 1일에서 28일 사이여야 합니다. |
|
(선택 사항) 보험 증권 레코드를 검색하는 데 사용되는 사용자 정의 클래스입니다. 기본값은 GetInsurancePolicy입니다. |
|
(선택 사항) 결제 일정을 검색하는 데 사용되는 Omnistudio 데이터 매퍼입니다. |
|
(선택 사항) 초기 결제에 사용되는 결제 규칙입니다. 예: 일, 월 또는 백분율. |
|
(선택 사항) 트랜잭션 이름입니다. 기본값은 |
|
(선택 사항) 트랜잭션 유형입니다. 기본값은 Premium Charge입니다. |
|
(선택 사항) 백분율 값 또는 월 수 또는 일 수입니다.
|
|
(선택 사항) 정책의 Premium 계산 방법 값을 재정의합니다. |
|
(선택 사항) 정책의 Premium Frequency 값을 재정의합니다. |
|
(선택 사항) 첫 번째 결제 일정 항목의 날짜입니다. 기본값은 정책의 유효 일자입니다. |
|
(선택 사항) 정책의 보험료 결제 유형 값을 재정의합니다. |
|
(필수) 결제 일정을 만드는 데 사용되는 InsurancePolicy의 ID입니다. |
|
(선택 사항) 결제 일정을 저장하는 데 사용할 사용자 정의 클래스입니다. 기본값은 PostInsurancePolicyPaymentSchedule입니다. |
|
(선택 사항) 결제 일정을 저장하는 데 사용되는 데이터 매퍼입니다. |
|
(선택 사항) 결제 일정 레코드가 저장될 경우 적용됩니다. 기본값은 |
입력 JSON
{
"policyId": "0YT5w000000UHv6GAG",
"paymentFrequency": "Monthly",
"paymentCalculationMethod": "Daily",
"paymentType": "Advanced",
"paymentStartDate": "1/1/2020",
"initialPaymentRule": "Percentage",
"initialPaymentValue": "10",
"initialPaymentTransactionType": "Premium Charge",
"initialPaymentTransactionName": "",
"postPaymentSchedule": "true"
}출력 JSON
{
"output": {
"paymentSchedule": [
{
"totalAmount": 571.5,
"toDelete": null,
"taxAmount": 51.5,
"scheduleDate": "2020-06-21",
"premiumAmount": 515,
"insTransaction": {
"type": "Premium Charge",
"transactionNumber": null,
"transactionDate": null,
"totalAmount": 571.5,
"taxAmount": 51.5,
"postDate": null,
"name": "Premium Charge",
"Id": null,
"feeAmount": 5,
"amount": 515,
"additionalInfo": null
},
"Id": null,
"feeAmount": 5
},
{
"totalAmount": 2578.79,
"toDelete": null,
"taxAmount": 232.38,
"scheduleDate": "2020-09-21",
"premiumAmount": 2323.85,
"insTransaction": null,
"Id": null,
"feeAmount": 22.56
},
{
"totalAmount": 1268.27,
"toDelete": null,
"taxAmount": 114.29,
"scheduleDate": "2020-12-21",
"premiumAmount": 1142.88,
"insTransaction": null,
"Id": null,
"feeAmount": 11.1
},
{
"totalAmount": 1296.44,
"toDelete": null,
"taxAmount": 116.83,
"scheduleDate": "2021-03-21",
"premiumAmount": 1168.27,
"insTransaction": null,
"Id": null,
"feeAmount": 11.34
}
],
"errorCode": "INVOKE-200",
"error": "OK"
}
}