Aller au contenu principal

Mise à jour du stock

Intent

Maintenir les quantités de stock cohérentes entre Magento, LogiDAV et les marketplaces, en journalisant chaque mutation.

Déclencheur

  • Automatique : lors de l'import de ventes en statut processing/complete
  • Automatique : lors de la mise à jour de statut d'une vente
  • Cronjob : commandes dédiées de synchronisation du stock

Composants principaux

ComposantRôle
ProductQtyLogServiceJournalisation de toutes les mutations de stock
SaleServiceDéclenche les mutations lors de l'import des ventes
Commandes de stockSynchronisation bidirectionnelle avec les sources externes

Flux de mutation

Effets de bord

  • Décrémentation du stock disponible
  • Journalisation de chaque mutation pour audit
  • Synchronisation des nouvelles quantités vers les marketplaces

Modes d'échec

  • Double décrémentation : si une même vente est importée deux fois (upsert non idempotent sur le stock)
  • Stock négatif : pas toujours bloquant selon la configuration
  • Délai de propagation : le stock n'est pas mis à jour instantanément sur les marketplaces

Chemin de débogage

  1. Consulter les logs ProductQtyLogService pour la mutation concernée
  2. Vérifier le statut de la vente associée
  3. Comparer le stock LogiDAV avec le stock Magento
  4. Vérifier les files d'attente de synchronisation marketplace