Skip to Content
Meubles Morinière

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

Fournisseurs et achats

La fiche d’un fournisseur et son lexique, la commande fournisseur du brouillon à la réception, l’achat lié à la ligne d’un client, les corrections, les retours et le réassort.

Not translated yet

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

Une commande client en déclenche souvent une autre chez un fournisseur : un fauteuil dans un tissu choisi, une table aux cotes du client, une pièce en rupture. L’achat doit rester lié au client qui l’attend, de la commande jusqu’à la réception. Et quand un fournisseur est en retard, il faut que ça se voie sur la date promise.

Les chemins sans préfixe partent de apps/erp/modules/purchase-orders/.

Les achats lisent le catalogue (référence, coût, politique de stock) et les lignes des commandes clients. Ils écrivent au journal du stock et dans le coût des pièces. La date de livraison annoncée par le fournisseur se compare à l’échéance de l’atelier (Délais et dates promises). Et la réception sert d’abord le client qui attend la pièce.

Le fournisseur

Un fournisseur n’a pas d’état énuméré. Il est actif ou archivé (archivedAt). Son nom est unique parmi les fournisseurs actifs, grâce à un index unique partiel (Supplier_name_key). Le service compare aussi les noms normalisés, donc « Atelier Dupont » et « atelier dupont » ne peuvent pas coexister (modules/suppliers/services/supplier-admin.service.ts#isNameTaken). Toutes les écritures passent sous le même verrou consultatif (shared/server/supplier-lock.ts#lockSuppliers).

  • Dès qu’on a passé une commande à un fournisseur, son nom, son adresse, son pays et son e-mail ne changent plus (#isIdentityLocked). Du coup, un bon de commande relit la fiche, et la fiche ne peut pas le réécrire. Ce gel remplace des colonnes de copie sur chaque achat. Par contre, un fournisseur qui déménage, il faut l’archiver et le recréer.
  • Dans la base, Supplier_identifiers_check contrôle le pays sur deux lettres, le SIREN (neuf chiffres, pour un fournisseur français seulement) et la forme du numéro de TVA.
  • Le pays a un effet sur le catalogue. Un fournisseur ne peut pas passer hors de l’Union tant que des meubles publiés de chez lui portent une marque sans personne responsable dans l’Union (OUTSIDE_EU_PUBLISHED). Ces fiches doivent nommer cette personne.
  • Un fournisseur archivé ne reçoit plus de commande, et ses brouillons ne se passent plus. Il ne se restaure pas si son nom a été repris entre-temps. Il ne se supprime pas s’il a reçu des commandes ou s’il a des meubles. Sans fournisseur, le site présenterait le meuble comme une création de l’atelier.

Chaque fournisseur a aussi sa façon d’écrire : « chêne nat. », « gris anthracite ». Une entrée de son lexique (SupplierLexiconEntry) traduit un mot de ses documents vers une couleur, une matière ou un texte du catalogue, avec une seule cible à la fois (SupplierLexiconEntry_value_check). Elle est créée à partir d’un écart relevé sur un accusé de réception, quand la personne choisit de le retenir (services/supplier-lexicon-retention.service.ts#retainSupplierLexiconEntry, plafonné par SUPPLIER_LEXICON_MAX_ENTRIES). Ensuite, elle sert à lire les documents de ce fournisseur : accusé de réception, bon de livraison, offre (Fisher).

La commande fournisseur

Elle a quatre états, et c’est la base qui les fait respecter : brouillon, passée, reçue, annulée (PurchaseOrderStatus). Le trigger PurchaseOrder_transition n’admet que ces passages :

VersDepuis
Passéebrouillon, ou reçue pour rouvrir une commande soldée avant d’avoir tout reçu
Reçuepassée
Annuléebrouillon, ou passée sans aucune pièce reçue

Les dates (orderedAt, receivedAt, canceledAt) suivent le statut, et PurchaseOrder_status_check vérifie qu’elles restent cohérentes. « Reçue en partie » et « soldée », ce ne sont pas des états. L’écran déduit ces libellés des quantités reçues. Le numéro (BC-2026-000123) vient d’une séquence et il peut avoir des trous, parce qu’un brouillon se supprime. Un bon de commande n’est pas une pièce comptable, donc il n’a pas besoin d’un compteur sans trou.

  1. On prépare un brouillon par fournisseur. services/purchase-order.service.ts#savePurchaseOrder verrouille la commande, compare les lignes à celles que l’écran a lues (CHANGED si quelqu’un les a modifiées), puis les remplace d’un bloc (#replaceDraftLines). Il refuse deux lignes « pour le stock » sur la même pièce, une ligne client commandée deux fois ou au-delà de son besoin, une ligne libre sans libellé, et plus de cent lignes. La base n’accepte une nouvelle ligne que sur un brouillon (PurchaseOrderLine_guard).
  2. Pour passer la commande, il faut un fournisseur actif, au moins une ligne, et un prix sur chaque ligne (UNPRICED_LINE). Le bon part ensuite par e-mail ou en PDF. Une fois la commande passée, on ne peut plus changer que la référence du fournisseur, la date annoncée et la note.
  3. Ensuite, on suit l’achat. Chaque achat a sa prochaine étape (relancer un retard, demander une date), et le tableau de bord compare les retards annoncés à l’échéance promise par l’atelier. Quand le fournisseur annonce une date (expectedOn) au jour où l’atelier doit expédier ou après, les commandes clients qui attendent ses pièces sont touchées (shared/lib/supply-promise.ts#isSupplyAfterDue). L’achat les montre, et l’avis au client part de la fiche (modules/orders/services/supply-notice.service.ts). Si le fournisseur repousse encore, l’avis redevient à envoyer, pour ces commandes-là seulement (services/supplier-delay-notice-reset.ts#reopenSupplierDelayNotices). Une date avancée ne touche à rien. Fisher lit l’accusé de réception du fournisseur. Il relève les écarts de prix, de finition, de couleur ou de cotes avec ce que le client a acheté.
  4. La réception est décrite plus bas.
  5. À la fin, on peut solder, annuler ou rouvrir. Solder (#closePurchaseOrder) clôt une commande dont une partie est arrivée. On renonce au reste. Le service rend la liste des pièces clientes qui ne sont plus commandées nulle part, pour que la personne les recommande. Annuler n’est possible qu’avant toute réception, et la base le vérifie aussi. Rouvrir n’est possible que pour une commande soldée avec un reliquat. Et ça ne marche pas si la ligne du client a été recommandée ailleurs entre-temps (REOPEN_REORDERED).

Il n’y a qu’un brouillon qui se supprime (PurchaseOrder_guard_delete).

L’achat lié au client

Une ligne d’achat peut viser la ligne de commande du client pour qui la pièce est commandée (PurchaseOrderLine.orderItemId).

  • On peut lier une ligne client pas encore préparée, sur une commande que l’atelier doit encore, pour une pièce fabriquée à la commande ou en rupture (lib/held-order-item.ts#heldOrderItemWhere). Une ligne client n’attend qu’un seul achat en cours (assertLinkable : ORDER_ITEM_ALREADY_ORDERED, ORDER_ITEM_COVERED).
  • Le lien se fait sur le brouillon, ou à la réception si la ligne n’a encore rien reçu. Il peut aussi partir de la commande client (services/order-for-customer.service.ts#orderForCustomer). Dans ce cas, la pièce rejoint le dernier brouillon de son fournisseur habituel, ou elle en ouvre un.
  • Dans la base, le lien ne change que sur une commande en brouillon ou passée (PurchaseOrderLine_guard), et il retient la ligne du client (onDelete: Restrict).
  • Les pièces mises de côté pour le client se déduisent. Ce sont les pièces reçues sur la ligne, moins celles qui sont entrées en stock (shared/lib/reserved-pieces.ts#unstockedOnLine). Il n’y a pas de table de réservations à maintenir. Quand le client annule, se fait rembourser ou change de déclinaison, ses pièces réservées entrent en stock par un mouvement de réception tardif, au coût de sa ligne (modules/orders/services/reserved-pieces.ts#restockReservedPieces). Et le lien vers les achats encore ouverts se défait.

La réception

services/purchase-order-receipt.service.ts#receivePurchaseOrder ne reçoit que sur une commande passée. Il verrouille dans un ordre fixe : la commande, puis les lignes clientes concernées, puis les déclinaisons triées par identifiant.

  • Chaque ligne renvoie la quantité déjà reçue que l’écran affichait. Si elle a changé, la réception est refusée (RECEIPT_STALE). Du coup, deux personnes qui reçoivent le même colis n’ajoutent pas deux fois les pièces. La mise à jour a cette quantité dans sa condition, et la base borne la quantité reçue entre zéro et la quantité commandée (PurchaseOrderLine_amounts_check). Un trigger interdit aussi qu’une ligne fasse entrer en stock plus qu’elle n’a reçu (StockMovement_purchase_line_insert).
  • Le client passe d’abord. Pour une pièce suivie, ce que le client lié attend encore lui est mis de côté (held-order-item.ts#piecesForCustomer), et le reste entre en stock au coût moyen pondéré. Une pièce fabriquée à la commande n’entre pas en stock. Elle prend le prix d’achat comme prix de revient. Une ligne libre, hors catalogue, ne fait avancer que sa quantité reçue.
  • Le prix retenu est celui saisi à la réception. S’il n’y en a pas, c’est celui de la facture du fournisseur, et sinon celui de la commande.
  • Tant qu’il manque des pièces, la commande reste passée. Elle devient reçue toute seule quand tout est arrivé.
  • Une ligne de bois reçue porte la référence de diligence raisonnée que demande le règlement européen contre la déforestation (EUDR), ou le motif de son absence (DueDiligenceBasis). Une fois le règlement applicable, la réception refuse une ligne de bois qui n’a ni l’une ni l’autre (lib/due-diligence.ts#isDueDiligenceMissing). La base n’admet un motif que sur une ligne de bois (PurchaseOrderLine_due_diligence_basis_check).

Corriger et renvoyer

Une erreur se corrige par un geste qui laisse une trace. On ne réécrit rien (services/purchase-line-adjustment.service.ts).

  • Corriger une réception : on retire d’abord les pièces entrées en stock, puis celles réservées au client (lib/purchase-line-adjustment.ts#splitReceiptCorrection). C’est refusé si ces pièces sont déjà vendues (ABOVE_STOCK) ou si celle du client est déjà préparée (RESERVED_PICKED). Une commande reçue en entier repasse alors à « passée ».
  • Renvoyer au fournisseur : pour les pièces suivies seulement. Si on attend un remplacement, c’est une correction de réception. Sinon, un mouvement de retour au fournisseur (SUPPLIER_RETURN) sort les pièces du stock, et la quantité reçue reste entière.
  • Corriger le prix d’achat : les pièces encore en stock sont réévaluées par une paire, une sortie puis une entrée au nouveau coût. La ligne du client prend le prix facturé. Et pour une pièce fabriquée à la commande, ce prix devient son prix de revient.

Après une sortie de stock, shared/server/sold-reservations.ts#releaseSoldReservations ferme chez Stripe, hors transaction, les paniers qui retenaient une pièce qui n’existe plus. Si Stripe ne répond pas, il alerte l’équipe.

La facture électronique reçue

Depuis le 1ᵉʳ septembre 2026, un fournisseur soumis à la facture électronique l’envoie par une plateforme agréée. L’ERP n’est pas cette plateforme et ne lui parle pas : la personne y télécharge le fichier et le dépose dans l’ERP (modules/supplier-invoices).

  • La lecture est déterministe, sans IA : le XML d’un Factur-X est extrait de son PDF (lib/factur-x-pdf.ts#facturXXmlOf), puis lu dans les deux syntaxes de la norme EN 16931, CII et UBL (lib/e-invoice-reading.ts#readEInvoice). Un champ obligatoire illisible fait échouer le dépôt, avec son nom.
  • Le dépôt refuse une autre devise que l’euro, un autre destinataire que le magasin, des totaux qui ne retombent pas, un doublon, et un vendeur dont le SIREN ou le n° de TVA n’est celui d’aucun fournisseur (services/supplier-invoice.service.ts#depositSupplierInvoice). Le fichier est archivé tel quel, sous son empreinte.
  • Le rapprochement suit le numéro de commande que la facture cite. Les écarts de prix et de quantité se recalculent à chaque lecture, contre l’achat et les autres factures du même achat (lib/supplier-invoice-check.ts#checkInvoice).
  • L’état reprend les noms du cycle de vie de la norme (approuvée, en litige, refusée, payée), avec le motif d’un litige ou d’un refus. Il reste dans l’ERP : le statut se pose à la main sur la plateforme. En base, ce que dit la facture ne change plus (SupplierInvoice_guard).

Le réassort

services/stock-reorder.service.ts#prepareReorderPurchaseOrder prépare un brouillon par fournisseur pour les pièces passées sous leur seuil. Le seuil, c’est celui de la pièce, et si elle n’en a pas, celui du magasin (ProductVariant_reorder_threshold_check). La quantité proposée ramène le stock au-dessus du seuil, en comptant les pièces déjà attendues (lib/stock-reorder.ts#reorderQuantity). Les pièces déjà présentes sur un brouillon sont laissées de côté. Le prix proposé est celui du dernier achat chez ce fournisseur, sinon le prix de revient.

La création du brouillon et l’écriture de ses lignes ne sont pas atomiques. Si ça échoue, on supprime le brouillon créé.

Les limites

  • Les états dérivés (« reçue en partie », « soldée », les pièces réservées) ne sont pas stockés. Ils se recalculent à chaque lecture. Ça coûte une agrégation de plus par écran, mais il n’y a pas de donnée à garder synchrone.
  • Le bon de commande relit la fiche du fournisseur. Donc pour changer une adresse, il faut archiver puis recréer le fournisseur.
  • Seules les factures électroniques des fournisseurs connus entrent dans l’ERP. Une facture en PDF simple ne laisse que son prix (invoicedUnitCostCents), qui corrige le coût. Aucune plateforme agréée n’est branchée : ni réception automatique, ni statut renvoyé. Et la comptabilité des achats, TVA déductible comprise, reste chez le comptable.

On this page