OdooWiki OCA HUB

Partner Data VIES Populator

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

This module allows you to create the partners (companies) based on their VAT number. Name and address of the partner will automatically be completed via VIES Webservice.

VIES Service (based on stdnum python)

Unfortunately, VIES doesn't return a structured address but just a multi-line string with aggregate street, zip and city.

So, when the data is retrieved, it will try to populate the City and Zip fields from the last line of the address. The Street field will contain the remaining information.

auto_awesome What this module does

AI-generated from the code · Odoo 17.0

When you type a European VAT number on a company partner, this module automatically fills in the company name, street, city, zip and country using the official VIES webservice.

This module adds an automatic lookup on company partners in Odoo. When a user enters or changes the VAT number of a partner marked as a company, Odoo queries the European VIES service and, if the number is valid, completes the partner's details for the user.

What it fills in automatically: - The VAT number itself, stored in the standardised form. - The company name, written in capital letters. - The country, matched from the country code returned by VIES. - The address: because VIES returns the address as one block of text, the module tries to split the last line into zip code and city, and puts the rest into the street field.

Business rules and behaviour: - The lookup only runs for partners that are companies and have a VAT number. - It only runs when the VAT number belongs to a country in Odoo's Europe country group; other VAT numbers are ignored. - If VIES cannot be reached or returns an error, nothing is changed on the partner, and a warning is written in the log. A technical error message can be raised when the lookup is called with that option. - If VIES says the number is not valid or has no name, no data is written.

It works on the res.partner model and depends on the standard VAT validation module.

Depends on

base_vat
Models and fields (1)
  • res.partner · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 17.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: 4 confirmed, 5 with no information of 9 versions.

Sources · Odoo 17.0

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

terminal Installation and usage

OCA documentation · Odoo 17.0

This module requires the python-stdnum library. As Odoo itself depends on this library, so it should already be installed on your system.

When changing a company partner VAT number, this module will try to fetch the partner data from VIES webservice.

If found on VIES, it will update the name, address, zip, city and country.

No verified information in OCA: 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.