Du är här:
InsCensusServiceStd:addPlanSelections
Använd denna tjänst för att skapa GroupCensusMemberPlan för befintliga GroupCensusMember. Den använder den ContractGroupPlans som specificeras i JSON för indata för att lägga till planer till varje GroupCensusMember. Tjänsten accepterar även valfria täckningar per medlem så att primära medlemmar och beroende kan registreras i olika täckningar under samma plan.
Klass: InsCensusServiceStd
Metod: addPlanSelections
Om planvalen för varje medlem laddas upp med CSV, använd InsCensusServiceStd:updateMembersWithPlans.
GroupCensus och Contract måste ha samma gruppkonto.
Statusen ContractGroupPlan måste vara aktiv.
Så här fungerar det
Tjänsten använder censusId och contractId för att infoga medlemmars valda planer.
- För vart och ett av sina
ContractGroupPlanutvärderar tjänsten om planen är giltig för medlemmen baserat på dessa faktorer:contractIdär giltig förcensusId.ContractGroupPlanID är giltigt förcontractId.IsOptOutAllPlansär falskt.När ContractGroupPlan har posttypen Produkt (ContractGroupPlan för överordnad):
Produkttypen för
ContractGroupPlanför den primära medlemmen får inte vara lika med produkttyperna som listas i den primära medlemmensOptOutPlanTypes.ContractGroupPlanprodukttyp för en beroende får inte vara lika med de produkttyper som anges i den beroendesOptOutPlanTypesochContractGroupPlanprodukttyp får inte vara lika med de produkttyper som anges iOptOutPlanTypesför den beroendes primära medlem.
När ContractGroupPlan har posttypen CoverageSpec (ContractGroupPlan för underordnad):
Produkttypen för ett underordnat företags
ContractGroupPlanför den primära medlemmen får inte vara lika med produkttyperna som anges i den primära medlemmensOptOutPlanTypes.Produkttypen för ett underordnat barns
ContractGroupPlanför en beroende får inte vara lika med de produkttyper som anges i den beroendesOptOutPlanTypesoch produkttypen förContractGroupPlanfår inte vara lika med de produkttyper som anges iOptOutPlanTypesför den beroendes primära medlem.
-
ID för framgångsrikt skapade
GroupCensusMemberPlanreturneras för giltiga planer. -
Tjänsten hämtar de giltiga planerna för kvalificerade gruppklasser för det givna kontraktet. Registrering i en rotplan och dess täckningar beror på om medlemmens klass är berättigad till planen och om planen accepterar medlemmar som inte är associerade med någon klass.
Om tjänsten avgör att en folkräkningsmedlem kan registrera sig för en plan läggs planen till i
GroupCensusMemberPlan.-
En plan läggs till i en
GroupCensusMemberPlanom:-
En folkräkningsmedlem är associerad med en giltig gruppklass och en
ContractGroupPlanGroupClassfinns med gruppklassen och planen. -
En folkräkningsmedlem är associerad med en giltig gruppklass, ingen
ContractGroupPlanGroupClasspost finns för gruppklassen och planen finns inte för någon annan gruppklass. -
En folkräkningsmedlem är inte associerad med en giltig gruppklass och det finns ingen
ContractGroupPlanGroupClassmed planen.
-
-
En plan läggs inte till i en
GroupCensusMemberPlanom:-
En folkräkningsmedlem är associerad med en giltig gruppklass, ingen
ContractGroupPlanGroupClassfinns för gruppklassen, men planen finns för en annan gruppklass. -
En folkräkningsmedlem är inte associerad med en giltig gruppklass och en
ContractGroupPlanGroupClassfinns med plan- och gruppklasserna.
-
-
-
Om ogiltiga
contractGroupPlanIdsskickas för engroupCensusMember(flagg-isNewMemberär sant) tar tjänsten bortgroupCensusMemberoch skapar inga nyaGroupCensusMemberPlanförgroupCensusMember. Förvänta dig endast denna utdata när flagg-onlySaveMembersWithValidProductsär inställd till sant i JSON-objektet.
Fjärralternativ
Alternativ |
Beskrivning |
|---|---|
|
Obligatoriskt. ID för folkräkning med de medlemmar vars planer måste infogas. Kontrollerar att |
|
Obligatoriskt. ID för kontots aktuella kontrakt. Kontrollerar att planerna för varje medlem är en del av kontraktet. |
|
Obligatoriskt. JSON-indata med två noder:
|
|
Valfritt. Om sant tas nya medlemmar utan poster i |
Servicebeteende
Förstå hur olika inmatningar påverkar serviceresultaten.
| Indata | Serviceresultat |
|---|---|
Inga censusId eller ogiltiga censusId |
Tjänsten lägger inte till någon medlemsplan. |
Inga contractId eller ogiltiga contractId |
Tjänsten lägger inte till någon medlemsplan. |
Ogiltig contractId för den specificerade folkräkningen |
Tjänsten lägger inte till någon medlemsplan. |
| Inga rader att infoga/uppdatera | Tjänsten lägger inte till någon medlemsplan. |
Raden har inget ID (GroupCensusMember.Id) |
Tjänsten lägger inte till någon medlemsplan. |
Ogiltig ContractGroupPlanId för det specificerade kontraktet |
Tjänsten skapar ingen medlemsplan. Om
|
Ogiltig ContractGroupPlanId för medlemmen (på grund av avböjande) |
Medlemsplan skapas inte Om
|
| Den primära medlemmen avböjer en produkttyp |
Om den primära medlemmen avböjer en produkttyp avböjer de beroende också den produkttypen. |
| Beroende medlem avböjer en produkttyp |
Om den primära medlemmen avböjer en produkttyp avböjer de beroende också den produkttypen. Om |
Indata-JSON
Här är formatet för indata-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
}Här är ett exempel på indata-JSON:
{
"censusId":"a4D4P000000hbjSUAQ",
"contractId":"8004P000000zF2dQAE",
"census":{
"members":[
{
"ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ",
"Id":"a4C4P000000d7POUAY"
}
],
"headers":[
{
"name":"ContractGroupPlanId"
}
]
}
}JSON för utdata
Tjänsten returnerar listan över GroupCensusMemberPlan som infogats. Den innehåller även en lista över fel som uppstått. Dessa fel grupperas per medlem.
Här är formatet för JSON för utdata:
{
"memberPlanIds":[
"GroupCensusMemberPlan.Id"
],
"errors":[
{
"error":"error"
}
]
}Tjänsten returnerar en JSON för utdata, formaterad så här:
{
"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"
}
]
}
