addons-cm/stock_inventory_product_exhausted/README.rst

133 lines
5.4 KiB
ReStructuredText

==========================================
Stock Inventory Exhausted Products
==========================================
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:...
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fstock--logistics--warehouse-lightgray.png?logo=github
:target: https://github.com/OCA/stock-logistics-warehouse/tree/16.0/stock_inventory_product_exhausted
:alt: OCA/stock-logistics-warehouse
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/stock-logistics-warehouse-16-0/stock-logistics-warehouse-16-0-stock_inventory_product_exhausted
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/stock-logistics-warehouse&target_branch=16.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
This module extends the functionality of the `stock_inventory` module from the OCA/stock-logistics-warehouse repository to include exhausted products (with zero quantity) in inventory adjustments.
In recent versions of Odoo, when a product reaches zero available quantity, its `stock.quant` is automatically deleted. This module allows creating quants with zero quantity for exhausted products when creating a new inventory adjustment, facilitating the physical counting of these products.
**Table of contents**
.. contents::
:local:
Features
========
* **Configurable field**: Includes a boolean field `include_exhausted_products` to enable/disable the functionality
* **Default behavior**: Maintains the original behavior of the base module when the option is disabled
* **Support for all selection types**: Works with manual selection, by category, specific product, or all products
* **Storable products only**: Creates quants only for products of type `product`, not for services
* **Prevents duplicates**: Does not create duplicate quants if they already exist for the product and location
* **User interface**: Field visible in the inventory adjustment form
Configuration
=============
The module requires no additional configuration. The `include_exhausted_products` field defaults to `False` to maintain compatibility with the original behavior.
Usage
=====
To use this module:
#. Go to **Inventory > Operations > Inventory Adjustments**
#. Create a new inventory adjustment
#. Configure the desired locations and product selection
#. **Enable** the "Include Exhausted Products" field if you want to include products without stock
#. Click on "Start Inventory"
Use cases
---------
**With the field enabled:**
* Zero quantity quants will be created for products that have no stock in the selected locations
* Allows physically counting products that are exhausted in the system
* Useful for complete inventories where you want to verify that there really is no stock of certain products
**With the field disabled:**
* Standard behavior of the original module
* Only products that already have existing quants are included
Known issues / Roadmap
======================
* Review the necessity of the StockQuant class override
* Consider performance optimizations for large product catalogs
* Add option to filter by product categories when including exhausted products
Bug Tracker
============
Bugs are tracked on `GitHub Issues <https://github.com/OCA/stock-logistics-warehouse/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smash it by providing detailed and welcomed
`feedback <https://github.com/OCA/stock-logistics-warehouse/issues/new?body=module:%20stock_inventory_product_exhausted%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
Do not contact contributors directly about support or help with technical issues.
Credits
=======
Authors
~~~~~~~
* Criptomart
Contributors
~~~~~~~~~~~~
* Luis Norte <luisnore@example.com>
Maintainers
~~~~~~~~~~~
This module is maintained by the OCA.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
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.
.. |maintainer-luisnore| image:: https://github.com/luisnore.png?size=40px
:target: https://github.com/luisnore
:alt: luisnore
Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
|maintainer-luisnore|
This module is part of the `OCA/stock-logistics-warehouse <https://github.com/OCA/stock-logistics-warehouse/tree/16.0/stock_inventory_product_exhausted>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.