Skip to content

Consumables

Ed Mozley edited this page Nov 21, 2026 · 3 revisions

📦 Consumables

Assets → Consumables keeps count of the things a service desk counts rather than tracks one by one - toner, fusers, rollers, paper, mice, keyboards, RAM, drives. You can see what is on the shelf, issue it against tickets, be told when it runs low, reorder through a form, and do stock takes that record what went missing and what it was worth.

New in 5.8.0. Asked for by email by a supporter of the project who ran printer parts and spares from a spreadsheet and only found out something had run out when the shelf was empty. Design and decisions: Consumables - design. Developers: Consumables - Developer Guide.


Asset or consumable?

If you would write down its serial number, it is an asset. If you would count it, it is a consumable.

Laptops, switches, access points and small printers stay assets - a spare in the cupboard is an asset with an In stock status. Toner, paper and mice are consumables: a quantity on a shelf.

Setting it up

  1. Assets → Settings → Consumables: add the types (Toner, Paper, Peripherals...).
  2. System → Custom fields → Consumables (optional): fields for every type, or one type's own - a Page yield for toner, a Weight for paper.
  3. Back on Assets → Settings → Consumables:
    • Tell these people when stock runs low - tick who gets the bell. Nobody is ticked at first.
    • Reorder form - choose a form from Forms (a requisition), and which of its questions gets the item, its part number, supplier, a suggested quantity, its unit cost and a note. Leave it on No reorder button if you do not want one.
  4. Assets → Consumables → New: add the items, with a unit, supplier, unit cost, Reorder at and Minimum.

Day to day

Open an item to see what is on hand, what it is worth, its details, and two tabs: Movements and History.

Button What it records
Receive A delivery: quantity, unit price, supplier, invoice number and date. A delivery at a new price becomes the item's price.
Issue Stock going out: quantity, who it went to, and the ticket when there is one.
Return Stock coming back, and from whom.
Adjust Damaged, found or written off - up or down, with a reason. Needs the Adjust consumable stock permission.
Reorder Opens the reorder form, filled in (when one is set up).
  • Never below zero. Issuing more than is there is refused: Only 3 in stock. If the shelf really has more, receive it or do a stock take.
  • Against a ticket. On a ticket, Link to... → Consumables opens this screen with Issue beside every item, filled in with the ticket and its requester. The issue is in the ticket's history too.
  • A ticket is optional. A walk-up "can I have a mouse" does not need a ticket raised first.

Deliveries: one order, several items, its documents

Deliveries → New books in a whole order at once - 10 mice, 10 toners and 5 keyboards from one supplier is one order number with one document:

  • the supplier, an order number (optional - toner bought on a card has none), the invoice number and date, the date received and a note;
  • a line for each item: the item, how many, and the unit price (filled in from the item's current price).

Receive books every line into stock - all or nothing, so a mistake on one line stops the whole delivery rather than half of it. You land on the delivery's page, which has:

  • its details, which you can correct - every change is recorded, old and new;
  • its lines, each with Undo, and Undo delivery for an order booked in twice (one reason, every line not already undone);
  • Documents: drop the order confirmation, the invoice or the delivery note, paste a link, or pick one from Files - the same panel as on projects, contracts and leases;
  • its history.

Every receipt belongs to a delivery. A quick Receive on one item (with an order number if there is one) makes a one-line delivery, so its paperwork has a home too. An item's Movements show order PO-4471 beside each receipt, linking to its delivery.

The Deliveries list searches by order number, invoice number, supplier or any item on it, and shows each delivery's value and how many documents it has.

Using consumables on tickets

  • Right-click a ticket → Use a consumable: the first 10 items of the ticket's company, how many of each are in stock, and a search box; an item that has run out is greyed. Picking one issues one against the ticket, to its requester, in one click - from the ticket's own company's stock only.
  • The ticket's Links strip shows what was used (📦 1 x USB mouse). The ✕ undoes it, asking why, and the undo sits beside it in the ledger.
  • Link to... → Consumables on a ticket still opens the full screen, for more than one, a different person, or a return.

Asking for one on a form

In Forms, add a Lookup question on Consumables - Which toner do you need? - to a request form. It searches the items in use in the requester's company, by name or part number, and can be ticked for use on the self-service portal, so people request supplies themselves.

The ticket raised from the request shows each item asked for as a dashed pill - Asked for: HP 26A - and clicking it uses one. Asking never moves stock: only somebody using it - handing it over - does, so the shelf and the records stay the same thing.

Everything is recorded

  • Nobody ever types a stock figure. Every receipt, issue, return and adjustment is a line in Movements with who, when, to or from whom, the ticket, the invoice and its value at the time - so last year's figures do not change when the price does.
  • A mistake is undone, never edited. Undo asks why and adds the opposite movement beside the original, which stays - so the history shows both the mistake and the correction. A movement can be undone once; undoing an adjustment needs the adjust permission.
  • History lists every change to the item itself - name, type, supplier, cost, levels, custom fields - with the old and new value.

Running low

At or below Reorder at, an item is marked Low (or Out at zero):

  • the list's Low or out of stock filter shows it;
  • Watchtower's Assets card counts it under Low stock, and the number opens that list;
  • the people ticked in Settings get a bell - once each time it falls, and again only after it has been restocked and fallen again.

Stock takes

Stock take → Start, then walk the shelves and type what is actually there. Each figure is saved as you leave its box.

  • Each line keeps what the records expected at that moment, what was counted, the difference and its value. Expecting 10 toners and finding 8 records -2, and -2 × the toner's price.
  • Finish puts the stock right and keeps the differences for ever. It needs the Adjust consumable stock permission - a count that changes stock is an adjustment.
  • Stock issued between counting a line and finishing still comes out right: finishing posts the difference, not the counted figure.
  • Cancel changes nothing; what was counted stays on record.

Differences

Differences charts what stock takes found missing and extra, month by month, in money or units - shown apart, so a gain of 3 never hides a loss of 3 - with the items that go missing most at the top.

Permissions (System → Roles)

Who Can
Anyone with Assets See consumables, the stock takes and Differences; enter counts in a stock take
Anyone with write access to Assets Add and edit items; receive, issue and return; undo those
Adjust consumable stock (administrators, or a role given it) Adjust stock, undo an adjustment, and finish a stock take
Set up consumables (administrators, or a role given it) Types, who hears about low stock, the reorder form

One store per company, for now

Stock belongs to the company you are working in (the company switcher), in one store per company. More stores - one per site - can come later without changing anything already recorded.

Related pages

FreeITSM

Getting Started

Modules

Multi-tenancy (planned)

Responses to feedback

Blue sky thinking

Bugs resolved

Pull requests

Links

Clone this wiki locally