Stock Change Quantity Reason
This module extends the product stock management and allows to set a reason in inventory adjustments globally or per line.
It also can manage preset reasons optionally.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Lets you record a reason whenever you change a product's quantity in inventory adjustments, either by typing free text or by picking from a list of predefined reasons.
When you adjust stock quantities in Odoo, this module adds a Reason field so you can explain why the quantity changed. You can either type a free-text reason or, if the feature is enabled, choose from a list of predefined reasons.
Where it appears: - In the Inventory Adjustment screen (the editable list of stock quantities), a Reason column appears next to the quantity you set. - In the detailed move lines of stock operations, a Reason column is also shown. - Under Inventory > Configuration > Inventory Adjustment, a new menu 'Change Qty Reasons' lets stock managers create and maintain the list of predefined reasons.
Business rules and automatic behaviour: - Predefined reasons are managed in a dedicated list; each reason has a name and an optional description, and names must be unique. - A setting in Inventory settings ('Preset Change Qty Reason') turns the predefined-reason feature on or off. When off, users type a free-text reason; when on, they select from the list. - The reason you enter is automatically copied onto the stock move line and also added to the origin/reference of the stock move, so it can be traced later. - Only users with the 'Manage Stock Change Qty Preset Reasons' right can create or edit predefined reasons; regular stock users can only read them.
It touches inventory quantities (stock.quant), stock move lines (stock.move.line), and adds a new model for reasons (stock.quant.reason).
Depends on
Required by other modules
Menus it adds
Models and fields (4)
- stock.quant · extends an existing modelreason, preset_reason_id
- stock.move.line · extends an existing modelreason, preset_reason_id
- stock.quant.reason · new modelname (Reason Name), active, description (Reason Description)
- res.config.settings · extends an existing modelgroup_qty_reason_preset (Preset Change Qty Reason)
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-03Confirmation status: 6 confirmed, 3 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/stock-logistics-warehouse.
terminal Installation and usage
OCA documentation · Odoo 18.0Configuration
Source · Odoo 18.0To enable preset reason feature, you must:
- Go to: Inventory \> Settings \> Inventory Adjustment
- Enable: Preset Change Qty Reason
- Enable: Technical Settings \> Manage Stock Change Qty Preset Reasons
Once is activate you will require te add a Preset reason to validate stock products change quantity.
To allow an Stock Manager configure preset reasons easily, you should:
- Select Stock Manager user on: Settings \> Users
- Enable: Technical Settings \> Manage Stock Change Qty Preset Reasons
- Go to Inventory \> Configuration \> Inventory Adjustment \> Change Qty Reasons
No verified information in OCA: Installation, Usage.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
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.