Skip to Content
Meubles Morinière

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

Devis et liens de paiement

Chiffrer, sceller et envoyer un devis, le relancer, le remplacer ou l’annuler, l’accepter en ligne ou au magasin. Et le lien de paiement, qui est un devis d’un autre genre.

Not translated yet

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

Un meuble sur mesure ne se met pas au panier. La demande arrive au magasin, par téléphone ou par la phrase à trous du site, qui écrit à la boîte de l’atelier (Demandes au magasin). L’atelier chiffre le meuble, le client relit le devis, puis il l’accepte et il paie. Le devis (Quote, QuoteLine) est un document séparé de la commande. Ses lignes viennent du catalogue, ou alors elles sont libres, avec leurs précisions (cotes, essence, finition). Il porte aussi un mode de livraison, une validité et parfois un acompte. Une fois accepté, il devient une commande, et une seule (Quote.orderId est unique).

Les chemins sans préfixe partent de apps/erp/modules/quotes/.

Le devis lit le catalogue (une ligne recopie la référence et la politique de stock de la déclinaison), la grille de port, les délais de fabrication et la fiche client. S’il est payé en ligne, il donne une commande du site. S’il est accepté au magasin, il donne une vente du magasin (Commandes). Son numéro sort d’un compteur sans trou, dans la série des devis (DocumentSeries.QUOTE).

Les états

Un devis a quatre états (QuoteStatus) : brouillon, envoyé, accepté, annulé. Le trigger Quote_guard n’admet que ces passages :

VersDepuis
Envoyébrouillon
Acceptéenvoyé
Annulébrouillon, envoyé
Brouillonenvoyé, seulement s’il n’a été ni vu, ni relancé, ni rattaché à un paiement
  • « Expiré », ce n’est pas un état. On le déduit de la date de validité, lue au jour de Paris (lib/quote-state.ts#quoteState, #isQuoteExpired). Du coup, il n’y a pas de tâche planifiée qui fait basculer les devis à minuit.
  • L’histoire d’un devis se lit dans des dates : premier et dernier envoi, nombre de relances, première et dernière consultation par le client, acceptation, annulation.
  • À l’envoi, le trigger fige le numéro, le lien d’accès du client, la validité, le port, la date d’envoi et le délai de fabrication promis. QuoteLine_guard fige les lignes. Un devis envoyé ou accepté a son PDF archivé, sauf une fois anonymisé (Quote_document_check). Un devis accepté garde sa commande et ne se supprime plus.
  • L’acompte, l’e-mail, les adresses et le message ne changent plus après l’envoi non plus. Mais là, c’est le service qui refuse (NOT_DRAFT). La base laisse faire, parce que la conservation des données doit pouvoir anonymiser un devis envoyé (quote-retention.service.ts#anonymizeExpiredQuotes).

Chiffrer

services/quote-admin.service.ts#createQuote et #updateDraftQuote refusent :

  • Une validité déjà passée, ou à plus d’un an.
  • La même déclinaison sur deux lignes, ou une déclinaison qui a disparu.
  • Un mode de livraison archivé.
  • Une livraison outre-mer, ou une vente à une entreprise d’un autre pays de l’Union livrée hors de France (lib/quote-destination.ts#quoteDestinationIssue).
  • Un acompte supérieur au total (la base exige aussi un acompte positif, Quote_deposit_check), ou un total au-delà de 999 999,99 €.

Le prix se saisit sur la ligne, donc un devis peut s’écarter du prix du catalogue. La référence et la politique de stock sont recopiées de la déclinaison. Un brouillon se retouche sous un verrou de sa ligne, et ses lignes se remplacent d’un bloc.

Sceller et envoyer

services/quote-sending.service.ts#sendQuote fait les choses dans cet ordre :

  1. Il refuse tant que le paiement en ligne n’est pas ouvert. Ça veut dire tant que les mentions légales et les conditions générales ne sont pas complètes (lib/quote-payment-gate.ts#isQuotePaymentOpen).
  2. Il refuse un devis expiré, anonymisé, ou qui en remplace un autre payé entre-temps.
  3. Il archive le PDF, puis il passe le devis à « envoyé ». Cette écriture a une condition : la date de dernière retouche lue au moment du rendu ne doit pas avoir changé (CHANGED_WHILE_SENDING). Du coup, le PDF que le client reçoit est exactement le devis enregistré. Le délai promis se fige à ce moment-là. La page du site, le paiement en ligne et l’accord au magasin le relisent.
  4. Il remet le devis en brouillon si on est sûr que l’e-mail n’est pas parti. Si on ne sait pas, le devis reste envoyé et l’écran le dit.

Relancer, remplacer, annuler

  • Relancer : on renvoie le même PDF archivé, avec un mot facultatif. Le nombre de relances et la date du dernier envoi avancent. Un devis expiré ne se relance pas.
  • Remplacer : on crée un nouveau devis qui cite l’ancien (replacesQuoteId). L’ancien est annulé seulement une fois le nouveau envoyé (services/quote-replacement.service.ts#retireReplacedQuote). Si cette annulation échoue, l’ancien reste ouvert et la personne est prévenue. Le client a donc toujours un devis valable. Un devis accepté ne se remplace pas.
  • Annuler (shared/server/quote-cancellation.ts#cancelQuote) : seulement depuis brouillon ou envoyé. Si un paiement en ligne est en train de s’ouvrir (moins de 60 secondes, CHECKOUT_IN_FLIGHT_MS), c’est refusé. Si une session est déjà ouverte, on la ferme d’abord chez Stripe. Si elle est payée, ou si Stripe ne répond pas, l’annulation est refusée. Ensuite, sous le verrou du devis, la tentative de paiement est annulée avec lui.

Accepter en ligne

Le client ouvre son devis par un lien et le paie sur le site (apps/site/modules/checkout/services/quote-payment.service.ts#openQuotePayment).

  • Le devis doit être envoyé. Il ne doit être ni annulé, ni accepté, ni expiré. Si une ligne est au taux réduit de TVA, il faut l’attestation du client. Si une tentative précédente est encore ouverte, elle se reprend à la même adresse de paiement. Si elle est abandonnée, elle se ferme.
  • Les prix viennent du devis. Si un prix du catalogue a changé depuis l’envoi, ça ne change rien.
  • Les pièces suivies sont retenues pendant la durée de la session, comme pour un panier. Si elles manquent, le client l’apprend avant de payer. Soit la pièce est en cours de paiement chez un autre client. Soit elle est vendue, et dans ce cas l’atelier est prévenu par e-mail.
  • Le paiement en ligne encaisse toujours le total du devis. L’acompte prévu ne vaut qu’au magasin.
  • Le devis n’est accepté qu’au moment du paiement. Le webhook l’accepte dans la transaction qui encaisse (modules/payments/services/quote-acceptance.service.ts#acceptQuoteOfOrder), et seulement s’il est encore envoyé. Il reporte sur la commande la note interne, parce que le site n’a pas le droit de l’écrire (Order_site_guard_insert). Dans l’autre sens, le devis reprend la fiche client que l’encaissement vient de rattacher à la commande. Côté base, le site ne peut rattacher à un devis envoyé qu’une commande du site en attente de paiement (Quote_site_guard_update).

Accepter au magasin

services/quote-store-acceptance.service.ts#acceptQuoteInStore transforme le devis en vente du magasin. Ensuite, elle suit le chemin de n’importe quelle vente au magasin (Acomptes et paiements).

  • Il admet un devis envoyé, même expiré (l’écran prévient). Il admet aussi un brouillon, et dans ce cas il le scelle sans e-mail (sealQuoteForStore). Une ligne au taux réduit exige une prestation et l’attestation du client. Une entreprise française sans SIREN est refusée.
  • Si une session en ligne est ouverte, on la ferme d’abord chez Stripe. Si le client a déjà payé en ligne, ou si un paiement s’ouvre, l’accord est refusé.
  • Tout se fait en une transaction. Sous le verrou du devis, la tentative en ligne est annulée, la commande du magasin se crée à partir des lignes du devis (shared/server/store-order.ts#createStoreOrder) et le devis passe à « accepté ». L’acompte du devis devient celui de la commande.
  • Si la commande ne se crée pas (une pièce suivie manque), un devis scellé pour l’occasion revient en brouillon. L’ancien devis remplacé est annulé seulement une fois la commande créée.

Le lien de paiement

Pour une pièce choisie au téléphone, le magasin envoie un lien de paiement. C’est un devis d’un autre genre (QuoteKind.PAYMENT_LINK), dans la même table et avec les mêmes services. Son genre se fixe à la création (lib/quote-kind.ts#quoteKindOf). Il n’y a que les textes et la validité par défaut qui changent : trois jours pour un lien, trente pour un devis (QUOTE_IMMEDIATE_VALIDITY_DAYS).

  • Le formulaire ne propose pas d’acompte pour un lien. Le serveur ne le refuse pas, parce que le paiement en ligne encaisse le total de toute façon.
  • Un lien envoyé ne se prolonge pas, parce que la base fige sa validité comme celle d’un devis. Il faut le refaire.

Les cas limites

  • Pour qu’un devis ne soit pas accepté deux fois, le paiement du site, l’accord au magasin et l’annulation prennent le même verrou consultatif. Son préfixe est écrit une fois pour les deux applications (QUOTE_PAYMENT_LOCK_PREFIX, packages/contracts/src/quote-payment-lock.ts). Chacun relit le devis sous ce verrou. Au magasin, le second clic est refusé : « le devis a changé » s’il attendait le verrou, « pas envoyé » s’il arrive après. Et le client qui paie après l’accord apprend que le devis est déjà réglé.
  • Il arrive que le client paie une session que l’accord au magasin ou l’annulation venait de fermer. Dans ce cas, la commande en ligne est déjà annulée côté paiement. Le webhook n’écrit rien et alerte l’équipe, qui rembourse ce paiement chez Stripe.
  • Si la pièce s’épuise entre le devis et l’accord, le paiement en ligne ne s’ouvre pas, et au magasin la vente est refusée. Les lignes sont figées, donc une pièce suivie ne bascule pas toute seule en fabrication à la commande. Il faut refaire le devis.
  • La validité se contrôle à l’ouverture du paiement. Un client qui a ouvert sa session la veille de l’échéance peut payer le lendemain, et le webhook l’accepte.

Les limites

  • Quote.orderId ne garde que la dernière tentative de paiement. Les tentatives abandonnées restent des commandes du site annulées, détachées du devis. Elles sont ensuite anonymisées avec les autres commandes impayées.
  • Il n’y a pas d’acompte en ligne. Un client qui veut verser un acompte passe au magasin, ou il paie tout.
  • Le devis n’a pas de variantes de prix ni d’options au choix du client. Pour changer d’option, on remplace le devis.

On this page