R4 Ballot #2 (Mixed Normative/Trial use)

This page is part of the FHIR Specification (v3.5.0: R4 Ballot #2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4

Patient Administration Work GroupMaturity Level: 0 Trial Use Compartments: Not linked to any defined compartments

Detailed Descriptions for the elements in the InsurancePlan resource.

InsurancePlan
Element IdInsurancePlan
Definition

Details of a Health Insurance product/plan provided by an organization.

Control1..1
TypeDomainResource
Invariants
Defined on this element
ipn-1Rule The organization SHALL at least have a name or an idendtifier, and possibly more than one(identifier.count() + name.count()) > 0
InsurancePlan.identifier
Element IdInsurancePlan.identifier
Definition

Business identifiers assigned to this health insurance product which remain constant as the resource is updated and propagates from server to server.

NoteThis is a business identifer, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
Summarytrue
Invariants
Affect this element
ipn-1Rule The organization SHALL at least have a name or an idendtifier, and possibly more than one(identifier.count() + name.count()) > 0
InsurancePlan.status
Element IdInsurancePlan.status
Definition

The current state of the health insurance product.

Control0..1
Terminology BindingPublicationStatus (Required)
Typecode
Is Modifiertrue (Reason: This element is labeled as a modifier because it is a status element that contains codes which means that the resource should not be treated as valid)
Meaning if MissingDefault interpretation is active.
Requirements

Need a flag to indicate a record is no longer to be used and should generally be hidden for the user in the UI.

Summarytrue
InsurancePlan.type
Element IdInsurancePlan.type
Definition

The kind of health insurance product.

Control0..*
Terminology BindingInsurance plan type (Example)
TypeCodeableConcept
Summarytrue
InsurancePlan.name
Element IdInsurancePlan.name
Definition

Official name of the health insurance product as designated by the owner.

Control0..1
Typestring
Summarytrue
Comments

If the name of the product/plan changes, consider putting the old name in the alias column so that it can still be located through searches.

Invariants
Affect this element
ipn-1Rule The organization SHALL at least have a name or an idendtifier, and possibly more than one(identifier.count() + name.count()) > 0
InsurancePlan.alias
Element IdInsurancePlan.alias
Definition

A list of alternate names that the product is known as, or was known as in the past.

Control0..*
Typestring
Requirements

Over time products/plans go through many changes and can be known by different names.

For searching knowing previous names that the product/plan was known by can be very useful.

Comments

There are no dates associated with the alias/historic names, as this is not intended to track when names were used, but to assist in searching so that older names can still result in identifying the product/plan.

InsurancePlan.period
Element IdInsurancePlan.period
Definition

The period of time that the health insurance product is available.

Control0..1
TypePeriod
InsurancePlan.ownedBy
Element IdInsurancePlan.ownedBy
Definition

The entity that is providing the health insurance product and underwriting the risk. This is typically an insurance carriers, other third-party payers, or health plan sponsors comonly referred to as 'payers'.

Control0..1
TypeReference(Organization)
Alternate NamesPayer
Summarytrue
InsurancePlan.administeredBy
Element IdInsurancePlan.administeredBy
Definition

An organization which administer other services such as underwriting, customer service and/or claims processing on behalf of the health insurance product owner.

Control0..1
TypeReference(Organization)
Summarytrue
InsurancePlan.coverageArea
Element IdInsurancePlan.coverageArea
Definition

The geographic region in which a health insurance product's benefits apply.

Control0..*
TypeReference(Location)
Summarytrue
InsurancePlan.contact
Element IdInsurancePlan.contact
Definition

The contact for the health insurance product for a certain purpose.

Control0..*
Requirements

Need to keep track of assigned contact points within bigger organization.

Comments

Where multiple contacts for the same purpose are provided there is a standard extension that can be used to determine which one is the preferred contact to use.

InsurancePlan.contact.purpose
Element IdInsurancePlan.contact.purpose
Definition

Indicates a purpose for which the contact can be reached.

Control0..1
Terminology BindingContact entity type (Extensible)
TypeCodeableConcept
Requirements

Need to distinguish between multiple contact persons.

InsurancePlan.contact.name
Element IdInsurancePlan.contact.name
Definition

A name associated with the contact.

Control0..1
TypeHumanName
Requirements

Need to be able to track the person by name.

InsurancePlan.contact.telecom
Element IdInsurancePlan.contact.telecom
Definition

A contact detail (e.g. a telephone number or an email address) by which the party may be contacted.

Control0..*
TypeContactPoint
Requirements

People have (primary) ways to contact them in some way such as phone, email.

InsurancePlan.contact.address
Element IdInsurancePlan.contact.address
Definition

Visiting or postal addresses for the contact.

Control0..1
TypeAddress
Requirements

May need to keep track of a contact party's address for contacting, billing or reporting requirements.

InsurancePlan.endpoint
Element IdInsurancePlan.endpoint
Definition

The technical endpoints providing access to services operated for the health insurance product.

Control0..*
TypeReference(Endpoint)
Requirements

Organizations have multiple systems that provide various services and need to be able to define the technical connection details for how to connect to them, and for what purpose.

InsurancePlan.network
Element IdInsurancePlan.network
Definition

Reference to the network included in the health insurance product.

Control0..*
TypeReference(Organization)
Comments

Networks are represented as a hierarchy of organization resources.

InsurancePlan.coverage
Element IdInsurancePlan.coverage
Definition

Details about the coverage offered by the insurance product.

Control0..*
InsurancePlan.coverage.type
Element IdInsurancePlan.coverage.type
Definition

Type of coverage (Medical; Dental; Mental Health; Substance Abuse; Vision; Drug; Short Term; Long Term Care; Hospice; Home Health).

Control1..1
TypeCodeableConcept
InsurancePlan.coverage.network
Element IdInsurancePlan.coverage.network
Definition

Reference to the network that providing the type of coverage.

Control0..*
TypeReference(Organization)
Comments

Networks are represented as a hierarchy of organization resources.

InsurancePlan.coverage.benefit
Element IdInsurancePlan.coverage.benefit
Definition

Specific benefits under this type of coverage.

Control1..*
InsurancePlan.coverage.benefit.type
Element IdInsurancePlan.coverage.benefit.type
Definition

Type of benefit (primary care; speciality care; inpatient; outpatient).

Control1..1
TypeCodeableConcept
InsurancePlan.coverage.benefit.requirement
Element IdInsurancePlan.coverage.benefit.requirement
Definition

The referral requirements to have access/coverage for this benefit.

Control0..1
Typestring
InsurancePlan.coverage.benefit.limit
Element IdInsurancePlan.coverage.benefit.limit
Definition

The specific limits on the benefit.

Control0..*
InsurancePlan.coverage.benefit.limit.value
Element IdInsurancePlan.coverage.benefit.limit.value
Definition

The maximum amount of a service item a plan will pay for a covered benefit. For examples. wellness visits, or eyeglasses.

Control0..1
TypeQuantity
Comments

May also be called “eligible expense,” “payment allowance,” or “negotiated rate.”.

InsurancePlan.coverage.benefit.limit.code
Element IdInsurancePlan.coverage.benefit.limit.code
Definition

The specific limit on the benefit.

Control0..1
TypeCodeableConcept
Comments

Use CodeableConcept.text element if the data is free (uncoded) text.

InsurancePlan.plan
Element IdInsurancePlan.plan
Definition

Details about an insurance plan.

Control0..*
InsurancePlan.plan.identifier
Element IdInsurancePlan.plan.identifier
Definition

Business identifiers assigned to this health insurance plan which remain constant as the resource is updated and propagates from server to server.

NoteThis is a business identifer, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
Summarytrue
InsurancePlan.plan.type
Element IdInsurancePlan.plan.type
Definition

Type of plan. For example, "Platinum" or "High Deductable".

Control0..1
TypeCodeableConcept
InsurancePlan.plan.coverageArea
Element IdInsurancePlan.plan.coverageArea
Definition

The geographic region in which a health insurance plan's benefits apply.

Control0..*
TypeReference(Location)
Summarytrue
InsurancePlan.plan.network
Element IdInsurancePlan.plan.network
Definition

Reference to the network that providing the type of coverage.

Control0..*
TypeReference(Organization)
Comments

Networks are represented as a hierarchy of organization resources.

InsurancePlan.plan.generalCost
Element IdInsurancePlan.plan.generalCost
Definition

Overall costs associated with the plan.

Control0..*
InsurancePlan.plan.generalCost.type
Element IdInsurancePlan.plan.generalCost.type
Definition

Type of cost.

Control0..1
TypeCodeableConcept
InsurancePlan.plan.generalCost.groupSize
Element IdInsurancePlan.plan.generalCost.groupSize
Definition

Number of participants enrolled in the plan.

Control0..1
TypepositiveInt
InsurancePlan.plan.generalCost.cost
Element IdInsurancePlan.plan.generalCost.cost
Definition

Value of the cost.

Control0..1
TypeMoney
InsurancePlan.plan.generalCost.comment
Element IdInsurancePlan.plan.generalCost.comment
Definition

Additional information about the general costs associated with this plan.

Control0..1
Typestring
InsurancePlan.plan.specificCost
Element IdInsurancePlan.plan.specificCost
Definition

Costs associated with the coverage provided by the product.

Control0..*
InsurancePlan.plan.specificCost.category
Element IdInsurancePlan.plan.specificCost.category
Definition

General category of benefit (Medical; Dental; Vision; Drug; Mental Health; Substance Abuse; Hospice, Home Health).

Control1..1
TypeCodeableConcept
InsurancePlan.plan.specificCost.benefit
Element IdInsurancePlan.plan.specificCost.benefit
Definition

List of the specific benefits under this category of benefit.

Control0..*
InsurancePlan.plan.specificCost.benefit.type
Element IdInsurancePlan.plan.specificCost.benefit.type
Definition

Type of specific benefit (preventative; primary care office visit; speciality office visit; hospitalization; emergency room; urgent care).

Control1..1
TypeCodeableConcept
InsurancePlan.plan.specificCost.benefit.cost
Element IdInsurancePlan.plan.specificCost.benefit.cost
Definition

List of the costs associated with a specific benefit.

Control0..*
InsurancePlan.plan.specificCost.benefit.cost.type
Element IdInsurancePlan.plan.specificCost.benefit.cost.type
Definition

Type of cost (copay; individual cap; family cap; coinsurance; deductible).

Control1..1
TypeCodeableConcept
InsurancePlan.plan.specificCost.benefit.cost.applicability
Element IdInsurancePlan.plan.specificCost.benefit.cost.applicability
Definition

Whether the cost applies to in-network or out-of-network providers (in-network; out-of-network; other).

Control0..1
Terminology BindingBenefit cost applicability (Required)
TypeCodeableConcept
InsurancePlan.plan.specificCost.benefit.cost.qualifiers
Element IdInsurancePlan.plan.specificCost.benefit.cost.qualifiers
Definition

Additional information about the cost, such as information about funding sources (e.g. HSA, HRA, FSA, RRA).

Control0..*
TypeCodeableConcept
InsurancePlan.plan.specificCost.benefit.cost.value
Element IdInsurancePlan.plan.specificCost.benefit.cost.value
Definition

The actual cost value. (some of the costs may be represented as percentages rather than currency, e.g. 10% coinsurance).

Control0..1
TypeQuantity