HL7 v2.5.1 Specificationsv2.5.1

to moveEnter to openTry PID-5, ADT, 0004

MDM: Medical Document Management

MDM moves clinical documents and their status: a dictated note becoming available, a transcription being edited, a document being replaced. The document itself travels in OBX segments beneath a TXA header.

Recognising MDM messages

MDM announces itself in MSH-9 like this:

MSH-9MDM^T01^MDM_T01
  1. MSH-9.1MDMmessage code: what kind of message this is (medical document management)
  2. MSH-9.2T01trigger event: what happened in the real world: original document notification
  3. MSH-9.3MDM_T01message structure: which segments to expect, and in what order

How to use these specifications explains MSH-9 in full, with a worked example.

Message structures

MDM takes 2 structures.

MDM_T01: Original Document Notification

6 different trigger events send this structure:

The segments below are the same for all 6. HL7 varies the meaning, not the shape: there is no separate MDM_T03 layout. What changes is MSH-9, which tells the receiver which of the 6 happened and therefore what to do with the message.

You must always send: MSH, EVN, PID, PV1, TXA. Everything else is optional, or required only inside a group you chose to send.

SegmentNameOPTCardinality
MSHR1..1
SFTO0..*
EVNR1..1
PIDR1..1
PV1R1..1
COMMON_ORDERa group of 4 segments, repeated togetherO0..*
ORCin COMMON_ORDERR1..1
TIMINGin COMMON_ORDERa group of 2 segments, repeated togetherO0..*
TQ1in TIMINGR1..1
TQ2in TIMINGO0..*
OBRin COMMON_ORDERR1..1
NTEin COMMON_ORDERO0..*
TXAR1..1

R inside a group means required of that group. Send the group and you must include that segment; leave the group out and it never appears. This structure has 2 such groups: COMMON_ORDER, TIMING.

MDM_T02: Original Document Notification and Content

5 different trigger events send this structure:

The segments below are the same for all 5. HL7 varies the meaning, not the shape: there is no separate MDM_T04 layout. What changes is MSH-9, which tells the receiver which of the 5 happened and therefore what to do with the message.

You must always send: MSH, EVN, PID, PV1, TXA, OBX. Everything else is optional, or required only inside a group you chose to send.

SegmentNameOPTCardinality
MSHR1..1
SFTO0..*
EVNR1..1
PIDR1..1
PV1R1..1
COMMON_ORDERa group of 4 segments, repeated togetherO0..*
ORCin COMMON_ORDERR1..1
TIMINGin COMMON_ORDERa group of 2 segments, repeated togetherO0..*
TQ1in TIMINGR1..1
TQ2in TIMINGO0..*
OBRin COMMON_ORDERR1..1
NTEin COMMON_ORDERO0..*
TXAR1..1
OBSERVATIONa group of 2 segments, repeated togetherR1..*
OBXR1..1
NTEO0..*

R inside a group means required of that group. Send the group and you must include that segment; leave the group out and it never appears. This structure has 3 such groups: COMMON_ORDER, TIMING, OBSERVATION.

Trigger events

The trigger event is the real-world thing that made the message get sent. MDM defines 11.

EventNameStructure
T01Original Document NotificationMDM_T01
T02Original Document Notification and ContentMDM_T02
T03Document Status Change NotificationMDM_T01
T04T04MDM_T02
T05Document Addendum NotificationMDM_T01
T06Document Addendum Notification and ContentMDM_T02
T07Document Edit NotificationMDM_T01
T08Document Edit Notification and ContentMDM_T02
T09Document Replacement NotificationMDM_T01
T10Document Replacement Notification and ContentMDM_T02
T11Document Cancel NotificationMDM_T01