Lab Results Feed Specifications
Photon does not make use of every data element in the typical OBR/OBX message. Since our focus is on acute care scenarios we require a subset of the total data.
Message Header
Event Date
This marks the date and time of the HL7 message. We use this date to prevent older messages from updating current data.
MSH.7.1
YYYYMMDDHHMMSS
Hospital Indicator
This is a code used to identify the source hospital.
MSH.4.1
string
Message Body - Patient & Order Header
Patient Medical Record Number
f you support multiple medical record numbers in your ADT (multiple PID.3 segments), we typically filter to one based on the value of the PID.3.5 field
PID.3.1
string
Patient Account Number
This is the encounter or account code for the patient's visit.
PID.18.1
string
Placer Number
The order number of the system placing the order for the lab
OBR.2.1
string
Filler Number
The order number of the system fulfilling the lab
OBR.3.1
string
Lab Code
The system code for the type of lab requested
OBR.4.1
string
Lab Name
The display name for the type of lab requested
OBR.4.2
string
Date Requested
The date and time stamp for when the lab was requested
OBR.6.1
YYYYMMDDHHMMSS
Observation Start Date
The start date and time stamp for the processing of the lab results
OBR.7.1
YYYYMMDDHHMMSS
Observation End Date
The end date and time stamp for the processing of the lab results
OBR.8.1
YYYYMMDDHHMMSS
Date Received
The date and time stamp for when the results were received by the ordering system
OBR.14.1
YYYYMMDDHHMMSS
Ordering Physician ID
The internal ID of the ordering provider
OBR.16.1
string
Ordering Physician Last Name
The last name of the ordering provider
OBR.16.2
string
Ordering Physician First Name
The first name of the ordering provider
OBR.16.3
string
Ordering Physician Middle Name
optional - The middle name of the ordering provider
OBR.16.4
string
Verification Date
The date and time stamp when the results were verified
OBR.22.1
YYYYMMDDHHMMSS
Result Status Code
The status code of the lab order (ex: pending, finished, etc)
OBR.25.1
string
Message Body - Order Result
Value Type
Indicates the type of data in additional fields
OBX.2.1
string
Code
The code for the data type measured
OBX.3.1
string
Name
The display name for the data measured
OBX.3.2
string
LOINC Code
optional - the LOINC code if available for the data point being measured
OBX.3.4
string
Value
The value of the data. This can be numeric or a string value depending on the value type
OBX.5.1
string
Units
The units of the measurement
OBX.6.1
string
Reference Range
The range of what is considered normal for the data being measured
OBX.7.1
string
Abnormal Flag
A code to indicate the "abnormal state" of the data. This can indicate if the data is too high, too low, emergent, etc
OBX.8.1
string
Status Code
The status code of the measurement
OBX.11.1
string
Date of Measurement
The date and time stamp the measurement was taken
OBX.14.1
YYYYMMDDHHMMSS
Notes
optional - The additional notes submitted with the particular value measured. There can be mutiple values per OBX
NTE.3.1
string
Last updated