Skip to Content
Meubles Morinière

The productLogique métier(in French)8 min read

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.

Not translated yet

This page is shown in its original French. Code excerpts, tests and figures read the same in either language.

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 vientCanalCréationEncaissement
Le panier du siteWEBen 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 ligneWEBpareil, aux prix du devis (Devis)pareil, le devis s’accepte dans la même transaction
Le magasinSTOREsoldé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 magasinSTOREpareil, à partir des lignes du devispareil

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, refus BALANCE_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.

Les étapes de la préparation et l’argent qu’elles exigentEn fabrication s’atteint depuis À préparer. Prête s’atteint depuis À préparer, En fabrication. Expédiée s’atteint depuis À préparer, En fabrication, Prête. Livrée s’atteint depuis Prête, Expédiée. En fabrication, Prête : pour y entrer : de l’argent reçu (Acompte versé, Payée, Remboursée en partie). Expédiée, Livrée : pour y entrer : tout payé (Payée, Remboursée en partie). Une commande s’annule depuis À préparer, En fabrication, Prête.À préparerEn fabricationPrêteExpédiéeLivréepour y entrer : de l’argent reçuAcompte versé · Payée · Remboursée enpartiepour y entrer : tout payéPayée · Remboursée en parties’annule tant qu’elle n’est pas partie
Passages lus dans apps/erp/modules/orders/constants/fulfillment.ts et statuts de paiement dans packages/domain/src/payment-status.ts, à chaque build de cette documentation. Les étapes à l’encre sont celles d’une commande partie. Survoler une étape isole ses flèches.

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 par mainOrderId unique). 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.
  • Order est 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.

On this page