Author: |
Camptocamp, ACSONE SA/NV, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
10.0-stock-storage-type-priority |
Repository: |
acsone/sale-workflow |
Dependencies: |
base_m2m_custom_field,
product,
stock,
stock_operation_cleaner,
stock_quant_package_dimension,
stock_quant_package_product_packaging,
and
web_domain_field |
Languages: |
HTML (398, 9.9%),
PO File (600, 14.9%),
Python (2354, 58.4%),
XML (531, 13.2%),
and
reStructuredText (150, 3.7%) |
Other branches: |
10.0-stock-storage-type-no-package |
Other repositories: |
Change2improve/wms,
DITIntl/wms,
ERPLibre/wms,
Gabinete-Digital/wms,
NeatNerdPrime/wms,
OCA-MUK/wms,
OCA/wms,
SanteLibre/wms,
SeuMarco/wms,
avarterroku/wms,
cameldevs/wms,
camptocamp/wms,
connect-to-ak/wms,
grindtildeath/wms,
gtopba/wms,
guewen/wms,
gurneyalex/wms,
josuf567/wms,
jumbamathews/wms,
kmee/wms,
lideritjnma/wms,
sanube/wms,
sebalix/wms,
sendalpegat/wms,
and
sunshineLhj/wms |
<h1 class="title">Stock Storage Type</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Alpha" src="https://img.shields.io/badge/maturity-Alpha-red.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/wms/tree/13.0/stock_storage_type"><img alt="OCA/wms" src="https://img.shields.io/badge/github-OCA%2Fwms-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/wms-13-0/wms-13-0-stock_storage_type"><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/285/13.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<dl class="docutils">
<dt>This module introduces two new models in order to manage stock moves with</dt>
<dd>packages according to the packaging and stock location properties.</dd>
</dl>
<ul>
<li><p class="first">Stock package storage type (<cite>stock.package.storage.type</cite>)</p>
<p>This model is linked to product.packaging and defines the type of storage
related to a specific packaging.</p>
</li>
<li><p class="first">Stock location storage type (<cite>stock.location.storage.type</cite>)</p>
<p>This models is linked to stock.location and defines the types of storage
that are allowed for a specific location.</p>
</li>
</ul>
<p>Therefore a Stock location storage type can include different Stock package
storage type in order to validate the destination of a move with package into a
stock location.
Moreover Stock location storage type can include product, size or lot
restrictions for the stock locations it's defined on, so that a move with
package will only be allowed if it doesn't violate the restrictions defined
(cf stock_location_storage_type_strategy).</p>
<p>Moreover, this module implements "storage type put-away strategy" in order to compute a
put-away location using storage types.</p>
<p>The standard put-away strategy is applied <em>before</em> the storage type put-away
strategy as the former relies on product or product category and the latter
relies on stock packages.</p>
<p>In other words, when a move is assigned, Odoo standard put-away strategy will be
applied to compute a new destination on the stock move lines, according to the
product.
After this first "put-away computation", the "storage type" put-away strategy
is applied, if the reserved quant is linked to a package defining a package
storage type.</p>
<p>Storage locations linked to the package storage are processed sequentially, if
said storage location is a child of the move line's destination location (i.e
either the put-away location or the move's destination location), then it will
be searched in order to find a children location that is allowed according to
the restrictions defined on the stock location storage types.
If no suitable location is found, the next location in the sequence will be
searched and so on.</p>
<div class="admonition important">
<p class="first admonition-title">Important</p>
<p class="last">This is an alpha version, the data model and design can change at any time without warning.
Only for development or testing purpose, do not use in production.
<a class="reference external" href="https://odoo-community.org/page/development-status">More details on development status</a></p>
</div>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#known-issues-roadmap" id="id1">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id2">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id3">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id4">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id5">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id6">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id1">Known issues / Roadmap</a></h2>
<p>Currently, the module supports only strategies applied on packages (<code>stock.quant.package</code>).
For implementations that do not use packages, it would be possible to add
compatibility with product packaging.</p>
<p>The information needed from a package are:</p>
<ul class="simple">
<li>the storage type, to know which strategy is applied</li>
<li>the dimensions and weight, to apply constraints</li>
</ul>
<p>If we want to support product packaging, we would need to:</p>
<ul class="simple">
<li>guess the product packaging of a move line based on the product and quantities
(multiple of a packaging quantity, for instance 8000 would be a pallet if the pallet
has 2000 units, 1900 would be Box if the Box has 100 units)</li>
<li>from the product packaging, we know the storage type and dimensions</li>
</ul>
<p>Everywhere the module is using <code>package_id</code>, we would have to check this:</p>
<ul class="simple">
<li>use the package if a package is set</li>
<li>else, use the computed packaging</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id2">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/wms/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/wms/issues/new?body=module:%20stock_storage_type%0Aversion:%2013.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="#id3">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id4">Authors</a></h3>
<ul class="simple">
<li>Camptocamp</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id5">Contributors</a></h3>
<ul class="simple">
<li>Akim Juillerat <<a class="reference external" href="mailto:akim.juillerat@camptocamp.com">akim.juillerat@camptocamp.com</a>></li>
<li>Guewen Baconnier <<a class="reference external" href="mailto:guewen.baconnier@camptocamp.com">guewen.baconnier@camptocamp.com</a>></li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id6">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/wms/tree/13.0/stock_storage_type">OCA/wms</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>