Loading
Verzekering
InsEnrollmentService:getMemberEnrollments

InsEnrollmentService:getMemberEnrollments

Gebruik deze service om huidige inschrijvingen voor een lid op te halen zodat deze de voordelen kan bewerken. Deze service neemt ook een of meer ID's van tellingsleden en retourneert geregistreerde plannen voor het lid en zijn of haar gezinsleden.

Belangrijk
Belangrijk Vanaf Winter '23 hebben we de service InsEnrollmentServiceStd:getMemberEnrollments ingeschakeld om te werken met het standaardgegevensmodel van Salesforce voor Financial Services Cloud en Health Cloud. Bestaande klanten kunnen deze service blijven gebruiken, maar er worden geen verdere uitbreidingen in het beheerde pakket Verzekeringen geleverd.

Klasse: InsEnrollmentService

Methode: getMemberEnrollments

Er zijn twee stromen om de service getMemberEnrollments aan te roepen:

  • Stroom Verzekeringspolis: Deze wordt geactiveerd wanneer de waarde van isFsc true (waar) is.

    • De stroom Persoonsaccounts wordt geactiveerd wanneer isFsc true (waar) is en het veld GroupCensusMember__c.AccountId__c is ingevuld.

    • De stroom Niet-persoonsaccounts wordt geactiveerd wanneer het veld GroupCensusMember__c.AccountId__c niet is ingevuld.

  • Asset Flow: Deze wordt geactiveerd wanneer de waarde van IsFsc false (onwaar) is.

Hoe het werkt bij het gebruik van verzekeringspolisrecords

De stroom Verzekeringspolis is van toepassing wanneer de waarde van isFsc true (waar) is. De service doet het volgende:

  1. Als er geen effectiveDate is opgegeven in de invoer, gebruikt de service de parameter contractId om Contract.EnrollmentStartDate__c op te halen. Zie effectiveDate en contractId in de sectie Externe opties voor meer informatie.

  2. Retourneert het beleid als InsurancePolicy. Voor Verzekeringspolis ondersteunt de service zowel de stroom Persoonsaccounts als de stroom Niet-persoonsaccounts, uitgelegd als:

    Stroom Persoonsaccounts

    Deze stroom is van toepassing wanneer tellingsleden zijn gekoppeld aan persoonsaccounts.

    1. Als groupAccountId de invoer is, gebruikt de service ACR om de personAccountIds op te halen van de tellingsleden die aan de groupAccountId zijn gekoppeld. Deze retourneert alle Verzekeringspolissen waarbij nameInsuredId overeenkomt met deze personAccountIds en effectiveDate overeenkomen met de effectiveDate die in de invoer zijn opgegeven.

    2. Als censusMemberIds de invoer is, haalt de service de GroupCensusMember__c op. Zie Parameter censusMemberIds in de sectie Externe opties voor meer informatie. Als het veld AccountId__c van de leden van de volkstelling is ingevuld, gebruiken we deze personAccountIds (GroupCensusMember__c.AccountId__c). Deze retourneert alle Verzekeringspolissen waarbij nameInsuredId overeenkomt met personAccountIds en effectiveDate overeenkomen met de effectiveDate die in de invoer zijn opgegeven.

    Stroom Niet-persoonsaccounts

    Deze stroom is van toepassing wanneer tellingsleden zijn gekoppeld aan contactpersonen.

    1. De service gebruikt accountId om het InsurancePolicy op te halen voor de leden van de volkstelling. Het is een verplichte parameter voor de stroom voor niet-persoonsaccounts.

    2. Als het veld censusMemberIds is opgegeven in de invoer, haalt de service de GroupCensusMember__c op. Als het veld AccountId__c van de leden van de volkstelling niet is ingevuld, haalt de service het beleid van de leden op met behulp van de GroupCensusMember__c.ContactId__c, accountId en effectiveDate. Het type beleid dat wordt opgehaald, is afhankelijk van de parameter isFsc en de aangepaste instelling voor defaultIsFSCOption zoals beschreven in deze tabel:

      Aangepaste instellingen > Set-up van verzekeringsconfiguratie>defaultIsFSCOption

      IsFsc-parameter

      Opgehaalde polissen

      True (Waar)

      N.v.t.

      InsurancePolicy

      False (Onwaar)

      True (Waar)

      InsurancePolicy

      N.v.t.

      True (Waar)

      InsurancePolicy

  3. De service haalt respectievelijk de partijen, InsurancePolicyParticipant of AssetPartyRelationship__c van de InsurancePolicy of Asset op. Voor FSC heeft AssetPartyRelationship__c alleen records voor de afhankelijken van de primaire leden. InsurancePolicyParticipant heeft records voor zowel de primaire leden als hun afhankelijken.

  4. Als het veld omitChildProducts false is, haalt de service de dekkingen (AssetCoverage__c) van de polissen en de bijbehorende productmetagegevens op. Zie Parameter omitChildProducts in de sectie Externe opties voor meer informatie.

  5. Elk beleid wordt vervolgens gegroepeerd op het primaire lid.

Hoe het werkt voor activa

Activastroom is van toepassing wanneer de waarde van isFsc false (onwaar) is. Voor activumrecords bieden we geen ondersteuning voor Persoonsaccount.

De service doet het volgende:

  1. Als er geen effectiveDate is opgegeven in de invoer, gebruikt de service de parameter contractId om Contract.EnrollmentStartDate__c op te halen. Zie effectiveDate en contractId in de sectie Externe opties voor meer informatie.

  2. De service gebruikt accountId om het object Activum op te halen voor de leden van de volkstelling. Het is een verplichte parameter voor de stroom Niet-FSC-accounts.

  3. De service gebruikt censusMemberIds om de GroupCensusMember__c op te halen. Zie de parameter censusMemberIds in de sectie Externe opties voor meer informatie.

  4. Als het veld AccountId__c van de leden van de volkstelling niet is ingevuld, haalt de service het beleid van de leden op met behulp van de velden GroupCensusMember__c.ContactId__c, accountId en effectiveDate. Het type beleid dat wordt opgehaald, is afhankelijk van de parameter isFsc en de aangepaste instelling voor defaultIsFSCOption zoals beschreven in deze tabel.

    Aangepaste instellingen > Set-up van verzekeringsconfiguratie>defaultIsFSCOption

    IsFsc-parameter

    Opgehaalde polissen

    False (Onwaar)

    False (Onwaar)

    Activum

    N.v.t.

    False (Onwaar)

    Activum

  5. De service haalt de partijen op. Voor Niet-FSC haalt het InsurancePolicyParticipant of AssetPartyRelationship__c op van de InsurancePolicy of Asset.

    • AssetPartyRelationship__c heeft alleen records voor de afhankelijke primaire leden.

    • InsurancePolicyParticipant heeft records voor zowel de primaire leden als hun gezinsleden.

  6. Als het veld omitChildProducts false is, haalt de service de dekkingen (InsurancePolicyCoverage of AssetCoverage__c) van de polissen en de bijbehorende productmetagegevens op. Zie Parameter omitChildProducts in de sectie Externe opties voor meer informatie.

  7. Elk beleid wordt vervolgens gegroepeerd op het primaire lid.

Externe opties

De service gebruikt de contractId om de effectiveDate van enrollmentStartDate op te halen of gebruikt effectiveDate rechtstreeks, wat voorrang heeft op contractId als beide worden gebruikt.

Optie

Beschrijving

censusMemberIds

Lijst van ID's van leden van de primaire volkstelling.

accountId

De groeps-ID waartoe dit lid behoort.

groupAccountId

De groeps-ID van de leden van de volkstelling wier polissen moeten worden opgehaald. Deze parameter is alleen van toepassing op FSC-stromen.

effectiveDate

Verplicht als contractId niet wordt gebruikt

Ingangsdatum van de polis.

Deze datum moet altijd de GMT-datum van de ingangsdatum van het beleid zijn.

contractId

Verplicht als effectiveDate niet wordt gebruikt.

Kan in plaats van effectiveDate worden gebruikt om de begindatum van de inschrijving op te halen als de ingangsdatum van het beleid.

includeOptionalCoverages

Indien true (waar), haalt service optionele dekkingen van de inschrijvingen op.

omitChildProducts

Indien false (onwaar), haalt de service dekkingen van de inschrijvingen op.

isFsc

  • Bepaalt of de polissen moeten worden opgehaald uit de activumrecords of de InsurancePolicy-records.

  • Als voor Custom Settings > Insurance Configuration Setup de defaultIsFSCOption is ingesteld op false of als er geen defaultIsFSCOption is, wordt de waarde van deze parameter gerespecteerd.

Invoer-JSON

Deze service gebruikt geen invoer-JSON.

Uitvoer-JSON

Hier is de indeling van de uitvoer-JSON:

  • De uitvoer-JSON is een lijst van volkstellingsleden, met Voornaam, Achternaam, Censuslid-ID en Contactpersoons-ID, met de bijbehorende inschrijvingen.

  • Het Enrollments heeft productdetails en Dependents als er afhankelijkheden zijn. Het omvat ook onderliggende producten en dekkingsdetails.

  • Het Dependents bestaat uit First Name, Last Name, Id, RelationshipType, ContactId en 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"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}

Hier is een voorbeeld van uitvoer-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"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}
 
Wordt geladen
Salesforce Help | Article