L'intégration avec Dolibarr vous permet d'enrichir votre interface Fygr grâce à la remontée automatique de vos factures clients et fournisseurs. Une fois la connexion établie, Fygr récupère vos factures sur les 12 derniers mois et les rafraîchit à chaque synchronisation.
📖 Cette intégration s'adresse aux utilisateurs de Dolibarr en mode SaaS hébergé ou auto-hébergé, dès lors que l'API REST de Dolibarr est activée et accessible depuis Internet.
Mettre en place la connexion
Suivez les étapes ci-dessous :
Sur votre compte Fygr, cliquez sur le bonhomme en haut à droite, puis sur
Intégrations:
Cliquez sur
+ Ajouter une intégration:
Sélectionnez
Dolibarr, puis cliquez surValider:
Générez votre clé API directement dans votre compte Dolibarr (depuis la configuration de votre compte utilisateur), puis renseignez-la dans Fygr accompagnée du domaine de votre instance Dolibarr (ex :
monentreprise.dolibarr.appouerp.monentreprise.fr) :
Sélectionnez les données que vous souhaitez importer depuis
Dolibarr, puis cliquez surSynchroniser les données:
Une fois la synchronisation terminée, cliquez sur
Voir mon dashboard:
Rendez-vous dans l'onglet
Échéancespour visualiser toutes vos factures importées :
🔑 Où trouver votre clé API Dolibarr ? Dans Dolibarr, ouvrez votre fiche utilisateur, puis l'onglet Utilisateur : la clé API se génère dans la section dédiée. L'utilisateur associé à cette clé doit avoir les droits de lecture sur les tiers, les factures clients et les factures fournisseurs (et, le cas échéant, les commandes fournisseurs).
Ce qui est remonté dans Fygr
Selon les cases cochées à l'étape 5, Fygr remonte :
Les factures clients (échéances clients / 411) sur les 12 derniers mois
Les factures fournisseurs (échéances fournisseurs / 401) sur les 12 derniers mois
Le tiers associé à chaque facture (client ou fournisseur), avec son nom légal
Pour chaque facture, Fygr récupère :
Le numéro de facture et la date d'émission
La date d'échéance (et la date de paiement si la facture est soldée)
Les montants HT, TVA et TTC en multidevises (utilisation des champs multicurrency de Dolibarr)
Le restant dû, calculé comme TTC – montant déjà payé
Le statut, mappé depuis les statuts Dolibarr
📖 Correspondance des statuts Dolibarr → Fygr
Brouillon (draft, statut 0) → ignoré, la facture n'est pas remontée tant qu'elle reste en brouillon
Validée / impayée (statut 1) → En cours (ou En retard si la date d'échéance est dépassée)
Payée (statut 2) → Payée
Annulée (statut 3) → Annulée
Les factures marquées comme spécimen dans Dolibarr (factures de démonstration) sont également exclues de la synchronisation.
Bonnes pratiques pour une donnée propre dans Fygr
📅 Renseignez systématiquement la date d'échéance dans Dolibarr (champ date limite de règlement côté client, date d'échéance côté fournisseur). Sans ce champ, Fygr ne peut pas positionner correctement la facture sur votre prévisionnel de trésorerie.
🏷️ Tenez à jour les statuts. Les factures qui restent en brouillon dans Dolibarr ne remontent pas dans Fygr : si vous ne voyez pas une facture, vérifiez d'abord qu'elle est bien validée. À l'inverse, une facture passée en statut Payée côté Dolibarr disparaît automatiquement de vos échéances Fygr.
🔁 Volumes importants. La synchronisation traite jusqu'à environ 5 000 factures par catégorie (clients / fournisseurs) à chaque rafraîchissement. Si votre volume dépasse ce seuil, contactez le support pour qu'on cale ensemble la stratégie d'import la plus adaptée.
Intégrations sur-mesure
⚙️ Certaines configurations Dolibarr sortent du cadre standard décrit ci-dessus : utilisation des commandes fournisseurs (supplier orders) à la place des factures fournisseurs comme source d'engagement de dépense, exploitation de champs personnalisés (extrafields) propres à votre instance pour véhiculer des informations métier (numéro de projet, code analytique, libellé enrichi…), ou règles de mapping spécifiques.
Ces cas sont gérables : Fygr peut configurer une intégration sur-mesure adaptée à votre instance. Pour cela, prenez contact avec votre référent Fygr ou avec le support en décrivant brièvement votre besoin et nous reviendrons vers vous avec une proposition.
Besoin d'aide ? N'hésitez pas à contacter notre équipe support :
📞 01 76 50 33 88
📧 [email protected]
📝 contactez-nous via le chat