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/interaction-messageheader-401

Download Excel representation

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

>

This structure is derived from Shared Services Message Header

NameCard.TypeConstraints and Usage
.  MessageHeader 0..*Shared Services Message HeaderDefinition:
The header for a message exchange that is either requesting or responding to an action. The reference(s) that are the subject of the action as well as other information related to the action are typically transmitted in a bundle in which the MessageHeader resource instance is the first resource in the bundle.

..  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 value is assigned by the system that creates a bundle and is unique to the specific message instance of the bundle and the uniqueness of this value will be validated by the PrescribeIT® service. This value is sometimes referenced in error messages.

..  meta 1..1MetaDefinition:
The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content may not always be associated with version changes to the resource.


Comments:
See children

...  profile 1..1uriSlice: Unordered, Open by value:value
Definition:
A list of profiles [[[StructureDefinition]]]s that this resource claims to conform to. The URL is a reference to [[[StructureDefinition.url]]].


Comments:
It is up to the server and/or other infrastructure of policy to determine whether/how these claims are verified and/or updated over time. The list of profile URLs is a set.

...  profile
       (profile)
1..1uriFixed Value: http://prescribeit.ca/fhir/StructureDefinition/interaction-messageheader-401
Definition:
A list of profiles [[[StructureDefinition]]]s that this resource claims to conform to. The URL is a reference to [[[StructureDefinition.url]]].


Comments:
Fixed value: http://prescribeit.ca/fhir/StructureDefinition/interaction-messageheader-401

..  timestamp 1..1instantDefinition:
Time and date the transaction was created


Comments:
Conformance Rule: Must be a full date and time with timezone (i.e. yyyy-mm-dd-HH:mm:ss.SSS-ZZZZZ).

..  event 1..1CodingBinding: SharedMessageEvents (20190415) (preferred)
Definition:
Code that identifies the event this message represents and connects it with its definition.

...  system 1..1uriFixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents
Definition:
The identification of the code system that defines the meaning of the symbol in the code.


Comments:
Fixed value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents

...  code 1..1codeFixed Value: 401
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: 401

..  response 0..0
...  identifier 1..1idDefinition:
The id of the message that this message is a response to.


Comments:
Conformance Rule: This is to be populated with the MessageHeader.id of the original message that is being responded to.

...  details 0..1Reference(Shared Health Operation Outcome) {b}Definition:
A reference from one resource to another.


Comments:


..  source 1..1BackboneElementDefinition:
The source application from which this message originated.

...  extension
       (applicationId)
1..1Message Header Application IdDefinition:
Unique identifier for the application responsible for sending a message.


Comments:
Vendors will be assigned this identifier upon registration by PrescribeIT® technical support.

...  extension
       (conformanceVersion)
1..1Message Header Source Conformance VersionDefinition:
String identifying the version of the sending software application that was most recently subjected to conformance testing


Comments:
This is the version number of the software that underwent conformance testing. It may be earlier than the source.version in cases where the application has since undergone changes that do not affect the communication interface.



Usage Note: This version must be registered with the Shared Services Hub and will be validated by the Hub at runtime.

...  name 0..1stringDefinition:
Human-readable name for the source system.


Comments:
Usage Note: The name of the Vendor.

...  software 1..1stringDefinition:
May include configuration or other information useful in debugging.


Comments:
Usage Note: The name of the Vendor's software creating the message.



Conformance Rule: This must be a known value that is registered on Shared Services Hub. This will be validated at run time.

...  version 1..1stringDefinition:
Can convey versions of multiple systems in situations where a message passes through multiple hands.


Comments:
Conformance Rule: This must convey the build version of the vendor application. This is the version of the application that created the message.



Usage Note: This version number is issued by the software vendor and will be used primarily for audit and troubleshooting purposes. This may or may not be the same as the conformance version.

...  endpoint 1..1uriDefinition:
Identifies the routing target to send acknowledgements to.


Comments:
Conformance Rule: This must be set to the fixed value of Organization/111111111 (used in all environments) which represents the PrescribeIT® switch which stores the un-routed message until it is retrieved by a Pharmacy. The URI must be configurable as it will vary by environment. The exact URI's are published to vendors in the API summary document. This will be the URI for Organization. The URI will be structured as follows: https://EnvironmentSpecificHost/EnvironmentAndContextSpecificPathRegistry/Organization/111111111

..  destination 1..1BackboneElementDefinition:
The destination application which the message is intended for.


Comments:
Usage Note: This is used to specify the destination system.

...  endpoint 1..1uriDefinition:
Indicates where the message should be routed to.


Comments:
Conformance Rule: This must be populated with the full URL for the Organization Identifier (CPRID) that was issued by PrescribeIT®. The format to be used is as follows. The URL's must be completely configurable within the EMR or PMS as they will vary by environment. Format: https://{environmentspecifichost}/{EnvironmentAndContextSpecificPath}/Organization/CPR1000123



Vendors will be given the actual values for {environmentspecifichost}/{EnvironmentAndContextSpecificPath} in the API document at time of onboarding.



Conformance Rule: In the context of 401, this will be the PrescribeIT® Switch URI (https://EnvironmentSpecificHost/EnvironmentAndContextSpecificPathRegistry/Organization/111111111)

..  data 1..*Reference(PrescribeIT® Deferred Request from EMR Task) {b}Definition:
A reference from one resource to another.


Comments:
The data is defined where the transaction type is defined. The transaction data is always included in the bundle that is the full message. Only the root resource is specified. The resources it references should be contained in the bundle but are not also listed here. Multiple repetitions are allowed to cater for merges and other situations with multiple focal targets.

This structure is derived from Shared Services Message Header

Summary

Mandatory: 5 elements
Must-Support: 8 elements
Fixed Value: 2 elements
Prohibited: 1 element

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element MessageHeader.meta.profile is sliced based on the value of value:value

This structure is derived from Shared Services Message Header

NameFlagsCard.TypeDescription & Constraintsdoco
.. MessageHeader S0..*Shared Services Message HeaderA resource that describes a message that is exchanged between systems
... meta S1..1MetaMetadata about the resource
.... profile S1..1(Slice Definition)Profiles this resource claims to conform to
Slice: Unordered, Open by value:value
..... profile:profile S1..1uriProfiles this resource claims to conform to
Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/interaction-messageheader-401
... event S1..1CodingCode for the event this message represents
.... code S1..1codeSymbol in syntax defined by the system
Fixed Value: 401
... response 0..0
... source
.... endpoint S1..1uriActual message source address or id
... destination S1..1BackboneElementMessage Destination Application(s)
... data S1..*Reference(PrescribeIT® Deferred Request from EMR Task) {b}A reference from one resource to another

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. MessageHeader SΣ0..*Shared Services Message HeaderA resource that describes a message that is exchanged between systems
... id SΣ1..1idLogical id of this artifact
... meta SΣ1..1MetaMetadata about the resource
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... versionId Σ0..1idVersion specific identifier
.... lastUpdated Σ0..1instantWhen the resource version last changed
.... profile SΣ1..1(Slice Definition)Profiles this resource claims to conform to
Slice: Unordered, Open by value:value
..... profile:profile SΣ1..1uriProfiles this resource claims to conform to

Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/interaction-messageheader-401
.... security Σ0..*CodingSecurity Labels applied to this resource
Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.


.... tag Σ0..*CodingTags applied to this resource
Binding: (unbound) (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones"


... 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
... timestamp SΣ1..1instantTime that the message was sent
... event ?!SΣ1..1CodingCode for the event this message represents
Binding: SharedMessageEvents (20190415) (preferred)
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... system SΣ1..1uriIdentity of the terminology system
Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents
.... version Σ0..1stringVersion of the system - if relevant
.... code SΣ1..1codeSymbol in syntax defined by the system
Fixed Value: 401
.... display Σ0..1stringRepresentation defined by the system
.... userSelected Σ0..1booleanIf this coding was chosen directly by the user
... source SΣ1..1BackboneElementMessage Source Application
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ext-messageheader-application-id S1..1uriSending application id
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-messageheader-application-id
.... ext-messageheader-conformance-version S1..1stringConformance version
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-messageheader-conformance-version
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... name SΣ0..1stringName of system
.... software SΣ1..1stringName of software running the system
.... version SΣ1..1stringVersion of software running
.... contact Σ0..1ContactPointHuman contact for problems
.... endpoint SΣ1..1uriActual message source address or id
... destination SΣ1..1BackboneElementMessage Destination Application(s)
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... name Σ0..1stringName of system
.... target Σ0..1Reference(Device)Particular delivery destination within the destination
.... endpoint SΣ1..1uriActual destination address or id
... enterer Σ0..1Reference(Practitioner)The source of the data entry
... author Σ0..1Reference(Practitioner)The source of the decision
... receiver Σ0..1Reference(Practitioner | Organization)Intended "real-world" recipient for the data
... responsible Σ0..1Reference(Practitioner | Organization)Final responsibility for event
... reason Σ0..1CodeableConceptCause of event
Binding: Example Message Reason Codes (example): Reason for event occurrence

... data SΣ1..*Reference(PrescribeIT® Deferred Request from EMR Task) {b}A reference from one resource to another

doco Documentation for this format

Grid View

This structure is derived from Shared Services Message Header

NameCard.TypeConstraints and Usage
.  MessageHeader 0..*Shared Services Message HeaderDefinition:
The header for a message exchange that is either requesting or responding to an action. The reference(s) that are the subject of the action as well as other information related to the action are typically transmitted in a bundle in which the MessageHeader resource instance is the first resource in the bundle.

..  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 value is assigned by the system that creates a bundle and is unique to the specific message instance of the bundle and the uniqueness of this value will be validated by the PrescribeIT® service. This value is sometimes referenced in error messages.

..  meta 1..1MetaDefinition:
The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content may not always be associated with version changes to the resource.


Comments:
See children

...  profile 1..1uriSlice: Unordered, Open by value:value
Definition:
A list of profiles [[[StructureDefinition]]]s that this resource claims to conform to. The URL is a reference to [[[StructureDefinition.url]]].


Comments:
It is up to the server and/or other infrastructure of policy to determine whether/how these claims are verified and/or updated over time. The list of profile URLs is a set.

...  profile
       (profile)
1..1uriFixed Value: http://prescribeit.ca/fhir/StructureDefinition/interaction-messageheader-401
Definition:
A list of profiles [[[StructureDefinition]]]s that this resource claims to conform to. The URL is a reference to [[[StructureDefinition.url]]].


Comments:
Fixed value: http://prescribeit.ca/fhir/StructureDefinition/interaction-messageheader-401

..  timestamp 1..1instantDefinition:
Time and date the transaction was created


Comments:
Conformance Rule: Must be a full date and time with timezone (i.e. yyyy-mm-dd-HH:mm:ss.SSS-ZZZZZ).

..  event 1..1CodingBinding: SharedMessageEvents (20190415) (preferred)
Definition:
Code that identifies the event this message represents and connects it with its definition.

...  system 1..1uriFixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents
Definition:
The identification of the code system that defines the meaning of the symbol in the code.


Comments:
Fixed value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents

...  code 1..1codeFixed Value: 401
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: 401

..  response 0..0
...  identifier 1..1idDefinition:
The id of the message that this message is a response to.


Comments:
Conformance Rule: This is to be populated with the MessageHeader.id of the original message that is being responded to.

...  details 0..1Reference(Shared Health Operation Outcome) {b}Definition:
A reference from one resource to another.


Comments:


..  source 1..1BackboneElementDefinition:
The source application from which this message originated.

...  extension
       (applicationId)
1..1Message Header Application IdDefinition:
Unique identifier for the application responsible for sending a message.


Comments:
Vendors will be assigned this identifier upon registration by PrescribeIT® technical support.

...  extension
       (conformanceVersion)
1..1Message Header Source Conformance VersionDefinition:
String identifying the version of the sending software application that was most recently subjected to conformance testing


Comments:
This is the version number of the software that underwent conformance testing. It may be earlier than the source.version in cases where the application has since undergone changes that do not affect the communication interface.



Usage Note: This version must be registered with the Shared Services Hub and will be validated by the Hub at runtime.

...  name 0..1stringDefinition:
Human-readable name for the source system.


Comments:
Usage Note: The name of the Vendor.

...  software 1..1stringDefinition:
May include configuration or other information useful in debugging.


Comments:
Usage Note: The name of the Vendor's software creating the message.



Conformance Rule: This must be a known value that is registered on Shared Services Hub. This will be validated at run time.

...  version 1..1stringDefinition:
Can convey versions of multiple systems in situations where a message passes through multiple hands.


Comments:
Conformance Rule: This must convey the build version of the vendor application. This is the version of the application that created the message.



Usage Note: This version number is issued by the software vendor and will be used primarily for audit and troubleshooting purposes. This may or may not be the same as the conformance version.

...  endpoint 1..1uriDefinition:
Identifies the routing target to send acknowledgements to.


Comments:
Conformance Rule: This must be set to the fixed value of Organization/111111111 (used in all environments) which represents the PrescribeIT® switch which stores the un-routed message until it is retrieved by a Pharmacy. The URI must be configurable as it will vary by environment. The exact URI's are published to vendors in the API summary document. This will be the URI for Organization. The URI will be structured as follows: https://EnvironmentSpecificHost/EnvironmentAndContextSpecificPathRegistry/Organization/111111111

..  destination 1..1BackboneElementDefinition:
The destination application which the message is intended for.


Comments:
Usage Note: This is used to specify the destination system.

...  endpoint 1..1uriDefinition:
Indicates where the message should be routed to.


Comments:
Conformance Rule: This must be populated with the full URL for the Organization Identifier (CPRID) that was issued by PrescribeIT®. The format to be used is as follows. The URL's must be completely configurable within the EMR or PMS as they will vary by environment. Format: https://{environmentspecifichost}/{EnvironmentAndContextSpecificPath}/Organization/CPR1000123



Vendors will be given the actual values for {environmentspecifichost}/{EnvironmentAndContextSpecificPath} in the API document at time of onboarding.



Conformance Rule: In the context of 401, this will be the PrescribeIT® Switch URI (https://EnvironmentSpecificHost/EnvironmentAndContextSpecificPathRegistry/Organization/111111111)

..  data 1..*Reference(PrescribeIT® Deferred Request from EMR Task) {b}Definition:
A reference from one resource to another.


Comments:
The data is defined where the transaction type is defined. The transaction data is always included in the bundle that is the full message. Only the root resource is specified. The resources it references should be contained in the bundle but are not also listed here. Multiple repetitions are allowed to cater for merges and other situations with multiple focal targets.

This structure is derived from Shared Services Message Header

Summary

Mandatory: 5 elements
Must-Support: 8 elements
Fixed Value: 2 elements
Prohibited: 1 element

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element MessageHeader.meta.profile is sliced based on the value of value:value

Differential View

This structure is derived from Shared Services Message Header

NameFlagsCard.TypeDescription & Constraintsdoco
.. MessageHeader S0..*Shared Services Message HeaderA resource that describes a message that is exchanged between systems
... meta S1..1MetaMetadata about the resource
.... profile S1..1(Slice Definition)Profiles this resource claims to conform to
Slice: Unordered, Open by value:value
..... profile:profile S1..1uriProfiles this resource claims to conform to
Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/interaction-messageheader-401
... event S1..1CodingCode for the event this message represents
.... code S1..1codeSymbol in syntax defined by the system
Fixed Value: 401
... response 0..0
... source
.... endpoint S1..1uriActual message source address or id
... destination S1..1BackboneElementMessage Destination Application(s)
... data S1..*Reference(PrescribeIT® Deferred Request from EMR Task) {b}A reference from one resource to another

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. MessageHeader SΣ0..*Shared Services Message HeaderA resource that describes a message that is exchanged between systems
... id SΣ1..1idLogical id of this artifact
... meta SΣ1..1MetaMetadata about the resource
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... versionId Σ0..1idVersion specific identifier
.... lastUpdated Σ0..1instantWhen the resource version last changed
.... profile SΣ1..1(Slice Definition)Profiles this resource claims to conform to
Slice: Unordered, Open by value:value
..... profile:profile SΣ1..1uriProfiles this resource claims to conform to

Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/interaction-messageheader-401
.... security Σ0..*CodingSecurity Labels applied to this resource
Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.


.... tag Σ0..*CodingTags applied to this resource
Binding: (unbound) (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones"


... 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
... timestamp SΣ1..1instantTime that the message was sent
... event ?!SΣ1..1CodingCode for the event this message represents
Binding: SharedMessageEvents (20190415) (preferred)
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... system SΣ1..1uriIdentity of the terminology system
Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedmessageevents
.... version Σ0..1stringVersion of the system - if relevant
.... code SΣ1..1codeSymbol in syntax defined by the system
Fixed Value: 401
.... display Σ0..1stringRepresentation defined by the system
.... userSelected Σ0..1booleanIf this coding was chosen directly by the user
... source SΣ1..1BackboneElementMessage Source Application
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
.... ext-messageheader-application-id S1..1uriSending application id
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-messageheader-application-id
.... ext-messageheader-conformance-version S1..1stringConformance version
URL: http://sharedhealth.exchange/fhir/StructureDefinition/ext-messageheader-conformance-version
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... name SΣ0..1stringName of system
.... software SΣ1..1stringName of software running the system
.... version SΣ1..1stringVersion of software running
.... contact Σ0..1ContactPointHuman contact for problems
.... endpoint SΣ1..1uriActual message source address or id
... destination SΣ1..1BackboneElementMessage Destination Application(s)
.... id 0..1idxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... name Σ0..1stringName of system
.... target Σ0..1Reference(Device)Particular delivery destination within the destination
.... endpoint SΣ1..1uriActual destination address or id
... enterer Σ0..1Reference(Practitioner)The source of the data entry
... author Σ0..1Reference(Practitioner)The source of the decision
... receiver Σ0..1Reference(Practitioner | Organization)Intended "real-world" recipient for the data
... responsible Σ0..1Reference(Practitioner | Organization)Final responsibility for event
... reason Σ0..1CodeableConceptCause of event
Binding: Example Message Reason Codes (example): Reason for event occurrence

... data SΣ1..*Reference(PrescribeIT® Deferred Request from EMR Task) {b}A reference from one resource to another

doco Documentation for this format

 

Other representations of profile: Schematron

Terminology Bindings

PathConformanceValueSet
MessageHeader.meta.securityextensibleAll Security Labels
MessageHeader.meta.tagexample
MessageHeader.languagerequiredhttp://tools.ietf.org/html/bcp47
MessageHeader.eventpreferredFixed Value: 401
MessageHeader.response.coderequiredResponseType
MessageHeader.reasonexampleExample Message Reason Codes

Constraints

IdPathDetailsRequirements