Links
- HL7v2 implementation guide
- Test-Specific HL7v2 Field Values Tool
- HL7v2 message validation
- MARS HL7v2 application programming interface (API)
Documentation
HL7v2 implementation guide
The HL7v2 implementation guide is available for online viewing and as a downloadable spreadsheet.
Patient-specific fields
Patient-related fields fall into two categories: (1) user profile (such as name, address, phone) and (2) test results. User profile fields should require a one-time entry by the individual user of the application. Test result fields need to be populated separately every time a test is taken.
Sender-specific fields
Sender-specific fields help to uniquely identify the sending application and are shown in the table below.
Sender-specific field | HL7v2 Element |
---|---|
Sending system OID | MSH-3.2 |
Sending facility name | MSH-4.1 |
Sending facility ID | MSH-4.2 |
Filler Order Number Assigner OID | OBR-3.3 |
Filler Order Number Assigner OID | ORC-3.3 |
Patient ID Assigner | PID-3.4.2 |
Specimen ID Assigner OID | SPM-2.2.3 |
The values of these fields will be provided by the Association of Public Health Laboratories (APHL) and will be unique to each application.
To request sender-specific field values for your organization and/or application, follow the link below.
Sender-specific field values request form
To look up existing sender/receiver-specific field values, follow the link below.
Sender/receiver-specific field values look up
Test-specific fields
Test-specific fields help to uniquely identify the type of test that is taken and are shown in the table below. A diagnostics company may manufacture different types of tests. Each type of test will have its own unique ID.
Test-specific field | HL7v2 Element |
---|---|
Test ordered code | OBR-4.1 |
Test ordered description | OBR-4.2 |
Test performed code | OBX[1]-3.1 |
Test performed description | OBX[1]-3.2 |
Device identifier | OBX[1]-17.1 |
Specimen type code | SPM-4.1 |
Specimen type description | SPM-4.2 |
The Test-Specific HL7v2 Field Values Tool is a tool that helps to identify the appropriate values for the above fields.
Receiver-specific fields
Receiving System |
MSH |
MSH |
MSH |
MSH |
MSH |
MSH |
---|---|---|---|---|---|---|
APHL AIMS Testing |
AIMS.INTEGRATION.STG |
2.16.840.1.114222.4.3.15.2 |
ISO |
AIMS.PLATFORM |
2.16.840.1.114222.4.1.217446 |
ISO |
APHL AIMS Production |
AIMS.INTEGRATION.PRD |
2.16.840.1.114222.4.3.15.1 |
ISO |
AIMS.PLATFORM |
2.16.840.1.114222.4.1.217446 |
ISO |
ReportStream | CDC PRIME | 2.16.840.1.114222.4.1.237821 | ISO | CDC PRIME | 2.16.840.1.114222.4.1.237821 | ISO |