Loading
メールアドレスがデフォルトのログイン方式となります 続きを読む
Insurance
InsEnrollmentService:getMemberEnrollments

詳細情報:

  1. Salesforce ヘルプ
  2. ドキュメント
  3. デジタル保険

InsEnrollmentService:getMemberEnrollments

このサービスを使用して、メンバーの現在の登録を取得し、メンバーが特典を編集できるようにします。このサービスでは、1 つ以上の国勢調査メンバー ID を取得し、メンバーとその扶養家族の登録済みプランを返します。

重要
重要 Winter '23以降、Financial Services CloudおよびHealth Cloud向けのSalesforce標準データ モデルと連携するInsEnrollmentServiceStd:getMemberEnrollmentsサービスが有効になります。既存のお客様は引き続きこのサービスを使用できますが、Insurance Managed Package ではそれ以上の機能強化は提供されません。

クラス: InsEnrollmentService

方法: getMemberEnrollments

getMemberEnrollments サービスを呼び出すフローは 2 つあります。

  • Insurance Policy Flow (保険契約フロー): isFsc の値が true の場合にトリガーされます。

    • 個人取引先フローは、isFsc が true で、[GroupCensusMember__c.AccountId__c] 項目が入力されたときにトリガーされます。

    • Non-Person Accounts フローは、[GroupCensusMember__c.AccountId__c] フィールドに値が入力されていないときにトリガーされます。

  • アセットフロー: IsFsc の値が false の場合にトリガーされます。

保険契約レコードを使用する場合のしくみ

Insurance Policy フローは、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 レコードを取得します。 詳細は、「Remote Options」セクションの「censusMemberIdsparameter」を参照してください。 国勢調査メンバーの AccountId__c フィールドに値が入力されている場合、次のpersonAccountIdsが使用されます (GroupCensusMember__c.AccountId__c)。nameInsuredId が personAccountIds に一致し、effectiveDate が入力で指定されたeffectiveDateに一致するすべての保険契約が返されます。

    個人取引先フロー

    このフローは、国勢調査メンバーが取引先責任者に関連付けられている場合に適用されます。

    1. このサービスでは、accountId を使用して国勢調査メンバーの InsurancePolicy オブジェクトを取得します。これは、個人以外の取引先フローの必須パラメーターです。

    2. 入力に censusMemberIds field が指定されている場合、サービスは GroupCensusMember__c レコードを取得します。 国勢調査メンバーの [AccountId__c] 項目が入力されていない場合、サービスは GroupCensusMember__c.ContactId__c、 accountId、および effectiveDate を使用してメンバーのポリシーを取得します。取得されるポリシーのタイプは、次の表で説明されているように、isFsc パラメータとdefaultIsFSCOptionのカスタム設定によって異なります。

      [カスタム設定] > [保険設定] > [defaultIsFSCOption]

      IsFsc パラメーター

      Policies Retrieved (取得された保険契約)

      True

      NA

      InsurancePolicy

      False

      True

      InsurancePolicy

      NA

      True

      InsurancePolicy

  3. このサービスでは、InsurancePolicyレコードまたはAssetレコードの関係者、InsurancePolicyParticipant者、AssetPartyRelationship__c者がそれぞれ取得されます。FSC の場合、AssetPartyRelationship__c  にはプライマリメンバーの扶養家族のレコードのみが含まれます。InsurancePolicyParticipant  には、プライマリメンバーとその扶養家族の両方のレコードがあります。

  4. omitChildProductsフィールドがfalse の場合、サービスはポリシーの対象範囲 (AssetCoverage__c) と対応する 製品メタデータを取得します。 詳細は、「Remote Options (リモートオプション)」セクションの「omitChildProducts parameter (パラメータ)」を参照してください。

  5. その後、各ポリシーはプライマリメンバーでグループ化されます。

納入商品でのしくみ

納入商品フローは、isFsc の値が false の場合に適用されます。納入商品レコードでは、個人取引先はサポートされません。

このサービスは、次の処理を実行します。

  1. 入力にeffectiveDateが指定されていない場合、サービスは contractId パラメータを使用してContract.EnrollmentStartDate__cを取得します。 詳細は、「リモートオプション」セクションの effectiveDate および contractId パラメータを参照してください。

  2. このサービスでは、accountId を使用して国勢調査メンバーの Asset オブジェクトを取得します。これは、非 FSC 取引先フローの必須パラメーターです。

  3. サービスは censusMemberIds を使用して GroupCensusMember__c レコードを取得します。詳細は、「Remote Options」セクションの「censusMemberIdsparameter」を参照してください。

  4. 国勢調査メンバーの AccountId__c 項目が入力されていない場合、サービスは GroupCensusMember__c.ContactId__c、 accountId、および effectiveDate 項目を使用してメンバーのポリシーを取得します。取得されるポリシーのタイプは、次の表で説明されているように、isFsc パラメータとdefaultIsFSCOptionのカスタム設定によって異なります。

    [カスタム設定] > [保険設定] > [defaultIsFSCOption]

    IsFsc パラメーター

    Policies Retrieved (取得された保険契約)

    False

    False

    納入商品

    NA

    False

    納入商品

  5. サービスが関係者を取得します。FSC 以外の場合、InsurancePolicyまたはAssetレコードのInsurancePolicyParticipantまたはAssetPartyRelationship__cを取得します。

    • AssetPartyRelationship__c には、主メンバーの扶養家族のレコードのみが含まれます。

    • InsurancePolicyParticipant には、主メンバーとその扶養家族の両方のレコードがあります。

  6. omitChildProductsfield が false の場合、ポリシーの対象範囲 (InsurancePolicyCoverage または AssetCoverage__c) と対応する 製品メタデータが取得されます。 詳細は、「Remote Options (リモートオプション)」セクションの「omitChildProductsparameter (パラメータ)」を参照してください。

  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がない場合、このパラメーターの値が優先されます。

Input JSON

このサービスは入力 JSON を取りません。

出力 JSON

出力 JSON の形式は次のとおりです。

  • 出力 JSON は、国勢調査メンバーとその登録のリストです。

  • 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