Release 4B Snapshot #1

This page is part of the FHIR Specification v4.3.0-snapshot1: R4B Snapshot to support the Jan 2022 Connectathon. About the R4B version of FHIR. The current officially released version is 4.3.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 UseSecurity Category: Business 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.

Cardinality0..*
TypeDomainResource
Summaryfalse
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 identifier, not a resource identifier (see discussion)
Cardinality0..*
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.

Cardinality0..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.

Cardinality0..*
Terminology BindingInsurancePlanType (Example)
TypeCodeableConcept
Summarytrue
InsurancePlan.name
Element IdInsurancePlan.name
Definition

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

Cardinality0..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.

Cardinality0..*
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.

Summaryfalse
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.

Cardinality0..1
TypePeriod
Summaryfalse
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'.

Cardinality0..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.

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

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

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

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

Cardinality0..*
Requirements

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

Summaryfalse
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.

Cardinality0..1
Terminology BindingContactEntityType (Extensible)
TypeCodeableConcept
Requirements

Need to distinguish between multiple contact persons.

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

A name associated with the contact.

Cardinality0..1
TypeHumanName
Requirements

Need to be able to track the person by name.

Summaryfalse
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.

Cardinality0..*
TypeContactPoint
Requirements

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

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

Visiting or postal addresses for the contact.

Cardinality0..1
TypeAddress
Requirements

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

Summaryfalse
InsurancePlan.endpoint
Element IdInsurancePlan.endpoint
Definition

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

Cardinality0..*
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.

Summaryfalse
InsurancePlan.network
Element IdInsurancePlan.network
Definition

Reference to the network included in the health insurance product.

Cardinality0..*
TypeReference(Organization)
Summaryfalse
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.

Cardinality0..*
Summaryfalse
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).

Cardinality1..1
TypeCodeableConcept
Summaryfalse
InsurancePlan.coverage.network
Element IdInsurancePlan.coverage.network
Definition

Reference to the network that providing the type of coverage.

Cardinality0..*
TypeReference(Organization)
Summaryfalse
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.

Cardinality1..*
Summaryfalse
InsurancePlan.coverage.benefit.type
Element IdInsurancePlan.coverage.benefit.type
Definition

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

Cardinality1..1
TypeCodeableConcept
Summaryfalse
InsurancePlan.coverage.benefit.requirement
Element IdInsurancePlan.coverage.benefit.requirement
Definition

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

Cardinality0..1
Typestring
Summaryfalse
InsurancePlan.coverage.benefit.limit
Element IdInsurancePlan.coverage.benefit.limit
Definition

The specific limits on the benefit.

Cardinality0..*
Summaryfalse
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.

Cardinality0..1
TypeQuantity
Summaryfalse
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.

Cardinality0..1
TypeCodeableConcept
Summaryfalse
Comments

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

InsurancePlan.plan
Element IdInsurancePlan.plan
Definition

Details about an insurance plan.

Cardinality0..*
Summaryfalse
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 identifier, not a resource identifier (see discussion)
Cardinality0..*
TypeIdentifier
Summarytrue
InsurancePlan.plan.type
Element IdInsurancePlan.plan.type
Definition

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

Cardinality0..1
TypeCodeableConcept
Summaryfalse
InsurancePlan.plan.coverageArea
Element IdInsurancePlan.plan.coverageArea
Definition

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

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

Reference to the network that providing the type of coverage.

Cardinality0..*
TypeReference(Organization)
Summaryfalse
Comments

Networks are represented as a hierarchy of organization resources.

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

Overall costs associated with the plan.

Cardinality0..*
Summaryfalse
InsurancePlan.plan.generalCost.type
Element IdInsurancePlan.plan.generalCost.type
Definition

Type of cost.

Cardinality0..1
TypeCodeableConcept
Summaryfalse
InsurancePlan.plan.generalCost.groupSize
Element IdInsurancePlan.plan.generalCost.groupSize
Definition

Number of participants enrolled in the plan.

Cardinality0..1
TypepositiveInt
Summaryfalse
InsurancePlan.plan.generalCost.cost
Element IdInsurancePlan.plan.generalCost.cost
Definition

Value of the cost.

Cardinality0..1
TypeMoney
Summaryfalse
InsurancePlan.plan.generalCost.comment
Element IdInsurancePlan.plan.generalCost.comment
Definition

Additional information about the general costs associated with this plan.

Cardinality0..1
Typestring
Summaryfalse
InsurancePlan.plan.specificCost
Element IdInsurancePlan.plan.specificCost
Definition

Costs associated with the coverage provided by the product.

Cardinality0..*
Summaryfalse
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).

Cardinality1..1
TypeCodeableConcept
Summaryfalse
InsurancePlan.plan.specificCost.benefit
Element IdInsurancePlan.plan.specificCost.benefit
Definition

List of the specific benefits under this category of benefit.

Cardinality0..*
Summaryfalse
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).

Cardinality1..1
TypeCodeableConcept
Summaryfalse
InsurancePlan.plan.specificCost.benefit.cost
Element IdInsurancePlan.plan.specificCost.benefit.cost
Definition

List of the costs associated with a specific benefit.

Cardinality0..*
Summaryfalse
InsurancePlan.plan.specificCost.benefit.cost.type
Element IdInsurancePlan.plan.specificCost.benefit.cost.type
Definition

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

Cardinality1..1
TypeCodeableConcept
Summaryfalse
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).

Cardinality0..1
Terminology BindingBenefitCostApplicability (Required)
TypeCodeableConcept
Summaryfalse
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).

Cardinality0..*
TypeCodeableConcept
Summaryfalse
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).

Cardinality0..1
TypeQuantity
Summaryfalse