[IMP]: add manual valuation section

Add images and manual valuation

add ref tag and retitle doc to sentence case

Remove trailing whitespaces

update explanation

closes odoo/documentation#3981

X-original-commit: 71ede7a3d4
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>

content/applications/inventory_and_mrp/inventory/management/reporting.rst

@@ -11,4 +11,3 @@ Valuation Methods
    reporting/inventory_valuation_config
    reporting/using_inventory_valuation
    reporting/integrating_landed_costs
-   /applications/finance/accounting/others/inventory/avg_price_valuation

content/applications/inventory_and_mrp/inventory/management/reporting/inventory_valuation_config.rst

@@ -1,7 +1,9 @@
 =================================
-Inventory Valuation Configuration
+Inventory valuation configuration
 =================================
 
+.. _inventory/inventory_valuation_config:
+
 All of a company's stock on-hand contributes to the valuation of its inventory. That value should
 be reflected in the company's accounting records to accurately show the value of the company and
 all of its assets.
@@ -27,32 +29,32 @@ between locations in a company's inventory.
    need to be periodically checked to ensure accuracy, and adjustments may be needed on an ongoing
    basis depending on the needs and priorities of the business.
 
-Types of Accounting
+Types of accounting
 -------------------
 
-Accounting entries will depend on the accounting mode: Continental or Anglo-Saxon.
+Accounting entries will depend on the accounting mode: *Continental* or *Anglo-Saxon*.
 
 .. tip::
-   Verify the accounting mode by activating the :ref:`developer-mode`
-   and navigating to :menuselection:`Accounting --> Configuration --> Settings`.
+   Verify the accounting mode by activating the :ref:`developer-mode` and navigating to
+   :menuselection:`Accounting --> Configuration --> Settings`.
 
-In Anglo-Saxon accounting, the costs of goods sold (COGS) are reported when products are sold or
+In *Anglo-Saxon* accounting, the costs of goods sold (COGS) are reported when products are sold or
 delivered. This means that the cost of a good is only recorded as an expense when a customer is
-invoiced for a product. Interim Stock Accounts are used for the input and output accounts, and are
-both Asset Accounts in the Balance Sheet.
+invoiced for a product. *Interim Stock Accounts* are used for the input and output accounts, and are
+both *Asset Accounts* in the balance sheet.
 
-In Continental accounting, the cost of a good is reported as soon as a product is received into
-stock. Additionally, a *single* Expense account is used for both input and output accounts in
-the Balance Sheet.
+In *Continental* accounting, the cost of a good is reported as soon as a product is received into
+stock. Additionally, a single *Expense* account is used for both input and output accounts in
+the balance sheet.
 
-Costing Methods
+Costing methods
 ---------------
 
 Below are the three costing methods that can be used in Odoo for inventory valuation.
 
 - **Standard Price**: is the default costing method in Odoo. The cost of the product is manually
   defined on the product form, and this cost is used to compute the valuation. Even if the purchase
-  price on a Purchase Order differs, the valuation will still use the cost defined on the product
+  price on a purchase order differs, the valuation will still use the cost defined on the product
   form.
 - **Average Cost (AVCO)**: calculates the valuation of a product based on the average cost of that
   product, divided by the total number of available stock on-hand. With this costing method,
@@ -81,10 +83,11 @@ valuation method should apply.
 Under the :guilabel:`Inventory Valuation` heading are two labels: :guilabel:`Costing Method` and
 :guilabel:`Inventory Valuation`. Pick the desired :guilabel:`Costing Method` using the drop-down
 menu (e.g. :guilabel:`Standard`, :guilabel:`Average Cost (AVCO)`, or :guilabel:`First In First Out
-(FIFO)` and switch the :guilabel:`Inventory Valuation` to :guilabel:`Automated`.
+(FIFO)`) and switch the :guilabel:`Inventory Valuation` to :guilabel:`Automated`.
 
 .. seealso::
-   :doc:`Using the inventory valuation <using_inventory_valuation>`
+   :doc:`Using the inventory valuation
+   </applications/inventory_and_mrp/inventory/management/reporting/using_inventory_valuation>`
 
 .. note::
    When choosing :guilabel:`Average Cost (AVCO)` as the :guilabel:`Costing Method`, the numerical

content/applications/inventory_and_mrp/inventory/management/reporting/using_inventory_valuation.rst

@@ -1,77 +1,130 @@
-=============================
-Using the inventory valuation
-=============================
+=========================
+Using inventory valuation
+=========================
 
-Inventory valuation refers to how you value your stock. It’s a very
-important aspect of a business as the inventory can be the biggest asset
-of a company.
+*Inventory valuation* is a quintessential accounting procedure that calculates the value of on-hand
+stock. Once determined, the inventory valuation amount is then incorporated into a company's overall
+value.
 
-In this documentation, we will explain how the inventory valuation works
-in Odoo.
+In Odoo, this process can be conducted manually— by warehouse employees physically counting the
+products— or automatically through the database.
 
-Inventory valuation: the basics
-===============================
+.. seealso::
+   :ref:`Inventory valuation configuration <inventory/inventory_valuation_config>`
+
+Understand the basics of inventory valuation
+============================================
+
+In order to understand how moving products in and out of stock affects the company's overall value,
+consider the following product and stock moves scenario below.
 
 Receive a product
 -----------------
 
-Each time a product enters or leaves your stock, the value of your
-inventory is impacted. The way it is impacted depends on the
-configuration of your product (more info here).
+For example, consider an physical product, a simple *table*, which is categorized as `Office
+Furniture` in the product form's :guilabel:`Product Category` field.
 
-Let’s take an example with a product - a table - configured with a
-*FIFO costing method* and an automated inventory valuation.
-
-I purchase 10 tables at a cost of $10.
-
-.. image:: using_inventory_valuation/use_inventory_valuation_01.png
-    :align: center
-
-When I’ll confirm the receipt of the products, the value of my inventory
-will be impacted. If I want to know what this impact is, I can click on
-the valuation stat button.
+Navigate to the the product category itself by going to :menuselection:`Inventory app -->
+Configuration --> Product Categories`, and on the form, set the :guilabel:`Costing Method` as `First
+In First Out (FIFO)` and the :guilabel:`Inventory Valuation` field as `Automated`.
 
 .. tip::
-         The consignment feature allows you to set owners on your stock (discover
-         more about the consignment feature). When you receive products that are
-         owned by another company, they are not taken into account in your
-         inventory valuation.
+   Alternatively access the :guilabel:`Product Categories` dashboard by clicking on the
+   :guilabel:`internal link` arrow on the individual product's form, by hovering over the
+   :guilabel:`Product Category` field.
 
-.. image:: using_inventory_valuation/use_inventory_valuation_02.png
-    :align: center
+Next, assume 10 tables are purchased at a price of $10.00, each. The :abbr:`PO (Purchase Order)` for
+those tables will show the subtotal of the purchase as $100, plus any additional costs or taxes.
 
-.. note::
-         You need access rights on the accounting module to see that button.
+.. image:: using_inventory_valuation/purchase-order.png
+   :align: center
+   :alt: Purchase order with 10 tables products valued at $10 each.
 
-In this case, I can see that the 10 tables entered the stock for a total
-value of $100.
+After selecting :guilabel:`Validate` on the :abbr:`PO (Purchase Order)`, use the
+:guilabel:`Valuation` smart button to view how the value of inventory was impacted.
 
-.. image:: using_inventory_valuation/use_inventory_valuation_03.png
-    :align: center
+.. image:: using_inventory_valuation/valuation-smart-button.png
+   :align: center
+   :alt: Valuation smart button on a receipt.
 
-I can also easily access the accounting entry that has been generated
-(in case of automated inventory valuation).
+.. important::
+   :ref:`Developer mode <developer-mode>` must be turned on to see the *Valuation* smart button.
 
-.. image:: using_inventory_valuation/use_inventory_valuation_04.png
-    :align: center
+.. tip::
+   The :doc:`consignment </applications/inventory_and_mrp/inventory/management/misc/owned_stock>`
+   feature allows ownership to items in stock. Thus, products owned by other companies are not
+   accounted for in the host company's inventory valuation.
+
+The :guilabel:`Stock Valuation` dashboard then displays valuation of all products in the shipment,
+along with their quantities and valuation. In the example of 10 tables being purchased, the
+:guilabel:`Total Value` column of the dashboard would display a calculated valuation of $100.
+
+.. image:: using_inventory_valuation/stock-valuation-product.png
+   :align: center
+   :alt: Stock valuation page depicting the products within a shipment.
+
+In Odoo, automatic inventory valuation records are also recorded in the *Accounting* app. To access
+these accounting entries, navigate to :menuselection:`Accounting --> Journal Entries`, and look for
+inventory valuation entries with the `STJ` prefix in the :guilabel:`Journal` and :guilabel:`Number`
+columns, respectively.
+
+.. image:: using_inventory_valuation/inventory-valuation-entry.png
+   :align: center
+   :alt: Accounting entry for the inventory valuation of 10 tables.
 
 Deliver a product
 -----------------
 
-In the same logic, when a table will be delivered, the stock valuation
-will be impacted and you will have access to a similar information.
+In the same logic, when a table is shipped to a customer and leaves the warehouse, the stock
+valuation decreases. The :guilabel:`Valuation` smart button on the :abbr:`DO (Delivery Order)`,
+likewise, displays the stock valuation record as it does on a :abbr:`PO (Purchase Order)`
 
-.. image:: using_inventory_valuation/use_inventory_valuation_05.png
-    :align: center
+.. image:: using_inventory_valuation/decreased-stock-valuation.png
+   :align: center
+   :alt: Decreased stock valuation after a product is shipped.
 
 The inventory valuation report
 ------------------------------
 
-The summary of this is accessible via the inventory valuation report
-(accessible from :menuselection:`Inventory --> Reporting --> Inventory Valuation`). It gives
-you, product per product, the value of your stock. By clicking on the
-button *Inventory At Date*, you can have the same information for a
-past date.
+To view the current value of all products in the warehouse, go to :menuselection:`Inventory app -->
+Reporting --> Inventory Valuation`. The records in the table are organized by product, and selecting
+a product's drop-down menu displays detailed records with the :guilabel:`Date`,
+:guilabel:`Quantity`, and :guilabel:`Total Value` of the inventory.
 
-.. image:: using_inventory_valuation/use_inventory_valuation_06.png
-    :align: center
+.. image:: using_inventory_valuation/inventory-valuation-products.png
+   :align: center
+   :alt: Inventory valuation report showing multiple products.
+
+.. note::
+   The :guilabel:`Inventory At Date` button, located in the top-left corner of the :guilabel:`Stock
+   Valuation` dashboard, shows the inventory valuation of products available during a prior
+   specified date.
+
+Update product unit price
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For any company: lead times, supply chain failures, and other risk factors can contribute to
+invisible costs. Although Odoo attempts to accurately represent the stock value, *manual valuation*
+serves as an additional tool to update the unit price of products.
+
+.. important::
+   Manual valuation is intended for products that can be purchased and received for a cost greater
+   than 0, or have product categories set with :guilabel:`Costing Method` set as either `Average
+   Cost (AVCO)` or `First In First Out (FIFO)`.
+
+.. image:: using_inventory_valuation/add-manual-valuation.png
+   :align: center
+   :alt: Add manual valuation of stock value to a product.
+
+Create manual valuation entries on the :guilabel:`Stock Valuation` dashboard by first navigating to
+:menuselection:`Inventory app --> Reporting --> Inventory Valuation`, and then click the little gray
+drop-down icon to the left of a product's name, to then reveal stock valuation line items below as
+well as a teal :guilabel:`+ (plus)` button on the right.
+
+Click the teal :guilabel:`+ (plus)` button to open up the :guilabel:`Product Revaluation` form,
+where updates to the calculation of inventory valuation can be made, by increasing or decreasing the
+unit price of each product.
+
+.. image:: using_inventory_valuation/product-revaluation.png
+   :align: center
+   :alt: Product revaluation form adding a value of $1.00 with the reason being inflation.