MajwareMAJWARE
HL7 v2.x Reference

HL7 Message Types Reference

Complete reference for every HL7 v2.x trigger event. Each entry includes required and optional segments, a realistic example message, real-world troubleshooting scenarios, and common confusions between similar event types.

50
Message types
ADT, ORM, ORU, SIU, MDM, DFT, BAR, RDE, ACK, VXU, MFN
Trigger event families

Patient Administration

7
ADT^A014R / 8O

Admit/Visit Notification

Sent when a patient is admitted to a facility (inpatient) or begins a visit (outpatient). This is the first message in a patient encounter lifecycle and triggers downstream actions: bed assignment, order entry enablement, billing account creation, and clinical system access.

ADT^A024R / 2O

Transfer a Patient

Sent when a patient is transferred from one location to another within the facility. It updates the patient's location in all downstream systems that track bed or unit assignments.

ADT^A034R / 3O

Discharge/End Visit

Sent when a patient is discharged from the facility (inpatient) or ends a visit (outpatient). It signals downstream systems to close the patient's active encounter and release associated resources.

ADT^A044R / 5O

Register a Patient

Sent when a patient is registered for an outpatient visit, emergency department encounter, or ambulatory appointment. Unlike A01 (inpatient admission), A04 is used when the patient is not assigned a bed or admitted inpatient.

ADT^A084R / 5O

Update Patient Information

Sent whenever patient demographics or visit information changes for an existing encounter. This is a delta update — the receiving system should update its patient record with the new information without creating a new encounter.

ADT^A114R / 0O

Cancel Admit/Visit Notification

Sent to cancel a previously transmitted A01 (admit) message. It instructs downstream systems to reverse the admit event and remove the patient's active encounter.

ADT^A404R / 1O

Merge Patient - Patient Identifier List

Sent to merge two patient records. The surviving patient (in PID.3) absorbs the information from the prior patient (in MRG.1). All clinical data associated with the prior patient identifier should be reassigned to the surviving patient.

Order Management

3

Observation/Results

3

Scheduling

6
SIU^S125R / 5O

Notification of New Appointment

Sent when a new appointment is booked in the scheduling system. It notifies downstream systems (RIS, procedure areas, room management) of the new appointment details including date, time, service, and patient.

SIU^S135R / 3O

Notification of Appointment Cancellation

SIU^S13 notifies downstream systems that a previously scheduled appointment has been cancelled. It triggers the receiving system (RIS, procedure area) to remove the appointment from the schedule and release associated resources.

SIU^S145R / 3O

Notification of Appointment Modification

SIU^S14 notifies downstream systems that an existing appointment has been modified — for example, rescheduled to a different date/time, changed to a different procedure, or updated with new patient or provider information.

SIU^S154R / 3O

Notification of Appointment Discontinuation

SIU^S15 notifies downstream systems that an appointment or recurring appointment series has been discontinued. It is similar to cancellation but applies specifically to recurring or active appointment slots that are being stopped going forward rather than cancelled retroactively.

SIU^S172R / 2O

Notification of Appointment Deletion

SIU^S17 instructs downstream systems to delete an appointment record entirely. It is a data correction event used when an appointment was created in error and needs to be completely removed from the receiving system's database, not just cancelled.

SIU^S265R / 1O

Notification That Patient Did Not Show Up for Scheduled Appointment

SIU^S26 notifies downstream systems that a patient did not arrive for a scheduled appointment (no-show). It allows clinical and scheduling systems to mark the appointment as a no-show and trigger appropriate follow-up workflows.

Document Management

3

Financial

4

ADT

18
ADT^A054R / 6O

Pre-Admit a Patient

Sent when a patient is pre-admitted to the facility before physically arriving. It creates a pending encounter record in downstream systems so that orders, imaging requests, and bed assignments can be prepared in advance of the patient's arrival.

ADT^A065R / 2O

Change Outpatient to Inpatient

Sent when a patient's status changes from outpatient (or emergency) to inpatient. The encounter class is upgraded and the patient is assigned a bed. This combines a change-of-class with a location update in a single message.

ADT^A075R / 2O

Change Inpatient to Outpatient

Sent when a patient's status changes from inpatient to outpatient. This is the reverse of ADT^A06. The encounter class is downgraded and the inpatient bed is released. Used when a full inpatient admission is reclassified as outpatient or observation status.

ADT^A094R / 2O

Patient Departing - Tracking

Sent when a patient temporarily leaves their assigned location — for example, leaving the floor to go to radiology, the OR, or physical therapy. This is a location tracking event, not a discharge or transfer. The patient is expected to return.

ADT^A104R / 1O

Patient Arriving - Tracking

Sent when a patient returns to their assigned location after a temporary absence. This is the counterpart to ADT^A09 (Patient Departing). It confirms the patient is back in their room or unit and location tracking is resolved.

ADT^A124R / 2O

Cancel Transfer

Sent to cancel a previously transmitted ADT^A02 (Transfer) message. It instructs downstream systems to revert the patient's location to the pre-transfer location, effectively undoing the transfer event.

ADT^A134R / 2O

Cancel Discharge/End Visit

Sent to cancel a previously transmitted ADT^A03 (Discharge) message. It re-activates the patient's encounter in all downstream systems, signalling that the patient is still admitted and the discharge was entered in error.

ADT^A144R / 6O

Pending Admit

Sent to notify downstream systems that a patient admission is expected in the near future. This is an advisory notification only — it does not create an encounter record. It alerts bed management, nursing, and ancillary systems to prepare for the incoming patient.

ADT^A154R / 1O

Pending Transfer

Sent to notify downstream systems that a patient transfer is imminent but has not yet occurred. Like A14, this is advisory — it notifies the destination unit to prepare a bed and the nursing team to prepare for the incoming patient.

ADT^A164R / 2O

Pending Discharge

Sent to notify downstream systems that a patient discharge is anticipated. This is an advance notification allowing downstream systems and care coordinators to initiate discharge workflows — medication reconciliation, follow-up scheduling, transport arrangements — before the official discharge (A03) is entered.

ADT^A175R / 1O

Swap Patients

Sent when two patients exchange beds or locations simultaneously. A17 carries information for both patients in a single message — it is one of the few ADT messages that contains PID and PV1 segments for two patients.

ADT^A234R / 0O

Delete a Patient Record

Sent to delete a visit record that was created in error. Unlike A11 (cancel admit), A23 is a hard delete instruction — it signals that the visit never should have existed and should be completely removed from downstream systems.

ADT^A283R / 4O

Add Person Information

Sent to add a new person record to a Master Patient Index (MPI) or downstream system without creating a visit or encounter. It carries person-level demographic information only — there is no PV1 visit context.

ADT^A293R / 0O

Delete Person Information

Sent to delete a person-level record from the Master Patient Index or downstream system. This is a destructive operation that removes the patient's identity record, not just a visit. It should only be used for records created in error.

ADT^A313R / 4O

Update Person Information

Sent to update person-level demographics in the Master Patient Index without visit context. It is the person-level equivalent of ADT^A08 (Update Patient Information) and is used when there is no active encounter.

ADT^A344R / 0O

Merge Patient Information - Patient ID Only

Sent to merge duplicate patient identifiers while retaining the demographics from the surviving record. The prior patient's identifier (in MRG.1) is merged into the surviving patient (in PID.3). Only patient identifiers are merged — visit records remain associated with the surviving patient.

ADT^A444R / 0O

Move Account Information

Sent to move an account (visit/encounter) from one patient record to another without merging the patients themselves. The PID segment identifies the patient the account is moving TO, and the MRG segment identifies the patient the account is moving FROM.

ADT^A474R / 0O

Change Patient Identifier List

Sent when a patient's identifier — most commonly their Medical Record Number (MRN) — is changed. The PID segment contains the new identifier; the MRG segment contains the old identifier that is being replaced. All downstream systems must update their records to use the new identifier.

Validate HL7 messages online

Paste any HL7 v2.x message and get instant segment parsing, field decoding, and validation. Free, client-side, no signup.

Open HL7 Message Viewer →

HL7 Integration Guide

Interface design patterns, channel configuration, segment mapping, and real-world HL7 v2.x implementation guidance.

Read the Guide →