Créez et vérifiez vos tiers Dolibarr depuis les registres d’entreprises / Assistant tiers entreprise

1. Présentation

Nspappers simplifie la création et la mise à jour des tiers : au lieu de ressaisir le nom, l’adresse, le SIREN ou le n° de TVA d’une entreprise, vous les récupérez depuis les registres officiels ou des services spécialisés comme Pappers.

• À la création d’un tiers : une zone de recherche (nom, SIREN, SIRET ou n° de TVA) remplit le formulaire en un clic.
• Sur la fiche d’un tiers existant : le bouton « Vérifier les données » ouvre une fenêtre qui compare ce qui est saisi dans Dolibarr avec ce que dit la source, champ par champ.
• Les contacts : les dirigeants de l’entreprise peuvent être créés comme contacts du tiers, ou leur fonction mise à jour.
• Plusieurs sources, tous les pays : France en priorité, puis la zone euro et le reste du monde.

Rien n’est modifié sans votre accord : vous cochez ce que vous souhaitez reprendre. Le module ne modifie pas le cœur de Dolibarr.

2. Prérequis et installation

2.1 Prérequis

Élément	Version
Dolibarr	20.0.0 à 24.0.x
PHP	7.4 à 8.3
Framework NSINFO	23.9.9 ou supérieur, installé et activé

Sans le framework NSINFO (gratuit), l’activation du module est refusée avec un message d’explication. Voir le framework NSINFO.

2.2 Installation

1. Dans Dolibarr, ouvrez Accueil > Configuration > Modules/Applications, puis l’onglet « Déployer/Installer un module externe ».
2. Glissez l’archive ZIP du module et cliquez sur « Envoyer fichier ».
3. Activez le module « Assistant tiers entreprise ».

Voir aussi installer un module et activation et paramètres.

3. Configuration

La page de réglages du module présente des sous-onglets verticaux. Chaque réglage s’enregistre dès que vous le modifiez (une coche verte le confirme). Quand un réglage n’est pas à sa valeur par défaut, une pastille ↺ apparaît devant lui et sur son sous-onglet : un clic sur celle du sous-onglet remet par défaut tous les réglages de ce sous-onglet.

3.1 Un sous-onglet par pays

Le pays de la société de votre Dolibarr est affiché en premier et marqué « pays du Dolibarr ». Viennent ensuite les autres sous-onglets :

Sous-onglet	Sources	Compte ou clé
France	API Recherche d’entreprises (activée par défaut) · Pappers · INSEE Sirene	Aucune pour l’API Recherche d’entreprises ; une clé pour Pappers et INSEE Sirene
Pays-Bas	KVK	Clé API (payante)
Irlande	CRO	Compte CRO Open Services
Royaume-Uni	Companies House	Clé API gratuite
Norvège	Brønnøysund	Aucune
Danemark	CVR (via cvrapi.dk)	Aucune (nombre de requêtes limité)
Tchéquie	ARES	Aucune
Monde	OpenCorporates · Creditsafe (tous les pays qu’ils couvrent)	Clé API OpenCorporates ; accès Creditsafe (contrat)
Union européenne	VIES (activé par défaut)	Aucune

Pour chaque source : un interrupteur pour l’activer et, si elle en demande une, le champ où coller la clé. Une source n’est utilisée que si elle est activée et que sa clé est renseignée. Chaque sous-onglet rappelle, sous les réglages, les liens des sites où créer le compte ou la clé.

Quand plusieurs sources sont actives pour un pays, leurs réponses sont fusionnées : pour chaque information, la première valeur renseignée est retenue, et la fenêtre de vérification indique de quelle source elle vient.

3.2 Contacts et bouton

Réglage	Effet
Proposer les dirigeants comme contacts du tiers	Activé par défaut. Les dirigeants apparaissent comme contacts à créer ou à mettre à jour.
Inclure aussi les dirigeants personnes morales	Désactivé par défaut. Par exemple une société présidente d’une autre société.
Couleur des boutons de l’assistant	Couleur des boutons du module (violet par défaut), choisie dans un sélecteur de couleur.

4. Obtenir une clé ou un compte

Deux sources fonctionnent sans rien demander : l’API Recherche d’entreprises (entreprises françaises) et VIES (validation des n° de TVA européens). Brønnøysund (Norvège), CVR (Danemark) et ARES (Tchéquie) sont aussi sans clé. Pour les autres, il faut créer un compte chez le fournisseur. Les conditions, tarifs et écrans des fournisseurs peuvent évoluer : leur site fait foi.

4.1 INSEE Sirene (gratuite)

L’INSEE fournit gratuitement les informations officielles des entreprises françaises (identité, adresse, activité, effectif). Il faut une clé personnelle :

1. Ouvrez le portail portail-api.insee.fr et cliquez sur « Se connecter ».
2. Choisissez la connexion pour les externes, puis « Enregistrement » : renseignez votre adresse e-mail et créez votre compte. Un message de confirmation est envoyé à cette adresse : validez-le.
3. Connectez-vous, ouvrez le tableau de bord et créez une application (nom libre, par exemple « Dolibarr »). Choisissez le mode de création simple.
4. Dans cette application, souscrivez à l’API Sirene.
5. Ouvrez l’onglet « Souscriptions », choisissez la souscription à l’API Sirene : votre clé d’API s’y affiche. Copiez-la.
6. Dans Dolibarr, ouvrez les réglages du module, sous-onglet France : collez la clé dans « Clé API INSEE Sirene » puis activez « INSEE Sirene ».

La clé n’a pas de date de fin et peut être renouvelée ou révoquée depuis le portail. L’INSEE limite le nombre de demandes par minute : c’est largement suffisant pour une saisie manuelle.

L’INSEE ne communique pas les dirigeants : pour les récupérer en France, gardez l’API Recherche d’entreprises (gratuite) ou Pappers.

4.2 Pappers

Pappers est un service payant (fonctionnement par crédits) qui propose des données complètes : dirigeants, adresse, forme juridique, capital, état de l’entreprise. Rendez-vous sur pappers.fr/api, créez un compte, choisissez une offre puis copiez votre clé API. Collez-la dans le sous-onglet France et activez « Pappers ». Chaque recherche et chaque fiche consomment des crédits.

4.3 OpenCorporates

OpenCorporates couvre de nombreux pays, dont la Belgique et le Luxembourg. Demandez une clé API sur opencorporates.com/api_accounts/new (usage commercial payant, selon leurs conditions). Collez-la dans le sous-onglet Monde et activez « OpenCorporates ».

4.4 KVK (Pays-Bas)

Le registre du commerce néerlandais. Rendez-vous sur le portail des développeurs du KVK, demandez une clé API (service payant) et collez-la dans le sous-onglet Pays-Bas.

4.5 CRO (Irlande)

Le registre irlandais des sociétés. Créez un compte CRO Open Services (services.cro.ie), puis saisissez dans le sous-onglet Irlande votre adresse e-mail et votre clé séparées par deux-points : e-mail:clé.

4.6 Creditsafe

Service payant avec contrat, qui couvre de nombreux pays et fournit aussi les dirigeants. Après souscription auprès de Creditsafe, saisissez dans le sous-onglet Monde l’identifiant et le mot de passe de l’accès API séparés par deux-points : utilisateur:mot de passe.

4.7 Companies House (Royaume-Uni)

Le registre britannique des sociétés fournit gratuitement l’identité, l’adresse, l’état et les dirigeants en fonction. Rendez-vous sur le portail des développeurs de Companies House, créez un compte, créez une application puis une clé de type « REST ». Collez la clé dans le sous-onglet Royaume-Uni et activez « Companies House ».

4.8 Sources gratuites sans clé

Il suffit d’activer l’interrupteur correspondant : Brønnøysund (Norvège), CVR (Danemark, via le service cvrapi.dk, qui limite le nombre de requêtes gratuites) et ARES (Tchéquie). Ces sources ne fournissent pas toujours les dirigeants.

5. Droits d’accès

Droit	Effet
Utiliser l’assistant tiers entreprise	Permet la recherche à la création d’un tiers et le bouton « Vérifier les données ». Accordé par défaut à l’activation du module.

Pour enregistrer les données reprises, l’utilisateur doit aussi pouvoir créer et modifier les tiers. Les droits se règlent dans la fiche de chaque utilisateur ou groupe, onglet Permissions.

6. Utilisation

6.1 Créer un tiers

1. Ouvrez Tiers > Nouveau tiers. Une zone « Rechercher » apparaît au-dessus du formulaire.
2. Choisissez le pays (celui de votre société est présélectionné ; la zone euro puis le reste du monde sont proposés), tapez le nom, le SIREN, le SIRET ou le n° de TVA de l’entreprise, puis cliquez sur « Rechercher ».
3. Cliquez sur « Choisir » en face de l’entreprise voulue.
4. Le formulaire se remplit : nom, adresse, code postal, ville, pays, SIREN, SIRET, code APE, n° de TVA, téléphone, e-mail, site web, capital (selon ce que la source fournit). Une entreprise cessée est signalée.
5. Vérifiez, complétez, puis enregistrez comme d’habitude.

Hors de France, le numéro d’immatriculation de l’entreprise est repris dans le premier identifiant professionnel du tiers.

6.2 Vérifier les données d’un tiers

1. Ouvrez la fiche d’un tiers : le bouton « Vérifier les données » figure parmi les boutons d’action.
2. Si le tiers a un SIREN, un SIRET ou un n° de TVA, l’entreprise est retrouvée automatiquement. Sinon, une liste d’entreprises trouvées d’après son nom vous est proposée : choisissez la bonne.
3. La fenêtre affiche, pour chaque information, la valeur dans Dolibarr, la valeur dans la source et un état :
   • Identique : rien à faire ;
   • À compléter : le champ est vide dans Dolibarr (coché d’office) ;
   • Différent : les deux valeurs diffèrent (non coché : vous décidez).
4. Cochez ce que vous voulez reprendre puis cliquez sur « Appliquer la sélection ». La fiche se recharge avec les données enregistrées.

6.3 Les dirigeants et les contacts

Quand l’option est activée, la fenêtre de vérification liste aussi les dirigeants de l’entreprise :

• À créer : le dirigeant n’existe pas parmi les contacts du tiers (comparaison du nom et du prénom, sans tenir compte des accents ni des majuscules) ;
• Fonction à mettre à jour : le contact existe mais sa fonction est différente de celle de la source ;
• Déjà à jour : rien à faire.

À la création d’un tiers, les dirigeants trouvés sont mémorisés et créés comme contacts au moment où vous enregistrez le tiers. Un contact n’est jamais créé deux fois.

7. Limites connues et FAQ

Quelles informations obtient-on ?

Cela dépend de la source : l’API Recherche d’entreprises et l’INSEE donnent l’identité, l’adresse et l’activité ; Pappers et Creditsafe vont plus loin ; VIES ne donne que le nom et l’adresse déclarés avec le n° de TVA, et certains pays ne les communiquent pas. Les noms des dirigeants viennent de l’API Recherche d’entreprises, de Pappers, d’OpenCorporates ou de Creditsafe ; leur découpage entre nom et prénom peut demander une vérification pour les sources étrangères.

Le bouton « Vérifier les données » ou la zone de recherche n’apparaissent pas.

Vérifiez que le module est activé, que vous avez le droit « Utiliser l’assistant tiers entreprise » et qu’au moins une source est activée (avec sa clé si elle en demande une).

« Clé refusée » ou « trop de demandes ».

La clé saisie est incorrecte ou le quota du fournisseur est atteint : vérifiez-la sur le site du fournisseur. Les autres sources actives restent utilisées.

Des données sont-elles conservées chez un tiers ?

Non. Les données sont lues au moment de la recherche et enregistrées dans Dolibarr uniquement quand vous le décidez. Vos clés ne sont jamais envoyées à votre navigateur.

Belgique, Luxembourg, Allemagne, Espagne, Italie, hors Europe…

Pour ces pays, activez OpenCorporates ou Creditsafe (recherche par nom, dirigeants selon les pays) et gardez VIES pour valider le n° de TVA des pays de l’Union européenne. La couverture et la qualité des données dépendent du fournisseur et du pays.

Une question ? Assistance NSINFO au 03 70 999 730 ou sur la page Assistance.