OdooWiki OCA HUB

Stock Picking Return Restricted Qty

stock_picking_return_restricted_qty folder_open OCA/stock-logistics-workflow open_in_new
Uncategorised License: AGPL-3

This module doesn't allow you to return more quantity of products than the delivered.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds an option on operation types to stop users from returning more product quantity than was actually delivered. When enabled, return wizards automatically cap the returnable quantity and block any attempt to exceed it.

This module adds a new checkbox called "Restrict Return Quantity" on the configuration form of operation types (the screen where you set up incoming, outgoing and internal operations). The checkbox appears right after the return operation type field.

When the option is enabled for the operation type used by a transfer, the return process behaves differently:

  • The return wizard automatically fills in the returnable quantity based on how much of the original move has not already been returned, so users see the maximum they can send back.
  • If a user tries to type a larger quantity, Odoo immediately shows an error saying that returning more quantities than delivered is not allowed.
  • The same check runs again when the return is confirmed, so the restriction cannot be bypassed.

The calculation looks at the original move quantity and subtracts quantities already returned through related moves that are partially available, assigned or done, never going below zero.

It touches the stock operation type configuration, the return picking wizard and its lines. No new menus or reports are added; the change is visible inside existing stock screens and the return wizard.

Depends on

stock

Required by other modules

Models and fields (3)
  • stock.picking.type · extends an existing modelrestrict_return_qty (Restrict Return Quantity)
  • stock.return.picking · extends an existing model
  • stock.return.picking.line · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 19.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: 7 confirmed, 2 with no information of 9 versions.

Sources · Odoo 19.0

Confirmed on 2026-11-03 in branch 19.0 of OCA/stock-logistics-workflow.

terminal Installation and usage

OCA documentation · Odoo 19.0

To manage analytic account tags using this module, you need to:

  • Navigate to Inventory \> Configuration \> Operations Types.
  • Select the Operation Type for which you want to enable the restriction.
  • Check the box "Restrict Return Quantity" and save.

To use this module, you need to:

  • Create an outgoing or an internal picking.
  • Include one or more products with enough stock.
  • Validate the picking.
  • Try to return more products than the delivered and see the warning message.

No verified information in OCA: Installation.

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.