Author: |
GRAP,Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
11.0-prod |
Repository: |
coopiteasy/stock-logistics-barcode |
Dependencies: |
mobile_app_angular,
and
stock |
Languages: |
CSS (109, 7.5%),
HTML (407, 28.2%),
JSON (49, 3.4%),
JavaScript (551, 38.2%),
PO File (38, 2.6%),
Python (205, 14.2%),
and
XML (85, 5.9%) |
Other branches: |
11.0-mobile-app-picking,
and
11.0-production |
Other repositories: |
Change2improve/stock-logistics-barcode,
Darknroses/stock-logistics-barcode,
Deanzou/stock-logistics-barcode,
Dobtor-OCA/stock-logistics-barcode,
ForgeFlow/stock-logistics-barcode,
Gabinete-Digital/stock-logistics-barcode,
NeatNerdPrime/stock-logistics-barcode,
OCA-MUK/stock-logistics-barcode,
OCA/stock-logistics-barcode,
RealSolutionsLux/stock-logistics-barcode,
Tecnativa/stock-logistics-barcode,
agenterp/stock-logistics-barcode,
anhvu-sg/stock-logistics-barcode,
ansinaesmejor/stock-logistics-barcode,
dani-xtendoo/stock-logistics-barcode,
druidoo-dev/stock-logistics-barcode,
eLBati/stock-logistics-barcode,
ehsu0407/stock-logistics-barcode,
heymanh/stock-logistics-barcode,
jasadmoozhiyan/stock-logistics-barcode,
jimhoefnagels/stock-logistics-barcode,
layounisl/stock-logistics-barcode,
legalsylvain/stock-logistics-barcode,
leonidasthe300/stock-logistics-barcode,
lideritjnma/stock-logistics-barcode,
nabima/stock-logistics-barcode,
nuobit/stock-logistics-barcode,
ofahd/stock-logistics-barcode,
rudisulistyo/stock-logistics-barcode,
rven/stock-logistics-barcode,
sanube/stock-logistics-barcode,
sendalpegat/stock-logistics-barcode,
takobi-online/stock-logistics-barcode,
unitek-solusi/OCA-stock-logistics-barcode,
valmarnet/stock-logistics-barcode,
wader1990/stock-logistics-barcode,
x0rzkov/odoo-stock-logistics-barcode,
xtendoo-corporation/stock-logistics-barcode,
and
zeroincombenze/stock-logistics-barcode |
<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/legalsylvain/stock-logistics-barcode/tree/11.0_ADD_mobile_app_picking/mobile_app_picking"><img alt="legalsylvain/stock-logistics-barcode" src="https://img.shields.io/badge/github-legalsylvain%2Fstock--logistics--barcode-lightgray.png?logo=github" /></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><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/legalsylvain/stock-logistics-barcode/11.0_ADD_mobile_app_picking/mobile_app_picking/static/description/stock_picking_type_form.png" src="https://raw.githubusercontent.com/legalsylvain/stock-logistics-barcode/11.0_ADD_mobile_app_picking/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/legalsylvain/stock-logistics-barcode/11.0_ADD_mobile_app_picking/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/legalsylvain/stock-logistics-barcode/11.0_ADD_mobile_app_picking/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/legalsylvain/stock-logistics-barcode/11.0_ADD_mobile_app_picking/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_line" src="https://raw.githubusercontent.com/legalsylvain/stock-logistics-barcode/11.0_ADD_mobile_app_picking/mobile_app_picking/static/description/mobile_04_list_move_line.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/legalsylvain/stock-logistics-barcode/11.0_ADD_mobile_app_picking/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>When your picking is finished, click on the
'Validate' button.</p>
<p>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><img alt="confirmation" src="https://raw.githubusercontent.com/legalsylvain/stock-logistics-barcode/11.0_ADD_mobile_app_picking/mobile_app_picking/static/description/mobile_06_list_move_line_confirmation.png" style="width: 300px;" /></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>
</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/legalsylvain/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/legalsylvain/stock-logistics-barcode/issues/new?body=module:%20mobile_app_picking%0Aversion:%2011.0_ADD_mobile_app_picking%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 part of the <a class="reference external" href="https://github.com/legalsylvain/stock-logistics-barcode/tree/11.0_ADD_mobile_app_picking/mobile_app_picking">legalsylvain/stock-logistics-barcode</a> project on GitHub.</p>
<p>You are welcome to contribute.</p>