You are here:
InsEnrollmentServiceStd:enrollMembers
Use this service to enroll census members into their selected plans.
Class: InsEnrollmentServiceStd
Method: enrollMembers
How It Works
- The service first queries for Group Census Members either a) using all members for a given
groupCensusIdor b) using only the members specified in the groupCensusMembersIds list. - It then searches for pre-enrolled plans linked to each member in the
GroupCensusMemberPlan. -
The product plans for each member are returned.
-
If the product is a part of
contractandcontractGroupPlans, the service creates anInsurancePolicy, and theInsurancePolicyCoveragesfor the coverage items specified in the plan. -
You can create Person Accounts for the group census members in the given group census. To support the Person Account flow:
-
If
accountIds(retrieved from theGroupCensusMember) are available, then the service usesAccountIdasInsurancePolicy.NameInsuredand createsInsurancePolicyParticipants,PrimaryParticipantAccountIdandRelatedParticipantAccountId. -
If
accountId is null, the service uses groupAccountId as InsurancePolicy.NameInsuredandcontactId asInsurancePolicyParticipants, PrimaryParticipantContactId, and RelatedParticipantContactId.
-
-
The service creates an Insurance Policy only for primary members and not their dependents. It creates the dependent information in a separate object called
InsurancePolicyParticipants. A record is also created for the Primary member. The service associates these records to the Insurance Policies.InsurancePolicyParticipant,primaryParticipantAccountIdandrelatedParticipantAccountIdfields are also populated using theAccountIdfield of the group census member and similarly Contact fields whenAccountIdis null. -
Insurance Policy Coverages
If a member is enrolled for an optional coverage during member enrollment, the service creates a separate
InsurancePolicyCoveragerecord corresponding to each enrolled optional coverage. TheInsurancePolicyCoveragerecord stores the enrolledInsuredPolicyParticipantId.- For mandatory coverages, there is a single
InsurancePolicyCoveragerecord for a family per product.
- Insurance Policy Premium
- If
saveMemberPremiumis True, theInsurancePolicyParticipantrecords include theStandardPremiumAmountvalue of a policy.NoteThe calculation procedure must be configured to set the memberPremium amount field with the Include in Calculation Output checked.
- If
Remote Options
| Option | Description |
|---|---|
groupCensusMemberIds |
Required if IDs (comma-separated) of the specific group census members to be enrolled. |
groupCensusId |
Required if The ID of the group census containing all census members to be enrolled. |
contractId |
Required. The ID of the contract that the members belong to and the plans that they are enrolled in. |
dependentRoleName
|
The Role field in The default value is Member. |
isBatchMode
|
Used to create policies asynchronously. Default value is |
primaryRoleName |
The Role field in |
saveMemberPremium
|
Indicates if the policy premium amount must be set for all If the value is true, the policy member premium is stored in the field The default value is false. |
Output JSON
The service returns the list of policies.
policyIds
|
InsurancePolicy record ID. |
{
"policyIds":[
"0036F00002Q4wlSQAR",
"0036F00002Q4wlSQAQ"
]
}
