RADx® MARS: Getting started: HL7v2

Links

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 fieldHL7v2 Element
Sending system OIDMSH-3.2
Sending facility nameMSH-4.1
Sending facility IDMSH-4.2
Filler Order Number Assigner OIDOBR-3.3
Filler Order Number Assigner OIDORC-3.3
Patient ID AssignerPID-3.4.2
Specimen ID Assigner OIDSPM-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 fieldHL7v2 Element
Test ordered codeOBR-4.1
Test ordered descriptionOBR-4.2
Test performed codeOBX[1]-3.1
Test performed descriptionOBX[1]-3.2
Device identifierOBX[1]-17.1
Specimen type codeSPM-4.1
Specimen type descriptionSPM-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
5.1
MSH
5.2
MSH
5.3
MSH
6.1
MSH
6.2
MSH
6.3
APHL AIMS TestingAIMS.INTEGRATION.STG2.16.840.1.114222.4.3.15.2ISOAIMS.PLATFORM2.16.840.1.114222.4.1.217446ISO
APHL AIMS ProductionAIMS.INTEGRATION.PRD2.16.840.1.114222.4.3.15.1ISOAIMS.PLATFORM2.16.840.1.114222.4.1.217446ISO
ReportStreamCDC PRIME2.16.840.1.114222.4.1.237821ISOCDC PRIME2.16.840.1.114222.4.1.237821ISO