CE QUE J’AI FAIT
En utilisant l’API Abby, j’ai traité trois mois de comptabilité d’un coup : 79 dépenses annotées et 61 justificatifs attachés, en une journée là où la saisie manuelle m’aurait pris plusieurs jours.
Mais pour y arriver, j’ai dû reconstituer par rétro-ingénierie trois choses qui ne sont pas documentées. Ce sont elles qui empêchent aujourd’hui n’importe quel indépendant un peu technique d’automatiser son livre des achats sans tâtonner.
Aucune des trois ne demande de développement lourd : il s’agit surtout de documentation.
———
POINT 1 — LES IDENTIFIANTS DE TVA (vatId) NE SONT DOCUMENTÉS NULLE PART
Sur les ventilations du livre des achats, le champ vatId est un simple nombre, sans liste de valeurs. Les codes documentés côté produits (FR_2000, FR_00UE…) ne s’y appliquent pas.
J’ai dû reconstituer la table en analysant mes ventilations existantes, puis en saisissant un justificatif dans l’interface pour relire la valeur enregistrée. Ce que j’obtiens :
vatId 1 = 20 % (taux normal)
vatId 2 = 10 % (taux intermédiaire)
vatId 3 = 5,5 % (taux réduit)
vatId 4 = 2,1 % (taux super-réduit)
vatId 5 = 0 % (hors taxe)
vatId 7 = 20 % (Union Européenne)
vatId 8 = 20 % (hors UE)
Il me manque encore la valeur du taux 8,5 % (DOM-TOM).
Ce qui aiderait : un tableau dans la documentation, ou mieux, un endpoint de référentiel. Cela éviterait ce travail à tous ceux qui suivront.
———
POINT 2 — AUCUN ENDPOINT FOURNISSEUR N’EST DOCUMENTÉ
Créer une dépense exige un identifiant de tiers, mais rien dans la documentation ne permet de lister ni de créer un fournisseur.
C’est le point le plus bloquant : rattacher une dépense à un fournisseur est l’un des gestes les plus courants de la tenue comptable, et il n’existe aujourd’hui aucun moyen officiel de le faire par l’API.
———
POINT 3 — ATTACHER UN JUSTIFICATIF DEMANDE UNE SÉQUENCE NON DOCUMENTÉE
L’opération fonctionne, mais en trois appels enchaînés dont l’ordre et le rôle ne se devinent pas.
Ce qui aiderait : un endpoint unique acceptant directement le fichier. À défaut, documenter la séquence suffirait.
———
UNE REMARQUE TRANSVERSE
Plusieurs écritures renvoient un code de succès alors que rien n’est enregistré. Cela oblige à relire systématiquement après chaque appel. Des erreurs explicites nommant le champ fautif rendraient l’API bien plus sûre à automatiser.
———
POURQUOI CELA COMPTE
Pour un indépendant avec plusieurs dizaines de factures par mois, ce sont des heures récurrentes sur un travail entièrement mécanisable.
L’API est déjà bien conçue : il lui manque peu de chose pour couvrir tout le cycle comptable sans intervention manuelle.
