This modules updates partner fields via the SIRENE database \. It uses the dataset economicref-france-sirene-v3 of opendatasoft \.
It computes a theorical VAT number from the SIREN and then checks the validity of the VAT number (depending on configuration) on VIES (if invalid, the VAT number is discarded).
The module supports 2 scenarios:
- update of an existing partner via the menu Action \> SIREN Lookup,
- creation of a new partner: start by setting the VAT number field, the SIREN field or SIRET field and Odoo will set the other fields. For usability purposes, it also work when you write the VAT number, SIREN or SIRET in the company name field.
In the 2 scenarios, it will update the following fields:
- Company Name
- Street
- Postal Code
- City
- Country
- SIREN and NIC (i.e. SIRET)
- VAT Number
- Language (creation scenario only)
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Look up French companies in the official SIRENE directory and fill in partner details automatically. You can search by name from a partner form, or simply type a SIREN, SIRET or VAT number and Odoo fills the address and VAT.
This module connects Odoo to the public French business directory (SIRENE, via opendatasoft.com) so you don't have to type company information by hand.
On a company contact, an action called "SIREN Lookup" opens a search window. You type a company name, click "Lookup", and Odoo shows a list of matching companies with their address, legal type, SIREN, SIRET, activity code, creation date, staff range and whether they are still active. Closed companies appear greyed out. Clicking "Select" on a line copies the chosen company's details onto the contact and leaves a note in the contact's history saying it was updated via the opendatasoft.com API.
Odoo can also fill the contact automatically while you type: if you enter a valid SIREN, SIRET or French VAT number in the SIREN, SIRET, VAT or even the company name field, the name, street, postal code, city, country and VAT number are filled in for you. Overseas French postcodes are mapped to the correct territory.
A setting in the VAT configuration lets you keep the VAT number computed from the SIREN even when the European VIES validation service is disabled or times out. This setting is per company.
Depends on
Models and fields (5)
- res.company · extends an existing modelforce_vat_siret_lookup (Force VAT Numbers during SIRET Lookups if VIES check times out or is disabled)
- res.partner · extends an existing model
- fr.siret.lookup · new modelname (Name to Search), line_ids (Results), partner_id
- res.config.settings · extends an existing modelforce_vat_siret_lookup (Force VAT Numbers during SIRET Lookups if VIES check times out or is disabled)
- fr.siret.lookup.line · new modelape (APE Code), zip, city, name, siren (SIREN), siret (SIRET), staff (# Staff), active, street, category, ape_label (APE Label), wizard_id (Wizard), country_id (Country), legal_type, creation_date
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-03Confirmation status: 3 confirmed, 6 with no information of 9 versions.
Sources · Odoo 16.0
Confirmed on 2026-11-03 in branch 16.0 of OCA/l10n-france.
terminal Installation and usage
OCA documentation · Odoo 18.0Installation
Source · Odoo 18.0It's recommended to install python-stdnum>=1.18 for SIRET support.
Configuration
Source · Odoo 18.0You can use this module without configuration.
However 2 configuration parameter can be adjusted in Invoicing > Configuration > Settings :
- Verify VAT Numbers (vat_check_vies field from base_vat module): this parameter will define whether you want check computed VAT number against EU VIES validation service
- Force VAT Numbers during SIRET Lookups if VIES check times out or is disabled (force_vat_siret_lookup): this parameter allows to force use of computed VAT number even if not checked agains EU VIES validation service or if an Exception is raised by EU VIES validation (for instance because of Timeout, which are quite frequent while checking for FR VAT)
The 2 above parameters are company dependent.
Note: if EU VIES validation service reports that VAT number is incorrect, the VAT field is emptied (even if Force... parameter is ticked)
Usage
Source · Odoo 18.0To update an existing partner, go to the partner form view and click on Action \> SIREN Lookup.
By default, the search field is filled with Company name. To get more accurate results, you may want to add the City name where the company is registered. Then click on Lookup.
A list of companies is displayed. You may want to click on one in order to see corresponding information or directly select company from list view. Once a company is selected, the partner information is updated and a message is logged in the chatter.
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.