OdooWiki OCA HUB

Deduplicate Contacts by reference

partner_deduplicate_by_ref folder_open OCA/partner-contact open_in_new
Tools License: AGPL-3

This module extends the criteria to match duplicated contacts using the field reference.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds a "Reference" option to the Odoo contact de-duplication wizard, so contacts can be grouped and merged based on their reference number instead of only name, email or VAT.

This module extends the standard "Deduplicate Contacts" tool in Odoo. When you open the automatic merge wizard, you now see an extra checkbox called "Reference" next to the existing grouping options.

  • Tick "Reference" to group contacts that share the same reference value, so they can be reviewed and merged together.
  • Contacts without a reference are ignored by this criterion: the module automatically excludes them from the duplicate groups it builds.
  • The list of contacts shown in the wizard also displays a "Reference" column, so you can see the value being used for the match.

The module only changes the de-duplication wizard screen and the way its duplicate search is built. It does not add new menus, reports, emails or scheduled actions, and it does not modify the contact form itself. It relies on the access-rights module partner_deduplicate_acl that it depends on.

Depends on

partner_deduplicate_acl
Models and fields (1)
  • base.partner.merge.automatic.wizard · extends an existing modelgroup_by_ref (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: 6 confirmed, 3 with no information of 9 versions.

Sources · Odoo 18.0

Confirmed on 2026-11-03 in branch 18.0 of OCA/partner-contact.

terminal Installation and usage

OCA documentation · Odoo 18.0

Usage

Source · Odoo 18.0

To use this module, you need to:

  • Go to Contacts \> Tools \> Deduplicate Contacts.
  • Mark "Reference" in the section "Search duplicates based on duplicated data in".
  • This criteria will be used for deduplicating.

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.