AutoTiers - Module Dolibarr

Module Dolibarr permettant l'auto-remplissage des informations d'un tiers à partir d'un numéro SIRET via l'API officielle SIRENE de l'INSEE.

Fonctionnalités

• Bouton "Rechercher" à côté du champ SIRET sur la page de création de tiers
• Interrogation de l'API INSEE SIRENE (gratuite et officielle)
• Remplissage automatique des champs :
  • Raison sociale
  • Adresse complète
  • Code postal
  • Ville
  • SIREN
  • Code NAF/APE
  • Numéro de TVA intracommunautaire (calculé automatiquement)

---

Installation

Prérequis

• Dolibarr 14.0 ou supérieur (testé sur 22.0.2)
• PHP 7.4 ou supérieur
• Extension PHP cURL activée

---

Méthode 1 : Installation via l'interface Dolibarr (recommandée)

C'est la méthode la plus simple, directement depuis Dolibarr.

Étape 1 : Télécharger le fichier ZIP

Téléchargez le fichier module_autotiers-1.0.0.zip depuis la page Releases de ce dépôt.

Note : Le fichier ZIP doit contenir le dossier autotiers à la racine.

Étape 2 : Déployer le module dans Dolibarr

1. Connectez-vous à Dolibarr en tant qu'administrateur
2. Allez dans Accueil > Configuration > Modules/Applications
3. Cliquez sur l'onglet "Déployer/Installer un module externe"
4. Cliquez sur "Parcourir..." et sélectionnez le fichier ZIP téléchargé
5. Cliquez sur "ENVOYER FICHIER"
6. Dolibarr décompresse et installe automatiquement le module

Étape 3 : Activer le module

1. Restez dans Accueil > Configuration > Modules/Applications
2. Cliquez sur l'onglet "Modules/applications disponibles"
3. Dans la barre de recherche, tapez "AutoTiers"
4. Cliquez sur le bouton ON/OFF pour activer le module

Étape 4 : Configurer la clé API INSEE

1. Cliquez sur l'icône ⚙️ (roue dentée) à côté du module activé
2. Saisissez votre clé API INSEE (voir section "Obtenir une clé API INSEE" ci-dessous)

---

Méthode 2 : Installation manuelle (FTP/SSH)

Si vous préférez copier les fichiers manuellement sur le serveur.

Étape 1 : Télécharger le module

Téléchargez ou clonez le dossier autotiers depuis ce dépôt.

Étape 2 : Copier les fichiers sur le serveur

Copiez le dossier autotiers dans le répertoire custom de votre installation Dolibarr :

Linux :

/var/www/html/dolibarr/htdocs/custom/autotiers/

Windows :

C:\wamp64\www\dolibarr\htdocs\custom\autotiers\

La structure finale doit être :

htdocs/
└── custom/
    └── autotiers/
        ├── admin/
        │   └── setup.php
        ├── ajax/
        │   └── siret_lookup.php
        ├── class/
        │   └── actions_autotiers.class.php
        ├── core/
        │   └── modules/
        │       └── modAutoTiers.class.php
        ├── js/
        │   └── autotiers.js
        ├── langs/
        │   ├── en_US/
        │   │   └── autotiers.lang
        │   └── fr_FR/
        │       └── autotiers.lang
        ├── sql/
        │   ├── llx_autotiers.key.sql
        │   └── llx_autotiers.sql
        └── README.md

Étape 3 : Vérifier la configuration des modules personnalisés

Si ce n'est pas déjà fait, activez le support des modules personnalisés :

1. Connectez-vous à Dolibarr en tant qu'administrateur
2. Allez dans Accueil > Configuration > Sécurité & Divers
3. Vérifiez que le chemin des modules personnalisés est défini :
   • Cherchez l'option "Répertoire racine des modules personnalisés"
   • La valeur doit être : htdocs/custom (ou le chemin complet)

Étape 4 : Activer le module AutoTiers

1. Allez dans Accueil > Configuration > Modules/Applications
2. Dans la barre de recherche, tapez "AutoTiers"
3. Cliquez sur le bouton ON/OFF pour activer le module
4. Le module apparaît dans la catégorie CRM

Étape 5 : Configurer la clé API INSEE

1. Cliquez sur l'icône ⚙️ (roue dentée) à côté du module activé
2. Saisissez votre clé API INSEE (voir section suivante)

---

Obtenir une clé API INSEE (gratuit)

Étape 1 : Créer un compte

1. Rendez-vous sur https://api.insee.fr
2. Cliquez sur "Créer un compte"
3. Remplissez le formulaire et validez votre email

Étape 2 : Créer une application

1. Connectez-vous à votre compte INSEE
2. Allez dans "Mes applications" (menu en haut à droite)
3. Cliquez sur "Créer une application"
4. Donnez un nom à votre application (ex: "Dolibarr AutoTiers")
5. Validez

Étape 3 : Souscrire à l'API Sirene

1. Dans votre application, cliquez sur "Ajouter une API"
2. Recherchez "Sirene - Données ouvertes"
3. Cliquez sur "Souscrire"
4. Acceptez les conditions d'utilisation

Étape 4 : Récupérer la clé API

1. Dans votre application, allez dans l'onglet "Clés"
2. Copiez la clé au format UUID : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Étape 5 : Configurer le module

1. Dans Dolibarr, allez dans la configuration du module AutoTiers
2. Collez votre clé API dans le champ prévu
3. Cliquez sur "Enregistrer"
4. Cliquez sur "Tester la connexion API" pour vérifier

---

Utilisation

1. Allez dans Tiers > Nouveau tiers
2. Saisissez un numéro SIRET (14 chiffres) dans le champ "Id. prof. 2 (SIRET)"
3. Cliquez sur le bouton "Rechercher" à côté du champ
4. Les informations de l'entreprise sont automatiquement remplies
5. Vérifiez les données et complétez si nécessaire
6. Cliquez sur "Créer tiers" pour enregistrer

---

Dépannage

Le bouton "Rechercher" n'apparaît pas

• Vérifiez que le module est bien activé
• Vérifiez que la clé API est configurée
• Videz le cache de votre navigateur (Ctrl+F5)
• Vérifiez la console JavaScript (F12) pour d'éventuelles erreurs

Erreur "Clé API invalide"

• Vérifiez que vous avez bien copié la clé complète (format UUID)
• Assurez-vous d'avoir souscrit à l'API "Sirene - Données ouvertes"
• La clé peut prendre quelques minutes à être active après création

Erreur "SIRET non trouvé"

• Vérifiez que le numéro SIRET est correct (14 chiffres)
• L'établissement peut être fermé ou non encore référencé
• Les nouvelles entreprises peuvent mettre quelques jours à apparaître

Erreur de connexion

• Vérifiez que votre serveur peut accéder à Internet
• Vérifiez que l'extension PHP cURL est activée
• L'API INSEE peut être temporairement indisponible

---

Désinstallation

1. Allez dans Accueil > Configuration > Modules/Applications
2. Désactivez le module AutoTiers
3. Supprimez le dossier htdocs/custom/autotiers/

---

Licence

GNU General Public License v3.0

---

Changelog

Version 1.0.0

• Version initiale
• Support de l'API INSEE Sirene v3.11
• Authentification par clé API (X-INSEE-Api-Key-Integration)