PrescribeIT® Specification and Guide Version 5.0


v5.0 of this specification has been superseded by v5.3. v5.3 is compatible but adds additional features for Quebec.

The version (Bundle.meta.tag:version) that is sent in the message will remain PrescribeIT5.0

 

The official URL for this profile is:

http://prescribeit.ca/fhir/StructureDefinition/profile-coverage

Download Excel representation

Description of Profiles, Differentials, Snapshots and how the different presentations work.

>

This structure is derived from Coverage

NameCard.TypeConstraints and Usage
.  Coverage 0..*CoverageDefinition:
Financial instrument which may be used to pay for or reimburse health care products and services.

..  id 1..1idDefinition:
The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.


Comments:
Usage Note: This will usually be a GUID and is assigned by the sending application. Ideally it should be consistent for all messages referencing this same set of coverage information.

..  issuer[x]
     (issuerReference)
1..1Reference(Organization) {b}Definition:
The program or plan underwriter or payor.


Comments:
This is currently required in the spec. I've submitted a request to loosen it.

...  display 1..1stringMax Length: 500
Definition:
Plain text narrative that identifies the resource in addition to the resource reference.


Comments:
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.

..  type 0..1CodingBinding: ActCoverageTypeCode (example): The type of insurance: public health, worker compensation; private accident, auto, private health, etc.).


Definition:
The type of coverage: social program, medical plan, accident coverage (workers compensation, auto), group health.

...  extension 0..*ExtensionSlice: Unordered, Open by value:url
Definition:
An Extension

...  extension
       (description)
0..1Coding TextDefinition:
Allows the specification of a free-text description for a coded element that has a type of Coding rather than CodeableConcept.

....  url 1..1uri"http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text"
....  value[x] 1..1stringMax Length: 5000
Definition:
Allows the specification of a free-text description for a coded element that has a type of Coding rather than CodeableConcept.

...  system 0..1uriDefinition:
The identification of the code system that defines the meaning of the symbol in the code.


Comments:
The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

...  code 0..1codeDefinition:
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

..  planholder[x]
     (planholderIdentifier)
1..1IdentifierDefinition:
The party who 'owns' the insurance contractual relationship to the policy or to whom the benefit of the policy is due.

...  value 1..1stringExample' General': 123456
Max Length: 500
Definition:
The portion of the identifier typically relevant to the user and which is unique within the context of the system.


Comments:
Conformance Rule: This element is required because of rules in the FHIR specification which may be relaxed in a future specification. If no useful value is known, this element may be populated 'Unknown'.

..  beneficiary[x]
     (beneficiaryReference)
1..1Reference(Shared Health Patient) {b}Definition:
A reference from one resource to another.

..  relationship 1..1CodingBinding: Beneficiary Relationship Codes (example): The code for the relationship of the patient to the subscriber.


Definition:
The relationship of the patient to the planholdersubscriber).

...  system 0..1uriFixed Value: http://hl7.org/fhir/v3/NullFlavor
Definition:
The identification of the code system that defines the meaning of the symbol in the code.


Comments:
Fixed value: http://hl7.org/fhir/v3/NullFlavor

...  code 0..1codeFixed Value: UNK
Definition:
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).


Comments:
Fixed value: UNK

..  identifier 0..1IdentifierDefinition:
The main (and possibly only) identifier for the coverage - often referred to as a Member Id, Subscriber Id, Certificate number or Personal Health Number or Case ID.

...  value 1..1stringExample' General': 123456
Example' ???': 123456
Definition:
The portion of the identifier typically relevant to the user and which is unique within the context of the system.


Comments:
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.

..  group 0..1stringDefinition:
Identifies a style or collective of coverage issues by the underwriter, for example may be used to identify a class of coverage or employer group. May also be referred to as a Policy or Group ID.

This structure is derived from Coverage

Summary

Mandatory: 3 elements (1 nested mandatory element)
Must-Support: 18 elements
Fixed Value: 2 elements

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

This structure is derived from Coverage

NameFlagsCard.TypeDescription & Constraintsdoco
.. Coverage S0..*CoverageInsurance or medical plan
... id S1..1idLogical id of this artifact
... issuerReference S1..1Reference(Organization) {b}Identifier for the plan issuer/carrier id
.... display S1..1stringName of payor
Max Length: 500
... type S0..1CodingType of coverage
.... extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ext-coding-text S0..1stringFree text
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text
..... value[x] S1..1stringFree text
Max Length: 5000
.... system S0..1uriIdentity of the terminology system
.... code S0..1codeSymbol in syntax defined by the system
... planholderIdentifier S1..1IdentifierPlan holder
.... value S1..1stringThe value that is unique
Max Length: 500
... beneficiaryReference S1..1Reference(Shared Health Patient) {b}A reference from one resource to another
... relationship S1..1CodingPatient relationship to planholder
.... system S0..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/v3/NullFlavor
.... code S0..1codeSymbol in syntax defined by the system
Fixed Value: UNK
... identifier S0..1IdentifierThe primary coverage ID
.... value S1..1stringThe value that is unique
Example ???: 123456
... group S0..1stringAn identifier for the group

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Coverage S0..*CoverageInsurance or medical plan
... id SΣ1..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: http://tools.ietf.org/html/bcp47 (required): A human language.


... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... issuer[x] Σ1..1(Slice Definition)Identifier for the plan issuer
Slice: Unordered, Closed by type:$this
.... issuer[x]:issuerReference SΣ1..1Reference(Organization) {b}Identifier for the plan issuer/carrier id
..... id 0..1idxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... reference ΣI0..1stringRelative, internal or absolute URL reference
..... display SΣ1..1stringName of payor
Max Length: 500
... bin 0..1stringBIN Number
... period Σ0..1PeriodCoverage start and end dates
... type SΣ0..1CodingType of coverage
Binding: ActCoverageTypeCode (example): The type of insurance: public health, worker compensation; private accident, auto, private health, etc.).

.... id 0..1idxml:id (or equivalent in JSON)
.... extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ext-coding-text S0..1stringFree text
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text
..... id 0..1idxml:id (or equivalent in JSON)
..... url S1..1uri"http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text"
..... value[x] S1..1stringFree text
Max Length: 5000
.... system SΣ0..1uriIdentity of the terminology system
.... version Σ0..1stringVersion of the system - if relevant
.... code SΣ0..1codeSymbol in syntax defined by the system
.... display Σ0..1stringRepresentation defined by the system
.... userSelected Σ0..1booleanIf this coding was chosen directly by the user
... planholder[x] ?!1..1(Slice Definition)Plan holder
Slice: Unordered, Closed by type:$this
.... planholder[x]:planholderIdentifier ?!S1..1IdentifierPlan holder
..... id 0..1idxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... use ?!Σ0..1codeusual | official | temp | secondary (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

..... system Σ0..1uriThe namespace for the identifier
Example General: http://www.acme.com/identifiers/patient or urn:ietf:rfc:3986 if the Identifier.value itself is a full uri
..... value SΣ1..1stringThe value that is unique
Example General: 123456
Max Length: 500
..... period Σ0..1PeriodTime period when id is/was valid for use
..... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... beneficiary[x] ?!1..1(Slice Definition)Plan Beneficiary
Slice: Unordered, Closed by type:$this
.... beneficiary[x]:beneficiaryReference ?!S1..1Reference(Shared Health Patient) {b}A reference from one resource to another
... relationship S1..1CodingPatient relationship to planholder
Binding: Beneficiary Relationship Codes (example): The code for the relationship of the patient to the subscriber.

.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... system SΣ0..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/v3/NullFlavor
.... version Σ0..1stringVersion of the system - if relevant
.... code SΣ0..1codeSymbol in syntax defined by the system
Fixed Value: UNK
.... display Σ0..1stringRepresentation defined by the system
.... userSelected Σ0..1booleanIf this coding was chosen directly by the user
... identifier SΣ0..1IdentifierThe primary coverage ID
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... use ?!Σ0..1codeusual | official | temp | secondary (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

.... type Σ0..1CodeableConceptDescription of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

.... system Σ0..1uriThe namespace for the identifier
Example General: http://www.acme.com/identifiers/patient or urn:ietf:rfc:3986 if the Identifier.value itself is a full uri
.... value SΣ1..1stringThe value that is unique
Example General: 123456
Example ???: 123456
.... period Σ0..1PeriodTime period when id is/was valid for use
.... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... group SΣ0..1stringAn identifier for the group
... plan Σ0..1stringAn identifier for the plan
... subPlan Σ0..1stringAn identifier for the subsection of the plan
... dependent Σ0..1positiveIntDependent number
... sequence Σ0..1positiveIntThe plan instance or sequence counter
... exception 0..*CodingEligibility exceptions
Binding: Exception Codes (example): The eligibility exception codes.


... school 0..1stringName of School
... network Σ0..1stringInsurer network
... contract 0..*Reference(Contract)Contract details

doco Documentation for this format

Grid View

This structure is derived from Coverage

NameCard.TypeConstraints and Usage
.  Coverage 0..*CoverageDefinition:
Financial instrument which may be used to pay for or reimburse health care products and services.

..  id 1..1idDefinition:
The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.


Comments:
Usage Note: This will usually be a GUID and is assigned by the sending application. Ideally it should be consistent for all messages referencing this same set of coverage information.

..  issuer[x]
     (issuerReference)
1..1Reference(Organization) {b}Definition:
The program or plan underwriter or payor.


Comments:
This is currently required in the spec. I've submitted a request to loosen it.

...  display 1..1stringMax Length: 500
Definition:
Plain text narrative that identifies the resource in addition to the resource reference.


Comments:
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.

..  type 0..1CodingBinding: ActCoverageTypeCode (example): The type of insurance: public health, worker compensation; private accident, auto, private health, etc.).


Definition:
The type of coverage: social program, medical plan, accident coverage (workers compensation, auto), group health.

...  extension 0..*ExtensionSlice: Unordered, Open by value:url
Definition:
An Extension

...  extension
       (description)
0..1Coding TextDefinition:
Allows the specification of a free-text description for a coded element that has a type of Coding rather than CodeableConcept.

....  url 1..1uri"http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text"
....  value[x] 1..1stringMax Length: 5000
Definition:
Allows the specification of a free-text description for a coded element that has a type of Coding rather than CodeableConcept.

...  system 0..1uriDefinition:
The identification of the code system that defines the meaning of the symbol in the code.


Comments:
The URI may be an OID (urn:oid:...) or a UUID (urn:uuid:...). OIDs and UUIDs SHALL be references to the HL7 OID registry. Otherwise, the URI should come from HL7's list of FHIR defined special URIs or it should de-reference to some definition that establish the system clearly and unambiguously.

...  code 0..1codeDefinition:
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

..  planholder[x]
     (planholderIdentifier)
1..1IdentifierDefinition:
The party who 'owns' the insurance contractual relationship to the policy or to whom the benefit of the policy is due.

...  value 1..1stringExample' General': 123456
Max Length: 500
Definition:
The portion of the identifier typically relevant to the user and which is unique within the context of the system.


Comments:
Conformance Rule: This element is required because of rules in the FHIR specification which may be relaxed in a future specification. If no useful value is known, this element may be populated 'Unknown'.

..  beneficiary[x]
     (beneficiaryReference)
1..1Reference(Shared Health Patient) {b}Definition:
A reference from one resource to another.

..  relationship 1..1CodingBinding: Beneficiary Relationship Codes (example): The code for the relationship of the patient to the subscriber.


Definition:
The relationship of the patient to the planholdersubscriber).

...  system 0..1uriFixed Value: http://hl7.org/fhir/v3/NullFlavor
Definition:
The identification of the code system that defines the meaning of the symbol in the code.


Comments:
Fixed value: http://hl7.org/fhir/v3/NullFlavor

...  code 0..1codeFixed Value: UNK
Definition:
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).


Comments:
Fixed value: UNK

..  identifier 0..1IdentifierDefinition:
The main (and possibly only) identifier for the coverage - often referred to as a Member Id, Subscriber Id, Certificate number or Personal Health Number or Case ID.

...  value 1..1stringExample' General': 123456
Example' ???': 123456
Definition:
The portion of the identifier typically relevant to the user and which is unique within the context of the system.


Comments:
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.

..  group 0..1stringDefinition:
Identifies a style or collective of coverage issues by the underwriter, for example may be used to identify a class of coverage or employer group. May also be referred to as a Policy or Group ID.

This structure is derived from Coverage

Summary

Mandatory: 3 elements (1 nested mandatory element)
Must-Support: 18 elements
Fixed Value: 2 elements

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

Differential View

This structure is derived from Coverage

NameFlagsCard.TypeDescription & Constraintsdoco
.. Coverage S0..*CoverageInsurance or medical plan
... id S1..1idLogical id of this artifact
... issuerReference S1..1Reference(Organization) {b}Identifier for the plan issuer/carrier id
.... display S1..1stringName of payor
Max Length: 500
... type S0..1CodingType of coverage
.... extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ext-coding-text S0..1stringFree text
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text
..... value[x] S1..1stringFree text
Max Length: 5000
.... system S0..1uriIdentity of the terminology system
.... code S0..1codeSymbol in syntax defined by the system
... planholderIdentifier S1..1IdentifierPlan holder
.... value S1..1stringThe value that is unique
Max Length: 500
... beneficiaryReference S1..1Reference(Shared Health Patient) {b}A reference from one resource to another
... relationship S1..1CodingPatient relationship to planholder
.... system S0..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/v3/NullFlavor
.... code S0..1codeSymbol in syntax defined by the system
Fixed Value: UNK
... identifier S0..1IdentifierThe primary coverage ID
.... value S1..1stringThe value that is unique
Example ???: 123456
... group S0..1stringAn identifier for the group

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Coverage S0..*CoverageInsurance or medical plan
... id SΣ1..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: http://tools.ietf.org/html/bcp47 (required): A human language.


... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionAdditional Content defined by implementations
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... issuer[x] Σ1..1(Slice Definition)Identifier for the plan issuer
Slice: Unordered, Closed by type:$this
.... issuer[x]:issuerReference SΣ1..1Reference(Organization) {b}Identifier for the plan issuer/carrier id
..... id 0..1idxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... reference ΣI0..1stringRelative, internal or absolute URL reference
..... display SΣ1..1stringName of payor
Max Length: 500
... bin 0..1stringBIN Number
... period Σ0..1PeriodCoverage start and end dates
... type SΣ0..1CodingType of coverage
Binding: ActCoverageTypeCode (example): The type of insurance: public health, worker compensation; private accident, auto, private health, etc.).

.... id 0..1idxml:id (or equivalent in JSON)
.... extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ext-coding-text S0..1stringFree text
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text
..... id 0..1idxml:id (or equivalent in JSON)
..... url S1..1uri"http://sharedhealth.exchange/fhir/StructureDefinition/ext-coding-text"
..... value[x] S1..1stringFree text
Max Length: 5000
.... system SΣ0..1uriIdentity of the terminology system
.... version Σ0..1stringVersion of the system - if relevant
.... code SΣ0..1codeSymbol in syntax defined by the system
.... display Σ0..1stringRepresentation defined by the system
.... userSelected Σ0..1booleanIf this coding was chosen directly by the user
... planholder[x] ?!1..1(Slice Definition)Plan holder
Slice: Unordered, Closed by type:$this
.... planholder[x]:planholderIdentifier ?!S1..1IdentifierPlan holder
..... id 0..1idxml:id (or equivalent in JSON)
..... extension 0..*ExtensionAdditional Content defined by implementations
..... use ?!Σ0..1codeusual | official | temp | secondary (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

..... type Σ0..1CodeableConceptDescription of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

..... system Σ0..1uriThe namespace for the identifier
Example General: http://www.acme.com/identifiers/patient or urn:ietf:rfc:3986 if the Identifier.value itself is a full uri
..... value SΣ1..1stringThe value that is unique
Example General: 123456
Max Length: 500
..... period Σ0..1PeriodTime period when id is/was valid for use
..... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... beneficiary[x] ?!1..1(Slice Definition)Plan Beneficiary
Slice: Unordered, Closed by type:$this
.... beneficiary[x]:beneficiaryReference ?!S1..1Reference(Shared Health Patient) {b}A reference from one resource to another
... relationship S1..1CodingPatient relationship to planholder
Binding: Beneficiary Relationship Codes (example): The code for the relationship of the patient to the subscriber.

.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... system SΣ0..1uriIdentity of the terminology system
Fixed Value: http://hl7.org/fhir/v3/NullFlavor
.... version Σ0..1stringVersion of the system - if relevant
.... code SΣ0..1codeSymbol in syntax defined by the system
Fixed Value: UNK
.... display Σ0..1stringRepresentation defined by the system
.... userSelected Σ0..1booleanIf this coding was chosen directly by the user
... identifier SΣ0..1IdentifierThe primary coverage ID
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... use ?!Σ0..1codeusual | official | temp | secondary (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

.... type Σ0..1CodeableConceptDescription of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.

.... system Σ0..1uriThe namespace for the identifier
Example General: http://www.acme.com/identifiers/patient or urn:ietf:rfc:3986 if the Identifier.value itself is a full uri
.... value SΣ1..1stringThe value that is unique
Example General: 123456
Example ???: 123456
.... period Σ0..1PeriodTime period when id is/was valid for use
.... assigner Σ0..1Reference(Organization)Organization that issued id (may be just text)
... group SΣ0..1stringAn identifier for the group
... plan Σ0..1stringAn identifier for the plan
... subPlan Σ0..1stringAn identifier for the subsection of the plan
... dependent Σ0..1positiveIntDependent number
... sequence Σ0..1positiveIntThe plan instance or sequence counter
... exception 0..*CodingEligibility exceptions
Binding: Exception Codes (example): The eligibility exception codes.


... school 0..1stringName of School
... network Σ0..1stringInsurer network
... contract 0..*Reference(Contract)Contract details

doco Documentation for this format

 

Other representations of profile: Schematron

Terminology Bindings

PathConformanceValueSet
Coverage.languagerequiredhttp://tools.ietf.org/html/bcp47
Coverage.typeexampleActCoverageTypeCode
Coverage.planholder[x]:planholderIdentifier.userequiredIdentifierUse
Coverage.planholder[x]:planholderIdentifier.typeextensibleIdentifier Type Codes
Coverage.relationshipexampleFixed Value: UNK
Coverage.identifier.userequiredIdentifierUse
Coverage.identifier.typeextensibleIdentifier Type Codes
Coverage.exceptionexampleException Codes

Constraints

IdPathDetailsRequirements