Abonnez-vous aux événements du cycle de vie des commandes et des devis depuis des systèmes externes. Commande créée, statut modifié, expédiée, annulée, remboursée—le tout en temps réel via SNS et des webhooks configurables.
Webhooks de commande déjà actifs
Les webhooks pour les événements de commande sont déjà actifs dans Veendo. Ce n'est pas une fonctionnalité à venir—vous pouvez vous y abonner dès aujourd'hui depuis le panneau admin. Chaque événement (ORDER_CREATED, ORDER_STATUS_UPDATED, ORDER_SHIPPED, ORDER_CANCELLED, ORDER_REFUNDED) est publié sur des SNS Topics et transmis aux endpoints HTTP que vous configurez.
Événements du cycle de vie
Chaque événement contient le body JSON complet de la commande : ID, client, articles, prix, adresse, statut de paiement et statut d'expédition. Les endpoints reçoivent les données immédiatement après l'événement : pas de délai, tout est en temps réel via SNS publish/subscribe.
Supported events: - ORDER_CREATED : nouvelle commande insérée - ORDER_STATUS_UPDATED : changement de statut (pre-order, confirmed, shipped, cancelled, refunded) - ORDER_SHIPPED : commande expédiée (infos de suivi incluses) - ORDER_CANCELLED : commande annulée par le client ou l'admin - ORDER_REFUNDED : remboursement total ou partiel traité
- Événement contenant les données complètes de la commande (client, articles, prix, taxes, expédition)
- SNS Topic pour des abonnements multiples (vous pouvez relier plusieurs webhooks)
- Retry automatique en cas d'échec de l'endpoint (exponential backoff)
- Signature HMAC-SHA256 pour vérifier l'authenticité du webhook
- Prise en charge de SQS, Lambda, endpoint HTTP
Intégration ERP/WMS en temps réel
Utilisez les webhooks pour synchroniser les commandes avec un ERP (SAP, NetSuite, Zucchetti, etc.) ou un WMS en temps réel. Lorsqu'une commande est créée dans Veendo, votre système la reçoit instantanément et peut démarrer le picking.
Vérifiez toujours la signature HMAC du webhook pour éviter les attaques par rejeu ; votre webhook secret est généré depuis le panneau et affiché une seule fois.
Configuration des webhooks depuis le panneau
Depuis le panneau Admin > Intégrations > Webhooks, ajoutez un endpoint HTTPS public qui recevra le POST JSON. Sélectionnez les événements qui vous intéressent, copiez le webhook secret et testez avec une commande d'essai.
Chaque webhook peut être activé/désactivé séparément, et vous avez une visibilité sur chaque livraison : timestamp, body envoyé, réponse reçue, statut des retry.
- Endpoint HTTPS avec authentification HMAC-SHA256
- Body JSON structuré, encodé en UTF-8
- Retry jusqu'à 5 tentatives avec exponential backoff (5s, 10s, 20s, 40s, 80s)
- Log console pour un débogage direct sur le panneau Veendo
Sécurité et fiabilité
Chaque webhook inclut une signature HMAC calculée avec votre secret ; vérifiez le timestamp pour éviter les attaques par rejeu. Si votre endpoint ne répond pas, SNS réessaie automatiquement. Si cela ne fonctionne pas non plus, l'événement reste en file d'attente pour être ensuite synchronisé au prochain polling.
- Signature HMAC-SHA256 (header : X-Veendo-Signature) pour l'authentification
- Timeout de l'endpoint : 30 secondes
- Dead letter queue pour les échecs persistants (contactez le support)
- Prise en charge multi-region : webhook résilient aux pannes régionales