ADT Integration - ADT

Have more questions? Submit a request

The format for the exchange of patient and order information with via Health Level 7 (HL7) messages. Patient Information transmitted via HL7 Admit Discharge Transaction (ADT) will populate the patient’s demographics and identifiers in the application. Orders transmitted via Order Request Management (ORM) will populate the application with pending orders while at the same time providing a notification to the monitor technician.

 

Specification

SafeNSound supports the HL7 2.3.1 standard messaging format (www.hl7.org). Data are transmitted via secure VPN using TCP/IP and MLLP protocols for message integrity.

 

Communication

Data transmission uses TCP/IP protocols.
Messages sent conform to the HL7 format.

After the receiving application verifies the validity of a message, an Acknowledgement (ACK) will be returned to the message source.

 

Message Definitions

SafeNSound accepts ADT and ORM messages. All messages must contain a Message Header (MSH), Patient Identifier (PID) and Patient Visit Information (PV1) segments. Order messages must also include Common Order (ORC) and Observation Request (OBR) segments. All other segments will be ignored.

 

Patient Information (ADT)

SafeNSound accepts ADT messages of type A01, A02, A03, A04, A05, A06, A08, A40, and A44.

 

MSH – Message Header

The message header is required for all messages and defines the message type, data source and data receiver.

Seq. Name Req. (Y/N) Notes
01 Field Seperator Y "|"
02 Encoding Characters Y "^~\&"
03 Sending Application Y  
04 Sending Facility Y Required for all inbound messages. Must match what is configured in the Facility HL7 field. 
05 Receiving Application N  
06 Receiving Facility N  
07 Message Date/Time Y YYYYMMDDhhmmss
08 Security N  
09 Message Type Y

"ADT^A01"

"ADT^A08"

10 Message Control ID Y  
11 Processing ID Y "P"
12 Version ID Y
"2.3"
 

 

PID – Patient Identification

The patient identification segment contains information which details patient identity. Dithered fields are ignored.

Seq. Name Req. (Y/N/O) Notes
01 Set ID Y '1'
02

Patient Class

 

Not used

03

Patient Location

Y  
3.1

Nurse Unit

Y  
3.2 Room O  
3.3 Bed O  
04

Admission Type

 

Not used

05

Pre-admit Number

 

Not used

06

Prior Patient Location

Conditional Used only for A02 transfer messages. Same format as PV1:3 patient location.
07

Attending Doctor

 

Not used

08

Referring Doctor

 

Not used

09

Consulting Doctor

 

Not used

10

Hospital Service

 

Not used

11

Temporary Location

 

Not used

12

Pre-admit Test Indicator

 

Not used

13

Readmission Indicator 

 

Not used

14

Admit Source

 

Not used

15

Ambulatory Status

 

Not used

16

VIP Indicator

 

Not used

17

Admitting Doctor

 

Not used

18

Patient Type

 

Not used

19

Visit Number

 

Not used

20

Financial Class

 

Not used

21

Charge Price Indicator

 

Not used

 

 

PV1 – Patient Visit Information

The patient visit information segment contains registration information specific to an encounter and is used to determine a patient’s location.

 

Seq.

Name

Req.

(Y/N/O)

Notes

01

Set ID

Y

'1'

02

Patient Class

 

Not used

03

Patient Location

Y

 

3.1

Nurse Unit

Y

 

3.2

Room

O

 

3.3

Bed

O

 

04

Admission Type

 

Not used

05

Pre-admit Number

 

Not used

06

Prior Patient Location

Conditional

Used only for A02 transfer messages. Same format as PV1:3 patient location.

07

Attending Doctor

 

Not used

08

Referring Doctor

 

Not used

09

Consulting Doctor

 

Not used

10

Hospital Service

 

Not used

11

Temporary Location

 

Not used

12

Pre-admit Test Indicator

 

Not used

13

Readmission Indicator 

 

Not used

14

Admit Source

 

Not used

15

Ambulatory Status

 

Not used

16

VIP Indicator

 

Not used

17

Admitting Doctor

 

Not used

18

Patient Type

 

Not used

19

Visit Number

 

Not used

20

Financial Class

 

Not used

21

Charge Price Indicator

 

Not used

 

Seq. Name Req. (Y/N/O) Notes
1 Set ID N EMPI number, if available. (See PID:4)
2 Patient ID (external) Y Medical Record Number or Patient Identifier. 
3 Patient ID (internal) Y Unique encounter identifier. required for integration with multiple facilities when EMPI # is not available in PID:2. Populates TeleCom ID2 field. 
4 Alternate Patient ID Conditional FamilyName^GivenName^MiddleName^Suffix^Prefix
5 PatientName Y  
5.1 FamilyName Y  
5.2 GivenName Y  
5.3 MiddleName N  
5.4 Suffix N  
5.5 Prefix N  
6 Mother's Maiden Name   YYYYMMDD
7 Date of Birth Y  
8 Gender Y  
9 Patient Alias N  
10 Race N Street1^Street2^City^State^ZIP
11 Patient Address N  
11.1 Street Address 1 N  
11.2 Street Address 2 N  
11.3 City N  
11.4 State N  
11.5 ZIP N  
12 County N (000)000-0000
13 Phone (home) N  
14 Phone (business) N  
15 Language N  
16 Marital Status N  
17 Religion N  
18 Patient Account Number Y Account Number or Financial Number
19 SSN N Social Security Number in 000000000 format

Note: Nothing else in PV1 is used.

 

Example: ADT Messages

Inpatient Admit

MSH|^~\@|EPC|HOSP1|BXVW|HOSP1|201004070956||ADT^A01|ADMT|P|2.3|||
PID||4886311|234567||EXAMPLE^PATIENT^X^^||19840404|M||W|STREET1^STREET2^CITY^ST^73100||(505)555-4444|||||23456701|444556666
PV1|1|I|4NTH^430^1||||0123^Referring,Doctor, MD|0123^Admitting,Doctor,MD||TEL|||||||0123^Admitting, Doctor, MD^^^^^^|I|23456701|||||||||||||||||||||||||201004070956||

 

Outpatient Registration

MSH|^~\@|EPC|HOSP1|BXVW|HOSP1|201004071011||ADT^A04|86543549|P|2.3|||
PID||4886311|433567||EXAMPLE^PATIENT^Y^^||19950711|M||W|STREET1^STREET2^CITY^ST^73100||(505)555-6677|||||43356701|333445555
PV1|1|E|ER^001^1||||0123^Referring,Doctor, MD|0123^Admitting,Doctor,MD||TEL|||||||0123^Admitting, Doctor, MD^^^^^^|E|43356701|||||||||||||||||||||||||201004071011||

 

Transfer

MSH|^~\@|EPC|HOSP1|BXVW|HOSP1|201004071120||ADT^A02|654999845|P|2.3|||
PID||4886311|234567||EXAMPLE^PATIENT^X^^||19840404|M||W|STREET1^STREET2^CITY^ST^73100||(505)555-4444|||||23456701|444556666
PV1|1|I|5NTH^510^1|||4NTH^430^1|0123^Referring,Doctor, MD|0123^Admitting,Doctor,MD||TEL|||||||0123^Admitting, Doctor, MD^^^^^^|I|23456701|||||||||||||||||||||||||201004071120||

 

Update

MSH|^~\@|EPC|HOSP1|BXVW|HOSP1|201004071218||ADT^A08|351494446|P|2.3|||
PID||4886311|234567||EXAMPLE^PATIENT^X^^||19840405|M||W|STREET1^STREET2^CITY^ST^73100||(505)555-4444|||||23456701|444556666
PV1|1|I|4NTH^430^1||||0123^Referring,Doctor, MD|0123^Admitting,Doctor,MD||TEL|||||||0123^Admitting, Doctor, MD^^^^^^|I|23456701|||||||||||||||||||||||||201004071218||

 

Order Information (ORM)

The SafeNSound orders interface accepts ORM^O01 messages with the following required message segments: MSH, PID, PV1, ORC and OBR..

 

ORC – Common Order

The ORC segment contains fields common to all order messages. The ORC segment is required for the transmission of an order to a receiving system.The order control code sent in ORC:1 will contain the usage of the order message: NW – new, SC – status change, CA – Cancelled, DC- discontinued.

 

Seq.

Name

Req. (Y/N)

Notes

01

Order Control ID

Y

NW, SC, CA, DC

02

Placer Order Number

Y

Unique Order ID

03

Filler Order Number

N

Identifies the order within the sending system.

04

Placer Group Number

 

Not used

05

Order Status

Y

O- Ordered, P- In Process, C- Complete, X- Cancelled

06

Response Flag

 

Not used

07

Quantity/Timing

 

Not used

08

Parent

 

Not used

09

Date of Transaction

 

Not used

10

Entered By

 

Not used

11

Verified By

 

Not Used

12

Ordering Provider ID

N

Not used

13

Enterer's Location

 

Not used

14

Call Back Phone

 

Not used

15

Order Effective Date

N

 

 

OBR – Order Detail

The Observation Request (OBR) segment contains information specific to the ordered patient monitoring observation.This segment defines the attributes and usage of the order.

Seq. Name Req. (Y/N/O) Notes
1 Set ID Y Always 1, SafeNSound only accepts one order per ORM
2 Placer Order Number Y Unique Order ID
3 Filler Order Number N Identifies the order within the sending system
4 Universal Service ID Y Universal Service ID
5 Priority O Not used
6 Requested Date/Time O Not used
7 Observation Date/Time O Not used
8 Observation End Date/Time O Not used
9 Collection Volume O Not used
10 Collector Identifier O Not used
11 Specimen Action Code O Not used
12 Danger Code O Not used
13 Relevant Clinical Info O Not used
14 Spec Received Date O Not used
15 Specimen Source O Not used
16 Ordering Provider Y Alias of ordering provider
17 Call Back Phone Number O Not used
18 Placer Field 1 O Not used
19 Placer Field 2 O Not used
20 Filler Field 1 O Not used
21 Filler Field 2 O Not used
22 Results Report O Not used
    O  
  Status Change O  
    O  
  Date/Time O  
23 Charge to Practice O Not used
24 Diagnostic Service Sector ID O Not used
25 Result Status O Not used
26 Parent Result O Not used
27 Quantity Timing O Not used
28 Result Copies To O Not used
29 Parent O Not used
30 Transportation Mode O Not used
31 Reason for Study N  
31.1 Reason ID O  
31.2 Reason Text O Freetext
32 Principal Result Interpreter  O Not used
33 Assistant Result Interpreter  O Not used
34 Technician O Not used
35 Transportation O Not used
36 Schedule Date/Time N Date & Time of a scheduled observation

Example:  ORM Message

Order Request

MSH|^~\&|EPC|HOSP1|BXVW|HOSP1|201004071719||ORM^O01|65499544992|P|2.3
PID||4886311|234567||EXAMPLE^PATIENT^X^^||19840405|M||W|STREET1^STREET2^CITY^ST^73100||(505)555-4444|||||23456701|444556666
PV1|1|I|4NTH^430^1||||0123^Referring,Doctor, MD|0123^Admitting,Doctor,MD||TEL|||||||0123^Admitting, Doctor, MD^^^^^^|I|23456701|||||||||||||||||||||||||201004070956||
ORC|NW|67227396^SYS_ORDERID|||Ordered||||20100407160155|65411|||||20100407160155||||65411^EXAMPLE^USER
OBR|1|67227396^SYS_ORDERID||TELEMETRY||20100407160155||||||||||20288^PROVIDER^ORDERING||||ACN65188843||20100407160155||TELEMETRY|||1^^0^20100407161411||||^MONITORING EXAMPLE PATIENT|||||20100407160000

 

Clinical Information (OBX)

The SafeNSound clinical information interface accepts OBX^O01 messages with the following required message segments: MSH, PID, PV1, and OBX.

 

Seq.

Name

Req.

(Y/N/O)

Notes

01

Set ID

Y

Always 1, SafeNSound only accepts one order per OBX

02

Placer Order Number

N

Unique ID

03

Filler Order Number

N

Identifies the order within the sending system

04

 

Y

 

4.1

Universal ID

Y

Universal ID 'WT' or 'HT'

4.2

Universal Name

Y

Universal Name ID 'WEIGHT' or 'HEIGHT'

5

Blank

N

 

6

Value

Y

 

7

Unit of Measurement

Y

Weight 'kg' or 'lbs'    Height 'cm' or 'in'  

 

Example:  OBX Message

MSH|^~\@|EPC|HOSP1|BXVW|HOSP1|201004071218||ADT^A08|351494446|P|2.3|||
PID||4886311|234567||EXAMPLE^PATIENT^X^^||19840405|M||W|STREET1^STREET2^CITY^ST^73100||(505)555-4444|||||23456701|444556666
PV1|1|I|4NTH^430^1||||0123^Referring,Doctor, MD|0123^Admitting,Doctor,MD||TEL|||||||0123^Admitting, Doctor, MD^^^^^^|I|23456701|||||||||||||||||||||||||201004071218||
OBX|||WT^WEIGHT||102|pounds|
OBX|||HT^HEIGHT||32|cm|

 

Articles in this section

Was this article helpful?
0 out of 0 found this helpful