Programmers HL7 Transport

This document is intended for programmers interested in the transport HL7 messages to this system over the Internet. HL7 is used to convey patient and prescription information from remote systems such as EMRs. Standard HL7 messages are enveloped for secure transport in a stateless, request/response messaging scheme. For scaleability reasons, socket connections are closed between sessions but sessions may contain multiple messages. The interface described in this document is purposely designed to allow ease of learning, implementation and testing. An authentication layer is added in order to identify systems with each other.

You will see that the HL7 interface with this system purposely mimics what browsers send via a HTTP form submits. This means with a simple form, action and form inputs, a human can easily send messages for testing purposes using only a browser. This is a huge time saver since programmers can readily see the target system's response and verify that the target system is working correctly.

Transport: HTTPS is used for transport. The privacy of patient and prescribing information must always be maintained so no non-secure transport is allowed. The system accepts both GET and POST HTTPS messages. If using GET, the parameters values must be URL Encoded in the query portion of the GET message's name/value pairs. (...&username=jsmith&password=...)

Authentication: You must obtain a username/password from this system in order to submit HL7 messages. The username/password is used as a system wide authentication to prevent from any unauthorized systems from submitting HL7 messages. The information in the HL7 segments are used to determine site and location information.

Test form for submitting HL7 messages:
Here are some sample messages to submit to system after you get a username and password:

Sample HL7 Msg 1:
MSH|^~\&|NextGen Rosetta|NextGen Clinic^0001|Billing System|Billing System|20061024102501||RDE^O11|1161699899|P|2.3
PID|1||33||PATIENT^TEST^B||19820201|M|||1234 Main ST^^Horsham^PA^19044^USA^^^MONTGOMERY||2155555555||Spanish|S|||123467102|||||||||||N
PV1|1||00600||||111^Venier^David^J||||||||||||126|||||||||||||||||||||||||200610241020
ORC|RF|1|||||||20061024|||111^Welby^Marcus^A
RXE|1^^^20061024^20061028|00045048235^TYLENOL||| ||1CAP PO Q8H^Take one capsule by mouth every eight hours||G|||0 ||||-2|2 |20061024

Sample HL7 Msg 2:
MSH|^~\&|NextGen Rosetta|NextGen Clinic^0001|Billing System|Billing System|20061024104204||RDE^O11|1161699900|P|2.3
PID|1||33||PATIENT^TEST^B||19820201|M|||1234 Main ST^^Horsham^PA^19044^USA^^^MONTGOMERY||2155555555||Spanish|S|||123467102|||||||||||N
PV1|1||00600||||111^Venier^David^J||||||||||||126|||||||||||||||||||||||||200610241020
ORC|NW|2|||||||20061024|||111^Venier^David^J
RXE|2^^^20061024^20061229|00002400602^PROZAC||| ||3P VN QOD^Inhale three times via nostril every other day||G|||3 ||||3| |