Skip to main content

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

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 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
5.1

MSH
5.2

MSH
5.3

MSH
6.1

MSH
6.2

MSH
6.3

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