InsCensusServiceStd:addPlanSelections

操作手順

このサービスでは、censusIdとcontractIdを使用して、メンバーが選択したプランを挿入します。

1. 各ContractGroupPlan ID で、サービスは、次の要素に基づいてプランがメンバーに対して有効かどうかを評価します。

   • contractIdはcensusIdで有効です。

   • ​​ContractGroupPlan​​ ID は contractId​ で有効です。

   • IsOptOutAllPlans は false です。

   • ContractGroupPlan のレコードタイプが Product (親の ContractGroupPlan) の場合:

     • プライマリメンバーの商品種別は、プライマリメンバーの [OptOutPlanTypesContractGroupPlan] にリストされている商品種別と同じにすることはできません。

     • 被扶養者のContractGroupPlan​​の商品種別は、その扶養者のOptOutPlanTypes「ContractGroupPlan」にリストされている商品種別と等しくなく、また、その商品種別は、その扶養者の主メンバーの「OptOutPlanTypes」にリストされている商品種別と等しくない必要があります。

   • ContractGroupPlan のレコードタイプが CoverageSpec (子の ContractGroupPlan) の場合:

     • プライマリメンバーの子の商品種別は、プライマリメンバーの [OptOutPlanTypes] にリストされている商品種別と等しくないContractGroupPlan必要があります。

     • 扶養家族の子のContractGroupPlan​​の商品種別は、その扶養家族のOptOutPlanTypes「」にリストされている商品種別と等しくなく、また、その「ContractGroupPlan」の商品種別は、扶養家族の主メンバーの「OptOutPlanTypes」にリストされている商品種別と等しくない必要があります。

2. 有効なプランでは、正常に作成されたGroupCensusMemberPlanエントリの ID が返されます。

3. このサービスは、特定の契約の対象グループクラスの有効なプランを取得します。ルートプランとその対象範囲への登録は、メンバーのクラスがプランの対象であるかどうか、およびどのクラスにも関連付けられていないメンバーもプランで受け入れるかどうかによって異なります。

   国勢調査メンバーが計画に登録できるとサービスが判断した場合、計画はGroupCensusMemberPlanに追加されます。

   • 計画がGroupCensusMemberPlanに追加されるのは、次の場合です。

     • 国勢調査メンバーは有効なグループクラスに関連付けられており、ContractGroupPlanGroupClassレコードはグループクラスとプランと共に存在します。

     • 国勢調査メンバーが有効なグループクラスに関連付けられており、グループクラスのレコードが存在しない ContractGroupPlanGroupClass。また、他のグループクラスの計画が存在しない。

     • 国勢調査メンバーが有効なグループクラスに関連付けられておらず、計画にContractGroupPlanGroupClassレコードが存在しない。

   • 次の場合、計画はGroupCensusMemberPlanに追加されません。

     • 国勢調査メンバーが有効なグループクラスに関連付けられており、グループクラスのContractGroupPlanGroupClassレコードが存在しないが、別のグループクラスの計画が存在する。

     • 国勢調査メンバーが有効なグループクラスに関連付けられておらず、ContractGroupPlanGroupClass レコードがプランおよびグループクラスと共に存在する。

4. groupCensusMemberで無効なcontractGroupPlanIdsが渡されると (フラグisNewMemberが true)、サービスはgroupCensusMemberレコードを削除し、groupCensusMemberの新しいGroupCensusMemberPlanレコードを作成しません。この出力は、JSON オブジェクトで flag onlySaveMembersWithValidProductsが true に設定されている場合にのみ期待されます。

リモートオプション

サービス動作

さまざまな入力がサービス出力にどのように影響するかを理解します。

Input 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"
      }
   ]
}