Webhooks
Recibe notificaciones en tiempo real cuando ocurren eventos en ODECIS
Los webhooks te permiten recibir notificaciones HTTP en tiempo real cuando ocurren eventos en tu cuenta de ODECIS.
Tiempo real
Notificaciones instantáneas cuando ocurren eventos
Reintentos automáticos
Reintentamos hasta 6 veces si tu servidor no responde
Eventos disponibles
productos
product.createdUn nuevo producto fue creadoproduct.updatedUn producto fue actualizadoproduct.deletedUn producto fue eliminadoinventario
stock.changedEl stock de un producto cambióventas
order.createdUna nueva orden de venta fue creadaorder.status_changedEl estado de una orden cambióorder.cancelledUna orden fue canceladafacturacion
invoice.createdUn comprobante electrónico fue emitidoinvoice.cancelledUn comprobante fue anuladoFormato del payload
{
"event": "product.created",
"timestamp": "2025-12-12T15:30:00.000Z",
"webhookId": "wh_abc123xyz",
"data": {
"product": {
"id": "prod_123",
"sku": "LAP-HP-001",
"name": "Laptop HP ProBook",
"price": 2499.90,
"stock": 25,
"createdAt": "2025-12-12T15:30:00.000Z"
}
}
}Política de reintentos
| Intento | Espera |
|---|---|
| Intento 1 | Inmediato |
| Intento 2 | 1 minuto |
| Intento 3 | 5 minutos |
| Intento 4 | 15 minutos |
| Intento 5 | 1 hora |
| Intento 6 | 2 horas |
Mejores prácticas
- Responde rápido: Devuelve 200 OK inmediatamente
- Usa HTTPS: Solo aceptamos endpoints con SSL válido
- Verifica la firma: Siempre valida X-Webhook-Signature
- No confíes en el orden: Los webhooks pueden llegar desordenados