diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 6feb9c740..31cc274ae 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -1,3 +1,11 @@ +# All changes to technical files (build environment and Sphinx extensions) have to be approved +/extensions/ @odoo/doc-review +.gitignore @odoo/doc-review +commit_template.txt @odoo/doc-review +conf.py @odoo/doc-review +Makefile @odoo/doc-review +requirements.txt @odoo/doc-review + # All changes to legal material have to be approved -/legal/ @odoo/legal -/legal.rst @odoo/legal +/content/legal/ @odoo/legal +/content/legal.rst @odoo/legal diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse.rst b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse.rst index b64f92494..a380f53cc 100644 --- a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse.rst +++ b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse.rst @@ -1,131 +1,129 @@ -===================================== -How to do inter-warehouses transfers? -===================================== +========================= +Inter-warehouse transfers +========================= -If you own different warehouses you might want to transfer goods from -one warehouse to the other. This is very easy thanks to the inventory -application in Odoo. +When owning several warehouses, you might need to transfer goods from one warehouse to another. +Proceeding to such behavior is called *inter-warehouse transfers*. If this action is physically +easy to perform, the administrative part can be arduous. Fortunately, Odoo comes with an intuitive +flow that helps save time when registering those transfers. Configuration ============= -First of all you have to select the multi locations option. Go to -:menuselection:`Configuration --> Settings` in the **Inventory application**. -Then tick the **Manage several locations per -warehouse** option. Please don't forget to **apply** your changes. +First of all, go to :menuselection:`Configuration --> Settings` and enable **Storage Locations**. +Then, hit save. -.. image:: media/inter01.png +.. image:: inter_warehouse/feature-storage-location.png :align: center + :alt: Enabling the storage location feature in Odoo Inventory. -.. tip:: - This option should also be ticked if you wish to manage different - locations and routes in your warehouse. +.. important:: + If you want to manage several routes within your warehouses, then enable **Multi-Step Routes** + and check :doc:`use-routes`. Creating a new warehouse ======================== -The next step is to create your new warehouse. In the Inventory application -click on :menuselection:`Configuration --> Warehouse Management --> -Warehouses`. You are now able to create your warehouse by clicking on -**Create**. +The next step is to create your new warehouse. To do so, go to :menuselection:`Configuration --> +Warehouse Management --> Warehouses` and click on **Create**. -Fill in a **Warehouse Name** and a **Short Name**. The short name is 5 -characters maximum. +Fill out a **Warehouse Name** and a **Short Name**. The short name is five characters maximum. -.. image:: media/inter02.png +.. image:: inter_warehouse/create-new-warehouse.png :align: center + :alt: Short name field of a warehouse on Odoo Inventory. -.. tip:: - Please note that the **Short Name** is very important as it will - appear on your transfer orders and other warehouse documents. It might - be smart to use an understandable one (e.g.: WH/[first letters of - location]). +.. important:: + The **Short Name** appears on your transfer orders and other warehouse documents. We recommend + using an understandable one (e.g.: WH/[first letters of location]). -If you go back to your dashboard, new operations will automatically have -been generated for your new warehouse. +Now, go back to your dashboard. There, new operations related to your warehouse have been +automatically generated. -.. image:: media/inter03.png +.. image:: inter_warehouse/new-transfer-types.png :align: center + :alt: Inventory app dashboard displaying new transfer type for the recently created warehouse. Creating a new inventory ======================== -If you create a new warehouse you might already have an existing -physical inventory in it. In that case you should create an inventory in -Odoo, if not you can skip this step. +If you create a new warehouse, you might already have an existing inventory in it. In that case, you +should create an inventory in Odoo. If this is not the case, you can skip this step. -Go into the inventory application, select :menuselection:`Inventory Control --> -Inventory Adjustment`. You can then create a new inventory by clicking on -**Create**. Fill in the **Inventory Reference**, **Date** -and be sure to select the right warehouse and location. +Into the inventory application, select :menuselection:`Operations --> Inventory Adjustment`. +Then, create a new inventory by clicking on **Create**. Fill in the **Inventory Reference**, +**Date** and make sure to select the right warehouse and location. -.. image:: media/inter04.png +.. image:: inter_warehouse/annual-inventory.png :align: center + :alt: View of the inventory adjustment form before hitting the start button. -Next, click on **Start Inventory**. A new window will open where you will -be able to input your existing products. Select add an item and indicate -the **Real Quantity** available in the warehouse. The theoretical quantity -can not be changed as it represents a computed quantity from purchase -and sales orders. +Next, click on **Start Inventory**. You will be able to input your existing products in the new +window. Select add an item and indicate the **Real Quantity** available in the warehouse. +The theoretical quantity can not be changed as it represents a computed one from purchase and sales +orders. -.. image:: media/inter05.png +.. image:: inter_warehouse/in-progress-annual-inventory.png :align: center + :alt: View of the actual physical inventory of the new warehouse. -Don't forget to validate your inventory once you have recorder the state of -all yours product. +.. tip:: + Don't forget to validate your inventory once you have recorded the state of all your products. Create an internal transfer =========================== -The final step is to create your internal transfer. If you want to -tranfer 2 units of a product from your first warehouse to another one in -Brussels, proceed as follows: +The final step is to create your internal transfer. If you want to transfer eight units of a product +from your first warehouse to another one, proceed as follows: -From your dashboard, select a internal movement of one of the two -warehouses. To do so, click on :menuselection:`More --> Transfer`. +From your dashboard, select an internal movement of one of the two warehouses. To do so, click on +:menuselection:`Manage --> Planned Transfer`. -.. image:: media/inter06.png +.. image:: inter_warehouse/internal-transfer-choice.png :align: center + :alt: View of the choice between planned transfer and immediate transfer. -A new window will open where you will be able to select the source -location zone (in this case our "old warehouse") and the destination -location zone (in this case our "new" warehouse located in Brussels). +On the new window, select the source location zone (in this case, your "old" warehouse) and the +destination location zone (in this case, your "new" warehouse). -Add the products you want to transfer by clicking on **Add an Item** and -don't forget to **Validate** or **Mark as TODO** once you are done. +Add the products you want to transfer by clicking on **Add an Item**, then click on **Save** and +**Mark as TODO** once you are done. -.. image:: media/inter07.png +.. image:: inter_warehouse/planned-internal-transfer.png :align: center + :alt: View of the internal transfer form. -If you select **Validate**, Odoo will process all quantities to transfer. +If you selected **Immediate Transfer**, Odoo processes the transfer automatically after you clicked +on **Validate**. -If you select **Mark as TODO**, Odoo will put the transfer in **Waiting -Availability** status. Click on **Reserve** to reserve the amount of -products in your source warehouse. +If you select **Mark as TODO**, Odoo puts the transfer in **Waiting Availability** status. +Click on **Reserve** to reserve the number of products in your source warehouse. It is also possible to manually transfer each product: -1. Via your dashboard, select the transfer order in the source location. +- Via your dashboard, select the transfer order in the source location. - .. image:: media/inter08.png - :align: center - -2. Select the right transfer order - - .. image:: media/inter09.png - :align: center - -3. Click on the little pencil logo in the lower right -corner in order to open the operation details window. In this new -window you can manually indicate how much products you process - -.. image:: media/inter10.png +.. image:: inter_warehouse/in-progress-internal-transfer.png :align: center + :alt: View of the dashboard with a zoom of the pending internal transfer. -.. tip:: - If you decide to partially process the transfer order (e.g. a part of the - products can't be shipped yet due to an unexpected event), Odoo will - automatically ask if you wish to create a **backorder**. - Create a backorder if you expect to process the remaining products - later, do not create a backorder if you will not supply/receive the - remaining products. +- Select the right transfer order. + +.. image:: inter_warehouse/internal-transfers-list.png + :align: center + :alt: View of the pending internal transfers list. + +- Click on the little pencil logo in the lower right corner to open the operation details window. + In this new window you can manually indicate how many products you process. + +.. image:: inter_warehouse/backorder.png + :align: center + :alt: View of a backorder pop-up window because all products are not moved at the same time. + +.. note:: + If you decide to process the transfer order partially (e.g., a part of the products can't be + shipped yet due to an unexpected event), Odoo automatically asks if you wish to create a + **backorder**. + + - Create a backorder if you expect to process the remaining products later. + - Do not create a backorder if you will not supply/receive the remaining products. \ No newline at end of file diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/annual-inventory.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/annual-inventory.png new file mode 100644 index 000000000..07dd171b6 Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/annual-inventory.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/backorder.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/backorder.png new file mode 100644 index 000000000..20413ca1d Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/backorder.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/create-new-warehouse.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/create-new-warehouse.png new file mode 100644 index 000000000..698fe11fa Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/create-new-warehouse.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/feature-storage-location.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/feature-storage-location.png new file mode 100644 index 000000000..525462d3a Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/feature-storage-location.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/in-progress-annual-inventory.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/in-progress-annual-inventory.png new file mode 100644 index 000000000..9c94e6842 Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/in-progress-annual-inventory.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/in-progress-internal-transfer.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/in-progress-internal-transfer.png new file mode 100644 index 000000000..cace7bc6b Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/in-progress-internal-transfer.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/internal-transfer-choice.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/internal-transfer-choice.png new file mode 100644 index 000000000..392aa4192 Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/internal-transfer-choice.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/internal-transfers-list.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/internal-transfers-list.png new file mode 100644 index 000000000..ca1e02a4b Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/internal-transfers-list.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/new-transfer-types.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/new-transfer-types.png new file mode 100644 index 000000000..4fd064dea Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/new-transfer-types.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/planned-internal-transfer.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/planned-internal-transfer.png new file mode 100644 index 000000000..831a386f3 Binary files /dev/null and b/content/applications/inventory_and_mrp/inventory/routes/concepts/inter_warehouse/planned-internal-transfer.png differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter01.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter01.png deleted file mode 100644 index db15576b9..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter01.png and /dev/null differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter02.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter02.png deleted file mode 100644 index 8a2881f6a..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter02.png and /dev/null differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter03.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter03.png deleted file mode 100644 index 56f1a30e6..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter03.png and /dev/null differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter04.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter04.png deleted file mode 100644 index c3db7fed2..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter04.png and /dev/null differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter05.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter05.png deleted file mode 100644 index fcaa88b2f..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter05.png and /dev/null differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter06.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter06.png deleted file mode 100644 index 3e9ed90cc..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter06.png and /dev/null differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter07.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter07.png deleted file mode 100644 index 8e0582d5c..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter07.png and /dev/null differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter08.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter08.png deleted file mode 100644 index 6765cc6af..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter08.png and /dev/null differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter09.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter09.png deleted file mode 100644 index 07cd5abe0..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter09.png and /dev/null differ diff --git a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter10.png b/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter10.png deleted file mode 100644 index 81da19753..000000000 Binary files a/content/applications/inventory_and_mrp/inventory/routes/concepts/media/inter10.png and /dev/null differ