Loading
시스템 관리자에 대한 피싱 방지 MFA 및 전 직원사용자 MFA 적용 안내 더 많이 읽기
보험
InsPolicyService:cancelPolicy

InsPolicyService:cancelPolicy

이 서비스를 사용하여 기존 보험 증권을 취소합니다.

이 서비스는 InsPolicyService:prepareToCancelPolicy 서비스 및 InsPolicyRevenueScheduleService:cancelRevenueSchedule 서비스와 협력하여 정책을 취소하고 환불 금액을 제공하고(필요한 경우) 매출 일정을 종료하는 데 필요한 모든 변경 사항을 완료합니다.

클래스: InsPolicyService

방법: cancelPolicy

이 서비스는 Salesforce Financial Services Cloud와 함께 작동합니다.

작동 방법

  1. 취소할 정책의 assetId 또는 policyId 및 취소가 적용되는 effectiveDate을 가져옵니다.

    노트
    노트 유효 취소 날짜는 오늘보다 길 수 없습니다.
  2. 정책 상태를 Canceled로 업데이트하고 원래 만료 일자를 만료 일자의 현재 값으로 업데이트하고 만료 일자를 취소 일자 이전 날짜로 업데이트합니다(시간 스탬프가 오후 11시 59분).

  3. 만료 날짜를 서비스에 전달된 effectiveDate로 변경하며 타임스탬프는 오후 11시 59분입니다.

  4. useIsPaidFlag 값을 기반으로 적절한 계산 프로세스를 사용합니다.

    useIsPaidFlag가 false(선택되지 않음)로 설정된 경우 서비스는 증권의 기간별 총 보험료, 기간별 총 수수료, 기간별 총 세금을 비례 배분하고 취소 날짜 및 증권 지불 날짜를 기반으로 환불된 금액을 계산합니다. 증권 지불 일자가 Null인 경우 서비스는 전체 지불 증권을 고려하고 만료 일자를 사용합니다.

    useIsPaidFlag가 true로 설정된 경우(선택됨) 서비스:

    1. 결제 일정을 사용하여 증권에 대해 이미 지급된 총액을 계산합니다. 정책에 지급된 총액은 지불됨 이 true로 설정된 지불 일정의 금액 합계(선택됨)입니다. 이 금액은 환불 계산에 사용됩니다.

    2. 증권의 기간별 총 보험료, 기간별 총 수수료, 기간별 총 세금을 비례 배분하고 취소 날짜 및 증권에 대해 이미 지급된 총액을 기반으로 환불 금액을 계산합니다.

    3. 현재 날짜 또는 취소 날짜(나중 날짜)를 기반으로 결제 일정을 조정합니다. 이 날짜 또는 그 이후의 결제 일정이 Is Paid로 설정된 경우(선택 취소됨) 서비스에서 삭제합니다.

    4. cancellationDate부터 지난 모든 지불되지 않은 결제 일정의 상태를 Invalid로 업데이트합니다. 지불되지 않은 금액이 새 결제 일정에 추가됩니다.

    5. 이미 계산된 환불 금액과 동일한 금액으로 현재 날짜에 대한 새 지불 일정을 생성하고 상태를 Valid로 표시합니다. createTransaction가 true이면 서비스에서 취소 트랜잭션을 생성합니다.

    6. 취소 정보가 포함된 모든 향후 증권 버전을 업데이트합니다.

      • 상태: 취소됨

      • 취소 날짜: 서비스에 effectiveDate 전달됨

      • 기간 보험료, 기간 세금, 기간 비용: 0

      • 만료 일자: 오전 11시 59분의 타임스탬프를 사용하여 effectiveDate가 서비스에 전달되기 전날

  5. 데이터베이스에 비례 배분된 TotalPremiumForTerm을 커밋합니다.

  6. createTransaction=true 및 전달된 ID가 assetId인 경우 AssetTransaction_c(Amount_c=refund, postDate_c 및 transactionDate_c=effectiveDate, type=transactionType(기본값은 취소됨)를 만듭니다. createTransaction=true 및 전달된 ID가 policyId인 경우 서비스는 InsurancePolicyTransaction_c 또는 InsurancePolicyTransaction(Amount_c=refund, postDate_c 및 transactionDate_c=effectiveDate, type=transactionType(기본값은 취소됨)을 만듭니다.

    서비스는 트랜잭션 세부 사항 개체에 트랜잭션 분석 데이터도 채웁니다. 각 자산, 참가자, 보장 범위가 보험료, 세금, 수수료와 관련하여 총 거래 금액에 얼마나 기여하는지에 대한 데이터를 표시합니다. 보험료, 세금, 수수료에 대해 0이 아닌 값이 하나 이상 있는 자산, 참가자, 보장 범위만 표시됩니다.
  7. assetId 및 새로 만든 transactionId을 사용하여 InsPolicyRevenueScheduleService:cancel 호출

  8. InsPolicyRevenueScheduleService: 취소 서비스는 매출 일정의 종료를 계산하고 결과를 정책의 매출 일정 섹션에 게시합니다. 환불 금액은 보험사 관점에서 가져옵니다. 음수 금액은 보험 소유자에게 환불되며, 양수 금액은 보험 소유자가 지불하지 않은 금액을 나타냅니다.

노트
노트

또한 서비스는 원래 증권 버전의 기간이 365일 미만이거나 해당 연도의 기간이 366일 미만인 증권 취소를 지원합니다. 보험 증권에 대한 고려 사항 및 제한 사항을 참조하십시오.

추가 요금(세금 및 수수료)

이 서비스(prepareToCancel 서비스와 함께)는 정책 취소 시 세금 및 수수료의 비례 배분 및 환불을 지원합니다. 작동 방식은 다음과 같습니다.

  • 대상 정책에 TotalTaxAmount__c가 있는 경우 해당 값이 취소 날짜에 비례 배분되고 TotalTaxForTerm__c 필드에 설정됩니다.

  • 대상 정책에 TotalFeeAmount__c가 있는 경우 해당 값이 취소 날짜에 비례 배분되고 TotalFeeForTerm__c 필드에 설정됩니다.

  • createTransaction 옵션(아래 참조)이 true로 설정되고 대상 정책에 환불 가능한 AssetPricingAdjustment__c 레코드가 있는 경우 비례 배분 환불 금액은 거래의 TaxAmount__c 및 FeeAmount__c 필드에 설정됩니다.

자산 개체 모델 대신 보험 증권 개체 모델을 사용하는 경우 필드 이름은 다릅니다.

  • TotalTaxAmount__c = StandardTaxAmount

  • TotalTaxForTerm__c = TermTaxAmount

  • TotalFeeAmount__c = StandardFeeAmount

  • TotalFeeForTerm__c = TermFeeAmount

  • AssetPricingAdjustment__c = InsurancePolicySurcharge

  • TaxAmount__c = TransactionTaxAmount

  • FeeAmount__c = TransactionFeeAmount

팁
팁

자산 개체 모델에서 보험 증권 개체 모델로 전환하는 방법에 대해 알아보려는 경우 보험 정책 조화를 참조하십시오.

원격 옵션

옵션

설명

additionalFees

(선택 사항)

보험 증권 취소에 하나 이상의 수수료를 추가합니다. 서비스는 수수료 합계로 취소 환불 금액을 줄이고, 결제 일정 항목을 조정하며, 취소 트랜잭션 분석에 수수료를 반영합니다.

각 수수료를 "<fee type>": <amount>로 형식화합니다.

예를 들어, $10 관리 수수료 및 $20 취소 수수료를 추가하려면 다음을 입력합니다.

  "additionalFees": {
    "Cancellation Fee": 20,
    "Admin Fee": 10
  }

취소 환불이 총 수수료 $120인 경우 해당 추가 수수료는 30달러로 줄입니다. 따라서 취소 환불 금액은 90달러입니다.

assetId 또는 policyId

(필수)

%theIdYouAreLookingFor%

취소되는 증권(자산) 또는 InsurancePolicy의 ID입니다.

cancelRevenueScheduleCustomeClassName

옵션(FSC 전용).

기본값은 CancelRevenueSchedule로 설정됩니다.

createTransaction

(선택 사항)

true 또는 false

기본값은 false입니다.

true하면 서비스가 매출 일정 서비스에서 사용할 거래를 만듭니다.

effectiveDate

(필수)

“YYYY-MM-DD HH:MM:SS” 또는 %OmniScriptDataElement%

정책이 취소되는 날짜입니다.

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

getDataCustomClassName

옵션(FSC 전용).

이 서비스에서 정책(자산) 정보를 검색하는 데 사용하는 사용자 정의 클래스의 이름입니다.

Salesforce FSC를 사용하는 경우 이 옵션 또는 getDataDRBundleName를 지정해야 합니다.

기본값은 GetInsurancePolicy로 설정됩니다.

getDataDRBundleName

옵션(FSC 전용).

이 서비스에서 정책(자산) 정보를 검색하는 데 사용하는 Omnistudio 데이터 매퍼의 이름입니다.

Salesforce FSC를 사용하는 경우 이 옵션 또는 getDataCustomClassName를 지정해야 합니다.

  • 둘 다 지정하면 서비스에서 getDataDRBundleName 값을 사용합니다.

  • 지정하지 않으면 서비스에서 getDataCustomClassName의 기본값(GetInsurancePolicy)을 사용합니다.

includeRevenueSchedule

(선택 사항)

true 또는 false

true 경우 이 옵션은 서비스에 수익 일정 취소를 위해 InsPolicyRevenueScheduleService: cancel 서비스를 호출하도록 지시합니다.

false 경우 서비스는 수익 예약에 대해 아무것도 하지 않습니다.

기본값은 false입니다.

updateDataCustomClassName

옵션(FSC 전용).

Salesforce FSC를 사용하는 경우 이 옵션 또는 updateDataDRBundleName를 지정해야 합니다.

기본값은 PostInsurancePolicy로 설정됩니다.

updateDataDRBundleName

옵션(FSC 전용).

Salesforce FSC를 사용하는 경우 이 옵션 또는 updateDataCustomClassName를 지정해야 합니다.

  • 둘 다 지정하면 서비스에서 updateDataDRBundleName 값을 사용합니다.

  • 지정하지 않으면 서비스에서 updateDataCustomClassName의 기본값(PostInsurancePolicy)을 사용합니다.

useIsPaidFlag

(선택 사항)

true 또는 false

true인 경우 새 비례 배분 논리가 사용됩니다(결제 일정을 고려).

false인 경우 기존 비례 배분 논리가 사용됩니다(취소 날짜 및 paidToDate를 사용).

기본값은 false로 설정됩니다.

입력 JSON

이 서비스는 입력 JSON을 받지 않습니다.

출력 JSON

Asset 개체 모델을 사용하는 경우 이 서비스는 JSON output 노드를 반환합니다. 예는 다음과 같습니다.

{
  "output": {
    "records": [
      {
        "instest10__TotalAmount__c": 420.97,
        "instest10__TaxAmount__c": 37.93,
        "instest10__FeeAmount__c": 3.68,
        "instest10__Amount__c": 379.36,
        "Id": "a416g0000002CZpAAM"
      }
    ],
    "totalSize": 1
  }
}

보험 증권 개체 모델을 사용하는 경우 이 서비스는 JSON results 노드를 반환합니다. 예는 다음과 같습니다.

{
    "result": {
        "type": "Cancelled",
        "transactionNumber": null,
        "transactionDate": 
        "totalAmount": null,
        "taxAmount": null,
        "postDate": "2021-09-01T07:00:00.000Z",
        "name": "Cancelled"
        "Id": null,
        "feeAmount": null,
        "amount": -133.4,
        "additionalInfo": null
    },
    "error": "OK"
}
 
로드 중
Salesforce Help | Article