Suscríbete a los eventos del ciclo de vida de pedidos y presupuestos desde sistemas externos. Pedido creado, estado cambiado, enviado, cancelado, reembolsado—todo en tiempo real vía SNS y webhooks configurables.
Webhooks de pedido ya activos
Los webhooks para los eventos de pedido ya están activos en Veendo. No es una función por venir—puedes suscribirte a ellos hoy mismo desde el panel admin. Cada evento (ORDER_CREATED, ORDER_STATUS_UPDATED, ORDER_SHIPPED, ORDER_CANCELLED, ORDER_REFUNDED) se publica en SNS Topics y se reenvía a los endpoints HTTP que configures.
Eventos del ciclo de vida
Cada evento contiene el body JSON completo del pedido: ID, cliente, artículos, precios, dirección, estado de pago y estado de envío. Los endpoints reciben los datos inmediatamente después del evento: sin retraso, todo es en tiempo real vía SNS publish/subscribe.
Supported events: - ORDER_CREATED: nuevo pedido insertado - ORDER_STATUS_UPDATED: cambio de estado (pre-order, confirmed, shipped, cancelled, refunded) - ORDER_SHIPPED: pedido enviado (info de seguimiento incluida) - ORDER_CANCELLED: pedido cancelado por el cliente o el admin - ORDER_REFUNDED: reembolso total o parcial procesado
- Evento con los datos completos del pedido (cliente, artículos, precio, impuestos, envío)
- SNS Topic para múltiples suscripciones (puedes conectar varios webhooks)
- Retry automático en caso de fallo del endpoint (exponential backoff)
- Firma HMAC-SHA256 para verificar la autenticidad del webhook
- Compatibilidad con SQS, Lambda, endpoint HTTP
Integración ERP/WMS en tiempo real
Usa los webhooks para sincronizar pedidos con un ERP (SAP, NetSuite, Zucchetti, etc.) o un WMS en tiempo real. Cuando se crea un pedido en Veendo, tu sistema lo recibe al instante y puede iniciar el picking.
Verifica siempre la firma HMAC del webhook para evitar ataques de repetición; tu webhook secret se genera desde el panel y se muestra una sola vez.
Configuración de webhooks desde el panel
Desde el panel Admin > Integraciones > Webhooks, añade un endpoint HTTPS público que recibirá el POST JSON. Selecciona los eventos que te interesan, copia el webhook secret y prueba con un pedido de prueba.
Cada webhook puede habilitarse/deshabilitarse por separado, y tienes visibilidad sobre cada entrega: timestamp, body enviado, respuesta recibida, estado de los retry.
- Endpoint HTTPS con autenticación HMAC-SHA256
- Body JSON estructurado, codificado en UTF-8
- Retry hasta 5 intentos con exponential backoff (5s, 10s, 20s, 40s, 80s)
- Log de consola para depuración directa en el panel de Veendo
Seguridad y fiabilidad
Cada webhook incluye una firma HMAC calculada con tu secret; verifica el timestamp para evitar ataques de repetición. Si tu endpoint no responde, SNS reintenta automáticamente. Si eso tampoco funciona, el evento permanece en cola para sincronizarse en el siguiente polling.
- Firma HMAC-SHA256 (header: X-Veendo-Signature) para la autenticación
- Timeout del endpoint: 30 segundos
- Dead letter queue para fallos persistentes (contacta con soporte)
- Compatibilidad multi-region: webhook resiliente a fallos regionales