Module to make the VAT number unique for customers and suppliers. Will not consider empty VATs as duplicated.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Adds an optional setting that prevents two contacts or companies from sharing the same VAT number. When enabled, Odoo blocks saving a duplicate VAT with an error message.
This module adds a new option in Odoo's Settings that lets you decide whether VAT numbers must be unique across contacts. You will find the checkbox labelled "Unique VAT Constraint" in the Contacts settings section of the general Settings screen.
When the option is switched on, Odoo checks every contact you save. If you try to save a contact whose VAT number is already used by another contact, Odoo stops you and shows an error saying that the VAT already exists in another partner.
- The check only applies to contacts that have a VAT number filled in; contacts without a VAT are never considered duplicates.
- Contacts that are children of another company (for example, a person linked to a parent company) are skipped, so the rule applies to the main contact records.
- The VAT field is no longer copied when you duplicate a contact, which helps avoid accidental duplicates.
The setting is stored as a system parameter, so it applies to the whole database once enabled. The module extends the res.partner model and the res.config.settings model, and adds a setting block to the existing configuration form.
Depends on
Models and fields (2)
- res.partner · extends an existing modelvat
- res.config.settings · extends an existing modelpartner_vat_unique (Unique VAT Constraint)
Text generated by AI (DeepSeek) from reading the Odoo 19.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-03Confirmation status: 8 confirmed, 1 with no information of 9 versions.
Sources · Odoo 19.0
Confirmed on 2026-11-03 in branch 19.0 of OCA/partner-contact.
terminal Installation and usage
OCA documentation · Odoo 19.0Installation
Source · Odoo 19.0Will not check previous VAT duplicates, so it is recomended make sure there isn't any duplicated VAT before installation.
No verified information in OCA: Configuration, Usage.
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.
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.