Loading
保险
InsEnrollmentService:getMemberEnrollments

InsEnrollmentService:getMemberEnrollments

使用此服务检索成员的当前注册,以便他们可以编辑好处。此服务还获取一个或多个普查成员 ID,并返回成员及其受抚养人的登记计划。

重要
重要 从 Winter '23 开始,我们启用了 InsEnrollmentServiceStd:getMemberEnrollments 服务,以便与 Salesforce Standard Data Model for Financial Services Cloud 和 Health Cloud 一起使用。现有客户可以继续使用此服务,但保险受管软件包不会提供进一步增强。

类:InsEnrollmentService

方法:getMemberEnrollments

有两个流可以调用 getMemberEnrollments 服务:

  • 保险单流:当 isFsc 的值为真时触发。

    • 当isFsc为真并且填充了 ⁇ GroupCensusMember__c.AccountId__c ⁇ 字段时,会触发个人客户流。

    • 在未填充 GroupCensusMember__c.AccountId__c ⁇ 字段时触发非个人客户流。

  • 资产流:当 IsFsc 的值为假时触发。

使用保险单记录时的工作方式

当isFsc值为真时,保险单流适用。该服务执行以下操作:

  1. 如果未在输入中提供任何effectiveDate参数,服务会使用参数 contractId ⁇ 检索参数Contract.EnrollmentStartDate__c。 有关更多信息,请查看远程选项部分中的 effectiveDate ⁇ 和 ⁇ contractId 参数。

  2. 将保单作为InsurancePolicy记录返回。对于保险单,该服务支持个人客户流和非个人客户流,解释如下:

    个人客户流

    此流适用于人口普查成员与个人客户关联的情况。

    1. 如果 ⁇ groupAccountId ⁇ 是输入,服务将使用 ACR 检索与 ⁇ 关联的普查成员的personAccountIdsgroupAccountId。它返回所有保险单,如果承保范围nameInsuredId与这些personAccountIds匹配,承保范围与输入中提供的承保范围effectiveDate匹配effectiveDate。

    2. 如果 ⁇ censusMemberIds ⁇ 是输入, ⁇ 服务会检索 ⁇ GroupCensusMember__c ⁇ 记录。 有关更多信息,请参阅远程选项部分中的censusMemberIds ⁇ parameter。 如果填充了普查成员的AccountId__c字段,我们使用这些personAccountIds (GroupCensusMember__c.AccountId__c)。它返回所有保险单,在这些保险单中,客户nameInsuredId编号匹配personAccountIds,客户编号effectiveDate匹配effectiveDate输入中提供的保险单。

    非个人客户流

    此流适用于人口普查成员与联系人关联的情况。

    1. 该服务使用 accountId 检索普查成员的InsurancePolicy普查对象。这是非个人客户流的强制参数。

    2. 如果在输入中提供了 ⁇ censusMemberIds ⁇ 字段,则服务会检索 ⁇ GroupCensusMember__c记录。 如果未填充普查成员的“AccountId__c”字段,服务将使用“GroupCensusMember__c.ContactId__c”、“accountId”和“effectiveDate”检索成员的策略。检索的策略类型取决于 isFsc 参数,以及下表描述的defaultIsFSCOption自定义设置:

      自定义设置 ⁇ >保险配置设置>defaultIsFSCOption

      IsFsc Parameter

      检索的保单

      真

      NA

      InsurancePolicy

      假

      真

      InsurancePolicy

      NA

      真

      InsurancePolicy

  3. 该服务分别检索记录InsurancePolicy或记录Asset的缔约方、InsurancePolicyParticipant或记录AssetPartyRelationship__c。对于 FSC,AssetPartyRelationship__c ⁇ 仅包含主要成员的受抚养人记录。InsurancePolicyParticipant ⁇ 包含主要成员及其受抚养人记录。

  4. 如果 ⁇ omitChildProducts字段是 ⁇ false,则服务检索保单的承保范围 ⁇ (AssetCoverage__c)及其相应的 ⁇ 产品元数据。 有关更多信息,请查看远程选项部分中的 ⁇ omitChildProducts ⁇ parameter。

  5. 然后,每个策略按主要成员分组。

如何适用于资产

当isFsc值为假时,资产流适用。对于资产记录,我们不支持个人客户。

该服务执行以下操作:

  1. 如果未在输入中提供任何effectiveDate参数,服务会使用参数 contractId ⁇ 检索参数Contract.EnrollmentStartDate__c。 有关更多信息,请查看远程选项部分中的 effectiveDate ⁇ 和 ⁇ contractId 参数。

  2. 该服务使用 accountId 检索普查成员的 ⁇ Asset ⁇ object。这是非FSC 客户流的强制参数。

  3. 该服务使用 censusMemberIds 检索GroupCensusMember__c记录。有关更多信息,请查看远程选项部分中的 censusMemberIds ⁇ parameter。

  4. 如果未填充普查成员的 AccountId__c ⁇ 字段,服务会使用 ⁇ GroupCensusMember__c.ContactId__c、 ⁇ accountId 和 ⁇ effectiveDate 字段检索成员的策略。检索的策略类型取决于 isFsc 参数,以及此表中描述的defaultIsFSCOption自定义设置。

    自定义设置 ⁇ >保险配置设置>defaultIsFSCOption

    IsFsc Parameter

    检索的保单

    假

    假

    资产

    NA

    假

    资产

  5. 该服务检索相关方。对于非 FSC,它检索记录中的记录InsurancePolicyParticipant或记录AssetPartyRelationship__cInsurancePolicy或记录Asset。

    • AssetPartyRelationship__c ⁇ only 包含主要成员的受抚养人记录。

    • InsurancePolicyParticipant该组织有主要成员及其受抚养人的记录。

  6. 如果 ⁇ omitChildProducts字段是 ⁇ false,服务将检索保单的承保范围 ⁇ (InsurancePolicyCoverage或 ⁇ AssetCoverage__c)及其相应的 ⁇ 产品元数据。 有关更多信息,请查看 ⁇ 远程选项部分中的 ⁇ omitChildProducts参数。

  7. 然后,每个策略按主要成员分组。

远程选项

该服务使用contractId从 enrollmentStartDate 获取effectiveDate,或者直接使用 effectiveDate,如果两者同时使用,这将优先于 contractId。

选项

说明

censusMemberIds

主要人口普查成员 ID 列表。

accountId

此成员所属的组 ID。

groupAccountId

检索其策略被建议的普查成员的组 ID。此参数仅适用于 FSC 流。

effectiveDate

不使用 contractId 时必填

保单的生效日期。

此日期必须始终是保单生效日期的 GMT 日期。

contractId

如果未使用 effectiveDate,则为必填项。

可用于而不是effectiveDate检索注册开始日期作为策略的生效日期。

includeOptionalCoverages

如果为真,服务将检索注册的可选覆盖范围。

omitChildProducts

如果为假,服务将检索注册的覆盖范围。

isFsc

  • 确定是否从 ⁇ Asset ⁇ records 或 ⁇ InsurancePolicy ⁇ records 检索策略。

  • 如果 ⁇ Custom Settings ⁇ > Insurance Configuration Setup ⁇ 具有 ⁇ defaultIsFSCOption集false ⁇ ,如果没有 ⁇ defaultIsFSCOption,则遵循此参数的值。

输入 JSON

此服务不需要输入 JSON。

输出 JSON

以下是输出 JSON 的格式:

  • 输出 JSON 是普查成员列表,其中包含名字、姓氏、普查成员 ID 和联系人 ID,以及登记。

  • Enrollments节点包含产品详细信息和Dependents节点(如果有依赖项)。它还包括子产品和承保范围详细信息。

  • Dependents 节点由 First Name、Last Name、Id、RelationshipType、ContactId 和 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"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}

以下是输出 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"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}
 
正在加载
Salesforce Help | Article