Retour à la configuration

Connecter votre Dolibarr à ErpGent

Deux informations suffisent : l'URL de votre Dolibarr et votre clé API. Voici comment les trouver en 3 étapes.

1

Trouver l'URL de votre Dolibarr

C'est l'adresse que vous tapez dans votre navigateur pour accéder à Dolibarr. Copiez-la sans le chemin final (sans /index.php).

Exemples valides :

https://erp.monentreprise.fr

https://monserveur.com/dolibarr

http://192.168.1.10:8080

2

Activer le module API RESTPré-requis indispensable

Sans ce module activé, Dolibarr n'expose aucune API et l'onglet de génération de clé n'apparaîtra même pas dans votre profil. À faire avant l'étape 3.

  1. aConnectez-vous à Dolibarr en tant qu'administrateur
  2. bAllez dans Configuration → Modules/Applications
  3. cOnglet Interfaces avec systèmes externes (ou cherchez « API » dans la barre de recherche)
  4. dTrouvez API REST (services web) et cliquez sur le bouton Activer. L'icône doit passer au vert.
Chemin dans Dolibarr :
Configuration → Modules/Applications → API REST (services web) → Activer
✓ Test rapide : Ouvrez dans votre navigateur https://votre-dolibarr.com/api/index.php/status. Si vous voyez du JSON, le module est bien activé.
3

Générer votre clé API Dolibarr

Une fois le module API REST activé (étape 2), naviguez jusqu'à votre profil utilisateur :

  1. aCliquez sur votre avatar / nom en haut à droite de Dolibarr
  2. bSélectionnez Mon profil (ou Configuration utilisateur)
  3. cCliquez sur l'onglet Modifier, puis descendez jusqu'à la section Accès API / Services web
  4. dSi le champ est vide, cliquez sur Générer. Copiez le token affiché — c'est votre clé API.
Chemin dans Dolibarr :
Avatar → Mon profil → Modifier → Accès API / Services web → Générer
ℹ️ Vous ne voyez pas la section « Accès API » ? C'est que le module API REST n'est pas activé. Retournez à l'étape 2.

Problèmes fréquents

❌ "Connexion refusée" ou timeout

Vérifiez que l'URL est accessible depuis internet (et non seulement depuis votre réseau local). Pour un Dolibarr en local, un tunnel comme ngrok est nécessaire.

❌ "Clé API invalide"

Régénérez la clé dans Dolibarr (profil → Accès API → Générer) et assurez-vous de l'avoir copiée entièrement.

❌ "API REST non activée"

Activez le module API REST dans Configuration → Modules/Applications. Dolibarr 16+ l'inclut nativement.

Retour à la connexionModifier dans les paramètres