Loading
보험
InsCensusServiceStd:addPlanSelections

InsCensusServiceStd:addPlanSelections

이 서비스를 사용하여 기존 GroupCensusMember 레코드에 대한 GroupCensusMemberPlan 레코드를 만듭니다. 각 GroupCensusMember에 계획을 추가하기 위해 입력 JSON에 지정된 ContractGroupPlans을 사용합니다. 또한 서비스는 기본 구성원 및 종속인이 같은 계획에 따라 다른 보장 범위에 등록할 수 있도록 구성원당 옵션 보장 범위를 허용합니다.

클래스: InsCensusServiceStd​​

방법: addPlanSelections

노트
노트

모든 구성원에 대한 계획 선택 항목이 CSV를 사용하여 업로드된 경우 InsCensusServiceStd:updateMembersWithPlans 서비스를 사용합니다.

GroupCensus 및 Contract에는 동일한 그룹 계정이 있어야 합니다.

ContractGroupPlan 상태는 활성 상태여야 합니다.

작동 방법

서비스는 censusId 및 contractId을 사용하여 구성원의 선택한 계획을 삽입합니다.

  1. 각각의 ContractGroupPlan ID에 대해 서비스는 다음 요소를 기반으로 플랜이 구성원에게 유효한지 여부를 평가합니다.
    • contractId는 censusId에 유효합니다.

    • ContractGroupPlan ID는 contractId​에 유효합니다.
    • IsOptOutAllPlans is false.

    • ContractGroupPlan에 레코드 유형이 제품(상위 항목의 ContractGroupPlan)인 경우:

      • 기본 구성원에 대한 ContractGroupPlan의 제품 유형은 기본 구성원 OptOutPlanTypes에 나열된 제품 유형과 동일하지 않아야 합니다.

      • 부양인의 ContractGroupPlan​​의 제품 유형은 부양인의 OptOutPlanTypes에 나열된 제품 유형과 같지 않으며, ContractGroupPlan의 제품 유형은 부양인의 기본 구성원 OptOutPlanTypes에 나열된 제품 유형과 같지 않아야 합니다.

    • ContractGroupPlan에 레코드 유형이 CoverageSpec(하위의 ContractGroupPlan)인 경우:

      • 기본 구성원에 대한 자녀의 ContractGroupPlan의 제품 유형은 기본 구성원 OptOutPlanTypes에 나열된 제품 유형과 동일하지 않아야 합니다.

      • 부양받은 자의 자녀의 ContractGroupPlan​​의 제품 유형은 부양받은 자의 OptOutPlanTypes에 나열된 제품 유형과 같지 않으며, ContractGroupPlan의 제품 유형은 부양받은 자의 기본 구성원의 OptOutPlanTypes에 나열된 제품 유형과 같지 않아야 합니다.

  2. 성공적으로 생성된 GroupCensusMemberPlan 항목의 ID는 유효한 계획에 대해 반환됩니다.

  3. 서비스에서 해당 계약에 적격한 그룹 클래스에 대한 유효한 계획을 검색합니다. 루트 계획 및 범위에 대한 등록은 구성원의 클래스가 계획에 적합한지 여부와 계획에서 클래스와 연결되지 않은 구성원을 허용하는지 여부에 따라 다릅니다.

    서비스에서 인구 조사 구성원이 계획에 등록할 수 있다고 판단하는 경우 해당 계획이 GroupCensusMemberPlan에 추가됩니다.

    • 다음 경우 계획이 GroupCensusMemberPlan에 추가됩니다.

      • 인구 조사 구성원이 유효한 그룹 클래스와 연결되고 그룹 클래스 및 계획과 함께 ContractGroupPlanGroupClass 레코드가 있습니다.

      • 인구 조사 구성원이 유효한 그룹 클래스와 연결되며, 그룹 클래스에 대한 레코드가 ContractGroupPlanGroupClass 존재하지 않으며 다른 그룹 클래스에 대한 계획이 존재하지 않습니다.

      • 인구 조사 구성원은 유효한 그룹 클래스와 연결되어 있지 않으며 계획에 대한 ContractGroupPlanGroupClass 레코드가 없습니다.

    • 다음과 같은 경우 계획이 GroupCensusMemberPlan에 추가되지 않습니다.

      • 인구 조사 구성원이 유효한 그룹 클래스와 연결되며, 그룹 클래스에 대한 ContractGroupPlanGroupClass 레코드가 없지만 다른 그룹 클래스에 대한 계획이 있습니다.

      • 인구 조사 구성원은 유효한 그룹 클래스와 연결되지 않으며, 계획 및 그룹 클래스에 ContractGroupPlanGroupClass 레코드가 있습니다.

  4. groupCensusMember에 대해 잘못된 contractGroupPlanIds이 전달되면(표시 isNewMember가 true) 서비스에서 groupCensusMember 레코드를 삭제하고 groupCensusMember에 대한 새 GroupCensusMemberPlan 레코드를 생성하지 않습니다. 플래그 onlySaveMembersWithValidProducts가 JSON 개체에서 true로 설정된 경우에만 이 출력을 예상합니다.

원격 옵션

옵션

설명

censusId

(필수)

계획을 삽입해야 하는 구성원이 있는 인구 조사 ID입니다.

contractId가 계정/인구 조사에 속하는지 확인합니다.

contractId

(필수)

계정의 현재 계약 ID입니다.

각 구성원의 계획이 계약의 일부인지 확인합니다.

census

(필수)

두 개의 노드가 있는 JSON 입력:

  • headers - GroupCensusMemberPlan의 필드 API 이름 목록입니다.

  • members - 삽입하거나 업데이트할 계획이 있는 구성원 목록입니다. 다음 노드를 포함해야 합니다.

    • Id — 인구 조사 구성원 ID.

    • isNewMember - 구성원이 새로 삽입된 경우 True

    • ContractGroupPlan - 구성원에 대해 선택한 계획 목록입니다. 세미콜론()으로 계약 그룹 계획 ID를 구분합니다.

onlySaveMembersWithValidProducts

(선택 사항)

true인 경우 GroupCensusMemberPlan 항목이 없는 새 구성원이 삭제됩니다. 기본값은 false입니다.

서비스 동작

다양한 입력이 서비스 출력에 미치는 영향을 이해합니다.

입력 서비스 출력
censusId 또는 유효하지 않은 censusId 없음 서비스에 구성원 플랜이 추가되지 않습니다.
contractId 또는 유효하지 않은 contractId 없음 서비스에 구성원 플랜이 추가되지 않습니다.
지정된 인구 조사에 유효하지 않은 contractId 서비스에 구성원 플랜이 추가되지 않습니다.
삽입/업데이트할 행 없음 서비스에 구성원 플랜이 추가되지 않습니다.
행에 ID가 없습니다(GroupCensusMember.Id) 서비스에 구성원 플랜이 추가되지 않습니다.
지정된 계약에 대한 유효하지 않은 ContractGroupPlanId

서비스는 구성원 플랜을 만들지 않습니다.

onlySaveMembersWithValidProducts가 true이고 구성원이 새 구성원인 경우 서비스가 다음을 수행합니다.

  • 유효한 계획이 없는 구성원을 삭제합니다.
  • 유효한 계획이 하나 이상 있는 경우 구성원을 만듭니다.
구성원에 대한 유효하지 않은 ContractGroupPlanId(수신 거부로 인한)

구성원 플랜이 생성되지 않음

onlySaveMembersWithValidProducts가 true이고 구성원이 새 구성원인 경우 서비스가 다음을 수행합니다.

  • 유효한 계획이 없는 구성원을 삭제합니다.
  • 유효한 계획이 하나 이상 있는 경우 구성원을 만듭니다.
기본 구성원이 제품 유형을 옵트아웃하는 경우

IsOptOutAllPlans 우선 순위가 지정된 OptOutPlanTypes다음,

  • IsOptOutAllPlans = true인 경우 등록할 제품을 지정해도 서비스에서 구성원 플랜을 만들지 않습니다.
  • IsOptOutAllPlans = false 및 구성원 등록을 위해 제품이 지정되어 있지만 해당 제품 유형이 수신 거부 항목과 동일한 경우 서비스에서 구성원 플랜을 만들지 않습니다.
  • IsOptOutAllPlans = false 및 수신 거부 항목과 동일한 상위 제품 유형이 있는 구성원 등록에 적용 범위가 지정된 경우 서비스에서 구성원 계획을 만들지 않습니다.

기본 구성원이 제품 유형을 옵트아웃하는 경우 종속자가 해당 제품 유형에서도 옵트아웃합니다.

종속 구성원이 제품 유형을 옵트아웃함

IsOptOutAllPlans 우선 OptOutPlanTypes순위,

  • IsOptOutAllPlans = true인 경우 등록할 제품을 지정해도 서비스에서 구성원 플랜을 만들지 않습니다.
  • IsOptOutAllPlans = false 및 구성원 등록을 위해 제품이 지정되어 있지만 제품 유형이 수신 거부 항목과 동일한 경우 서비스에서 구성원 플랜을 만들지 않습니다.
  • IsOptOutAllPlans = false 및 수신 거부 항목과 동일한 상위 제품 유형이 있는 구성원 등록에 적용 범위가 지정된 경우 서비스에서 구성원 계획을 만들지 않습니다.

기본 구성원이 제품 유형을 옵트아웃하는 경우 종속자가 해당 제품 유형에서도 옵트아웃합니다.

IsOptOutAllPlans = primary 구성원에 대해 true인 경우 연결된 종속 항목에 동일한 출력이 적용됩니다.

입력 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"
      }
   ]
}
 
로드 중
Salesforce Help | Article