Developer documentation‎ > ‎HL7 API‎ > ‎Messages‎ > ‎


ADT A03: Discharge a patient


Records a patient discharge.

Relevant entities

Please click through to the Data Model to explore the presentation of these entities in the web interface.

Update behaviour

Message Entity Matching Criteria Behaviour (Matched) Behaviour (Not Matched)
A03 [[Encounter]] [[Encounter.External Encounter ID]] as derived from PV1-19.1 The [[Encounter Event]] will be handled as indicated below. A new [[Encounter]] will be created with this message.
  [[Encounter Event]] An Encounter can contain zero or one discharge [[Encounter Event]]s. If the [[Encounter]] has been matched, then there will be at most one discharge [[Encounter Event]], so no other IDs are required for matching. The discharge [[Encounter Event]] is replaced with the information in this message. The discharge [[Encounter Event]] is added to the [[Encounter]].


This is identical in format to the ADT A01, except that PV1-45 is used for the Message timestamp instead of PV1-44, as shown below:
Segment Field Component Description Example Data Model


[ PV1-44 ]
Admit datetime. Timestamp of admission for the entire Encounter.
Ignored by an A03

[ PV1-45 ]
Discharge datetime. Timestamp of discharge for the entire Encounter.

PV1-45.1 Discharge timestamp 201508011200 [[Encounter Event.Timestamp]]

If not provided, MSH-7 will be used.


PID|||9999999999^^^NHS^NH||Smith^John^Joe^^Mr||19700101|M|||My flat name^1, The Road^London^London^SW1A 1AA^GBR||^NET~01234567890^PRN~07123456789^PRS|^NET~01234098765^WPN||||||||||||||||N|
PV1|1|I|^^^^^^^^My Ward||||^Jones^Stuart^James^^Dr^|^Smith^William^^^Dr^|^Foster^Terry^^^Mr^||||||||||V00001|||||||||||||||||||||||||201508011000|201508011200


PKB will respond with a standard HL7 acknowledgement.