Skip to content

[ADD] Inventory: reception report documentation#18928

Open
stepperpig wants to merge 1 commit into
17.0from
17.0-inventory-reception-report-kaili
Open

[ADD] Inventory: reception report documentation#18928
stepperpig wants to merge 1 commit into
17.0from
17.0-inventory-reception-report-kaili

Conversation

@stepperpig

Copy link
Copy Markdown
Contributor

Description

This PR adds a new doc page for the Inventory Reception Report feature to allocate incoming stock from purchase orders (POs) to sales orders (SOs). While an Allocation report doc exists for MRP, reception report documentation for Inventory did not previously exist.

Original feature task card
Doc task

Changes

  • New reception_report.rst page under Inventory > Warehouses & Storage > Inventory Management.
  • Screenshots added.

Version Scope

This 17.0 PR can be FWP up to master. Additional changes for 18.0 and 19.0 will be opened in separate PRs.

@stepperpig stepperpig requested a review from jero-odoo July 14, 2026 22:52
@stepperpig stepperpig self-assigned this Jul 14, 2026
@stepperpig stepperpig added the 5 label Jul 14, 2026
@robodoo

robodoo commented Jul 14, 2026

Copy link
Copy Markdown
Collaborator

Pull request status dashboard

@C3POdoo C3POdoo requested a review from a team July 14, 2026 22:54
@stepperpig

Copy link
Copy Markdown
Contributor Author

Hi @jero-odoo, got a PR ready for your review when you get a chance - thank you!

@jero-odoo jero-odoo left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good @stepperpig ! Just a few notes, let me know if you have any questions.

========

Reception reports are used to manage the allocation of replenished stock. This means that users must
first confirm demand from customers, then replenish the necessary stock through a |PO|. Only after

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
first confirm demand from customers, then replenish the necessary stock through a |PO|. Only after
first confirm customer demand, then replenish the necessary stock through a |PO|. Only after

optional


The user then creates a new |RfQ| to replenish the demanded stock by navigating to the *Purchase*
app and clicking :guilabel:`New`. On the form, add the products in demand on the customers' |SOs| by
clicking :guilabel:`Add a product` in the *Products* tab and specify the required

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
clicking :guilabel:`Add a product` in the *Products* tab and specify the required
clicking :guilabel:`Add a product` in the *Products* tab and specifying the required

:guilabel:`Quantity`.

.. important::
In order for Odoo to properly create allocations, ensure that the selected product has the

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
In order for Odoo to properly create allocations, ensure that the selected product has the
To ensure Odoo can properly create allocations, confirm the selected product that the selected product has the

Reception Report
----------------

After confirming the |PO|, open the reception report to allocate units of the products to desired

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
After confirming the |PO|, open the reception report to allocate units of the products to desired
After confirming the |PO|, open the reception report to allocate the products' units to the desired

Comment on lines +95 to +96
a list of its products, including each product's name, quantity, and the option to individually
assign the specified units.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
a list of its products, including each product's name, quantity, and the option to individually
assign the specified units.
a list of its products, including each product's name, quantity, and the option to assign the specified units individually

Allocate units
~~~~~~~~~~~~~~

To allocate units for a product in a |SO|, click :guilabel:`Assign` in the product's corresponding

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To allocate units for a product in a |SO|, click :guilabel:`Assign` in the product's corresponding
To allocate units for a product in an |SO|, click :guilabel:`Assign` in the product's corresponding

Normally, I would say "in a sales order" but since you are abbreviating "in an SO" works better

All` in the corresponding row of the |SO|. To assign all available units across all |SOs|, click
:guilabel:`Assign All` at the top.

The quantity of reservable units for each product is automatically calculated in order starting from

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The quantity of reservable units for each product is automatically calculated in order starting from
The quantity of reservable units for each product is automatically calculated, in order starting from

Comment on lines +165 to +167
from Vendor A. This vendor can only provide 100 units of the *Chair*, available this week. So,
the user creates and confirms another |PO| to replenish the remaining 50 units needed from Vendor
B, available next week.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
from Vendor A. This vendor can only provide 100 units of the *Chair*, available this week. So,
the user creates and confirms another |PO| to replenish the remaining 50 units needed from Vendor
B, available next week.
from Vendor A. This vendor can only provide 100 units of the *Chair* this week. So, the user creates and confirms another |PO| to replenish the remaining 50 units from Vendor B, which will be available next week.

Comment on lines +174 to +175
Because the user wants to prioritize Customer B's order, they want to make sure Customer B
receives 75 units from Vendor A, who can guarantee a faster delivery. To do so, they first open

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Because the user wants to prioritize Customer B's order, they want to make sure Customer B
receives 75 units from Vendor A, who can guarantee a faster delivery. To do so, they first open
Because the user wants to prioritize Customer B’s order, they want to ensure Customer B receives 75 units from Vendor A, which can guarantee faster delivery. To do so, they first open

Comment on lines +41 to +46
#. :ref:`Confirm SOs <reception-report/workflow/confirm-so>` for one or more customers.
#. Create and :ref:`confirm a PO <reception-report/workflow/confirm-po>` for the demanded products.
#. Open receipt and :ref:`access the reception report <reception-report/workflow/reception-report>`
to allocate products.
#. :ref:`Validate receipt <reception-report/workflow/validate-receipt>` on the |PO|.
#. :ref:`Validate delivery <reception-report/workflow/validate-delivery>` on the |SO|.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not a huge fan of laying things out like this, I think because while the list does include links to the other sections, it doesn't really include any information, so it feels a bit redundant.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants