Loading
보험
InsEnrollmentService:getMemberEnrollments

InsEnrollmentService:getMemberEnrollments

이 서비스를 사용하여 구성원이 보상을 편집할 수 있도록 구성원에 대한 현재 등록을 검색합니다. 이 서비스는 하나 이상의 인구 조사 구성원 ID를 가져오고 구성원 및 종속인에 대해 등록된 계획을 반환합니다.

중요
중요 Winter '23부터 Financial Services Cloud 및 Health Cloud용 Salesforce 표준 데이터 모델과 함께 작동하는 InsEnrollmentServiceStd:getMemberEnrollments 서비스를 사용할 수 있습니다. 기존 고객은 계속해서 이 서비스를 사용할 수 있지만 보험 관리형 패키지에서는 추가 개선 사항이 제공되지 않습니다.

클래스: InsEnrollmentService

방법: getMemberEnrollments

getMemberEnrollments 서비스를 호출하는 두 가지 플로가 있습니다.

  • 보험 증권 플로: isFsc 값이 true이면 트리거됩니다.

    • 개인 계정 플로는 isFsc가 true이고 GroupCensusMember__c.AccountId__c 필드가 채워지면 트리거됩니다.

    • GroupCensusMember__c.AccountId__c 필드가 채워지지 않으면 비 개인 계정 플로가 트리거됩니다.

  • 자산 플로: IsFsc 값이 false인 경우 트리거됩니다.

보험 증권 레코드 사용 시 작동 방식

보험 증권 흐름은 isFsc 값이 true인 경우에 적용됩니다. 서비스는 다음을 수행합니다.

  1. 입력에 effectiveDate가 제공되지 않으면 서비스에서 contractId 매개 변수를 사용하여 Contract.EnrollmentStartDate__c을 검색합니다. 자세한 내용은 원격 옵션 섹션의 effectiveDate 및 contractId 매개 변수를 참조하십시오.

  2. 정책을 InsurancePolicy 레코드로 반환합니다. 보험 증권의 경우 서비스는 다음과 같이 설명된 개인 계정 플로와 비 개인 계정 플로를 모두 지원합니다.

    개인 계정 플로

    이 플로는 인구 조사 구성원이 개인 계정에 연결된 경우에 적용됩니다.

    1. groupAccountId가 입력인 경우 서비스는 ACR을 사용하여 groupAccountId와 연결된 인구 조사 구성원의 personAccountIds을 검색합니다. nameInsuredId가 해당 personAccountIds와 일치하고 effectiveDate가 입력에 제공된 effectiveDate와 일치하는 모든 보험 증권을 반환합니다.

    2. censusMemberIds이 입력인 경우 서비스에서 GroupCensusMember__c 레코드를 검색합니다. 자세한 내용은 원격 옵션 섹션의 censusMemberIds 매개 변수를 참조하십시오. 인구 조사 구성원의 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 매개 변수

      검색된 정책

      True

      NA

      InsurancePolicy

      False

      True

      InsurancePolicy

      NA

      True

      InsurancePolicy

  3. 서비스는 각각 InsurancePolicy 또는 Asset 기록의 당사자, InsurancePolicyParticipant 또는 AssetPartyRelationship__c를 검색합니다. FSC의 경우, AssetPartyRelationship__c에는 기본 구성원의 보존자에 대한 기록만 있습니다. InsurancePolicyParticipant에는 기본 구성원 및 보존자 모두에 대한 기록이 있습니다.

  4. omitChildProducts 필드가 false인 경우 서비스에서 정책의 적용 범위(AssetCoverage__c) 및 해당 제품 메타데이터를 검색합니다. 자세한 내용은 원격 옵션 섹션의 omitChildProducts 매개 변수를 참조하십시오.

  5. 각 정책이 기본 구성원별로 그룹화됩니다.

자산 작동 방식

자산 흐름은 isFsc 값이 false인 경우에 적용됩니다. 자산 레코드의 경우 개인 계정은 지원하지 않습니다.

서비스는 다음을 수행합니다.

  1. 입력에 effectiveDate가 제공되지 않으면 서비스에서 contractId 매개 변수를 사용하여 Contract.EnrollmentStartDate__c을 검색합니다. 자세한 내용은 원격 옵션 섹션의 effectiveDate 및 contractId 매개 변수를 참조하십시오.

  2. 이 서비스는 accountId을 사용하여 인구 조사 구성원에 대한 자산 개체를 검색합니다. 비FSC 계정 플로의 필수 매개 변수입니다.

  3. 서비스는 censusMemberIds을 사용하여 GroupCensusMember__c 레코드를 검색합니다. 자세한 내용은 원격 옵션 섹션의 censusMemberIds 매개 변수를 참조하십시오.

  4. 인구 조사 구성원의 AccountId__c 필드가 채워지지 않은 경우 서비스에서 GroupCensusMember__c.ContactId__c, accountId 및 effectiveDate 필드를 사용하여 구성원의 정책을 검색합니다. 검색되는 정책 유형은 이 표에 설명된 대로 isFsc 매개 변수와 defaultIsFSCOption에 대한 사용자 정의 설정에 따라 다릅니다.

    사용자 정의 설정 > 보험 구성 설정>defaultIsFSCOption

    IsFsc 매개 변수

    검색된 정책

    False

    False

    자산

    NA

    False

    자산

  5. 서비스에서 당사자를 검색합니다. FSC가 아닌 경우 InsurancePolicy 또는 Asset 레코드의 InsurancePolicyParticipant 또는 AssetPartyRelationship__c을 검색합니다.

    • AssetPartyRelationship__c에는 기본 구성원의 부양인에 대한 기록만 있습니다.

    • 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

true이면 서비스에서 등록의 옵션 적용 범위를 검색합니다.

omitChildProducts

false인 경우 서비스에서 등록 범위를 검색합니다.

isFsc

  • 자산 레코드 또는 InsurancePolicy 레코드에서 증권을 검색할지 여부를 결정합니다.

  • 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