InsCensusServiceStd:addPlanSelections

Miten se toimii?

Palvelu käyttää jäsenien valitsemien suunnitelmien lisäämiseen censusId ja contractId.

1. Palvelu arvioi jokaisen ContractGroupPlan-tunnuksensa osalta, onko suunnitelma voimassa jäsenelle seuraavien tekijöiden perusteella:

   • contractId on voimassa censusId:lle.

   • ContractGroupPlan Id on voimassa contractId​.

   • IsOptOutAllPlans on false.

   • Kun ContractGroupPlan-tietuetyyppi on Product (ylätason ContractGroupPlan):

     • Ensisijaisen jäsenen ContractGroupPlan-tyypin ei tarvitse vastata ensisijaisen jäsenen OptOutPlanTypes-osiossa mainittuja tuotetyyppejä.

     • Riippumattoman henkilön ContractGroupPlan​​-tuotetyyppi ei saa vastata riippumattoman henkilön OptOutPlanTypes-luettelossa olevia tuotetyyppejä eikä ContractGroupPlan-tuotetyyppi saa vastata riippumattoman henkilön ensisijaisen jäsenen OptOutPlanTypes-luettelossa olevia tuotetyyppejä.

   • Kun ContractGroupPlan-tietuetyyppi on CoverageSpec (ContractGroupPlan alitason):

     • Alitason jäsenen ContractGroupPlan-arvon tuotetyypin ei tarvitse vastata ensisijaisen jäsenen OptOutPlanTypes-kentässä määritettyjä tuotetyyppejä.

     • Lapselle alitason ContractGroupPlan​​-arvon tuotetyyppi ei saa vastata hänen OptOutPlanTypes-arvoonsa sisältyviä tuotetyyppejä eikä ContractGroupPlan-arvon tuotetyyppi saa vastata hänen ensisijaisen jäsenensä OptOutPlanTypes-arvoon sisältyviä tuotetyyppejä.

2. Onnistuneesti luotujen GroupCensusMemberPlan-merkintöjen tunnukset palautetaan kelvollisille suunnitelmille.

3. Palvelu noutaa sopimukselle kelvolliset suunnitelmat sopiville ryhmäluokille. Juuritason suunnitelmaan ja sen kattavuuksiin rekisteröinti riippuu siitä, onko jäsenen luokka oikeutettu suunnitelmaan ja hyväksyykö suunnitelma jäseniä, jotka eivät liity mihinkään luokkaan.

   Jos palvelu määrittää, että kyselyn jäsen voi rekisteröityä suunnitelmaan, suunnitelma lisätään GroupCensusMemberPlan.

   • Suunnitelma lisätään GroupCensusMemberPlan, jos:

     • Kyselyn jäsen on liitetty kelvolliseen ryhmäluokkaan ja ryhmäluokkaan ja suunnitelmaan on liitetty ContractGroupPlanGroupClass-tietue.

     • Kertakirjautumisen jäsen liittyy kelvolliseen ryhmäluokkaan, ryhmäluokalle ei ContractGroupPlanGroupClass ole tietuetta eikä suunnitelmaa ole olemassa muille ryhmäluokille.

     • Kyselyn jäsen ei liity kelvolliseen ryhmäluokkaan eikä suunnitelmaan ole olemassa mitään ContractGroupPlanGroupClass-tietuetta.

   • Suunnitelmaa ei lisätä GroupCensusMemberPlan, jos:

     • Kyselyn jäsen on liitetty kelvolliseen ryhmäluokkaan, ryhmäluokalle ei ole olemassa ContractGroupPlanGroupClass-tietuetta, mutta suunnitelma on olemassa toiselle ryhmäluokalle.

     • Henkilöstön jäsentä ei liitetä kelvolliseen ryhmäluokkaan ja suunnitelma- ja ryhmäluokkiin on liitetty ContractGroupPlanGroupClass -tietue.

4. Kun virheelliset contractGroupPlanIds välitetään groupCensusMember:lle (lipun isNewMember on true), palvelu poistaa groupCensusMember-tietueet eikä luo uusia GroupCensusMemberPlan-tietueita groupCensusMember:lle. Odotat tämän tuloksen vain, kun merkinnän onlySaveMembersWithValidProducts on määritetty true JSON-objektissa.

Etäasetukset

Palvelun toimintatapa

Katso miten eri syötteet vaikuttavat palvelun tuloksiin.

Syötetty JSON

Alla on syötetyn JSON-tiedoston muoto:

{ 
   "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
}

Alla on esimerkki syötetystä JSON-tiedostosta:

{ 
   "censusId":"a4D4P000000hbjSUAQ",
   "contractId":"8004P000000zF2dQAE",
   "census":{ 
      "members":[ 
         { 
            "ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ",
            "Id":"a4C4P000000d7POUAY"
         }
      ],
      "headers":[ 
         { 
            "name":"ContractGroupPlanId"
         }
      ]
   }
}

Tulos-JSON

Palvelu palauttaa luettelon onnistuneesti lisätyistä GroupCensusMemberPlan-tunnuksista. Se tarjoaa myös havaittujen virheiden luettelon. Nämä virheet on ryhmitetty jäsenkohtaisesti.

Alla on tuloksen JSON-tiedoston muoto:

{ 
   "memberPlanIds":[ 
      "GroupCensusMemberPlan.Id"
   ],
   "errors":[ 
      { 
         "error":"error"
      }
   ]
}

Palvelu palauttaa tuloksen JSON-tiedoston muodossa näin:

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