The productLogique métier(in French)8 min read
Service après-vente
Rembourser par Stripe ou au magasin, par pièces ou en montant, la rétractation, les retours, les réserves à la livraison et la réclamation au transporteur, les litiges bancaires, et ce que le logiciel ne suit pas.
Not translated yet
Il n’y a pas de module de SAV ni de tickets. Tout se passe sur la commande. Chaque événement qui suit la vente y laisse une trace. Le remboursement et le litige y ont leur ligne. La rétractation, le retour, les réserves et la réclamation y ont leur colonne datée. La fiche du client rassemble tout ça (app/(console)/clients/[cle]/_lib/customer-affairs.ts, Clients). Quand la demande vient du site, elle arrive par e-mail dans la boîte du magasin, avec ses photos et la commande citée (Demandes au magasin). J’explique ce choix plus bas.
Les chemins sans préfixe partent de apps/erp/.
Le SAV dépend de la commande, parce que l’argent reçu borne ce qu’on peut rembourser. Il dépend de la facturation, parce qu’un remboursement émet son avoir (Facturation). Il dépend aussi du stock, où reviennent les pièces rendues, et de Stripe, qui confirme les remboursements et les litiges par webhook. Et il dépend de la comptabilité, parce qu’une période déclarée ferme certains gestes. Dans l’autre sens, une rétractation ouverte arrête la préparation de la commande, et un litige ouvert arrête son départ (Commandes).
Rembourser
Pour rembourser, il faut une connexion récente (Sécurité).
Par Stripe
Pour une commande payée en ligne, le remboursement se fait en trois temps.
- On commence par réserver (
modules/refunds/services/refund-reservation.service.ts#reserveRefundLine). Sous le verrou de la commande, le service vérifie qu’elle a encore de l’argent encaissé et qu’elle n’est pas déjà remboursée en entier. Et surtout, il vérifie que les remboursements en cours ou aboutis, plus le nouveau, ne dépassent pas l’encaissé (EXCEEDS_REMAINING). Si la même demande est refaite dans la minute, elle est reconnue comme un doublon (TWIN_REQUEST). Le remboursement est créé en attente. - Ensuite, on envoie (
stripe-refund.service.ts#sendReservedRefund). Le service relit d’abord chez Stripe les litiges du paiement. S’il y a un litige ouvert ou perdu, le remboursement échoue. La demande part avec l’identifiant local comme clé d’idempotence, donc une reprise ne rembourse pas deux fois. Si la réponse se perd, le remboursement reste en attente. On ne le déclare pas échoué. - À la fin, le webhook confirme. Il retrouve le remboursement par son identifiant Stripe, ou par l’identifiant local passé en métadonnées (
modules/payments/services/webhook-refund.service.ts#handleRefundEvent). Un remboursement fait directement dans le tableau de bord Stripe est recopié dans l’ERP, et l’équipe est alertée s’il dépasse l’encaissé.
RefundStatus peut valoir en attente, action requise, abouti, échoué ou annulé (shared/server/refund-settlement.ts#settleRefund).
- Échoué et annulé sont définitifs. Si Stripe ranime un remboursement tombé, il n’y a qu’une alerte qui part.
- « Action requise » garde le montant réservé et lève un signal sur la commande.
- Un remboursement abouti qui échoue ou s’annule ensuite est retombé. Il garde sa date d’aboutissement et il reçoit une date de retombée (
reversedAt). Les pièces qu’il avait remises en stock en ressortent (shared/server/reclaimed-pieces.ts#reclaimRestockedPieces), et une facture annule son avoir. - « Interroger Stripe » n’apparaît qu’après cinq minutes sans réponse. Un remboursement que Stripe n’a jamais reçu passe échoué. La veille signale un remboursement resté en attente plus de dix jours (
PENDING_REFUND_MAX_AGE_MS). - La garde de la base le dit : « un remboursement enregistré ne se supprime pas, il échoue ou s’annule » (
Refund_guard).
Au magasin, consigné
Un remboursement en espèces, par chèque, par virement ou sur la carte au terminal du magasin se consigne (modules/refunds/services/off-stripe-refund.service.ts#recordOffStripeRefund). Il est créé abouti. Sa date ne peut pas être dans le futur, ni avant l’encaissement, ni dans un exercice exporté. Un litige bancaire enregistré le bloque. Sur une vente payée par acomptes, il se répartit entre les factures d’acompte qu’il entame (shared/invoicing/invoice.ts#depositRefundShares). Une erreur de saisie s’annule tant que la période de TVA n’est pas déclarée. Pour un remboursement hors Stripe, c’est la seule transition que la base admet : d’abouti à annulé.
Par pièces ou en montant
- Par pièces (
RefundItem), le prix rendu est celui affiché, éco-contribution comprise, moins la part de remise de la ligne (modules/refunds/lib/refund-pieces.ts#priceRefundPieces). Le port se rembourse en entier, une seule fois (SHIPPING_REFUNDED). Une pièce qui n’a rien coûté au client ne se rembourse pas. Une clé composite garantit qu’une pièce remboursée appartient bien à la commande remboursée (Données). - En montant, on rembourse librement jusqu’à l’encaissé. Par contre, après ça, le remboursement par pièces n’est plus proposé (
PIECES_AFTER_AMOUNT), parce qu’on ne saurait plus quelles pièces ce montant couvrait. - Avant le départ, les pièces remboursées reviennent en stock par une annulation (
modules/orders/services/fulfillment-restock.service.ts#restockRefundedItems). Après le départ, la pièce n’est plus au magasin, donc elle revient par un retour (plus bas). - Au magasin et avant la facture, un remboursement en montant est une correction d’encaissement (Acomptes et paiements).
La rétractation
Le client d’une vente à distance peut se rétracter pendant quatorze jours à compter de la réception (WITHDRAWAL_PERIOD_DAYS, packages/domain/src/withdrawal.ts). L’échéance se calcule en jours civils à l’heure de Paris, avec les jours fériés du lieu de livraison, parce que l’Alsace et la Moselle ont les leurs (LOCAL_LAW_ZIP_PREFIXES). Une demande se traite dans packages/orders/src/withdrawal.ts. Le site (formulaire du client) et l’ERP (demande reçue autrement) l’exécutent de la même façon. Le site prévient l’ERP par un événement signé (Échanges entre les applications).
- Il n’y a que le client d’une commande du site, sans société, qui peut se rétracter (
shared/lib/open-withdrawal.ts#isConsumerContract). - La demande s’écrit par une mise à jour conditionnelle (
createWithdrawalRequests). Du coup, si on la rejoue, elle est reconnue comme déjà enregistrée. Une demande en ligne hors délai n’est pas enregistrée. Le client reçoit un e-mail qui le lui dit, et l’équipe est alertée. Quand la demande est saisie dans l’ERP (modules/orders/services/withdrawal.service.ts#admitWithdrawalRequest), elle ne peut pas être future ni antérieure au paiement. Et si elle est hors délai, il faut la confirmer comme telle. - L’accusé de réception est daté avant l’envoi, comme une réservation. Si on est sûr que l’envoi a échoué, cette date est retirée. Du coup, deux envois simultanés n’en font partir qu’un.
- Tant que la rétractation est ouverte, la commande ne part ni en fabrication ni en expédition. Elle repart quand un remboursement a abouti après la demande, même partiel (
modules/orders/lib/withdrawal-release.ts#withdrawalReleasedWhere). - On peut clore la rétractation sans remboursement (
#closeWithdrawal), en disant pourquoi : le client y renonce, le contrat n’y donne pas droit, ou la demande a été enregistrée par erreur (WithdrawalClosure). C’est refusé après un remboursement abouti. - Les rappels restent internes. La veille signale un accusé de réception absent et relance son envoi. Elle signale aussi une demande non remboursée après sept jours, la moitié du délai légal de remboursement (
CANCELED_ORDER_REFUND_MAX_AGE_MS). Le téléphone du propriétaire reçoit la demande par notification.
Les retours
- Une pièce rapportée sur une commande expédiée ou livrée se reprend en stock (
fulfillment-restock.service.ts#restockReturnedItems). Il n’y a que les pièces suivies qui reviennent, par un mouvement de retour, et on ne dépasse pas ce qui reste à rentrer. Ce geste ne dépend pas du remboursement. On peut rembourser avant que la pièce revienne, ou l’inverse. - On peut clore un retour sans pièce (
#closeReturnWithoutPiece) quand la commande est remboursée en entier et que rien ne reviendra. C’est le cas d’un meuble détruit chez le transporteur, par exemple. La base vérifie que c’est cohérent (Order_returnClosedAt_check). - La veille signale une commande remboursée dont la pièce n’est pas revenue, quatorze jours après la demande de rétractation ou le remboursement, plus trois jours de transport.
- La reprise de l’ancien meuble, ce n’est pas un retour. Le client la demande au paiement quand le mode de livraison la propose (
takebackRequested). L’ERP l’affiche sur la commande et la fiche du client, sans état ni mouvement de stock.
Les réserves et le transporteur
Quand un meuble arrive abîmé, le client écrit des réserves sur le bon du transporteur, et le magasin n’a que peu de jours pour réclamer.
- On note les réserves comme le client les a écrites, sur une commande expédiée ou livrée (
modules/orders/services/delivery-follow-up.service.ts#recordDeliveryReserves). - La réclamation au transporteur se marque comme envoyée (
carrier-claim.service.ts#markCarrierClaimed), seulement s’il y a des réserves et une livraison (un retrait ne compte pas). L’ERP en prépare le brouillon (carrier-claim-draft.service.ts). - Le délai est de trois jours après la réception, jours fériés exclus. C’est l’article L133-3 du Code de commerce (
modules/orders/lib/delivery-follow-up.ts#carrierClaimLastDay). Tant que la réclamation n’est pas partie, la fiche du client la signale (afterSalesSignals). - Les réserves et la réclamation n’engagent pas de remboursement. C’est une décision à part.
Les litiges bancaires
Quand la banque d’un client conteste un paiement en ligne, Stripe ouvre un litige.
- Il n’y a que le webhook qui l’écrit (
modules/payments/services/webhook-dispute.service.ts#handleDisputeEvent), et il relit le litige chez Stripe à chaque événement. Un état final ne revient jamais à un état antérieur. Si un événement essaie, une alerte part. La date limite de réponse vient de Stripe (dueBy). - Un litige ouvert, même une simple demande d’informations, bloque l’expédition. Un litige perdu bloque aussi la fabrication. Dans les deux cas, les remboursements et la correction de prix sont bloqués.
- La réponse se donne chez Stripe. L’ERP en rédige le brouillon (
dispute-response-draft.service.ts) et prévient le propriétaire sur son téléphone. - Un litige perdu n’émet pas d’avoir. Il entre dans les encaissements de l’exercice comme un mouvement à part.
Ce que le logiciel ne suit pas
- La garantie. Le code le dit : « Une demande de garantie faite par téléphone ou par e-mail n’y figure pas : le logiciel ne la note nulle part » (
customer-affairs.ts). On l’écrit dans la note interne de la commande. - L’échange. Avant le départ, il passe par un changement de déclinaison (Stock). Après, c’est un retour, un remboursement, puis une nouvelle vente.
- Le transport du retour, avec ses frais et son rendez-vous.
- Une commande anonymisée ne reçoit plus d’avoir. La correction revient au comptable.
Pourquoi sur la commande
Les gestes du SAV agissent sur les gardes de la commande. Une rétractation ou un litige doit bloquer l’expédition directement dans la mise à jour conditionnelle qui la fait (modules/orders/services/fulfillment-guards.ts#departureGuardWhere). Un remboursement est borné par l’encaissé de la commande, sous son verrou. Avec une table de tickets à part, il faudrait la lire dans chacune de ces gardes, et faire en sorte qu’elle reste d’accord avec la commande.
Ce qu’on y gagne, c’est qu’il n’y a rien à synchroniser. La fiche du client relit les mêmes colonnes que les gardes, et la veille aussi. Par contre, une commande n’a qu’un texte de réserves et qu’une date de réclamation. Donc une seconde avarie sur la même commande s’écrit par-dessus. Et ce qui n’est pas lié à une commande, comme la garantie, n’a pas de place.