Docs / Team and floor

Scanning and labels

Scan with a phone camera or a USB scanner to look things up, move, receive, count, pick and pack. Print item, bin, lot and work order labels as a PDF.

In the demo

Scan, Labels and the Fulfillment screen that makes pick lists and shipments are built. Camera reading was tested with generated barcode images, not on real phones.

The Scan screen

Open Scan. It is in the sidebar for the owner, production and warehouse roles. Pick a mode, then scan. Each mode shows only if your role does that work.

A USB barcode scanner works like a keyboard. Click the scan field and scan, and the code is typed in and sent.
On a phone the camera opens by itself. It reads QR, Code 128, EAN-13 and UPC-A, on Scan, on the Production kiosk and work order scan, and on the pick and pack screens in Fulfillment. A browser with its own barcode reader uses it; every other browser uses a built-in decoder. The picture is read in the page and goes nowhere.
No camera, or permission refused? Use Enter code manually, or a USB scanner.
Every scan gives a beep, and the last 30 scans are listed with what each one did.
An unknown code writes nothing and says No match for <code>.

Lockstock reads its own labels first, then an item barcode or SKU, a lot number, a serial number, a bin code, a work order, a purchase order or a sales order number.

The seven modes

Mode	Who	What it does
Look up	Owner, purchaser, production, warehouse	Scan an item, bin, lot, serial, work order or order to see what it is and what it holds.
Move	Owner, purchaser, warehouse	Scan the item, the bin it is in, then the bin it is going to, then type the quantity.
Receive	Owner, purchaser, warehouse	Pick a purchase order. Each scan of an item adds one, or type a quantity. An item that is not on the order is said so and not counted. Going over what is still due needs a reason. Finish writes the receipt once.
Count	Owner, production, warehouse	Pick a bin, scan each item and enter what is on the shelf. The counts sit on a sheet until you press Post counts, which writes the differences. A difference over your write-off limit becomes a proposal for the owner.
Pick	Owner, warehouse	For each row of a pick list, scan the bin, then the item. A wrong bin or item says so and counts nothing. Rows with serial numbers need each serial scanned.
Pack	Owner, warehouse	Scan each item into the box. An item that is not on the shipment, or is already fully packed, is refused.
Kiosk	Owner, production	Scan a work order label to start the task at your work center.

Every write carries its own request id, so a double scan, a retry or a second tab never moves stock twice. A short pick, a backorder, the carrier, the tracking number and Mark shipped are done on Fulfillment, not in Scan.

Scanning on Production

On Production, the scan button opens the camera. Scan a work order label or its number to open that order.
On the shop floor kiosk (/app/production/kiosk), pick a work center and scan to start a task. While a task runs, scanning a component's SKU or lot confirms its row.
A work order's plain number works without a label.

The camera there reads codes only where the browser provides barcode detection. If it does not, the screen says so and you type the code. The Scan screen has a built-in reader and does not have that limit.

Printing labels

Open Labels from a Print label button (an item row or page on Inventory, a bin on Locations, a work order on Production) and the thing you came from is already ticked. Or open it directly and pick Items, Bins, Lots or Work orders, search, and tick what you want.

Choose the size: 2 x 1 in, 4 x 2 in or a sheet of 30. Choose Code 128 or QR. Choose copies of each label, 1 to 500. The preview shows the label before you print.
Download PDF makes the file. One PDF holds up to 1,000 labels, and one job up to 500 things. A code too long for the label you chose is flagged: use QR or a bigger label.
Each download is saved as a print job. Pressing twice or retrying does not save it twice.
Owner, purchaser, production and warehouse can print. A viewer reads only.
An item with no barcode can get one: press Generate one. It saves a code like LS-000001 as the item's barcode. The owner, purchaser and warehouse can do this.

Label codes

A Lockstock label carries one short line. Code 128 and QR carry the same text, and the Scan screen reads all four.

Label	Reads as
Item	`LS1:I:<item barcode>`
Bin	`LS1:B:<bin code>`
Lot	`LS1:L:<lot number>`
Work order	`LS1:W:<work order number>`

A plain item barcode, a SKU, a bin code or a work order number scans too, without a Lockstock label.

Limits

Camera reading was proved with generated barcode images in a test browser, not on a range of real phones. Try your own labels and scanner before you rely on them.
Pick and pack work on a pick list and a shipment that already exist. Make them on Fulfillment. See Orders and shipping.
Stock moves, counts and receipts are written step by step, each guarded by its request id. They are not yet one database transaction.