integration:elmis_interface

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revisionBoth sides next revision
integration:elmis_interface [2019/10/16 19:19] – [19.03. The mSupply eLMIS interface] Emily Porrellointegration:elmis_interface [2021/10/08 11:06] Gary Willetts
Line 1: Line 1:
 {{indexmenu_n>30}} {{indexmenu_n>30}}
-====== 19.03. mSupply eLMIS interface ====== +====== 23.03. mSupply eLMIS interface ====== 
- +eLMIS stands for **E**lectronic **L**ogistics **M**anagement and **I**nformation **S**ystem and is a version of OpenLMIS developed under the USAID Deliver project. mSupply has an interface for receiving orders from eLMIS and sending shipment details back to it.\\ \\ Because eLMIS does not have an API, the mSupply interface uses files stored in a commonly accessible location to share information.
- +
-This is a work in progress - will be completed soon! +
- +
-eLMIS stands for **E**lectronic **L**ogistics **M**anagement **S**ystem and is a piece of software developed under the USAID Deliver project. mSupply has an interface for receiving orders from eLMIS and sending shipment details back to it. Because eLMIS does not have an API, the interface uses files stored in a commonly accessible location to share information.+
  
 ===== Setup ===== ===== Setup =====
Line 20: Line 16:
  
 ==== 2. Enter the setup information into mSupply ==== ==== 2. Enter the setup information into mSupply ====
-Go to the eLMIS tab of //File > Preferences// and enter the settings for the interface thereYou can find instructions for that [[preferences:general#elmis|here]]. +Go to the mSupply Special > Preferences window and select the eLMIS tabPlease see the [[preferences:general]] > [[preferences:general#elmis_tab]] section in this user guide for information on these settings.
  
 ==== 3. Setup eLMIS ==== ==== 3. Setup eLMIS ====
Line 44: Line 40:
 If the order is successfully converted into a customer invoice the eLMIS order file is moved from //main folder///Order/Incoming to //main folder///Order/Processed. If the order is successfully converted into a customer invoice the eLMIS order file is moved from //main folder///Order/Incoming to //main folder///Order/Processed.
  
-If there is a problem and the order file is not converted into a customer invoice then the order file is moved to //main folder///Order/Error. In addition, an error file is created and is also placed in //main folder///Order/Error. The error file has the name "//XXXX//-YYYY-MM-DD-HH-MM.err.csv" where //XXXX// is the order file's filename without its extension. See the Error file format section below for the format of the error file. An error email with the error file attached will also be sent to the error email address set in the [[preferences:general#elmis|mSupply preferences]].+If there is a problem and the order file is not converted into a customer invoice then the order file is moved to //main folder///Order/Error. In addition, an error file is created and is also placed in //main folder///Order/Error. The error file has the name "//XXXX//-YYYY-MM-DD-HH-MM.err.csv" where //XXXX// is the order file's filename without its extension. See the Error file format section below for the format of the error file. An error email with the error file attached will also be sent to the error email address set in the [[preferences:general#elmis_tab|mSupply preferences]].
  
 ==== 2. Creates eLMIS shipment files for confirmed customer invoices ==== ==== 2. Creates eLMIS shipment files for confirmed customer invoices ====
Line 57: Line 53:
 Well, the good news is that day-to-day you don't have to do anything. The interface will continue running quietly in the background processing order files and creating shipment files as the customer invoices are confirmed. Well, the good news is that day-to-day you don't have to do anything. The interface will continue running quietly in the background processing order files and creating shipment files as the customer invoices are confirmed.
  
-Periodically you should check the error email address set in the [[preferences:general#elmis|mSupply preferences]] for messages about errors. Remember the order files that have caused errors can be found on the //main folder///Order/Error folder. Note that mSupply does not put anything in the //main folder///Shipment/Error folder - eLMIS only uses that folder when processing the shipment files.+Periodically you should check the error email address set in the [[preferences:general#elmis_tab|eLMIS preferences]] for messages about errors. Remember the order files that have caused errors can be found on the //main folder///Order/Error folder. Note that mSupply does not put anything in the //main folder///Shipment/Error folder - eLMIS only uses that folder when processing the shipment files.
  
 The only other time you will hear anything from the interface is if mSupply detects an item on a customer invoice that wasn't in the original eLMIS order. This will happen if one of the item placeholder lines was replaced with a different item (e.g. because of low stock or a preferred item is to be used). In this case, mSupply will show a window and ask you to tell it which item on the original order you replaced with the item in question. Once you have selected the item that has been replaced mSupply will continue creating the shipment file. The only other time you will hear anything from the interface is if mSupply detects an item on a customer invoice that wasn't in the original eLMIS order. This will happen if one of the item placeholder lines was replaced with a different item (e.g. because of low stock or a preferred item is to be used). In this case, mSupply will show a window and ask you to tell it which item on the original order you replaced with the item in question. Once you have selected the item that has been replaced mSupply will continue creating the shipment file.
Line 88: Line 84:
 \\ \\
 \\ \\
-|  //  Previous:  **[[integration:frontlinesms_integration:|19.02. FrontlineSMS integration]]** | | Next: **[[integration:moneyworks|19.04. Moneyworks Integration]]** //  |+|  //  Previous:  **[[integration:frontlinesms_integration:]]** | | Next: **[[integration:moneyworks]]** //  |
  
  
 ---- struct data ---- ---- struct data ----
 +pagestatus.status    : 
 ---- ----
  
  • Last modified: 2022/03/15 10:26
  • by Gary Willetts