📦 bakery

Packaging Stock

Packaging Stock is a dedicated inventory ledger for the boxes, bags, ribbons, wraps, labels, trays and boards you use to package baked goods — tracked completely separately from your sellable Product inventory, so packaging counts never get mixed up with what you sell.

📍 Menu path: Bakery → Packaging Stock

👤 Who uses it: All roles can view; adding, editing, adjusting or deleting packaging items typically needs the same edit permission as other stock pages

Overview

Each packaging item has its own Name, optional SKU, Category (Box, Bag, Ribbon, Wrap, Label, Tray, Board or Other), current Quantity, Unit (pcs, rolls, sheets, etc.), a Low Stock Alert threshold, and a Cost per Unit used to value your packaging stock.

The page shows a running low-stock banner naming every item currently at or below its threshold, plus summary tiles for Total Items, Low Stock count and total Stock Value (quantity × cost).

Stock is changed with a dedicated Adjust Stock action — Stock In, Stock Out, or Set To — completely independent from Inventory's product stock adjustment; packaging never appears on the regular Inventory page.

Before You Start

None — this page has no plan-tier gate and no dependency on Products; packaging items are created directly here.

Step-by-Step Guide

1 Add a packaging item

Click Add Item.
Enter Name * (required, e.g. "8-inch Cake Box"), optional SKU, Category, Opening Stock (quantity) and Unit (e.g. pcs, rolls, sheets).
Enter Cost per Unit and a Low Stock Alert threshold.
Click Add Item.

2 Adjust packaging stock

Click Stock on any row to open Adjust Stock.
Choose Stock In (received new packaging), Stock Out (used or consumed), or Set To (correct to an exact counted quantity).
Enter the Quantity and an optional Note, e.g. "New stock received" or "used for order".
Click Update Stock.

3 Edit or delete a packaging item

Click the edit icon to change its Name, SKU, Category, Unit, Cost per Unit or Low Stock Alert threshold — the quantity itself is only changed via Adjust Stock, not the edit form.
Click the trash icon and confirm to permanently delete an item.

4 Watch and act on low stock

Any item at or below its Low Stock Alert threshold is highlighted amber in the table and listed by name in the low-stock banner at the top of the page.
Use the category chip row to filter the table down to just Boxes, Bags, Ribbons, etc. when restocking a specific category.

Every Field & Button, Explained

Field / Button	What it does
`Add Item`	Opens the form to create a new packaging item.
`Low stock banner`	Names every item currently at or below its Low Stock Alert threshold; only shown when at least one item is low.
`Total Items / Low Stock / Stock Value tiles`	Summary stats across every packaging item currently on file.
`Category filter chips`	Built dynamically from categories already used on your packaging items.
`Item / SKU column`	Packaging item name and optional SKU code.
`Category column`	Box, Bag, Ribbon, Wrap, Label, Tray, Board or Other.
`In Stock column`	Current quantity; highlighted amber with a warning icon when at or below the alert threshold.
`Alert At column`	The configured Low Stock Alert threshold for that item.
`Cost/Unit column`	Current cost per unit used to value the item.
`Stock Value column`	Quantity × Cost per Unit for that item.
`Stock button`	Opens the Adjust Stock modal for that item.
`Edit icon`	Opens the item form pre-filled for editing (name, SKU, category, unit, cost, alert threshold).
`Delete icon`	Permanently deletes the item after a confirmation prompt.
`Name *`	Required identifying name for the packaging item.
`SKU`	Optional internal code.
`Opening Stock / Unit (add form)`	Starting quantity and its unit of measure when first creating an item.
`Cost per Unit (₹)`	Used to compute Stock Value.
`Low Stock Alert`	Quantity threshold at or below which the item is flagged as low stock.
`Adjustment Type: Stock In / Stock Out / Set To`	Add to, subtract from, or replace the current quantity outright.
`Quantity (adjust modal)`	The amount to add, remove, or set exactly, depending on the chosen adjustment type.
`Notes (adjust modal)`	Optional free-text reason recorded with the adjustment.

Tips & Best Practices

Set a realistic Low Stock Alert per packaging category — a 500-piece roll of ribbon and an 8-inch cake box run out at very different rates.
Use Set To after a physical packaging stock count rather than calculating and entering a Stock In/Out delta yourself — it removes arithmetic mistakes.
Keep Cost per Unit current; the Stock Value tile is only meaningful when costs reflect your latest purchase price.
Note the reason (e.g. "used for order #123", "damaged in transit") every time you log a Stock Out — it turns the packaging log into a mini audit trail later.

Troubleshooting & FAQ

An item's In Stock number doesn't match what's really on the shelf.

Use Adjust Stock with Set To and enter the freshly counted quantity — this replaces the stored quantity exactly rather than adding or subtracting a delta.

I can't find a packaging item that should exist.

Packaging items are entirely separate from Products; if it was never added here, click Add Item to create it.

The low stock banner keeps showing an item I've already restocked.

Its Low Stock Alert threshold may be higher than you expect — check the item's Alert At value; it still counts as low as long as quantity stays at or below that number.

Stock Value looks too low or too high.

It is simply Quantity × Cost per Unit summed across every item. Check that Cost per Unit is filled in correctly for each item, since a blank or zero cost silently contributes nothing to the total.

🧑‍💻 Developer Notes

Source component(s):

frontend-app/pos-app-backery/src/pages/bakery/PackagingPage.jsx

Backend endpoints used:

GET /bakery/packaging
POST /bakery/packaging
PUT /bakery/packaging/:id
DELETE /bakery/packaging/:id
POST /bakery/packaging/:id/adjust

Related tables (db-core repositories):

BakeryPackagingItem
BakeryPackagingMovement

Redux slices:

None — local component state only

Feature flag key: packaging

A local, bakery-only component (not shared via pos-react-lib) — packaging items live in their own table and API namespace, completely independent of the Product/Inventory schema used elsewhere in BazaarPOS, so packaging quantities never show up on the main Inventory page or in product-based stock reports.