Le produitLogique métier5 min de lecture
Acomptes et paiements
Encaisser en ligne ou au magasin, en une ou plusieurs fois, l’acompte et le solde, la relance, pourquoi un trop-perçu ne peut pas arriver, et un registre d’encaissements où on ne fait qu’ajouter.
L’argent d’un meuble fabriqué arrive en plusieurs fois : un acompte à la commande, le solde à la livraison, parfois en espèces puis par chèque. Chaque encaissement est une ligne (Payment). On ne la modifie pas et on ne l’efface pas. L’état de l’argent de la commande se déduit de la somme de ces lignes, des remboursements et des avoirs.
Les chemins sans préfixe partent de apps/erp/.
Les encaissements font avancer l’état de l’argent de la commande, et donc ce que la préparation peut faire (Commandes). Chacun peut recevoir sa facture d’acompte, et la facture de vente les déduit (Facturation). Ils sont chaînés et clos par jour, par mois et par exercice (Des encaissements qui ne se retouchent pas). Les remboursements les réduisent (Service après-vente).
Le registre des encaissements
Tous les encaissements s’écrivent par une seule fonction, shared/server/payment-ledger.ts#recordPayment. Un encaissement porte un moyen, un montant positif (Payment_amount_check), une date, une référence facultative (numéro de chèque, de virement) et son auteur.
Au magasin, les moyens sont les espèces, le chèque, la carte sur le terminal et le virement (shared/constants/store-payment-methods.ts#STORE_PAYMENT_METHODS). Le paiement Stripe, il n’y a que le webhook qui l’écrit, avec son identifiant de paiement, unique en base, et que seul un encaissement Stripe peut porter (Payment_stripe_check).
On ne fait qu’ajouter. Payment_guard refuse toute modification et toute suppression : « un encaissement enregistré ne se supprime pas, il se rembourse ». À l’insertion, il n’admet que les espèces, le chèque, la carte, le virement et Stripe. Du coup, une erreur de saisie se corrige par un remboursement (plus bas). Chaque encaissement reçoit aussi un numéro d’ordre et une empreinte chaînée à la précédente. Les clôtures de caisse reprennent la dernière.
En ligne : toujours la totalité
Le panier du site et le devis payé en ligne encaissent le total, en une fois, par Stripe Checkout. Le webhook écrit l’encaissement dans la transaction qui fait passer la commande de « en attente » à « payée » (modules/payments/services/webhook-session.service.ts#handleSessionPaid). Il n’y a pas d’acompte en ligne. Un client qui veut verser un acompte passe au magasin.
Au magasin
La vente
modules/payments/services/off-site-sale.service.ts#recordOffSiteBasket enregistre le panier du magasin et crée la commande du magasin (shared/server/store-order.ts#createStoreOrder). Il y a deux règlements possibles (#settlementOrderFields).
- Soldée et remise : le client part avec sa pièce, et la commande est créée directement livrée. Tout doit être encaissé (
HANDOVER_UNPAID), et le client peut rester anonyme. - Sur acompte : le client est nommé, et la pièce est retirée plus tard ou livrée à une adresse donnée (
ADDRESS_REQUIRED). La commande est créée « acompte versé ».
Une vente peut se régler avec plusieurs moyens. Il y a un encaissement par moyen, et leur somme doit tomber exactement sur le dû (#assertPaymentsCoverDue, PAYMENTS_MISMATCH). On peut la saisir après coup, mais pas à une date future, ni trop ancienne. Elle ne peut pas non plus tomber dans un exercice déjà exporté ou une période de TVA déjà déclarée, parce qu’elle changerait des chiffres déjà remis.
Une vente envoyée deux fois (double clic, réseau qui reprend) n’est enregistrée qu’une fois. Une clé de soumission est réservée quinze minutes dans Redis (shared/server/idempotency.ts#claimSubmission). Si Redis est absent ou en panne, la vente passe sans cette garde, parce qu’on ne bloque pas le magasin pour un cache.
Encaisser la suite
modules/orders/services/store-payment.service.ts#collectStorePayment verrouille la commande et refuse dans trois cas :
- Une commande du site, qui est forcément payée en ligne (
NOT_STORE). - Une commande soldée, annulée ou anonymisée (
NOT_COLLECTABLE). - Un montant au-delà du reste dû (
ABOVE_REMAINING).
Sinon, le service écrit l’encaissement et recalcule l’état de l’argent. Cette écriture a pour condition l’ancien état. La date de paiement de la commande reste celle du premier encaissement.
Le reste dû se calcule par une seule règle, packages/domain/src/store-collection.ts#storeCollectionOf. L’ERP l’applique (fiche, relance, facture) et le site la montre au client (« Reste à payer »). Elle compare l’encaissé, net des corrections, au total diminué des avoirs sans remboursement. L’état qui en sort (#storeCollectionStatus) est « en attente », « acompte versé », « payée », « remboursée en partie » ou « remboursée ».
L’acompte
L’acompte du devis devient celui de la commande, et on peut le modifier à l’encaissement. Il ne bloque rien. Il préremplit juste le montant à encaisser (modules/orders/lib/store-collect-prefill.ts#storeCollectPrefill). Le premier encaissement suffit à lancer la fabrication, quel que soit son montant. Pour le départ, il faut la totalité (Commandes).
La facture d’acompte s’établit à la demande, une par encaissement (Facturation).
La relance de solde
modules/orders/services/balance-reminder.service.ts#remindBalance envoie au client d’une vente du magasin ce qu’il doit encore. La relance est refusée si la commande est anonymisée, annulée ou sans e-mail. Une vente déjà soldée n’est pas relancée, et l’écran le dit. La clé d’idempotence change toutes les cinq minutes. Du coup, un double clic n’envoie qu’un e-mail, et une vraie relance plus tard repart. Il n’y a que la première relance qui est datée (balanceReminderSentAt). C’est l’équipe qui relance. Il n’y a pas de tâche planifiée pour ça.
Le trop-perçu n’existe pas
D’où que vienne la vente, l’argent reçu ne peut pas dépasser le dû :
- À la vente, un acompte demandé ou un versement au-delà du total est refusé (
DEPOSIT_ABOVE_TOTAL,OVERPAID). - Un encaissement au-delà du reste aussi (
ABOVE_REMAINING). - Au magasin, les moyens doivent tomber juste (
PAYMENTS_MISMATCH). - En ligne, un montant Stripe qui ne correspond pas à la commande la ferme, avec une alerte pour rembourser.
Pour corriger une erreur d’encaissement, il y a la correction d’encaissement (packages/domain/src/store-collection.ts#collectionCorrectionTest). C’est un remboursement en montant, sans pièce ni port, fait au magasin avant la facture de vente, l’expédition, la livraison ou l’annulation. Il réduit l’encaissé, mais il ne compte pas comme un remboursement, et la vente peut revenir en attente. Il laisse une trace comme tout remboursement. Et la facture de vente émet d’abord l’avoir de cette correction (Facturation).
Les limites
- Il n’y a pas d’échéancier. Les versements sont libres jusqu’au reste dû, et rien ne prévoit une date ni un montant pour le suivant.
- La garde contre le double envoi au magasin dépend de Redis. Quand Redis manque, elle disparaît et rien n’est bloqué.
- Il n’y a que la première relance de solde qui est datée. Les suivantes ne se comptent pas.
- La valeur « autre » de
PaymentMethodexiste dans le schéma, mais la base la refuse à l’insertion.