HL7 Pharmacies

Complete

Overview

This page describes how to configure OpenVPMS to interface with an HL7 pharmacy such as Cubex. For an overview of HL7 in OpenVPMS, see Concepts - HL7.

Configuration

To configure OpenVPMS to interface with an HL7 pharmacy the following steps must be performed:

1. Configure an HL7 MLLP Sender, to send HL7 messages to the pharmacy

2. Configure an HL7 MLLP Receiver, to receive HL7 messages from the pharmacy

3. Configure an HL7 Pharmacy with the Receiver and Sender

4. Configure an HL7 Pharmacy Group (optional)

5. Configure products to be dispensed via the Pharmacy/Pharmacy Group

1. Configuring an HL7 MLLP Sender

The HL7 MLLP Sender is used to send pharmacy orders, and patient admission and discharge messages to the pharmacy. It is configured via the Aministration - HL7 - Connectors page.

Select New - HL7 MLLP Sender and enter the pharmacy connection information as per your pharmacy provider's instructions.

2. Configuring an HL7 MLLP Receiver

The HL7 MLLP Receiver is used to receive pharmacy dispense messages from the pharmacy. It is configured via the Aministration - HL7 - Connectors page.

Select New - HL7 MLLP Receiver and enter the pharmacy information as per your pharmacy provider's instructions.

Note that Port is a TCP/IP port that OpenVPMS listens on. It must be accessible to the pharmacy through any firewall. Appropriate security precautions should be taken to avoid other parties from accessing the port.

3. Configuring an HL7 Pharmacy

The HL7 Pharmacy is used to specify a pharmacy to send pharmacy orders to, and receive dispense messages from. It is configured via the Administration - HL7 - Services page.

Select New - HL7 Pharmacy and enter the:

  • HL7 MLLP Sender configured in step 1 for the Order Connector
  • HL7 MLLP Receiver configured in step 2 for the Dispense Connector

4. Configuring an HL7 Pharmacy Group

An HL7 Pharmacy Group is used to group pharmacies by Practice Location.

It is only required for multi-location practices that use different pharmacies for each practice location.

It is configured via the Administration - HL7 - Services page.

Select New - HL7 Pharmacy Group and enter the HL7 Pharmacy or Pharmacies configured in step 3.

5. Configuring Products

To configure products to be dispensed by a Pharmacy/Pharmacy Group, set the Pharmacy on the appropriate Medication or Merchandise product, or the Product Type.

For large numbers of products, specifying the Pharmacy on the Product Type is the preferred approach, although all products with the Product Type must be dispensed this way.

Testing the Connection

The simplest way to test the connection between OpenVPMS and the pharmacy provider is to admit a patient. This will send an HL7 ADT A01 message via the Order Connector to the pharmacy.

Its progress can be viewed on the OpenVPMS side by going to Aministration - HL7 - Connectors, selecting the appropriate HL7 MLLP Sender, and clicking Messages.

To test the connection from the pharmacy to OpenVPMS, dispense a product. A corresponding:

  • HL7 RDS O13 should appear in the Messages window for the HL7 MLLP Receiver
  • Customer Order should appear in Customer - Orders