This
page
is
part
of
the
FHIR
Specification
(v0.0.82:
(v1.0.2:
DSTU
1).
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
-
it
is
just
but
rather
a
record
of
the
fact
that
a
request
was
made.
To
actually
request
that
a
diagnostic
procedure
be
performed,
additional
initiate
the
workflow
beyond
sumply
simply
the
existence
of
a
Diagnostic
Order
is
may
be
required.
This
can
be
achieved
by
using
an
Order
resource,
with
the
Diagnostic
Order
referenced
from
the
Order.details
,
Order.details,
or
by
using
the
Diagnostic
Order
resource
in
the
context
of
of
an
messaging
or
service
workflow
where
the
request
is
explicit
or
implicit.
implicit."
This resource is referenced by CarePlan , ClinicalImpression , DiagnosticReport , ImagingStudy and Procedure
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
![]() |
|---|---|---|---|---|
![]() | DomainResource | A request for a diagnostic service | ||
![]() ![]() | Σ | 1..1 | Reference ( Patient | Group | Location | Device ) | Who and/or what test is about |
![]() ![]() | Σ | 0..1 | Reference ( Practitioner ) | Who ordered the test |
![]() ![]() | Σ | 0..* | Identifier | Identifiers assigned to this order |
![]() ![]() | Σ | 0..1 | Reference ( Encounter ) | The encounter that this diagnostic order is associated with |
![]() ![]() | 0..* | CodeableConcept |
Explanation/Justification
for
test
Condition/Problem/Diagnosis Codes ( Example ) | |
![]() ![]() | 0..* | Reference ( Observation | Condition | DocumentReference ) | Additional clinical information | |
![]() ![]() | 0..* | Reference ( Specimen ) | If the whole order relates to specific specimens | |
![]() ![]() | ?! Σ | 0..1 | code |
proposed
|
draft
|
planned
|
requested
|
received
|
accepted
|
in-progress
|
review
|
completed
|
cancelled
|
suspended
|
rejected
|
failed
DiagnosticOrderStatus ( Required ) |
![]() ![]() | Σ | 0..1 | code |
routine
|
urgent
|
stat
|
asap
DiagnosticOrderPriority ( Required ) |
![]() ![]() | 0..* | BackboneElement | A list of events of interest in the lifecycle | |
![]() ![]() ![]() | Σ | 1..1 | code |
proposed
|
draft
|
planned
|
requested
|
received
|
accepted
|
in-progress
|
review
|
completed
|
cancelled
|
suspended
|
rejected
|
failed
DiagnosticOrderStatus ( Required ) |
![]() ![]() ![]() | Σ | 0..1 | CodeableConcept |
More
information
about
the
event
and
its
context
Diagnostic Order Event Codes ( Example ) |
![]() ![]() ![]() | Σ | 1..1 | dateTime | The date at which the event happened |
![]() ![]() ![]() | 0..1 | Reference ( Practitioner | Device ) | Who recorded or did this | |
![]() ![]() | 0..* | BackboneElement | The items the orderer requested | |
![]() ![]() ![]() | Σ | 1..1 | CodeableConcept |
Code
to
indicate
the
item
(test
or
panel)
being
ordered
LOINC Diagnostic Order Codes ( Preferred ) |
![]() ![]() ![]() | 0..* | Reference ( Specimen ) | If this item relates to specific specimens | |
![]() ![]() ![]() | 0..1 | CodeableConcept |
Location
of
requested
test
(if
applicable)
SNOMED CT Body Structures ( Example ) | |
![]() ![]() ![]() | Σ | 0..1 | code |
proposed
|
draft
|
planned
|
requested
|
received
|
accepted
|
in-progress
|
review
|
completed
|
cancelled
|
suspended
|
rejected
|
failed
DiagnosticOrderStatus ( Required ) |
![]() ![]() ![]() | Σ | 0..* | see event | Events specific to this item |
![]() ![]() | 0..* | Annotation | Other notes and comments | |
Documentation
for
this
format
| ||||
UML Diagram
This
resource
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
![]() |
|---|---|---|---|---|
![]() | DomainResource | A request for a diagnostic service | ||
![]() ![]() | Σ | 1..1 | Reference ( Patient | Group | Location | Device ) |
Who
and/or
what
test
is
|
![]() ![]() |
Σ | 0..1 | Reference ( Practitioner ) | Who ordered the test |
![]() ![]() | Σ | 0..* | Identifier | Identifiers assigned to this order |
![]() ![]() | Σ | 0..1 | Reference ( Encounter ) | The encounter that this diagnostic order is associated with |
![]() ![]() | 0..* | CodeableConcept |
Explanation/Justification
for
test
Condition/Problem/Diagnosis Codes ( Example ) | |
![]() ![]() | 0..* | Reference ( Observation | Condition | DocumentReference ) | Additional clinical information | |
![]() ![]() | 0..* | Reference ( Specimen ) | If the whole order relates to specific specimens | |
![]() ![]() | ?! Σ | 0..1 | code |
proposed
|
draft
|
planned
|
requested
|
received
|
accepted
|
in-progress
|
review
|
completed
|
cancelled
|
suspended
|
rejected
|
failed
DiagnosticOrderStatus ( Required ) |
![]() ![]() | Σ | 0..1 | code |
routine
|
urgent
|
stat
|
asap
DiagnosticOrderPriority ( Required ) |
![]() ![]() | 0..* | BackboneElement | A list of events of interest in the lifecycle | |
![]() ![]() ![]() | Σ | 1..1 | code |
proposed
|
draft
|
planned
|
requested
|
received
|
accepted
|
in-progress
|
review
|
completed
|
cancelled
|
suspended
|
rejected
|
failed
DiagnosticOrderStatus ( Required ) |
![]() ![]() ![]() | Σ | 0..1 | CodeableConcept |
More
information
about
the
event
and
Diagnostic Order Event Codes ( Example ) |
![]() ![]() ![]() | Σ | 1..1 | dateTime | The date at which the event happened |
![]() ![]() ![]() | 0..1 | Reference ( Practitioner | Device ) | Who recorded or did this | |
![]() ![]() | 0..* | BackboneElement | The items the orderer requested | |
![]() ![]() ![]() | Σ | 1..1 | CodeableConcept |
Code
to
indicate
the
item
(test
or
panel)
being
ordered
LOINC Diagnostic Order Codes ( Preferred ) |
![]() ![]() ![]() | 0..* | Reference ( Specimen ) | If this item relates to specific specimens | |
![]() ![]() ![]() | 0..1 | CodeableConcept |
Location
of
requested
test
(if
applicable)
SNOMED CT Body Structures ( Example ) | |
![]() ![]() ![]() | Σ | 0..1 | code |
proposed
|
draft
|
planned
|
requested
|
received
|
accepted
|
in-progress
|
review
|
completed
|
cancelled
|
suspended
|
rejected
|
failed
DiagnosticOrderStatus ( Required ) |
![]() ![]() ![]() | Σ | 0..* | see event | Events specific to this item |
![]() ![]() | 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> <</bodySite> < <</event><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
|
|
|
| DiagnosticOrder.priority |
The
clinical
priority
of
a
diagnostic
|
|
|
| DiagnosticOrder.event.description |
Additional
information
about
an
event
that
occurred
to
a
diagnostic
order
-
e.g.
if
the
status
remained
|
Example |
|
| DiagnosticOrder.item.code |
Codes
for
tests/services
that
can
be
performed
by
diagnostic
|
|
|
| DiagnosticOrder.item.bodySite |
Codes
describing
anatomical
locations.
May
include
|
Example |
|
)
and
the
producer
of
the
observations
in
response
to
the
order
(known
as
the
'Filler'
in
HL7
v2)
.
Use
the
identifier
type
code
"PLAC"
for
the
Placer
Identifier
and
"FILL"
for
the
Filler
identifier.
See
the
example
code
below:
<!-- 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
standard
common
parameters
also
apply.
See
Searching
for
more
information
about
searching
in
REST,
messaging,
and
services.
| Name | Type | Description | Paths |
|
|
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
|
|
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
|
|
DiagnosticOrder.item.event.status |
| item-status | token |
proposed
|
draft
|
planned
|
requested
|
received
|
accepted
|
|
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
|
|
DiagnosticOrder.status |
| subject | reference | Who and/or what test is about |
DiagnosticOrder.subject
( Device , Location , Patient , Group ) |