Loading
Forsikring
InsEnrollmentService:getMemberEnrollments

InsEnrollmentService:getMemberEnrollments

Bruk denne tjenesten til å hente gjeldende påmeldinger for et medlem slik at de kan redigere fordelene. Denne tjenesten tar også én eller flere ID-er for folketellingsmedlemmer og returnerer registrerte planer for medlemmet og deres avhengige.

Viktig
Viktig Fra og med Winter '23 har vi aktivert InsEnrollmentServiceStd:getMemberEnrollments-tjenesten for å fungere med Salesforce Standard Data Model for Financial Services Cloud og Health Cloud. Eksisterende kunder kan fortsette å bruke denne tjenesten, men ingen ytterligere forbedringer vil bli levert i den administrerte pakken for Forsikring.

Klasse: InsEnrollmentService

Metode: getMemberEnrollments

Det finnes to flyter for å kalle opp getMemberEnrollments-tjenesten:

  • Forsikringspoliseflyt: Den utløses når verdien av isFsc er sann.

    • Personkontoer-flyten utløses når isFsc er sann og GroupCensusMember__c.AccountId__c er fylt ut.

    • Flyten Ikke-personkontoer utløses når GroupCensusMember__c.AccountId__c-feltet ikke er fylt ut.

  • Aktivumflyt: Den utløses når verdien i IsFsc er usann.

Slik fungerer det ved bruk av Forsikringspolise-poster

Forsikringspolise-flyten gjelder når verdien av isFsc er sann. Tjenesten gjør følgende:

  1. Hvis ingen effectiveDate oppgis i inndataene, bruker tjenesten contractId-parameteren til å hente Contract.EnrollmentStartDate__c. Se effectiveDate- og contractId-parametere i delen Eksterne alternativer for å få mer informasjon.

  2. Returnerer policyene som InsurancePolicy-poster. For Forsikringspolise støtter tjenesten både personkontoflyten og flyten Ikke-personkontoer forklart som:

    Personkontoer-flyt

    Denne flyten gjelder når folketellingsmedlemmer er knyttet til personkontoer.

    1. Hvis groupAccountId er inndata, bruker tjenesten ACR til å hente personAccountIds til folketellingsmedlemmene som er knyttet til groupAccountId. Den returnerer alle forsikringspoliser der nameInsuredId samsvarer med disse personAccountIds og effectiveDate samsvarer med effectiveDate oppgitt i inndataene.

    2. Hvis censusMemberIds er inndata, henter tjenesten GroupCensusMember__c-postene. Se censusMemberIds-parameteren i delen Eksterne alternativer for å få mer informasjon. Hvis AccountId__c-feltet for folketellingsmedlemmene er fylt ut, bruker vi disse personAccountIds (GroupCensusMember__c.AccountId__c). Den returnerer alle forsikringspoliser der nameInsuredId samsvarer med personAccountIds og effectiveDate samsvarer med effectiveDate gitt i inndata.

    Flyt for ikke-personkontoer

    Denne flyten gjelder når folketellingsmedlemmer er knyttet til kontakter.

    1. Tjenesten bruker accountId til å hente InsurancePolicy-objektet for folketellingen. Det er en obligatorisk parameter for flyten for ikke-personkontoer.

    2. Hvis censusMemberIds-feltet oppgis i inndataene, henter tjenesten GroupCensusMember__c-postene. Hvis AccountId__c-feltet for folketellingsmedlemmene ikke er fylt ut, henter tjenesten policyene til medlemmene som bruker GroupCensusMember__c.ContactId__c, accountId og effectiveDate. Typen policy som hentes, avhenger av isFsc-parameteren og den tilpassede innstillingen for defaultIsFSCOption som beskrevet i denne tabellen:

      Tilpassede innstillinger > Forsikringskonfigurasjon > defaultIsFSCOption

      IsFsc-parameter

      Policyer hentet

      True

      NA

      InsurancePolicy

      False

      True

      InsurancePolicy

      NA

      True

      InsurancePolicy

  3. Tjenesten henter henholdsvis partene, InsurancePolicyParticipant eller AssetPartyRelationship__c i InsurancePolicy eller Asset. For FSC har AssetPartyRelationship__c bare poster for de primære medlemmenes underordnede. InsurancePolicyParticipant har poster for både de primære medlemmene og deres underordnede.

  4. Hvis omitChildProducts-feltet er false, henter tjenesten dekningene (AssetCoverage__c) for polisene og tilhørende produktmetadata. Se omitChildProducts-parameteren i delen Eksterne alternativer for å få mer informasjon.

  5. Hver policy grupperes deretter etter det primære medlemmet.

Slik fungerer den for aktiva

Aktivumflyt gjelder når verdien i isFsc er usann. For aktivumposter støtter vi ikke Personkonto.

Tjenesten gjør følgende:

  1. Hvis ingen effectiveDate oppgis i inndataene, bruker tjenesten contractId-parameteren til å hente Contract.EnrollmentStartDate__c. Se effectiveDate- og contractId-parametere i delen Eksterne alternativer for å få mer informasjon.

  2. Tjenesten bruker accountId til å hente Aktivum-objektet for folketellingsmedlemmene. Det er en obligatorisk parameter for flyten for ikke-FSC-kontoer.

  3. Tjenesten bruker censusMemberIds til å hente GroupCensusMember__c-postene. Se censusMemberIds-parameteren i delen Eksterne alternativer for å få mer informasjon.

  4. Hvis AccountId__c-feltet for folketellingsmedlemmene ikke er fylt ut, henter tjenesten policyene til medlemmene ved bruk av feltene GroupCensusMember__c.ContactId__c, accountId og effectiveDate. Typen policy som hentes, avhenger av isFsc-parameteren og den tilpassede innstillingen for defaultIsFSCOption som beskrevet i denne tabellen.

    Tilpassede innstillinger > Forsikringskonfigurasjon > defaultIsFSCOption

    IsFsc-parameter

    Policyer hentet

    False

    False

    Aktivum

    NA

    False

    Aktivum

  5. Tjenesten henter partene. For ikke-FSC henter den InsurancePolicyParticipant eller AssetPartyRelationship__c, av InsurancePolicy eller Asset-postene.

    • AssetPartyRelationship__c har bare poster for de primære medlemmenes avhengige.

    • InsurancePolicyParticipant har poster for både de primære medlemmene og deres underordnede.

  6. Hvis omitChildProducts er false, henter tjenesten dekningene (InsurancePolicyCoverage eller AssetCoverage__c) for polisene og tilhørende produktmetadata. Se omitChildProducts-parameteren i delen Eksterne alternativer for å få mer informasjon.

  7. Hver policy grupperes deretter etter det primære medlemmet.

Eksterne alternativer

Tjenesten bruker enten contractId til å hente effectiveDate fra enrollmentStartDate eller den bruker effectiveDate direkte, som har forrang foran contractId hvis begge brukes.

Alternativ

Beskrivelse

censusMemberIds

Liste over primære ID-er for folketellingsmedlemmer.

accountId

Gruppen Id som dette medlemmet tilhører.

groupAccountId

Gruppe-ID-en til folketellingsmedlemmene som har poliser som skal hentes. Denne parameteren gjelder bare for FSC-flyt.

effectiveDate

Nødvendig hvis contractId ikke brukes

Gyldighetsdatoen for policyen.

Denne datoen må alltid være GMT-datoen for policyens gyldighetsdato.

contractId

Kreves hvis effectiveDate ikke brukes.

Kan brukes i stedet for effectiveDate for å hente startdato for påmelding som gyldighetsdato for policyen.

includeOptionalCoverages

Hvis true, henter tjenesten valgfrie dekninger av påmeldingene.

omitChildProducts

Hvis false, henter tjenesten dekninger av påmeldingene.

isFsc

  • Bestemmer om polisene skal hentes fra Aktivum-postene eller InsurancePolicy-postene.

  • Hvis Custom Settings > Insurance Configuration Setup har defaultIsFSCOption satt til false eller hvis det ikke er noen defaultIsFSCOption, respekteres verdien i denne parameteren.

Inndata-JSON

Denne tjenesten bruker ikke en inndata-JSON.

Utdata-JSON

Her er formatet på JSON-koden for utdata:

  • Utdata-JSON-koden er en liste over folketellingsmedlemmer med Fornavn, Etternavn, ID for folketellingsmedlem og kontakt-ID med registreringer.

  • Enrollments-noden har produktdetaljer og Dependents-noder hvis det er avhengige. Den inkluderer også underordnede produkter og dekningsdetaljer.

  • Dependents-noden består av First Name, Last Name, Id, RelationshipType, ContactId og 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"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}

Her er et eksempel på JSON-kode for utdata:

{
  "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"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}
 
Laster
Salesforce Help | Article