InsEnrollmentService: getEnrolleePolicies

Class:InsEnrollmentService

Method:getEnrolleePolicies

How It Works

1. The service receives the parsed JSON.

   • If the input does not contain an accountId, an error is returned.

   • If the input does not contain a valid list of contact ids, an error is returned.

2. The service retrieves a list of contacts for each contactId.

3. The service retrieves a list of policies and map them to each contact retrieved, as long as their group is the given account id.

   • If the input contains an effectiveDate, only policies with the same effective date are retrieved.

   • If the input contains a productType, only policies with the same productType are retrieved.

   • If the input sets includeExpiredPolicies to true, even expired policies are retrieved.

4. The Product details for retrieved policies are also retrieved, including the list of dependents registered for a given policy.

5. The retrieved enrollee list with all assigned policy details is returned in the data node.

Inputs

Input JSON

JSON format:

{
  "contactIds": [ContactId],
  "accountId": accountId,
  "effectiveDate": Date,
  "productType": productType,
  "includeExpiredPolicies": Boolean
}

Sample data output:

{
    "contactIds": [ "0035w000034kiVwAAI" ],
    "accountId": "0015w00002ADHiPAAX",
    "effectiveDate": "6/12/2020",
    "productType": "Medical",
    "includeExpiredPolicies": true
}

Output JSON

JSON format:

{
  "data": [
    {
      "enrollments": [
        {
          "dependents": [
            {
              "partyId":Id,
              "contactId": Id,
              "relationshipType": String,
              "LastName": String",
              "FirstName": String,
              "Id": Id
            }
          ],
          "EffectiveEnd": Date,
          "EffectiveStart": Date,
          "Name": String,
          "productName": String,
          "primaryMemberContactId": Id,
          "policyNumber": String,
          "accountId": Id,
          "productId": Id,
          "Id": Id
        }
      ],
      "AccountId": Id,
      "Id": Id,
      "LastName": String,
      "FirstName": String,
      "Name": String
    }
  ],
  "error": "OK"
}

Sample data output:

{
  "data": [
    {
      "enrollments": [
        {
          "dependents": [
            {
              "partyId": "a0z3h0000036sJiAAI",
              "contactId": "0033h00000BBybMAAT",
              "relationshipType": "Dependent",
              "LastName": "C1P1",
              "FirstName": "D1",
              "Id": "a4B3h000000IdiMEAS"
            },
            {
              "partyId": "a0z3h0000036sJjAAI",
              "contactId": "0033h00000BBybNAAT",
              "relationshipType": "Dependent",
              "LastName": "C1P1",
              "FirstName": "D2",
              "Id": "a4B3h000000IdiNEAS"
            }
          ],
          "EffectiveEnd": null,
          "EffectiveStart": "2020-06-12",
          "Name": "Policy1",
          "productName": "MedPlan A",
          "primaryMemberContactId": "0033h00000BBybLAAT",
          "policyNumber": null,
          "accountId": "0013h00000Gx5UqAAJ",
          "productId": "01t3h000002T4JmAAK",
          "Id": "02i3h00000037xxAAA"
        }
      ],
      "AccountId": "0013h00000Gx5UqAAJ",
      "Id": "0033h00000BBybLAAT",
      "LastName": "C1P1",
      "FirstName": "P1",
      "Name": "P1 C1P1"
    },
    {
      "enrollments": [
        {
          "dependents": [
            {
              "partyId": "a0z3h0000036sJlAAI",
              "contactId": "0033h00000BBybPAAT",
              "relationshipType": "Dependent",
              "LastName": "C1P2",
              "FirstName": "D1",
              "Id": "a4B3h000000IdiOEAS"
            },
            {
              "partyId": "a0z3h0000036sJmAAI",
              "contactId": "0033h00000BBybQAAT",
              "relationshipType": "Dependent",
              "LastName": "C1P2",
              "FirstName": "D2",
              "Id": "a4B3h000000IdiPEAS"
            }
          ],
          "EffectiveEnd": null,
          "EffectiveStart": "2020-06-12",
          "Name": "Policy2",
          "productName": null,
          "primaryMemberContactId": "0033h00000BBybOAAT",
          "policyNumber": null,
          "accountId": "0013h00000Gx5UqAAJ",
          "productId": null,
          "Id": "02i3h00000037xyAAA"
        }
      ],
      "AccountId": "0013h00000Gx5UqAAJ",
      "Id": "0033h00000BBybOAAT",
      "LastName": "C1P2",
      "FirstName": "P2",
      "Name": "P2 C1P2"
    }
  ],
  "error": "OK"
}