This page is part of the FHIR Specification (v1.0.2: DSTU 2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions
Orders and Observations Work Group | Maturity Level: 1 | Compartments: Device, Encounter, Patient, Practitioner |
A record of a request for a diagnostic investigation service to be performed.
A Diagnostic Order is a record of a request for a set of diagnostic investigations to be performed. The investigation will lead to a Diagnostic Report that summarizes the outcome of the investigation, and includes any useful data and/or images that are relevant to the treatment/management of the subject.
The principal intention of the Diagnostic Order is to support ordering diagnostic investigations on patients (which includes non-human patients in veterinary medicine). However in many contexts, healthcare related processes include performing diagnostic investigations on groups of subjects, devices involved in the provision of healthcare, and even environmental locations such as ducts, bodies of water, etc. The Diagnostic Order supports all these usages.
The general work flow that this resource facilitates is that a clinical system creates a diagnostic order. The diagnostic order is then exchanged, perhaps via intermediaries, with a system that represents a diagnostic service that can perform the investigation as a request to do so. The diagnostic service will update the request as the work is performed, and then finally issue a report that references the requests that it fulfills.
DiagnosticOrder is closely related to other types of "request" resources, particularly ReferralRequest and ProcedureRequest. In fact, for some services, it may be appropriate to use any one of these resources to request that the service be performed. Which one is used may be driven by organization practice and by context. When it is unclear which to use, the following principles may be helpful:
The DiagnosticOrder supports references to the numerous other resources that define information about the subject - the orderer, associated encounter, specimen, body site and other supporting information. For example, Patient, Practitioner, Specimen and Condition are all referenced in this resource. Some systems may choose to bundle up a DiagnosticOrder and this referenced information into a Document for delivery to the recipient. However, REST, Messaging and Services are also valid architectures for managing referrals and may be more appropriate where active workflow management is needed.
The CarePlan resource can be used to describe more sophisticated requests for combinations of services and DiagnosticOrder may be referenced as part of a CarePlan. Similarly ClinicalImpression resource can reference DiagnosticOrder as part of a follow up to plan to the assessment.
Note that the Diagnostic Order itself is not a request to perform the investigation - but rather a record of the fact that a request was made. To actually initiate the workflow beyond simply the existence of a Diagnostic Order may be required. This can be achieved by using an Order resource, with the Diagnostic Order referenced from the Order.details, or by using the Diagnostic Order resource in the context of an messaging or service workflow where the request is explicit or implicit."
This resource is referenced by CarePlan, ClinicalImpression, DiagnosticReport, ImagingStudy and Procedure
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
DiagnosticOrder | DomainResource | A request for a diagnostic service | ||
subject | Σ | 1..1 | Reference(Patient | Group | Location | Device) | Who and/or what test is about |
orderer | Σ | 0..1 | Reference(Practitioner) | Who ordered the test |
identifier | Σ | 0..* | Identifier | Identifiers assigned to this order |
encounter | Σ | 0..1 | Reference(Encounter) | The encounter that this diagnostic order is associated with |
reason | 0..* | CodeableConcept | Explanation/Justification for test Condition/Problem/Diagnosis Codes (Example) | |
supportingInformation | 0..* | Reference(Observation | Condition | DocumentReference) | Additional clinical information | |
specimen | 0..* | Reference(Specimen) | If the whole order relates to specific specimens | |
status | ?! Σ | 0..1 | code | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed DiagnosticOrderStatus (Required) |
priority | Σ | 0..1 | code | routine | urgent | stat | asap DiagnosticOrderPriority (Required) |
event | 0..* | BackboneElement | A list of events of interest in the lifecycle | |
status | Σ | 1..1 | code | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed DiagnosticOrderStatus (Required) |
description | Σ | 0..1 | CodeableConcept | More information about the event and its context Diagnostic Order Event Codes (Example) |
dateTime | Σ | 1..1 | dateTime | The date at which the event happened |
actor | 0..1 | Reference(Practitioner | Device) | Who recorded or did this | |
item | 0..* | BackboneElement | The items the orderer requested | |
code | Σ | 1..1 | CodeableConcept | Code to indicate the item (test or panel) being ordered LOINC Diagnostic Order Codes (Preferred) |
specimen | 0..* | Reference(Specimen) | If this item relates to specific specimens | |
bodySite | 0..1 | CodeableConcept | Location of requested test (if applicable) SNOMED CT Body Structures (Example) | |
status | Σ | 0..1 | code | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed DiagnosticOrderStatus (Required) |
event | Σ | 0..* | see event | Events specific to this item |
note | 0..* | Annotation | Other notes and comments | |
Documentation for this format |
UML Diagram
XML Template
<DiagnosticOrder xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <subject><!-- 1..1 Reference(Patient|Group|Location|Device) Who and/or what test is about --></subject> <orderer><!-- 0..1 Reference(Practitioner) Who ordered the test --></orderer> <identifier><!-- 0..* Identifier Identifiers assigned to this order --></identifier> <encounter><!-- 0..1 Reference(Encounter) The encounter that this diagnostic order is associated with --></encounter> <reason><!-- 0..* CodeableConcept Explanation/Justification for test --></reason> <supportingInformation><!-- 0..* Reference(Observation|Condition| DocumentReference) Additional clinical information --></supportingInformation> <specimen><!-- 0..* Reference(Specimen) If the whole order relates to specific specimens --></specimen> <status value="[code]"/><!-- 0..1 proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed --> <priority value="[code]"/><!-- 0..1 routine | urgent | stat | asap --> <event> <!-- 0..* A list of events of interest in the lifecycle --> <status value="[code]"/><!-- 1..1 proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed --> <description><!-- 0..1 CodeableConcept More information about the event and its context --></description> <dateTime value="[dateTime]"/><!-- 1..1 The date at which the event happened --> <actor><!-- 0..1 Reference(Practitioner|Device) Who recorded or did this --></actor> </event> <item> <!-- 0..* The items the orderer requested --> <code><!-- 1..1 CodeableConcept Code to indicate the item (test or panel) being ordered --></code> <specimen><!-- 0..* Reference(Specimen) If this item relates to specific specimens --></specimen> <bodySite><!-- 0..1 CodeableConcept Location of requested test (if applicable) --></bodySite> <status value="[code]"/><!-- 0..1 proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed --> <event><!-- 0..* Content as for DiagnosticOrder.event Events specific to this item --></event> </item> <note><!-- 0..* Annotation Other notes and comments --></note> </DiagnosticOrder>
JSON Template
{ "resourceType" : "DiagnosticOrder", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "subject" : { Reference(Patient|Group|Location|Device) }, // R! Who and/or what test is about "orderer" : { Reference(Practitioner) }, // Who ordered the test "identifier" : [{ Identifier }], // Identifiers assigned to this order "encounter" : { Reference(Encounter) }, // The encounter that this diagnostic order is associated with "reason" : [{ CodeableConcept }], // Explanation/Justification for test "supportingInformation" : [{ Reference(Observation|Condition| DocumentReference) }], // Additional clinical information "specimen" : [{ Reference(Specimen) }], // If the whole order relates to specific specimens "status" : "<code>", // proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed "priority" : "<code>", // routine | urgent | stat | asap "event" : [{ // A list of events of interest in the lifecycle "status" : "<code>", // R! proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed "description" : { CodeableConcept }, // More information about the event and its context "dateTime" : "<dateTime>", // R! The date at which the event happened "actor" : { Reference(Practitioner|Device) } // Who recorded or did this }], "item" : [{ // The items the orderer requested "code" : { CodeableConcept }, // R! Code to indicate the item (test or panel) being ordered "specimen" : [{ Reference(Specimen) }], // If this item relates to specific specimens "bodySite" : { CodeableConcept }, // Location of requested test (if applicable) "status" : "<code>", // proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed "event" : [{ Content as for DiagnosticOrder.event }] // Events specific to this item }], "note" : [{ Annotation }] // Other notes and comments }
Structure
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
DiagnosticOrder | DomainResource | A request for a diagnostic service | ||
subject | Σ | 1..1 | Reference(Patient | Group | Location | Device) | Who and/or what test is about |
orderer | Σ | 0..1 | Reference(Practitioner) | Who ordered the test |
identifier | Σ | 0..* | Identifier | Identifiers assigned to this order |
encounter | Σ | 0..1 | Reference(Encounter) | The encounter that this diagnostic order is associated with |
reason | 0..* | CodeableConcept | Explanation/Justification for test Condition/Problem/Diagnosis Codes (Example) | |
supportingInformation | 0..* | Reference(Observation | Condition | DocumentReference) | Additional clinical information | |
specimen | 0..* | Reference(Specimen) | If the whole order relates to specific specimens | |
status | ?! Σ | 0..1 | code | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed DiagnosticOrderStatus (Required) |
priority | Σ | 0..1 | code | routine | urgent | stat | asap DiagnosticOrderPriority (Required) |
event | 0..* | BackboneElement | A list of events of interest in the lifecycle | |
status | Σ | 1..1 | code | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed DiagnosticOrderStatus (Required) |
description | Σ | 0..1 | CodeableConcept | More information about the event and its context Diagnostic Order Event Codes (Example) |
dateTime | Σ | 1..1 | dateTime | The date at which the event happened |
actor | 0..1 | Reference(Practitioner | Device) | Who recorded or did this | |
item | 0..* | BackboneElement | The items the orderer requested | |
code | Σ | 1..1 | CodeableConcept | Code to indicate the item (test or panel) being ordered LOINC Diagnostic Order Codes (Preferred) |
specimen | 0..* | Reference(Specimen) | If this item relates to specific specimens | |
bodySite | 0..1 | CodeableConcept | Location of requested test (if applicable) SNOMED CT Body Structures (Example) | |
status | Σ | 0..1 | code | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed DiagnosticOrderStatus (Required) |
event | Σ | 0..* | see event | Events specific to this item |
note | 0..* | Annotation | Other notes and comments | |
Documentation for this format |
XML Template
<DiagnosticOrder xmlns="http://hl7.org/fhir"> <!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <subject><!-- 1..1 Reference(Patient|Group|Location|Device) Who and/or what test is about --></subject> <orderer><!-- 0..1 Reference(Practitioner) Who ordered the test --></orderer> <identifier><!-- 0..* Identifier Identifiers assigned to this order --></identifier> <encounter><!-- 0..1 Reference(Encounter) The encounter that this diagnostic order is associated with --></encounter> <reason><!-- 0..* CodeableConcept Explanation/Justification for test --></reason> <supportingInformation><!-- 0..* Reference(Observation|Condition| DocumentReference) Additional clinical information --></supportingInformation> <specimen><!-- 0..* Reference(Specimen) If the whole order relates to specific specimens --></specimen> <status value="[code]"/><!-- 0..1 proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed --> <priority value="[code]"/><!-- 0..1 routine | urgent | stat | asap --> <event> <!-- 0..* A list of events of interest in the lifecycle --> <status value="[code]"/><!-- 1..1 proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed --> <description><!-- 0..1 CodeableConcept More information about the event and its context --></description> <dateTime value="[dateTime]"/><!-- 1..1 The date at which the event happened --> <actor><!-- 0..1 Reference(Practitioner|Device) Who recorded or did this --></actor> </event> <item> <!-- 0..* The items the orderer requested --> <code><!-- 1..1 CodeableConcept Code to indicate the item (test or panel) being ordered --></code> <specimen><!-- 0..* Reference(Specimen) If this item relates to specific specimens --></specimen> <bodySite><!-- 0..1 CodeableConcept Location of requested test (if applicable) --></bodySite> <status value="[code]"/><!-- 0..1 proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed --> <event><!-- 0..* Content as for DiagnosticOrder.event Events specific to this item --></event> </item> <note><!-- 0..* Annotation Other notes and comments --></note> </DiagnosticOrder>
JSON Template
{ "resourceType" : "DiagnosticOrder", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "subject" : { Reference(Patient|Group|Location|Device) }, // R! Who and/or what test is about "orderer" : { Reference(Practitioner) }, // Who ordered the test "identifier" : [{ Identifier }], // Identifiers assigned to this order "encounter" : { Reference(Encounter) }, // The encounter that this diagnostic order is associated with "reason" : [{ CodeableConcept }], // Explanation/Justification for test "supportingInformation" : [{ Reference(Observation|Condition| DocumentReference) }], // Additional clinical information "specimen" : [{ Reference(Specimen) }], // If the whole order relates to specific specimens "status" : "<code>", // proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed "priority" : "<code>", // routine | urgent | stat | asap "event" : [{ // A list of events of interest in the lifecycle "status" : "<code>", // R! proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed "description" : { CodeableConcept }, // More information about the event and its context "dateTime" : "<dateTime>", // R! The date at which the event happened "actor" : { Reference(Practitioner|Device) } // Who recorded or did this }], "item" : [{ // The items the orderer requested "code" : { CodeableConcept }, // R! Code to indicate the item (test or panel) being ordered "specimen" : [{ Reference(Specimen) }], // If this item relates to specific specimens "bodySite" : { CodeableConcept }, // Location of requested test (if applicable) "status" : "<code>", // proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed "event" : [{ Content as for DiagnosticOrder.event }] // Events specific to this item }], "note" : [{ Annotation }] // Other notes and comments }
Alternate definitions: Schema/Schematron, Resource Profile (XML, JSON), Questionnaire
Path | Definition | Type | Reference |
---|---|---|---|
DiagnosticOrder.reason | Diagnosis or problem codes justifying the reason for requesting the diagnostic investigation. | Example | Condition/Problem/Diagnosis Codes |
DiagnosticOrder.status DiagnosticOrder.event.status DiagnosticOrder.item.status | The status of a diagnostic order. | Required | DiagnosticOrderStatus |
DiagnosticOrder.priority | The clinical priority of a diagnostic order. | Required | DiagnosticOrderPriority |
DiagnosticOrder.event.description | Additional information about an event that occurred to a diagnostic order - e.g. if the status remained unchanged. | Example | Diagnostic Order Event Codes |
DiagnosticOrder.item.code | Codes for tests/services that can be performed by diagnostic services. | Preferred | LOINC Diagnostic Order Codes |
DiagnosticOrder.item.bodySite | Codes describing anatomical locations. May include laterality. | Example | SNOMED CT Body Structures |
<!-- Placer identifier--> <identifier> <type> <coding> <system value="http://hl7.org/fhir/identifier-type"/> <code value="PLAC"/> </coding> <text value="Placer"/> </type> <system value="urn:oid:1.3.4.5.6.7"/> <value value="2345234234234"/> </identifier> <!-- Filler identifier--> <identifier> <type> <coding> <system value="http://hl7.org/fhir/identifier-type"/> <code value="PLAC"/> </coding> <text value="Placer"/> </type> <system value=" http://hl7.org/fhir/identifier-type"/> <value value="567890"/> </identifier>
Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Paths |
actor | reference | Who recorded or did this | DiagnosticOrder.event.actor, DiagnosticOrder.item.event.actor (Device, Practitioner) |
bodysite | token | Location of requested test (if applicable) | DiagnosticOrder.item.bodySite |
code | token | Code to indicate the item (test or panel) being ordered | DiagnosticOrder.item.code |
encounter | reference | The encounter that this diagnostic order is associated with | DiagnosticOrder.encounter (Encounter) |
event-date | date | The date at which the event happened | DiagnosticOrder.event.dateTime |
event-status | token | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed | DiagnosticOrder.event.status |
event-status-date | composite | A combination of past-status and date | |
identifier | token | Identifiers assigned to this order | DiagnosticOrder.identifier |
item-date | date | The date at which the event happened | DiagnosticOrder.item.event.dateTime |
item-past-status | token | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed | DiagnosticOrder.item.event.status |
item-status | token | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed | DiagnosticOrder.item.status |
item-status-date | composite | A combination of item-past-status and item-date | |
orderer | reference | Who ordered the test | DiagnosticOrder.orderer (Practitioner) |
patient | reference | Who and/or what test is about | DiagnosticOrder.subject (Patient) |
specimen | reference | If the whole order relates to specific specimens | DiagnosticOrder.specimen, DiagnosticOrder.item.specimen (Specimen) |
status | token | proposed | draft | planned | requested | received | accepted | in-progress | review | completed | cancelled | suspended | rejected | failed | DiagnosticOrder.status |
subject | reference | Who and/or what test is about | DiagnosticOrder.subject (Device, Location, Patient, Group) |