Inventory
Inventory keeps the physical item, its available quantity, identifying code, and stock history together. Use it for supplies you sell, equipment you rent, or ingredients consumed by a configured recipe. An inventory item is separate from the customer-facing service, rental offer, or menu where it is used.
The examples follow a plumbing workshop. Its repair-kit stock starts at 36 after two receipts; recording one damaged kit leaves 35. A second example counts two unopened one-litre soap bottles plus a half-full bottle as 2.5 bottles. All amounts and calibration values are illustrative demo data.
Create and maintain inventory
- Open Inventory for the intended business and choose New.
- Select an identifying image and enter a precise item name, including size when relevant.
- Choose Sellable or Rentable according to the item's use.
- Decide whether to enable Inventory tracking. For tracked items, select quantity tracking or serialized units.
- Review the initial stock amount and optional shared code, then choose Create Item.
- Open the saved item to enter its Cost, currency, variants, or other relevant settings. Choose Save after editing.
Setting Cost after creating an item does not backfill its opening cost layers. For a new cost-tracked example, start at zero stock, save the cost, then record the actual received quantity through Restock with its cost. If stock already exists, inspect Inventory value and the Inventory account before assuming the current cost has valued earlier units. The latest demo review found a mismatch after adding cost to an item with existing opening stock; changing the displayed cost alone did not repair that history.

Search and grid/list controls help find the correct record. Duplicate creates a starting point for a similar item; review its copied fields and stock before using it. Before deleting anything, check the menus, rental offers, recipes, and other records that depend on it.
Quantity Tracking
Quantity stores a combined stock amount for interchangeable units. Serialized units tracks physical units individually and manages availability through their statuses. Do not switch modes merely to change a total.
The quantity field may be unavailable when stock comes from linked Inventory Sources, is managed per variant, or you lack Manual Inventory Adjustment permission. A source-linked item derives availability from its ingredients or components; change the actual source stock instead of typing an unrelated total.
Record a movement
- Open the item and choose Adjust Stock.
- Select the reason. Restock adds received units; Damaged / Lost removes units; Sale records a manual stock sale movement.
- Enter a positive quantity and inspect the before/after preview.
- For a restock or sale, review Cost (each) or the price field when shown. Set the item's cost separately for cost tracking.
- Add a specific note, then review the final action, such as Remove 1, before applying it.
- Reopen the item or reload the list to confirm the saved quantity and activity entry.

The adjustment quantity is a movement, not the final shelf total. If the shelf count is 35, do not enter 35 as a removal. Use Count to compare a final physical count with expected stock. A Correction option is also present, but this walkthrough verifies Restock and Damaged / Lost; use the preview and verify the saved direction before relying on another reason.
Count what is actually on hand
- From Inventory, choose Count and select or add the area you are counting.
- Pick an item from To count. Enter its actual counted quantity; bottle items have the additional controls described below.
- Continue through the intended items, then choose Review.
- Compare expected and counted amounts. Remove a mistaken line or use Keep counting to correct it.
- Choose Save count only after review. Only counted items change; uncounted inventory is not set to zero.
- Check the result. If the app reports a partial save, review the named failed items before retrying.

An unfinished count is a local draft for the current business and can resume on the same browser. It is not saved stock, a shared draft on every device, or proof of server availability while offline. Save count requires Manual Inventory Adjustment permission.
Logs
The item's Activity Log explains how stock changed. Read its notes and movement quantities before entering another correction. Repeating a receipt or adjustment can count it twice.
Inventory Logs
- Open the item and scroll to Activity Log.
- Read the newest entry's reason, note, relative time, and quantity change.
- Follow related references, such as a purchase-order number, back to the original record when investigating a receipt.
- Distinguish a movement such as +12 or −1 from a Checkpoint such as = 2.5. A checkpoint establishes a counted baseline; it is not another delivery.

The log loads recent activity and more entries as you scroll where available. Its loaded/end message describes the entries available in that view, rather than promising an accounting audit of every outside system.
Item Tags and Groups
Inventory's filter chips are called groups in the interface. Use them as practical item labels, such as “Service-call supplies,” rather than looking for a separate free-text tag editor on the item page.
- Choose Manage groups beside the Inventory filter chips.
- Choose New Group, enter a name and optional description, then Create Group.
- Open the group and select the items that belong in it.
- Choose Save Assignments.
- Close the dialog and select the group's chip to check the filtered result. All removes that group filter.

Deleting a group unlinks its items without deleting the inventory items themselves. Give groups clear purposes so staff can distinguish a stock grouping from a sellable menu or rental listing.
Barcode Scanning
For a quantity-tracked item, Shared Item Code identifies the whole item. Enter a numeric code, use Generate Number, or use Scan beside the field to read an existing code. Save the item before using that code elsewhere. Serialized unit labels identify individual physical units instead.
From the Inventory list, Scan opens the camera scanner. A supported keyboard-style USB/Bluetooth scanner can also send a code while the page is open and an editable input is not focused. A recognized item opens a result with its name and stock; choose Open item to inspect it.

When a code is unknown, the result can offer linking or creation options according to access and code type. Check the existing catalog before creating a duplicate. For a failed lookup, confirm the saved code, selected business, connection, and whether a text input captured the scanner's typing.
Inventory Labels
The saved shared-code preview offers QR and Barcode views. Download QR saves a PNG; Download Barcode saves an SVG. Copy Code copies the underlying value, not a device login or pairing credential.
- Save the intended item code and inspect its preview.
- Choose Print label.
- Select QR code, Barcode, or Both and review the 40 × 12 mm label preview.
- On a supported device, use Connect Bluetooth to choose the compatible NIIMBOT printer.
- After connection, use Print label, then test the physical label against the intended item before labeling a shelf or batch.

The preview alone does not establish printer compatibility or print quality. Keep item codes distinct from staff PINs and device pairing codes.
Weighed Inventory
Bottle profiles let a count combine unopened containers with partially filled ones. Set up the actual size and weights before using a scale reading; a typical-weight estimate is different from a measured calibration.
Set up the bottle
- Open the item and choose Set up bottle or Customize.
- Review the shape, type, size in millilitres, and visual colours. Use the appropriate type, including Other when applicable.
- Enter the weights of an actual unopened and empty container, in grams. Use Weigh when a supported scale is connected.
- Choose whether stock is kept in Bottles or Millilitres. Review conversion carefully when changing an existing stock unit.
- Choose Add bottle for a new profile or Done when customizing, then Save on the item page to persist the profile.

Count unopened and open bottles
In Count, select the bottle item. Use the Unopened stepper for full containers. With a supported connected scale, review the stable reading and any pourer allowance before adding an open bottle. Without a live scale, drag the bottle's fill level and choose Add open bottle for a manual estimate.

Review the open-bottle entries and remove accidental duplicates before saving. If automatic addition is enabled for a live scale, follow the prompt to lift the bottle after a settled reading so it is not counted repeatedly. Scale input uses supported native terminal hardware or WebHID where available; physical scale accuracy and camera-based bottle recognition were not verified here.
Inventory Cost Tracking
Set the item's Cost and currency before recording stock receipts. Cost describes what the stock costs the business; it is separate from selling prices. Where variants have their own cost, review the per-type option and each variant.
In Books, recorded stock movements feed inventory cost layers using first-in, first-out treatment. Open Accounting → Reports → Inventory value to compare on-hand quantity, average cost, recorded value, and the Inventory account. A purchase-order receipt should also be checked against its linked item and received quantity.

Check missing costs, receipt history, fractional quantities, and rounding when the report and account differ. Changing today's item cost does not establish the correct value of all previous receipts. The current report uses remaining cost layers; its displayed date control should not be treated as proof of a reconstructed historical valuation. See Financial reports for the report's limits.
Troubleshooting
| Situation | What to check |
|---|---|
| Quantity still looks old after an adjustment | Reopen the item or reload the list, then inspect both stock and the new log entry. Do not apply the same movement again just to refresh the screen. |
| Stock is not editable | Manual adjustment permission, serialized mode, variants, and linked Inventory Sources. |
| An item is absent from a group filter | Saved group assignments and the active chip. Switch to All to search the full list. |
| A counted total is unexpectedly low | Missing unopened counts, an accidental empty count, removed open-bottle entries, and the selected stock unit. |
| A bottle estimate differs from a scale reading | Full/empty weights, container size, scale stability, and any pourer allowance. |
| Labels cannot connect or print | Browser/native Bluetooth support, compatible printer, connection state, and any visible error. |
| Inventory value differs from the books | Cost layers, missing receipts, fractional quantities, and the report's displayed difference. Investigate before posting a correction. |
Continue with Receive supplies and check stock, Bills and suppliers, Financial reports, Rentals, or Menus.