Sottoscrivi gli eventi del ciclo di vita di ordini e preventivi da sistemi esterni. Ordine creato, stato cambiato, spedito, cancellato, rimborsato—tutto in tempo reale via SNS e webhook configurabili.
Webhook ordine già live
I webhook per gli eventi di ordine sono già attivi in Veendo. Non è una feature in arrivo—puoi sottoscriverli oggi dal pannello admin. Ogni evento (ORDER_CREATED, ORDER_STATUS_UPDATED, ORDER_SHIPPED, ORDER_CANCELLED, ORDER_REFUNDED) viene pubblicato su SNS Topics e inoltrato a endpoint HTTP che tu configurti.
Eventi del ciclo di vita
Ogni evento contiene il body JSON completo dell'ordine: ID, cliente, articoli, prezzi, indirizzo, stato di pagamento e stato di spedizione. Gli endpoint ricevono i dati subito dopo l'evento: non c'è ritardo, tutto è real-time via SNS publish/subscribe.
Supported events: - ORDER_CREATED: nuovo ordine inserito - ORDER_STATUS_UPDATED: cambio stato (pre-order, confirmed, shipped, cancelled, refunded) - ORDER_SHIPPED: ordine spedito (tracking info incluso) - ORDER_CANCELLED: ordine cancellato dal cliente o admin - ORDER_REFUNDED: rimborso completo o parziale processato
- Evento contenente dati ordine completi (cliente, item, prezzo, tasse, spedizione)
- SNS Topic per subscribe multipli (puoi collegare più webhook)
- Retry automatico in caso di fallimento endpoint (exponential backoff)
- Signature HMAC-SHA256 per verificare autenticità webhook
- Supporto per SQS, Lambda, HTTP endpoint
Ordini di integrazione ERP/WMS
Usa i webhook per sincronizzare ordini con ERP (SAP, NetSuite, Zucchetti, ecc.) o WMS in tempo reale. Quando un ordine viene creato in Veendo, il tuo sistema lo riceve istantaneamente e può iniziare il picking.
Verifica sempre la firma HMAC del webhook per evitare replay attack; il tuo webhook secret viene generato dal pannello e visualizzato una sola volta.
Configurazione webhook dal pannello
Dal pannello Admin > Integrazioni > Webhook, aggiungi un endpoint HTTP pubblico (https) che riceverà il POST JSON. Seleziona gli eventi che ti interessano, copia il webhook secret e testa con un ordine di prova.
Ogni webhook può essere abilitato/disabilitato separatamente, e hai visibilità su ogni consegna: timestamp, body inviato, risposta ricevuta, retry status.
- Endpoint HTTPS con autenticazione HMAC-SHA256
- Body JSON strutturato, UTF-8 encoded
- Retry fino a 5 tentativi con backoff exponential (5s, 10s, 20s, 40s, 80s)
- Log console per debug diretto sul pannello Veendo
Sicurezza e affidabilità
Ogni webhook include firma HMAC calcolata con il tuo secret; verifica il timestamp per evitare replay attack. Se il tuo endpoint non risponde, SNS ritenta automaticamente. Se nemmeno questo funziona, l'evento rimane in coda per poi essere sincronizzato dal prossimo polling.
- Firma HMAC-SHA256 (header: X-Veendo-Signature) per autenticazione
- Timeout endpoint: 30 secondi
- Dead letter queue per fallimenti persistenti (contatta support)
- Supporto multi-region: webhook resiliente a fallimenti regionali