odoo-addon-l10n-fr-siret-lookup 18.0.1.0.0.3

Lookup partner via an API on the SIRENE directory

SIRET Lookup

This modules updates partner fields via the SIRENE database <https://data.opendatasoft.com\>. It uses the dataset economicref-france-sirene-v3 of opendatasoft <https://public.opendatasoft.com/explore/dataset/economicref-france-sirene-v3/information/\>.

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)

Table of contents

• Installation

• Configuration

• Usage

• Bug Tracker

• Credits

  • Authors

  • Contributors

  • Other credits

  • Maintainers

Installation

It’s recommended to install python-stdnum>=1.18 for SIRET support.

Configuration

You 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

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

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

• Le Filament

• Akretion

Contributors

• Benjamin Rivier <benjamin-filament> (https://le-filament.com)

• Remi Cazenave <remi-filament> (https://le-filament.com)

• Alexis de Lattre <[e-mail]>

Other credits

The development of this module has been financially supported by:

• Le Filament

Maintainers

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainers:

This module is part of the OCA/l10n-france project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.