Integration and interoperability

Target release
Epic
Document status	DRAFT
Document owner	@Mary Jo Kochendorfer (Deactivated)
Technical Lead

Goals/Scope

Identify systems and use cases for integration. When possible and where this if funding, build out proof of concepts to demonstrate feasibility.

Background

There are many requests and ideas circulating around about having OpenLMIS integrate with other systems. This spec is to document some of those opportunities in further detail.

Assumptions

Does no include Order file transfers via FTP to National ERPs
Focus on API driven integrations

User Stories

	Title	User Story	Label	Importance	Notes	JIRA Tickets

	Title	User Story	Label	Importance	Notes	JIRA Tickets
1	DHIS2 integration POC	As a DIVO, I would like to see the coverage data (how many patients for a specific vaccine were vaccinated last month) from as specific facility in DHIS2 prior to determining how much stock to send a facility so that I account for the upcoming demand.	DHIS2		For more discussion: GDHF: DHIS 2, OpenLMIS and OpenSRP Integration POC Review the IAPHL conversation around coverage information
2	DHIS2 integration POC	As an EPI Manager, I want to see the coverage data (DHIS2) next to the supply chain data (OpenLMIS).
3	DHIS2 integration POC	DRAFT idea As OpenLMIS, I would like to know when a patient is immunized so I can validate the issue/open vial wastage ....	DHIS2		very draft idea and needs more research
4	DHIS2	As the OpenLMIS system, I want my facilities to match/map to the facilities within DHIS2 so that I can pull data from desired facilities... (needs some work) Need to identify source system DHIS2 populates unique IDs for each facility Can DHIS2 support their party facility registry or standards (i.e. GLN identifiers)?			during the July 18 2017 Product committee meeting, members raised the importance of mapping facilities between the systems
5	ODK2 CCE app	Draft idea As a CCE technician, I would like to update cold chain functionality of a piece of CCE at a facility on a tablet/phone, so that DIVOs know when CCE is not functioning and shouldn't resupply. As a surveyor, I would like to take inventory on what CCE exists at each facility so that OpenLMIS has an updated inventory count of all CCE.	ODK2
6	Facility Registry (OpenHIE)	Draft idea As OpenLMIS, I want my my facilities to match/map to the country's source facility list so that my list of facilities is updated and reflective of the most recent list. (really includes the new facilities and deactivation of facilities) Need to figure out the workflow of making assignments for new facilities Need to figure out the workflow around archiving/deactivating facilities
7	Mobile: Create an order	DRAFT and needs more discussion As a mobile user tracking stock movements, I want to send my orders (or I want to ping OpenLMIS to generate an order) to OpenLMIS for fulfillment.			Detailed discussion: OpenSRP and OpenLMIS Integration
8	Mobile: Confirm delivery	DRAFT and needs more discussion			Detailed discussion: OpenSRP and OpenLMIS Integration

Diagrams

Dependencies

Description	Link

Description	Link

Open Questions

Below is a list of questions to be addressed as a result of this requirements document:

	Question	Outcome	Status

	Question	Outcome	Status
1	Is there a DVD-MT module within DHIS2?	Reached out to BAO and Ghana but it seems like there isn't a module but more of a mapping of data elements.	Closed
2	How does a DIVO want to see the data from DHIS2? Or what levels of the supplychain view reports where logistics data is needed?
3	What data elements from OpenLMIS should be pushed to DHIS2?	Stock outs, wastage,
4

Notes

OpenFN - openfn.org - is an interoperable layer. Taylor Downs CEO taylor@openfn.org
OpenHIE architecture
- https://wiki.ohie.org/display/projects/DATIM4U
- http://openhim.org/#
DHIS2
- http://bidinitiative.org/bid-learning-network/event/webinar-interoperability-between-epi-information-systems-dhis2-and-dvdmt/
- Talking with BAO (Steffen and Nicola) on a Proof of Concept
ODK2 CCE App
- Quick discussion on Jul 13, 2017 with @Richard Anderson (Unlicensed) and Waylan on plans for CCE app in ODK2
- Out of scope → reporting from the CCEM
- In scope
  - Taking inventory of equipment across facilities
  - Update inventory status (working/non-working) what are the specific levels
  - Maintenance tool (driven by Sophie and Richard)
- Next step/meeting Aug 9, 2017 to see the application.
- UW demoed the application on Aug 9, 2017.
BID Initiative
Tanzania
- Notes form Carl: Connection between Tanzania Immunization Registry (TImR) and DHIS2: https://github.com/openhie/openhim-mediator-timr-dhis2-tz
- Potentially connect with Ally from IntraHealth if we would like to see more details.

Notes with Steffen 9/13

Actual use case - data structures
Supply levels may be more simple - can set alerts with DHIS2
Will trigger a link to send them back to OpenLMIS
#s of patients immunized (daily) - gets into political questions about differing systems
Data visualization of stock levels (red, yellow, green) based on stock levels
- How could that link to vaccine data in DHIS2?
- Could link to/compare to immunizations performed
- Could build indicators inside DHIS2 and combine with stock indicators in OpenLMIS - predictive modeling and show trends
- Data generator/scrambler
- Proof of concept for a real integration

National view - approx 6 products
Higher level - snapshot
Different user - would see specific alerts for a specific district
DHIS2 coverage data - how to expose that in OpenLMIS?