Passer au contenu principal

Que sont les Écritures Comptables Manuelles ?

Les écritures comptables manuelles sont des transactions comptables créées directement par les utilisateurs disposant de l’autorisation ledger: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.
À utiliser avec parcimonie : La plupart des transactions doivent être enregistrées via les opérations normales d’Agatabo (dépôts, prêts, dépenses, dividendes). Les écritures manuelles sont réservées aux situations exceptionnelles qui exigent une intervention comptable directe.

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
Corrections :
  • Correction d’erreurs : Corriger des transactions publiées incorrectement
  • Ajustements de soldes : Rapprocher des écarts
Soldes d’Ouverture :
  • 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
Transactions Spéciales :
  • Événements ponctuels : Transactions sans fonctionnalité dédiée dans Agatabo
  • Allocations complexes : Répartitions sur plusieurs comptes
N’utilisez PAS les écritures manuelles pour :
  • ❌ 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 :
Corps de la requête :
Structure ManualJournalLineDto :
Réponse :

Prérequis

Exigences :Autorisations :
  • Autorisation ledger:write (généralement Comptable ou Administrateur)
Connaissances :
  • 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
Documentation :
  • Approbation de l’ajustement (si requise par la politique interne)
  • Documents justificatifs (reçus, mémos, rapports de rapprochement)
  • Explication claire de l’objectif
Technique :
  • 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
Exigence d’équilibre :
  • Le total des débits doit égaler le total des crédits : Appliqué automatiquement
  • Les écritures non équilibrées sont rejetées
Contraintes de montant :
  • 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)
Contraintes de compte :
  • 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
Contraintes de date :
  • 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)
Idempotence :
  • 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’amortissement
Exemple 2 : Corriger une erreur publiée Un dépôt de membre a été crédité par erreur à John au lieu de Jane.
Exemple 3 : Enregistrer des intérêts courus
Exemple 4 : Soldes d’ouverture

Structure de l’Écriture Comptable

Écriture comptable créée :
Remarque : Les écritures comptables manuelles sont toujours POSTED immédiatement. Il n’y a pas d’état brouillon. Une fois créées, elles sont permanentes et ne peuvent pas être modifiées ou supprimées. Pour corriger, créez une écriture d’annulation.

Exemples Courants d’Écritures Manuelles

1. Amortissement Mensuel

Objectif : Enregistrer la dépense d’amortissement mensuelle des immobilisations
Effet : La dépense réduit le résultat net, l’amortissement cumulé réduit la valeur des immobilisations.

2. Corriger une Erreur Publiée

Objectif : Un dépôt de membre a été enregistré sur le mauvais membre Écriture originale (incorrecte) :
Écriture de correction :
Effet : La caisse ne change pas, le solde de John diminue, le solde de Jane augmente.

3. Revenu d’Intérêt Couru

Objectif : Enregistrer un intérêt gagné mais pas encore reçu
Effet : Reconnaît le revenu gagné et crée une créance jusqu’à la réception de l’argent.

4. Soldes d’Ouverture

Objectif : Enregistrer les soldes initiaux au démarrage d’Agatabo
Effet : Initialise le système comptable avec les soldes de départ.

5. Passer une Créance Douteuse en Perte

Objectif : Passer en perte un prêt irrécouvrable
Effet : Retire le prêt irrécouvrable des actifs et enregistre une dépense.

6. Dépense Prépayée

Objectif : Enregistrer le paiement d’un service futur (ex. assurance pour 12 mois)
Effet : Échange de la caisse contre un actif prépayé (à amortir chaque mois sur 12 mois).

7. Reclasser une Dépense

Objectif : Déplacer une dépense d’une catégorie vers une autre
Effet : Aucun changement du total des dépenses, mais meilleure catégorisation des dépenses.

Bonnes 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
Création de l’Écriture :
  • ✅ 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
Après 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
Documentation :
  • ✅ 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 invalides :
  • ❌ Comptes inexistants
  • ❌ Comptes d’autres organisations
  • ❌ Comptes inactifs
  • ✅ Utilisez uniquement les comptes actifs de votre organisation
Comptes gérés par le système :
  • ⚠️ 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
Écritures non équilibrées :
  • ❌ Total des débits ≠ total des crédits
  • ✅ Vérifiez toujours l’équilibre avant publication
Montants négatifs :
  • ❌ 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)
Impossible de modifier ou supprimer :
  • ❌ 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) :
Annulation :
Puis créez l’écriture correcte :

Méthode 2 : Créer une Écriture Corrective

Si seule une partie de l’écriture est incorrecte, créez un ajustement : Originale (incorrecte) :
Correction (directe) :

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)
Signaux d’alerte pour les auditeurs :
  • 🚩 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
Bonnes pratiques pour des écritures manuelles prêtes pour l’audit :
  • ✅ 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) :
Prévention :
  • 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) :
Prévention :
  • 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) :
Exemple (correct) :
Prévention :
  • 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 :
Prévention :
  • 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 :
Prévention :
  • 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-key avec 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)
Format de clé d’idempotence (recommandé) :
Exemple d’utilisation :

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