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
integration:nhlmis [2026/03/02 10:30] – [Other setup] Gary Willettsintegration:nhlmis [2026/03/06 12:10] (current) – [Synchronising items] Gary Willetts
Line 64: Line 64:
   * **Stock:** Any stock in a store that needs to be sent to NHLMIS must be assigned a program and donor and must belong to an item with a code that is recognised by NHLMIS. The program is set using the **Program** drop down list that appears on a supplier invoice line add/edit or stock line edit window when the **Send stock** checkbox is checked. It is populated with the names of master lists that have an "NHLMISProgram://program name//" tag. The program is NOT assigned using custom stock field 5 (commonly used in other installations).   * **Stock:** Any stock in a store that needs to be sent to NHLMIS must be assigned a program and donor and must belong to an item with a code that is recognised by NHLMIS. The program is set using the **Program** drop down list that appears on a supplier invoice line add/edit or stock line edit window when the **Send stock** checkbox is checked. It is populated with the names of master lists that have an "NHLMISProgram://program name//" tag. The program is NOT assigned using custom stock field 5 (commonly used in other installations).
   * **Master lists:** master lists should be created for each NHLMIS program (with a tag in the format "NHLMISProgram://program name//"), assigned to the stores that will use them and then the preference to control item visibility by item master list turned on. **NOTE:** this will mean a lot of configuration work when the interface first goes live!   * **Master lists:** master lists should be created for each NHLMIS program (with a tag in the format "NHLMISProgram://program name//"), assigned to the stores that will use them and then the preference to control item visibility by item master list turned on. **NOTE:** this will mean a lot of configuration work when the interface first goes live!
 +  * **Donors:** make sure all donors representing NHLMIS funders are created and visible in all stores selected in the **Stores to send stock and receive requisitions for** table in the //File > Preferences > NHLMIS// tab as described above. The code of the donor must match the funder name in NHLMIS. e.g. ''funder:pepfar'' must be a donor with its code set to ''pepfar'' in mSupply.
 +  * **Item properties**: add a property with the type ''NHLMISChild'' and any value (not an item code) to any item. See the  page [[items:item_basics:tab_reporting#item_properties|4.01.15. Items - Reporting tab]] for details on how to do this.
 +  * **Users**: add a user with the name "NHLMIS Interface". Make it active but give it no permissions (except being able to login to the dashboard) and do not allow it to login to any stores. mSupply will set this user as the creator of transactions generated by the interface. 
  
  
Line 105: Line 108:
   * if it has a Generic parent ID which is different from its ID then it is created as an NHLMISChild property of the parent item (as long as it doesn't already exist as this property!) with a value of "//item code//,pack_//pack size//" e.g. "ghsc-mal0004,pack_100".   * if it has a Generic parent ID which is different from its ID then it is created as an NHLMISChild property of the parent item (as long as it doesn't already exist as this property!) with a value of "//item code//,pack_//pack size//" e.g. "ghsc-mal0004,pack_100".
  
-In addition, new items will be added to master lists that have tags matching the item's program name (master list tag format is "NHLMISProgram://program name//"). If the master list does not exist then it will be crerated by mSupply.+In addition, new items will be added to master lists that have tags matching the item's program name (master list tag format is "NHLMISProgram://program name//"). If the master list does not exist then it will be created by mSupply.
  
 The pack size sent with an item is set as its default pack size. The pack size sent with an item is set as its default pack size.
  • Last modified: 2026/03/02 10:30
  • by Gary Willetts