InsCensusServiceStd:addPlanSelections

Funzionamento

Il servizio utilizza censusId e contractId per inserire i piani selezionati dei membri.

1. Per ciascuno dei suoi ID ContractGroupPlan, il servizio valuta se il piano è valido per il membro in base ai seguenti fattori:

   • Il contractId è valido per l'censusId.

   • L'ID ContractGroupPlan è valido per l'contractId​.

   • IsOptOutAllPlans è falso.

   • Quando ContractGroupPlan ha tipo di record Prodotto (ContractGroupPlan della controllante):

     • Il tipo di prodotto del ContractGroupPlan per il membro principale non deve essere uguale ai tipi di prodotto elencati nel OptOutPlanTypes del membro principale.

     • Il tipo di prodotto del ContractGroupPlan​​ per un dipendente non deve essere uguale ai tipi di prodotto elencati nel OptOutPlanTypes del dipendente e il tipo di prodotto del ContractGroupPlan non deve essere uguale ai tipi di prodotto elencati nel OptOutPlanTypes del membro principale del dipendente.

   • Quando ContractGroupPlan ha il tipo di record CoverageSpec (ContractGroupPlan of child):

     • Il tipo di prodotto del ContractGroupPlan di un membro secondario per il membro principale non deve essere uguale ai tipi di prodotto elencati nel OptOutPlanTypes del membro principale.

     • Il tipo di prodotto del ContractGroupPlan​​ di un figlio per un dipendente non deve essere uguale ai tipi di prodotto elencati nel OptOutPlanTypes del dipendente e il tipo di prodotto del ContractGroupPlan non deve essere uguale ai tipi di prodotto elencati nel OptOutPlanTypes del membro principale del dipendente.

2. Per i piani validi vengono restituiti gli ID delle voci GroupCensusMemberPlan create correttamente.

3. Il servizio recupera i piani validi per le classi di gruppo idonee per il contratto specificato. L'iscrizione a un piano di base e alle relative coperture dipende dal fatto che la classe del membro sia idonea al piano e che il piano accetti membri non associati a nessuna classe.

   Se il servizio stabilisce che un membro del censimento può iscriversi a un piano, il piano viene aggiunto al GroupCensusMemberPlan.

   • Un piano viene aggiunto a un GroupCensusMemberPlan se:

     • Un membro del censimento è associato a una classe di gruppo valida ed esiste un record ContractGroupPlanGroupClass con la classe di gruppo e il piano.

     • Un membro del censimento è associato a una classe di gruppo valida, non ContractGroupPlanGroupClass esiste un record per la classe di gruppo e il piano non esiste per nessun'altra classe di gruppo.

     • Un membro del censimento non è associato a una classe di gruppo valida e non esiste alcun record ContractGroupPlanGroupClass con il piano.

   • Un piano non viene aggiunto a un GroupCensusMemberPlan se:

     • Un membro del censimento è associato a una classe di gruppo valida, non esiste un record ContractGroupPlanGroupClass per la classe di gruppo, ma il piano esiste per un'altra classe di gruppo.

     • Un membro del censimento non è associato a una classe di gruppo valida ed esiste un record ContractGroupPlanGroupClass con il piano e le classi di gruppo.

4. Quando vengono passati contractGroupPlanIds non validi per un groupCensusMember (il flag isNewMember è true), il servizio elimina i record groupCensusMember e non crea nuovi record GroupCensusMemberPlan per il groupCensusMember. Questo output è previsto solo quando il flag onlySaveMembersWithValidProducts è impostato true nell'oggetto JSON.

Opzioni remote

Comportamento del servizio

Di seguito viene descritto in che modo i diversi input influiscono sugli output del servizio.

Input JSON

Di seguito è riportato il formato del JSON di input:

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

Di seguito è riportato un esempio di JSON di input:

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

JSON di output

Il servizio restituisce l'elenco degli ID GroupCensusMemberPlan inseriti correttamente. Fornisce anche l'elenco degli errori riscontrati. Questi errori sono raggruppati per membro.

Di seguito è riportato il formato del JSON di output:

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

Il servizio restituisce un JSON di output, formattato come segue:

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