This module provides a barcode scanning interface for stock operations: receipts, deliveries, internal transfers, relocations and inventory adjustments.
It is designed for keyboard-wedge scanners (USB/Bluetooth) and works on desktop and mobile browsers, without requiring the Odoo Enterprise barcode application.
Main features:
Table of contents
The interface recognizes four kinds of barcodes. Assign them first:
You need the permission Manage Multiple Stock Locations to see the menu.
Go to Inventory > Configuration > Locations.
Select the location and fill in the Barcode field.
You need the permission Manage Product Packaging to see the menu.
Go to Inventory > Configuration > Product Packagings.
Create or select a packaging and fill in the Barcode field. Scanning a packaging selects its product and proposes the packaging quantity.
The lot name acts as its barcode, so no extra configuration is needed (requires Lots & Serial Numbers enabled).
Packages are matched by their name, so scanning a package label selects the package content (requires Packages enabled).
Go to Inventory > Configuration > Barcodes > Barcode Option Groups to define how the scan screen behaves. The first task of an implementation is to analyze with the customer the flow of each operation (what is labelled, what the operator reads and in which order, whether readings are confirmed one by one) and adjust the options below to it. The module ships six example groups: Picking IN, Picking OUT, Picking Internal, Relocation, Inventory and a generic Operation fallback. The Inventory group is always the one used by the inventory scan screen.
GS1-128 labels (stock_barcodes_gs1) are decoded as a whole: the product, lot and quantity they carry are set regardless of the steps.
The Steps to scan list defines, per field of the screen (location, product, packaging, lot, package, destination, destination package, quantity, owner, …):
A field that is required but not scannable in its step can only be filled by default, from the stock of a scanned lot or package, or by hand in manual entry.
On each operation type (Inventory > Configuration > Operation Types) you can select:
The Barcodes tiles and the scanner button of the Inventory > Overview cards only list operation types with a barcode option group. The Scan barcodes button of a transfer uses the generic Operation group when its operation type has none.
Inventory > Configuration > Barcodes > Barcode Actions define the tiles shown in the Barcodes main menu. Each action can have its own barcode: scanning it from the main menu opens the action directly.
Select actions and press Print barcodes to generate a PDF with their Code128 barcodes, e.g. for a laminated menu sheet.
The system parameter stock_barcodes.limit_product_qty (default 999999) rejects absurd quantities caused by scanning a barcode into a quantity input.
The barcode scan screens recognize, in both free and guided mode:
A bell sound confirms a successful scan and an error sound signals a rejected one. Status messages under the barcode field explain what the screen is waiting for and why a scan was rejected. The Manual button toggles manual entry to type values without a scanner.
You can open the scan screen from three places:
Barcodes main menu (app Barcodes): select an operation tile, then pick one of the ready transfers from the list.
An operation type card in Inventory > Overview (scanner button): scan products for any ready picking of that type. With Search picking from product, reading a product opens a ready picking that contains it.
A specific transfer (Scan barcodes button in Inventory > Transfers): the picking is locked and every scan applies to it.
Scan in any order; the screen reacts to the kind of barcode read:
Quantities beyond the picking demand or beyond available stock are not written silently: the screen asks for confirmation (force done) or rejects the scan, depending on the option group.
Once a product is read, the information button next to it opens a dialog with the on hand, incoming, outgoing and forecasted quantities of the product and its stock in each location. Deliveries and internal transfers list first the locations the removal strategy takes stock from; receptions list them in reverse order. Tapping a location fills the source location, or the destination location on receptions.
The buttons next to the source and destination location fields open the same list without the product quantities, to pick a location quickly: the source one in removal strategy order, the destination one (receptions and internal transfers) in reverse order.
On small screens, where the field labels are replaced by icons, these buttons are hidden and the product and location icons become buttons that open them instead.
The screen shows the next pending move (product, lot, quantities, locations) and guides the operator step by step (e.g. Scan Source, then Scan Product, Lot). Scanning something different from what is expected is rejected with an explicit message (Wrong product, Wrong lot, Wrong location).
In the pending moves list you can:
Jump to another line (arrows or tapping a card).
Edit a line with the pencil icon.
Put the whole remaining quantity with the +N button (e.g. +120). Once defined, this button disappears; use the edit icon to change the quantity.
Show the lines already scanned with the eye icon.
Decide the backorder behavior per line when quantities are incomplete (create backorder / no backorder / keep pending).
The Validate button confirms the transfer using the scanned quantities. A wizard is displayed to confirm the action; after validation you return to the ready-pickings list.
If some lines have no quantity, the standard confirmation wizard asks whether to process all quantities.
With Auto put in pack enabled, unpacked lines are packed automatically before validating.
Press the + Product button to add an item not in the demand (when the option group allows non-demanded products).
When you select a product, a numeric field is displayed to add the quantity.
The trash can icon resets the form values (except the location) without closing it; Clean values resets everything and closes the form; Confirm adds the new item.
If a scanned lot does not exist on a receipt, it can be created on the fly (Create lots if not match) or through the new lot dialog.
Unknown packagings can be registered from the scan screen with the new packaging dialog: scan the packaging barcode, set the name and confirm.
Open Barcodes > Inventory (or the Scan barcodes button of an inventory adjustment).
The screen uses the Inventory option group. With the location filled by default it opens on the stock location of the first warehouse; make the location scannable to count other locations. Then scan products, lots, packagings or packages:
Each product scan adds 1 unit to the counted quantity (or the packaging quantity when a packaging is scanned). With Replace quantity on each reading, a new reading overwrites the counted quantity.
With Accumulate repeated readings and manual confirmation, scanning the same product, lot or packaging again before confirming adds one more unit (or packaging) to the quantity to confirm.
Serial-tracked products accept exactly one unit per serial; a second read of the same serial is rejected.
The eye icon switches between the items already counted by you and the pending ones.
Each line in the list can be edited (pencil), incremented/decremented (+/-) or cleared (trash). Confirming an edited line replaces its counted quantity.
The Apply button is displayed when there are counted items. It opens the standard inventory adjustment confirmation (with reason), applies your counted quants and returns to the main menu.
By default the pending moves list on the barcode screen shows the source location and lot of each move. When the option group has Show fixed dest. location enabled, the list also shows the destination location already planned on the stock move line, so the operator sees where the goods must be stored as soon as the picking is opened, without scanning anything.
This only reads the destination resolved upstream when the move was prepared (e.g. the putaway strategy applied at reception). It never recomputes the putaway: putaway is a warehouse decision taken when the move is created, not a barcode-screen concern (see Use location dest. putaway for the opposite, recompute-on-scan behaviour).
In addition, with this option enabled, scanning a product reuses the move line already routed by putaway and keeps its destination, instead of creating a new line at the generic picking destination. This way receiving by barcode keeps the goods on their planned putaway location.
To keep the shown value reliable it is displayed only for moves whose destination has no storage category, i.e. a fixed putaway whose location does not depend on the received quantity. For capacity-based putaway (storage categories) the final location may still change on a partial receipt, so it is intentionally not shown.
Enable it in Inventory > Configuration > Barcode Option Groups, on the option group used by the operation type, with the Show fixed dest. location checkbox.
Technical debt (see docs/TECHNICAL.md):
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.
Current maintainers:
This module is part of the OCA/stock-logistics-barcode project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.