Loading
Vakuutus
InsEnrollmentService:getMemberEnrollments

Olet tässä:

  1. Salesforce-ohje
  2. Asiakirja
  3. Digitaalinen vakuutus

InsEnrollmentService:getMemberEnrollments

Käytä tätä palvelua noutaaksesi jäsenen tämänhetkiset rekisteröinnit, jotta hän voi muokata etuja. Tämä palvelu ottaa myös yhden tai useamman väestönlaskentajäsenen tunnuksen ja palauttaa jäsenelle ja hänen alaisilleen rekisteröidyt suunnitelmat.

Tärkeää
Tärkeää Winter '23 -julkaisusta alkaen olemme ottaneet käyttöön InsEnrollmentServiceStd:getMemberEnrollments -palvelun, joka toimii Salesforcen vakiomuotoisen datamallin kanssa Financial Services Cloudille ja Health Cloudille. Nykyiset asiakkaat voivat jatkaa tämän palvelun käyttämistä, mutta hallittujen vakuutusten paketti ei tarjoa lisäparannuksia.

Luokka: InsEnrollmentService

Metodi: getMemberEnrollments

getMemberEnrollments-palvelua voi kutsua kahdella tavalla:

  • Vakuutussopimuksen kulku: Se käynnistyy, kun isFsc-arvo on tosi.

    • Henkilötilit-kulku käynnistyy, kun isFsc on tosi ja GroupCensusMember__c.AccountId__c-kenttä on täytetty.

    • Muu kuin henkilötilit -kulku käynnistyy, kun GroupCensusMember__c.AccountId__c-kenttää ei ole täytetty.

  • Omaisuuden kulku: Se käynnistyy, kun IsFsc-arvo on false.

Miten se toimii vakuutusten tietueiden käytössä

Vakuutuskäytäntö-kulkua sovelletaan, kun isFsc-arvo on true. Palvelu tekee seuraavat toimet:

  1. Jos effectiveDate-arvoa ei ole annettu input-arvona, palvelu käyttää contractId-parametriä hakeakseen Contract.EnrollmentStartDate__c. Lisätietoja on effectiveDate- ja contractId-parametreissä Etäasetukset-osiossa.

  2. Palauttaa käytännöt InsurancePolicy-tietueina. Palvelu tukee Vakuutussopimus-kentässä sekä Henkilötilit-kulkua että Ei henkilötilit -kulkua, joka selitetään seuraavasti:

    Henkilötilien kulku

    Tämä kulku on käytettävissä, kun rekisteröinnin jäsenet on liitetty henkilötileihin.

    1. Jos input-arvo on groupAccountId, palvelu käyttää ACR-tiedostoa noutaakseen personAccountIds-arvot groupAccountId liittyvistä väestönlaskentajäsenistä. Se palauttaa kaikki vakuutuskäytännöt, joissa nameInsuredId vastaa näitä personAccountIds ja effectiveDate vastaa input-arvona annettua effectiveDate.

    2. Jos input-arvo on censusMemberIds, palvelu noutaa GroupCensusMember__c-tietueet. Lisätietoja on Etäasetukset-osion kohdassa censusMemberIds-parametri. Jos kyselyn jäsenten AccountId__c-kenttä on täytetty, käytämme näitä personAccountIds (GroupCensusMember__c.AccountId__c). Se palauttaa kaikki vakuutuskäytännöt, joissa nameInsuredId vastaa personAccountIds ja effectiveDate vastaa input-arvona annettuja effectiveDate.

    Muu kuin henkilötilien kulku

    Tämä kulku on käytettävissä, kun tietueiden jäseniä liitetään yhteyshenkilöihin.

    1. Palvelu käyttää accountId-objektia noutaakseen InsurancePolicy-objektin kyselyn jäsenille. Se on pakollinen parametri muille kuin henkilötilien kuluille.

    2. Jos input-arvona on määritetty censusMemberIds-kenttä, palvelu noutaa GroupCensusMember__c-tietueet. Jos kyselyn jäsenten AccountId__c-kenttää ei ole täytetty, palvelu noutaa GroupCensusMember__c.ContactId__c-, accountId- ja effectiveDate-arvoja käyttävien jäsenten käytännöt. Noudettavan käytännön tyyppi riippuu isFsc-parametristä ja mukautetusta defaultIsFSCOption-asetuksesta tämän taulukon mukaisesti:

      Mukautetut asetukset > Vakuutusmääritykset>defaultIsFSCOption

      IsFsc-parametri

      Noudetut käytännöt

      True

      NA

      InsurancePolicy

      False

      True

      InsurancePolicy

      NA

      True

      InsurancePolicy

  3. Palvelu noutaa InsurancePolicy- tai Asset-tietueiden osapuolet, InsurancePolicyParticipant tai AssetPartyRelationship__c. FSC:llä AssetPartyRelationship__c sisältää tietueita vain ensisijaisten jäsenten sidonnaisille. InsurancePolicyParticipant sisältää tietueita sekä ensisijaisille jäsenille että heidän alaisilleen.

  4. Jos omitChildProducts-kenttä on false, palvelu noutaa vakuutusten kattavuudet (AssetCoverage__c) ja niitä vastaavan tuotteen metadatan. Lisätietoja on Etäasetukset-osion kohdassa omitChildProducts-parametri.

  5. Jokainen käytäntö on ryhmitetty ensisijaisen jäsenen mukaan.

Miten se toimii omaisuuksille

Omaisuudet-kulkua käytetään, kun isFsc-arvo on false. Emme tue omaisuustietueiden henkilötilejä.

Palvelu tekee seuraavat toimet:

  1. Jos effectiveDate-arvoa ei ole annettu input-arvona, palvelu käyttää contractId-parametriä hakeakseen Contract.EnrollmentStartDate__c. Lisätietoja on effectiveDate- ja contractId-parametreissä Etäasetukset-osiossa.

  2. Palvelu käyttää accountId-objektia noutaakseen Omaisuus-objektin väestönlaskentajäsenille. Se on pakollinen parametri ei-FSC-tilien kululle.

  3. Palvelu käyttää censusMemberIds-operaattoria noutaakseen GroupCensusMember__c-tietueet. Lisätietoja on Etäasetukset-osiossa kohdassa censusMemberIds-parametri.

  4. Jos rekisterin jäsenten AccountId__c-kenttää ei ole täytetty, palvelu noutaa niiden jäsenten käytännöt, jotka käyttävät GroupCensusMember__c.ContactId__c-, accountId- ja effectiveDate-kenttiä. Noudettavan käytännön tyyppi riippuu isFsc-parametristä ja mukautetusta defaultIsFSCOption-asetuksesta tämän taulukon mukaisesti.

    Mukautetut asetukset > Vakuutusmääritykset>defaultIsFSCOption

    IsFsc-parametri

    Noudetut käytännöt

    False

    False

    Omaisuus

    NA

    False

    Omaisuus

  5. Palvelu noutaa osapuolet. Jos kyseessä ei ole FSC, se noutaa InsurancePolicy- tai Asset-tietueista InsurancePolicyParticipant tai AssetPartyRelationship__c.

    • AssetPartyRelationship__c sisältää tietueita vain ensisijaisten jäsenten sidonnaisille.

    • InsurancePolicyParticipant sisältää tietueita sekä ensisijaisille jäsenille että heidän alaisilleen.

  6. Jos omitChildProducts-kenttä on false, palvelu noutaa vakuutusten kattavuudet (InsurancePolicyCoverage tai AssetCoverage__c) ja niiden vastaavan tuotemata-tiedot. Lisätietoja on Etäasetukset-osion kohdassa omitChildProducts-parametri.

  7. Jokainen käytäntö on ryhmitetty ensisijaisen jäsenen mukaan.

Etäasetukset

Palvelu käyttää joko contractId-arvoa noutaakseen effectiveDate-arvon enrollmentStartDate:sta tai käyttää suoraan effectiveDate-arvoa, joka on etusijalla contractId:lle, jos molempia käytetään.

Vaihtoehto

Kuvaus

censusMemberIds

Ensisijaisten väestönlaskentajäsenen tunnusten luettelo.

accountId

Ryhmän tunnus, johon tämä jäsen kuuluu.

groupAccountId

Sen ryhmän tunnus, jonka käytäntöjä haluat noutaa. Tämä parametri koskee vain FSC-kulkua.

effectiveDate

Pakollinen, jos contractId-arvoa ei käytetä

Käytännön voimaanastumispäivä.

Tämän päivämäärän täytyy olla aina käytännön voimaanastumispäivän GMT-aika.

contractId

Pakollinen, jos effectiveDate-arvoa ei käytetä.

Voidaan käyttää effectiveDate-arvon sijaan noutaakseen rekisteröinnin alkamispäivän käytännön voimaanastumispäivänä.

includeOptionalCoverages

Jos arvo on true, palvelu noutaa valinnaiset rekisteröintien kattavuudet.

omitChildProducts

Jos arvo on false, palvelu noutaa rekisteröintien kattavuudet.

isFsc

  • Määrittää, noudetaanko vakuutukset omaisuustietueista vai InsurancePolicy-tietueista.

  • Jos Custom Settings > Insurance Configuration Setup on defaultIsFSCOption false tai jos defaultIsFSCOption ei ole, tämän parametrin arvo noudatetaan.

Syötetty JSON

Tämä palvelu ei ota syötettyä JSON-tiedostoa.

Tulos-JSON

Alla on tuloksen JSON-tiedoston muoto:

  • JSON-tiedosto on luettelo väestönlaskentajäsenistä, jonka etunimi, sukunimi, väestönlaskentajäsenen tunnus ja yhteyshenkilön tunnus sisältävät sen rekisteröinnit.

  • Enrollments-noodilla on tuotteen lisätiedot ja Dependents-noodit, jos niissä on sidonnaisuuksia. Se sisältää myös alitason tuotteet ja kattavuustiedot.

  • Dependents-noodi koostuu First Name, Last Name, Id, RelationshipType, ContactId ja PartyId.

{
  "totalSize": numberOfPrimaryMembersRetrievedWithEnrollments,
  "records": [
    {
      "FirstName": "primaryMemberFirstName",
      "LastName": "primaryMemberLastName",
      "Id": "primaryMemberGroupCensusMemberId",
      "contactId": "primaryMemberContactId",
      "enrollments": {
        "totalSize": primary member's number of enrollments,
        "records": [
          {
            "policyNumber": "policy number",
            "Id": "policy Id",
            "productId": "policy's product id",
            "accountId": "policy's account id",
            "primaryMemberContactId": "primaryMemberContactId",
            "productName": "policy's product name",
            "Name": "policy's product name",
            "EffectiveStart": "policy effective date",
            "EffectiveEnd": "policy expiration date",
            "Price": 0,
            "planId": "policy product's plan id",
            "contractId": "contract id",
            "ProductCode": "product code",
            "RecordTypeName__c": "Product",
            "attributeCategories": {},
            "Term": "policy term",
            "attributeSelectedValues": "{}",
            "childProducts": {
              "totalSize": numberOfChildProductsOfThePolicyProduct,
              "records": [
                {
                  "productId": "productIdOfTheChildProduct",
                  "productName": "productNameOfTheChildProduct",
                  "ProductCode": "productCodeOfTheChildProduct",
                  "Name": "productNameOfTheChildProduct",
                  "pciId": "productChildItemIdOfTheChildProduct",
                  "isOptional": ifThisIsAnOptionalCoverage,
                  "attributeSelectedValues": "{}",
                  "isSelected": true,
                  "Id": "coverageId",
                  "PricingSource": "pricingSource",
                  "attributeCategories": {}
                }
              ]
            },
            "dependents": {
              "totalSize": primary member's number of dependents,
              "records": [
                {
                  "Id": "record id",
                  "FirstName": "dependentsFirstName",
                  "LastName": "dependentsLastName",
                  "relationshipType": "relationshipType",
                  "partyId": "contact's party id",
                  "contactId": "dependent's contact Id"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}

Alla on esimerkki output JSON-tiedostosta:

{
  "totalSize": 1,
  "records": [
    {
      "FirstName": "Scott",
      "LastName": "Matthews",
      "Id": "a386F000000yq5LQAQ",
      "contactId": "0036F00002Q4wlSQAR",
      "enrollments": {
        "totalSize": 1,
        "records": [
          {
            "policyNumber": "AA232SDTJ",
            "Id": "02i6F000004XE2jQAG",
            "productId": "01t6F000007sLsaQAE",
            "accountId": "0016F00002GIY4mQAH",
            "primaryMemberContactId": "0036F00002Q4wlSQAR",
            "productName": "BoMedicalProduct",
            "Name": "BoMedicalProduct",
            "EffectiveStart": "2018-04-12",
            "EffectiveEnd": "2019-02-09",
            "Price": 0,
            "planId": "a1u6F0000035QYxQAM",
            "contractId": "8006F000001GhodQAC",
            "ProductCode": "BMP",
            "RecordTypeName__c": "Product",
            "attributeCategories": {
              "totalSize": 1,
              "records": [
                {
                  "productAttributes": {
                    "records": [
                      {
                        "userValues": null,
                        "values": [
                          {
                            "disabled": true,
                            "readonly": true
                          }
                        ],
                        "isNotTranslatable": false,
                        "cloneable": true,
                        "hidden": false,
                        "hasRules": false,
                        "displaySequence": 0,
                        "label": "TestAttribute_2.2",
                        "attributeId": "a1R6F00000FNrpDUAT",
                        "filterable": true,
                        "disabled": true,
                        "readonly": true,
                        "required": false,
                        "multiselect": false,
                        "inputType": "number",
                        "dataType": "currency",
                        "code": "bfb83baa-662e-674e-9c04-2bad2dc545e1"
                      }
                    ],
                    "totalSize": 1
                  },
                  "id": "a1Q6F000009rHU0UAM",
                  "Name": "AlvinProdCattegory2",
                  "Code__c": "d7539648-3485-0218-802c-c493e727fa67"
                }
              ]
            },
            "Term": "Custom",
            "attributeSelectedValues": "{}",
            "childProducts": {
              "totalSize": 1,
              "records": [
                {
                  "productId": "01t6F00000Akx48QAB",
                  "productName": "Serious Illness",
                  "ProductCode": "SERILL",
                  "Name": "Serious Illness",
                  "pciId": "a2Q6F000001JiqHUAS",
                  "isOptional": false,
                  "attributeSelectedValues": "{}",
                  "isSelected": true,
                  "Id": "01t6F00000Akx48QAU",
                  "PricingSource": "SIPremSelected",
                  "attributeCategories": {
                    "totalSize": 1,
                    "records": [
                      {
                        "productAttributes": {
                          "records": [
                            {
                              "userValues": null,
                              "values": [
                                {
                                  "disabled": false,
                                  "readonly": false
                                }
                              ],
                              "isNotTranslatable": false,
                              "cloneable": true,
                              "hidden": false,
                              "hasRules": false,
                              "displaySequence": 1,
                              "label": "SI Amount Override",
                              "attributeId": "a1R6F00000LE7ESUA1",
                              "filterable": true,
                              "disabled": false,
                              "readonly": false,
                              "required": false,
                              "multiselect": false,
                              "inputType": "number",
                              "dataType": "currency",
                              "code": "SIOVER"
                            },
                            {
                              "rules": [
                                {
                                  "actions": {
                                    "Hide": {
                                      "client": {
                                        "params": {}
                                      },
                                      "remote": {
                                        "params": {}
                                      },
                                      "rest": {
                                        "link": null,
                                        "method": null,
                                        "params": {}
                                      }
                                    }
                                  },
                                  "expression": "%SERILL.SIOVER% > 0",
                                  "ruleType": "Hide"
                                }
                              ],
                              "userValues": null,
                              "values": [
                                {
                                  "disabled": false,
                                  "readonly": false
                                }
                              ],
                              "isNotTranslatable": false,
                              "cloneable": true,
                              "hidden": false,
                              "hasRules": true,
                              "displaySequence": 9,
                              "label": "SIB Multiplier",
                              "attributeId": "a1R6F00000LE7ERUA1",
                              "filterable": true,
                              "disabled": false,
                              "readonly": false,
                              "required": false,
                              "multiselect": false,
                              "inputType": "number",
                              "dataType": "number",
                              "code": "SIB"
                            },
                            {
                              "rules": [
                                {
                                  "actions": {
                                    "Hide": {
                                      "client": {
                                        "params": {}
                                      },
                                      "remote": {
                                        "params": {}
                                      },
                                      "rest": {
                                        "link": null,
                                        "method": null,
                                        "params": {}
                                      }
                                    }
                                  },
                                  "expression": "%SERILL.SIOVER% > 0",
                                  "ruleType": "Hide"
                                }
                              ],
                              "userValues": null,
                              "values": [
                                {
                                  "disabled": false,
                                  "readonly": false
                                }
                              ],
                              "isNotTranslatable": false,
                              "cloneable": true,
                              "hidden": false,
                              "hasRules": true,
                              "displaySequence": 10,
                              "label": "SIB Max",
                              "attributeId": "a1R6F00000LE7EQUA1",
                              "filterable": true,
                              "disabled": false,
                              "readonly": false,
                              "required": false,
                              "multiselect": false,
                              "inputType": "number",
                              "dataType": "currency",
                              "code": "SI"
                            }
                          ],
                          "totalSize": 3
                        },
                        "id": "a1Q6F00000ATYVIUA5",
                        "Name": "Benefit Calculation",
                        "Code__c": "11c2dcbf-500e-1180-4581-ff5000cb0ca6",
                        "displaySequence": 12
                      }
                    ]
                  }
                }
              ]
            },
            "dependents": {
              "totalSize": 2,
              "records": [
                {
                  "Id": "a0o6F00000WsgPtQAJ",
                  "FirstName": "Joan",
                  "LastName": "Robbins",
                  "relationshipType": "Child",
                  "partyId": "a376F000008BJIvQAJ",
                  "contactId": "a376F000008BJIvQAO"
                },
                {
                  "partyId": "a0o6F00000Wsh8QQAF",
                  "Id": "a0o6F00000Wsh8QQAR",
                  "First Name": "Max",
                  "Last Name": "Robbins",
                  "relationshipType": "Spouse",
                  "contactId": "a376F000008BJIwQAO"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}
 
Ladataan
Salesforce Help | Article