위치:
InsCensusServiceStd:addPlanSelections
이 서비스를 사용하여 기존 GroupCensusMember 레코드에 대한 GroupCensusMemberPlan 레코드를 만듭니다. 각 GroupCensusMember에 계획을 추가하기 위해 입력 JSON에 지정된 ContractGroupPlans을 사용합니다. 또한 서비스는 기본 구성원 및 종속인이 같은 계획에 따라 다른 보장 범위에 등록할 수 있도록 구성원당 옵션 보장 범위를 허용합니다.
클래스: InsCensusServiceStd
방법: addPlanSelections
모든 구성원에 대한 계획 선택 항목이 CSV를 사용하여 업로드된 경우 InsCensusServiceStd:updateMembersWithPlans 서비스를 사용합니다.
GroupCensus 및 Contract에는 동일한 그룹 계정이 있어야 합니다.
ContractGroupPlan 상태는 활성 상태여야 합니다.
작동 방법
서비스는 censusId 및 contractId을 사용하여 구성원의 선택한 계획을 삽입합니다.
- 각각의
ContractGroupPlanID에 대해 서비스는 다음 요소를 기반으로 플랜이 구성원에게 유효한지 여부를 평가합니다.contractId는censusId에 유효합니다.ContractGroupPlanID는contractId에 유효합니다.IsOptOutAllPlansis false.ContractGroupPlan에 레코드 유형이 제품(상위 항목의 ContractGroupPlan)인 경우:
기본 구성원에 대한
ContractGroupPlan의 제품 유형은 기본 구성원OptOutPlanTypes에 나열된 제품 유형과 동일하지 않아야 합니다.부양인의
ContractGroupPlan의 제품 유형은 부양인의OptOutPlanTypes에 나열된 제품 유형과 같지 않으며,ContractGroupPlan의 제품 유형은 부양인의 기본 구성원OptOutPlanTypes에 나열된 제품 유형과 같지 않아야 합니다.
ContractGroupPlan에 레코드 유형이 CoverageSpec(하위의 ContractGroupPlan)인 경우:
기본 구성원에 대한 자녀의
ContractGroupPlan의 제품 유형은 기본 구성원OptOutPlanTypes에 나열된 제품 유형과 동일하지 않아야 합니다.부양받은 자의 자녀의
ContractGroupPlan의 제품 유형은 부양받은 자의OptOutPlanTypes에 나열된 제품 유형과 같지 않으며,ContractGroupPlan의 제품 유형은 부양받은 자의 기본 구성원의OptOutPlanTypes에 나열된 제품 유형과 같지 않아야 합니다.
-
성공적으로 생성된
GroupCensusMemberPlan항목의 ID는 유효한 계획에 대해 반환됩니다. -
서비스에서 해당 계약에 적격한 그룹 클래스에 대한 유효한 계획을 검색합니다. 루트 계획 및 범위에 대한 등록은 구성원의 클래스가 계획에 적합한지 여부와 계획에서 클래스와 연결되지 않은 구성원을 허용하는지 여부에 따라 다릅니다.
서비스에서 인구 조사 구성원이 계획에 등록할 수 있다고 판단하는 경우 해당 계획이
GroupCensusMemberPlan에 추가됩니다.-
다음 경우 계획이
GroupCensusMemberPlan에 추가됩니다.-
인구 조사 구성원이 유효한 그룹 클래스와 연결되고 그룹 클래스 및 계획과 함께
ContractGroupPlanGroupClass레코드가 있습니다. -
인구 조사 구성원이 유효한 그룹 클래스와 연결되며, 그룹 클래스에 대한 레코드가
ContractGroupPlanGroupClass존재하지 않으며 다른 그룹 클래스에 대한 계획이 존재하지 않습니다. -
인구 조사 구성원은 유효한 그룹 클래스와 연결되어 있지 않으며 계획에 대한
ContractGroupPlanGroupClass레코드가 없습니다.
-
-
다음과 같은 경우 계획이
GroupCensusMemberPlan에 추가되지 않습니다.-
인구 조사 구성원이 유효한 그룹 클래스와 연결되며, 그룹 클래스에 대한
ContractGroupPlanGroupClass레코드가 없지만 다른 그룹 클래스에 대한 계획이 있습니다. -
인구 조사 구성원은 유효한 그룹 클래스와 연결되지 않으며, 계획 및 그룹 클래스에
ContractGroupPlanGroupClass레코드가 있습니다.
-
-
-
groupCensusMember에 대해 잘못된contractGroupPlanIds이 전달되면(표시isNewMember가 true) 서비스에서groupCensusMember레코드를 삭제하고groupCensusMember에 대한 새GroupCensusMemberPlan레코드를 생성하지 않습니다. 플래그onlySaveMembersWithValidProducts가 JSON 개체에서 true로 설정된 경우에만 이 출력을 예상합니다.
원격 옵션
옵션 |
설명 |
|---|---|
|
(필수) 계획을 삽입해야 하는 구성원이 있는 인구 조사 ID입니다.
|
|
(필수) 계정의 현재 계약 ID입니다. 각 구성원의 계획이 계약의 일부인지 확인합니다. |
|
(필수) 두 개의 노드가 있는 JSON 입력:
|
|
(선택 사항) true인 경우 |
서비스 동작
다양한 입력이 서비스 출력에 미치는 영향을 이해합니다.
| 입력 | 서비스 출력 |
|---|---|
censusId 또는 유효하지 않은 censusId 없음 |
서비스에 구성원 플랜이 추가되지 않습니다. |
contractId 또는 유효하지 않은 contractId 없음 |
서비스에 구성원 플랜이 추가되지 않습니다. |
지정된 인구 조사에 유효하지 않은 contractId |
서비스에 구성원 플랜이 추가되지 않습니다. |
| 삽입/업데이트할 행 없음 | 서비스에 구성원 플랜이 추가되지 않습니다. |
행에 ID가 없습니다(GroupCensusMember.Id) |
서비스에 구성원 플랜이 추가되지 않습니다. |
지정된 계약에 대한 유효하지 않은 ContractGroupPlanId |
서비스는 구성원 플랜을 만들지 않습니다.
|
구성원에 대한 유효하지 않은 ContractGroupPlanId(수신 거부로 인한) |
구성원 플랜이 생성되지 않음
|
| 기본 구성원이 제품 유형을 옵트아웃하는 경우 |
기본 구성원이 제품 유형을 옵트아웃하는 경우 종속자가 해당 제품 유형에서도 옵트아웃합니다. |
| 종속 구성원이 제품 유형을 옵트아웃함 |
기본 구성원이 제품 유형을 옵트아웃하는 경우 종속자가 해당 제품 유형에서도 옵트아웃합니다.
|
입력 JSON
다음은 입력 JSON 형식입니다.
{
"censusId":"ID",
"contractId":"ID",
"census":{
"headers":[
{
"name":"GroupCensusMemberPlan.fieldAPI1"
},
{
"name":"GroupCensusMemberPlan.fieldAPI2"
}
],
"members":[
{
"Id":"Census Member ID",
"isNewMember":true,
"GroupCensusMemberPlan.fieldAPI1":"value1",
"GroupCensusMemberPlan.fieldAPI2":"value2",
"ContractGroupPlanId": "ContractGroupPlan.Id;ChildContractGroupPlan.Id"
},
{
"Id":"Census Member ID",
"isNewMember":true,
"GroupCensusMemberPlan.fieldAPI1":"value1",
"GroupCensusMemberPlan.fieldAPI2":"value2",
"ContractGroupPlanId": "ContractGroupPlan.Id;ChildContractGroupPlan.Id"
}
]
},
"onlySaveMembersWithValidProducts" : true
}다음은 입력 JSON의 예입니다.
{
"censusId":"a4D4P000000hbjSUAQ",
"contractId":"8004P000000zF2dQAE",
"census":{
"members":[
{
"ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ",
"Id":"a4C4P000000d7POUAY"
}
],
"headers":[
{
"name":"ContractGroupPlanId"
}
]
}
}출력 JSON
서비스는 성공적으로 삽입한 GroupCensusMemberPlan ID 목록을 반환합니다. 또한 발생한 오류 목록도 제공합니다. 다음 오류는 구성원별로 그룹화됩니다.
다음은 출력 JSON 형식입니다.
{
"memberPlanIds":[
"GroupCensusMemberPlan.Id"
],
"errors":[
{
"error":"error"
}
]
}서비스가 다음과 같이 서식이 지정된 출력 JSON을 반환합니다.
{
"memberPlanIds":[
"a4B4P000006jKsMUAU",
"a4B4P000006jKsNUAU",
"a4B4P000006jKsOUAU",
"a4B4P000006jKsPUAU"
],
"errors":[
{
"numPlansError":2,
"error":"ContractGroupPlan value is not valid:8004P000000zJKjQAM; Medical",
"numPlans":2,
"Id":"a4C4P000000ed6dUAA",
"isNewMember":true,
"ContractGroupPlan":"8004P000000zJKjQAM;Medical"
}
]
}
