조정 계산을 위한 사용자 정의 통합 절차
표준 식 집합은 보험 증권 제한 컨텍스트 내의 의무를 처리하도록 설계되었습니다. 더 전문화된 계산이 필요한 인스턴스가 있습니다. 사용자 정의 논리를 사용하여 중재 가능, Copays, Coinsurance 또는 OOPM(Out-of-Pocket Maximum)을 계산해야 하는 경우 사용자 정의 통합 절차(IP)를 사용하여 계산 플로를 확장할 수 있습니다.
필수 Edition
| 지원되는 Edition 을 확인하세요. |
사용자 정의 IP는 다음과 같은 상황에서 특히 유용합니다.
- 외부 데이터: 계산에 필요한 데이터는 항상 표준 데이터 집합으로 제한되지 않습니다. 예를 들어 연령, 지역 또는 고용주 그룹과 같은 청구자 또는 계정 데이터를 통합할 수 있습니다. 이 외부 데이터는 차감, 복수, 공동 보험 또는 OOPM 계산에 크게 영향을 미칠 수 있습니다.
- 고급 논리: 일부 시나리오에서는 표준 논리가 충분하지 않을 수 있습니다. 예를 들어 연령 기반 공동 보험 리베이트 또는 기타 복잡한 규칙을 적용해야 합니다.
- 실시간 소비 값: 특정 경우 계산에 필요한 값은 동적이며 실시간으로 가져옵니다. 이는 최신 정보에 액세스하는 외부 API가 포함됩니다.
사용자 정의 IP를 사용하면 계산이 정확하고 특정 요구에 맞게 조정되어 식 집합의 표준 기능을 넘는 데이터 및 논리를 활용할 수 있습니다. 이 유연성은 복잡한 보험 시나리오를 처리하고 정확한 결과를 제공하는 데 매우 중요합니다.
사용자 정의 통합 절차를 만들기 전에 Omnistudio 메타데이터 API 지원을 활성화해야 합니다.
사용자 정의 IP 워크플로
조정을 계산하기 위한 사용자 정의 IP를 만드는 단계:
-
통합 절차를 만듭니다. 예: IP_CustomAdjustments.
IP에 이 샘플과 유사한 입력 맵이 수신됩니다.
{ "claimId": "801xx0000004Cc7GAE", "claimCoverageId": "1cxx0000004Cc7GAE", "claimedAmount": 1000, "benefitName": "Medical", "paymentDetailId": "0Rvxx0000004Cc7GAE", "PolicyLimitStandings": [ { "insurancePolicyLimitId": "1TDxx0000004Cc7GAE", "category": "Deductible", "scope": "ClaimCoverage", "calcInitialAmount": 1000, "remainingAmount": 200 }, { "insurancePolicyLimitId": "1TDxx0000004Cc6GAE", "category": "Coinsurance", "scope": "ClaimCoverage", "calcInitialValue": 10 }, { "insurancePolicyLimitId": "1TDxx0000004Cc8GAE", "category": "OutOfPocketMax", "scope": "Policy", "calcInitialAmount": 6000, "remainingAmount": 300 } ], "additionalFields": { "networkType": "InNetwork", "treatmentCategory": "Preventive" } }청구 보장 범위 지불 세부 사항 개체에 설정된 필드를 구성하고 보장 범위 제품에 매핑하는 경우에만 IP에
additionalFields가 수신됩니다. 추가 필드에 컨텍스트 데이터를 포함하는 방법에 대한 자세한 내용은 사용자 정의 계산의 컨텍스트 데이터를 참조하십시오. -
다음과 같이 참조 데이터를 가져옵니다.
- 나이를 계산하는 연락처 개체의 DOB입니다.
- 지역을 결정할 계정 개체의 주소입니다.
-
경우에 따라 현재 순위 가져오기 API를 호출하여 최신 인출, 동료 지불, 공동 보험, OOPM 사용량을 가져옵니다.
- 현재 차감 가능한 잔액, OOPM 및 기타 의무 잔액을 검색하려면 IP 내에서 이 API를 사용합니다.
- 이렇게 하면 의무 계산에 계산 시 가장 최근 소비가 반영됩니다.
- 이 API를 호출하지 않을 경우 IP는 요청 또는 정적 구성을 통해 전달된 값을 사용합니다.
- 현재 상태 가져오기 API가 사용 사례에 적합하지 않은 경우 IP 내에서 다른 데이터 추출 도구를 사용할 수 있습니다.
-
의무 규칙 구현:
- 차감 가능: 나머지 차감 가능한 금액을 차감합니다.
- Coinsurance: 기준 또는 조정 비율을 적용합니다. 예를 들어 75세 이상의 청구자에게 할인된 공동 보험료를 적용합니다.
- OOPM: 청구자가 이미 기본 최대값에 도달한 경우 의무를 조정합니다.
- 컨텍스트 라우팅:
additionalFields맵의 값에 대한 분기. 예를 들어,additionalFields.networkType가 InNetwork인 경우 네트워크 내 할인을 적용하거나additionalFields.treatmentCategory가 예방적인 경우 예방 서비스에 대한 copay를 면제합니다.
-
다음을 포함하는 통합 JSON 응답을 생성합니다.
- insurancePolicyLimitTrackings: 제한 추적의 세부 사항.
- claimCovPaymentAdjustments: 결제 조정액의 분석입니다.
- 조정액이 모든 의무 후에 최종 지불 금액을 반영하는지 확인합니다.
요약
출력 JSON 형식이 아래와 정확한지 확인합니다.
{
"result": {
"adjustedAmount": 800,
"adjustmentReason": "Deductible, Copay, Coinsurance, OutOfPocketMax",
"insurancePolicyLimitTrackings": [
{
"insurancePolicyLimitId": "1TDxx0000004Cc7GAE",
"category": "Deductible",
"scope": "ClaimCoverage",
"calcInitialAmount": 1000,
"postedAmount": 200,
"remainingAmount": 0,
"totalUsedAmount": 500
},
{
"insurancePolicyLimitId": "1TDxx0000004Cc6GAE",
"category": "Coinsurance",
"scope": "ClaimCoverage",
"calcInitialValue": 1000,
"postedAmount": 54.60,
"totalUsedAmount": 300
},
{
"insurancePolicyLimitId": "1TDxx0000004Cc8GAE",
"category": "OutOfPocketMax",
"scope": "Policy",
"calcInitialAmount": 1000,
"postedAmount": 200,
"remainingAmount": 0,
"totalUsedAmount": 6000
}
],
"claimCovPaymentAdjustments": [
{ "adjustedAmount": 200, "adjustmentReason": "Deductible" },
{ "adjustedAmount": 20, "adjustmentReason": "Copay" },
{ "adjustedAmount": 54.60, "adjustmentReason": "Coinsurance" },
{ "adjustedAmount": 200, "adjustmentReason": "OutOfPocketMax" }
]
}
}샘플 출력에 표시된 대로 CoInsurance 추적 요소의 calcInitialAmount 대신 calcInitialValue(전체)를 입력합니다.
사용 사례: 현재 상태가 옵션인 의무
시나리오
-
요청 금액: $1,000
-
차감 가능한 나머지 항목: 200달러(현재 평점 가져오기 API에서 검색됨)
-
Coinsurance: 7%(할인 적용, 일반적으로 10%)
-
Pocket Out-of-Pocket 최대값(OOPM): 청구자는 이미 6,000달러의 한도에서 5,700달러를 사용했습니다.
계산 단계
-
중재 가능한 응용 프로그램:
- 나머지 할인 가능한 금액은 $200이 요청된 금액에 적용됩니다.
- 차감 가능 후 요청 금액: $1,000 - $200 = $800
-
Coinsurance 응용 프로그램:
- 나머지 금액에 7% 공동 보험을 적용합니다.
- 공동 보험 금액: $800 * 7% = $56
-
기본 최대값(OOPM) 고려 사항:
- OOPM에 대해 가감 가능 및 공동 보험 후 남은 금액은 $44입니다.
- 공동 보험 후 조정 금액: $800 - $56 = $744
-
최종 금액:
- 청구자가 OOPM 최대값에 도달하지 못했으므로 나머지 $744가 보장되며 지불을 위해 전송됩니다.
출력 JSON 샘플:
{
"result": {
"adjustedAmount": 744,
"adjustmentReason": "Deductible, Coinsurance",
"insurancePolicyLimitTrackings": [
{
"insurancePolicyLimitId": "1TDxx0000004Cc7GAE",
"category": "Deductible",
"scope": "ClaimCoverage",
"calcInitialAmount": 200,
"postedAmount": 1000,
"remainingAmount": 0,
"totalUsedAmount": 200
},
{
"insurancePolicyLimitId": "1TDxx0000004Cc6GAE",
"category": "Coinsurance",
"scope": "ClaimCoverage",
"calcInitialValue": 7,
"postedAmount": 1000,
"totalUsedAmount": 56
},
{
"insurancePolicyLimitId": "1TDxx0000004Cc8GAE",
"category": "OutOfPocketMax",
"scope": "Policy",
"calcInitialAmount": 300,
"postedAmount": 1000,
"remainingAmount": 44,
"totalUsedAmount": 5956
}
],
"claimCovPaymentAdjustments": [
{ "adjustedAmount": 200, "adjustmentReason": "Deductible" },
{ "adjustedAmount": 56, "adjustmentReason": "Coinsurance" }
]
}
}고려 사항
-
옵션 API: 정확성을 위해 IP 내에서 현재 상태 가져오기 API를 호출할 수 있습니다. 제한 소비에 대한 실시간 데이터가 필요한 경우 이 API를 사용합니다.
-
협회: 설정하는 동안 IP를 의무 논리가 적용될 관련 증권 적용 범위와 연결합니다.
