<?xml version="1.0" encoding="UTF-8"?>
<!-- generator="FeedCreator 1.8" -->
<?xml-stylesheet href="https://docs.msupply.org.nz/docs/lib/exe/css.php?s=feed" type="text/css"?>
<rdf:RDF
    xmlns="http://purl.org/rss/1.0/"
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
    xmlns:dc="http://purl.org/dc/elements/1.1/">
    <channel rdf:about="https://docs.msupply.org.nz/docs/feed.php">
        <title>mSupply documentation wiki - items:item_basics</title>
        <description></description>
        <link>https://docs.msupply.org.nz/docs/</link>
        <image rdf:resource="https://docs.msupply.org.nz/docs/_media/wiki:logo.png" />
       <dc:date>2026-04-06T18:18:09+00:00</dc:date>
        <items>
            <rdf:Seq>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_backorders"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_barcodes"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_bill_of_materials"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_custom_data"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_dispensing"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_general"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_interactions"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_ledger"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_log"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_master_lists"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_misc"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_notes"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_order_options"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_purchase_orders"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_quotes"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_reconcile"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_reporting"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_requisitions"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_stock"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_storage"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_stores"/>
                <rdf:li rdf:resource="https://docs.msupply.org.nz/docs/items:item_basics:tab_usage"/>
            </rdf:Seq>
        </items>
    </channel>
    <image rdf:about="https://docs.msupply.org.nz/docs/_media/wiki:logo.png">
        <title>mSupply documentation wiki</title>
        <link>https://docs.msupply.org.nz/docs/</link>
        <url>https://docs.msupply.org.nz/docs/_media/wiki:logo.png</url>
    </image>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_backorders">
        <dc:format>text/html</dc:format>
        <dc:date>2021-10-18T09:56:46+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.08. Items - Backorders tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_backorders</link>
        <description>4.01.08. Items - Backorders tab

Back to Item Details window



You can view the backorders for an item here. These are the backorders that have been created manually in this window or during the process of issuing goods to customers when you do not have enough stock to send to them and the</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_barcodes">
        <dc:format>text/html</dc:format>
        <dc:date>2021-05-04T12:07:52+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.19. Items - Barcodes tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_barcodes</link>
        <description>4.01.19. Items - Barcodes tab

Back to Item Details window

This tab is for managing the barcodes assigned to this item. For all the details you need, please see the 15.02. Adding barcodes to items page.
    Previous:  4.01.18. Items - Stores tab | | Next: 4.01.20. Items - Custom data tab</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_bill_of_materials">
        <dc:format>text/html</dc:format>
        <dc:date>2021-04-28T13:15:10+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.11. Items - Bill of materials tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_bill_of_materials</link>
        <description>4.01.11. Items - Bill of materials tab

Back to Item Details window

This tab may not be showing if you do not have a registration for mSupply(r) that enables manufacturing, or the buttons may be dimmed so you can not make entries if your user permissions do not allow you to view Bills of Materials.</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_custom_data">
        <dc:format>text/html</dc:format>
        <dc:date>2023-08-11T08:06:23+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.20. Items - Custom data tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_custom_data</link>
        <description>4.01.20. Items - Custom data tab

Back to Item Details window

This tab is for managing data stored in custom fields for this item. 

If you don&#039;t see any custom fields, that&#039;s because none have been set up yet!

Custom fields use and setup are described here
    Previous:</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_dispensing">
        <dc:format>text/html</dc:format>
        <dc:date>2025-03-28T15:04:41+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.14. Items - Dispensing tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_dispensing</link>
        <description>4.01.14. Items - Dispensing tab

Back to Item Details window



Default directions

A feature of mSupply(r) which can reduce the time taken to dispense a prescription is its use of abbreviated patient directions, which allows the entry of a short sequence of characters that expand to meaningful text. This is where you can set an item&#039;s default directions which will be used at the time of dispensing. When there is more than one entry, priority is given to the direction that is ranked at no.1 unde…</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_general">
        <dc:format>text/html</dc:format>
        <dc:date>2026-03-02T09:02:39+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.01. Items - General tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_general</link>
        <description>4.01.01. Items - General tab

Back to Item Details window

What are those lock icons?  To minimise the chance of accidental amendment, some critical fields have a lock icon to the left of it.  To change any of these fields, you must click on the lock icon first, and then enter the new value in the field.</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_interactions">
        <dc:format>text/html</dc:format>
        <dc:date>2021-05-06T09:17:13+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.22. Items - Interactions tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_interactions</link>
        <description>4.01.22. Items - Interactions tab

Back to Item Details window



This tab is read only and displays the interactions this item has with other items. These interactions are automatically  downloaded from the universal code server (&lt;https://codes.msupply.foundation/&gt;) when a universal code has been applied to the item. See the</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_ledger">
        <dc:format>text/html</dc:format>
        <dc:date>2023-01-18T15:31:56+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.06. Items - Ledger tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_ledger</link>
        <description>4.01.06. Items - Ledger tab

Back to Item Details window

The item Ledger tab lists individual transactions for the item in question. By default is shows all transactions for the current year:



The Type column has a shorthand label for the type of transaction:

	*  si = supplier invoice and inventory adjustment to increase the amount of stock</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_log">
        <dc:format>text/html</dc:format>
        <dc:date>2021-04-28T13:16:09+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.16. Items - Log tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_log</link>
        <description>4.01.16. Items - Log tab

Back to Item Details window

mSupply(r) maintains a record of any changes to an item&#039;s details - name, code or units. The log window displays a list of such changes, under the headings:

	*  Date
	*  Time
	*  User and Event
	*  Event Type
    Previous:</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_master_lists">
        <dc:format>text/html</dc:format>
        <dc:date>2021-05-04T12:04:59+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.21. Items - Master lists tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_master_lists</link>
        <description>4.01.21. Items - Master lists tab

Back to Item Details window

This tab is for managing the barcodes assigned to this item. For all the details you need, please see the 15.02. Adding barcodes to items page.
    Previous:  4.01.20. Items - Custom data tab | | Next: 4.01.22. Items - Interactions tab</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_misc">
        <dc:format>text/html</dc:format>
        <dc:date>2025-08-29T14:14:00+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.03. Items - Misc(ellaneous) tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_misc</link>
        <description>4.01.03. Items - Misc(ellaneous) tab

Back to Item Details window

This window has settings for:

	*  cautionary warnings used when dispensing medicines
	*  accounts used when exporting transaction information
	*  SMS (text) messaging
	*  Price list



Warnings: Warnings which apply to this item are chosen from a standard list. This list is set
up using the</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_notes">
        <dc:format>text/html</dc:format>
        <dc:date>2021-04-28T13:14:17+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.09. Items - Notes tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_notes</link>
        <description>4.01.09. Items - Notes tab

Back to Item Details window



You can add and edit notes for an item here.

Click the New note button to add a note. A note can be up to 32,000 characters.



The date on which you are entering the note is already completed, and in the main panel you should type in the wording of the note itself. In the lower left of the window is a drop-down list offering various choices concerning the displaying of the note on screen; it may appear as an alert when this item is iss…</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_order_options">
        <dc:format>text/html</dc:format>
        <dc:date>2026-01-28T00:02:27+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.13. Items - Order options tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_order_options</link>
        <description>4.01.13. Items - Order options tab

Back to Item Details window



Never order this item

Use this check box to stop the item from being included in orders. This could be useful if the item is a “one-off” or it has been discontinued.

Hold: do not receive

If this check-box is checked, you cannot receive this item</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_purchase_orders">
        <dc:format>text/html</dc:format>
        <dc:date>2021-04-28T13:15:21+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.12. Items - Purchase orders tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_purchase_orders</link>
        <description>4.01.12. Items - Purchase orders tab

Back to Item Details window



	*  The Show drop down list allows filtering the display of Purchase Orders according to their status - All, Suggested, etc. - 
	*  If you double-click a row the Purchase order will be opened in a new window.</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_quotes">
        <dc:format>text/html</dc:format>
        <dc:date>2025-07-27T21:52:20+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.07. Items - Quotes tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_quotes</link>
        <description>4.01.07. Items - Quotes tab

Back to Item Details window



A quotation is a record of a price you have been given by a supplier.
For each item you can have multiple quotes recorded, reflecting
different prices you have been quoted from different suppliers, or even
different prices from the one supplier for different pack sizes.</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_reconcile">
        <dc:format>text/html</dc:format>
        <dc:date>2021-04-28T13:14:59+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.10. Items - Reconcile tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_reconcile</link>
        <description>4.01.10. Items - Reconcile tab

Back to Item Details window



Clicking the Reconcile button will give a summary of usage.

It is useful for checking mSupply(r) is working as it should be! If you get an error here it is most likely mSupply(r) was in use when a power failure occurred. In multi-user versions we are able to provide you with a log file that will allow you to incorporate transactions entered even if a power failure has occurred.</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_reporting">
        <dc:format>text/html</dc:format>
        <dc:date>2021-08-19T14:52:12+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.15. Items - Reporting tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_reporting</link>
        <description>4.01.15. Items - Reporting tab

Back to Item Details window

[ Item reporting]

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

	*  If you are using Universal Codes, the ATC category, item strength and DDD value will be populated from the universal code server.</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_requisitions">
        <dc:format>text/html</dc:format>
        <dc:date>2021-04-28T13:16:22+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.17. Items - Requisitions tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_requisitions</link>
        <description>4.01.17. Items - Requisitions tab

Back to Item Details window

The Requisitions tab shows the stocktakes featuring this item,

	*  Choose a date range from the drop-down list to show custom stocktakes within that range.
	*  Double-click a row to view the customer stocktake in question.</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_stock">
        <dc:format>text/html</dc:format>
        <dc:date>2024-10-25T14:31:09+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.05. Items - Stock tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_stock</link>
        <description>4.01.05. Items - Stock tab

Back to Item Details window



The Stock tab shows the lines of stock for this item together with the stock on hand. mSupply(r) will calculate how many days this stock will last, based on your usage over a number of months - you can specify how many months.</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_storage">
        <dc:format>text/html</dc:format>
        <dc:date>2025-12-31T13:41:15+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.02. Items - Storage tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_storage</link>
        <description>4.01.02. Items - Storage tab

Back to Item Details window



Default section

Default shelf Location

The default shelf location for this item in this store.  When you receive items into stock, they will be given the shelf location you enter here by default. You can always override it if you wish. Enter the first few characters of the location&#039;s code, then press the</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_stores">
        <dc:format>text/html</dc:format>
        <dc:date>2021-05-04T12:07:25+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.18. Items - Stores tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_stores</link>
        <description>4.01.18. Items - Stores tab

Only users who have Admin privileges may access this feature. See section 25.15. Managing users

Selecting this item shows the stores where this item is visible, and allows these stores to be set to Active using the checkbox.



If the Active checkbox is unchecked, the item will not be visible when logged in to that store</description>
    </item>
    <item rdf:about="https://docs.msupply.org.nz/docs/items:item_basics:tab_usage">
        <dc:format>text/html</dc:format>
        <dc:date>2025-02-05T15:15:48+00:00</dc:date>
        <dc:creator>Anonymous (anonymous@undisclosed.example.com)</dc:creator>
        <title>4.01.04. Items - Usage tab</title>
        <link>https://docs.msupply.org.nz/docs/items:item_basics:tab_usage</link>
        <description>4.01.04. Items - Usage tab

Back to Item Details window

BEWARE!  Once set, the options on this page will continue to govern every forecast generated by mSupply for this item in this store until you change it! It can be easy to forget that a particular item has been given different settings for calculationg its AMC.</description>
    </item>
</rdf:RDF>
