Interoperability & Integration
Yes, OpenMRS talks to other systems!
Many teams need their EMR to connect well with other systems. We want to help you find the answer to whether OpenMRS has previously been integrated with the systems you use, and to share practical resources you can follow to get started. Didn’t find what you’re looking for? Let us know by posting in the OpenMRS forum: http://talk.openmrs.org.
Do you know other ways of connecting OpenMRS with other systems? We want to hear from you! Share your approach by posting on our forum http://talk.openmrs.org or by editing this page directly.
- 1 APIs
- 2 Facility-Level Integrations
- 2.1 Billing and Inventory Management
- 2.2 Data Visualization, Reporting, and Flattening
- 2.3 SMS and WhatsApp
- 2.4 Laboratory Information Systems (LIS)
- 2.5 Lab Analyzers and Lab Machines
- 2.6 CHW Community Health Worker Apps
- 2.7 Imaging, PACS (Picture Archiving and Communication System), DICOM (Digital Imaging and Communications in Medicine), and RIS (Radiology Information System)
- 2.8 System Monitoring
- 3 National-Level Integrations (e.g. HIE, NDR)
- 4 Still need help?
APIs
In general, OpenMRS has 2 major API options your team can leverage to call resources as required:
💻 REST API: Thoroughly documented here. To rapidly explore the OpenMRS data model, you can also use this search tool.
🔥 FHIR API: Information here, and FHIR IG here.
Interoperability Layers
Ozone Platform: Ozone’s interoperability layer. Data is directly pulled from a source OpenMRS MySQL database and wired onto camel routes in an effort to integrate OpenMRS with other systems without any use of the OpenMRS Java API or data model. More info here.
OpenHIM: Demo video of OpenMRS integration using OpenHIM here, sample architecture here, and comparison to Apache Kafka here
Facility-Level Integrations
Billing and Inventory Management
Odoo
ERPNext: OpenMRS 3 community members are currently working on an OpenMRS <-> ERPNext integration. For more information join the #openmrs3 channel on the OpenMRS Slack. Integrating OpenMRS with ERPNext is also on the Ozone roadmap: Open source integration layer via Ozone planned for mid-March 2024.
Crater: open-source app for expenses, payments, invoices & estimates. Bahmni-Lite is using Crater as a lightweight alternative to Odoo for invoicing & billing. Details here.
Data Visualization, Reporting, and Flattening
DHIS2 (Health Management Information System)
OpenMRS DHIS2 Connector Module: Module here, Demo Video #1 here, Demo Video #2 here
OpenMRS <> DHIS2 exchanging patient identifications and individual data (such as observations) through OpenFN – 5 minutes walkthrough video
FHIR-related: Members from the DHIS2 and OpenMRS communities are starting to collaborate on a FHIR-based integration strategy. We are seeking your use cases! Please contact grace[a]openmrs.org if you have a use case to share.
Apache Superset (Open Source data visualization tool)
Ozone Analytics, a versatile big data pipelines technology, streams data from OpenMRS to a data lake consumed by Apache Superset. More info here. Known OMRS Community Integrations: Cote d’Ivoire’s HIS Technical Working Group, ICRC (see some example ICRC Superset dashboards here).
PowerBI
Several implementers use SQL scripts to ETL from OpenMRS to a SQL Server where Power BI then consumes the transformed data (eg PIH, EGPAF). For more information consider posting to the OpenMRS Forum at http://talk.openmrs.org
Other Data Extraction Tools
Open Health Stack: The Analytics Pipeline of Open Health Stack is specifically called fhir-data-pipes. Known Community Member Integrations: Being used for Cote d’Ivoire OpenMRS analytics capture by ITECH.
MambaETL: UCSF module for OpenMRS Data Flattening. Details here.
SMS and WhatsApp
OpenMRS SMS module, documentation here. Connects OpenMRS with SMS service providers, and provides a convenient layer to send SMS/WhatsApp from the OpenMRS. Configuration examples here.
SMS Notifications in Bahmni Lite: Details here.
Laboratory Information Systems (LIS)
OpenELIS: See the OpenELIS FHIR IG. Known Community Member Integrations: ITECH (Sigdep3 in Cote d’Ivoire and Isanteplus in Haiti). Prerequisite modules: FHIR2 Module, Lab-on-FHIR Module. Point of contact for OpenELIS integration questions: digit[a]uw.edu See also: the EMR and LIS Data HIE Exchange Knowledge Base
SENAITE: In Ozone: SENAITE Config for the Ozone interoperability layer with OpenMRS: repo here.
Lab Analyzers and Lab Machines
OpenHIE Lab Information Sysytems COP and the Decoupled Analyzer Interface System (DAIS) – Community built middleware to connect clinical lab analyzers and convert their output to FHIR resources.
Analyzer Interface Manuals: shared Folder here (e.g. ASTM, HL7v2 guides for common Lab Analyzers, since these guides are often difficult to find or even only available in CDROM)
CHW Community Health Worker Apps
Community Health Toolkit (CHT) & Medic: See the CHT Integration Guide for OpenMRS Additionally, Medic has built an interoperability layer for the CHT based on the OpenHIE architecture: here. CHT has been integrated with OpenMRS in unique scenarios at peer to peer level based on unique requirements. Community Orgs with known integrations: Partners in Health; KenyaEMR/Palladium (eCHIS)
Open Health Stack Android FHIR SDK: See this demo Android Smart Phone application built using Android FHIR SDK to connect with an OpenMRS instance using the FHIR2 omod. Code location. Demo slides and O2 <–> Android App Sync video.
OpenSRP2: Because OpenSRP2 is FHIR-native, this works well with OpenMRS' FHIR2 Module. Worldwide, there are OpenMRS v2 and v3 implementations that have used the FHIR2 Module to integrate well with OpenSRP 2, such as mPower in Bangladesh. OpenSRP2 website is here.
If you are using OpenSRP v1, see the old Integration Guide Here. However, note that OpenSRP 2 is the recommended up-to-date version.
CommCare (Dimagi): CommCare’s Data Integration Layer product can be used to exchange data with OpenMRS. Some implementers are using the CommCare FHIR API.
Imaging, PACS (Picture Archiving and Communication System), DICOM (Digital Imaging and Communications in Medicine), and RIS (Radiology Information System)
DCM4CHEE: Currently in Bahmni. Soon to come for Ozone.
System Monitoring
Grafana & Prometheus: Helpful with deployment of upgrades, application up-time and hard-drive health monitoring, backup monitoring, sync monitoring. See all servers where application is down so you can proactively contact those sites. (Prometheus listens for this information; Grafana helps you visualize them.) Used by ITECH Cote d’Ivoire: monitoring to manage 500 locally stored instances and pull up in local fhir store. Deployment and updates; remote management and monitoring tools – could work on data center or locally installed. E.g. can show you which sites did not yet upgrade and may need a manual intervention. Contact: digit[a]uw.edu (Similar to CHT’s WatchDog setup).
National-Level Integrations (e.g. HIE, NDR)
Terminology Service / Terminology Registry / Dictionary Manager
OCL (Open Concept Lab)
OCL serves as a terminology management service that can host OpenMRS concept dictionaries, prepare them for integration with your system(s), and manage them over time. OCL also serves as the home for the CIEL interface terminology, which can be adapted and reused for your OpenMRS concept dictionaries.
OpenMRS Open Concept Lab Module: This module unlocks OpenMRS and OCL integration. Get started here.
Squad Calls: OpenMRS/OCL call that folks can join with questions / sharing experiences
Insurance, UHC, and Claim Management
openIMIS: openIMIS FHIR IG
Out-of-the-box Integration Layer between OpenMRS v3 and openIMIS coming soon to Ozone (~end of April 2024).
Facility Registry
GOFR (Facility Registry) – Uses FHIR’s MCSD profiles so OpenMRS can query those FHIR stores for the desired facility information. Known Community Member Integrations: ITECH
Geoprism: Uses FHIR’s MCSD profiles so OpenMRS can query those FHIR stores for the desired facility information.
Client Registry
OpenEMPI: Integration steps documented here.
OpenCR: Demo Video of OMRS and OpenCR integration, with installation guides and repository links, available here. Known Community Member Integrations: ITECH (Sigdep3 in Cote d’Ivoire and Isanteplus in Haiti).
SanteMPI: SanteMPI Client OpenMRS Module
JeMPI: The new 2023 OpenMRS – JeMPI Integration Guide is here.
Didn’t find what you’re looking for? Please share your use case by posting in the OpenMRS forum at: https://talk.openmrs.org
Still need help?
The OpenMRS Community is here for you!