Back to Item Details window

 Item reporting

As of mSupply v4.14 there are 2 major changes to item reporting information:

  1. If you are using Universal Codes, the ATC category, item strength and DDD value will be populated from the universal code server.
  2. Extra properties of an item will be included in the properties list and you can add more if you wish.

ATC Category: This field is intended for the ATC code. The use of ATC codes and DDD values is discussed in detail here.

DDD value: The DDD value is the defined daily dose of the item. For example, doxycycline's DDD value is 100mg., while that of Amoxycillin is 1g. DDDs are a means of quantifying the issue of medicines by doses rather than by the raw number of units dispensed.

DDD factor: Defined Daily Dose factor- this is the number of units of the item that make up the DDD value. In the case of amoxycillin 250mg capsules the DDD factor is 4, while amoxycillin 500mg capsules have a factor of 2. For Doxycycline 100mg tablets the DDD factor is 1

ABC category: This option allows you to mark items that are commonly used and then report on only those items. For Reports using this category, see Items and Stock reports

Catalogue code: This field allows you to enter a different 'Catalogue' code for the item. Items can be searched by this code if the Include catalogue code for item search preference is set

Item Strength: This value is populated from the universal code server if you are using it.

Item Properties

Item properties provide a flexible way of adding your own properties (or categories) to an item. You can add an unlimited number of categories.

Properties that have been added from the Universal Code Server (see 4.01.01. Items - General tab) cannot be edited so the Edit and Delete buttons are disabled for those.

Adding properties
  • Use the Add button to add a new property. This window will open:
  • If this is a new property then type the property's name in the Type field
  • If it is another value for an existing property, click on the arrows to the right of the Type field to see a list of the current properties and you can select one from the list:
  • Enter the value for the property in the Value field
  • Click on the OK button to save your changes or Cancel to discard them.
Editing properties
  • Either double-click a property in the list or click on it to select it and click on the (Edit) button.
  • The same window as when adding a property will open but populated with the property's name and value. Type the new name of the property or click on the arrows to the right of the Type field to select one from the list of current properties.
  • Edit the Value if necessary then click on the OK button to save your changes.
Deleting properties
  • Select a property from the list by clicking on it.
  • Click on the button to delete it. You will be asked to confirm the deletion before it is actioned.

If you are using a synchronisation system, then properties adding to items also synchronise to all other sites using mSupply desktop.

Properties can be viewed and used on the mSupply dashboard.

From version 4.15 properties can be used for specifying which items are included in reports.

You can create properties with the same Type value but you cannot create properties with the same Type value as properties added by the Universal code server (see the 4.01.01. Items - General tab page for details on giving your item a universal code).

  • Last modified: 2021/08/19 14:52
  • by Gary Willetts