OdooWiki OCA HUB

Sale Order Customer Free Reference

sale_order_customer_free_ref folder_open OCA/edi open_in_new
Sale License: AGPL-3

The goal of this module is to improve on the client_order_ref on sale.order.

By default, Odoo only has one field to handle the customer reference of a sales order.

However, an order provided by the buyer can contain an id (PO number) and a free reference. When exchanging with the other parties, you sometimes need to differentiate them. For instance, this is required by some EDI flows.

To help with this, this module adds two specific fields for them and transforms the client_order_ref standard field into a computed one.

The two new fields are also passed on to generated invoices.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Splits the single Customer Reference on sales orders into two fields: a customer order number (PO id) and a free reference. The original reference is filled automatically from the two, and both are carried over to invoices.

This module gives sales users two separate places to record what a customer sends with an order: an order number (for example a purchase order id) and a free reference. Both fields appear on the sales order form, right after the existing Customer Reference field.

The original Customer Reference field is no longer typed by hand: it is now read-only and is built automatically by joining the order number and the free reference with a hyphen. If someone fills the combined reference instead, the module splits it back into the two fields.

When an invoice is created from a sales order, both values are copied onto the invoice, so the customer's order number and free reference stay visible on the accounting document. The two fields are also added to the invoice form, next to the existing reference field.

  • New fields on sales orders and invoices: customer order number and customer free reference.
  • The standard Customer Reference becomes computed and read-only on sales orders.
  • Values are copied to the generated invoice through the normal invoice preparation.
  • Fields are not duplicated when a record is copied.

The module touches sale.order and account.move and only changes the sale order and invoice forms; no new menus or reports are added.

Depends on

sale

Required by other modules

ebill_paynet_customer_free_refebill_postfinance_customer_free_refsale_order_import_ubl_customer_free_ref
Models and fields (2)
  • sale.order · extends an existing modelclient_order_ref (Customer Reference), customer_order_number, customer_order_free_ref (Customer Free Reference)
  • account.move · extends an existing modelcustomer_order_number, customer_order_free_ref (Customer Free Reference)

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: 3 confirmed, 6 with no information of 9 versions.

terminal Installation and usage

No verified information

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.

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.