Que sont les Écritures Comptables Manuelles ?
Les écritures comptables manuelles sont des transactions comptables créées directement par les utilisateurs disposant de l’autorisationledger:write, au lieu d’être générées automatiquement par les opérations standard (dépôts, prêts, dépenses, dividendes). Elles servent aux ajustements, corrections, charges à payer, produits à recevoir et transactions spéciales.
Quand Utiliser les Écritures Manuelles
Cas d’utilisation valides : Ajustements Comptables :- Amortissement : Amortissement mensuel des immobilisations
- Charges/produits à recevoir : Enregistrer un revenu gagné ou une dépense engagée mais pas encore payé(e)
- Produits/dépenses constatés d’avance : Dépenses prépayées ou revenus non encore gagnés
- Passages en pertes : Créances douteuses, cessions d’actifs
- Reclassements : Corriger des transactions mal classées
- Correction d’erreurs : Corriger des transactions publiées incorrectement
- Ajustements de soldes : Rapprocher des écarts
- Configuration initiale : Enregistrer les soldes de départ lors d’une migration vers Agatabo
- Initialisation des comptes : Créer des comptes avec des soldes historiques
- Événements ponctuels : Transactions sans fonctionnalité dédiée dans Agatabo
- Allocations complexes : Répartitions sur plusieurs comptes
- ❌ Dépôts des membres (utilisez la fonctionnalité Dépôts)
- ❌ Décaissements ou paiements de prêts (utilisez la fonctionnalité Prêts)
- ❌ Dépenses opérationnelles (utilisez la fonctionnalité Dépenses)
- ❌ Distributions de dividendes (utilisez la fonctionnalité Dividendes)
- ❌ Allocations de réserves (utilisez la fonctionnalité Réserves)
Point d’Accès API
Créer une écriture comptable manuelle :Prérequis
Exigences :Autorisations :
- Autorisation
ledger:write(généralement Comptable ou Administrateur)
- Compréhension de la comptabilité en partie double
- Connaissance des règles de débit et de crédit
- Familiarité avec le plan comptable de l’organisation
- Approbation de l’ajustement (si requise par la politique interne)
- Documents justificatifs (reçus, mémos, rapports de rapprochement)
- Explication claire de l’objectif
- La date de transaction doit se trouver dans une période comptable ouverte
- Clé d’idempotence pour chaque requête (empêche les doublons)
Règles de Validation
Champs obligatoires :- En-tête x-idempotency-key : Empêche les écritures en double
- lines : Au moins une ligne d’écriture (généralement 2+ pour une écriture équilibrée)
- ledgerAccountId : UUID valide pour chaque ligne
- side : Doit être “DEBIT” ou “CREDIT”
- amount : Doit être ≥ 0.01 avec maximum 2 décimales
- Le total des débits doit égaler le total des crédits : Appliqué automatiquement
- Les écritures non équilibrées sont rejetées
- Montant minimum : 0.01 (1 centime dans une devise fractionnaire)
- Décimales : Maximum 2
- Aucun montant négatif : Utilisez le côté opposé à la place (ex. utilisez CREDIT pour diminuer un actif, pas un DEBIT négatif)
- Les comptes doivent exister : Tous les ledgerAccountIds doivent être valides
- Les comptes doivent appartenir à l’organisation : Impossible d’utiliser les comptes d’autres organisations
- Les comptes doivent être actifs : Les comptes inactifs ne peuvent pas être utilisés
- Les comptes doivent être accessibles : L’utilisateur doit avoir l’autorisation de publier sur ces comptes
- Date de transaction : Doit être au format ISO (YYYY-MM-DD)
- Période ouverte uniquement : Impossible de publier dans des périodes comptables clôturées
- Pas de dates futures : La date ne peut pas être postérieure à aujourd’hui (sauf configuration contraire)
- L’en-tête x-idempotency-key est obligatoire : La requête échoue sans lui
- La même clé retourne l’écriture existante : Les tentatives peuvent être répétées sans risque
- Unique par organisation : La même clé peut exister dans différentes organisations
Créer une Écriture Comptable Manuelle
Avec l’API
Exemple 1 : Enregistrer une dépense d’amortissementStructure de l’Écriture Comptable
Écriture comptable créée :Exemples Courants d’Écritures Manuelles
1. Amortissement Mensuel
Objectif : Enregistrer la dépense d’amortissement mensuelle des immobilisations2. Corriger une Erreur Publiée
Objectif : Un dépôt de membre a été enregistré sur le mauvais membre Écriture originale (incorrecte) :3. Revenu d’Intérêt Couru
Objectif : Enregistrer un intérêt gagné mais pas encore reçu4. Soldes d’Ouverture
Objectif : Enregistrer les soldes initiaux au démarrage d’Agatabo5. Passer une Créance Douteuse en Perte
Objectif : Passer en perte un prêt irrécouvrable6. Dépense Prépayée
Objectif : Enregistrer le paiement d’un service futur (ex. assurance pour 12 mois)7. Reclasser une Dépense
Objectif : Déplacer une dépense d’une catégorie vers une autreBonnes Pratiques
Directives pour les écritures comptables manuelles :Avant de Créer :
- ✅ Vérifiez que la transaction ne peut pas être enregistrée via les fonctionnalités standard
- ✅ Obtenez l’approbation du superviseur ou du comptable (si requis par la politique)
- ✅ Préparez les documents justificatifs
- ✅ Rédigez d’abord l’écriture sur papier et vérifiez l’équilibre
- ✅ Confirmez que la date de transaction est dans une période comptable ouverte
- ✅ Générez une clé d’idempotence unique
- ✅ Rédigez une description claire et détaillée (comme si vous l’expliquiez à un auditeur)
- ✅ Référencez la transaction originale si vous corrigez une erreur
- ✅ Joignez les documents justificatifs
- ✅ Vérifiez soigneusement les comptes sélectionnés
- ✅ Vérifiez les montants et les côtés (DEBIT vs CREDIT)
- ✅ Confirmez que l’écriture est équilibrée avant publication
- ✅ Examinez immédiatement l’écriture publiée
- ✅ Conservez la clé d’idempotence pour référence future
- ✅ Documentez la raison dans les dossiers comptables
- ✅ Informez les parties prenantes concernées
- ✅ Gardez des copies de tous les documents justificatifs
- ✅ Rapportez chaque mois toutes les écritures manuelles à la direction
- ✅ Longueur minimale de la description : 10 caractères (recommandé : 50-200 caractères)
- ✅ Incluez le “pourquoi”, pas seulement le “quoi” (ex. “Correction - dépôt affecté au mauvais membre à cause d’une similarité de nom” et pas seulement “Correction”)
- ✅ Référencez les IDs des transactions originales lors de corrections d’erreurs
- ✅ Utilisez un format de date cohérent (ISO : YYYY-MM-DD)
- ✅ Joignez les mémos, rapports de rapprochement ou documents d’approbation
Restrictions et Limites
Impossible de créer des écritures manuelles pour : Périodes clôturées :- ❌ Date de transaction dans une période comptable clôturée
- ✅ Créez dans la période ouverte actuelle avec une description qui référence la période précédente
- ❌ Comptes inexistants
- ❌ Comptes d’autres organisations
- ❌ Comptes inactifs
- ✅ Utilisez uniquement les comptes actifs de votre organisation
- ⚠️ Certains comptes peuvent être restreints (le système rejettera si non autorisé)
- ⚠️ Vérifiez que vous avez l’autorisation de publier sur les comptes cibles
- ❌ Total des débits ≠ total des crédits
- ✅ Vérifiez toujours l’équilibre avant publication
- ❌ Les montants négatifs ne sont pas autorisés
- ✅ Utilisez plutôt le côté opposé (CREDIT pour diminuer un actif, pas un DEBIT négatif)
- ❌ Une fois publiées, les écritures manuelles sont permanentes
- ✅ Pour corriger, créez une écriture d’annulation ou une nouvelle écriture corrective
Corriger les Écritures Manuelles
Les écritures comptables manuelles sont permanentes une fois publiées. Pour corriger :Méthode 1 : Créer une Écriture d’Annulation
Créez une écriture qui annule l’originale : Originale (incorrecte) :Méthode 2 : Créer une Écriture Corrective
Si seule une partie de l’écriture est incorrecte, créez un ajustement : Originale (incorrecte) :Flux d’Approbation (Recommandé)
Bien qu’Agatabo n’impose pas de flux d’approbation, les organisations doivent établir des contrôles internes :
Mise en oeuvre :
- Générez la clé d’idempotence après approbation
- Incluez la référence d’approbation dans la description
- Joignez le mémo d’approbation comme document
Considérations d’Audit
Les écritures manuelles reçoivent une attention particulière des auditeurs : Attentes des auditeurs :- ✅ Justification métier claire pour chaque écriture
- ✅ Documents justificatifs (mémos, rapprochements, approbations)
- ✅ Fréquence raisonnable (trop d’écritures manuelles indiquent des contrôles faibles)
- ✅ Autorisation et piste d’approbation appropriées
- ✅ Descriptions exactes et complètes
- ✅ Écritures équilibrées (aucune exception)
- 🚩 Trop d’écritures manuelles (suggère des contrôles internes faibles)
- 🚩 Écritures à montants ronds sans documentation
- 🚩 Écritures manuelles proches de la fin de période
- 🚩 Descriptions vagues (“Ajustement”, “Correction” sans détail)
- 🚩 Écritures manuelles qui annulent des transactions de périodes antérieures
- 🚩 Grandes écritures manuelles sans documentation d’approbation
- ✅ Documentez la raison de l’écriture manuelle (pourquoi pas une fonctionnalité standard ?)
- ✅ Référencez les documents justificatifs (rapports de rapprochement, mémos, factures)
- ✅ Maintenez une piste d’approbation (emails, formulaires, procès-verbaux)
- ✅ Exportez chaque mois un rapport des écritures manuelles pour revue
- ✅ Conservez des copies de tous les documents justificatifs pour l’audit
Erreurs Courantes et Prévention
1. Écriture Non Équilibrée
Erreur : Total des débits ≠ total des crédits Exemple (incorrect) :- Vérifiez toujours que le total des débits = le total des crédits avant publication
- Le système rejette automatiquement les écritures non équilibrées
- Rédigez d’abord l’écriture sur papier avec des totaux progressifs
2. Mauvais Choix de Compte
Erreur : Sélectionner CASH alors que vous vouliez sélectionner BANK_ACCOUNT Prévention :- Examinez attentivement les comptes sélectionnés
- Utilisez la recherche pour trouver le bon compte
- Vérifiez le rôle et le type du compte avant publication
- Revérifiez les comptes propres à un membre (épargne, prêts)
3. Mauvais Côté (Débit vs Crédit)
Erreur : Enregistrer un DEBIT alors que cela devrait être un CREDIT Exemple (incorrect) :- Revoyez les règles de partie double : Comprendre la Partie Double
- Rappelez-vous l’aide-mémoire DEALER (Débits : Dépenses, Actifs, Pertes augmentent ; Crédits : Capitaux propres, Passifs, Revenus augmentent)
- Réfléchissez à la logique de l’écriture comptable avant publication
4. Description Peu Claire
Erreur : “Ajustement” ou “Correction” sans détail Exemple (incorrect) :- Rédigez la description comme si vous l’expliquiez à un auditeur
- Incluez quoi, pourquoi, qui, quand, et une référence à la transaction originale
- Utilisez 50-200 caractères minimum pour une explication utile
5. Publication dans une Période Clôturée
Erreur : Essayer de publier une écriture avec une date de transaction dans une période clôturée Message d’erreur :- Vérifiez le statut de la période comptable avant de créer l’écriture
- Utilisez une date de transaction de la période actuelle pour les corrections de périodes antérieures
- Référencez la période antérieure dans la description
6. Clé d’Idempotence Manquante
Erreur : Ne pas inclure l’en-tête x-idempotency-key Message d’erreur :- Incluez toujours l’en-tête x-idempotency-key
- Générez une clé unique pour chaque écriture (ex. depreciation-jun-2026, correction-)
- Conservez la clé d’idempotence pour référence future
Idempotence
Les écritures comptables manuelles exigent une clé d’idempotence pour empêcher les doublons. Fonctionnement :- Fournissez l’en-tête
x-idempotency-keyavec une valeur unique - Si la même clé est utilisée deux fois dans la même organisation, la deuxième requête retourne l’écriture existante
- Vous pouvez réessayer les requêtes échouées sans créer de doublons
- Différentes organisations peuvent utiliser la même clé (portée à l’organisation)
Sujets Connexes
Comprendre la Partie Double
Apprendre les débits, crédits et principes comptables
Comptes du Grand Livre
Voir les comptes disponibles et le plan comptable
Rôles du Grand Livre
Comprendre les rôles et types de comptes
Consultation des Écritures Comptables
Examiner les écritures publiées et la piste d’audit
Périodes Comptables
Comprendre la clôture de période et les contraintes
Annulation d'Écritures
Apprendre comment annuler les écritures publiées