# External integration with OpenELIS Global using HL7 to create orders via API

**URL:** https://talk.openelis-global.org/t/external-integration-with-openelis-global-using-hl7-to-create-orders-via-api/1626
**Category:** Uncategorized
**Tags:** dev\_setup, dev, dev-stages
**Created:** [August 19, 2025, 6:56pm UTC](https://talk.openelis-global.org/t/external-integration-with-openelis-global-using-hl7-to-create-orders-via-api/1626 "2025-08-19T18:56:27Z")
**Posts on this page:** 5
**Page:** 1

<div class="post-metadata">

### Author: ![Adrian](https://avatars.discourse-cdn.com/v4/letter/a/82dd89/32.png) [@Adrian](https://talk.openelis-global.org/u/Adrian)
#### Post date: [August 19, 2025, 6:56pm UTC](https://talk.openelis-global.org/t/external-integration-with-openelis-global-using-hl7-to-create-orders-via-api/1626/1 "2025-08-19T18:56:27Z")

</div>

Hello everyone,

I am working on an integration between an external system and OpenELIS Global. What I need is to be able to send lab orders from another system (such as an LIS or HIS) to OpenELIS using an external API. In addition, the data exchange must be based on HL7 (v2 or v3, depending on what OpenELIS supports).

I have reviewed the available documentation, but I did not find clear information on how to expose an API or endpoint that receives HL7 messages to create new orders in the system.

My questions are:

1. Is there currently an API or connector in OpenELIS Global that allows receiving HL7 messages for order creation?

2. If not, is there any guidance or recommendation on how to extend OpenELIS to implement this functionality?

3. Which version of HL7 (v2.x or v3) is compatible or recommended in this context?

I would greatly appreciate any guidance, examples, or references to relevant documentation that you can share.

Thank you in advance.

---

<div class="post-metadata">

### Author: ![Moses\_Mutesasira](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/moses_mutesasira/32/72_2.png) [@Moses\_Mutesasira](https://talk.openelis-global.org/u/Moses_Mutesasira)
#### Post date: [August 19, 2025, 7:36pm UTC](https://talk.openelis-global.org/t/external-integration-with-openelis-global-using-hl7-to-create-orders-via-api/1626/2 "2025-08-19T19:36:03Z")

</div>

Hello @Adrian ,  
There was some work done several years back to support HL7 integration , but i dont think its been well mantained .

If your goal is to recieve Lab Oders from another System or Device ,  
You could leaverage the Analyzer framework , and write your own custom analyser to parse and load the specific Message format your System supports.

see Quick overview about [analysers](https://uwdigi.atlassian.net/wiki/spaces/OG/pages/239829012/Analyzers) and check out [these slides](https://docs.google.com/presentation/d/1Sq8QcNlKlbkouhXbFZpAFDkBPPYUukEGlV1iQkyn2iw/edit?slide=id.p#slide=id.p) giving details on how to develop your own plugin

---

<div class="post-metadata">

### Author: ![Adrian](https://avatars.discourse-cdn.com/v4/letter/a/82dd89/32.png) [@Adrian](https://talk.openelis-global.org/u/Adrian)
#### Post date: [August 20, 2025, 3:37pm UTC](https://talk.openelis-global.org/t/external-integration-with-openelis-global-using-hl7-to-create-orders-via-api/1626/3 "2025-08-20T15:37:53Z")

</div>

Thank you.

And without hl7, is there an API that can be used to communicate (create an order in OpenElis) from an HIS?

---

<div class="post-metadata">

### Author: ![Moses\_Mutesasira](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.openelis-global.org/moses_mutesasira/32/72_2.png) [@Moses\_Mutesasira](https://talk.openelis-global.org/u/Moses_Mutesasira)
#### Post date: [August 20, 2025, 4:12pm UTC](https://talk.openelis-global.org/t/external-integration-with-openelis-global-using-hl7-to-create-orders-via-api/1626/4 "2025-08-20T16:12:01Z")

</div>

We support a [FHIR based EMR-LIS](https://uwdigi.atlassian.net/wiki/spaces/HIE/pages/224722951/Laboratory+Workflows) workflow . example its used to integrate between[OpenMRS and OpenELIS](https://uwdigi.atlassian.net/wiki/spaces/OG/pages/682852353/How+to+Send+a+Lab+Request+from+OpenMRS+and+Result+in+OpenELIS).  
See [demo video](https://www.youtube.com/watch?v=LsHhDrrlvKw).

Note that the workflow is System agnostic ,and not necesarily specific to OpenMRS.

---

<div class="post-metadata">

### Author: ![Adrian](https://avatars.discourse-cdn.com/v4/letter/a/82dd89/32.png) [@Adrian](https://talk.openelis-global.org/u/Adrian)
#### Post date: [August 20, 2025, 7:49pm UTC](https://talk.openelis-global.org/t/external-integration-with-openelis-global-using-hl7-to-create-orders-via-api/1626/6 "2025-08-20T19:49:21Z")

</div>

Thank you.

I was reading and the links for “[Tutorial: Lab Order Communication between OpenMRS and OpenELIS](https://uwdigi.atlassian.net/wiki/spaces/HIE/pages/224722951/Laboratory+Workflows#Tutorial%253A-Lab-Order-Communication-between-OpenMRS-and-OpenELIS)” send me to a 404 error. I don’t know if there are other links and tutorials for performing the integration.
