Metadata-Version: 2.1
Name: odoo-addon-stock_move_valuation_usage
Version: 19.0.1.0.0.5
Requires-Dist: odoo-addon-stock_account_product_run_fifo_hook==19.0.*
Requires-Dist: odoo==19.0.*
Summary: Trace where stock move valuation has been used, including quantities and values taken.
Home-page: https://github.com/OCA/stock-logistics-workflow
License: AGPL-3
Author: ForgeFlow,Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Development Status :: 3 - Alpha
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

==========================
Stock Move Valuation Usage
==========================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:5155618e67e22b4a6def0ae272853560502078d8de773e5a906271ce7559731a
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Alpha-red.png
    :target: https://odoo-community.org/page/development-status
    :alt: Alpha
.. |badge2| image:: https://img.shields.io/badge/license-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--workflow-lightgray.png?logo=github
    :target: https://github.com/OCA/stock-logistics-workflow/tree/19.0/stock_move_valuation_usage
    :alt: OCA/stock-logistics-workflow
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/stock-logistics-workflow-19-0/stock-logistics-workflow-19-0-stock_move_valuation_usage
    :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-workflow&target_branch=19.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module allows to trace the usage of stock move valuation. That is,
makes it possible to identify which stock moves were used as sources for
a given outgoing stock move, and how much quantity and value was taken
from each source move.

Note: In Odoo 19.0, stock valuation layer model was removed and
valuation is now tracked directly on stock moves through the 'value'
field.

This kind of traceability is important in case that at some point you
want to conduct a revaluation (for example, in case that the purchase
order price changes after the products have been received into stock).

Also, it changes the way the outgoing move values are calculated in
order to respect the MTO case. When creating the outgoing move
valuation, Odoo uses FIFO to consume from the first available incoming
moves with value. The module stock_move_valuation_usage improves this
process. For standard FIFO, it always uses the oldest move. However, for
MTO cases, when there is a fixed link between the incoming move and the
outgoing move, the system should use the specific incoming move not just
the oldest one. Also, when the case is not MTO, the system should avoid
using moves that are "reserved".

.. IMPORTANT::
   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.
   `More details on development status <https://odoo-community.org/page/development-status>`_

**Table of contents**

.. contents::
   :local:

Usage
=====

- Create a product with that uses a category with automatic inventory
  valuation and FIFO costing method.
- Create a purchase order for this product and receive it into stock.
- Deliver the product to a customer and check the completed stock move
  in 'Inventory / Reporting / Stock Move Valuation Usage', where you
  will be able to identify the source moves that were used to value this
  move, and the quantity and value that was taken.
- Create several MTO order
- Deliver the products to a customer in a random way and check the
  section 'Move Valuation Usage'. The MTO logic is respected, then FIFO
  applies.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/stock-logistics-workflow/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/stock-logistics-workflow/issues/new?body=module:%20stock_move_valuation_usage%0Aversion:%2019.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
-------

* ForgeFlow

Contributors
------------

- ForgeFlow S.L. <contact@forgeflow.com>

  - Jasmin Solanki <jasmin.solanki@forgeflow.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.

This module is part of the `OCA/stock-logistics-workflow <https://github.com/OCA/stock-logistics-workflow/tree/19.0/stock_move_valuation_usage>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
