3.114 StructureDefinition: Task e163-m - RX Renewal Response - Approved with Changes
The official URL for this profile is:
http://prescribeit.ca/fhir/StructureDefinition/task-e163-m
The e163-m - RX Renewal Response - Approved with Changes task can be provided as part of two bundle types:
- 101 Interaction Bundle
- The 101 bundles will be directed to a specific pharmacy and placed directly in the pharmacy’s inbox for retrieval
- This applies to jurisdictions that allow directed retrieval from the pharmacy
- 401 Interaction Bundle
- The 401 bundles will be used for held bundles which requires the pharmacy user to initiate the retrieval of these bundles
- This applies to jurisdictions where direct retrieval is not supported and a hold and retrieve flow is being used for authoritative tasks instead
Refer to the functional specification documents to understand which jurisdiction(s) each is applicable for
The following diagram depicts the overall structure of an Approve with Changes RX Renewal Response and the relationships between resources. The diagrams are only showing the possible types of resources but that the GridView reflects the true relationships. Each medication in the Renewal request MUST be responded to with either, a Denied, Approved, Approved with Changes or Under Review in the initial response. Further the Renewal response bundle MAY include one or more New or Renewal RX orders.
Conformance Rules and Usage Notes specific to this task may exist.
The new medication order being provided in the Approved with Change Renewal Request Response reflects a continuation of the therapy from the previous prescription with some clinically significant changes. The pharmacy should carefully examine the new approved with change order because what needs to be dispensed will be different from the last time they dispensed the medication.
3.114.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 PrescribeIT® Response from EMR Task
Name | Card. | Type | Constraints and Usage |
---|---|---|---|
Task | 0..* | PrescribeIT® Response from EMR Task | inv-2: A Failure reason may be present only when a task has failed. inv-1: Last modified date must be greater than or equal to created date. Definition: A task to be performed. |
id | 1..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 will usually be a GUID and is assigned by the sending application. |
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. |
profile (task-e163-m) | 1..1 | uri | Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/task-e163-m 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/task-e163-m |
extension | 0..* | Extension | Slice: Unordered, Open by value:url Definition: An Extension |
extension (groupIdentifier) | 1..1 | Task Group Identifier | Definition: This is the common identifier that represents a paper order. It may be shared by multiple Task instances for various Medication Orders, reflecting multiple requests that are authorized simultaneously for a patient by a single prescriber Comments: Usage Note: This business identifier is assigned by the sending application and is used to group tasks together that need to be processed and managed together. Refer to the PrescribeIT® Version 5.0 Jurisdictional Rules and Task Grouping Excel spreadsheet rules for a full set of scenarios. |
extension (basedOn) | 1..1 | Task Order Based On | Definition: Identifies a request, plan or proposal that drove the creation of this task Comments: Usage Note: The URL for this extension does not refer to an existing web-page as is a pre-adoption extension. Refer to the Shared Health implementation Guide for more information. |
url | 1..1 | uri | "http://hl7.org/fhir/StructureDefinition/extension-Task.basedOn" |
value[x] | 1..1 | Reference() | Slice: Unordered, Closed by type:$this Definition: The identifier of the request task that this task was created based on Comments: Conformance Rule: The will be a URN (form urn:uuid:[guid]) containing the Task.id for the task being responded to |
value[x] (valueReference) | 1..1 | Reference() {r} | Definition: Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list). Comments: Conformance Rule: The will be a URN (form urn:uuid:[guid]) containing the Task.id for the task being responded to |
extension | 0..* | Extension | Slice: Unordered, Open by value:url Definition: An Extension |
extension (multipleResponse) | 0..1 | Task Multiple Response | Definition: If true, indicates that this renewal response is a subsequent response of an initial response that was sent as 'under review'. Comments: Conformance Rules:
|
reference | 1..1 | string | Definition: A 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. Comments: Conformance Rule: This shall be the Task.id of the request task being responded to, expressed as a uri (i.e. urn:uuid:[original task id]) |
modifierExtension (doNotAutofill) | 0..1 | Task Do Not Auto-fill | Definition: A modifier extension that, if true, indicates that a task that would normally be interpretted as seeking the immediate fulfillment of a request is not seeking fulfillment, but is merely sharing the authoritative order. The fulfillment request will arrive by other means |
type | 1..1 | Shared Health CodeableConcept Code | Binding: PrescriptionTaskType (20220913) (required) Definition: A concept that may be defined by a formal reference to a terminology or ontology or may be provided by text. Comments: This will be a fixed code for each type of task. Review usage comments on child elements. |
coding | 1..* | Coding | Slice: Unordered, Open by value:system Definition: A reference to a code defined by a terminology system. Comments: Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labelled as UserSelected = true. |
system | 1..1 | uri | Definition: The identification of the code system that defines the meaning of the symbol in the code. Comments: This is the URI that represents the coding system as defined within the binding. |
code | 1..1 | code | 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: This is the code as defined within the binding. |
display | 0..1 | string | Definition: A representation of the meaning of the code in the system, following the rules of the system. |
coding (taskCode) | 1..* | Coding | Definition: A reference to a code defined by a terminology system. Comments: Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labelled as UserSelected = true. |
system | 1..1 | uri | Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/prescriptiontasktype 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/prescriptiontasktype |
code | 1..1 | code | Fixed Value: e163-m 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: e163-m |
display | 0..1 | string | Definition: A representation of the meaning of the code in the system, following the rules of the system. |
priority | 0..1 | code | Binding: PrescriptionTaskPriority (20190415) (required) Definition: The priority of the task among other tasks of the same type. Comments: This element does not apply to Tasks p170-m (Pharmacist Adapt), p200-m (RX Dispense Notification), and p210-m (RX Dispense Cancel Notification) Conformance Rule: If one of the medications within a group is a high priority, the EMR should present the entire renewal request (based on Group Identifier) as a high priority item within the queue. Conformance Rule: For Tasks p141-m (Cancel RX Request Denied) and p143-m (Cancel RX Remaining Fills Revoked) the priority must be set to high. Usage Note: For Task e150-m (Discontinue RX Request) the priority should default to normal. |
status | 1..1 | code | Binding: TaskStatus (required): The current status of the task. Fixed Value: requested Definition: The current status of the task. Comments: Fixed value: requested |
subject | 1..1 | Reference(PrescribeIT® Renewal Prescription) {b} | Definition: The subject of the task. |
reference | 1..1 | string | Definition: A 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. Comments: Conformance Rule: This is the reference to the Medication Order resource id. This is not a business identifier. Example: value='MedicationOrder/[guid].' Conformance Rule: The Medication Order reference must be for the Medication Order that is being Approved or Approved with Changes by the prescriber. |
for | 1..1 | Reference(Shared Health Patient) {b} | Definition: The entity who benefits from the performance of the service specified in the task (e.g., the patient). Comments: Identifies the patient tied to the task. (FHIR prohibits inheritance of context, so this must be explicitly declared rather than inferred from the presence of the Patient resource in the message) |
reference | 1..1 | string | Definition: A 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. Comments: This is a reference to the Patient associated with the task. It will be a URN pointing to the id of the patient record in the message |
created | 1..1 | dateTime | created-full: Must be at least a full date. i.e. yyyy-mm-dd Definition: The date and time this task was created. Comments: This indicates when the request was created. This will generally be the same as the date of message construction. Conformance Rule: Date-Time must be specified down to the day. Time is optional and may be ignored. Usage Note: If time is present, FHIR requires the UTC offset and for time to be specified down to the seconds. If seconds aren't available, they may be filled with '00' |
lastModified | 1..1 | dateTime | lastModified-full: Must be at least a full date. i.e. yyyy-mm-dd Definition: The date and time of last modification to this task. Comments: This is required by FHIR but is not needed. It should generally be set to the same value as Task.created. This is the date of the most recent transaction as recorded in the EMR. Usage Note: If time is present, FHIR requires the UTC offset and for time to be specified down to the seconds. If seconds aren't available, they may be filled with '00'. Conformance Rule: PMS is not expected to display this date as it is irrelevant to the Pharmacist or to the processing of the discontinue notification. |
creator | 1..1 | Reference(Shared Health SAML Practitioner) {b} | Definition: The creator of the task. Comments: This is who is submitting the task and asking for it be done. In the context of all EMR message this will be the PrescribeIT® Prescriber that responsible for initiating or overseeing the clinical event in the message. |
reference | 1..1 | string | Definition: A 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. Comments: This is a reference to the originating prescriber Practitioner. This value will be returned from the Provider Registry Practitioner query. Example: value='https://{environmentSpecificHost}/{environmentAndContextSpecificPath}/Practitioner/{CPRID}' |
owner | 1..1 | Reference(Shared Health - eRx Service Location) {b} | Definition: The owner of this task. The participant who can execute this task. Comments: This is who is intended to receive/act on the task |
reference | 1..1 | string | Definition: A 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. Comments: This is a reference to the pharmacy Organization being responded to. This value should echo the Task.creator from the request task being responded to. Example: value='https://{environmentSpecificHost}/{environmentAndContextSpecificPath}/Organization/{CPRID}' |
input | 0..1 | BackboneElement | Slice: Unordered, Closed by value:name Definition: Inputs to the task. |
input (change) | 1..1 | BackboneElement | Definition: Inputs to the task. |
name | 1..1 | string | Fixed Value: change Definition: The name of the input parameter. Comments: Fixed value: change |
value[x] | 1..1 | string | Definition: This is a textual description of the changes, eg change. This would be a substantive change such as a change in dose, frequency or patient instructions, or a change of classification of drugs. This will be specified as needed and if included in the message, this should be displayed to the Pharmacist/Pharmacy Technician Comments: Conformance Rule: EMR expected to call out a difference in dosing, if they notice a difference in the request, versus what is in the EMR. A difference in the quantity or number of refills does not constitute changes |
This structure is derived from PrescribeIT® Response from EMR Task
Summary
Mandatory: 14 elements
Must-Support: 18 elements
Fixed Value: 5 elements
Prohibited: 1 element
Structures
This structure refers to these other structures:
- http://prescribeit.ca/fhir/StructureDefinition/profile-medicationorder-renew
- http://sharedhealth.exchange/fhir/StructureDefinition/profile-practitioner-saml
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
- The element Task.meta.profile is sliced based on the value of value:value
- The element Task.type.coding is sliced based on the value of value:system
- The element Task.input is sliced based on the value of value:name (Closed)
This structure is derived from PrescribeIT® Response from EMR Task
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Task | 0..* | PrescribeIT® Response from EMR Task | RX Renewal Response - Approved with Changes | |
meta | S | 1..1 | Meta | Metadata about the resource |
profile | S | 1..* | (Slice Definition) | Profiles this resource claims to conform to Slice: Unordered, Open by value:value |
profile:task-e163-m | S | 1..1 | uri | Profiles this resource claims to conform to Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/task-e163-m |
modifierExtension:doNotAutofill | S | 0..1 | Task Do Not Auto-fill | Task Do Not Fill? |
type | S | 1..1 | Shared Health CodeableConcept Code | Concept - reference to a terminology or just text |
coding | S | 1..* | (Slice Definition) | Code defined by a terminology system Slice: Unordered, Open by value:system |
coding:taskCode | S | 1..* | Coding | Code defined by a terminology system |
system | S | 1..1 | uri | Identity of the terminology system Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/prescriptiontasktype |
code | S | 1..1 | code | Symbol in syntax defined by the system Fixed Value: e163-m |
status | S | 1..1 | code | draft | requested | received | accepted | + Fixed Value: requested |
subject | S | 1..1 | Reference(PrescribeIT® Renewal Prescription) {b} | Renewal prescription |
reference | S | 1..1 | string | Relative, internal or absolute URL reference |
creator | S | 1..1 | Reference(Shared Health SAML Practitioner) {b} | Task requestor |
reference | S | 1..1 | string | Relative, internal or absolute URL reference |
input | S | 0..1 | (Slice Definition) | Task Input Slice: Unordered, Closed by value:name |
input:change | S | 1..1 | BackboneElement | Task Input |
name | S | 1..1 | string | Input Name Fixed Value: change |
value[x] | S | 1..1 | string | How has prescription changed? |
output | 0..0 | |||
Documentation for this format |
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Task | I | 0..* | PrescribeIT® Response from EMR Task | RX Renewal Response - Approved with Changes |
id | SΣ | 1..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Σ | 1..* | (Slice Definition) | Profiles this resource claims to conform to Slice: Unordered, Open by value:value |
profile:task-e163-m | SΣ | 1..1 | uri | Profiles this resource claims to conform to Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/task-e163-m |
tag | Σ | 0..* | Coding | Tags 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..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): A human language. | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | S | 0..* | Extension | Extension Slice: Unordered, Open by value:url |
ext-task-group-identifier | S | 1..1 | Shared Health Identifier | Group Identifier URL: http://hl7.org/fhir/StructureDefinition/extension-Task.groupIdentifier profiled by http://prescribeit.ca/fhir/StructureDefinition/ext-task-group-identifier |
ext-task-basedon | S | 1..1 | Reference() | Plan, request or referral URL: http://hl7.org/fhir/StructureDefinition/extension-Task.basedOn profiled by http://prescribeit.ca/fhir/StructureDefinition/ext-task-basedon |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
url | S | 1..1 | uri | "http://hl7.org/fhir/StructureDefinition/extension-Task.basedOn" |
value[x] | S | 1..1 | (Slice Definition) | e-Renewal request Slice: Unordered, Closed by type:$this |
value[x]:valueReference | S | 1..1 | Reference() {r} | Value of extension |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | S | 0..* | Extension | Extension Slice: Unordered, Open by value:url |
ext-task-multiple-response | S | 0..1 | boolean | Task Multiple Response? URL: http://prescribeit.ca/fhir/StructureDefinition/ext-task-multiple-response |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
modifierExtension | ?! | 0..* | (Slice Definition) | Extension Slice: Unordered, Open by value:url |
modifierExtension:doNotAutofill | ?!S | 0..1 | Task Do Not Auto-fill | Task Do Not Fill? |
identifier | 0..1 | Identifier | Task Instance Identifier | |
type | S | 1..1 | Shared Health CodeableConcept Code | Concept - reference to a terminology or just text Binding: PrescriptionTaskType (20220913) (required) |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
coding | SΣ | 1..* | (Slice Definition) | Code defined by a terminology system Slice: Unordered, Open by value:system |
coding:All Slices | Content/Rules for all slices | |||
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 |
version | Σ | 0..1 | string | Version of the system - if relevant |
code | SΣ | 1..1 | code | Symbol in syntax defined by the system |
display | SΣ | 0..1 | string | Representation defined by the system |
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user |
coding:taskCode | SΣ | 1..* | Coding | Code defined by a terminology system |
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/prescriptiontasktype |
version | Σ | 0..1 | string | Version of the system - if relevant |
code | SΣ | 1..1 | code | Symbol in syntax defined by the system Fixed Value: e163-m |
display | SΣ | 0..1 | string | Representation defined by the system |
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user |
text | Σ | 0..1 | string | Plain text representation of the concept |
description | Σ | 0..1 | string | Task Description |
performerType | 0..* | Coding | requester | dispatcher | scheduler | performer | monitor | manager | acquirer | reviewer Binding: TaskPerformerType (preferred): The type(s) of task performers allowed | |
priority | S | 0..1 | code | normal | high Binding: PrescriptionTaskPriority (20190415) (required) |
status | SΣI | 1..1 | code | draft | requested | received | accepted | + Binding: TaskStatus (required): The current status of the task. Fixed Value: requested |
failureReason | ΣI | 0..1 | CodeableConcept | Task Failure Reason |
subject | S | 1..1 | Reference(PrescribeIT® Renewal Prescription) {b} | Renewal prescription |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
for | SΣ | 1..1 | Reference(Shared Health Patient) {b} | Beneficiary of the Task |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
definition | Σ | 0..1 | uri | Task Definition |
created | SI | 1..1 | dateTime | Task Creation Date created-full: Must be at least a full date. i.e. yyyy-mm-dd |
lastModified | SΣI | 1..1 | dateTime | Task Last Modified Date lastModified-full: Must be at least a full date. i.e. yyyy-mm-dd |
creator | S | 1..1 | Reference(Shared Health SAML Practitioner) {b} | Task requestor |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
owner | S | 1..1 | Reference(Shared Health - eRx Service Location) {b} | Task recipient |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
parent | 0..1 | Reference(Task) | Composite task | |
input | S | 0..1 | (Slice Definition) | Task Input Slice: Unordered, Closed by value:name |
input:All Slices | Content/Rules for all slices | |||
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 |
name | 1..1 | string | Input Name | |
value[x] | 1..1 | Input Value | ||
valueBoolean | boolean | |||
valueInteger | integer | |||
valueDecimal | decimal | |||
valueBase64Binary | base64Binary | |||
valueInstant | instant | |||
valueString | string | |||
valueUri | uri | |||
valueDate | date | |||
valueDateTime | dateTime | |||
valueTime | time | |||
valueCode | code | |||
valueOid | oid | |||
valueId | id | |||
valueUnsignedInt | unsignedInt | |||
valuePositiveInt | positiveInt | |||
valueMarkdown | markdown | |||
valueAnnotation | Annotation | |||
valueAttachment | Attachment | |||
valueIdentifier | Identifier | |||
valueCodeableConcept | CodeableConcept | |||
valueCoding | Coding | |||
valueQuantity | Quantity | |||
valueRange | Range | |||
valuePeriod | Period | |||
valueRatio | Ratio | |||
valueSampledData | SampledData | |||
valueSignature | Signature | |||
valueHumanName | HumanName | |||
valueAddress | Address | |||
valueContactPoint | ContactPoint | |||
valueTiming | Timing | |||
valueReference | Reference(Any) | |||
valueMeta | Meta | |||
input:change | S | 1..1 | BackboneElement | Task Input |
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 |
name | S | 1..1 | string | Input Name Fixed Value: change |
value[x] | S | 1..1 | string | How has prescription changed? |
Documentation for this format |
Grid View
This structure is derived from PrescribeIT® Response from EMR Task
Name | Card. | Type | Constraints and Usage |
---|---|---|---|
Task | 0..* | PrescribeIT® Response from EMR Task | inv-2: A Failure reason may be present only when a task has failed. inv-1: Last modified date must be greater than or equal to created date. Definition: A task to be performed. |
id | 1..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 will usually be a GUID and is assigned by the sending application. |
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. |
profile (task-e163-m) | 1..1 | uri | Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/task-e163-m 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/task-e163-m |
extension | 0..* | Extension | Slice: Unordered, Open by value:url Definition: An Extension |
extension (groupIdentifier) | 1..1 | Task Group Identifier | Definition: This is the common identifier that represents a paper order. It may be shared by multiple Task instances for various Medication Orders, reflecting multiple requests that are authorized simultaneously for a patient by a single prescriber Comments: Usage Note: This business identifier is assigned by the sending application and is used to group tasks together that need to be processed and managed together. Refer to the PrescribeIT® Version 5.0 Jurisdictional Rules and Task Grouping Excel spreadsheet rules for a full set of scenarios. |
extension (basedOn) | 1..1 | Task Order Based On | Definition: Identifies a request, plan or proposal that drove the creation of this task Comments: Usage Note: The URL for this extension does not refer to an existing web-page as is a pre-adoption extension. Refer to the Shared Health implementation Guide for more information. |
url | 1..1 | uri | "http://hl7.org/fhir/StructureDefinition/extension-Task.basedOn" |
value[x] | 1..1 | Reference() | Slice: Unordered, Closed by type:$this Definition: The identifier of the request task that this task was created based on Comments: Conformance Rule: The will be a URN (form urn:uuid:[guid]) containing the Task.id for the task being responded to |
value[x] (valueReference) | 1..1 | Reference() {r} | Definition: Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list). Comments: Conformance Rule: The will be a URN (form urn:uuid:[guid]) containing the Task.id for the task being responded to |
extension | 0..* | Extension | Slice: Unordered, Open by value:url Definition: An Extension |
extension (multipleResponse) | 0..1 | Task Multiple Response | Definition: If true, indicates that this renewal response is a subsequent response of an initial response that was sent as 'under review'. Comments: Conformance Rules:
|
reference | 1..1 | string | Definition: A 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. Comments: Conformance Rule: This shall be the Task.id of the request task being responded to, expressed as a uri (i.e. urn:uuid:[original task id]) |
modifierExtension (doNotAutofill) | 0..1 | Task Do Not Auto-fill | Definition: A modifier extension that, if true, indicates that a task that would normally be interpretted as seeking the immediate fulfillment of a request is not seeking fulfillment, but is merely sharing the authoritative order. The fulfillment request will arrive by other means |
type | 1..1 | Shared Health CodeableConcept Code | Binding: PrescriptionTaskType (20220913) (required) Definition: A concept that may be defined by a formal reference to a terminology or ontology or may be provided by text. Comments: This will be a fixed code for each type of task. Review usage comments on child elements. |
coding | 1..* | Coding | Slice: Unordered, Open by value:system Definition: A reference to a code defined by a terminology system. Comments: Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labelled as UserSelected = true. |
system | 1..1 | uri | Definition: The identification of the code system that defines the meaning of the symbol in the code. Comments: This is the URI that represents the coding system as defined within the binding. |
code | 1..1 | code | 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: This is the code as defined within the binding. |
display | 0..1 | string | Definition: A representation of the meaning of the code in the system, following the rules of the system. |
coding (taskCode) | 1..* | Coding | Definition: A reference to a code defined by a terminology system. Comments: Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labelled as UserSelected = true. |
system | 1..1 | uri | Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/prescriptiontasktype 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/prescriptiontasktype |
code | 1..1 | code | Fixed Value: e163-m 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: e163-m |
display | 0..1 | string | Definition: A representation of the meaning of the code in the system, following the rules of the system. |
priority | 0..1 | code | Binding: PrescriptionTaskPriority (20190415) (required) Definition: The priority of the task among other tasks of the same type. Comments: This element does not apply to Tasks p170-m (Pharmacist Adapt), p200-m (RX Dispense Notification), and p210-m (RX Dispense Cancel Notification) Conformance Rule: If one of the medications within a group is a high priority, the EMR should present the entire renewal request (based on Group Identifier) as a high priority item within the queue. Conformance Rule: For Tasks p141-m (Cancel RX Request Denied) and p143-m (Cancel RX Remaining Fills Revoked) the priority must be set to high. Usage Note: For Task e150-m (Discontinue RX Request) the priority should default to normal. |
status | 1..1 | code | Binding: TaskStatus (required): The current status of the task. Fixed Value: requested Definition: The current status of the task. Comments: Fixed value: requested |
subject | 1..1 | Reference(PrescribeIT® Renewal Prescription) {b} | Definition: The subject of the task. |
reference | 1..1 | string | Definition: A 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. Comments: Conformance Rule: This is the reference to the Medication Order resource id. This is not a business identifier. Example: value='MedicationOrder/[guid].' Conformance Rule: The Medication Order reference must be for the Medication Order that is being Approved or Approved with Changes by the prescriber. |
for | 1..1 | Reference(Shared Health Patient) {b} | Definition: The entity who benefits from the performance of the service specified in the task (e.g., the patient). Comments: Identifies the patient tied to the task. (FHIR prohibits inheritance of context, so this must be explicitly declared rather than inferred from the presence of the Patient resource in the message) |
reference | 1..1 | string | Definition: A 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. Comments: This is a reference to the Patient associated with the task. It will be a URN pointing to the id of the patient record in the message |
created | 1..1 | dateTime | created-full: Must be at least a full date. i.e. yyyy-mm-dd Definition: The date and time this task was created. Comments: This indicates when the request was created. This will generally be the same as the date of message construction. Conformance Rule: Date-Time must be specified down to the day. Time is optional and may be ignored. Usage Note: If time is present, FHIR requires the UTC offset and for time to be specified down to the seconds. If seconds aren't available, they may be filled with '00' |
lastModified | 1..1 | dateTime | lastModified-full: Must be at least a full date. i.e. yyyy-mm-dd Definition: The date and time of last modification to this task. Comments: This is required by FHIR but is not needed. It should generally be set to the same value as Task.created. This is the date of the most recent transaction as recorded in the EMR. Usage Note: If time is present, FHIR requires the UTC offset and for time to be specified down to the seconds. If seconds aren't available, they may be filled with '00'. Conformance Rule: PMS is not expected to display this date as it is irrelevant to the Pharmacist or to the processing of the discontinue notification. |
creator | 1..1 | Reference(Shared Health SAML Practitioner) {b} | Definition: The creator of the task. Comments: This is who is submitting the task and asking for it be done. In the context of all EMR message this will be the PrescribeIT® Prescriber that responsible for initiating or overseeing the clinical event in the message. |
reference | 1..1 | string | Definition: A 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. Comments: This is a reference to the originating prescriber Practitioner. This value will be returned from the Provider Registry Practitioner query. Example: value='https://{environmentSpecificHost}/{environmentAndContextSpecificPath}/Practitioner/{CPRID}' |
owner | 1..1 | Reference(Shared Health - eRx Service Location) {b} | Definition: The owner of this task. The participant who can execute this task. Comments: This is who is intended to receive/act on the task |
reference | 1..1 | string | Definition: A 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. Comments: This is a reference to the pharmacy Organization being responded to. This value should echo the Task.creator from the request task being responded to. Example: value='https://{environmentSpecificHost}/{environmentAndContextSpecificPath}/Organization/{CPRID}' |
input | 0..1 | BackboneElement | Slice: Unordered, Closed by value:name Definition: Inputs to the task. |
input (change) | 1..1 | BackboneElement | Definition: Inputs to the task. |
name | 1..1 | string | Fixed Value: change Definition: The name of the input parameter. Comments: Fixed value: change |
value[x] | 1..1 | string | Definition: This is a textual description of the changes, eg change. This would be a substantive change such as a change in dose, frequency or patient instructions, or a change of classification of drugs. This will be specified as needed and if included in the message, this should be displayed to the Pharmacist/Pharmacy Technician Comments: Conformance Rule: EMR expected to call out a difference in dosing, if they notice a difference in the request, versus what is in the EMR. A difference in the quantity or number of refills does not constitute changes |
This structure is derived from PrescribeIT® Response from EMR Task
Summary
Mandatory: 14 elements
Must-Support: 18 elements
Fixed Value: 5 elements
Prohibited: 1 element
Structures
This structure refers to these other structures:
- http://prescribeit.ca/fhir/StructureDefinition/profile-medicationorder-renew
- http://sharedhealth.exchange/fhir/StructureDefinition/profile-practitioner-saml
Extensions
This structure refers to these extensions:
Slices
This structure defines the following Slices:
- The element Task.meta.profile is sliced based on the value of value:value
- The element Task.type.coding is sliced based on the value of value:system
- The element Task.input is sliced based on the value of value:name (Closed)
Differential View
This structure is derived from PrescribeIT® Response from EMR Task
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Task | 0..* | PrescribeIT® Response from EMR Task | RX Renewal Response - Approved with Changes | |
meta | S | 1..1 | Meta | Metadata about the resource |
profile | S | 1..* | (Slice Definition) | Profiles this resource claims to conform to Slice: Unordered, Open by value:value |
profile:task-e163-m | S | 1..1 | uri | Profiles this resource claims to conform to Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/task-e163-m |
modifierExtension:doNotAutofill | S | 0..1 | Task Do Not Auto-fill | Task Do Not Fill? |
type | S | 1..1 | Shared Health CodeableConcept Code | Concept - reference to a terminology or just text |
coding | S | 1..* | (Slice Definition) | Code defined by a terminology system Slice: Unordered, Open by value:system |
coding:taskCode | S | 1..* | Coding | Code defined by a terminology system |
system | S | 1..1 | uri | Identity of the terminology system Fixed Value: https://fhir.infoway-inforoute.ca/CodeSystem/prescriptiontasktype |
code | S | 1..1 | code | Symbol in syntax defined by the system Fixed Value: e163-m |
status | S | 1..1 | code | draft | requested | received | accepted | + Fixed Value: requested |
subject | S | 1..1 | Reference(PrescribeIT® Renewal Prescription) {b} | Renewal prescription |
reference | S | 1..1 | string | Relative, internal or absolute URL reference |
creator | S | 1..1 | Reference(Shared Health SAML Practitioner) {b} | Task requestor |
reference | S | 1..1 | string | Relative, internal or absolute URL reference |
input | S | 0..1 | (Slice Definition) | Task Input Slice: Unordered, Closed by value:name |
input:change | S | 1..1 | BackboneElement | Task Input |
name | S | 1..1 | string | Input Name Fixed Value: change |
value[x] | S | 1..1 | string | How has prescription changed? |
output | 0..0 | |||
Documentation for this format |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
Task | I | 0..* | PrescribeIT® Response from EMR Task | RX Renewal Response - Approved with Changes |
id | SΣ | 1..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Σ | 1..* | (Slice Definition) | Profiles this resource claims to conform to Slice: Unordered, Open by value:value |
profile:task-e163-m | SΣ | 1..1 | uri | Profiles this resource claims to conform to Fixed Value: http://prescribeit.ca/fhir/StructureDefinition/task-e163-m |
tag | Σ | 0..* | Coding | Tags 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..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): A human language. | |
text | 0..1 | Narrative | Text summary of the resource, for human interpretation | |
contained | 0..* | Resource | Contained, inline Resources | |
extension | S | 0..* | Extension | Extension Slice: Unordered, Open by value:url |
ext-task-group-identifier | S | 1..1 | Shared Health Identifier | Group Identifier URL: http://hl7.org/fhir/StructureDefinition/extension-Task.groupIdentifier profiled by http://prescribeit.ca/fhir/StructureDefinition/ext-task-group-identifier |
ext-task-basedon | S | 1..1 | Reference() | Plan, request or referral URL: http://hl7.org/fhir/StructureDefinition/extension-Task.basedOn profiled by http://prescribeit.ca/fhir/StructureDefinition/ext-task-basedon |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
url | S | 1..1 | uri | "http://hl7.org/fhir/StructureDefinition/extension-Task.basedOn" |
value[x] | S | 1..1 | (Slice Definition) | e-Renewal request Slice: Unordered, Closed by type:$this |
value[x]:valueReference | S | 1..1 | Reference() {r} | Value of extension |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | S | 0..* | Extension | Extension Slice: Unordered, Open by value:url |
ext-task-multiple-response | S | 0..1 | boolean | Task Multiple Response? URL: http://prescribeit.ca/fhir/StructureDefinition/ext-task-multiple-response |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
modifierExtension | ?! | 0..* | (Slice Definition) | Extension Slice: Unordered, Open by value:url |
modifierExtension:doNotAutofill | ?!S | 0..1 | Task Do Not Auto-fill | Task Do Not Fill? |
identifier | 0..1 | Identifier | Task Instance Identifier | |
type | S | 1..1 | Shared Health CodeableConcept Code | Concept - reference to a terminology or just text Binding: PrescriptionTaskType (20220913) (required) |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
coding | SΣ | 1..* | (Slice Definition) | Code defined by a terminology system Slice: Unordered, Open by value:system |
coding:All Slices | Content/Rules for all slices | |||
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 |
version | Σ | 0..1 | string | Version of the system - if relevant |
code | SΣ | 1..1 | code | Symbol in syntax defined by the system |
display | SΣ | 0..1 | string | Representation defined by the system |
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user |
coding:taskCode | SΣ | 1..* | Coding | Code defined by a terminology system |
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/prescriptiontasktype |
version | Σ | 0..1 | string | Version of the system - if relevant |
code | SΣ | 1..1 | code | Symbol in syntax defined by the system Fixed Value: e163-m |
display | SΣ | 0..1 | string | Representation defined by the system |
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user |
text | Σ | 0..1 | string | Plain text representation of the concept |
description | Σ | 0..1 | string | Task Description |
performerType | 0..* | Coding | requester | dispatcher | scheduler | performer | monitor | manager | acquirer | reviewer Binding: TaskPerformerType (preferred): The type(s) of task performers allowed | |
priority | S | 0..1 | code | normal | high Binding: PrescriptionTaskPriority (20190415) (required) |
status | SΣI | 1..1 | code | draft | requested | received | accepted | + Binding: TaskStatus (required): The current status of the task. Fixed Value: requested |
failureReason | ΣI | 0..1 | CodeableConcept | Task Failure Reason |
subject | S | 1..1 | Reference(PrescribeIT® Renewal Prescription) {b} | Renewal prescription |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
for | SΣ | 1..1 | Reference(Shared Health Patient) {b} | Beneficiary of the Task |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
definition | Σ | 0..1 | uri | Task Definition |
created | SI | 1..1 | dateTime | Task Creation Date created-full: Must be at least a full date. i.e. yyyy-mm-dd |
lastModified | SΣI | 1..1 | dateTime | Task Last Modified Date lastModified-full: Must be at least a full date. i.e. yyyy-mm-dd |
creator | S | 1..1 | Reference(Shared Health SAML Practitioner) {b} | Task requestor |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
owner | S | 1..1 | Reference(Shared Health - eRx Service Location) {b} | Task recipient |
id | 0..1 | id | xml:id (or equivalent in JSON) | |
extension | 0..* | Extension | Additional Content defined by implementations | |
reference | SΣI | 1..1 | string | Relative, internal or absolute URL reference |
display | Σ | 0..1 | string | Text alternative for the resource |
parent | 0..1 | Reference(Task) | Composite task | |
input | S | 0..1 | (Slice Definition) | Task Input Slice: Unordered, Closed by value:name |
input:All Slices | Content/Rules for all slices | |||
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 |
name | 1..1 | string | Input Name | |
value[x] | 1..1 | Input Value | ||
valueBoolean | boolean | |||
valueInteger | integer | |||
valueDecimal | decimal | |||
valueBase64Binary | base64Binary | |||
valueInstant | instant | |||
valueString | string | |||
valueUri | uri | |||
valueDate | date | |||
valueDateTime | dateTime | |||
valueTime | time | |||
valueCode | code | |||
valueOid | oid | |||
valueId | id | |||
valueUnsignedInt | unsignedInt | |||
valuePositiveInt | positiveInt | |||
valueMarkdown | markdown | |||
valueAnnotation | Annotation | |||
valueAttachment | Attachment | |||
valueIdentifier | Identifier | |||
valueCodeableConcept | CodeableConcept | |||
valueCoding | Coding | |||
valueQuantity | Quantity | |||
valueRange | Range | |||
valuePeriod | Period | |||
valueRatio | Ratio | |||
valueSampledData | SampledData | |||
valueSignature | Signature | |||
valueHumanName | HumanName | |||
valueAddress | Address | |||
valueContactPoint | ContactPoint | |||
valueTiming | Timing | |||
valueReference | Reference(Any) | |||
valueMeta | Meta | |||
input:change | S | 1..1 | BackboneElement | Task Input |
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 |
name | S | 1..1 | string | Input Name Fixed Value: change |
value[x] | S | 1..1 | string | How has prescription changed? |
Documentation for this format |
Other representations of profile: Schematron
3.114.3 Terminology Bindings
Terminology Bindings
Path | Conformance | ValueSet / Code |
Task.meta.tag | example | |
Task.language | required | http://tools.ietf.org/html/bcp47 |
Task.type | required | PrescriptionTaskType |
Task.performerType | preferred | TaskPerformerType |
Task.priority | required | PrescriptionTaskPriority |
Task.status | required | Fixed Value: requested |
3.114.4 Constraints
Constraints
Id | Path | Details | Requirements |
inv-2 | Task | A Failure reason may be present only when a task has failed. : failureReason.empty() or status = 'failed' | |
inv-1 | Task | Last modified date must be greater than or equal to created date. : lastModified >= created | |
created-full | Task.created | Must be at least a full date. i.e. yyyy-mm-dd : length()>=10 | |
lastModified-full | Task.lastModified | Must be at least a full date. i.e. yyyy-mm-dd : length()>=10 |