<h1 class="title">Stock Barcodes</h1> <p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/stock-logistics-barcode/tree/14.0/stock_barcodes"><img alt="OCA/stock-logistics-barcode" src="https://img.shields.io/badge/github-OCA%2Fstock--logistics--barcode-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/stock-logistics-barcode-14-0/stock-logistics-barcode-14-0-stock_barcodes"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/150/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> <p>This module provides a barcode reader interface for stock module.</p> <p>This module contains a base wizard read barcode that can be extended by other modules.</p> <p>This module also makes use of this wizard for providing barcode support for doing inventories and picking operations.</p> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#usage" id="id4">Usage</a><ul> <li><a class="reference internal" href="#barcode-interface-for-inventory-operations" id="id5">Barcode interface for inventory operations</a></li> <li><a class="reference internal" href="#barcode-interface-for-picking-operations" id="id6">Barcode interface for picking operations</a></li> <li><a class="reference internal" href="#automatic-operation-mode" id="id7">Automatic operation mode</a></li> <li><a class="reference internal" href="#manual-entry-mode" id="id8">Manual entry mode</a></li> <li><a class="reference internal" href="#scan-logs" id="id9">Scan logs</a></li> </ul> </li> <li><a class="reference internal" href="#known-issues-roadmap" id="id10">Known issues / Roadmap</a></li> <li><a class="reference internal" href="#changelog" id="id11">Changelog</a><ul> <li><a class="reference internal" href="#id1" id="id12">11.0.1.1.0 (2019-09-24)</a></li> <li><a class="reference internal" href="#id2" id="id13">13.0.1.1.1 (2021-02-06)</a></li> <li><a class="reference internal" href="#id3" id="id14">14.0.1.0.0 (2021-04-05)</a></li> </ul> </li> <li><a class="reference internal" href="#bug-tracker" id="id15">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id16">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id17">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id18">Contributors</a></li> <li><a class="reference internal" href="#maintainers" id="id19">Maintainers</a></li> </ul> </li> </ul> </div> <a name="usage"></a> <h2><a class="toc-backref" href="#id4">Usage</a></h2> <a name="barcode-interface-for-inventory-operations"></a> <h3><a class="toc-backref" href="#id5">Barcode interface for inventory operations</a></h3> <p>To use the barcode interface on inventory:</p> <ol class="arabic simple"> <li>Go to <em>Inventory &gt; operations &gt; Inventory Adjustments</em>.</li> <li>Create new inventory with &quot;Select products manually&quot; option.</li> <li>Start inventory.</li> <li>Click to &quot;Scan barcodes&quot; smart button.</li> <li>Start reading barcodes.</li> </ol> <a name="barcode-interface-for-picking-operations"></a> <h3><a class="toc-backref" href="#id6">Barcode interface for picking operations</a></h3> <p>You can use the barcode interface in a picking or an operation type, the main difference is that if you open the barcode interface from a picking, this picking is locked and you read products for it.</p> <p>To use the barcode interface on picking operations:</p> <ol class="arabic simple"> <li>Go to <em>Inventory</em>.</li> <li>Click on scanner button on any operation type.</li> <li>Start reading barcodes.</li> </ol> <p>To use the barcode interface on a picking:</p> <ol class="arabic simple"> <li>Go to <em>Inventory &gt; Transfers</em>.</li> <li>Click to &quot;Scan barcodes&quot; smart button.</li> <li>Start reading barcodes.</li> </ol> <p>The barcode scanner interface has two operation modes. In both of them user can scan:</p> <ol class="arabic simple"> <li>Warehouse locations with barcode.</li> <li>Product packaging with barcode.</li> <li>Product with barcode.</li> <li>Product Lots (The barcode is name field in this case).</li> </ol> <a name="automatic-operation-mode"></a> <h3><a class="toc-backref" href="#id7">Automatic operation mode</a></h3> <p>This is the default mode, all screen controls are locked to avoid scan into fields.</p> <p>The user only has to scan barcode in physical warehouse locations with a scanner hardward, the interface read the barcode and do operations in this order:</p> <ol class="arabic simple"> <li>Try search a product, if found, is assigned to product_id field and creates or update inventory line with 1.0 unit. (If product has tracking by lots the interface wait for a lot to be scanned).</li> <li>Try search a product packaging, if found, the product_id related is set, product quantities are updated and create or update inventory line with product quantities defined in the product packaging.</li> <li>Try search a lot (The product is mandatory in this case so you first scan a product and then scann a lot), this lot field is not erased until that product change, so for each product scann the interface add or update a inventory line with this lot.</li> <li>Try to search a location, if found the field location is set and next scan action will be done with this warehouse location.</li> </ol> <p>If barcode has not found, when message is displayed you can create this lot scanning the product.</p> <a name="manual-entry-mode"></a> <h3><a class="toc-backref" href="#id8">Manual entry mode</a></h3> <p>You can change to &quot;manual entry data&quot; to allow to select data without scanner hardware, but hardward scanner still active on, so a use case would be when user wants set quantities manually instead increment 1.0 unit peer scan action.</p> <a name="scan-logs"></a> <h3><a class="toc-backref" href="#id9">Scan logs</a></h3> <p>All scanned barcodes are saved into model. Barcode scanning interface display 10 last records linked to model, the goal of this log is show to user other reads with the same product and location done by other users. User can remove the last read scan.</p> <a name="known-issues-roadmap"></a> <h2><a class="toc-backref" href="#id10">Known issues / Roadmap</a></h2> <ul class="simple"> <li>Excute action_done() method outside onchange environment.</li> <li>Allow create product when a barcode has not been found.</li> <li>Allow to select picking reading its barcode.</li> <li>Allow to select multiple pickings to process scanned products.</li> </ul> <a name="changelog"></a> <h2><a class="toc-backref" href="#id11">Changelog</a></h2> <a name="id1"></a> <h3><a class="toc-backref" href="#id12">11.0.1.1.0 (2019-09-24)</a></h3> <ul class="simple"> <li>[ADD] New feature. User can uses barcode interface in picking operations.</li> </ul> <a name="id2"></a> <h3><a class="toc-backref" href="#id13">13.0.1.1.1 (2021-02-06)</a></h3> <ul class="simple"> <li>[ADD] New feature. Add option to get lots automatically based on removal strategy in inventory.</li> </ul> <a name="id3"></a> <h3><a class="toc-backref" href="#id14">14.0.1.0.0 (2021-04-05)</a></h3> <ul class="simple"> <li>[ADD] New feature. Add security for users.</li> </ul> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id15">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/stock-logistics-barcode/issues">GitHub Issues</a>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed <a class="reference external" href="https://github.com/OCA/stock-logistics-barcode/issues/new?body=module:%20stock_barcodes%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="credits"></a> <h2><a class="toc-backref" href="#id16">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id17">Authors</a></h3> <ul class="simple"> <li>Tecnativa</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id18">Contributors</a></h3> <ul class="simple"> <li><a class="reference external" href="https://www.tecnativa.com">Tecnativa</a>:<ul> <li>Sergio Teruel</li> <li>Carlos Dauden</li> <li>Pedro M. Baeza</li> </ul> </li> <li><a class="reference external" href="https://www.onestein.eu">Onestein</a>:<ul> <li>Andrea Stirpe</li> </ul> </li> <li><a class="reference external" href="https://www.initos.com">InitOS</a>:<ul> <li>Foram Shah</li> </ul> </li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id19">Maintainers</a></h3> <p>This module is maintained by the OCA.</p> <a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a> <p>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.</p> <p>This module is part of the <a class="reference external" href="https://github.com/OCA/stock-logistics-barcode/tree/14.0/stock_barcodes">OCA/stock-logistics-barcode</a> project on GitHub.</p> <p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>