Si votre agence utilise QuickBooks pour sa comptabilité, vous pouvez connecter les deux outils via l’API Ezus. Chacun garde son rôle :
Ezus reste la référence pour vos données commerciales : clients, fournisseurs, projets, devis, marges et factures.
QuickBooks reste la référence pour la comptabilité et la trésorerie : grand livre, TVA, rapprochement bancaire et reporting financier.
La connexion repose sur un connecteur (développement sur mesure ou plateforme d’intégration) qui fait circuler les données entre les deux outils.
Ce qui est synchronisé
D’Ezus vers QuickBooks :
vos clients et fournisseurs ;
vos factures de ventes et factures d’avoir ;
vos factures fournisseurs, avec leur PDF.
De QuickBooks vers Ezus :
les paiements reçus de vos clients ;
les paiements effectués à vos fournisseurs.
💡 Chaque facture est rattachée à son projet Ezus. Vos projets peuvent ainsi être associés à des projets ou des classes dans QuickBooks pour suivre la rentabilité par dossier.
Côté ventes : de la facture finalisée au paiement
Dans Ezus : vous finalisez une facture de vente ou une facture d’avoir sur un projet.
Le connecteur récupère la facture : lignes, TVA, totaux, lien vers le PDF et informations client.
Dans QuickBooks : le client est retrouvé (ou créé), puis la facture est enregistrée avec son PDF en pièce jointe.
Dans Ezus : les paiements reçus remontent sur le projet et la facture passe au statut payée.
Côté achats : de la facture fournisseur au règlement
Dans Ezus : vous rattachez le PDF d’une facture fournisseur à son projet et à son fournisseur.
Le connecteur récupère la facture : montants, date d’échéance, lien vers le PDF et informations fournisseur.
Dans QuickBooks : le fournisseur est retrouvé (ou créé), puis la facture fournisseur est enregistrée avec son PDF.
Dans Ezus : les règlements effectués dans QuickBooks mettent à jour la facture fournisseur.
Pour les intégrateurs : détails techniques
Chaque flux s’appuie sur un endpoint existant de l’API Ezus :
Flux | Sens | Objet QuickBooks | Route Ezus |
Clients | Vers QuickBooks |
|
|
Factures et avoirs | Vers QuickBooks |
|
|
Paiements clients | Vers Ezus |
|
|
Fournisseurs | Vers QuickBooks |
|
|
Factures fournisseurs | Vers QuickBooks |
|
|
Paiements fournisseurs | Vers Ezus |
|
|
💡 Pour récupérer une facture, procédez en deux appels. La route au pluriel (/invoices) renvoie la liste des factures et permet d’identifier celles à transmettre, par exemple avec le filtre ?stage=completed. La route au singulier (/invoice) renvoie ensuite le détail complet d’une facture : lignes, TVA, totaux, lien vers le PDF.
Le même principe s’applique aux factures fournisseurs, aux clients et aux fournisseurs.
Les flux inverses sont également possibles : clients, fournisseurs et factures fournisseurs peuvent être créés depuis QuickBooks grâce aux routes d’upsert correspondantes.
Côté ventes, la mise à jour du statut de la facture se fait via PUT /invoices-update.
Principes de conception :
Aucun doublon : chaque écriture est un upsert sur une référence de votre choix, avec des modes stricts de création et de mise à jour.
Accès durable : en plus de la clé API, des jetons de rafraîchissement sont valables 90 jours et renouvelés à chaque utilisation.
Synchronisation à votre rythme : en temps réel, planifiée ou déclenchée par un événement, selon les fréquences décrites plus haut dans cet article.
Enregistrements liés : les identifiants QuickBooks peuvent être stockés dans les champs personnalisés Ezus des clients, fournisseurs et factures.
Documentation : référence publique sur api.ezus.io.
Mise en place
Cadrage : identifiez votre édition de QuickBooks, les flux à activer et vos règles de TVA et de devises.
Accès API : récupérez votre clé API depuis Paramètres > Développeurs.
Développement et tests : associez vos comptes comptables et vos codes de TVA, puis testez les flux sur de vrais projets.
Mise en production : activez la synchronisation sur votre compte de production et contrôlez attentivement votre première clôture mensuelle..
💡 À venir : plusieurs évolutions de l’API sont prévues pour faciliter ce type de connecteur. Elles incluent l’authentification OAuth en un clic, la synchronisation différentielle, de nouveaux webhooks signés, l’affectation d’un paiement à une facture précise, les codes comptables et de TVA par ligne, le multi-devises et un environnement sandbox. Nous mettrons cet article à jour au fil de leur disponibilité.