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 |