Skip to main content
The Scanned items drawer open on two collected units, with Clear all scans, Edit, Archive and Add all

Inventory > Stock items, with two units collected

Open in TWICE Admin

inventory/stock-items
Give each unit a code, put it on the unit, and scan it to collect that unit anywhere in the admin. This page also settles what the other three scannable codes do, because staff conflate the first two. Put the stock code on the asset tag and the listing barcode on the shelf label. A picker holding an item asks “which unit is this”. Someone at a counter asks “what is this”.

Prerequisites

Required permissions:
  • inventory:stock_item:create for codes set while registering
  • inventory:stock_item:manage for codes changed afterwards
  • account_settings:barcode_search:view to scan a code at all
All four system roles hold every one.
Decide where your codes come from before you start.Mix both across a fleet freely. Do not mix both on one unit, because a unit’s codes are one list.

The walkthrough

1

Set codes when you register

In the Register new stock item dialog, set Item codes to decide where the codes come from.
  • Auto-generate lets TWICE create them. Quantity then decides how many units you get.
  • Manual means you type them, and the Quantity field disappears. The number of codes you enter is the number of units. Three codes, three units.
Count the codes before you submit. That swap catches people out.
2

Add or change codes on an existing unit

Open the item and edit its codes on the General tab.Give one unit more than one code when it already carries a supplier’s label and you want your own alongside it. Both resolve to the same unit when scanned.
3

Put the code on the physical unit

Print the code and stick it where a picker will look. Keep it off a part that gets removed, and off anywhere that will be scuffed within a season.Use a document template to render the barcode, so the label comes out of TWICE rather than a separate tool.
4

Scan the code

Scan anywhere in the admin. There is no scan field to focus first: TWICE watches for scanner input and acts on the code.A stock code collects the unit into the Scanned items drawer instead of navigating away, so you can build a pile off a shelf and act on all of it at once. Scan a second unit of a bulk stock item and the count on its row goes up.
5

Act on the pile

Pick an action in the Scanned items drawer. It carries four.
A bulk edit session opened from the scanned pile, headed Editing multiple items, 2 selected

Inventory > Stock items > Scanned items > Edit

6

Send the pile somewhere with Add all

Open Add all and pick a destination. Read the second row before you use the first.Into available stock frees units by ending what holds them, so a unit still out with a customer has its order ended. Use it to clear stale holds, not to tidy a pile you scanned by mistake. Clear all scans is the one that changes nothing.
The Add all menu open on Into available stock, Into reservation and Into order

Inventory > Stock items > Scanned items > Add all

7

Know what a scan will resolve to

Expect one string to be checked against all four kinds at once. Each kind is unique only within itself, so one string can name a unit, a listing, a SKU and an order together.A code matching exactly one thing is acted on as the table at the top of this page says. A code matching more than one is reported rather than resolved: a dialog headed “This code matches more than one thing” lists the matches and asks you to pick. No kind of code outranks another.
The dialog This code matches more than one thing, listing a stock item and a listing to choose between

One code naming both a stock item and a listing

Order references match more loosely than the other three, on purpose. A reference matches in full, and a bare number matches too, so scanning 42 finds the order shown as #42. Only a query of digits alone is read as an order number, so 123-A never finds order #123.

How do I know it worked?

  • Scanning the label adds the unit to Scanned items, named on its own row.
  • A code that does not resolve says so: Code not found, in a notification. TWICE read the scanner fine and found nothing, which is a different problem from the scanner not working.
  • The code is on the item’s General tab, alongside the item’s other codes if it carries several.

Troubleshooting / common pitfalls

Click on empty page space and scan again. Scanning is deliberately ignored while an input, textarea or editable field has focus, so a scan into a form field goes into the field.Check whether you are on an order page. Orders run their own scanner, which puts things on the order rather than collecting them. That is intended while picking, not a fault.
The scan worked and the lookup found nothing. Codes match exactly, after trimming surrounding whitespace, with no partial or fuzzy matching.Search the inventory table for the code as text. If it is not there, the unit does not carry it. If it is there and the scan still fails, compare the two character for character: a scanner configured to add a prefix, a suffix or a carriage return produces a string that no longer matches.
Pick the one you meant and the scan carries on. The string is on more than one object, most often a manufacturer barcode used as both a stock code and a listing barcode.Keep the namespaces apart to stop the question being asked. Give units their own stock codes, auto-generated or prefixed, and leave the manufacturer barcode to the listing.
Find both units and re-code one. Two units carry the same code, or a label went on the wrong unit, so both match and the scan asks rather than choosing.Use auto-generated codes on stock that has no external identifier of its own. They avoid this by construction, which is the main argument for them.
Count the codes before submitting. With Manual codes the number of codes is the number of units, which is why the Quantity field is hidden. Enter five codes for five units.
Give the unit the stock code and the shelf, bin or product label the listing barcode.Labelling them the other way round works right up until you need to tell two identical units apart, which is the entire point of individual tracking.

Stock codes

What a stock code is in the data model.

Listing barcodes

The other identifier, and what each one settles.

Assign and swap stock items

What a scan does on an order instead.

Register stock items

Where codes are first set.

Bulk-edit stock items

Changing identifiers across many units at once.