Le produitLogique métier8 min de lecture
Commandes
Trois façons de créer une même commande, ses deux états, la préparation de la fabrication à la livraison, l’annulation, et ce que devient un paiement en ligne qui échoue, arrive deux fois ou arrive trop tard.
Une vente sur le site, au magasin ou sur devis, c’est la même commande (Order), et on la suit jusqu’à la facture. La commande porte ce qui a été vendu, l’argent reçu et la préparation du meuble. Sa facture et ses remboursements ont leurs pages : Facturation et Service après-vente.
Les chemins sans préfixe partent de apps/erp/modules/orders/.
La commande lit le catalogue, et ses lignes recopient ce qu’elles vendent (Données). Elle lit aussi la grille de port et les délais. Elle fait bouger le stock (Stock) et elle déclenche les achats liés à ses lignes (Fournisseurs et achats). Ses encaissements et ses remboursements font avancer l’état de son argent.
Trois façons de créer une commande
| D’où elle vient | Canal | Création | Encaissement |
|---|---|---|---|
| Le panier du site | WEB | en attente de paiement, écrite par le site (apps/site/modules/checkout/services/checkout.service.ts#createPendingOrder) | en entier, confirmé par le webhook Stripe |
| Un devis payé en ligne | WEB | pareil, aux prix du devis (Devis) | pareil, le devis s’accepte dans la même transaction |
| Le magasin | STORE | soldée et remise sur place, ou sur acompte (shared/server/store-order.ts#createStoreOrder) | en une ou plusieurs fois, par l’équipe |
| Un devis accepté au magasin | STORE | pareil, à partir des lignes du devis | pareil |
Chaque canal a ses obligations, et c’est la base qui les impose. Une commande du site a son e-mail, ses conditions générales acceptées et son adresse (Order_channel_check). Le site ne peut écrire qu’une commande du site en attente de paiement, sans note interne ni fiche client (Order_site_guard_insert). Au magasin, l’acompte ne dépasse pas le total (Order_store_check). Toutes les ventes du magasin passent par la même fonction, createStoreOrder, qu’elles soient faites sur place ou à partir d’un devis.
Deux états côte à côte
Une commande porte deux états. Il y a celui de son argent (PaymentStatus : en attente, acompte versé, payée, remboursée en partie ou en entier, échouée, annulée). Et il y a celui de sa préparation (FulfillmentStatus : à préparer, en fabrication, prête, expédiée, livrée, annulée). Deux regroupements servent partout (packages/domain/src/payment-status.ts) :
- Payée en entier à un moment (
SETTLED_PAYMENT_STATUSES) : une commande payée ne redevient pas impayée parce qu’on en a rendu une partie depuis. - Garde de l’argent du client (
HELD_PAYMENT_STATUSES) : un acompte, la totalité, ou ce qui reste après un remboursement partiel.
Les deux états sont liés à trois niveaux.
- Dans la base, rien ne part (expédiée, livrée) avant d’être payé en entier. Rien ne se prépare avant d’être payé, sauf une vente du magasin, qui peut entrer en fabrication sur acompte (
Order_fulfillment_payment_check). Il n’y a qu’une vente du magasin qui connaît l’acompte versé (Order_confirmed_check). - Le service est plus strict. Une vente du magasin entre en fabrication dès qu’il y a un premier encaissement, et pas avant (
NOT_PAID). Elle ne part qu’une fois soldée (services/fulfillment-guards.ts#DEPARTABLE_PAYMENT_STATUSES, refusBALANCE_DUE). L’acompte demandé (depositCents) ne bloque rien. Il préremplit juste le montant à encaisser. - Et dès qu’il y a un encaissement, le canal et les montants de la commande ne changent plus. Dès qu’il y a une facture, la date de paiement et l’acompte ne changent plus non plus (
Order_guard_update). Un prix faux sur une vente déjà facturée se corrige par une facture rectificative (Facturation).
La préparation
Les passages permis sont écrits une fois (constants/fulfillment.ts#FULFILLMENT_TRANSITIONS). La figure les relit dans le code, avec l’état de l’argent que le service exige pour entrer dans chaque étape.
Le passage direct de prête à livrée, c’est la remise au magasin.
services/fulfillment.service.ts#advanceFulfillment vérifie d’abord ce qu’il peut expliquer. Ensuite il verrouille la commande et il écrit par une mise à jour conditionnelle. La condition porte l’état de départ, l’état de l’argent et les gardes de départ (fulfillment-guards.ts#departureGuardWhere). Une rétractation en cours ou un litige bancaire perdu bloquent tous les passages. Un litige encore ouvert ne bloque que le départ (expédition et livraison). Seule exception : une commande déjà expédiée passe toujours à « livrée », puisque le meuble est parti et qu’il faut pouvoir constater son arrivée. Un retrait au magasin ne s’expédie pas. Si la mise à jour ne touche rien, le refus est expliqué après coup (#explainRefusedTransition) : « déjà expédiée », « solde dû », « litige en cours ».
- Une pièce qui manque (rupture non décidée) empêche tous les passages, sauf l’entrée en fabrication et le passage d’expédiée à livrée (
assertNoMissingPiece). - Quand une commande est prête, ses lignes sont marquées sorties du rayon (
OrderItem.pickedAt). Elles ne comptent plus dans les pièces vendues encore en magasin (Stock). - Chaque pas s’écrit (
OrderStep, avec qui l’a fait). Ça sert à la chronologie de la fiche, et rien ne se décide dessus. - L’échéance de l’atelier part du paiement, et la date promise au client reste à part (Délais et dates promises).
Ce que l’atelier a sous les yeux pour préparer est décrit dans La journée de l’équipe : les signaux d’une commande, sa prochaine étape, le bon de préparation, le planning des livraisons.
Expédier, remettre, livrer
- Expédier (
services/fulfillment-steps.service.ts#shipOrderAndNotify) : on écrit le colis principal, avec le transporteur et le numéro de suivi (OrderParcel, un seul principal par commande parmainOrderIdunique). Une fois la commande expédiée, on peut lui ajouter des colis supplémentaires. - Remettre au magasin : une commande prête passe à livrée, sans colis ni avis d’expédition (
Order_pickup_check). - Livrer : une livraison constatée par le suivi du transporteur n’est admise que depuis « expédiée ». La base exige que la livraison soit postérieure à l’expédition (
Order_delivery_sequence_check).
Le rendez-vous de livraison se fixe jusqu’à la livraison, même une fois la commande expédiée, à condition d’avoir reçu de l’argent. Pour un colis, on ne fait que déplacer un rendez-vous déjà fixé, parce qu’il suit la tournée du transporteur. Il ne peut pas tomber dans le passé ni un jour de fermeture. Et il ne s’écrit que si l’ancien n’a pas changé entre-temps (services/delivery-follow-up.service.ts#scheduleDeliveryAppointment).
Chaque avis au client a sa date sur la commande : confirmation, expédition, retrait, rendez-vous, livraison, retard d’un fournisseur, rupture. Le premier envoi est daté une fois, et un renvoi ne réécrit pas la date. L’avis d’annulation est l’exception : il n’a pas de date à lui, et sa clé d’envoi reprend la date d’annulation. Chez le fournisseur d’e-mail, une clé d’idempotence empêche qu’un envoi repris parte deux fois.
On peut revenir en arrière (#stepBackFulfillment, lib/fulfillment-gestures.ts#stepBackTarget) tant que le client n’a rien su de l’étape. Une expédition ne se défait plus si son avis est parti, si un retour est enregistré ou s’il y a des colis supplémentaires. Une remise sans expédition revient à « prête ». Ce retour efface les dates de l’étape qu’on quitte.
Annuler
services/fulfillment-cancel.service.ts#cancelFulfillment annule une commande qui n’est pas encore partie : à préparer, en fabrication ou prête.
- Les pièces vendues reviennent en stock par une annulation, dans la limite de ce qui a été vendu et hors lignes en rupture. Les pièces reçues pour le client entrent aussi en stock, et les liens vers les achats encore ouverts se défont.
- Un rendez-vous de livraison s’efface.
- Si le client a réglé quelque chose, même remboursé depuis, il reçoit un e-mail d’annulation : la commande, le rendez-vous annoncé qui n’aura pas lieu, et le remboursement (
services/fulfillment-cancel.service.ts#notifyOrderCanceled). Si l’e-mail échoue, ou pour une commande jamais payée qui avait un rendez-vous annoncé, l’écran demande de prévenir le client. - Une session de paiement encore ouverte est expirée chez Stripe. Si Stripe ne répond pas, l’équipe est alertée.
- L’annulation ne touche pas à l’argent. L’état du paiement ne change pas, et ce qui a été encaissé apparaît « à rembourser » (
lib/refund-due.ts#refundDueCents). Un nouvel encaissement et la relance de solde sont refusés. Rembourser, c’est un geste à part, qui demande une connexion récente (Service après-vente).
Les paiements en ligne qui tournent mal
Le paiement d’une commande du site arrive par le webhook Stripe. Il n’y a que l’ERP qui le reçoit (Stripe).
- Quand une session expire, la commande est annulée. Quand un paiement différé est refusé, elle est marquée échouée. Dans les deux cas, ça ne se fait que si elle était encore en attente (
modules/payments/services/webhook-session.service.ts#handleSessionClosed). Une session manquée peut aussi se refermer à la main, après avoir interrogé Stripe (services/stale-session.service.ts#closeExpiredSession). - Le webhook compare le montant, la devise et la commande visée. S’il y a un écart, il ferme la commande et il demande de rembourser (
#reconcileSession). - Si le client paie après une annulation de l’atelier, l’argent est là. La commande passe payée, l’encaissement s’écrit, la facture aussi. Par contre, le stock n’est pas décompté. L’équipe est alertée pour rembourser depuis la fiche (
#settleCanceledOrder). - S’il paie sur une tentative fermée (devis annulé ou accepté au magasin entre-temps), rien ne s’écrit et l’équipe est alertée.
- Si un événement est livré deux fois, son identifiant sert de clé à
WebhookEvent, et un événement déjà traité répond sans rien refaire. Un événement repris en cours de traitement ne fait pas de dégâts. Les écritures sont conditionnelles (la commande ne passe payée que depuis « en attente »), l’identifiant de paiement Stripe est unique, et les émissions de facture reconnaissent une facture déjà émise. Si une alerte n’a pas pu partir, on répond une erreur, et Stripe relivre.
Dans tous ces cas, un paiement reçu n’est ni refusé ni perdu. On l’écrit, on signale l’anomalie, et c’est une personne qui décide du remboursement.
Les limites
- Les règles de la préparation sont réparties entre la constante des passages, les gardes du service et les contraintes de la base. Et elles ne disent pas exactement la même chose. La base admet une vente du magasin en fabrication sans encaissement, alors que le service la refuse.
Orderest une table large, avec une colonne datée par étape et par avis. Données explique pourquoi.- Rien ne rembourse tout seul un paiement arrivé sur une commande fermée. Il attend qu’une personne décide.