23.06. NHLMIS integration

Before you turn on the NHLMIS integration two important setup steps must be taken: All store, item, customer and supplier codes must match those used in NHLMIS. If this step is not taken; stock data you send will be rejected by NHLMIS because the items the stock belongs to will not be recognised requisitions (orders) you receive from NHLMIS will not be added because the customer or items are not recognised by mSupply NHLMIS must be configured so that the API key relates to the correct stores in your mSupply installation.

mSupply has an interface with the Nigeria Health Logistics Information System. The interface allows the automatic sending of current stock and pulling of orders from NHLMIS.

The preferences that define how this interface works are managed on the NHLMIS tab of the File > Preferences menu. The tab looks like this:

General preferences

Server URL: The URL of the NHLMIS interface. Enter everything without the resource to be called and the final “/” e.g. https://dev.api.nscip.field.supply/v1 (this is actually the URL of the NHLMIS test server).

API key: The authentication key for your organisation. This will be provided by the NHLMIS team.

Error email: The email address for error emails to be sent to.

Stores to send stock and receive requisitions for table: This table contains a row for every store in the datafile. Check the checkbox in the Send stock & Fetch requisitions column (by clicking on it) for each store you want to send stock to and fetch requisitions for in the NHLMIS interface.

Send stock preferences

Send current stock to NHLMIS checkbox: If this is checked then mSupply will automatically send the current stock stock in each of the stores selected in the Stores to send stock and receive requisitions for table. If it is unchecked then no current stock is sent to NHLMIS.

No. of days between sends: The number of days to leave between each send of stock. If set to 0 then current stock is not sent to NHLMIS.

Time to send: The time of day to send the stock. Enter the value in 12 hour clock format and select whether it is AM or PM in the drop down list.

Manufacturer to use if none: By default, if the stock doesn't have a manufacturer set in mSupply then it is sent to NHLMIS with a blank manufacturer. If you enter something in this field then, if a line of stock has no manufacturer set, then the contents of this field are sent in the manufacturer field. Of course, if a line of stock does have a manufacturer set then it is sent with the name of that manufacturer, regardless of what is entered in this field.

Send now button: If this is clicked, the current stock in the stores selected in the Stores to send stock and receive requisitions for table will be sent to NHLMIS immediately. This will be an “extra” send and does not affect the automatic send defined by the No. of days between sends and Time to send fields.

Fetch requisitions preferences

Fetch requisitions from NHLMIS checkbox:

No. of minutes between fetches:

Set “since” marker“ to drop down list:

Order ID text box and Fetch now button:

What happens

Errors

Previous: 23.05. MYOB | | Next: 24. Data Tables and Fields