# Enrollment Guide

The following information supports Ideon sending enrollments for Individual Coverage Health Reimbursement Arrangements.

{% hint style="warning" %}
What changes are needed to send ICHRA enrollments with Ideon?

* Provide [Employer](https://ideonapi.gitbook.io/enrollment/mapping-guides/groups#employer) level details like contact and broker information
  * a group `benefit_administrator`  `phone_number` value
  * broker `national_producer_number` and `state_license_number`
* *Optionally*: Notification that a given `coverage_period`  is using the Ideon ICHRA payment solution
  * This allows us to begin the process of generating secure payments for a given group&#x20;
* Create and provide a `plan` , with associated `plan_identifier` (hios id)
* Provide the `citizenship status` for an eligible member (either `us_citizen` or `alien_resident` )
* Provide a `marital status` value
* Provide the expected `policy_premium_amount` , which we provide on the carrier application, and reconcile with existing data to ensure accuracy at time of enrollment.&#x20;

{% endhint %}

Each endpoint in the traditional workflow is used during this implementation, with limited information required at each step:

* a [Group](https://ideonapi.gitbook.io/enrollment/implementation-resources/mapping-guides/groups) shell is created
  * Include values like `producer_of_record` broker information and  `primary_location.benefit_administrator`  `phone_number` &#x20;
* a [Coverage Period](https://ideonapi.gitbook.io/enrollment/implementation-resources/mapping-guides/coverage-periods) is created to show the `carrier_name`  and time period
* under a Coverage Period, each [Plan](https://ideonapi.gitbook.io/enrollment/implementation-resources/mapping-guides/plans) option is created
* [Subscribers](https://ideonapi.gitbook.io/enrollment/implementation-resources/mapping-guides/subscribers) and dependents are created
* Plans are associated with Subscribers by creating [Qualifying Life Event](https://ideonapi.gitbook.io/enrollment/implementation-resources/mapping-guides/qualifying-life-events) objects&#x20;

## Required Information

<table><thead><tr><th width="252.98046875">Endpoint</th><th width="249.28515625">Ideon Field</th><th>Usage &#x26; Mapping</th></tr></thead><tbody><tr><td>POST coverage_periods/[id]/plans</td><td><ul><li>plan_identifier</li></ul></td><td>id is necessary to relate this QLE to a <code>plan</code> that was created. Each <code>plan</code> has a <code>plan_identifier</code> that indicates a description, the exact HIOS id for the plan, etc. </td></tr><tr><td>POST subscriber/[id]/qualifying_life_event</td><td><ul><li>id</li></ul></td><td><p>id is necessary to relate this QLE to a <code>plan</code> that was created. </p><p></p><p>Each <code>plan</code> has a <code>plan_identifier</code> that indicates a description, the exact HIOS id for the plan, etc.</p></td></tr><tr><td>POST subscriber/[id]/qualifying_life_event</td><td><ul><li>policy_premium_amount</li><li>employee_contribution_amount</li><li>employer_contribution_amount</li></ul></td><td>These fields are required by supported ICHRA carriers. These refer to the total premium for the policy, the amount the employee will pay after subsidy, and the ICHRA subsidy amount (employee_contribution)</td></tr><tr><td>POST subscriber/[id]/qualifying_life_event</td><td>plan_quote_id</td><td><p><mark style="color:purple;">Future Enhancment.</mark> </p><p></p><p>Discuss with Ideon whether you can provide this data, based on previous quotes made via IdeonQuote's API</p></td></tr></tbody></table>

## Additional Documentation

For a full API specification, see [https://app.swaggerhub.com/apis/VericredEnrollments/Enrollments/0.3.3#](https://app.swaggerhub.com/apis/VericredEnrollments/Enrollments/0.3.3#/)&#x20;
