Une fois le module activé, vous pouvez procéder à ses paramétrages : il ne nécessite pas la définition de permissions.
# 3. SOUSCRIRE À UNE API DE L'INSEE # Renouveler le token d'accès ### **Procédure :** 1\. Connectez-vous sur [https://portail-api.insee.fr](https://portail-api.insee.fr) avec votre compte. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/TS40EjDdHKmNgaNZ-r14.png) 2\. Allez dans "***Mes applications***" puis sélectionnez votre application. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/SUbTyVa9KxWzSLwB-g1.png) 3\. Ouvrez l'onglet ***"Souscriptions".*** Cliquez sur "API Sirene". [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/gk4UcpsfaAlWVmuY-g2.png) 4\. Cliquez sur le bouton **"Renouveler"** . [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/vlvmtyXiRQ3Siauk-g3.png) [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/0Ihld7czsKAUqONt-g4.png) ### **À savoir :** - L'Insee ***recommande de renouveler le jeton d'accès toutes les 24h*** (il est de courte durée de vie). - Depuis la seconde quinzaine de septembre 2026, le mot de passe de votre compte sur le portail devra lui aussi être renouvelé tous les 90 jours (une invité apparaît à la connexion si l'échéance est dépassée). - Si vous passez par l'API en direct plutôt que par l'interface, l'ancien Endpoint de token était `https://api.insee.fr/token` (POST, `grant_type=client_credentials`) ; vérifiez l'équivalent OAuth2 documenté sur le nouveau portail si votre intégration utilise encore l'ancienne URL, car elle peut avoir changé lors de la migration. # Souscrire à une API de l'INSEE ### **Créer ou migrer son compte Insee** À compter du 28 février 2025, la souscription à l'API 3.11 du nouveau portail de l'Insee nécessite la création d'un compte auprès de ce portail. Rendez-vous sur le nouveau portail à l'adresse suivante https://portail-api.insee.fr/ et cliquez sur le menu **SE CONNECTER**. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/V9NmXUrp7T3A61lD-r1.png) Sur la page suivante, cliquez sur le bouton **CONNEXION POUR LES EXTERNES**. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/QchERnxT2t6aqwWA-r2.png) *Figure 3.1. Connexion au portail* Laissez vous guider pour la création de votre compte. Surveillez vos courriers indésirables, des e-mails de confirmation de création de votre compte vont vous être envoyés.**Note** : Si vous aviez un compte sur l'ancien portail, il sera reconnu, votre ancien mot de passe sera toujours valable suite à l'e-mail de confirmation de migration de ce compte utilisateur.
Une fois votre compte vérifié, connectez-vous. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/TS40EjDdHKmNgaNZ-r14.png) ### **Créer son application** Cliquez sur le menu APPLICATIONS puis sur le bouton **CRÉER UNE APP**. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/YXoEpZEfGtYoGCMY-r3.png) Sur l'écran suivant, contentez-vous de compléter le NOM DE L'APPLICATION : **Dolibarr/Easya** par exemple et une DESCRIPTION avant de cliquer sur le bouton SUIVANT. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/nQt5OMPHlixMNupo-r4.png) À l'étape suivante, cliquez directement sur le bouton **SUIVANT**. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/0MpmuEjbzPwDWMCu-r5.png) Enfin, cliquez sur le bouton **CRÉER L'APPLICATION**. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/TlPfGJSS8XdZ1mLS-r6.png) [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/CP79pEFookOcD5Xx-r7.png) Cliquez sur les boutons SUIVANT jusqu'à obtention de l'écran de succès de la création de votre application.[](https://wiki.infras.fr/uploads/images/gallery/2026-07/H1bmymEhel1856Ix-thidksc0azp8juxw-r8.png)[](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/tHIDKSc0aZP8jUxW-r8.png) ### **Souscrire à l'API et récupérer le token d'accès** Connecté sur le portail, parcourez le **CATALOGUE** et trouvez (ou recherchez) l'API sirene. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/RnZVAxCEBbkfZSju-r9.png) Cliquez sur sa tuile et cliquez sur le bouton **SOUSCRIRE**. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/SUStt6ozzAp66oHx-r15.png) Cliquez ensuite sur l'API Sirene pour afficher le bandeau de droite et récupérer le token nécessaire au bon fonctionnement du module. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/zzjDQrvY6Pl0texI-r10.png) [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/UJK6pKRDmzFHV9Kp-r11.png) [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/LP3MyIIeSMOFGEuz-r12.png) [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/GrBS1Pfb6SBMAPns-r13.png) # 4. PARAMÉTRAGES # ONGLET « CODE NAF » ### **Paramètres pour la liste des codes NAF** Ces réglages contrôlent la lecture du fichier CSV fourni avec le module (install/data/codenaf.csv), utilisé pour alimenter le dictionnaire des codes NAF (activités). [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/xQnUPnr3nZX6BOPc-g7.png) - **Séparateur CSV :** séparateur de champs utilisé dans le fichier CSV. Valeur par défaut : « ; ». - **Caractère d'encadrement CSV :** caractère d'encadrement de texte utilisé dans le fichier CSV. Valeur par défaut : « " ». - **Caractère d'échappement CSV :** caractère d'échappement utilisé dans le fichier CSV. Valeur par défaut : « \\ ». Deux boutons sont proposés en bas de formulaire : - **Bouton « Modifier » :** enregistre les 3 réglages ci-dessus (séparateur, encadrement, échappement) sans recharger le fichier CSV. - **Bouton « Recharger le fichier des Codes NAF » :** relit entièrement le fichier CSV fourni avec le module, avec les 3 réglages ci-dessus, et réimporte les codes NAF dans le dictionnaire ; un message indique le nombre de codes NAF ajoutés.Cette action n'enregistre pas les 3 réglages de format CSV si vous les avez modifiés dans le même envoi de formulaire (utilisez d'abord « Modifier » pour les sauvegarder, puis « Recharger le fichier des Codes NAF » séparément si nécessaire).
# ONGLET « DICTIONNAIRE » [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/xQnUPnr3nZX6BOPc-g7.png) Cette page réutilise le système générique du module ***« Dictionnaires avancés »*** filtré sur les dictionnaires propres à Sirene. Elle affiche la liste des dictionnaires disponibles pour le module et permet, en cliquant sur l'un d'eux, d'en consulter et gérer le contenu (ajout, modification, activation/désactivation, suppression d'une ligne), selon les droits accordés à l'utilisateur sur le module « Dictionnaires avancés » (lecture, création, modification, suppression, activation/désactivation). ### **Dictionnaires proposés par le module Sirene :** Le module Sirene nécessite deux dictionnaires de correspondance pour la bonne gestion des pays et des effectifs des tiers. Leur modification est possible mais n'est nécessaire que si vous avez apporté des modifications aux dictionnaires natifs de gestion de ces données. **Code NAF :** liste des codes d'activité (NAF/APE) et de leur libellé, alimentée par l'onglet « Code NAF » (voir chapitre précédent). **Effectifs :** tranches d'effectifs salariés utilisées pour qualifier la taille des entreprises retournées par l'API Sirene. **Pays :** table de correspondance des codes pays utilisée par les données Sirene/RNA. # ONGLET « RNA » Le RNA (***Répertoire National des Associations***) permet d'interroger les informations des associations, structures non commerciales, via une API dédiée, sur le même principe que l'onglet « Sirene ». ### **Paramètres de l'API :** Le champ de saisie de l'URL D'ACCÈS À L'API permettant de récupérer les informations propres aux structures de type associations, en complément des autres informations. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/Avfi1bls3fUgWgX1-g6.png) - **URL d'accès à l'API :** adresse de l'API RNA interrogée. Valeur par défaut si laissée vide : ***https://siva-integ1.cegedim.cloud/apim/api-asso/api/structure/.*** - **Vérification SSL, à n'activer que sur demande de votre intégrateur :** active le contrôle du certificat SSL du serveur de l'API RNA, à des fins de débug, sauvegarde immédiate.L'URL est validée par le bouton **« Enregistrer »** de ce bloc ; l'interrupteur SSL s'enregistre séparément et immédiatement.
# ONGLET « SIRENE » ### **Paramètres de l'API :** [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/yE59fxzOFmthiRaM-g5.png) Dans le tableau PARAMÈTRES API, enregistrez les données de connexion aux API du répertoire SIRENE, soit : - **URL d'accès à l'API :** adresse de l'API Sirene (INSEE) interrogée pour les recherches d'entreprises. Valeur par défaut si laissée vide : [https://api.insee.fr/api-sirene/3.11/.](https://api.insee.fr/api-sirene/3.11/.) La valeur de ce champ est fournie à l'installation du module. Ne modifiez cette valeur que sur une communication de notre part. - **Token d'accès à l'API :** jeton d'authentification généré depuis le compte Sirene, transmis en en-tête «Authorization: Bearer». - **Vérification SSL, N'activez ce paramètre que sur demande de votre intégrateur en cas de difficultés d'utilisation :** active le contrôle du certificat SSL du serveur de l'API, utile uniquement à des fins de débug, sauvegarde immédiate.Ces 3 champs sont validés ensemble par le bouton **« Enregistrer »** de ce bloc (le token et l'URL uniquement ; l'interrupteur SSL s'enregistre séparément et immédiatement).
### **Paramètres généraux (partie API) :** - **TimeOut de l'API :** délai d'attente maximum d'une requête vers l'API, en secondes (valeur par défaut : 10). - **Mode débug :** affiche les messages d'erreur détaillés en cas de problème sur une requête API, sauvegarde immédiate. **N’activez le mode debug que sur notre demande suite à un problème technique.**Le champ TimeOut est validé par le bouton **« Enregistrer »** du même formulaire que le bloc « Paramètres de l'API » ci-dessus.
### **Paramètres généraux (options de recherche/création de tiers) :** - **Recherche des adresses :** active la recherche d'adresses via l'API Adresse, sauvegarde immédiate. Si le module natif ***Dolibarr*** ***« Adresse France »*** est actif, cette option est automatiquement désactivée et verrouillée, non modifiable : un message invite à désactiver ce module natif avant de pouvoir activer cette fonctionnalité du module Sirene. - **Lien de vérification du numéro SIREN dans la fiche tiers :** URL à placer avant le numéro SIREN pour construire le lien de vérification affiché sur la fiche tiers. Valeur par défaut : lien vers ***https://annuaire-entreprises.data.gouv.fr/entreprise/.*** - **Sièges sociaux :** lors de la création d'un tiers, ne rechercher par défaut que parmi les sièges sociaux, plutôt que tous les établissements, sauvegarde immédiate. - **Nom tiers étendu :** ajoute la ville et le NIC, numéro d'établissement, dans le nom du tiers récupéré depuis Sirene, si un tiers du même nom existe déjà dans ***Dolibarr***, ce qui évite les doublons de libellé, sauvegarde immédiate. - **Rendre la recherche par SIRENE obligatoire pour :** oblige à passer par la recherche SIRENE avant de créer un tiers, parmi Prospect, Client, Fournisseur. - **Types de tiers exclus de l'obligation SIRENE :** types de tiers, dictionnaire natif ***Dolibarr*** « Types de tiers », pour lesquels la recherche SIRENE n'est pas obligatoire, même si l'option ci-dessus est active (par défaut : Particulier).Ces réglages sont validés par le bouton « Enregistrer » du bloc « Paramètres généraux ».
### **Paramètres de la tâche planifiée (cron) :** [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/iVO4gRzWQA4CKee5-g51.png) L'activation de la tâche planifiée peut mettre à jour automatiquement les données des tiers français. Champs mis à jour par la tâche planifiée, chacun activable individuellement et sauvegardé immédiatement : Raison sociale ; Nom alternatif, enseigne, nom commercial ou marque ; Adresse (adresse, code postal, département, ville, pays, géolocalisation) ; RNA ; Code NAF ; Numéro de TVA ; Effectifs (note : sur certaines versions du module, l'affichage initial de cet interrupteur peut être erroné, toujours affiché comme désactivé, suite à une particularité du code de la page ; cliquer dessus pour vérifier ou forcer l'état réellement souhaité) ; Forme juridique. - **Envoi d'un mail d'alerte :** adresse mail du destinataire de l'alerte informant d'une fermeture de tiers ou d'un problème survenu lors de la vérification des tiers. - **Fréquence de mise à jour :** met à jour les tiers français ouverts, ayant un SIRET, dont la date du dernier appel Sirene remonte à plus de X jours (valeur par défaut : 30).Le mail d'alerte et la fréquence sont validés par le bouton **« Enregistrer »** de ce bloc ; les cases à cocher des champs mis à jour s'enregistrent individuellement et immédiatement.
# 5. UTILISATION DU MODULE # Utilisation régulière ### **Recherche et création de tiers :** Le module **SIRENE** ajoute aux pages de création des tiers un cadre de saisie des différents critères de recherche. Saisissez les éléments en votre possession et cliquez sur le bouton RECHERCHER pour afficher la liste des résultats. Vous pouvez choisir de limiter le nombre de résultats à afficher en remplissant le champ dédié. Par défaut, l'affichage sera limité à 20 lignes. Dès que vous ouvrez le formulaire de création d'un tiers (***Tiers > Nouveau tiers***), un bloc ***« Rechercher automatiquement le tiers (rep. SIRENE) »*** apparaît en haut du formulaire, avant les champs habituels. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/gCywlo9QRfPb5C2w-h1.png) *Figure 5.1. Tableau de recherche d'un tiers* Le bouton + DE CRITÈRES vous affichera les champs de recherche VILLE, CODE POSTAL et vous permettra de modifier le nombre de résultat.**Note** La case **AFFICHER UNIQUEMENT LES ÉTABLISSEMENTS OUVERTS** est cochée par défaut, Aussi, si plusieurs résultats sont disponibles, le module SIRENE coche par défaut en vue de la sélection rapide du premier résultat dont l'établissement est en activité. La case **AFFICHER UNIQUEMENT LES SIÈGES SOCIAUX** est cochée selon les paramétrages du module pour toutes vos recherches.
[](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/MJAJx17ppB0MKCpY-h2.png) *Figure 5.2. Résultats d'une recherche*| #### **Options de recherche — caractères de substitution** - Le caractère `~` (AltGr + 2 sous Windows) permet de faire une recherche approximative sur 1 ou 2 caractères. - Le caractère `*` permet de remplacer une chaîne de caractères de taille quelconque. Il signifie donc une chaîne de 0 ou plusieurs caractères, sauf quand il est seul : dans ce cas, il signifie une chaîne d'au moins un caractère. `CodePostal=69*` donnera comme résultat tous les codes postaux commençant par 69 et suivis d'autres caractères, tandis que `CodePostal=69**0` affichera les codes postaux commençant par 69, suivis de 2 caractères et se terminant par 0. - Le caractère `?` permet de remplacer un et seulement un caractère. `CodePostal=69?` affichera les résultats commençant par 69 suivis d'un seul et unique caractère, soit aucun résultat pour les codes postaux comportant 5 caractères. Une recherche `CodePostal=6900?` listera les codes postaux des arrondissements de Lyon. **Astuce** Les caractères de substitution sont cumulables dans un même filtre. Il est possible de lancer une recherche par code postal selon les critères `69?*`. **Attention** Malgré l'utilisation des caractères de substitution, les résultats affichés peuvent être limités par les enregistrements et le formatage du répertoire Sirene. |
|---|
**Note :** Cette action peut être effectuée par l'exécution d'une tâche planifiée.
### **Cas des établissements fermés** Lorsque le module détecte que l'établissement de votre tiers est fermé, une VÉRIFICATION SIRENE manuelle lancera dans le pop-up de mise à jour une nouvelle recherche depuis le numéro de SIREN du tiers. Vous pourrez sélectionner le nouvel établissement depuis lequel mettre à jour les informations de votre tiers. [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/93DJ5EK6abTRDRPd-h8.png) *Figure 5.6. Recherche d'un nouvel établissement par son SIREN* # 6. AUTOMATISATIONS DE LA MISE À JOUR # TÂCHE CRON Le module SIRENE ajoute une tâche planifiée pour automatiser la vérification des données de vos tiers avec celles présentes dans le répertoire Sirene. Activez le module TACHES PLANIFIÉES et la tâche planifiée ETAT MAJ SIRENE sur la page ***ACCUEIL > OUTILS D'ADMINISTRATION > TÂCHES PLANIFIÉES.*** [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/Pz4oNwRblWnK3wyZ-y3.png) *Figure 6.1. Tâche planifiée activée* Sans autre paramétrage, la tâche planifiée passe en revue la liste des tiers. Si un tiers a été FERMÉ, un e-mail est envoyé aux destinataires définis dans les paramètres du module [](https://wiki.infras.fr/uploads/images/gallery/2026-07/scaled-1680-/8kXQENK65vR61oLb-y4.png) *Figure 6.3. Paramétrages de la tâche planifiée* **ENVOI D'UN MAIL D'ALERTE :** Renseignez ici l'adresse e-mail destinataire de la notification des tiers ayant fait l'objet d'une fermeture. Plusieurs destinataires peuvent être saisis, séparez-les alors par des virgules. **FRÉQUENCE DE MISE À JOUR :** Ce nombre de jours définit la période pendant laquelle un tiers ne sera pas vérifié par l'automatisme depuis sa dernière date de mise à jour. **CHAMPS MIS À JOUR :** sélectionnez, les champs que vous souhaitez voir modifiés automatiquement en cas de modification sur le répertoire Sirene de l'INSEE. L'activation de la mise à jour de l'adresse implique la mise à jour de toutes ses données composantes : - - - Adresse - Code postal - Département - Ville - Pays et géolocalisation| #### Limites de l'automatisme de mise à jour L'absence de certaines données sur les fiches de vos tiers (CODE CLIENT ou CODE FOURNISSEUR par exemple) peut empêcher leur mise à jour par la tâche planifiée. Dans ce cas, le champ MISE À JOUR SIRENE DÉTECTÉE sera coché, vous devrez apporter les modifications nécessaires à la fiche de votre tiers et décocher la case MISE À JOUR SIRENE DÉTECTÉE. |
|---|
**Attention** Toute modification apportée dans le dictionnaire sera supprimée suite à une réactivation du module SIRENE pour recharger les données du fichier .csv. Apportez vos modifications dans le fichier .csv suivies de la réactivation du module SIRENE pour reconstituer la liste des libellés telle que vous l'aurez personnalisée dans le fichier source.
##### **Extrait de compte client :** Permet la création d'un état d'un compte client ou fournisseur. Visualisez rapidement l’état des factures et le restant à payer de vos clients et fournisseurs. ##### **Prospecting map :** Localise les tiers sur une carte présente sur leur fiche et permet d’afficher vos prospects sur une carte globale selon leur statut de prospection et autres critères. # 8. SUPPORT ET ASSISTANCE # Bonnes pratiques Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module : 1. 1. Désactivez et réactivez le module. 2. Vérifiez sur le ChangeLog si une nouvelle version a été publiée et sa compatibilité avec votre version de ***Dolibarr***. 3. Ré-installez/mettez à jour le module. 4. Vérifiez enfin qu'aucune incompatibilité avec un autre module ne soit indiquée. Le cas échéant, suivez nos préconisations. Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant notre extranet de support . Pour plus d’efficacité dans l’étude de votre demande, précisez : - - Le nom et la version du module - La version de Dolibarr - La liste des modules additionnels activés - Tous les éléments nécessaires à la meilleure des prises en charge de votre demande : contexte, étapes successives pour reproduire l'erreur, captures d'écran, etc.| #### Module SIRENE installé sur un serveur local L'utilisation du module sur un environnement local peut nécessiter une modification du fichier php.ini du serveur. Cette opération est nécessaire si vous rencontrez l'erreur 60 ou un message de type suivant : cURL error 60: SSL certificate problem: unable to get local issuer certificate. 1. Téléchargez le fichier cacert.pem depuis le site [http://curl.haxx.se/ca/cacert.pem](http://curl.haxx.se/ca/cacert.pem) 2. Éteignez le serveur 3. Placez le fichier dans le répertoire où est installé PHP : C:\\doliwamp\\bin\\php par exemple 4. Ouvrez le fichier php.ini. Identifiez la ligne contenant curl.cainfo. Modifiez alors le fichier en ajoutant le chemin vers le fichier cacert.pem. Par exemple : curl.cainfo = C:\\doliwamp\\bin\\php\\cacert.pem. 5. Redémarrez le serveur. Cette opération pourrait demander à être effectuée de nouveau à chaque mise à jour du serveur Wamp ou de Doliwamp. |
|---|
**Note** Pour le bon déroulement d'une mise à jour, désactivez un module avant de lancer le remplacement de ses fichiers puis de le réactiver. Vérifiez enfin que de nouveaux paramétrages ne soient pas nécessaires.