Module AutoTiers EN: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
(Create module page)
 
(Configuration : clé API INSEE requise (portail-api.insee.fr, API Sirene 3.11), captures d'écran, SIRET d'essai / INSEE API key required, screenshots)
 
Line 38: Line 38:
= Configuration =
= Configuration =


No configuration is required. The module works as soon as it is enabled (the PHP cURL extension must be available).
AutoTiers needs a free INSEE API key.
 
# On portail-api.insee.fr: '''Se connecter''', '''CONNEXION-POUR-LES-EXTERNES''', then '''Enregistrement''' (fill the form without accents). Confirm the account from the email you receive.
# '''Tableau de bord -> Créer ma première application''': name, description, "simple" mode, then '''Créer l'application'''.
# '''Catalogue -> API Sirene''' (version 3.11, not V4) '''-> Souscrire''': "Accès public" plan, then the application you created.
# Copy the key shown; it stays visible in the application, '''Souscriptions''' tab.
# In Dolibarr: '''Home -> Setup -> Modules/Applications''', AutoTiers gear icon. Paste the key, '''Save''', then '''Test API Connection'''.
 
[[File:AutoTiers-configuration.jpg|thumb|none|700px|AutoTiers setup page: the INSEE API key]]


= Usage =
= Usage =


On a new third party, enter the SIRET number and click '''Search''': the fields are filled automatically from the INSEE database.
On '''Third parties -> New third party''', enter the SIRET in "Prof Id 2 (SIRET)" and click '''Search''': company name, address, postal code, town, SIREN, NAF/APE code and VAT number are filled from the INSEE Sirene database. Check them, then '''Create third party'''.
 
To try it: 12000101100010, the SIRET of the Secrétariat général du Gouvernement (French government).
 
[[File:AutoTiers-saisie-siret.jpg|thumb|none|700px|SIRET entered, Search button (French interface)]]
[[File:AutoTiers-champs-remplis.jpg|thumb|none|700px|After Search: the fields are filled]]


= Compatibility =
= Compatibility =


Dolibarr 14.0+ (tested on 22.0.2), PHP 7.4+, cURL.
Dolibarr 14.0+ (tested on 22.0.2 and 23.0.4), PHP 7.4+, cURL.

Latest revision as of 09:51, 23 October 2026

Information


Module name AutoTiers
Editor / Editeur NothingElse - https://nothingelse.app
Download or buy page / Page achat ou téléchargement External module - www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis PHP cURL extension

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2026-10-23
Note / Nota Tested on Dolibarr 22.0

AutoTiers automatically fills in a third party's information (company name, full address, postal code, town, SIREN, NAF/APE code and intra-community VAT number) from a French SIRET number, by querying the official INSEE SIRENE API.

Installation

  1. Download the module and unzip it into htdocs/custom/autotiers/
  2. In Dolibarr: Home -> Setup -> Modules/Applications
  3. Find AutoTiers and enable it
  4. Make sure the PHP cURL extension is enabled

Features

  • A Search button next to the SIRET field on the third party creation page
  • Queries the official, free INSEE SIRENE API
  • Automatically fills: company name, full address, postal code, town, SIREN, NAF/APE code
  • Intra-community VAT number computed automatically
  • Designed for French companies (SIRET-based)

Configuration

AutoTiers needs a free INSEE API key.

  1. On portail-api.insee.fr: Se connecter, CONNEXION-POUR-LES-EXTERNES, then Enregistrement (fill the form without accents). Confirm the account from the email you receive.
  2. Tableau de bord -> Créer ma première application: name, description, "simple" mode, then Créer l'application.
  3. Catalogue -> API Sirene (version 3.11, not V4) -> Souscrire: "Accès public" plan, then the application you created.
  4. Copy the key shown; it stays visible in the application, Souscriptions tab.
  5. In Dolibarr: Home -> Setup -> Modules/Applications, AutoTiers gear icon. Paste the key, Save, then Test API Connection.
AutoTiers setup page: the INSEE API key

Usage

On Third parties -> New third party, enter the SIRET in "Prof Id 2 (SIRET)" and click Search: company name, address, postal code, town, SIREN, NAF/APE code and VAT number are filled from the INSEE Sirene database. Check them, then Create third party.

To try it: 12000101100010, the SIRET of the Secrétariat général du Gouvernement (French government).

SIRET entered, Search button (French interface)
After Search: the fields are filled

Compatibility

Dolibarr 14.0+ (tested on 22.0.2 and 23.0.4), PHP 7.4+, cURL.