Loading
Forsikring
InsEnrollmentService:getMemberEnrollments

InsEnrollmentService:getMemberEnrollments

Brug denne tjeneste til at hente aktuelle tilmeldinger for et medlem, så de kan redigere fordelene. Denne tjeneste tager også et eller flere id'er for optællingsmedlemmer og returnerer tilmeldte planer for medlemmet og deres afhængige.

Vigtigt
Vigtigt Fra og med Winter '23 har vi InsEnrollmentServiceStd:getMemberEnrollments-tjenesten aktiveret til at fungere med Salesforce Standard Data Model til Financial Services Cloud og Health Cloud. Eksisterende kunder kan fortsætte med at bruge denne tjeneste, men der leveres ingen yderligere forbedringer i den administrerede forsikringspakke.

Kategori: InsEnrollmentService

Metode: getMemberEnrollments

Der er to forløb til at kalde getMemberEnrollments-tjenesten:

  • Forsikringspoliceforløb: Det udløses, når værdien af isFsc er sand.

    • Forløbet Personkonti udløses, når isFsc er sandt, og GroupCensusMember__c.AccountId__c er udfyldt.

    • Forløbet Ikke-personkonti udløses, når feltet GroupCensusMember__c.AccountId__c ikke er udfyldt.

  • Aktivforløb: Det udløses, når værdien af IsFsc er falsk.

Sådan fungerer det, når der bruges forsikringspoliceregistreringer

Forsikringspolicens forløb gælder, når værdien af isFsc er sand. Tjenesten gør følgende:

  1. Hvis der ikke angives nogen effectiveDate i inputtet, bruger tjenesten contractId-parameteren til at hente Contract.EnrollmentStartDate__c. Se effectiveDate og contractId i afsnittet Fjernindstillinger for at få flere oplysninger.

  2. Returnerer policerne som InsurancePolicy registreringer. For Forsikringspolice understøtter tjenesten både forløbet Personkonti og forløbet Ikke-personkonti forklaret som:

    Personkonti-forløb

    Dette forløb er gældende, når optællingsmedlemmer er tilknyttet personkonti.

    1. Hvis groupAccountId er input, bruger tjenesten ACR til at hente personAccountIds for de folketællingsmedlemmer, der er tilknyttet groupAccountId. Den returnerer alle forsikringspolicer, hvor nameInsuredId matcher disse personAccountIds, og effectiveDate matcher de effectiveDate, der er angivet i input.

    2. Hvis censusMemberIds er inputtet, henter tjenesten GroupCensusMember__c-registreringerne. Se censusMemberIds-parameter i afsnittet Fjernindstillinger for at få flere oplysninger. Hvis feltet AccountId__c for folketællingsmedlemmer er udfyldt, bruger vi disse personAccountIds (GroupCensusMember__c.AccountId__c). Den returnerer alle forsikringspolicer, hvor nameInsuredId matcher personAccountIds og effectiveDate matcher de effectiveDate, der er angivet i input.

    Forløb for ikke-personkonti

    Dette forløb er gældende, når optællingsmedlemmer er tilknyttet kontakter.

    1. Tjenesten bruger accountId til at hente InsurancePolicy for folketællingsmedlemmerne. Det er en obligatorisk parameter for ikke-personkonti-forløb.

    2. Hvis der er angivet et censusMemberIds-felt i inputtet, henter tjenesten GroupCensusMember__c-registreringerne. Hvis feltet AccountId__c for optællingsmedlemmerne ikke er udfyldt, henter tjenesten politikkerne for de medlemmer, der bruger GroupCensusMember__c.ContactId__c, accountId og effectiveDate. Den type politik, der hentes, afhænger af isFsc-parameteren og den tilpassede indstilling for defaultIsFSCOption som beskrevet i denne tabel:

      Tilpassede indstillinger > Opsætning af forsikringskonfiguration>standardIsFSCOption

      IsFsc-parameter

      Hentede policer

      Sand

      NA

      InsurancePolicy

      Falsk

      Sand

      InsurancePolicy

      NA

      Sand

      InsurancePolicy

  3. Tjenesten henter henholdsvis parterne, InsurancePolicyParticipant eller AssetPartyRelationship__c i InsurancePolicy eller Asset. For FSC har AssetPartyRelationship__c kun registreringer for de primære medlemmers afhængige. InsurancePolicyParticipant har registreringer for både de primære medlemmer og deres afhængige.

  4. Hvis feltet omitChildProducts er false, henter tjenesten dækningerne (AssetCoverage__c) af policerne og deres tilsvarende produktmetadata. Se omitChildProducts-parameter i afsnittet Fjernindstillinger for at få flere oplysninger.

  5. Hver politik er derefter grupperet efter det primære medlem.

Sådan fungerer det for aktiver

Aktivforløb anvendes, når værdien af isFsc er falsk. For aktivregistreringer understøtter vi ikke personkonti.

Tjenesten gør følgende:

  1. Hvis der ikke angives nogen effectiveDate i inputtet, bruger tjenesten contractId-parameteren til at hente Contract.EnrollmentStartDate__c. Se effectiveDate og contractId i afsnittet Fjernindstillinger for at få flere oplysninger.

  2. Tjenesten bruger accountId til at hente objektet Aktiv for optællingsmedlemmerne. Det er en obligatorisk parameter for ikke-FSC-kontoforløb.

  3. Tjenesten bruger censusMemberIds til at hente GroupCensusMember__c registreringer. Se censusMemberIds-parameter i afsnittet Fjernindstillinger for at få flere oplysninger.

  4. Hvis feltet AccountId__c for folketællingsmedlemmer ikke er udfyldt, henter tjenesten politikkerne for medlemmerne ved brug af felterne GroupCensusMember__c.ContactId__c, accountId og effectiveDate. Den type politik, der hentes, afhænger af isFsc-parameteren og den tilpassede indstilling for defaultIsFSCOption som beskrevet i denne tabel.

    Tilpassede indstillinger > Opsætning af forsikringskonfiguration>standardIsFSCOption

    IsFsc-parameter

    Hentede policer

    Falsk

    Falsk

    Aktiv

    NA

    Falsk

    Aktiv

  5. Tjenesten henter parterne. For ikke-FSC henter det InsurancePolicyParticipant eller AssetPartyRelationship__c af InsurancePolicy eller Asset.

    • AssetPartyRelationship__c har kun registreringer for de primære medlemmers afhængige.

    • InsurancePolicyParticipant har registreringer for både de primære medlemmer og deres afhængige.

  6. Hvis feltet omitChildProducts er false, henter tjenesten dækningerne (InsurancePolicyCoverage eller AssetCoverage__c) for policerne og deres tilsvarende produktmetadata. Se omitChildProducts-parameter i afsnittet Fjernindstillinger for at få flere oplysninger.

  7. Hver politik er derefter grupperet efter det primære medlem.

Fjernindstillinger

Tjenesten bruger enten contractId til at hente effectiveDate fra enrollmentStartDate, eller den bruger effectiveDate direkte, hvilket har forrang for contractId, hvis begge anvendes.

Indstilling

Beskrivelse

censusMemberIds

Liste over id'er for primære optællingsmedlemmer.

accountId

Det gruppe-id, dette medlem tilhører.

groupAccountId

Gruppe-id'et for de optællingsmedlemmer, hvis policer skal hentes. Denne parameter er kun gældende for FSC-forløb.

effectiveDate

Krævet, hvis contractId ikke bruges

Ikrafttrædelsesdato for politikken.

Denne dato skal altid være GMT-datoen for politikkens ikrafttrædelsesdato.

contractId

Krævet, hvis effectiveDate ikke bruges.

Kan bruges i stedet for effectiveDate til at hente startdatoen for tilmeldingen som politikens ikrafttrædelsesdato.

includeOptionalCoverages

Hvis det er sandt, henter tjenesten valgfri dækninger af tilmeldingerne.

omitChildProducts

Hvis det er falsk, henter tjenesten dækninger af tilmeldingerne.

isFsc

  • Bestemmer, om policerne skal hentes fra aktivregistreringerne eller InsurancePolicy-registreringerne.

  • Hvis Custom Settings > Insurance Configuration Setup har defaultIsFSCOption indstillet til false, eller hvis der ikke er nogen defaultIsFSCOption, respekteres værdien af denne parameter.

Input JSON

Denne tjeneste bruger ikke et input-JSON.

Output JSON

Her er formatet på output-JSON:

  • Output-JSON er en liste over optællingsmedlemmer med Fornavn, Efternavn, Id for optællingsmedlem og Id for kontakt med dens tilmeldinger.

  • Enrollments har produktdetaljer og Dependents, hvis der er afhængige. Det inkluderer også underordnede produkter og dækningsdetaljer.

  • Dependents består af 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å output-JSON:

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