Plans

Create the Plans for a Group's Coverage Period

Now that you have created a Coverage Period for the Group, the next step is to create the Plans that are offered to the subscribers per product line.

In order to create a Plan:

1. Formulate the Request

2. Send Request / Receive Response

Formulate the Request

Ideon supports a wide variety of product lines across carriers. Use the product_line to denote the overall benefit (medical, dental, disability) and the product_type and voluntary values to provide more information within a product line, i.e., short_term or non_voluntary .

The external_identifier can be used as a link to an identifier in your system to help you manage the resource across systems.

POST /coverage_periods/:id/plans

{
  "plan": {
    "external_identifier": "ppo_high_plan",
    "description": "Medical PPO - High",
    "product_line": "medical",
    "product_type": "preferred_provider_organization",
    "premium_level": "high",
    "waiting_period": {
      "coverage_start": "immediate",
      "waiting_period": "30_days"
    }
  }
}

Send Request / Receive Response

The request is sent to Ideon using a POST /coverage_periods/:id/plans endpoint. Ideon will provide one of two responses to the requestor. The first option is that the request was received successfully and the coverage period was created on our system: 201 - Resource Created Successfully. The second option is that syntax and semantic errors exist: 422 - Unprocessable Entity. This includes the violation of carrier specific business rules.

Success

If the request passes validation, the requestor will be informed of the successful receipt, and provided a copy of the Plan. In the response body the requestor will find the UUID associated with the resource, which is used to indicate the plan a subscriber elects coverage for: plan.id. Typically Coverage Period's have several Plans, so you can create as many as are required.

{
  "plan": {
    "id": "a37ecd06-5d97-46e4-9b4e-dcde6a03246f",
    "external_identifier": "ppo_high_plan",
    "description": "Medical PPO - High",
    "product_line": "medical",
    "product_type": "preferred_provider_organization",
    "premium_level": "high",
    "waiting_period": {
      "coverage_start": "immediate",
      "waiting_period": "30_days"
    }
  }
}