Configuration

The configuration settings section allows you to configure custom data for the system. It is only available on the Open mSupply Central Server.

Viewing the configuration settings🔗

To view the configuration settings, go to Settings in the lower section of the navigation panel:

Settings: nav

If you are on the Open mSupply Central Server, you will see this list of settings sections:

Settings: collapsed

Click on the Configuration section to begin.

Store Configuration🔗

Initialise Gaps Module🔗

To operate fully, the GAPS module requires a number of configuration changes and data records to be added to the system. In order to make this process easier, all of the required general configuration steps have been automated for you.

In order to add the GAPS configuration changes, simply click the Initialise button, shown below:

GAPS: uninitialised

Once configured, the Initialise button will become disabled:

GAPS: initialised

An Edit button will also appear in the footer, where you can edit the store properties for the store you are currently logged into:

Store properties edit

Clicking that Edit button will open a new window, where you can view and edit your store properties.

You will see a number of property inputs in this window. If you don't, there may be something wrong with the configuration - please contact support to investigate.

GAPS configuration is a one way process that cannot be undone! Please be sure you wish to use the GAPS module before initialising.

Supply Level Property🔗

The supply level property can be assigned to a store to identify that store's position within the supply chain hierarchy (e.g. central, regional, facility, etc...). On this page you are able to define the number and name of the levels which are available.

To configure supply levels, click the edit button:

Supply Level: Edit button

This opens a window where you can manage supply levels. If a supply level is already assigned to a store, you’ll see a notice and the delete button will be disabled.

Supply Level: Modal

To assign a supply level to a store either:

  • Navigate to Manage > Stores and edit a store
  • If on the central server, click the edit button in the app footer

Then, select the appropriate supply level from the dropdown:

Supply Level: Store Properties

Click the Ok button to save your changes. If you do not have the Supply level property available, editing the properties (step 1 above) will create the required property. Remember to sync your remote site after editing!

If you are using the Congo plugin then the selected supply level will be synchronised with the store's category 5 property

Store preferences🔗

Open mSupply is using some of the mSupply central server store preferences.

Here's the list of preferences which are currently in use:

PreferenceUsed by
Can manually link requisition to supplier invoiceInternal Orders
Edit prescribed quantity on prescriptionPrescriptions
Expiring items periodUsed for some Reports
Include requisitions from this store in suppliers' remote authorisation processUsed in Internal Orders if using the remote authorisation module
Keep requisition lines with zero requested quantity on finaliseRequisitions
Monthly consumption look back periodUsed for some Reports
Months lead timeUsed for some Reports
Open mSupply: Uses program moduleIf using Patient Programs
Set pack to one for all visible items in this storeWill enable the 'pack to one' feature when receiving stock
Show extra fields in requisitionDisplays additional fields for internal orders and requisitions
Stocktake frequencyUsed for some Reports
Store: Able to issue in foreign currencyIf using multiple currencies, this setting is used in multiple places
Threshold for overstockUsed for some Reports
Threshold for understockUsed for some Reports
Use consumption & stock from customers for internal ordersInternal Orders
Use remote authorisation for response requisitionsIf using authorisation for Requisitions
mobile: Uses Vaccine ModuleCold chain