Temps nécessaire : ± 5 minutes

Sommaire

  • S’assurer d’avoir activé le module API

  • S’assurer de ne pas restreindre l’accès à certaines adresses IP

  • Connecter Dolibarr


S’assurer d’avoir activé le module API

1

Sélectionner le menu “Accueil“

2

Sélectionner le menu “Configuration“

3

Sélectionner le menu “Configuration - Modules/Applications“

Page Configuration Dolibarr

4

Activer le module “API/Web services (serveur REST)“ (si ce n'est pas déjà fait)

Page Module/Applications

S’assurer de ne pas restreindre l’accès à certaines adresses IP

1

Sélectionner la roue crantée sur la carte “API/WEB SERVICES“

Page d'accueil

2

S'assurer que le champ “Autorise l'accès à l'API à certaines IP de clients seulement“ soit vide

Page d'accueil

HeyBilly by Pennylane n’est pas compatible avec cette protection par adresse IP, car le service utilise une multitude d’adresses IP à travers une architecture dites “sans serveur”.

Connecter Dolibarr

1

Se connecter à Dolibarr

Page Connexion Dolibarr

2

Sélectionner le menu Utilisateur représenté par une photo de profil

3

Sélectionner le bouton “Fiche“

Page d'accueil

Il est recommandé de créer un utilisateur dédié à l’intégration et ne pas utiliser le compte administrateur pour des raisons de sécurité.
4

Sélectionner l'onglet Permissions

Page Permissions

5

S'assurer que l'utilisateur a les permissions suivantes :

ObjetDroit
TiersConsulter les tiers (sociétés) liés à l’utilisateur.
TiersÉtendre l’accès à tous les tiers ET leurs objets (pas seulement ceux dont l’utilisateur est enregistré en tant que commercial).
TiersConsulter les contacts
Factures et avoirsConsulter les factures clients
FournisseursConsulter les fournisseurs
FournisseursConsulter les factures fournisseur
ProduitsConsulter les produits
ServicesConsulter les services
6

Sélectionner l'onglet “Utilisateur“

7

Sélectionner le bouton “Modifier et vérifier que l'utilisateur est administrateur“

Onglet Utilisateur

8

Survoler le texte “Caché“ de la “Clé pour l’API“

9

Sélectionner l'icône Copier pour copier dans le presse-papier

Onglet Utilisateur

Si vous ne voyez pas de Clé pour l’API, suivez les étapes suivantes à la place :

  1. Sélectionner le bouton “Modifier“”

  2. Sélectionner l’icône Générer (représentée par une flèche qui tourne)”

  3. Copier la clé pour l’API dans le presse-papier

Page Modifier un utilisateur

10

Sélectionner le bouton “Enregistrer“

Page Modifier un utilisateur

11

Aller sur la Configuration

12

Coller la clé dans le champ “Clé d’API“

Page Configurer mon intégration - Étape Connnecter Dolibarr

13

Aller sur Dolibarr

14

Copier l'URL du site

Barre d'adresse Dolibarr

15

Aller sur la Configuration

16

Coller l'URL du site dans le champ “URL du site“

Page Configurer mon intégration - Étape Connnecter Dolibarr

Assurez-vous que votre instance et votre API sont correctement accessibles en ligne et qu’aucun mécanisme de sécurité n’entrave l’accès depuis l’extérieur.
17

Sélectionner le bouton “Connecter“