OdooWiki OCA HUB

Purchase Order Supplier Return

purchase_order_supplier_return folder_open OCA/purchase-workflow open_in_new
Purchase License: AGPL-3

Allow to return products to supplier. On purchase orders validated and shipped with negative product quantity, received quantity is updated. The product type must be of type storable.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

When you return products to a supplier on a purchase order that has a negative quantity, this module automatically marks the stock move as a refund so the received quantity is updated correctly.

This module works in the background on purchase orders that involve storable products. It does not add any new menu, screen or button; instead it changes how Odoo handles the validation of stock moves linked to purchase order lines.

When a stock move is completed (for example when you validate a receipt or a return), the module checks the related purchase order line. If that line has a negative ordered quantity and its received quantity is calculated from stock moves, the move is automatically flagged as a refund.

  • The check only applies to purchase order lines that are linked to the move.
  • The move must be in the done state.
  • The purchase line must use the stock moves method to compute the received quantity.
  • The ordered quantity on the purchase line must be negative.

As a result, the received quantity on the purchase order is updated to reflect the return, keeping the purchase order figures consistent with the actual stock movements. This is useful when you use negative quantities on a purchase order to represent a supplier return and want Odoo to treat the resulting stock move as a refund rather than a normal receipt.

Depends on

purchase_stock
Models and fields (1)
  • stock.move · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 2 confirmed, 7 with no information of 9 versions.

Sources · Odoo 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/purchase-workflow.

terminal Installation and usage

OCA documentation · Odoo 18.0

Create a purchase order with a negative quantity, confirm it and validate the related stock picking. Quantity received will be updated.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.