England Pathology and Laboratory Medicine (PaLM) Technical Framework
0.1.0 - ci-build United Kingdom flag

England Pathology and Laboratory Medicine (PaLM) Technical Framework - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Message Definition - Laboratory Order (O21)

Draft as of 2026-11-04

Raw xml | Download


<MessageDefinition xmlns="http://hl7.org/fhir">
  <id value="laboratory-order"/>
  <language value="en"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: MessageDefinition laboratory-order</b></p><a name="laboratory-order"> </a><a name="hclaboratory-order"> </a><p><b>url</b>: <a href="MessageDefinition-laboratory-order.html">MessageDefinition Laboratory Order (O21)</a></p><p><b>version</b>: 0.1.0</p><p><b>name</b>: LaboratoryOrder</p><p><b>title</b>: Laboratory Order (O21)</p><p><b>status</b>: Draft</p><p><b>experimental</b>: true</p><p><b>date</b>: 2026-11-04</p><p><b>publisher</b>: Kevin Mayfield</p><p><b>contact</b>: <a href="https://github.com/KevinMayfield/PathologyAndLaboratory">https://github.com/KevinMayfield/PathologyAndLaboratory</a></p><p><b>description</b>: </p><div><p>FHIR Message equivalent of the HL7 v2.5.1 <code>OML^O21^OML_O21</code> message, sent by the Order
Placer (EPR, GP system, order comms) to the Order Filler (LIMS) for
<a href="LAB-1.html">Placer Order Management [LAB-1]</a>, by the Order Filler to the Order Placer
for <a href="LAB-2.html">Filler Order Management [LAB-2]</a>, and by a Requester (referring
laboratory) to a Subcontractor (reference laboratory) for
<a href="LAB-35.html">Sub-order Management [LAB-35]</a>.</p>
<p>Each ORC/OBR pair becomes a <a href="StructureDefinition-LaboratoryOrder.html">Laboratory Order</a>,
PID a <a href="StructureDefinition-Patient.html">Patient</a> and SPM a
<a href="StructureDefinition-Specimen.html">Specimen</a>. See <a href="mapping.html">Mapping HL7 v2 and FHIR</a>.</p>
<p>The HL7 v2 acknowledgement <code>ORL^O22</code> (or <code>ACK^O21</code>) is a FHIR response message
(<code>MessageHeader.response</code>).</p>
</div><p><b>jurisdiction</b>: <span title="Codes:{urn:iso:std:iso:3166 GB}">United Kingdom of Great Britain and Northern Ireland</span></p><p><b>event</b>: <a href="http://terminology.hl7.org/7.5.0/CodeSystem-v2-0003.html#v2-0003-O21">event: O21</a> (OML - Laboratory order)</p><p><b>category</b>: Consequence</p><h3>Focus</h3><table class="grid"><tr><td style="display: none">-</td><td><b>Code</b></td><td><b>Profile</b></td><td><b>Min</b></td><td><b>Max</b></td></tr><tr><td style="display: none">*</td><td>ServiceRequest</td><td><a href="StructureDefinition-LaboratoryOrder.html">Laboratory Order</a></td><td>1</td><td>*</td></tr></table><p><b>responseRequired</b>: Always</p></div>
  </text>
  <url value="https://examplesihe.org.uk/MessageDefinition/laboratory-order"/>
  <version value="0.1.0"/>
  <name value="LaboratoryOrder"/>
  <title value="Laboratory Order (O21)"/>
  <status value="draft"/>
  <experimental value="true"/>
  <date value="2026-11-04"/>
  <publisher value="Kevin Mayfield"/>
  <contact>
    <telecom>
      <system value="url"/>
      <value value="https://github.com/KevinMayfield/PathologyAndLaboratory"/>
    </telecom>
  </contact>
  <description
               value="FHIR Message equivalent of the HL7 v2.5.1 `OML^O21^OML_O21` message, sent by the Order
Placer (EPR, GP system, order comms) to the Order Filler (LIMS) for
[Placer Order Management [LAB-1]](LAB-1.html), by the Order Filler to the Order Placer
for [Filler Order Management [LAB-2]](LAB-2.html), and by a Requester (referring
laboratory) to a Subcontractor (reference laboratory) for
[Sub-order Management [LAB-35]](LAB-35.html).

Each ORC/OBR pair becomes a [Laboratory Order](StructureDefinition-LaboratoryOrder.html),
PID a [Patient](StructureDefinition-Patient.html) and SPM a
[Specimen](StructureDefinition-Specimen.html). See [Mapping HL7 v2 and FHIR](mapping.html).

The HL7 v2 acknowledgement `ORL^O22` (or `ACK^O21`) is a FHIR response message
(`MessageHeader.response`)."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="GB"/>
      <display value="United Kingdom of Great Britain and Northern Ireland"/>
    </coding>
  </jurisdiction>
  <eventCoding>
    <system value="http://terminology.hl7.org/CodeSystem/v2-0003"/>
    <code value="O21"/>
    <display value="OML - Laboratory order"/>
  </eventCoding>
  <category value="consequence"/>
  <focus>
    <code value="ServiceRequest"/>
    <profile
             value="https://examplesihe.org.uk/StructureDefinition/LaboratoryOrder"/>
    <min value="1"/>
    <max value="*"/>
  </focus>
  <responseRequired value="always"/>
</MessageDefinition>