OdooWiki OCA HUB

Partner VAT Unique

partner_vat_unique folder_open OCA/partner-contact open_in_new
Customer Relationship Management License: AGPL-3

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.0

Adds 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

base_setup
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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation 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.0

Will 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.

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.