Stores

The Stores list is available only on the Open mSupply Central Server. This is where you can view all stores, and manage their properties.

Viewing Stores🔗

Choose Manage > Stores in the navigation panel.

You will be presented with a list of stores in your system.

store list

The list of Stores is divided into 5 columns:

ColumnDescription
CodeThe code for the store
NameStore name
SupplierWhether this store is a supplier
CustomerWhether this store is a customer
DonorWhether this store is a donor
You can tell if a customer is also using Open mSupply in their store if they have an icon like this Store next to the code.
  1. The list can display a fixed number of stores per page. On the bottom left corner, you can see how many stores are currently displayed on your screen.
  2. If you have more stores than the current limit, you can navigate to the other pages by clicking on the page number or using the right of left arrows (bottom right corner).
  3. You can also select a different number of rows to show per page using the option at the bottom right of the page.

Searching stores🔗

You can filter the list of stores by name or by code. This can be useful if you're looking for one particular store!

In the search bar in the top left of your screen, type some (or all) of a store name or store code. The list will now contain all matching stores:

Stores filter

Store Preferences🔗

Store preferences allow the configuration of Open mSupply for a specific store. A short description of each preference is given below, with further detail in their related areas of the documentation.

To configure preferences for a store, select that store from the list - a new window will open.

Store preferences

Toggle the preferences on or off as required, and close when you are finished.

Available Preferences🔗

Preference NameDescription
Show indicative price on internal orders and requisitions
Order in packsDefaults the Internal Order/Requisition representation to packs instead of units
Use procurement functionalityEnables procurement functionality including Purchase Orders and External inbound shipments
Sort available batches by VVM status then expiryAuto-allocation in Outbound Shipments and Prescriptions uses VVM status first, then FEFO
Use simplified mobile UIReduces number of fields and elements for tablets - see the simplified tablet UI page for details. Requires legacy store preference.
Disable manual returns
Auto finalise fulfilled requisitions
Automatically verify inbound shipments
Manage VVM status for stockEnables a VVM status field on stock
Manage vaccines in dosesView stock levels and transactions for vaccine items in doses, rather than units or packs
Can create Internal Order from a RequisitionAllows users to create an Internal Order from a Requisition
Select destination store for an Internal OrderAllows users to select the destination store when creating an Internal Order from a Requisition to change the destination of the supplier's Outbound Shipment
Inbound shipment (external) lines must be authorised
Number of months to check for consumption when calculating out of stock productsSets how many past months are checked for item usage. If an item was used but is now out of stock, it will be flagged as out of stock on the Dashboard.
Number of months threshold to show low stock alerts for productsFlags products as low stock if their months of stock are below the set threshold.
Number of months threshold to show overstock alerts for productsFlags products as overstock if their months of stock are above the set threshold.
Batches expiring in between days
• First threshold for expiring items (days)Days before expiry to start flagging as "expiring soon." Used in the Expiring Stock widget. Note that the widget isn't displayed if both of these threshold settings are unconfigured.
• Second threshold for expiring items (days)Days before expiry to stop flagging as "expiring soon." Used in Expiring Stock widget.
Custom colour of page footerThe colour of the page footer can be changed to a store-specific value
Warn users when creating internal order if there is no recent stocktake
• EnableEnable this feature
• Max ageDays since the last stocktake with the required minimum items has been taken
• Min itemsA minimum number of items that the stocktake must contain to be considered - you may wish to ignore stocktakes which only have one or two items in them, for example.
Invoice status optionsConfigure which invoice statuses are available for Outbound shipments / supplier returns, and inbound shipments / customer return.

When selecting a store custom colour, you can enter a HEX colour value directly or use the colour picker:

Colour picker

Most store preferences are still managed through the Legacy mSupply central server (see the list of preferences). Only new store preferences for Open mSupply are configured on Open mSupply central server for now. All store preferences will be migrated to Open mSupply in a future version.

Store Properties🔗

To edit the properties of a store in the list, click on it. This will open a new Edit Store window.

Facility Properties tab showing no properties defined

From this window, you can edit the store properties.

Edit facility

  • Click OK to save your changes and close the window
  • Click OK & Next to save your changes and start editing the next store
  • Click Cancel at any time to revert your changes and close the window

Editing your store properties🔗

Any store can view and edit their own properties. If properties have been configured, an additional Edit button will be visible in the app footer, next to your store name:

Footer: store edit

Click the Edit button to open a new window, where you can edit the properties for your store.

Some properties can be disabled here. This means they are only editable on the Open mSupply Central Server.

Edit own store

Once you are happy with your changes, click OK to save and close the window.

Click Cancel at any time to revert your changes and close the window.

Permissions & Restrictions🔗

Stores are only visible on the Open mSupply Central Server.

To Edit stores centrally you need the Can modify central data permission, enabled in the omSupply Permissions Tab on your Central Store.

Can Modify Central Data Permission