Terminology Explainer
Introduction🔗
There's an old computer science joke: "There are 2 things that are hard in computer science: cache invalidation, off-by-1 errors, and naming things"
Putting aside the cheesy off-by-1 part of the joke, the "naming things" part is very true. We could spend all our time arguing about naming things, and never deliver any useful system at all!
Our approach is to try and combine industry standard naming, what is customary in health supply chains in different countries, all with a nod to mSupply's historical names for things. It's clearly impossible to find names that will satisfy all those criteria, so this user guide page will hopefully ease the pain.
Items, Products, SKUs🔗
Open mSupply is different to other inventory management systems in that the core concept for inventory is an Item - which is usually a generic medicine or product with the unit of measurement specified, but no pack size. There's a good reason for this:
- Most public health systems operate on generic names
- Reporting usually wants to know the total amount of generic item, not just of a particular product/SKU1 that was used
Item variants in Open mSupply are the equivalent of an SKU - they have a brand, barcode, pack size, etc.
Item examples🔗
The following are examples of how Open mSupply expects items to be structured for stock handling.
Bold text indicates the property that separates the item from the one above.
Medicine items
| Item | Active ingredient | Strength | Unit |
|---|---|---|---|
| PARA500T | Paracetamol | 500mg | Tablet |
| PARA500C | Paracetamol | 500mg | Capsule |
| PARA250T | Paracetamol | 250mg | Capsule |
Vaccine items
| Item | Type | Form | Unit | Doses / unit | Dosage | Administration route | |
|---|---|---|---|---|---|---|---|
| ROTALP12O | Rotavirus vaccine | Liquid | Plastic tube | 1 | 2 | Oral | |
| ROTALP13O | Rotavirus vaccine | Liquid | Plastic tube | 1 | 3 | Oral | |
| ROTALV13O | Rotavirus vaccine | Liquid | Vial | 1 | 3 | Oral | |
| ROTALV53O | Rotavirus vaccine | Liquid | Vial | 5 | 3 | Oral | |
| ROTALFV53O | Rotavirus vaccine | Liquid (frozen) | Vial | 5 | 3 | Oral | |
| ROTALFV53M | Rotavirus vaccine | Liquid (frozen) | Vial | 5 | 3 | Intramuscular | |
| ROTALY2V13O | Rotavirus vaccine | Lyophilised | Two vial set | 1 | 3 | Oral | |
Variant examples🔗
The following are examples of item variants, using items from each of the medicines and vaccines tables above.
Medicine item variants
| Item | Variant | Commercial name | Manufacturer | Container | Pack size |
|---|---|---|---|---|---|
| PARA500T | A | Medreich Paracetamol | Sri Krishna Pharmaceuticals Limited | Blister, carton of | 50 tablets |
| PARA500T | B | Medreich Paracetamol | Sri Krishna Pharmaceuticals Limited | Blister, carton of | 100 tablets |
| PARA500T | C | Palmol | Fine Chemicals Corporation (Pty) Limited | Blister, carton of | 20 tablets |
| PARA500T | D | Palmol | Fine Chemicals Corporation (Pty) Limited | Bottle | 500 tablets |
Vaccine item variants
| Item | Variant | Commercial name | Manufacturer | Storage temperature | VVM type | Container | Pack size |
|---|---|---|---|---|---|---|---|
| ROTALY2V13O | A | Rotasiil | Serum Institute of India Pvt. Ltd. | 2-8°C | 30 | Carton | 50 vial sets |
| ROTALY2V13O | B | Rotasiil Thermo | Serum Institute of India Pvt. Ltd. | +25°C | 250 | Carton | 100 vial sets |
Facilities, Warehouses, Stores, Sites, Organisational Units🔗
The major ERP systems all use different terminology for site-level organizational units that manage inventory.
In mSupply, we have the following concepts:
| Concept | Explanation |
|---|---|
| Store | A (virtual) store is a unit that manages it's own inventory and transactions. It has it's own users with their own set of permissions |
| Site | A (remote) site has an Open mSupply server that synchronises with the Open mSupply central server. A site can contain 1 or more stores (for example, it might have one essential medicines store, a laboratory items store, and an EPI store, all managed by different users, but all logging in [usually on the local wifi network] to the same server) |
| Facility | The physical complex at a particular geographical location. Usually a facility will have a single Open mSupply site, even if it has lots of physical stores. The only reason to have more than one site at a facility is if the stores can't all connect to the same local network. |
Comparison with other ERP systems:🔗
In Odoo, an organizational unit is typically referred to as a "Warehouse." Each warehouse represents a physical location where inventory is stored and managed, while still being part of the broader company structure.
In SAP, an organizational unit is called a "Plant" or "Storage Location" depending on the exact context. A Plant represents a separate facility or manufacturing site that manages its own inventory.
In Microsoft Dynamics, an organizational unit is called a "Site" or "Warehouse" depending on which Dynamics product you're using (Dynamics 365 Business Central vs. Dynamics 365 Supply Chain Management).
SKU = Stock Keeping Unit - a particular brand, pack size (and maybe packging variation) of an item.