Lot Traceability
Lot Traceability is designed to answer "which production runs used this batch or ingredient?" — search by a supplier batch number or an ingredient name and see every production run that consumed it, so you can act quickly in a recall situation. On pos-app-restaurant this page currently does not work: it calls a backend endpoint that does not exist for the restaurant app, so every search returns a "Search failed" error.
Overview
This is the same Lot Traceability component used by the bakery variant (FnbLotTraceabilityPage) — it supports two search modes: "By Batch Number" (the exact batch/lot number from a supplier invoice or purchase order) and "By Ingredient Name".
A result is a list of Production Run cards, each expandable to show every ingredient used in that run, with a batch number where one was recorded and the quantity used.
It is intended purely as a lookup tool — there is nothing to create or edit here; lot data is meant to be recorded automatically whenever a production run is marked Done in Production Schedule.
On pos-app-restaurant, this page is wired to call GET /restaurant/lot-traceability, but that route is not registered on the backend for the restaurant app — only /bakery/lot-traceability and /wholesale/lot-traceability exist. Every search on this page for a restaurant tenant currently fails with a "Search failed" toast.
Before You Start
- You must have the Billing feature enabled on your plan, and be on the Enterprise plan tier for this page to be visible.
- Intended prerequisite (not currently functional for restaurant): production runs must have been completed with recipe ingredients linked to products carrying batch numbers, since lot data is meant to be captured automatically at that point.
Step-by-Step Guide
1 Search by batch number (intended use)
- Open Kitchen Operations → Lot Traceability and keep "By Batch Number" selected.
- Get the batch number from the supplier alert or purchase order and enter it, then click Search or press Enter.
- Review every production run listed that used this batch, expanding a card to see the specific ingredients and quantities involved.
2 Search by ingredient name (intended use)
- Switch to "By Ingredient Name" and enter the ingredient (e.g. "Wheat Flour").
- Review every production run that used that ingredient, regardless of batch.
Every Field & Button, Explained
| Field / Button | What it does |
|---|---|
Search mode | By Batch Number (exact match against a supplier/purchase-order batch number) or By Ingredient Name (matches the ingredient name recorded on a production run). |
Production Run card | Shows the run name, production date, run ID, and (when expanded) every ingredient used with its quantity and batch number if tracked. |
Tips & Best Practices
- Do not rely on this page for restaurant tenants today — searches will fail. If you need to trace which dishes/production used a specific supplier batch right now, cross-reference manually via Kitchen Requisitions, Supplier Visit Log and Recipes' ingredient lists until this is fixed.
- Once fixed, treat this as a first-response tool in a supplier recall: search by batch number the moment a supplier alert comes in, rather than waiting to see if any customers report an issue.