Table of Contents

23.08. HL7 and Tamanu/Patis Plus integration

mSupply supports HL7 integration with HL7 compliant APIs. Currently, this is limited to retrieving information from HL7 Servers, mSupply does not send patient data.

When using mSupply Synchronisation systems, this must be configured on the central server. Data retrieved from the integration is stored on the mSupply Central Server and distributed via sync to remote sites. Data is also available via remote patient search.

Tamanu and Patis Plus are the primary use cases for this integration at the moment, and the only products we actively test the integration with. If you require integrating with other HL7 servers, please contact us!

Configuration

Choose File > Preferences from the menus and click on the HL7 Integration tab on the left hand side. This window opens:

To turn on HL7 configuration start by ticking the option Use HL7 integration. Then select either Use HL7 patient feed or Use HL7 patient search; these are explained below.

Then enter:

All these should be provided by the organisation hosting the HL7 server that you wish to integrate with.

Press the Test connection button to validate the details you've entered and save them.

Patient Feed

This is the default and recommended option to use if available. The patient feed will regularly request all recent changes to patients and their related documents available on the HL7 Server. Supported records will seamlessly be integrated into the mSupply Central Server database.

The patient search option allows remote searches done from mSupply remote sites to additionally search the integrated HL7 server seamlessly, and return both mSupply and HL7 results in the mSupply user interface.

Which one?

Patient feed is the recommended option as it solves multiple drawbacks of Patient search:

Medication dispense

If this is turned on then all finalised prescriptions are sent to the prescription consuming software every hour.