Événements

Stock

Signaler chaque changement de quantité au moment où il arrive, ventes comprises.

Capacité stock.read, qui repose sur catalog.read.

stock.changed

{
  "eventId": "019a3b1e-7c2d-7f3a-9b1e-2d4c6e8f0a12",
  "type": "stock.changed",
  "occurredAt": "2026-10-30T14:02:11.482913+01:00",
  "payload": { "productId": "NOZA-CEND0210", "quantity": 17 }
}
  • quantity est ce qui peut se vendre maintenant, réservations déduites : sur Sylius, onHand − onHold.
  • occurredAt est l'instant où ce nombre était vrai. Kult Lab s'en sert pour écarter une lecture dépassée.

Quand l'envoyer

À chaque changement, au moment où il arrive, ventes comprises. C'est la lecture de stock qui fait descendre une vente de votre boutique dans le stock du commerce : order.upserted ne fait jamais bouger le stock.

Envoyez-le aussi après un réassort, un inventaire ou une correction faits chez vous. Ne l'envoyez pas pour une quantité que Kult Lab vient de vous demander d'écrire par stock.set : la réponse à la commande suffit (Pas d'écho).

Les verdicts propres au stock

VerdictQuand
staleoccurredAt est plus ancien que la dernière quantité que Kult Lab tient de vous : rien ne bouge
queuedun stock.set de ce produit est parti et attend sa réponse : la lecture est gardée, puis appliquée

Kult Lab reste maître de la quantité. Il compare votre lecture à celle d'avant, en déduit le mouvement (une vente, un réassort) et l'écrit au registre du commerce. Il pousse ensuite la bonne quantité vers les autres canaux, et vers vous si l'envoi du stock est armé.

Copyright © 2026