Stock
The Stock page is the single place for day-to-day goods management. It combines the sales catalog, live stock levels, goods receipt entry, the movement ledger and the supplier directory in one page with five tabs. Open it from the Stock entry in the main navigation sidebar.
Products, Suppliers and Inventory previously lived inside Settings. They now live here so that weekly goods entry and daily stock questions do not require opening the configuration area.
Tabs
| Tab | Purpose |
|---|---|
| Cafe Menu | The sales catalog: names, prices, barcodes, categories, photos and the order of categories. See Products for field details. |
| Stock | Live stock levels with thresholds, counts, increases, decreases, waste and returns. |
| Stock Receipt | Enter a supplier delivery line by line against an invoice. Saving the receipt increases stock. |
| Movements | The full stock ledger across all products, with filters and CSV export. |
| Suppliers | The vendor directory with contact details, payment terms and supplier payments. See Suppliers for field details. |
The Cafe Menu and Suppliers tabs show a count badge. The Stock tab shows the product count and switches to a warning badge with the number of critical products as soon as one product is at or below its threshold. The Stock and Movements tabs are hidden for a cashier whose role cannot see stock.
Cafe Menu
The Cafe Menu tab lists what customers can order. Switch between Table and Grid views, search by name and filter by category. Category Order sets the order in which categories appear. Drag a row or use Move Up and Move Down, then click Save.
Click New Product to add a product. Besides the catalog fields, the product dialog has:
| Field | Meaning |
|---|---|
| Track stock | Leave this off for items you never count, such as food made to order. They stay on sale and show no stock number |
| Opening stock | How many you have on hand right now. Saved as the first stock entry |
| Critical threshold | You are warned when stock drops to this level. Zero means no warning |
| Purchase cost | What you pay your supplier. Used for the margin estimate until the first receipt arrives |
| Pick from stock | Fills the form from a product that already exists on the Stock page |
Stock quantities cannot be edited on this tab. They change only through the Stock tab, receipts, sales and returns.
Products that are not counted
A product with Track stock off shows an Available badge instead of a stock number. When you run out of it, use Mark as sold out. The product then shows Sold out and cannot be ordered. Use Back on sale when it is available again. Counted products show In Stock or Out of Stock based on their quantity.
Remove from Sale deletes the product from the catalog after a confirmation. This cannot be undone. To hide a product while keeping its stock history, use Deactivate in its detail panel on the Stock tab.
Stock Receipt
The Stock Receipt tab records a delivery as a single receipt document:
- Select or type the Supplier.
- Enter the Invoice No and Invoice Date from the supplier's document.
- Add lines with Add line or scan a barcode into the barcode field. Each line has a Barcode, the Product, the Quantity, the Purchase price, an optional Discount and the VAT rate. The line total is calculated automatically. Use Edit line to change a line.
- Review the totals: Subtotal, Discount, VAT and Grand total.
- Click Save.
The currency is fixed to the system currency configured in Settings > General and cannot be changed on the receipt.
New products from the receipt
When a scanned barcode or a typed name does not match an existing product, the line can be added with Add as a new product. The product is created in the catalog when the receipt is saved. A first delivery can build the catalog as it is entered. Products created this way have no sale price yet. The Stock tab lists them under a warning with a Complete prices action, because they cannot be sold at the till until they have a price.
Drafts
The receipt in progress is saved as a draft automatically. You can leave the page and return without losing the entry. Discard draft clears the current receipt after a confirmation.
Validation
A receipt cannot be saved without a supplier, an invoice number or at least one line. Every line needs a quantity greater than zero and a purchase price that is not negative.
What saving does
Saving a receipt:
- Stores the receipt with its supplier, invoice number, invoice date, lines and the cashier who entered it.
- Increases the stock level of every product on the receipt by the received quantity.
- Records a Purchase movement for each line in the product's movement history.
Receipt history and editing receipts
The Receipt history button opens a list of past receipts showing the invoice number, supplier, date, line count and total. Selecting a receipt shows its individual lines.
To correct a saved receipt, open it in the history and click Edit this receipt. The receipt opens on the tab in edit mode. Saving with Save changes overwrites the saved receipt and corrects stock by the difference. Cancel editing discards the changes. A draft in progress is set aside while you edit and comes back afterwards.
Stock
The Stock tab is the live view of what is on the shelf.
Summary cards and alerts
Cards at the top show the Stock value and the number of products that are Critical (below threshold), Out of stock, at Negative stock (more sold than received), without a threshold (No threshold) and Idle (no movement in 30 days). Alert banners point out products created without a sale price, products without a critical threshold and products with negative stock. Run a count to correct negative stock.
Filters and views
Use the search field (Search product, barcode or category), the category list and the filter chips Critical, Out of stock, No threshold, Idle and Unvalued. Active and All decide whether deactivated products are listed. Switch between Table and Grid views.
| Column | Meaning |
|---|---|
| Stock | The current quantity on hand |
| Threshold | The minimum stock level set for the product. Zero means no threshold |
| Sale price | The current sale price |
| Last purchase | The last net purchase price from a receipt |
| Margin | Sale price against the last net purchase price, as an estimate |
| Stock value | The value of the remaining quantity |
| Last movement | When the stock last changed |
A product is critical when its stock is at or below a threshold greater than zero. The footer shows the total stock value and the number of critical items, with Export CSV and Order list buttons.
Product detail panel
Select a product to open its detail panel. It has the tabs Overview, Movements, Purchases and Sales. The overview shows the current stock, the Critical threshold (edit it with the edit button next to it), the Daily usage over the last 30 days, the estimated Days left, a Suggested order quantity, the price and estimated margin, and the last supplier.
The panel footer holds the stock actions for a counted product: Count, Increase and Decrease or waste. Edit opens the product dialog. Deactivate hides the product from the till and from ordering but keeps its stock history. A product that has stock movements cannot be deleted. Deactivate it instead.
Stock actions
The stock dialog has five modes. You can switch between them inside the dialog.
| Mode | What it does |
|---|---|
| Increase | Adds the entered quantity to stock |
| Decrease | Removes the entered quantity from stock |
| Count | Records a physical count. Enter the counted quantity and the stock is set to that value |
| Waste | Records lost, broken or spoiled items with a Reason (Broken, Spoiled or expired, Lost, Other). Stock goes down and the cost is recorded as waste |
| Return | Records an item the customer brought back. Stock goes up. Turn on Returned but unsellable when it cannot be sold again. Stock is then credited back and written off at once. The refund and the loss stay separate in the ledger |
A New stock preview shows the result before you save.
Count mode
Turn on Count mode to count many products at once. Enter what you physically counted next to each product. The difference and its value impact are calculated for you. Click Save differences to save every difference in one go as adjustments.
Order list
The Order list button in the footer opens the products below their threshold, grouped by the supplier each was last bought from, with the suggested and estimated quantities and an estimated total. You can Copy the list, Print it or Send on WhatsApp to the supplier. Products never entered through a receipt are grouped under Supplier unknown.
Movements
The Movements tab is the stock ledger for all products. Pick a period (Today, 7 days, 30 days or Custom) and narrow the list by product, reason, cashier and direction (All, Incoming, Outgoing). You can also search by reference or note. Summary cards show the number of movements, the incoming and outgoing quantities and the waste value. Export CSV saves the filtered list to a file. Rows where stock dropped below zero are marked Stock went negative.
Every stock change is recorded with the date, the reason, the quantity change, the stock level after the change, the cashier and a reference to the source document. Movement reasons are:
| Reason | Meaning |
|---|---|
| Sale | Stock decreased because the product was sold on an order. |
| Purchase | Stock increased from a saved stock receipt. |
| Adjustment | Stock was changed manually with Increase, Decrease or a count. |
| Waste | Stock decreased due to spoilage, breakage or loss. |
| Return | Stock increased from a customer return or an order cancellation. |
Suppliers
The Suppliers tab lists your vendors. Select a supplier to see its deliveries, total spend, average receipt and the products bought from it. Enter goods starts a stock receipt for that supplier. Use Record payment to log a payment against an invoice by cash, card, bank transfer or other method. A cash payment is deducted from the drawer at shift close. An alert appears when payment is overdue for one or more suppliers. A supplier with receipts cannot be deleted. Deactivate it instead.
Permissions
The Stock page follows the same cashier permission as the product and inventory areas. Cashiers without that permission do not see the page. The Stock and Movements tabs are hidden for roles that cannot see stock. See Cashier Roles and Permissions for the permission model. The page can also be hidden for everyone from View Settings.