Inventory
Configure Low Stock Thresholds, Bell Counts and Device Alerts
Posnic has three related low-stock surfaces with different threshold rules. Set the branch range, add item reorder points where needed and verify each alert surface separately.
- Menu path
- Manage -> Core Settings -> Inventory; Inventory -> Items -> Edit; Inventory -> Low Stock
- Verified from
- Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence
frontend/modules/settings_write.html Inventory tab, frontend/modules/items_write.html items_reorder_point, frontend/static/script/js/modules/js/lowstock.js, api/src/repositories/item.repository.js getLowStockItems, api/src/controllers/items.controller.js itemLowStockTable and quantityCount, api/src/realtime/low-stock-push.js
Set the Branch Fallback Range
- Open Manage -> Core Settings.
- Select the Inventory tab.
- Enter a non-negative number in Low Stock Notification Range. For example, 10 alerts when an eligible item's available quantity reaches 10 or lower.
- Review Stock Log and Track Inventory separately; neither switch changes the threshold number.
- Click Save, then open Inventory -> Low Stock and verify the result for the active branch.
Override the Range for One Item
On the Low Stock page, an item-specific Reorder point takes precedence. When it is empty, Posnic uses the active branch range. Instant items are excluded. The current endpoint does not require Track inventory to be enabled.
- Open Inventory -> Items and edit the item.
- Enter a non-negative Reorder point for that item.
- Save the item.
- Open Inventory -> Low Stock and compare the available quantity with the saved Reorder point.
- Clear the item Reorder point when the item should use the branch Low Stock Notification Range again.
Know Which Alert You Are Reading
| Surface | Threshold and scope | Important behavior |
|---|---|---|
| Inventory -> Low Stock | Active branch; item Reorder point first, otherwise branch range. | Excludes instant items and sorts the lowest quantity first. |
| Header notification bell | Active branch range applied directly. | Does not apply item-specific reorder points, so its count can differ from the page. |
| Device push notification | Widest configured range across the shop, checked shop-wide. | Checked at most once per shop every six hours and sent only when the low-stock count grows. |
Device Push Requirements
- The user must have an active push subscription.
- The user must have Item read permission.
- At least one branch must have a usable Low Stock Notification Range.
- The push contains the count and a link, not the affected item details.
- A falling or unchanged count updates internal state silently and does not send another alert.
- Because the push check is shop-wide and uses the widest branch range, it may not match the active branch page or bell.
Troubleshoot Counts and Missing Alerts
| Symptom | Check | Resolution |
|---|---|---|
| Page shows an item but bell count is lower | The item has a Reorder point above the branch range. | This is expected; align the item point and branch range only if the business wants matching counts. |
| Bell shows an item that is not on the page | The item Reorder point is lower than the branch range. | Compare both thresholds and use the page as the item-specific reorder watchlist. |
| No device alert after restocking or count falls | Push is sent only when the count grows. | No action is required; confirm the current page and bell instead. |
| No device alert after more items become low | Six-hour throttle, no subscription, missing Item read permission or no configured range. | Check permissions and browser notification subscription, then allow the next scheduled check. |
| Unexpected service or non-stock item appears | The item is non-instant and its quantity meets the threshold. | Adjust its item type, quantity or reorder point; Track inventory alone does not exclude it. |
Acceptance Check
- Choose one non-instant test item in the active branch.
- Record its available quantity and set a Reorder point equal to or above that quantity.
- Confirm the item appears in Inventory -> Low Stock.
- Set its Reorder point below the quantity and confirm it leaves the page after refresh.
- Clear the Reorder point and confirm the branch range controls the result.
- Record the page and bell counts separately; do not require them to match when item overrides exist.