OdooWiki OCA HUB

Purchase - Order Qty By Product Category

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

This module is used to display product quantities involved in a PO grouped by product category.

auto_awesome What this module does

AI-generated from the code · Odoo 15.0

Adds a new tab on purchase orders that shows ordered, received and pending quantities grouped by product category, optionally split by unit of measure. Two settings let you control this grouping behaviour.

This module adds a new "Qty by Product Category" tab to the purchase order form. There you see a table with one line per product category, showing the quantity ordered, the quantity received and the quantity still to receive, plus the unit of measure when the Units of Measure feature is enabled.

Two toggles on that tab control how quantities are grouped: - "Split by UoM": when on, quantities are grouped by category and by unit of measure instead of category alone. - "Use Reference UoM": only available when the previous toggle is on; when active, all quantities are converted to the reference unit of measure of each category before being summed.

Defaults for these toggles can be set company-wide in Purchase settings ("Split Quantity Category By UoM" and "Split Quantity Category By Reference UoM"). The module also reads system parameters to decide the default values.

The grouping records are created and updated automatically as order lines change, and are removed when no longer needed. A check prevents two identical groups (same order, category and unit of measure) from existing. The module touches purchase.order, purchase.order.line, res.company and res.config.settings.

Depends on

purchase
Models and fields (5)
  • res.company · extends an existing modelpo_category_qty_split_by_uom, po_category_qty_split_by_uom_reference
  • purchase.order · extends an existing modelcategory_qty_split_by_uom, qty_by_product_category_ids (Order Qty By Category), category_qty_split_by_uom_reference
  • purchase.order.line · extends an existing modelqty_by_product_category_id (Order Line Qty By Category)
  • res.config.settings · extends an existing modelpo_category_qty_split_by_uom, po_category_qty_split_by_uom_reference
  • purchase.order.qty.by.product.category · new modelqty_uom_id, category_id, qty_ordered, qty_received, qty_to_receive, purchase_line_ids, purchase_order_id

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

Sources · Odoo 15.0

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

terminal Installation and usage

OCA documentation · Odoo 15.0

Once the module is installed, you can configure whether quantities should be split by UoM by default. To do so, you can:

  • configure an ir.config_parameter record, with key "purchase_ordered_qty_by_product_category.split_by_uom" and value "1"
  • go to the Purchase settings and flag the "Split Quantity Category By UoM" checkbox

You can also configure whether reference UoM should be used for grouping. To do so, you can:

  • configure an ir.config_parameter record, with key "purchase_ordered_qty_by_product_category.split_by_uom_reference" and value "1"
  • go to the Purchase settings and flag the "Split Quantity Category By Reference UoM" checkbox

NB: splitting by reference UoM is available only if splitting by UoM is activated first.

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.