Sie befinden sich hier:
InsCensusServiceStd:addPlanSelections
Verwenden Sie diesen Service, um GroupCensusMemberPlan für vorhandene GroupCensusMember zu erstellen. Sie verwendet die in der Eingabe-JSON angegebene ContractGroupPlans, um Pläne zu jedem GroupCensusMember hinzuzufügen. Der Service akzeptiert auch optionale Abdeckungen pro Mitglied, sodass primäre Mitglieder und abhängige Personen für unterschiedliche Abdeckungen unter demselben Plan registriert werden können.
Klasse: InsCensusServiceStd
Methode: addPlanSelections
Wenn die Planauswahlen für jedes Mitglied mithilfe von CSV hochgeladen werden, verwenden Sie den InsCensusServiceStd:updateMembersWithPlans-Service.
GroupCensus und Contract müssen über denselben Gruppenaccount verfügen.
Der Status "ContractGroupPlan" muss aktiv sein.
Funktionsweise
Der Service verwendet censusId und contractId, um die ausgewählten Pläne der Mitglieder einzufügen.
- Für jede seiner
ContractGroupPlanwertet der Service anhand der folgenden Faktoren aus, ob der Plan für das Mitglied gültig ist:Die
contractIdist für diecensusIdgültig.- Die
ContractGroupPlan-ID ist für diecontractIdgültig. IsOptOutAllPlansist false.Wenn "ContractGroupPlan" den Datensatztyp "Produkt" aufweist (ContractGroupPlan des übergeordneten Elements):
Der Produkttyp des
ContractGroupPlanfür das primäre Mitglied darf nicht mit den Produkttypen übereinstimmen, die in derOptOutPlanTypesdes primären Mitglieds aufgeführt sind.Der Produkttyp des
ContractGroupPlanfür einen abhängigen Mitarbeiter darf nicht gleich den in derOptOutPlanTypesdes abhängigen Mitarbeiters aufgeführten Produkttypen sein und der Produkttyp desContractGroupPlandarf nicht gleich den in derOptOutPlanTypesdes primären Mitglieds des abhängigen Mitarbeiters aufgeführten Produkttypen sein.
Wenn "ContractGroupPlan" den Datensatztyp "CoverageSpec" (ContractGroupPlan des untergeordneten Elements) aufweist:
Der Produkttyp der
ContractGroupPlaneines untergeordneten Mitglieds für das primäre Mitglied darf nicht mit den Produkttypen übereinstimmen, die in derOptOutPlanTypesdes primären Mitglieds aufgeführt sind.Der Produkttyp der
ContractGroupPlaneines untergeordneten Elements für einen abhängigen Mitarbeiter darf nicht gleich den in derOptOutPlanTypesdes abhängigen Elements aufgeführten Produkttypen sein und der Produkttyp desContractGroupPlandarf nicht gleich den in derOptOutPlanTypesdes primären Elements des abhängigen Elements aufgeführten Produkttypen sein.
-
Die IDs erfolgreich erstellter
GroupCensusMemberPlanwerden für gültige Pläne zurückgegeben. -
Der Service ruft die gültigen Pläne für berechtigte Gruppenklassen für den angegebenen Vertrag ab. Die Registrierung bei einem Stammplan und seine Abdeckungen hängen davon ab, ob die Klasse des Mitglieds für den Plan berechtigt ist und ob der Plan Mitglieder akzeptiert, die keiner Klasse zugeordnet sind.
Wenn der Service feststellt, dass sich ein Volkszählungsmitglied bei einem Plan registrieren kann, wird der Plan dem
GroupCensusMemberPlanhinzugefügt.-
In folgenden Fällen wird einem
GroupCensusMemberPlanein Plan hinzugefügt:-
Ein Zählungsmitglied ist einer gültigen Gruppenklasse zugeordnet und es ist ein
ContractGroupPlanGroupClassmit der Gruppenklasse und dem Plan vorhanden. -
Ein Zählungsmitglied ist einer gültigen Gruppenklasse zugeordnet, für die Gruppenklasse ist kein
ContractGroupPlanGroupClassDatensatz vorhanden und für keine andere Gruppenklasse ist der Plan vorhanden. -
Ein Volkszählungsmitglied ist keiner gültigen Gruppenklasse zugeordnet und es ist kein
ContractGroupPlanGroupClassmit dem Plan vorhanden.
-
-
In folgenden Fällen wird einem
GroupCensusMemberPlankein Plan hinzugefügt:-
Ein Zählungsmitglied ist einer gültigen Gruppenklasse zugeordnet. Für die Gruppenklasse ist kein
ContractGroupPlanGroupClassvorhanden, der Plan für eine andere Gruppenklasse ist jedoch vorhanden. -
Ein Volkszählungsmitglied ist keiner gültigen Gruppenklasse zugeordnet und es ist ein
ContractGroupPlanGroupClassmit den Plan- und Gruppenklassen vorhanden.
-
-
-
Wenn ungültige
contractGroupPlanIdsfür einengroupCensusMemberübergeben werden (derisNewMemberder Kennzeichnung ist wahr), löscht der Service diegroupCensusMemberund erstellt keine neuenGroupCensusMemberPlanfür dengroupCensusMember. Erwarten Sie diese Ausgabe nur, wenn die KennzeichnungonlySaveMembersWithValidProductsim JSON-Objekt auf true festgelegt ist.
Remote-Optionen
Option |
Beschreibung |
|---|---|
|
Pflichtangabe. ID der Zählung mit den Mitgliedern, deren Pläne eingefügt werden müssen. Stellt sicher, dass die |
|
Pflichtangabe. ID des aktuellen Vertrags des Accounts. Stellt sicher, dass die Pläne für jedes Mitglied Teil des Vertrags sind. |
|
Pflichtangabe. JSON-Eingabe mit zwei Knoten:
|
|
Optional. Bei true werden neue Mitglieder ohne Einträge in |
Serviceverhalten
Erfahren Sie, wie sich unterschiedliche Eingaben auf die Serviceausgaben auswirken.
| Eingabe | Serviceausgabe |
|---|---|
Keine censusId oder ungültige censusId |
Der Service fügt keinen Mitgliedsplan hinzu. |
Keine contractId oder ungültige contractId |
Der Service fügt keinen Mitgliedsplan hinzu. |
Ungültige contractId für die angegebene Zählung |
Der Service fügt keinen Mitgliedsplan hinzu. |
| Keine Zeilen zum Einfügen/Aktualisieren | Der Service fügt keinen Mitgliedsplan hinzu. |
Zeile hat keine ID (GroupCensusMember.Id) |
Der Service fügt keinen Mitgliedsplan hinzu. |
Ungültige ContractGroupPlanId für den angegebenen Vertrag |
Der Service erstellt keinen Mitgliedsplan. Wenn
|
Ungültige ContractGroupPlanId für das Mitglied (wegen Abmeldung) |
Mitgliedsplan wird nicht erstellt Wenn
|
| Das primäre Mitglied meldet sich von einem Produkttyp ab |
Wenn sich das primäre Mitglied von einem Produkttyp abmeldet, werden die abhängigen Mitglieder auch von diesem Produkttyp abgemeldet. |
| Abhängiges Mitglied meldet sich von einem Produkttyp ab |
Wenn sich das primäre Mitglied von einem Produkttyp abmeldet, werden die abhängigen Mitglieder auch von diesem Produkttyp abgemeldet. Wenn |
Input JSON
Folgendes Format der Eingabe-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
}Hier ein Beispiel für die Eingabe-JSON:
{
"censusId":"a4D4P000000hbjSUAQ",
"contractId":"8004P000000zF2dQAE",
"census":{
"members":[
{
"ContractGroupPlanId":"a4D4P000000hbjSUAQ;a4D4P000000hbjSUAQ",
"Id":"a4C4P000000d7POUAY"
}
],
"headers":[
{
"name":"ContractGroupPlanId"
}
]
}
}Ausgabe-JSON
Der Service gibt die Liste der erfolgreich eingefügten GroupCensusMemberPlan-IDs zurück. Sie enthält auch die Liste der aufgetretenen Fehler. Diese Fehler werden nach Mitglied gruppiert.
Das Format der Ausgabe-JSON lautet wie folgt:
{
"memberPlanIds":[
"GroupCensusMemberPlan.Id"
],
"errors":[
{
"error":"error"
}
]
}Der Service gibt eine Ausgabe-JSON zurück, die wie folgt formatiert ist:
{
"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"
}
]
}

