OdooWiki OCA HUB

Package multi reference

stock_quant_package_multi_reference folder_open OCA/stock-logistics-tracking open_in_new
Inventory/Inventory License: AGPL-3

This module allows to define multiple references for a single package.

auto_awesome What this module does

AI-generated from the code · Odoo 16.0

Lets you store several reference numbers or barcodes on a single package instead of just one. The package's main reference stays in sync with the first entry in the list.

On the package form you get a new editable list called References, where you can add as many reference values as you need and reorder them with a drag handle. The package's own Package Reference field is now read-only on the form and always shows the first reference in that list, so the rest of Odoo keeps working with a single main reference.

  • Adding, changing or removing the first reference updates the package reference automatically, and typing a package reference creates the matching first entry in the list.
  • Searching packages by reference also looks inside the whole reference list, so a package can be found by any of its references, not only the main one.
  • A reference value cannot be used twice: if you try to save a reference that already exists on another package, Odoo blocks it with an error showing the existing package and company.
  • When the module is installed, existing packages are given a first reference entry built from their current name.

It works on the package model stock.quant.package and adds a new reference model stock.quant.package.reference, with access for all internal users. The change appears on the standard package form in Inventory.

Depends on

stock
Models and fields (2)
  • stock.quant.package · extends an existing modelname (Package Reference), reference_ids (References)
  • stock.quant.package.reference · new modelname (Reference), sequence, stock_quant_package_id (Package)

Text generated by AI (DeepSeek) from reading the Odoo 16.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 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/stock-logistics-tracking.

terminal Installation and usage

OCA documentation · Odoo 16.0

A list of references is available for each package with a priority, so the package reference is used as the main reference.

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.