ZD Coverage
Resources conforming to this profile are requested by ZorgDomein when SSO to ZorgDomein has succeeded and patient details are fetched from the source system.
Queries on the https://[FHIRServerUrl]/Coverage
endpoint may include the following query parameters:
subscriber=[PatientID]
:[PatientID]
will refer to the patient ID as provided in the Task resource that is requested by ZorgDomein during SSO._include=Coverage:payor
: indicates that the search result must also contain the Organization resource that is referred to by Coverage.payor.
The canonical URL for this profile is:
http://zorgdomein.nl/fhir/StructureDefinition/zd-coverage
This profile builds on Coverage.
Coverage | S | 0..* | Coverage |
There are no (further) constraints on this element Element Id
Coverage Insurance or medical plan or a payment agreement DefinitionFinancial instrument which may be used to reimburse or pay for health care products and services.
|
identifier | Σ | 0..* | Identifier | Element Id
Coverage.identifier The policy number of the insurance of the patient (fallback) DefinitionThe main (and possibly only) identifier for the coverage - often referred to as a Member Id, Certificate number, Personal Health Number or Case ID. May be constructed as the concatination of the Coverage.SubscriberID and the Coverage.dependant. This value may uniquely identify the coverage or it may be used in conjunction with the additional identifiers below.
|
status | Σ ?! | 0..1 | codeBinding |
There are no (further) constraints on this element Element Id
Coverage.status active | cancelled | draft | entered-in-error DefinitionThe status of the resource instance. This element is labeled as a modifier because the status contains the code entered-in-error that marks the coverage as not currently valid. Financial Resource Status Codes (required) Constraints
|
type | Σ | 0..1 | CodeableConceptBinding |
There are no (further) constraints on this element Element Id
Coverage.type Type of coverage such as medical or accident DefinitionThe type of coverage: social program, medical plan, accident coverage (workers compensation, auto), group health or payment by an individual or organization. The order of application of coverages is dependent on the types of coverage. Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Coverage Type and Self-Pay Codes (preferred) Constraints
|
policyHolder | Σ | 0..1 | Reference(Patient | RelatedPerson | Organization) |
There are no (further) constraints on this element Element Id
Coverage.policyHolder Owner of the policy DefinitionThe party who 'owns' the insurance policy, may be an individual, corporation or the subscriber's employer. References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository. Reference(Patient | RelatedPerson | Organization) Constraints
|
subscriber | S Σ | 1..1 | Reference(Patient | RelatedPerson) | Element Id
Coverage.subscriber The insured person DefinitionThe party who has signed-up for or 'owns' the contractual relationship to the policy or to whom the benefit of the policy for services rendered to them or their family is due. References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository. Reference(Patient | RelatedPerson) Constraints
|
subscriberId | S Σ | 0..1 | string | Element Id
Coverage.subscriberId The policy number of the insurance of the patient DefinitionThe insurer assigned ID for the Subscriber. Note that FHIR strings may not exceed 1MB in size
|
beneficiary | Σ | 0..1 | Reference(Patient) |
There are no (further) constraints on this element Element Id
Coverage.beneficiary Plan Beneficiary DefinitionThe party who benefits from the insurance coverage., the patient when services are provided. References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.
|
relationship | 0..1 | CodeableConcept |
There are no (further) constraints on this element Element Id
Coverage.relationship Beneficiary relationship to the Subscriber DefinitionThe relationship of beneficiary (patient) to the subscriber. To determine relationship between the patient and the subscriber. Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination. Policyholder Relationship Codes (example) Constraints
|
|
period | Σ | 0..1 | Period |
There are no (further) constraints on this element Element Id
Coverage.period Coverage start and end dates DefinitionTime period during which the coverage is in force. A missing start date indicates the start date isn't known, a missing end date means the coverage is continuing to be in force. This is not a duration - that's a measure of time (a separate type), but a duration that occurs at a fixed value of time. A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). If duration is required, specify the type as Interval|Duration.
|
payor | S Σ | 1..1 | Reference(Organization) | Element Id
Coverage.payor The insurance company issuing the policy DefinitionThe program or plan underwriter or payor including both insurance and non-insurance agreements, such as patient-pay agreements. May provide multiple identifiers such as insurance company identifier or business identifier (BIN number). Need to identify the issuer to target for processing and for coordination of benefit processing. References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.
|
reference | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.payor.reference Literal reference, Relative, internal or absolute URL DefinitionA reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources. Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server.
|
identifier | Σ | 0..1 | Identifier | Element Id
Coverage.payor.identifier UZOVI-code of insurance company DefinitionAn identifier for the other resource. This is used when there is no way to reference the other resource directly, either because the entity is not available through a FHIR server, or because there is no way for the author of the resource to convert a known identifier to an actual location. There is no requirement that a Reference.identifier point to something that is actually exposed as a FHIR instance, but it SHALL point to a business concept that would be expected to be exposed as a FHIR instance, and that instance would need to be of a FHIR resource type allowed by the reference. When an identifier is provided in place of a reference, any system processing the reference will only be able to resolve the identifier to a reference if it understands the business context in which the identifier is used. Sometimes this is global (e.g. a national identifier) but often it is not. For this reason, none of the useful mechanisms described for working with references (e.g. chaining, includes) are possible, nor should servers be expected to be able resolve the reference. Servers may accept an identifier based reference untouched, resolve it, and/or reject it - see CapabilityStatement.rest.resource.referencePolicy. When both an identifier and a literal reference are provided, the literal reference is preferred. Applications processing the resource are allowed - but not required - to check that the identifier matches the literal reference Applications converting a logical reference to a literal reference may choose to leave the logical reference present, or remove it.
|
use | Σ ?! | 0..1 | codeBinding |
There are no (further) constraints on this element Element Id
Coverage.payor.identifier.use usual | official | temp | secondary (If known) DefinitionThe purpose of this identifier. Allows the appropriate identifier for a particular context of use to be selected from among a set of identifiers. This is labeled as "Is Modifier" because applications should not mistake a temporary id for a permanent one. Applications can assume that an identifier is permanent unless it explicitly says that it is temporary.
|
type | Σ | 0..1 | CodeableConceptBinding |
There are no (further) constraints on this element Element Id
Coverage.payor.identifier.type Description of identifier DefinitionA coded type for the identifier that can be used to determine which identifier to use for a specific purpose. Allows users to make use of identifiers when the identifier system is not known. This element deals only with general categories of identifiers. It SHOULD not be used for codes that correspond 1..1 with the Identifier.system. Some identifiers may fall into multiple categories due to common usage. Where the system is known, a type is unnecessary because the type is always part of the system definition. However systems often need to handle identifiers where the system is not known. There is not a 1:1 relationship between type and system, since many different systems have the same type. Identifier Type Codes (extensible) Constraints
|
system | Σ | 1..1 | uriFixed Value | Element Id
Coverage.payor.identifier.system The namespace for the identifier value DefinitionEstablishes the namespace for the value - that is, a URL that describes a set values that are unique. There are many sets of identifiers. To perform matching of two identifiers, we need to know what set we're dealing with. The system identifies a particular set of unique identifiers. see http://en.wikipedia.org/wiki/Uniform_resource_identifier
http://nictiz.nl/fhir/NamingSystem/uzovi
|
value | Σ | 1..1 | string |
There are no (further) constraints on this element Element Id
Coverage.payor.identifier.value The value that is unique DefinitionThe portion of the identifier typically relevant to the user and which is unique within the context of the system. If the value is a full URI, then the system SHALL be urn:ietf:rfc:3986. The value's primary purpose is computational mapping. As a result, it may be normalized for comparison purposes (e.g. removing non-significant whitespace, dashes, etc.) A value formatted for human display can be conveyed using the Rendered Value extension.
General
123456 Mappings
|
period | Σ | 0..1 | Period |
There are no (further) constraints on this element Element Id
Coverage.payor.identifier.period Time period when id is/was valid for use DefinitionTime period during which identifier is/was valid for use. This is not a duration - that's a measure of time (a separate type), but a duration that occurs at a fixed value of time. A Period specifies a range of time; the context of use will specify whether the entire range applies (e.g. "the patient was an inpatient of the hospital for this time range") or one value from the range applies (e.g. "give to the patient between these two times"). If duration is required, specify the type as Interval|Duration.
|
assigner | Σ | 0..1 | Reference(Organization) |
There are no (further) constraints on this element Element Id
Coverage.payor.identifier.assigner Organization that issued id (may be just text) DefinitionOrganization that issued/manages the identifier. The Identifier.assigner may omit the .reference element and only contain a .display element reflecting the name or other textual information about the assigning organization.
|
display | Σ | 0..1 | string | Element Id
Coverage.payor.display Name of insurance company DefinitionPlain text narrative that identifies the resource in addition to the resource reference. This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it.
|
grouping | 0..1 | BackboneElement |
There are no (further) constraints on this element Element Id
Coverage.grouping Additional coverage classifications DefinitionA suite of underwrite specific classifiers, for example may be used to identify a class of coverage or employer group, Policy, Plan.
|
|
group | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.group An identifier for the group DefinitionIdentifies a style or collective of coverage issued by the underwriter, for example may be used to identify an employer group. May also be referred to as a Policy or Group ID. Note that FHIR strings may not exceed 1MB in size
|
groupDisplay | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.groupDisplay Display text for an identifier for the group DefinitionA short description for the group. Note that FHIR strings may not exceed 1MB in size
|
subGroup | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.subGroup An identifier for the subsection of the group DefinitionIdentifies a style or collective of coverage issued by the underwriter, for example may be used to identify a subset of an employer group. Note that FHIR strings may not exceed 1MB in size
|
subGroupDisplay | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.subGroupDisplay Display text for the subsection of the group DefinitionA short description for the subgroup. Note that FHIR strings may not exceed 1MB in size
|
plan | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.plan An identifier for the plan DefinitionIdentifies a style or collective of coverage issued by the underwriter, for example may be used to identify a collection of benefits provided to employees. May be referred to as a Section or Division ID. Note that FHIR strings may not exceed 1MB in size
|
planDisplay | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.planDisplay Display text for the plan DefinitionA short description for the plan. Note that FHIR strings may not exceed 1MB in size
|
subPlan | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.subPlan An identifier for the subsection of the plan DefinitionIdentifies a sub-style or sub-collective of coverage issued by the underwriter, for example may be used to identify a subset of a collection of benefits provided to employees. Note that FHIR strings may not exceed 1MB in size
|
subPlanDisplay | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.subPlanDisplay Display text for the subsection of the plan DefinitionA short description for the subplan. Note that FHIR strings may not exceed 1MB in size
|
class | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.class An identifier for the class DefinitionIdentifies a style or collective of coverage issues by the underwriter, for example may be used to identify a class of coverage such as a level of deductables or co-payment. Note that FHIR strings may not exceed 1MB in size
|
classDisplay | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.classDisplay Display text for the class DefinitionA short description for the class. Note that FHIR strings may not exceed 1MB in size
|
subClass | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.subClass An identifier for the subsection of the class DefinitionIdentifies a sub-style or sub-collective of coverage issues by the underwriter, for example may be used to identify a subclass of coverage such as a sub-level of deductables or co-payment. Note that FHIR strings may not exceed 1MB in size
|
subClassDisplay | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.grouping.subClassDisplay Display text for the subsection of the subclass DefinitionA short description for the subclass. Note that FHIR strings may not exceed 1MB in size
|
dependent | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.dependent Dependent number DefinitionA unique identifier for a dependent under the coverage. For some coverage a single identifier is issued to the Subscriber and a dependent number issued to each beneficiary. Note that FHIR strings may not exceed 1MB in size
|
sequence | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.sequence The plan instance or sequence counter DefinitionAn optional counter for a particular instance of the identified coverage which increments upon each renewal. Some coverage, for example social plans, may be offered in short time increments, for example for a week or a month at a time, so while the rest of the plan details and identifiers may remain constant over time, the instance is incremented with each renewal and provided to the covered party on their 'card'. Note that FHIR strings may not exceed 1MB in size
|
order | Σ | 0..1 | positiveInt |
There are no (further) constraints on this element Element Id
Coverage.order Relative order of the coverage DefinitionThe order of applicability of this coverage relative to other coverages which are currently inforce. Note, there may be gaps in the numbering and this does not imply primary, secondard etc. as the specific positioning of coverages depends upon the episode of care. 32 bit number; for values larger than this, use decimal
|
network | Σ | 0..1 | string |
There are no (further) constraints on this element Element Id
Coverage.network Insurer network DefinitionThe insurer-specific identifier for the insurer-defined network of providers to which the beneficiary may seek treatment which will be covered at the 'in-network' rate, otherwise 'out of network' terms and conditions apply. Note that FHIR strings may not exceed 1MB in size
|
contract | 0..* | Reference(Contract) |
There are no (further) constraints on this element Element Id
Coverage.contract Contract details DefinitionThe policy(s) which constitute this insurance coverage. References SHALL be a reference to an actual FHIR resource, and SHALL be resolveable (allowing for access control, temporary unavailability, etc). Resolution can be either by retrieval from the URL, or, where applicable by resource type, by treating an absolute reference as a canonical URL and looking it up in a local registry/repository.
|
See the profile on simplifier.net for additional details.
Resource example
Below you find an example of a Coverage resource that conforms to the ZD Coverage profile.
{
"resourceType" : "Coverage",
"id" : "zd-coverage-1",
"meta" : {
"profile" : [
"http://zorgdomein.nl/fhir/StructureDefinition/zd-coverage"
]
},
"subscriber" : {
"reference" : "Patient/zd-patient-1"
},
"subscriberId": "A123456780",
"payor" : [
{
"identifier" : {
"system" : "http://nictiz.nl/fhir/NamingSystem/uzovi",
"value" : "0101"
},
"display" : "N.V. Univé Zorg"
}
]
}
<Coverage xmlns='http://hl7.org/fhir'>
<id value='zd-coverage-1'/>
<meta>
<profile value='http://zorgdomein.nl/fhir/StructureDefinition/zd-coverage'/>
</meta>
<subscriber>
<reference value='Patient/zd-patient-1'/>
</subscriber>
<subscriberId value='A123456780'/>
<payor>
<identifier>
<system value='http://nictiz.nl/fhir/NamingSystem/uzovi'/>
<value value='0101'/>
</identifier>
<display value='N.V. Univé Zorg'/>
</payor>
</Coverage>