This specification is currently a work in progress.


Events Processed


ADT^A01 - Admit Patient


An A01 event is intended to be used for "Admitted" patients only. An A01 event is sent as a result of a patient undergoing the admission process which assigns the patient to a bed. It signals the beginning of a patient’s stay in a healthcare facility.


Cortex will update both patient demographic information from the PID segment, as well as visit information when processing this message.


Updates to admit information are sent as a subsequent ADT^A01 message.


Structure:


Segment
Opt
MSHR
EVNR
PIDR
NK1{O}
PV1R
PV2O



ADT^A02 - Transfer Patient


An A02 event is issued as a result of the patient changing his or her assigned physical location. 


Cortex will update both patient demographic information from the PID segment, as well as visit information when processing this message. 


To cancel a transfer, a new ADT^A02 message should be sent, reversing the locations.


Structure:


Segment
Opt
MSHR
EVNR
PIDR
PV1R
PV2O



ADT^A03 - Discharge Patient


An A03 event signals the end of a patient’s stay in a healthcare facility. It signals that the patient’s status has changed to "discharged" and that a discharge date has been recorded. The patient is no longer in the facility.


For non-admitted patients, an A03 event signals the end of a patient’s visit to a healthcare facility. It could be used to signal the end of a visit for a one-time or recurring outpatient who is not assigned to a bed. It could also be used to signal the end of a visit to the Emergency Department.


Cortex will update both patient demographic information from the PID segment, as well as visit information when processing this message.


Updates to patient discharge information are sent as a subsequent ADT^A04 message.


Structure:


SegmentOpt
MSHR
EVNR
PIDR
PV1R
PV2O



ADT^A04 - Register Patient


This event signals that the patient has arrived or checked in as a one-time, or recurring outpatient, and is not assigned to a bed. Typically Emergency Department visits.


Cortex will update both patient demographic information from the PID segment, as well as visit information when processing this message.


Updates to patient registration information are sent as a subsequent ADT^A04 message.


Structure:


SegmentOpt
MSHR
EVNR
PIDR
PV1R
PV2O


ADT^A11 - Cancel Patient Admit


For "admitted" patients, the A11 event is sent when an A01 (admit/visit notification) event is cancelled, either because of an erroneous entry of the A01 event, or because of a decision not to admit the patient after all.


For "non-admitted" patients, the A11 event is sent when an A04 (register a patient) event is cancelled, either because of an erroneous entry of the A04 event, or because of a decision not to check the patient in for the visit after all.


Structure:


SegmentOpt
MSHR
EVNR
PIDR
PV1R
PV2O


ADT^A13 - Cancel Discharge


The A13 event is sent when an A03 (discharge/end visit) event is cancelled, either because of erroneous entry of the A03 event or because of a decision not to discharge or end the visit of the patient after all.


Structure:


SegmentOpt
MSHR
EVNR
PIDR
PV1R
PV2O


ADT^A28 - Create New Patient


This event allows the creation of a patient record in Cortex before any admission or visit events take place.


HL7 2.4 defines the PV1 segment as required to maintain backward compatibility with previous releases. However, a "pseudo-optional" PV1 can be achieved by valuing PV1-2 - patient class to N - not applicable. Cortex does not require the presence of the PV1 segment at all for this event.


Structure:


SegmentOpt
MSHR
EVNR
PIDR
PV1O
PV2O


ADT^A31 - Update Person Information


This event allows for the updating of patient demographic information outside of the context of a visit. Many systems can be quite noisy with theses messages, so Cortex will selectively process these messages only for patient who have a current visit in progress. This event is ignored for those patients who do not have a visit in progress. 


HL7 2.4 defines the PV1 segment as required to maintain backward compatibility with previous releases. However, a "pseudo-optional" PV1 can be achieved by valuing PV1-2 - patient class to N - not applicable. Cortex does not require the presence of the PV1 segment at all for this event.


Structure:


SegmentOpt
MSHR
EVNR
PIDR
PV1O
PV2O



ADT^A40 - Merge Patient


An A40 event is used to signal a merge of records for a patient that was incorrectly filed under two different identifiers. The "incorrect source identifier" identified in the MRG segment (MRG-1 - prior patient identifier list) is to be merged with the required "correct target identifier" of the same "identifier type code" component identified in the PID segment (PID-3 - patient identifier list). The "incorrect source identifier" would then logically never be referenced in future transactions.


Structure:


SegmentOpt
MSHR
EVNR
PIDR
MRG
R
PV1O


Segment Definitions


MSH - Message Header Segment


SeqNameLenTypeOptRptNullableDescription
1Field Separator1STR

Standard HL7 field separator. Fixed value of '|'.
2Encoding Characters4STR

Standard HL7 encoding characters.
Fixed value of '^~\&'.
3Sending Application180HDO


Application that originally sent the message.
4Sending Facility180HDO


Facility that originally sent the message.
5Receiving Application180HDO


Application the message is intended for.
6Receiving Facility180HDO


Facility the message is intended for.
7Date / Time of Message26TSR

The value of this field must be to a precision of fractions of a second to 3 decimal places. If the fractions of a second are not available, then these must be set to '000'.

The value of this field must contain the time zone component.

The time zone of this date time will be treated as the default time zone for all other time stamps in a message instance (i.e. this time zone will be used if one is not supplied with other time stamps).


8Security
STO

Unused
9Message Type
MSGR

See elsewhere for message types supported by Cortex.
10Message Control ID22STR

Unique message control ID.


11Processing ID3PTR

Processing ID. Message will only be processed if the value of this is 'P'. Message will be ignored for any other value.
12Version ID8IDR

HL7 Version ID. Fixed value of '2.4'.


Example:


MSH|^~\\&|||||20190527223546||ADT^A01|18234123946123|P|2.4||||


EVN - Event Segment


SeqNameLenTypeOptRptNullableDescription
2
Recorded Date Time26TSR


6Occurred Date Time26TSO

Optional, will fall back to EVN.2 date time for event.


Example:


EVN|A01|20190527223546||||20190527223400|


PID - Patient Identifier Segment


SeqNameLenTypeOptRptNullableDescription
2Patient ID20CXB

Backwards Compatibility only. Cortex may be configured to use this identifier as the primary identifier for creating and matching patient records.
3Patient Identifier List250CXRY

List of identifiers used to uniquely identify a patient.

Cortex may be configured to filter this patient identifier list to match a "primary identifier" type it uses to create and match patient records.


For New Zealand, this patient identifier list must contain a NHI number. It should be identified by setting the Universal ID (3.4.2) to '2.16.840.1.113883.2.18.2' - the Ministry of Health NHI OID.


Identifiers in this list not matching the filter defined by the organisation will be ignored.


If multiple identifiers match the filter defined by the organisation, the first in the list will be used.


5Patient Name250XPNRY
The first name in this repeating field is considered the primary legal name of the patient which will show in Cortex.

Multiple names may exist here, and future versions of Cortex may allow a 'Preferred Name' in addition to legal name.

7Date Time of Birth26TSR

The minimum precision requirement for this field is days (YYYYMMDD). If the time of birth is not known then it should be defaulted to ‘000000’, as per the TS type definition.
8Administrative Sex1ISR

Administrative sex of the patient based on biological and physical characteristics. Note that this is different to gender which is self- identified.


Valid values are:
A (Ambiguous)
F (Female)
M (Male)
N (Not Applicable)
O (Other)
U (Unknown)
29Patient Death Date Time26TSO

Date and time when patient death occurred. Mandatory if PID.30 <Patient Death Indicator> is set to 'Y'.
30Patient Death Indicator1IDO
YIndicates if the patient is deceased. <blank> defaults to not deceased.

Valid values are:
N (No)
Y (Yes)
<blank>


Examples:

PID|1||81231314^^^&2.16.840.1.113883.2.18.66.3.1.1~ZZZ0016^^^&2.16.840.1.113883.2.18.2~TEM1234^^^&2.16.840.1.113883.2.18.2||Bloggs^Joe^John^^Mr^^D||19391009|M||99^Not Stated||||||||||||99^Not Stated^NZHIS||||||||N


PV1 - Patient Visit Segment


SeqNameLenTypeOptRptNullableDescription
2Patient Class1ISR

Category of patient stay. Valid values are:

E (Emergency)
I (Inpatient admissions)
N (Not applicable)
3Assigned Patient Location80PLR

The patient's current assigned location. For transfer events, this is the destination location. For discharge events, this is the patient's location prior to discharge.
7Attending Doctor250XCNOYYThe attending doctor for this visit. Multiple names and identifiers for the same physician may be sent.

In New Zealand it is recommended to use the person's CPN from the Health Practitioner Index as the ID number. With the Universal ID of the assigning authority set to '2.16.840.1.113883.2.18.3.1'
8Referring Doctor250XCNOY

19Visit Number250CXR

Unique visit number.
38Diet Type250
CEO


44Admit Date Time26TSO

Required for all ADT events where a visit presentation has occurred; i.e. the patient has either been registered or admitted.
45Discharge Date Time26TSO

Required for all patient discharge (A03) events.



MRG - Merge Patient Information Segment


SeqNameLenTypeOptRptNullableDescription
1Prior Patient Identifier
250CXR

The patient identifier that is to be merged into another [existing] patient record (as defined by the PID segment within the same message).



Data Types


CX - Extended Composite ID with Check Digit


SeqComponent NameLenTypeOptDescription
1ID
ST
RThe value of the identifier itself.
2Check Digit

ST
OShould be null
3Check Digit Scheme

IDOShould be null
4Assigning Authority
HDRAssigning authority for the identifier.

For NHI identifiers in New Zealand, it is recommended the Universal ID (CX.4.2) component should be set to the Ministry of Health's NHI OID: '2.16.840.1.113883.2.18.2'


Example: 

ZZZ0016^^^&2.16.840.1.113883.2.18.2 (Usage as New Zealand NHI patient identifier)


PL - Patient Location


SeqComponent NameLenTypeOptDescription
1Point of Care
ISRWard / Unit / Department / Clinic within the Facility
2Room
ISOPatient room
3Bed
ISOPatient bed
4Facility
HDRFacility where the patient is located.

The Universal ID (PL.4.2) component is required to be set.

In New Zealand it is highly recommended that the Universal ID component be set to the Facility Code from the Ministry of Health's HPI. Optional the Universal ID type may be set to 'FAC'
9Location Description
ST
Text description of the patient location. If Cortex is configured to auto-create locations, this description will be used to name the newly created location. The Cortex location name may be updated after creation.


Example: 

WD 16^01^04^&FZZ999-B&FAC^^^^Ward 16 (Usage as New Zealand location within a MoH defined facility)


XPN - Extended Person Name


SeqComponent NameLenTypeOptDescription
1Family Name
100ST
RNote this should be a string, not a FN type.
2Given Name
100ST
R


Example:

Bloggs^Joe^