Connecter Dolibarr à Billy
Temps nécessaire : ± 5 minutes
Sommaire
- Assurer vous d'avoir activé le module API
- Assurez-vous de ne pas restreindre l'accès à certains adresses IP
- Connecter Dolibarr
Assurez-vous d'avoir activé le module API
- Sélectionner le menu Accueil
- Sélectionner le menu Configuration
- Sélectionner le menu Configuration - Modules/Applications
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/650d7a9c9446233b9352825c/file-0tqrzrHTAk.png)
- Activez le module "API/Web services (serveur REST), Active le server REST Dolibarr fournissant des services API" si ce n'est pas déjà fait
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/650d7ab7638c3422caf9cb32/file-T0zlX9gcCx.png)
Assurez-vous de ne pas restreindre l'accès à certains adresses IP
- Sélectionner la roue crantée sur la carte API/WEB SERVICES
- Assurez-vous que le champ "Autorise l'accès à l'API à certaines IP de clients seulement" soit vide
Billy 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
- Se connecter à Dolibarr
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/64df0c66e3ee466b38a4da8b/file-kkiDoXUVmX.png)
- Sélectionner le menu Utilisateur représenté par une photo de profil
- Sélectionner Fiche
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/64df0c78a38c7c2a1bc5f561/file-MkJvzS6YGX.png)
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é.
- Sélectionner l'onglet Permissions
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/64df09a923f94575804bc01c/file-ldaqE9xyOA.png)
- Assurer-vous sur l'utilisateur a les permissions suivantes
Tiers | Consulter 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). |
Tiers | Consulter les contacts |
Factures et avoirs | Consulter les factures clients |
Fournisseurs | Consulter les fournisseurs |
Fournisseurs | Consulter les factures fournisseur |
Produits | Consulter les produits |
Services | Consulter les services |
- Sélectionner l'onglet Utilisateur
- Survoler le terme Caché de la Clé pour l’API
- Sélectionner l'icône copier pour copier dans le presse-papier
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/64df0ca6b73292711b9800f7/file-sfHXla0SYZ.png)
- Si vous ne voyez pas de Clé pour l'API, sélectionner Modifier
- Sélectionner l'icône Générer représenté par une flèche qui tourne
- Copier la clé pour l'API dans le presse-papier
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/650d7aef94b9d62c532e2b7d/file-Z5ioniGcTT.png)
- Sélectionne le bouton Enregistrer
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/650d7b36638c3422caf9cb34/file-jn3U76ZBUj.png)
- Coller la clé dans le champ Clé d’API sur la page Configurer mon intégration sur Billy
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/646de1b906d1de0f8f3de68f/file-o0Qj8YW3pS.png)
- Copier l'URL du site
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/64df0d4dfb285068c0d4d4e7/file-JHLpIdiqIu.png)
- Coller l'URL du site dans le champ URL du site sur la page Configurer mon intégration de Billy
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.
![](http://d33v4339jhl8k0.cloudfront.net/docs/assets/6447ce24309b700c9399a7df/images/646de1dc4089fa4863e22c22/file-dM4Puaaw9X.png)
- Sélectionner le bouton Connecter