breadcrumbDescription
InsCensusServiceStd:addPlanSelections
Brug denne tjeneste til at oprette GroupCensusMemberPlan-registreringer for eksisterende GroupCensusMember-registreringer. Den bruger de ContractGroupPlans, der er angivet i input-JSON til at føje planer til hver GroupCensusMember. Tjenesten accepterer også valgfri dækning pr. medlem, så primære medlemmer og afhængige kan tilmelde sig forskellige dækninger under den samme plan.
Kategori: InsCensusServiceStd
Metode: addPlanSelections
Hvis planvalgene for hvert medlem uploades ved brug af CSV, skal du bruge InsCensusServiceStd:updateMembersWithPlans.
GroupCensus og Kontrakt skal have den samme gruppekonto.
Status for ContractGroupPlan skal være aktiv.
Sådan fungerer det
Tjenesten bruger censusId og contractId til at indsætte medlemmernes valgte planer.
- For hvert af sine
ContractGroupPlanid'er evaluerer tjenesten, om planen er gyldig for medlemmet baseret på følgende faktorer:contractIder gyldig forcensusId.ContractGroupPlanId er gyldigt forcontractId.IsOptOutAllPlanser falsk.Når ContractGroupPlan har registreringstypen Produkt (ContractGroupPlan er overordnet):
Produkttypen for
ContractGroupPlanfor det primære medlem må ikke svare til de produkttyper, der er anført i det primære medlemsOptOutPlanTypes.ContractGroupPlanprodukttype for en afhængig må ikke svare til de produkttyper, der er anført i den afhængigesOptOutPlanTypes, ogContractGroupPlanprodukttype må ikke svare til de produkttyper, der er anført i den afhængiges primære medlemsOptOutPlanTypes.
Når ContractGroupPlan har registreringstypen CoverageSpec (ContractGroupPlan underordnet):
Produkttypen for en underordnet
ContractGroupPlanfor det primære medlem må ikke svare til de produkttyper, der er angivet i det primære medlemsOptOutPlanTypes.Produkttypen for en underordnet børns
ContractGroupPlanmå ikke svare til de produkttyper, der er anført i den underordnedesOptOutPlanTypes, ogContractGroupPlanmå ikke svare til de produkttyper, der er anført i den underordnedes primære medlemsOptOutPlanTypes.
-
Id'erne for oprettede
GroupCensusMemberPlanreturneres for gyldige planer. -
Tjenesten henter de gyldige planer for berettigede gruppeklasser for den angivne kontrakt. Tilmelding til en rodplan og dens dækninger afhænger af, om medlemmets klasse er berettiget til planen, og om planen accepterer medlemmer, der ikke er tilknyttet nogen klasse.
Hvis tjenesten fastslår, at et folketællingsmedlem kan tilmelde sig en plan, føjes planen til
GroupCensusMemberPlan.-
En plan føjes til en
GroupCensusMemberPlan, hvis:-
Et opkrævningsmedlem knyttes til en gyldig gruppeklasse, og der findes en
ContractGroupPlanGroupClassmed gruppeklassen og planen. -
Et opkrævningsmedlem knyttes til en gyldig gruppeklasse, der findes ingen
ContractGroupPlanGroupClassregistrering for gruppeklassen, og planen findes ikke for nogen anden gruppeklasse. -
Et folketællingsmedlem er ikke tilknyttet en gyldig gruppeklasse, og der findes ingen
ContractGroupPlanGroupClassmed planen.
-
-
En plan føjes ikke til en
GroupCensusMemberPlan, hvis:-
Et opkrævningsmedlem knyttes til en gyldig gruppeklasse, der findes ingen
ContractGroupPlanGroupClassfor gruppeklassen, men planen findes for en anden gruppeklasse. -
Et optællingsmedlem er ikke tilknyttet en gyldig gruppeklasse, og der findes en
ContractGroupPlanGroupClassmed plan- og gruppeklasser.
-
-
-
Når ugyldige
contractGroupPlanIdsoverføres for engroupCensusMember(flaggenisNewMemberer sand), sletter tjenestengroupCensusMemberog opretter ikke nogen nyeGroupCensusMemberPlanforgroupCensusMember. Forvent kun dette output, når markerings-onlySaveMembersWithValidProductser indstillet sandt i JSON-objektet.
Fjernindstillinger
Indstilling |
Beskrivelse |
|---|---|
|
Påkrævet. Id for folketælling med de medlemmer, hvis planer skal indsættes. Validerer, at |
|
Påkrævet. Id for kontoens aktuelle kontrakt. Validerer, at planerne for hvert medlem er del af kontrakten. |
|
Påkrævet. JSON-input med to noder:
|
|
Valgfrit. Hvis det er sandt, slettes nye medlemmer uden poster i |
Serviceadfærd
Forstå, hvordan forskellige input påvirker serviceoutput.
| Input | Serviceoutput |
|---|---|
Ingen censusId eller ugyldig censusId |
Tjenesten tilføjer ingen medlemsplan. |
Ingen contractId eller ugyldig contractId |
Tjenesten tilføjer ingen medlemsplan. |
Ugyldig contractId for den angivne folketælling |
Tjenesten tilføjer ingen medlemsplan. |
| Ingen rækker at indsætte/opdatere | Tjenesten tilføjer ingen medlemsplan. |
Row har ingen id (GroupCensusMember.Id) |
Tjenesten tilføjer ingen medlemsplan. |
Ugyldig ContractGroupPlanId for den angivne kontrakt |
Tjenesten opretter ingen medlemsplan. Hvis
|
Ugyldig ContractGroupPlanId for medlemmet (på grund af framelding) |
Medlemsplan er ikke oprettet Hvis
|
| Det primære medlem framelder sig en produkttype |
Hvis det primære medlem framelder sig en produkttype, framelder afhængige sig også denne produkttype. |
| Afhængigt medlem framelder sig en produkttype |
Hvis det primære medlem framelder sig en produkttype, framelder afhængige sig også denne produkttype. Hvis |
Input JSON
Her er formatet på input-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
}Her er et eksempel på input-JSON:
{
"censusId":"a4D4P000000hbjSUAQ",
"contractId":"8004P000000zF2dQAE",
"census":{
"members":[
{
"ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ",
"Id":"a4C4P000000d7POUAY"
}
],
"headers":[
{
"name":"ContractGroupPlanId"
}
]
}
}Output JSON
Tjenesten returnerer listen over indsatte GroupCensusMemberPlan-id'er. Den leverer også en liste over fejl. Disse fejl er grupperet pr. medlem.
Her er formatet på output-JSON:
{
"memberPlanIds":[
"GroupCensusMemberPlan.Id"
],
"errors":[
{
"error":"error"
}
]
}Tjenesten returnerer et output-JSON, der er formateret sådan:
{
"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"
}
]
}
