ModuleEn productionEmbarquéXL · > 2 semainescommerce.facturation-encaissements

Facturation et encaissements

Produire des factures coherentes, suivre le du et enregistrer acomptes, soldes, avoirs et remboursements sans reecrire l'histoire.

Le problème qu'il règle

Un champ paid masque les mouvements d'argent, les trop-percus et les remboursements.

Preuve — En production

Tourne chez un client qui s'en sert, données réelles persistées.

Empaquetage — Embarqué

Tissé dans le code du client. À réécrire, pas à copier.

Les écrans

Back-office · 3

Route	Écran	Ce qu'on y fait	La forme	Les états
`/invoices`	Factures	Lister, filtrer, creer et envoyer les pieces.	Table dense, statuts, montant et echeance.	Brouillon, emise, payee, partielle, avoir, annulee.
`/invoices/[id]`	Facture	Voir les lignes immuables et les mouvements lies.	Document, timeline paiement, actions bornees.	A payer, soldee, trop-percue, remboursee.
`/payments`	Encaissements	Enregistrer, rapprocher et rembourser.	Ledger, filtres, rapprochement et recus.	En attente, confirme, refuse, rembourse, inconnu.

Espace client · 1

Route	Écran	Ce qu'on y fait	La forme	Les états
`/facture/[token]`	Recu client	Consulter et imprimer une piece signee.	Document public borne par token.	Valide, revoque, introuvable.

Où l'IA intervient

L'autonomie se lit avant la technique. « Propose » est le défaut de la maison : l'outil prépare, une personne valide. Tout ce qui « agit » doit nommer son garde-fou.

ProposeAgent BO

Explique le solde et prepare une relance avec les pieces sources.

Tool calling

Ce qui tourne tout seul

Déclencheur	Effet	Comment
Paiement confirme	Rapprocher la facture et recalculer le solde	RPC transactionnelle idempotente
Echeance depassee	Preparer une relance sans l'envoyer seule	Scheduler + outbox

Ce qu'on peut activer dedans

Charges

charges

Brouillon puis postees, jamais modifiees apres facturation.

Paiements

payments

Registre idempotent par moyen et reference.

Factures

invoices

Numerotation, lignes snapshots, PDF/impression et envoi.

Avoirs

credits

Corrigent sans supprimer la piece d'origine.

Impayes

unpaid

Reste du explicite, montant inconnu distinct de zero.

Sous le capot

Données

charges
payments
invoices
invoice_lines
credit_notes
payment_events

Composants réutilisables

InvoiceTable
InvoiceDocument
PaymentLedger
RefundDialog
UnpaidBanner

Services externes

· SystemPay/Lyra
· Brevo
· Export comptable

Rôles et droits

· Encaissement
· Remboursement
· Lecture comptable

Ce qu'il faut autour

Il exige

Il ne cohabite pas avec

Aucun conflit connu.

D'autres en dépendent

Les pièges

Chacun vient d'un incident réel, relevé dans les commentaires du code d'origine. C'est la partie du catalogue qui vaut le plus cher : elle évite de repayer la même leçon.

Une franchise se plafonne par evenement, pas par dommage.
Un remboursement integral n'est pas une facture impayee.

Ce qu'il ne fait pas, et ce qui reste à faire

Hors périmètre

· Comptabilite generale
· Declaration fiscale automatique

Pour le mettre vraiment sur étagère

· Fusionner ledger Tiare, factures Studio et rail SystemPay RDC.
· Ajouter numerotation/fiscalite configurable par juridiction.

Où c'est prouvé

Studio Belleza

En production

/home/jordy/projects/Studio Belleza/studio-belleza/src/app/admin/invoices

Tiare Auto (base loueur)

Démo simulée

/home/jordy/projects/location-exemple/src/app/pro/(app)/encaissements

Rangiroa Diving Center

Livré

/home/jordy/projects/PACIFIK'AI/solutions/bookflow/factory/sites/rangiroa-diving-center/service/systempay.py

Vérifié contre le code le 2026-08-27. Au-delà de quatre-vingt-dix jours sans revérification, une fiche décrit un souvenir, pas un dépôt.

Tous secteurs