Loading
Forsikring
InsCensusServiceStd:addPlanSelections

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

Bemærk
Bemærk

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.

  1. For hvert af sine ContractGroupPlan id'er evaluerer tjenesten, om planen er gyldig for medlemmet baseret på følgende faktorer:
    • contractId er gyldig for censusId.

    • ContractGroupPlan Id er gyldigt for contractId​.
    • IsOptOutAllPlans er falsk.

    • Når ContractGroupPlan har registreringstypen Produkt (ContractGroupPlan er overordnet):

      • Produkttypen for ContractGroupPlan for det primære medlem må ikke svare til de produkttyper, der er anført i det primære medlems OptOutPlanTypes .

      • ContractGroupPlan​​ produkttype for en afhængig må ikke svare til de produkttyper, der er anført i den afhængiges OptOutPlanTypes, og ContractGroupPlan produkttype må ikke svare til de produkttyper, der er anført i den afhængiges primære medlems OptOutPlanTypes.

    • Når ContractGroupPlan har registreringstypen CoverageSpec (ContractGroupPlan underordnet):

      • Produkttypen for en underordnet ContractGroupPlan for det primære medlem må ikke svare til de produkttyper, der er angivet i det primære medlems OptOutPlanTypes .

      • Produkttypen for en underordnet børns ContractGroupPlan​​ må ikke svare til de produkttyper, der er anført i den underordnedes OptOutPlanTypes, og ContractGroupPlan må ikke svare til de produkttyper, der er anført i den underordnedes primære medlems OptOutPlanTypes.

  2. Id'erne for oprettede GroupCensusMemberPlan returneres for gyldige planer.

  3. 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 ContractGroupPlanGroupClass med gruppeklassen og planen.

      • Et opkrævningsmedlem knyttes til en gyldig gruppeklasse, der findes ingen ContractGroupPlanGroupClass registrering for gruppeklassen, og planen findes ikke for nogen anden gruppeklasse.

      • Et folketællingsmedlem er ikke tilknyttet en gyldig gruppeklasse, og der findes ingen ContractGroupPlanGroupClass med planen.

    • En plan føjes ikke til en GroupCensusMemberPlan, hvis:

      • Et opkrævningsmedlem knyttes til en gyldig gruppeklasse, der findes ingen ContractGroupPlanGroupClass for gruppeklassen, men planen findes for en anden gruppeklasse.

      • Et optællingsmedlem er ikke tilknyttet en gyldig gruppeklasse, og der findes en ContractGroupPlanGroupClass med plan- og gruppeklasser.

  4. Når ugyldige contractGroupPlanIds overføres for en groupCensusMember (flaggen isNewMember er sand), sletter tjenesten groupCensusMember og opretter ikke nogen nye GroupCensusMemberPlan for groupCensusMember. Forvent kun dette output, når markerings-onlySaveMembersWithValidProducts er indstillet sandt i JSON-objektet.

Fjernindstillinger

Indstilling

Beskrivelse

censusId

Påkrævet.

Id for folketælling med de medlemmer, hvis planer skal indsættes.

Validerer, at contractId tilhører kontoen/optællingen.

contractId

Påkrævet.

Id for kontoens aktuelle kontrakt.

Validerer, at planerne for hvert medlem er del af kontrakten.

census

Påkrævet.

JSON-input med to noder:

  • headers – Liste over API-feltnavne på GroupCensusMemberPlan.

  • medlemmer – Liste over medlemmer med planer om at blive indsat eller opdateret. Den skal indeholde følgende noder:

    • Id – Id for optællingsmedlem.

    • isNewMember - Sandt, hvis medlemmet netop er indsat

    • ContractGroupPlan - Listen over valgte planer for medlemmet. Afgrænse kontraktgruppens plan-id'er med et semikolon (;).

onlySaveMembersWithValidProducts

Valgfrit.

Hvis det er sandt, slettes nye medlemmer uden poster i GroupCensusMemberPlan. Standardværdien er false.

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 onlySaveMembersWithValidProducts er sandt, og medlemmet er nyt, gør tjenesten følgende:

  • Sletter medlemmet uden nogen gyldige planer.
  • Opretter et medlem, hvis det har mindst en gyldig plan.
Ugyldig ContractGroupPlanId for medlemmet (på grund af framelding)

Medlemsplan er ikke oprettet

Hvis onlySaveMembersWithValidProducts er sandt, og medlemmet er nyt, gør tjenesten følgende:

  • Sletter medlemmet uden nogen gyldige planer.
  • Opretter et medlem, hvis det har mindst en gyldig plan.
Det primære medlem framelder sig en produkttype

IsOptOutAllPlans har forrang, efterfulgt af OptOutPlanTypes.

  • Hvis IsOptOutAllPlans = true, opretter tjenesten ikke en medlemsplan, selvom du angiver et produkt til tilmelding.
  • Hvis IsOptOutAllPlans = false og et produkt er angivet til medlemstilmelding, men dets produkttype er den samme som frameldingsoplysningen, opretter tjenesten ikke en medlemsplan.
  • Hvis IsOptOutAllPlans = false og dækning er angivet for medlemstilmelding med den overordnede produkttype, der er den samme som frameldingsoplysningen, opretter tjenesten ikke en medlemsplan.

Hvis det primære medlem framelder sig en produkttype, framelder afhængige sig også denne produkttype.

Afhængigt medlem framelder sig en produkttype

IsOptOutAllPlans har forrang, efterfulgt af OptOutPlanTypes

  • Hvis IsOptOutAllPlans = true, opretter tjenesten ikke en medlemsplan, selvom du angiver et produkt til tilmelding.
  • Hvis IsOptOutAllPlans = false og et produkt er angivet til medlemstilmelding, men dets produkttype er den samme som frameldingsoplysningen, opretter tjenesten ikke en medlemsplan.
  • Hvis IsOptOutAllPlans = false og dækning er angivet for medlemstilmelding med den overordnede produkttype, der er den samme som frameldingsoplysningen, opretter tjenesten ikke en medlemsplan.

Hvis det primære medlem framelder sig en produkttype, framelder afhængige sig også denne produkttype.

Hvis IsOptOutAllPlans = true for et primært medlem, gælder det samme output for de tilknyttede afhængige.

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"
      }
   ]
}
 
Indlæser
Salesforce Help | Article