Documentation KSIDol > Modules KSIDol > Fiche tiers par SIREN

Notice du module Fiche tiers par SIREN

Guide d'utilisation non technique : à quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.

Une saisie, une ficheLe SIREN suffit : raison sociale, adresse, SIRET, APE, forme juridique, TVA

Facture électroniqueVerdict d'annuaire à chaque recherche (Peppol et plateforme agréée)

Fiches sous surveillanceÉcarts avec le répertoire Sirene signalés à l'ouverture de la fiche

Quota préservéRéponses INSEE en cache local 30 jours

1. Presentation du module

SirenCreatTiers supprime la saisie manuelle des fiches tiers françaises : vous tapez le numéro SIREN dans le champ « Id prof. 1 » du formulaire de création ou de modification d'un tiers, et le module interroge l'API Sirene officielle de l'INSEE pour remplir le formulaire à votre place. Il vérifie au passage que l'entreprise peut recevoir des factures électroniques (annuaire central Peppol, et annuaire de la plateforme agréée quand le module EInvoicing est relié), puis continue de surveiller vos fiches dans le temps : à l'ouverture d'une fiche, les écarts avec le répertoire Sirene sont listés dans un bandeau, avec mise à jour en un clic.

Remplissage automatique depuis le SIREN : raison sociale (et sigle en alias), adresse du siège, code postal, ville, SIRET du siège, code APE, forme juridique, numéro de TVA intracommunautaire calculé.
Bouton loupe à côté du champ SIREN, et recherche automatique dès la saisie d'un SIREN valide (désactivable).
Verdict d'annuaire de facturation électronique : entreprise joignable ou non, plateforme de réception, acceptation du Factur-X.
Contrôle périodique des fiches : bandeau listant les différences, boutons « Mettre à jour la fiche » et « Valider telle quelle ».
Avertissements utiles : entreprise cessée, diffusion restreinte, clé de contrôle SIREN inhabituelle.
Cache local de 30 jours et accès réservé aux utilisateurs authentifiés disposant du droit de lecture des tiers.

2. Mise en route : la clé API INSEE

Le module s'appuie sur l'API Sirene officielle de l'INSEE, gratuite mais soumise à une clé.

Créez une clé gratuite sur le portail des API de l'INSEE (portail-api.insee.fr) : la page de configuration du module contient le guide pas-à-pas complet (compte, application, souscription à l'API Sirene, récupération de la clé).
Collez la clé dans la configuration du module puis utilisez « Tester la connexion » pour valider.
L'offre publique de l'INSEE (30 requêtes/minute, 2 000 requêtes/heure) est largement suffisante : le module met les réponses en cache local pendant 30 jours.
Activez le module, ouvrez un formulaire de création de tiers, saisissez un SIREN : c'est en service.

3. Créer une fiche tiers depuis le SIREN

Sur le formulaire de création d'un tiers, tout part du champ « Id prof. 1 (SIREN) ».

Saisissez le SIREN — les espaces et le formatage sont tolérés : « 938 582 186 » est accepté et nettoyé automatiquement.
La recherche se déclenche toute seule dès que 9 chiffres valides sont saisis (réglable), ou manuellement via le bouton loupe.
Le module remplit : raison sociale, sigle en alias, adresse du siège, code postal, ville, SIRET du siège (Id prof. 2), code APE (Id prof. 3), forme juridique et numéro de TVA intracommunautaire calculé.
Pour un entrepreneur individuel dont la dénomination porte le nom civil, le nom commercial INSEE (enseigne, dénomination usuelle) alimente le nom alternatif de la fiche.
Un message sous le champ confirme la récupération des données et affiche le verdict d'annuaire de facturation électronique.

4. Compléter une fiche existante

Le module fonctionne aussi sur le formulaire de modification, sans écraser votre travail.

En modification, seuls les champs vides sont complétés : ce que vous avez déjà saisi est conservé.
Un réglage (« Écraser les champs en modification ») permet au contraire de remplacer les champs par les données INSEE.
Le bouton loupe reste disponible à tout moment pour relancer la recherche.

5. Le verdict d'annuaire de facturation électronique

À chaque recherche, le module vérifie si l'entreprise est joignable en facturation électronique — la question que tout le monde se posera avec la réforme française.

Vérification native de l'annuaire central Peppol (SML/SMP), le canal officiel machine de la réforme, qui couvre toutes les plateformes agréées : entreprise enregistrée ou non, plateforme de réception déclarée, acceptation du format Factur-X.
Si le module EInvoicing est actif et relié à une plateforme agréée, son service d'annuaire normalisé (AFNOR XP Z12-013) est également interrogé, et l'adresse de routage du tiers est pré-remplie sur le formulaire de création.
Un seul verdict est affiché : si les deux sources ne sont pas d'accord, la réponse positive fait foi (une plateforme peut ignorer une entreprise pourtant enregistrée).
Si l'entreprise n'est pas joignable, l'enregistrement de la fiche demande une confirmation — simple garde-fou, désactivable dans la configuration.

6. Le contrôle périodique des fiches

Une fiche exacte le jour de sa création peut devenir fausse : déménagement, changement de forme juridique, cessation. Le module surveille sans rien imposer.

À l'ouverture d'une fiche tiers, ses données sont comparées au répertoire Sirene et à l'annuaire de facturation électronique.
En cas d'écart, un bandeau liste précisément les différences, champ par champ (valeur de la fiche contre valeur INSEE).
« Mettre à jour la fiche avec les données INSEE » applique les corrections en un clic ; « Valider la fiche telle quelle » garde vos valeurs.
Une fiche conforme ou validée n'est plus contrôlée pendant 90 jours (durée réglable) ; le contrôle peut être désactivé entièrement.

7. Avertissements et cas particuliers

Le module signale sans bloquer : c'est toujours vous qui décidez.

Entreprise administrativement cessée : un avertissement s'affiche, la fiche reste créable (utile pour un historique ou un contentieux).
Entreprise en diffusion restreinte au répertoire Sirene : le module vous en informe ; certaines données peuvent être absentes.
Clé de contrôle SIREN inhabituelle : simple avertissement, la saisie n'est jamais bloquée (des numéros parfaitement légitimes dérogent à la règle de contrôle, La Poste par exemple).
SIREN inconnu du répertoire : message clair, rien n'est rempli.

8. Les réglages du module

Tout se pilote depuis la page de configuration, sans toucher au code.

Clé API INSEE, avec bouton « Tester la connexion » et guide de création intégré.
Recherche automatique à la saisie : activée par défaut, désactivable (le bouton loupe reste).
Écraser les champs en modification : désactivé par défaut.
Contrôle de l'annuaire de facturation électronique : activé par défaut.
Confirmation à l'enregistrement quand l'entreprise n'est pas joignable : activée par défaut.
Contrôle périodique des fiches et durée de validité (90 jours par défaut).
Limiter les contrôles aux tiers français : activé par défaut — pour les entreprises étrangères, le contrôle TVA VIES natif de Dolibarr reste le bon outil.

9. Liaisons avec Dolibarr

Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.

Tiers : Le module travaille directement dans le formulaire natif de création et de modification des tiers : aucun écran parallèle, les données remplies sont celles de la fiche Dolibarr standard.
Identifiants professionnels : Les champs natifs Id prof. 1 (SIREN), Id prof. 2 (SIRET) et Id prof. 3 (APE) sont utilisés tels quels, ainsi que la forme juridique et le numéro de TVA intracommunautaire de la fiche.
Module EInvoicing (facturation électronique) : Quand EInvoicing est actif et relié à une plateforme agréée, son annuaire normalisé est interrogé en plus de l'annuaire central Peppol, et l'adresse de routage e-invoicing du tiers est pré-remplie. Sans EInvoicing, le module fonctionne intégralement avec le canal Peppol natif.
Contrôle TVA VIES natif : Pour les entreprises non françaises, le bouton de vérification VIES natif de Dolibarr, à côté du champ TVA intracommunautaire, reste l'outil de référence — le module ne le remplace pas.
Droits utilisateurs : La recherche est réservée aux utilisateurs authentifiés disposant du droit de lecture des tiers ; aucune donnée n'est accessible sans connexion.