<h1 class="title">Mobile App - Picking</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/11.0/mobile_app_picking"><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-11-0/stock-logistics-barcode-11-0-mobile_app_picking"><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/11.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 light Web app to scan products Barcode to handle stock pickings with a barcode reader.</p> <p>This module was written to extend the functionality of odoo Stock module.</p> <p>You could be interested by different OCA implementions of such features:</p> <ul class="simple"> <li><code>stock_scanner</code> approach: <a class="reference external" href="https://github.com/OCA/stock-logistics-barcode/tree/11.0/stock_scanner">https://github.com/OCA/stock-logistics-barcode/tree/11.0/stock_scanner</a></li> <li><code>stock_barcodes</code> approach: <a class="reference external" href="https://github.com/OCA/stock-logistics-barcode/tree/11.0/stock_barcodes">https://github.com/OCA/stock-logistics-barcode/tree/11.0/stock_barcodes</a></li> </ul> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li> <li><a class="reference internal" href="#usage" id="id2">Usage</a></li> <li><a class="reference internal" href="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li> <li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id5">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id6">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id7">Contributors</a></li> <li><a class="reference internal" href="#other-credits" id="id8">Other credits</a></li> <li><a class="reference internal" href="#maintainers" id="id9">Maintainers</a></li> </ul> </li> </ul> </div> <a name="configuration"></a> <h2><a class="toc-backref" href="#id1">Configuration</a></h2> <ul class="simple"> <li>Go to 'Inventory' / 'Configuration' / 'Warehouse Management' / 'Operations Types'</li> <li>Select an operation type you want to handle with your mobile</li> <li>Check the box 'Available on Mobile'</li> </ul> <p>Optionaly you can put two extra settings:</p> <ul class="simple"> <li>'Create backorder' if you want that confirm picking on the Mobile App generate or not a backorder by default.</li> <li>'Product fields' to select extra custom fields that will be displayed on the mobile app.</li> </ul> <div class="figure"> <img alt="https://raw.githubusercontent.com/OCA/stock-logistics-barcode/11.0/mobile_app_picking/static/description/stock_picking_type_form.png" src="https://raw.githubusercontent.com/OCA/stock-logistics-barcode/11.0/mobile_app_picking/static/description/stock_picking_type_form.png" /> </div> <a name="usage"></a> <h2><a class="toc-backref" href="#id2">Usage</a></h2> <p>Enter the url <a class="reference external" href="http://MY-ODOO-INSTANCE/mobile_app_picking/static/www/index.html">http://MY-ODOO-INSTANCE/mobile_app_picking/static/www/index.html</a></p> <p>You can also enter the url <a class="reference external" href="http://MY-ODOO-INSTANCE/mobile_app_picking">http://MY-ODOO-INSTANCE/mobile_app_picking</a> if all your odoo databases have <code>mobile_app_picking</code> installed.</p> <table class="docutils"> <colgroup> <col width="61%" /> <col width="39%" /> </colgroup> <thead valign="bottom"> <tr><th class="head">Description</th> <th class="head">Screenshot</th> </tr> </thead> <tbody valign="top"> <tr><td><p class="first">Select a database (if your instance has many databases)</p> <p class="last">Enter your credentials and confirm</p> </td> <td><img alt="authentication" src="https://raw.githubusercontent.com/OCA/stock-logistics-barcode/11.0/mobile_app_picking/static/description/mobile_01_authentication.png" style="width: 300px;" /></td> </tr> <tr><td>Select a picking type</td> <td><img alt="list_picking_type" src="https://raw.githubusercontent.com/OCA/stock-logistics-barcode/11.0/mobile_app_picking/static/description/mobile_02_list_picking_type.png" style="width: 300px;" /></td> </tr> <tr><td><p class="first">Select a picking.</p> <p class="last">(you can scan its barcode)</p> </td> <td><img alt="list_picking" src="https://raw.githubusercontent.com/OCA/stock-logistics-barcode/11.0/mobile_app_picking/static/description/mobile_03_list_picking.png" style="width: 300px;" /></td> </tr> <tr><td><p class="first">The next screen displays the detail of the operations.</p> <p>To go the scan screen, click on the 'Scanner' button</p> <p class="last">You can also click on a move line</p> </td> <td><img alt="list_move" src="https://raw.githubusercontent.com/OCA/stock-logistics-barcode/11.0/mobile_app_picking/static/description/mobile_04_list_move.png" style="width: 300px;" /></td> </tr> <tr><td><p class="first">Scan the product barcode:</p> <p>This will display the detail of the operation. (expected and done quantity, the UoM, and also extra fields you could have set in the picking type configuration)</p> <p>Everytime you scan a product, the done quantity will be increased by 1.</p> <p>You can also put a custom quantity in the field if it is easy for your operator to count the number of products</p> <p class="last">At the end of the process, go back to the list of move lines, by clicking on the according button.</p> </td> <td><img alt="scan_mode" src="https://raw.githubusercontent.com/OCA/stock-logistics-barcode/11.0/mobile_app_picking/static/description/mobile_05_scan_mode.png" style="width: 300px;" /></td> </tr> <tr><td><p class="first">You can reset a quantity if you did a bad operation, by clicking on the button on the end of each line.</p> <p class="last">When your picking is finished, click on the 'Validate' button.</p> </td> <td><img alt="list_move_change" src="https://raw.githubusercontent.com/OCA/stock-logistics-barcode/11.0/mobile_app_picking/static/description/mobile_06_list_move_change.png" style="width: 300px;" /></td> </tr> <tr><td><p class="first">It will create a backorder or not, depending on the setting of the picking type.</p> <p class="last">Once validated, the screen will go the screen to select another picking.</p> </td> <td>&nbsp;</td> </tr> </tbody> </table> <p><strong>Colors depending on the quantity</strong></p> <p>The field quantity will have a different background color depending on the difference between expected and done quantity :</p> <ul class="simple"> <li><code>white</code> : no quantity set</li> <li><code>yellow</code> : expected quantity not reached</li> <li><code>green</code> : done quantity corresponds to the expected quantity</li> <li><code>red</code>: done quantity is over the expected quantity</li> </ul> <p><strong>Typical Errors and Warning at the login screen</strong></p> <ul class="simple"> <li>It will not possible to log in if the user is not member of the 'Warehouse / User' group.</li> </ul> <p><strong>Typical Errors and Warning at the scanner screen</strong></p> <ul class="simple"> <li>'Incorrect quantity' if the quantity entered is negative, or is not a float.</li> <li>'Barcode not found in the picking' if the operator tries to scan a product that is not in the list of move lines.</li> <li>'Many operations found' if there are many lines with the same products. In that case, the operator should select manually the line he want to treat.</li> </ul> <a name="known-issues-roadmap"></a> <h2><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h2> <ul class="simple"> <li>For the time being, this module doesn't handle 'Lot', 'Pack' and 'Owner'.</li> <li>The UI doesn't allow to add an unexpected product on the fly.</li> <li>In practice, the mobile app emulate the actions of the user, changing Done quantity of stock moves of a given picking. This action is allowed by odoo under certain conditions, that are defined by the field <code>is_quantity_done_editable</code> of the <code>stock.picking</code>. Using this module if this field is unchecked could generate problems. This field is disabled (amoung others conditions) if user is member of <code>stock.group_stock_multi_locations</code> or <code>stock.group_tracking_owner</code> See the functions <code>_compute_show_details_visible</code> and <code>_compute_is_quantity_done_editable</code> for more detals.</li> <li>Could be interesting to merge the two views <code>list_move</code> and <code>main_scan</code> into a single one module.</li> </ul> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id4">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:%20mobile_app_picking%0Aversion:%2011.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="#id5">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id6">Authors</a></h3> <ul class="simple"> <li>GRAP</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id7">Contributors</a></h3> <ul class="simple"> <li>Sylvain LE GAL (<a class="reference external" href="https://www.twitter.com/legalsylvain">https://www.twitter.com/legalsylvain</a>)</li> </ul> <a name="other-credits"></a> <h3><a class="toc-backref" href="#id8">Other credits</a></h3> <p>The development of this module has been financially supported by:</p> <ul class="simple"> <li>Cycle En Terre (<a class="reference external" href="https://cycle-en-terre.be/">https://cycle-en-terre.be/</a>)</li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id9">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/11.0/mobile_app_picking">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>