Une API (interface de programmation) permet à deux logiciels d’échanger des données sans intervention humaine. Côté comptabilité, elle sert à faire entrer automatiquement dans le dossier ce que produisent les autres outils de l’entreprise : ventes d’un webshop, tickets de caisse, factures émises par un CRM, notes de frais, paie. Bien conçue, elle supprime la ressaisie. Mal conçue, elle déverse chaque nuit des écritures fausses que personne ne relit.
Ce qu’une API comptable fait, et ce qu’elle ne fait pas
| Besoin | API comptable | Autre canal |
|---|---|---|
| Envoyer le chiffre d’affaires quotidien d’un webshop | oui | |
| Créer des clients avec leur numéro d’entreprise | oui | |
| Lire les soldes clients pour un outil de relance | oui | |
| Envoyer une facture B2B à un client belge assujetti | non | Peppol, obligatoire depuis le 1er janvier 2026 |
| Importer les extraits bancaires | parfois | fichiers CODA |
| Déposer la déclaration TVA | non | Intervat |
Le point qui surprend le plus : une API ne remplace pas Peppol. Si votre CRM émet des factures à des entreprises belges, ces factures doivent partir en format structuré sur le réseau Peppol ; l’API sert ensuite à informer la comptabilité de ce qui a été facturé, ou mieux, à laisser la comptabilité émettre elle-même. Voyez comment fonctionne Peppol avant de décider quel outil est l’émetteur officiel des factures.
Détail ou synthèse
Première décision : envoie-t-on chaque transaction, ou une écriture de synthèse par jour ?
- Le détail se justifie quand chaque vente a un client identifié qui peut devoir de l’argent : facturation B2B, abonnements, location.
- La synthèse convient aux ventes au comptant à des particuliers : webshop B2C, caisse, billetterie. Le détail reste dans l’outil d’origine, qui doit pouvoir le produire en cas de contrôle.
Exemple de synthèse quotidienne d’un webshop qui vend des livres (6 %) et des accessoires (21 %), encaissés par un prestataire de paiement :
| Compte | Libellé | Débit | Crédit |
|---|---|---|---|
| 499 | Prestataire de paiement, à recevoir | 1 302 | |
| 700 | Ventes livres, 6 % | 1 000 | |
| 700 | Ventes accessoires, 21 % | 200 | |
| 451 | TVA due | 102 |
Quand le prestataire verse le montant net de ses commissions, l’écriture bancaire solde le compte d’attente et isole les frais. Les commissions de passerelle sont traitées dans frais de paiement et de passerelle.
Le contrat de données
Avant d’écrire une ligne de code, fixez par écrit ce que chaque message doit contenir. C’est ce document, plus que la technique, qui fait la qualité de l’intégration.
- Un identifiant unique de la source (numéro de commande, de ticket, de facture). La comptabilité refuse un second envoi avec le même identifiant : c’est ce qu’on appelle l’idempotence, et c’est la seule protection fiable contre les doublons quand un envoi est relancé après une coupure.
- Le code TVA, pas seulement le taux. 21 % en vente locale et 21 % en autoliquidation n’alimentent pas les mêmes grilles.
- Le compte de produit ou de charge du PCMN, ou une catégorie que la comptabilité traduit par une table de correspondance tenue à jour.
- Pour un client professionnel : le numéro d’entreprise BCE et le numéro de TVA, validés à la source.
- La date de l’opération, distincte de la date d’envoi. Une vente du 31 mars envoyée le 1er avril appartient au premier trimestre.
Erreurs, rejets et reprises
Une intégration tourne bien neuf jours sur dix. Le dixième, un taux manque, un client n’existe pas, le serveur est indisponible. Exigez :
- un rejet explicite des messages invalides, avec la raison, plutôt qu’une écriture passée sur un compte par défaut ;
- une file des rejets consultable par le comptable, avec possibilité de corriger et renvoyer ;
- un rapprochement quotidien des totaux : chiffre d’affaires de la source = total des écritures reçues pour la même date.
Ce dernier contrôle est le plus utile de tous. Un écart de quelques euros révèle une commande annulée mal traitée ; un écart d’une journée entière révèle un envoi perdu.
Sécurité des clés
Chaque intégration reçoit sa propre clé ou son propre jeton d’accès, limité à ce qu’elle doit faire : le webshop peut créer des ventes, pas lire la paie. Une clé ne se partage pas par e-mail, ne se colle pas dans un tableur, et se révoque le jour où l’outil est abandonné. Les principes généraux sont les mêmes que pour les personnes ; voyez la sécurité des accès comptables.
Par où commencer
Choisissez le flux qui coûte le plus de ressaisie, souvent les ventes en ligne ou la caisse. Faites-le tourner un mois en parallèle de la méthode actuelle, comparez les totaux semaine par semaine, puis seulement coupez l’ancienne méthode. Avant de brancher quoi que ce soit, assurez-vous que les fiches clients et le plan comptable sont propres : une API reproduit fidèlement les erreurs qu’on lui donne, voir le nettoyage des données avant automatisation.