Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
109 changes: 109 additions & 0 deletions sale_partner_display_ref/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,109 @@
.. image:: https://odoo-community.org/readme-banner-image
:target: https://odoo-community.org/get-involved?utm_source=readme
:alt: Odoo Community Association

==============================
Sale Partner Display Reference
==============================

..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:3f6d47315481b2141d5d8ac0d49379f06f318461cef0c8fbea60a42912acf580
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fsale--workflow-lightgray.png?logo=github
:target: https://github.com/OCA/sale-workflow/tree/19.0/sale_partner_display_ref
:alt: OCA/sale-workflow
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/sale-workflow-19-0/sale-workflow-19-0-sale_partner_display_ref
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/sale-workflow&target_branch=19.0
:alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module prefixes the customer reference (``res.partner.ref``) to the
partner's ``display_name`` whenever it is rendered inside a Sales view —
shown as ``[C00123] Acme Corp`` in the customer field of a sales
quotation or order, both in the dropdown and on the selected value.

The decoration mechanism lives in the generic ``partner_display_ref``
module; this module only injects the ``partner_display_ref_field``
context key (set to ``ref``) into the Sales views. Contacts, CRM,
Invoicing and any other module that reads ``display_name`` continues to
see the plain partner name.

**Table of contents**

.. contents::
:local:

Usage
=====

Set a value on the **Reference** field of any contact
(``res.partner.ref``).

Open the **Sales** app, create or edit a quotation and open the
**Customer** dropdown — matching partners appear with the reference
prefix:

::

[C00123] Acme Corp

The prefix stays on the selected value too, so the reference remains
visible on the saved order. Views outside Sales keep the plain partner
name.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/sale-workflow/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/sale-workflow/issues/new?body=module:%20sale_partner_display_ref%0Aversion:%2019.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* ForgeFlow

Contributors
------------

- `ForgeFlow <https://www.forgeflow.com>`__

- Jasmin Solanki <jasmin.solanki@forgeflow.com>

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

This module is part of the `OCA/sale-workflow <https://github.com/OCA/sale-workflow/tree/19.0/sale_partner_display_ref>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
2 changes: 2 additions & 0 deletions sale_partner_display_ref/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# Copyright 2026 ForgeFlow S.L.
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
17 changes: 17 additions & 0 deletions sale_partner_display_ref/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Copyright 2026 ForgeFlow S.L.
# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).

{
"name": "Sale Partner Display Reference",
"summary": "Wire the partner reference prefix into Sales views.",
"version": "19.0.1.0.0",
"category": "Sales/Sales",
"author": "ForgeFlow, Odoo Community Association (OCA)",
"website": "https://github.com/OCA/sale-workflow",
"license": "AGPL-3",
"depends": ["partner_display_ref", "sale"],
"data": [
"views/sale_order_views.xml",
],
"installable": True,
}
3 changes: 3 additions & 0 deletions sale_partner_display_ref/pyproject.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[build-system]
requires = ["whool"]
build-backend = "whool.buildapi"
2 changes: 2 additions & 0 deletions sale_partner_display_ref/readme/CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
- [ForgeFlow](https://www.forgeflow.com)
- Jasmin Solanki \<<jasmin.solanki@forgeflow.com>\>
9 changes: 9 additions & 0 deletions sale_partner_display_ref/readme/DESCRIPTION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
This module prefixes the customer reference (`res.partner.ref`) to the
partner's `display_name` whenever it is rendered inside a Sales view —
shown as `[C00123] Acme Corp` in the customer field of a sales quotation or
order, both in the dropdown and on the selected value.

The decoration mechanism lives in the generic `partner_display_ref` module;
this module only injects the `partner_display_ref_field` context key (set to
`ref`) into the Sales views. Contacts, CRM, Invoicing and any other module that reads
`display_name` continues to see the plain partner name.
9 changes: 9 additions & 0 deletions sale_partner_display_ref/readme/USAGE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
Set a value on the **Reference** field of any contact (`res.partner.ref`).

Open the **Sales** app, create or edit a quotation and open the **Customer**
dropdown — matching partners appear with the reference prefix:

[C00123] Acme Corp

The prefix stays on the selected value too, so the reference remains visible
on the saved order. Views outside Sales keep the plain partner name.
Loading
Loading