Créer une pièce comptable

Une pièce comptable dans SynkriaOps est un ensemble d’écritures réparties dans un même journal, à une même date, équilibrées débit/crédit. Une fois validée, la pièce est rendue immuable (modification interdite, contrepassation possible) et hashée en chaîne SHA-256 pour traçabilité NF203 / SYSCOHADA art. 24.

Flow standard de saisie

1. Comptabilité → Pièces comptables → Nouvelle pièce.

2. Choisissez le journal (ventes, achats, banque, OD, AN). Cela détermine le préfixe de numérotation (ex. VTE, ACH, BNQ, OD, AN).

3. Saisissez la date (doit appartenir à un exercice fiscal ouvert — sinon SynkriaOps refuse la création).

4. Ajoutez les lignes d’écriture :

   • Numéro de compte (autocomplete depuis le plan comptable SYSCOHADA)
   • Libellé
   • Montant débit OU crédit (jamais les deux sur la même ligne)
   • Optionnel : référence externe (n° de facture, code analytique, lettrage)

5. La somme totale des débits doit être égale à la somme totale des crédits. Le bandeau en haut affiche en temps réel l’écart — la validation est bloquée tant que débit ≠ crédit.

Astuce

Les montants sont saisis en NUMERIC(15,2) — pas de notation scientifique, pas d’arrondis flottants. La devise est implicitement XAF (FCFA BEAC) sauf configuration multi-devise (roadmap).

Validation et numérotation

Tant que la pièce est en statut BROUILLON, vous pouvez la modifier librement. La validation déclenche :

1. Numérotation séquentielle : le numéro VTE-2026-000123 est attribué via un verrou pessimiste PostgreSQL (FOR UPDATE). Aucune numérotation ne peut être sautée ni dupliquée, même en concurrence.

2. Calcul du hash chaîné SHA-256 : le hash de cette pièce = SHA-256(contenu pièce + hash de la pièce précédente du même tenant). Toute altération ultérieure casse la chaîne et est immédiatement détectable.

3. Trigger PostgreSQL : les colonnes montant, compte, date des lignes validées sont protégées en UPDATE/DELETE par un trigger BEFORE (cf. migration TightenPiecesValideeImmutability).

Attention

Pour corriger une pièce validée, vous devez créer une contrepassation ou une OD inverse — jamais modifier l’originale. L’historique reste intact pour l’audit.

Vérification d’intégrité (QR code)

À partir de la PR #270 (LOT-FACT-V5-QR-VERIF), le PDF de chaque pièce validée embarque un QR code pointant vers https://app.synkriaops.com/v/{token}. Scanner ce QR vérifie en quelques millisecondes :

• L’authenticité de la pièce (token JWT signé HMAC-SHA256)
• Que le contenu actuel correspond au hash chaîné enregistré
• L’auteur et la date de validation

Conforme SYSCOHADA art. 24 (conservation 10 ans) — utile pour les vérifications fiscales ou les audits CAC.

Exemple — facture client

Date	Journal	Numéro	Compte	Débit	Crédit	Libellé
2026-05-19	VTE	(auto)	411000045	1 180 000		Client SARL ABC
2026-05-19	VTE	(auto)	70100000		1 000 000	Vente prestation conseil
2026-05-19	VTE	(auto)	44310000		180 000	TVA collectée 18 %

Total débit = 1 180 000 ✓ Total crédit = 1 180 000 → validation possible.

Erreurs courantes

Erreur	Cause	Solution
« Débit ≠ Crédit »	Lignes déséquilibrées	Ajouter une ligne d’ajustement ou corriger les montants
« Exercice fiscal clos »	Date dans un exercice fermé	Choisir une date dans un exercice ouvert
« Compte 411xxx inexistant »	Tiers pas encore créé	Créer le tiers (génère le sous-compte 411 automatiquement)
« Pièce validée — modification interdite »	Tentative d’éditer une pièce déjà validée	Créer une contrepassation à la place

Pour aller plus loin

• Lettrage des comptes tiers → (à venir)
• Comprendre la chaîne de hash → (à venir)
• Export FEC pour contrôle fiscal → (à venir)