Professional Documents
Culture Documents
HL7 Supply Interface Spec 67-3078C+
HL7 Supply Interface Spec 67-3078C+
Specification
67-3078 Rev C
This guide is CONFIDENTIAL and designed only for Omnicell Technical personnel and/or designated
representatives.
This guide and accompanying software and/or hardware described in it are protected under copyright laws and may
not be copied, wholly or in part, without the express written consent of Omnicell, Inc. The same proprietary and
copyright notices must be attached to any permitted copies as were attached to the original documents.
Omnicell, Inc.
1201 Charleston Road
Mountain View, CA 94043
(650) 251-6100
www.omnicell.com
Omnicell and the Omnicell design mark, OmniBuyer, OmniCenter, OmniRx, OmniSupplier, SafetyMed, SafetyPak,
SafetyStock, and Sure-Med are registered trademarks. Anesthesia TT, Anesthesia Workstation, Anywhere RN,
Executive Advisor, Flexbin, Medication Surveillance, OmniDispenser, OmniLinkRx, OmniScanner, OmniTrack,
Omni TT, Open Touch, OptiFlex, OptiFlex MobileTrack, Point-to-Point Medication Safety, SecureVault, See & Touch,
SinglePointe, TempCheck, Touch & Go, VSuite, and WorkflowRx are trademarks of Omnicell, Inc. in the United States
and internationally. All other trademarks and trade names are the property of their respective owners.
Copyright 2010-2012 Omnicell, Inc. All rights reserved.
Table of Contents
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Inventory Interface Information Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Replenishment Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Local Supply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Non-Stock Supply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
Command Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
Code Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
For 12.0 servers:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
For 16.5 servers:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IN-1
Overview
In order for Omnicell system to be fully integrated into the hospital’s information systems
solution, it should automatically exchange information with other systems that are part of that
solution. The exchange of information with the Omnicell system will be accomplished via a batch
interface, which complies with HL7 standards.
The exchange of information between the Omnicell system and other vendor products falls into
the following categories:
Patient admission, discharge and transfer information passing from the ADT system to the
Omnicell system (ADT)
Charge information passing from the Omnicell system to the billing or financial system
(CHG)
Patient booking information from an Operating Management System (SCH)
Inventory information passing from the Omnicell system to the Materials Management
system, and vice versa; Omnicell supports the following inventory interfaces:
Inventory Adjustment Information (XOR)
Inventory Re-order Information (ORD)
Quantity on Hand Information (REQ)
Advanced Shipping Notices (ASN)
Restock Complete Information (IRC)
Item Master Database Update Information (IMU)
This document specifically covers inventory interfaces between Omnicell and the hospital’s
Materials Management System.
ADT and CHG real time interfaces can be found in HL7 Pharmacy Interface Specification (67-2070).
Replenishment Interface
Local Supply
4. Display shelf
locations for
1. On-hand or
restocking
re-order
quantity
XPC
DB OmniCenter
There are a number of ways to interface with the supply inventory system and to initiate
restocking. The most simple case is where inventory is held primarily in a central supply location
within the hospital. In this case, two methods of interfacing are used.
Method 1: A handheld counting system is emulated where Omnicell delivers the quantity on hand
information to the inventory system. In this case the restock quantity and pick lists are printed by
the existing inventory system.
Method 2: Omnicell generates the pick lists, and then communicate the re-order quantity to the
inventory system. Omnicell has the ability to store a different re-order point, below the par level.
This reduces the number of line items handled on each restocking trip. A critically low level is also
provided which indicates that stock is at critical level.
In both methods, the quantity to be restocked is sent to the cabinet. When the re-stock technicians
arrive at the cabinet, they enter the system in normal re-stock mode. A list of restock orders is
displayed. They select the order they are filling. The lights next to the items to be restocked on that
order are lit. This guides the technicians through the restocking process.
The system specifies exactly how much is to be restocked. The technician simply has to select the
flashing item button for all items (except those on back-order), perform the restock, then push the
button again to acknowledge the quantity restocked.
This contrasts with systems that do not receive the quantity picked, then compute the value from
the par level and the quantity on hand at the time the technician arrives at the cabinet. Because
these values may be different than at the time the pick list was generated, the technician must
check the value for every item. This greatly increases the restock time.
Non-Stock Supply
XPC 3. Return
DB OmniCenter Advance
Shipping
Notice 6. Confirm
Inventory 2. Generate restock
Purchase quantity
Management
System Orders
The Omnicell system was designed with all levels of non-stock and just in time (JIT) inventory
systems in mind. For non-stock systems, OmniCenter sends either the quantity on hand or the
quantity to be re-ordered to the inventory/purchasing system. It sends the information in the form
of an electronic purchase order to the distributor.
Omnicell could provide EDI interfaces directly to distributors using the X.12 standard. However,
hospitals have typically chosen to consolidate Omnicell purchase orders with other EDI orders
through their own system.
Once the order is placed, Omnicell can receive back the quantity ordered from the purchasing
system with the associated P.O. number or in the form of an advanced shipping notice sent
through the purchasing system from the distributor. This information is sent in advance to the
appropriate cabinet.
When the technicians bring the items to restock the cabinet, they select the P.O. number displayed
on the PC screen that matches the P.O. or shipping number on their re-stock list. The lights for all
the items on the corresponding restock list are lit up on the cabinet. Pushing one of these lit
buttons once, displays the quantity to be restocked. There is an opportunity at this point to change
the restock number if the quantity of items brought is not the same. Pushing the button accepts
the number displayed and turns that light out. The technician proceeds until all the lights are out.
The quantities actually stocked are sent to the Omnicenter. They can be used to print exception
reports or sent on to the purchasing system to be matched against invoices as a receiving function.
HL7 Messages
HL7 Implementation
The specification described in this chapter follows the HL7 (health level 7) standard to format
messages. The majority of the messages and segments in this specification are standard HL7
messages and segments.
HL7 Z segments are used where no HL7 segment has been defined for the necessary information.
They are also formatted to the HL7 standard. This chapter only covers segments used by
Omnicell. Detailed information about each field element can be found in the HL7 Implementation
Guide. Omnicell supports HL7 versions 2.1 thru 2.5.
The communications protocol is described in Appendix C of the HL7 Implementation Guide.
Omnicell can interface using either the Hybrid Lower Layer Protocol for a serial RS-232
connection (Section C.2) or the Minimal Lower Layer Protocol for a network environment
(Section C.4). Omnicell recommends the use of Minimal Lower Layer Protocol over a TCP-IP
socket connection.
Message Delimiters
Certain special characters are used to construct a message. They are the:
Segment terminator
Field separator
Component separator
Subcomponent separator
Repetition separator
Escape character
The segment terminator is always a carriage return (in ASCII, a hex 0D) for real-time interfaces.
The other delimiters are defined in the message segment header (MSH) segment. The delimiters
occur as specified in the Encoding Character Position column of the message delimiter table
(Table 2-1).
The delimiter values used in the MSH segment are the delimiter values used throughout the entire
message. In the absence of other considerations, HL7 recommends using the Suggested Values of
the message delimiter table (Table 2-1).
At any given site, the subset of the possible delimiters may be limited by negotiations between
applications. This implies that the receiving applications will use the agreed upon delimiters, as
they appear in the MSH, to parse the message.
Encoding
Suggested Character
Delimiter Value Position Usage
Segment Terminator <cr> (hex 0D) - Terminates a segment record.
Field Separator | - Separates two adjacent data fields within a segment. It also separates the segment ID from
the first data field in each segment.
Component Separator ^ 1 Separates adjacent components of data fields where allowed.
Subcomponent & 4 Separates adjacent subcomponents of data fields where allowed. If there are no
Separator subcomponents, this character may be omitted.
Repetition Separator ~ 2 Separates multiple occurrences of a field where allowed.
Escape Character \ 3 Escape character for use with any field represented by an ST, TX or FT data type, or for use
with the data (fourth) component of the ED data type. If no escape characters are used in a
message, this character may be omitted. However, it must be present if subcomponents are
used in the message.
Table 2-1. Message delimiters
ADT Interface
The ADT interface processes admission, discharge and transfer information.
Admission, Discharge, and Transfer (ADT) messages are sent from the ADT system to the
Omnicell system to allow each Omnicell cabinet to maintain an up-to-date demographic and visit
information about the patients. When any of the supported trigger events occur on the ADT
system, the corresponding HL7 interface message are translated and transmitted to the Omnicell
system. Once the interface message is sent to the Omnicell system, a Message Acknowledgment
(MSA) message is sent by the Omnicell system to the ADT system confirming that the
transmission was successful. The Omnicell system will then process the message to update
Omnicell patient database.
General Information
Communication mode: TCP/IP socket, MLLP
HL7 v2.1-5 formats supported
Omnicell configuration: socket server (listening socket)
Requires IP address and agreed upon port number for connecting to Omnicell
ADT may share connection with RXP
Acknowledgment Message
As inbound interface, ADT interface is able to generate the generic HL7 acknowledgement
message with AA as the acknowledgement code. A negative acknowledgment (AE) code will be
sent when ADT receives ill-formatted HL7 messages. This means Omnicell is signaling the ADT
system to send a next transaction because the current record is rejected. Content validation shall
be carried out during translation of the message, and therefore, content errors will not be
communicated back to the sending system.
The acknowledgment message consists of a message header and an acknowledgement segment.
Note: The following tables have OmniCenter tokens in bold under Comments.
Name Definition
MSH Message Header
EVN Event Type
PID Patient OD
PV1 Patient Visit
[{AL1}] Allergy Information
[MRG] Merge Patient Information (merge events)
[{OBX}] Observation/Results
The segments listed under each message are the segments that the Omnicell system processes
unless specified otherwise. If additional segments (Z-segments or segments not in the HL7
specification) are sent within the messages, Omnicell ignores them. Fields within a segment are
ignored if the Omnicell system does not process them. Complete messages and segments may be
sent by the sending system. The Omnicell system handles the filtering of segments and fields that
it does not need.
The length of the data fields used by Omnicell is based upon the maximum length defined in the
Omnicell data dictionary. Length of the data fields not used by Omnicell follows the length as
defined in the HL7 standard document.
Note: The following tables have OmniCenter tokens in bold under Comments.
Required/
Sequence Length Optional Element Name Comments
1 3 R Event Code Refer to “Supported Message Events” on page 3-2.
2 26 R Recorded Date/Time Format: YYYYMMDDHHMMSS
3 26 O Date/Time Planned Event Not used
4 3 O Event Reason Code Not used
5 250 O Operator ID Not used
6 26 O Event Occurred Not used
7 241 O Event Facility Not used
Table 3-2. Event type
Allergy information is generally updated during patient admission. In most cases, accurate allergy
information is recorded at the time doctors are prescribing medication. Thus, it is a common
practice allergy is updated from the RDE message (RXP interface). Regardless, the decision on
which interface should be used to update allergy information must be agreed upon by customers,
pharmacy vendor and the Omnicell installation team. As a default, allergy update in ADT
interface is disabled although it can easily be turned on.
If Allergy Alert feature is used, the ADT system is required to send valid allergy codes to
Omnicell. With this feature, allergies are referenced using allergy codes. In addition, this interface
is capable of dynamically updating Omnicenter Allergy database from patient's allergy
information so users will not have to manually add codes to the database.
OBX– Observation/Results
The OBX segment is a repeating segment used to transmit a single observation or observation
fragment. It represents the smallest indivisible unit of a report. For this interface, this segment is
specifically used to retrieve height and weight of a patient.
Required/
Sequence Length Optional Element Name Comments
1 4 O Set ID - OBX
2 2 C Value Type
3 250 R Observation Identifier OBX.3.2 can be either “WEIGHT” or “HEIGHT”. Updates pwt and
pht data fields, respectively in Omnicell
4 20 C Observation Sub-ID
5 5 C Observation Value pht for height, or pwt for weight; Value is associated with the
value of OBX.3.2
6 5 O Units Units of measures must be CM for height, and KG for weight
7 60 O References Range
8 5 O Abnormal Flags
9 5 O Probability
10 2 O Nature of Abnormal Test
11 1 O Observation Result Status
12 26 O Date Last Observation Normal Value
13 20 O User Defined Access Checks
14 25 O Date/Time of the Observation
15 250 O Producer's ID
16 250 O Responsible Observer
17 250 O Observation Method
18 22 O Equipment Instance Identifier
19 26 O Date/Time of the Analysis
Table 3-6. Observation/Results
Required/
Sequence Length Optional Element Name Comments
1.1 16 R Prior Patient Identifier List
2 16 B Prior Alternate Patient ID
3 16 R Prior Patient Account Number
4 16 B Prior Patient ID
5 16 R Prior Visit Number
6 16 O Prior Alternate Visit ID
7 32 R Prior Patient Name
Table 3-7. Merge patient information
Mapping Tables
Facility Mapping - ADT Facility
The facility mapping table is used for accommodating multi-facility accounts. This will be used
for distributing transactions to appropriate Omnicenter server. The source of data may change
depending on the vendor system. Generally, the data originates from the Sending Facility field in
the MSH segment. That value is translated to its corresponding Site ID in Omnicenter.
CHG Interface
The CHG interface processes patient charges and credits.
When a drug or item is removed from the Omnicell cabinet, a charge transaction is automatically
generated for the patient for whom the item was selected. If an item, which was selected for a
patient, is returned to the cabinet, a credit transaction is automatically generated for the patient
from whom the item was returned. This charge/billing information can then be sent from the
Omnicell system to the hospital's financial or billing system in either real-time or batch mode,
depending on the receiving vendor system's requirements. A financial transaction (DFT) message
is the preferred format used by the Omnicell system.
General Information
Connection: TCP/IP Socket, MLLP, or via Net bios or FTP as batch file
HL7 v2.1-5 formats supported.
Omnicell is configured as socket client, or batch file.
Requires IP address and agreed upon port number for connecting to the pharmacy or financial
system for real-time mode. Batch requires login credentials to access destination folder.
The length of the data fields used by Omnicell is based upon the maximum length defined in the
Omnicell data dictionary. Length of the data fields not used by Omnicell follows the length as
defined in the HL7 standard document.
Note: The following tables have OmniCenter tokens in bold under Comments.
1
Source of data may change depending on the vendor system. A Facility mapping table may be
needed to accommodate multi-facility accounts. Otherwise, get value from Sending Application
in NODE.INI.
2
Source of data may change depending on the vendor system. A Facility mapping table may be
needed to accommodate multi-facility accounts. Otherwise, get value from Sending Facility in
NODE.INI.
3
Source of data may change depending on the vendor system. A Facility mapping table may be
needed to accommodate multi-facility accounts. Otherwise, get value from Receiving Application
in NODE.INI.
4
Source of data may change depending on the vendor system. A Facility mapping table may be
needed to accommodate multi-facility accounts. Otherwise, get value from Receiving Facility in
NODE.INI
EVN – Event
t
Required/
Sequence Length Optional Element Name Comments
0 3 R Segment Name EVN
1 3 R Event Code P03
2 16 R Transaction Date and Time Format: YYYYMMDDHHMMS
Table 4-2. Event
5
The TO field in the mapping table may contain multiple Floor Stock locations. Use ^ to separate
each floor stock location. When an OmniSupplier ID is mapped to multiple locations, generate
the same exact message and set ZPM.3 accordingly for each location.
SCH Interface
The SCH interface processes operating room (OR) scheduling.
The OR Scheduling Interface enables OmniCenter to receive OR booking information from an
OR Scheduling System when a patient is scheduled for a new surgery, an existing surgery booking
is modified, a booking is rescheduled, or a booking is cancelled. It enables end users and
schedulers to view all appointments scheduled for a patient across departments. In addition, this
interface can be used to inform any system of the patients coming in for surgery as well as the
details of the patient's surgeries such as surgery time, location and procedure.
Patients are booked for surgeries in OR Scheduling department. Omnicell supports the following
HL7 SIU message type trigger events:
S12 - New appointment
S13 - Reschedule appointment
S14 - Modify appointment
S15 - Cancel appointment
Typical Workflows
Workflow 1
1. The OR scheduler is informed by a doctor's office that a patient needs to be scheduled for
surgery.
2. The patient is booked for surgery in the OR department.
3. An S12 HL7 outbound scheduling message is sent to Omnicell including a unique case or
booking number.
4. A case is added to Omnicell Case table upon receiving the message from the OR scheduling
system.
Workflow 2
1. The OR scheduler reschedules a booking by moving it through manage booking or the grid.
2. An S13 HL7 outbound scheduling message is sent to Omnicell including the case or booking
number.
3. Omnicell receives the message and updates the patient's appointment in the Case table.
Workflow 3
1. The OR scheduler modifies a booking by changing any information that is not associated with
the time, date, duration, or room and re-files the booking.
2. An S14 HL7 outbound scheduling message is sent to Omnicell including the case or booking
number.
3. The Omnicell system updates the OR appointment for the patient in the Case table.
Workflow 4
1. The OR scheduler cancels a booking.
2. An S15 HL7 outbound scheduling message is sent to Omnicell including the case or booking
number.
3. Omnicell receives the message and cancels the patient's appointment in the Case table.
General Information
Real-time via TCP/IP socket, MLLP
Connection is persistent
HL7 v2.1-6 formats supported
Name Definition
MSH Message Header
{
EVN Event Type
PID Patient Identification
PV1 Patient Visit
SCH Schedule Activity Information
AIS Appointment Information - Service Segment
AIP Appointment Information - Personnel Resource Segment
AIL Appointment Information - Location Resource Segment
[AIG] Appointment Information - General Resource
}
Note: The following tables have OmniCenter tokens in bold under Comments.
Required/
Sequence Length Optional Element Name Comments
1 3 R Event Type S12 - New Appointment (A)
S13 - Reschedule Appointment (U)
S14 - Modify Appointment (U)
S15 - Cancel Appointment (D)
2 16 R Recorded Date/Time Format: YYYYMMDDHHMMSS
Table 5-2. Event type segment
XOR Interface
The XOR interface processes inventory adjustment information.
If the Materials Management department wants the Materials Management system to receive
inventory adjustment (depletion, return and other transactions affecting quantity on hand)
information, the Omnicell system can pass each item transaction record to the materials
management system. This information can be passed from the Omnicell system to the materials
management system as the transaction occurs on the Omnicell system (real-time), or the
transaction can be passed in a batch file once or more each day.
Hospital
System Interface services OmniCenter
Application Application
Application
General Information
Communication mode: Batch file via file transfer protocol (FTP) or network drive mapping
HL7 v2.1-5 formats supported
Omnicell configuration: send a batch file on a scheduled basis
Name Definition
MSH Message Header
{
ORC Common Order Segment
{
RQD Requisition Detail Segment
[RQ1] Requisition Detail – 1 Segment
}
}
The segments listed under each message are the segments that the Omnicell system processes
unless specified otherwise. If additional segments (Z-segments or segments not in the HL7
specification) are sent within the messages, Omnicell ignores them. Fields within a segment are
ignored if the Omnicell system does not process them. Complete messages and segments may be
sent by the sending system. The Omnicell system handles the filtering of segments and fields that
it does not need.
The length of the data fields used by Omnicell is based upon the maximum length defined in the
Omnicell data dictionary. Length of the data fields not used by Omnicell follows the length as
defined in the HL7 standard document.
Note: The following tables have OmniCenter tokens in bold under Comments.
Required/
Sequence Length Optional Element Name Comments
1 2 R Order Control NW
2 16 R Placer Order Number ^OMNI – assuming caret is subfield delimiter
4 22 O Placer Group Number ^OMNI – assuming caret is subfield delimiter
6 1 O Response Flag N
9 14 O Date/Time of Transaction Format: YYYYMMDDHHMMSS
10 250 O Entered by User formatted according to HL7 standard
18.2 250 O Entering Device "OMNI Interface"
Table 6-2. Common order segment
ORD Interface
The ORD interface processes inventory re-order information.
A customer’s Materials Management department can choose to have inventory re-order
information sent from the Omnicell system to the Materials Management system. A pick list
information is generated in Omnicell and sent to the Materials Management system via an
interface.
Par levels and re-order levels are stored on the Omnicell system. They are used to calculate re-
order quantities for each item. A pick list file of the reorder quantities is generated whenever a
user at the OmniCenter chooses to generate a pick list. At that time, the pick list information is
communicated to the materials management system either as individual records or as a batch file
containing information on the complete pick list.
Hospital
System Interface services OmniCenter
Application Application
Application
General Information
Communication mode: Batch file via file transfer protocol (FTP) or network drive mapping
HL7 v2.1-5 formats supported
Omnicell configuration: Send file on a scheduled basis
Name Definition
FHS HL7 file header
BHS HL7 batch header
MSH Message Header
MFI Master File Identification
{
MFE Master File Entry
[ZPL] Pick List File Record
}
The segments listed under each message are the segments that the Omnicell system processes
unless specified otherwise. If additional segments (Z-segments or segments not in the HL7
specification) are sent within the messages, Omnicell ignores them. Fields within a segment are
ignored if the Omnicell system does not process them. Complete messages and segments may be
sent by the sending system. The Omnicell system handles the filtering of segments and fields that
it does not need.
The length of the data fields used by Omnicell is based upon the maximum length defined in the
Omnicell data dictionary. Length of the data fields not used by Omnicell follows the length as
defined in the HL7 standard document.
Note: The following tables have OmniCenter tokens in bold under Comments.
REQ Interface
The REQ interface processes quantity on hand information.
The current quantities on hand at all cabinets are required to calculate re-order quantities before
pick lists or purchase orders are generated. If the Materials Management system is receiving
inventory depletion information in real time from the Omnicell system, it could calculate quantity
on hand at any time.
If inventory depletion information is not received in real time, the Materials Management system
will need the Omnicell system to send the quantity on hand for each cabinet just prior to
generating pick lists or purchase orders. This is accomplished by sending an Inventory Status
Request message to the Omnicell system. A Quantity on Hand Report is returned.
Hospital
System
Application OmniCenter
Interface services
Application
Application
General Information
Communication mode: Batch file via file transfer protocol (FTP) or network drive mapping
HL7 v2.1-5 formats supported
Omnicell configuration: send a file on a scheduled basis
Step A
Event Code QRY - Status Report Query
Step B
Event Code ZUS - Unit Status (Quantity on Hand) Report
Note: Step A is optional. The REQ interface can be configured to automatically generate QOH information on
a scheduled basis. However, all cabinets will be included in the QOH message. Step A may be implemented if
the inventory system is capable of sending QOH query by cabinet.
The segments listed under each message are the segments that the Omnicell system processes
unless specified otherwise. If additional segments (Z-segments or segments not in the HL7
specification) are sent within the messages, Omnicell ignores them. Fields within a segment are
ignored if the Omnicell system does not process them. Complete messages and segments may be
sent by the sending system. The Omnicell system handles the filtering of segments and fields that
it does not need.
The length of the data fields used by Omnicell is based upon the maximum length defined in the
Omnicell data dictionary. Length of the data fields not used by Omnicell follows the length as
defined in the HL7 standard document.
ASN Interface
The ASN interface processes advanced shipping notices.
An Advanced Shipping Notice (ASN) includes quantities of which items are being sent for
restocking on each cabinet. The items sent from the supply room or vendor are expected to be
physically restocked in cabinets soon (hours or days if ordered from a vendor) after the pick list is
transmitted. Cabinets use the ASN information allows the lights on the cabinet to show the
restock technician the locations of the items to be restocked.
The ASN message is the same as the Inventory Re-order Information message. The difference is
that an Inventory Re-order Information message is sent from the Omnicell system to the
Materials Management system while the ASN message is sent from the Materials Management
system to the Omnicell system.
This message is optional, depending on the needs of the hospital’s Materials Management
department.
Hospital
System
Application OmniCenter
Interface services
Application
Application
General Information
Communication mode: Batch file via file transfer protocol (FTP) or network drive mapping
HL7 v2.1-5 formats supported
Omnicell configuration: receive a file from the inventory system; The existence of the input file
triggers ASN to automatically process the batch file.
Name Definition
MSH Message Header
MFI Master File Identification
{
MFE Master File Entry
[ZPL] Pick List File Record
}
The segments listed under each message are the segments that the Omnicell system processes
unless specified otherwise. If additional segments (Z-segments or segments not in the HL7
specification) are sent within the messages, Omnicell ignores them. Fields within a segment are
ignored if the Omnicell system does not process them. Complete messages and segments may be
sent by the sending system. The Omnicell system handles the filtering of segments and fields that
it does not need.
The length of the data fields used by Omnicell is based upon the maximum length defined in the
Omnicell data dictionary. Length of the data fields not used by Omnicell follows the length as
defined in the HL7 standard document.
Note: The following tables have OmniCenter tokens in bold under Comments.
IRC Interface
The IRC interface processes restock complete information.
When a restock technician completes the restocking process for a cabinet, a Restock Complete
message is sent to the Materials Management system. This verifies for the Materials Management
system that the restocking had been completed. It also shows the quantity of items physically
restocked. This quantity can be compared to the quantity ordered. The numbers should be the
same. This interface is optional depending on the need to compare the two quantities.
Hospital
System Interface services OmniCenter
Application Application
Application
General Information
Communication mode: Batch file via file transfer protocol (FTP) or network drive mapping
HL7 v2.1-5 formats supported
Omnicell configuration: send a file to the Material Management system
Name Definition
FHS HL7 file header
BHS HL7 batch header
MSH Message Header
MFI Master File Identification
{
MFE Master File Entry
[ZRC] Restock Complete Record
}
The segments listed under each message are the segments that the Omnicell system processes
unless specified otherwise. If additional segments (Z-segments or segments not in the HL7
specification) are sent within the messages, Omnicell ignores them. Fields within a segment are
ignored if the Omnicell system does not process them. Complete messages and segments may be
sent by the sending system. The Omnicell system handles the filtering of segments and fields that
it does not need.
The length of the data fields used by Omnicell is based upon the maximum length defined in the
Omnicell data dictionary. Length of the data fields not used by Omnicell follows the length as
defined in the HL7 standard document.
Note: The following tables have OmniCenter tokens in bold under Comments.
IMU Interface
The IMU interface process item master updates.
The IMU interface can be implemented to transmit information whenever items are modified,
added or deleted on the Materials Management system. It is assumed that the Materials
Management system is the owner of the Inventory Master File. Any modifications, additions or
deletions made to the inventory master file must be keyed into the Materials Management system.
In order to allow users at workstations on the Materials Management system to modify, add or
delete items on each cabinet, an HL7 message has been defined for the exchange of the necessary
information. Entering modifications, additions or deletions into the Materials Management
system should trigger the corresponding HL7 interface message to be formatted and transmitted
to the Omnicell system.
Hospital
System
Application OmniCenter
Interface services
Application
Application
General Information
Communication mode: Batch file via file transfer protocol (FTP) or network drive mapping
HL7 v2.1-5 formats supported
Omnicell configuration: receive a file from the inventory system; The existence of the input file
triggers ISU to automatically process the batch file.
*For MUP item update, IMU interface only updates item cost and item price.
Name Definition
MSH Message Header
{
MFE Master File Entry
[ZMI] Master Item File Record
}
The segments listed under each message are the segments that the Omnicell system processes
unless specified otherwise. If additional segments (Z-segments or segments not in the HL7
specification) are sent within the messages, Omnicell ignores them. Fields within a segment are
ignored if the Omnicell system does not process them. Complete messages and segments may be
sent by the sending system. The Omnicell system handles the filtering of segments and fields that
it does not need.
The length of the data fields used by Omnicell is based upon the maximum length defined in the
Omnicell data dictionary. Length of the data fields not used by Omnicell follows the length as
defined in the HL7 standard document. The caret (^) in the example indicates subfield delimiter.
Note: The following tables have OmniCenter tokens in bold under Comments.
MSH|^~\&|||||200706040944||ZUSER|HL7O.4.11307|P|2.1
MFE|MUP
ZMI|JDC23^Update the master|||JDC23_Alias||||||||||||
Appendix A: PK Command
This command allows a hospital to change its patient identification when migrating to a new
system. It is used with the ADT interface.
Configuration
No configuration changes are required for this feature.
Database
No database table or field changes are required for this feature
Implementation
The existing command processing infrastructure will be used to handle this new command so no
additional error handling or error reporting function needs to be added.
The coding effort is essentially an extension to existing code.
Command Details
Token Description Rule Notes
pid Existing patient ID U16 Any value longer than 16 will be rejected
pidn New patient ID U16 Any value longer than 16 will be rejected; cannot be blank; cannot start with '*'; cannot be existing patient id
Code Changes
ff_process:get_obj Add command to patient group.
ff_patient:process input Add call to processing function.
ff_patient:pk() Author command processing function with business rules.
CPatient:Change Pat ID() Author DB access sub-function
Exceptions
The following tables are not updated by the PK command as specified by software version.
Index
A I
acknowledgement segment (MSA) 3-3 IMU interface 11-1
admission, discharge, transfer 3-1 inventory adjustment 6-1
ADT inventory re-order 7-1
acknowledgment message 3-2 inventory request 8-1
ADT interface 3-1 IRC interface 10-1
advanced shipping notices 9-1 IRC message 10-4
allergy information (AL1) 3-7 item master updates 11-1
ASN interface 9-1
ASN Message 9-3 M
mapping tables 3-9
B master file entry (MFE) 7-4, 9-3, 10-3, 11-2
backward compatibility 2-2 master file identification (MFI) 7-3, 9-2, 10-3
batch header (BHS) 7-3, 10-2 master item file (ZMI) 11-3
medical record number A-1
C merge patient information (MRG) 3-9
common order segment (ORC) 6-2 message events
communications protocol 2-1 ADT 3-2
component separator 2-1 message header (MSH) 3-5, 4-2, 5-3, 6-2, 10-3
message header segment (MSH) 3-3
D message segment header 2-1
message segments
DFT message 4-5
ADT 3-4
ORD 7-2
E SIU 5-2
escape character 2-1 XOR 6-1
event (EVN) 4-3 messages 2-1
event code MFN messages 11-3
QRY 8-2 Minimal Lower Layer Protocol 2-1
ZUS 8-2 MRN A-1
event type (EVN) 3-5
event type segment (EVN) 5-3 O
observation/results (OBX) 3-8
F operating room scheduling 5-1
field separator 2-1 ORD interface 7-1
field use 2-2
file header (FHS) 7-2, 10-2 P
financial transaction (DFT) 4-1
patient charges 4-1
financial transaction (FT1) 4-4
patient credits 4-1
formats supported 3-1, 4-1, 5-2, 6-1
patient ID A-1
patient identification (PID) 3-6, 4-3, 5-4
H patient visit (PV1) 3-7, 4-3
HL7 standard 2-1 pick list file (ZPL) 7-4, 9-3
Hybrid Lower Layer Protocol 2-1 pick list message 7-4
PK command A-1
code changes A-2
exceptions A-2
pocket activity (ZPM) 4-5
Q
quantity on hand 8-1
Quantity on Hand Report 8-1
query definition segment (QRD) 8-3
query filter segment (QRF) 8-4
R
record level event codes 11-1
repetition separator 2-1
replenishment interface
local supply 1-2
non-stock supply 1-3
REQ interface 8-1
requisition detail segment (RQD) 5-5, 6-3
restock complete (ZRC) 10-4
S
SCH interface 5-1
segment attribute 2-2
segment terminator 2-1
sequence number protocol 2-2
SIU message 5-6
subcomponent separator 2-1
T
transactions tables A-1
trigger event 2-2
U
unit status report (ZSR) 8-4
W
waste tables A-1
X
XOR interface 4-1, 6-1
XOR message 3-10, 6-3
Z
Z segment 8-4, 10-4, 11-3
ZUS message 8-4
Feedback Form
Name: E-mail:
Dept./Title: Phone:
Feedback: