Acomba GO : les comptes GL n'ont pas de solde par période
Le connecteur Acomba GO est en cours de validation contre l'API ACCEO Connecté (automne 2026). Cette page décrit une caractéristique d'Acomba GO lui-même, qui restera vraie quelle que soit la version du connecteur. Pour la disponibilité des entités, voir Acomba GO est-il supporté ?.
Réponse courte
Oui, c'est vrai : dans Acomba GO, le solde par période n'existe pas. Il n'y a ni soldes stockés sur le compte, ni périodes comptables (12 ou 13 périodes, fermeture par période) comme dans Acomba. Il y a un exercice financier (date de début, date de fin, verrou), et des écritures. Le solde d'un compte à une date donnée est une valeur dérivée : écriture d'ouverture + somme des écritures jusqu'à cette date.
C'est exactement le modèle de QuickBooks Online : pas de périodes, une « date de clôture » qui verrouille, et des rapports (bilan, balance de vérification) recalculés à la volée à partir des transactions.
Ce que l'API ACCEO Connecté expose
| Concept dans Acomba | Dans Acomba GO (API ACCEO Connecté) |
|---|---|
| Solde par compte par période (année courante, année précédente, budgets) | Rien. Le compte (account) porte son numéro, son nom, sa catégorie et sa sous-catégorie, les prochains numéros de chèque et de dépôt, et sa répartition. Aucun champ de solde. |
| Périodes comptables (nombre de périodes, fermeture par période) | Rien. L'exercice (exercise) porte une description, une date de début, une date de fin et un verrou. Pas de sous-découpage. |
| Fermeture de période | Seulement le verrou de l'exercice (isLock). |
| Solde à une date | Se calcule : écriture d'ouverture + somme des écritures (gltransaction) jusqu'à la date. |
Validé contre l'API réelle (septembre 2026). Aucun point d'entrée « rapport » ou « balance de vérification » n'est exposé par ACCEO Connecté.
Conséquences dans ERPConnector
Sur GET /api/Entity/GLAccount, avec Acomba GO, le contrat reste le même qu'avec Acomba —
mais les soldes par période sont calculés au lieu d'être lus :
- Avec
$expand=AnneeCourante(et/ouAnneePrécédente), le connecteur relit toutes les écritures et reconstitue les 14 valeurs de la convention Acomba : période 0 = solde d'ouverture de l'exercice (tout ce qui est daté avant son début, écriture d'ouverture comprise), période n = mouvement net du n‑ième mois de l'exercice. Le solde à la fin de la période 6 est donc la somme des périodes 0 à 6, exactement comme dans Acomba. - L'exercice courant est celui qui contient la date du jour ; l'exercice précédent, celui qui se termine juste avant. Acomba GO n'ayant pas de périodes, ce sont des mois ; un exercice court laisse les périodes manquantes à 0.
- Ce calcul lit toutes les écritures : demandez l'expand seulement quand vous en avez besoin, et conservez le résultat plutôt que de le recalculer à chaque appel.
- Le filtre
ValeurAuCompte ne 0fonctionne avec l'expand (comptes ayant au moins une période non nulle) et n'a aucun effet sans lui. Budget01..03restent vides : les budgets n'existent pas dans Acomba GO.- Les autres champs de la fiche (
NoCompteGL,NomCompteGL,TypeDeCompte,Fiche_DerniereModification, lignes d'allocation) sont alimentés normalement.
Obtenir un solde à une date quelconque
Pour une date qui ne tombe pas sur une fin de période, ou pour refaire le calcul vous-même, passez
par les écritures, entité GLJournalEntry (gltransaction dans Acomba GO) :
- Extrayez les écritures de la plage voulue avec un filtre sur la date, par exemple
$filter=DateEcriture ge '2026-01-01' and DateEcriture le '2026-01-31'. - Regroupez les lignes par
NoCompteGLet sommez débits et crédits : c'est le mouvement de la période. - Le solde à une date = mouvement cumulé depuis le début du premier exercice. L'écriture d'ouverture d'Acomba GO (une seule par entreprise, datée la veille du premier exercice) est une écriture comme les autres et fait partie de la somme.
Ce calcul est le même que celui qu'Acomba GO fait pour ses propres rapports. Il demande de lire toutes les écritures de la plage : sur une entreprise volumineuse, pensez à conserver le résultat plutôt que de le recalculer à chaque appel.
Une facture, un achat, un encaissement ou un paiement n'apparaît dans les écritures qu'une fois
transféré au Grand Livre dans Acomba GO (champ isTransferred). Tant qu'il ne l'est pas, il
est absent du calcul — le solde obtenu est alors celui des écritures transférées, pas celui de
tous les documents saisis. Les inscriptions comptables (CustomerARInvoice, SupplierARInvoice),
elles, sont transférées d'office.
Si vous migrez d'Acomba vers Acomba GO
Puisque les soldes ne se transfèrent pas, ils se reconstituent :
- Choisissez la date de coupure. Au début d'un exercice, c'est le cas propre : l'écriture d'ouverture ne porte que le bilan (actif, passif, capitaux), les revenus et dépenses de l'exercice fermé sont déjà nets dans les bénéfices non répartis, et il n'y a aucun historique à rejouer. En cours d'exercice, ajoutez une écriture sommaire par période Acomba (le mouvement net par compte, pris des soldes par période d'Acomba) : Acomba GO retrouve ainsi les mêmes mouvements mensuels, sans rejouer chaque facture.
- L'écriture d'ouverture est unique. Acomba GO n'en accepte qu'une par entreprise ; elle n'a pas de date (Acomba GO la place la veille du premier exercice) et doit balancer.
- Ne comptez pas deux fois les comptes clients et fournisseurs. Si l'écriture d'ouverture met le solde des comptes clients et que les factures ouvertes sont recréées, le compte de contrôle double. Passez les soldes clients / fournisseurs de l'ouverture par un compte de transit « Soldes d'ouverture », puis créez les documents ouverts avec ce compte de transit en contrepartie : le transit revient à zéro, le sous-grand-livre est peuplé, le compte de contrôle est juste.
- L'inventaire se reprend en deux morceaux. La valeur du stock va dans l'écriture
d'ouverture (compte d'inventaire) ; les quantités se posent sur chaque produit
(
Inventaire_QteEnMain), ce qui ne génère aucune écriture dans Acomba GO — pas de double compte possible. - Validez par le calcul. Pour chaque compte : solde Acomba à la date de coupure contre ouverture + somme des écritures Acomba GO à la même date. C'est le rapport d'écart de la migration.