3.66 StructureDefinition: Interaction Bundle 999 - Generic eRx Asynchronous Reject
The official URL for this profile is:
http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999
This message is used when a destination endpoint identifies that an error occurred 'asynchronously'. An error detected synchronously will be reported as HTTP 4xx or 5xx series, with an operation outcome.
An asynchronous example business scenario would be that a destination pharmacy is registered for 'fax only' and the fax delivery function failed. PrescribeIT™ would create a '999' message and post it to the source sender's inbox, so they are aware that their request was not delivered successfully.
A '999' may also be created by the recipient of the message (PMS or Physician office/EMR). If the receiving system determines that they are unable to parse the message, or if they have a business issue (i.e. patient not found) they will create a '999' message and send it to the PrescribeIT™. The message will post the '999' to the appropriate inbox. The originator will receive the '999' when they poll their inbox.
PrescribeIT™ also creates a ‘999’ during the ‘Aged process’. If a message was delivered through the polling process, but the receiver never ‘acknowledged’ receipt of it, then PrescribeIT™ will create a ‘999’ indicating to the original sender, that the message was not delivered.
The Operation Outcome resource is available to describe the error encountered. Within 'issue' there is the ability to provide a severity and high level error code (that are constrained by binding value sets), but the description will be provided as 'text'.
3.66.2 Formal Views of Profile Content
Download Excel representation
Description of Profiles, Differentials, Snapshots and how the different presentations work.
>
This structure is derived from Shared Health Bundle for Messages
| Name | Card. | Type | Constraints and Usage |
|---|---|---|---|
 Bundle | 0..* | bdl-2: entry.search only when a search bdl-1: total only when a search or history bdl-7: FullUrl must be unique in a bundle, or else entries with the same fullUrl must have different meta.versionId bdl-3: entry.request only for some types of bundles bdl-4: entry.response only for some types of bundles headerExists: First entry must be a MessageHeader messageis999: First entry must be a MessageHeader with the messageheader-999 profile OperationOutcome2nd: Second entry must be an OperationOutcome Definition: A container for a collection of resources. | |
 id | 0..1 | id | Definition: 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 PrescribeIT™ system upon receipt of a bundle and returned synchronously in the response to that bundle. This ID should not be confused with the traceID that is also returned in the response and is generally used when diagnosing message failures within the PrescribeIT™ system logs. The Bundle.id is also used by receiving systems to remove the bundle from their inbox after they have successfully retrieved the bundle. |
| meta | 1..1 | Meta | Definition: 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. |
 profile | 1..* | uri | Slice: 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 (BaseProfile) | 1..1 | uri | Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/profile-bundle-message 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://sharedhealth.exchange/fhir/StructureDefinition/profile-bundle-message |
| profile (MessageProfile) | 1..1 | uri | Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999 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://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999 |
| tag | 1..* | Coding | Slice: Unordered, Open by value:system Binding: (unbound) (example) Definition: Tags applied to this resource. Tags are intended to be used to identify and relate resources to process and workflow, and applications are not required to consider the tags when interpreting the meaning of a resource. Comments: The tags can be updated without changing the stated version of the resource. The list of tags is a set. Uniqueness is based the system/code, and version and display are ignored. |
 tag(version) | 1..1 | Coding | Binding: SharedSpecificationVersion (required) Definition: Tags applied to this resource. Tags are intended to be used to identify and relate resources to process and workflow, and applications are not required to consider the tags when interpreting the meaning of a resource. Comments: Usage Note: This the version of the specification the Bundle claims to be conformant with. |
  system | 1..1 | uri | Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion 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/sharedspecificationversion |
 code | 1..1 | code | Fixed Value: Shared2.0 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: Shared2.0 |
| type | 1..1 | code | Binding: BundleType (required) Fixed Value: message Definition: Indicates the purpose of this bundle- how it was intended to be used. Comments: Fixed value: message |
| entry | 2..2 | BackboneElement | bdl-5: must be a resource unless there's a request or response bdl-6: The fullUrl element must be present when a resource is present, and not present otherwise Definition: An entry in a bundle resource - will either contain a resource, or information about a resource (transactions and history only). |
| fullUrl | 1..1 | uri | Definition: The Absolute URL for the resource. The fullUrl SHALL not disagree with the id in the resource. The fullUrl is a version independent reference to the resource. The fullUrl element SHALL have a value except that: * fullUrl can be empty on a POST (although it does not need to when specifying a temporary id for reference in the bundle) * Results from operations might involve resources that are not identified. Comments: fullUrl may not be unique in the context of a resource. Note that since FHIR resources do not need to be served through the FHIR API, the absolute URL may not end with the logical id of the resource (Resource.id), but if the fullUrl does look like a RESTful server URL (e.g. meets the regex, then it SHALL end with the Resource.id. |
| resource | 1..1 | Resource | Definition: The Resources for the entry. |
This structure is derived from Shared Health Bundle for Messages
Summary
Mandatory: 4 elements
Must-Support: 6 elements
Fixed Value: 2 elements
Slices
This structure defines the following Slices:
- The element Bundle.meta.profile is sliced based on the value of value:value
This structure is derived from Shared Health Bundle for Messages
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
 Bundle | SI | 0..* | messageis999: First entry must be a MessageHeader with the messageheader-999 profile OperationOutcome2nd: Second entry must be an OperationOutcome | |
| meta | S | 1..1 | Meta | |
 profile | S | uri | Slice: Unordered, Open by value:value | |
| profile | S | 1..1 | uri | Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999 |
| tag | S | 1..1 | Coding | |
| code | S | 1..1 | code | Fixed Value: Shared2.0 |
| entry | S | 2..2 | BackboneElement | |
| Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| Bundle | SΣI | 0..* | Contains a collection of resources messageis999: First entry must be a MessageHeader with the messageheader-999 profile OperationOutcome2nd: Second entry must be an OperationOutcome | |
 id | SΣ | 0..1 | id | Logical id of this artifact |
 meta | SΣ | 1..1 | Meta | Metadata about the resource |
| id | 0..1 | id | xml:id (or equivalent in JSON) | |
 extension | 0..* | Extension | Additional Content defined by implementations | |
| versionId | Σ | 0..1 | id | Version specific identifier |
| lastUpdated | Σ | 0..1 | instant | When the resource version last changed |
| profile | SΣ | uri | Profiles this resource claims to conform to Slice: Unordered, Open by value:value | |
| profile | SΣ | 1..1 | uri | Profiles this resource claims to conform to Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/profile-bundle-message |
| profile | SΣ | 1..1 | uri | Profiles this resource claims to conform to Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999 |
| security | Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible) |
| tag | SΣ | Coding | Tags applied to this resource Slice: Unordered, Open by value:system Binding: (unbound) (example) | |
| tag | SΣ | 1..1 | Coding | Tags applied to this resource Binding: SharedSpecificationVersion (required) |
| id | 0..1 | id | xml:id (or equivalent in JSON) | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| system | SΣ | 1..1 | uri | Identity of the terminology system Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion |
| version | Σ | 0..1 | string | Version of the system - if relevant |
| code | SΣ | 1..1 | code | Symbol in syntax defined by the system Fixed Value: Shared2.0 |
| display | Σ | 0..1 | string | Representation defined by the system |
| userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user |
| implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
| language | 0..1 | code | Language of the resource content Binding: http://tools.ietf.org/html/bcp47 (required) | |
| type | SΣ | 1..1 | code | document | message | transaction | transaction-response | batch | batch-response | history | searchset | collection Binding: BundleType (required) Fixed Value: message |
| total | ΣI | 0..1 | unsignedInt | If search, the total number of matches |
| link | Σ | 0..* | BackboneElement | Links related to this Bundle |
| id | 0..1 | id | xml:id (or equivalent in JSON) | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
 modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored |
| relation | Σ | 1..1 | string | http://www.iana.org/assignments/link-relations/link-relations.xhtml |
| url | Σ | 1..1 | uri | Reference details for the link |
| entry | SΣI | 2..2 | BackboneElement | Entry in the bundle - will have a resource, or information |
| id | 0..1 | id | xml:id (or equivalent in JSON) | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored |
| fullUrl | SΣ | 1..1 | uri | Absolute URL for resource (server address, or UUID/OID) |
 resource | SΣ | 1..1 | Resource | A resource in the bundle |
| signature | Σ | 0..1 | Signature | Digital Signature |
| Documentation for this format | ||||
Grid View
This structure is derived from Shared Health Bundle for Messages
| Name | Card. | Type | Constraints and Usage |
|---|---|---|---|
| Bundle | 0..* | bdl-2: entry.search only when a search bdl-1: total only when a search or history bdl-7: FullUrl must be unique in a bundle, or else entries with the same fullUrl must have different meta.versionId bdl-3: entry.request only for some types of bundles bdl-4: entry.response only for some types of bundles headerExists: First entry must be a MessageHeader messageis999: First entry must be a MessageHeader with the messageheader-999 profile OperationOutcome2nd: Second entry must be an OperationOutcome Definition: A container for a collection of resources. | |
| id | 0..1 | id | Definition: 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 PrescribeIT™ system upon receipt of a bundle and returned synchronously in the response to that bundle. This ID should not be confused with the traceID that is also returned in the response and is generally used when diagnosing message failures within the PrescribeIT™ system logs. The Bundle.id is also used by receiving systems to remove the bundle from their inbox after they have successfully retrieved the bundle. |
| meta | 1..1 | Meta | Definition: 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. |
| profile | 1..* | uri | Slice: 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 (BaseProfile) | 1..1 | uri | Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/profile-bundle-message 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://sharedhealth.exchange/fhir/StructureDefinition/profile-bundle-message |
| profile (MessageProfile) | 1..1 | uri | Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999 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://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999 |
| tag | 1..* | Coding | Slice: Unordered, Open by value:system Binding: (unbound) (example) Definition: Tags applied to this resource. Tags are intended to be used to identify and relate resources to process and workflow, and applications are not required to consider the tags when interpreting the meaning of a resource. Comments: The tags can be updated without changing the stated version of the resource. The list of tags is a set. Uniqueness is based the system/code, and version and display are ignored. |
| tag (version) | 1..1 | Coding | Binding: SharedSpecificationVersion (required) Definition: Tags applied to this resource. Tags are intended to be used to identify and relate resources to process and workflow, and applications are not required to consider the tags when interpreting the meaning of a resource. Comments: Usage Note: This the version of the specification the Bundle claims to be conformant with. |
| system | 1..1 | uri | Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion 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/sharedspecificationversion |
| code | 1..1 | code | Fixed Value: Shared2.0 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: Shared2.0 |
| type | 1..1 | code | Binding: BundleType (required) Fixed Value: message Definition: Indicates the purpose of this bundle- how it was intended to be used. Comments: Fixed value: message |
| entry | 2..2 | BackboneElement | bdl-5: must be a resource unless there's a request or response bdl-6: The fullUrl element must be present when a resource is present, and not present otherwise Definition: An entry in a bundle resource - will either contain a resource, or information about a resource (transactions and history only). |
| fullUrl | 1..1 | uri | Definition: The Absolute URL for the resource. The fullUrl SHALL not disagree with the id in the resource. The fullUrl is a version independent reference to the resource. The fullUrl element SHALL have a value except that: * fullUrl can be empty on a POST (although it does not need to when specifying a temporary id for reference in the bundle) * Results from operations might involve resources that are not identified. Comments: fullUrl may not be unique in the context of a resource. Note that since FHIR resources do not need to be served through the FHIR API, the absolute URL may not end with the logical id of the resource (Resource.id), but if the fullUrl does look like a RESTful server URL (e.g. meets the regex, then it SHALL end with the Resource.id. |
| resource | 1..1 | Resource | Definition: The Resources for the entry. |
This structure is derived from Shared Health Bundle for Messages
Summary
Mandatory: 4 elements
Must-Support: 6 elements
Fixed Value: 2 elements
Slices
This structure defines the following Slices:
- The element Bundle.meta.profile is sliced based on the value of value:value
Differential View
This structure is derived from Shared Health Bundle for Messages
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| Bundle | SI | 0..* | messageis999: First entry must be a MessageHeader with the messageheader-999 profile OperationOutcome2nd: Second entry must be an OperationOutcome | |
| meta | S | 1..1 | Meta | |
| profile | S | uri | Slice: Unordered, Open by value:value | |
| profile | S | 1..1 | uri | Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999 |
| tag | S | 1..1 | Coding | |
| code | S | 1..1 | code | Fixed Value: Shared2.0 |
| entry | S | 2..2 | BackboneElement | |
| Documentation for this format | ||||
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints |
|---|---|---|---|---|
| Bundle | SΣI | 0..* | Contains a collection of resources messageis999: First entry must be a MessageHeader with the messageheader-999 profile OperationOutcome2nd: Second entry must be an OperationOutcome | |
| id | SΣ | 0..1 | id | Logical id of this artifact |
| meta | SΣ | 1..1 | Meta | Metadata about the resource |
| id | 0..1 | id | xml:id (or equivalent in JSON) | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| versionId | Σ | 0..1 | id | Version specific identifier |
| lastUpdated | Σ | 0..1 | instant | When the resource version last changed |
| profile | SΣ | uri | Profiles this resource claims to conform to Slice: Unordered, Open by value:value | |
| profile | SΣ | 1..1 | uri | Profiles this resource claims to conform to Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/profile-bundle-message |
| profile | SΣ | 1..1 | uri | Profiles this resource claims to conform to Fixed Value: http://sharedhealth.exchange/fhir/StructureDefinition/interaction-bundle-999 |
| security | Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible) |
| tag | SΣ | Coding | Tags applied to this resource Slice: Unordered, Open by value:system Binding: (unbound) (example) | |
| tag | SΣ | 1..1 | Coding | Tags applied to this resource Binding: SharedSpecificationVersion (required) |
| id | 0..1 | id | xml:id (or equivalent in JSON) | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| system | SΣ | 1..1 | uri | Identity of the terminology system Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/sharedspecificationversion |
| version | Σ | 0..1 | string | Version of the system - if relevant |
| code | SΣ | 1..1 | code | Symbol in syntax defined by the system Fixed Value: Shared2.0 |
| display | Σ | 0..1 | string | Representation defined by the system |
| userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user |
| implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created |
| language | 0..1 | code | Language of the resource content Binding: http://tools.ietf.org/html/bcp47 (required) | |
| type | SΣ | 1..1 | code | document | message | transaction | transaction-response | batch | batch-response | history | searchset | collection Binding: BundleType (required) Fixed Value: message |
| total | ΣI | 0..1 | unsignedInt | If search, the total number of matches |
| link | Σ | 0..* | BackboneElement | Links related to this Bundle |
| id | 0..1 | id | xml:id (or equivalent in JSON) | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored |
| relation | Σ | 1..1 | string | http://www.iana.org/assignments/link-relations/link-relations.xhtml |
| url | Σ | 1..1 | uri | Reference details for the link |
| entry | SΣI | 2..2 | BackboneElement | Entry in the bundle - will have a resource, or information |
| id | 0..1 | id | xml:id (or equivalent in JSON) | |
| extension | 0..* | Extension | Additional Content defined by implementations | |
| modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored |
| fullUrl | SΣ | 1..1 | uri | Absolute URL for resource (server address, or UUID/OID) |
| resource | SΣ | 1..1 | Resource | A resource in the bundle |
| signature | Σ | 0..1 | Signature | Digital Signature |
| Documentation for this format | ||||
Other representations of profile: Schematron
3.66.3 Terminology Bindings
Terminology Bindings
| Path | Name | Conformance | ValueSet |
| Bundle.meta.security | All Security Labels | extensible | All Security Labels |
| Bundle.meta.tag | SharedSpecificationVersion | required | SharedSpecificationVersion |
| Bundle.meta.tag | SharedSpecificationVersion | required | SharedSpecificationVersion |
| Bundle.language | ?ext | required | http://tools.ietf.org/html/bcp47 |
| Bundle.type | BundleType | required | BundleType |
| Bundle.entry.search.mode | SearchEntryMode | required | SearchEntryMode |
| Bundle.entry.request.method | HTTPVerb | required | HTTPVerb |
3.66.4 Constraints
Constraints
| Id | Path | Details | Requirements |
| bdl-2 | Bundle | entry.search only when a search : entry.search.empty() or (type = 'searchset') | |
| bdl-1 | Bundle | total only when a search or history : total.empty() or (type = 'searchset') or (type = 'history') | |
| bdl-7 | Bundle | FullUrl must be unique in a bundle, or else entries with the same fullUrl must have different meta.versionId : entry.where(fullUrl).select(fullUrl&resource.meta.versionId).isDistinct() | |
| bdl-3 | Bundle | entry.request only for some types of bundles : entry.request.empty() or type = 'batch' or type = 'transaction' or type = 'history' | |
| bdl-4 | Bundle | entry.response only for some types of bundles : entry.response.empty() or type = 'batch-response' or type = 'transaction-response' | |
| headerExists | Bundle | First entry must be a MessageHeader : entry[0].resource.is(MessageHeader) | |
| messageis999 | Bundle | First entry must be a MessageHeader with the messageheader-999 profile : entry[0].resource.meta.where(profile='http://sharedhealth.exchange/fhir/StructureDefinition/interaction-messageheader-999').exists() | |
| OperationOutcome2nd | Bundle | Second entry must be an OperationOutcome : entry[1].resource.is(OperationOutcome) | |
| bdl-5 | Bundle.entry | must be a resource unless there's a request or response : resource.exists() or request.exists() or response.exists() | |
| bdl-6 | Bundle.entry | The fullUrl element must be present when a resource is present, and not present otherwise : fullUrl.empty() xor resource.exists() |