ODECISDocumentacion
Ir al Sistema

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 instantaneas cuando ocurren eventos

Reintentos automaticos

Reintentamos hasta 6 veces si tu servidor no responde

Eventos disponibles

productos

product.createdUn nuevo producto fue creado
product.updatedUn producto fue actualizado
product.deletedUn producto fue eliminado

inventario

stock.changedEl stock de un producto cambio

ventas

order.createdUna nueva orden de venta fue creada
order.status_changedEl estado de una orden cambio
order.cancelledUna orden fue cancelada

facturacion

invoice.createdUn comprobante electronico fue emitido
invoice.cancelledUn comprobante fue anulado

Formato 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"
    }
  }
}

Politica de reintentos

IntentoEspera
Intento 1Inmediato
Intento 21 minuto
Intento 35 minutos
Intento 415 minutos
Intento 51 hora
Intento 62 horas

Mejores practicas

  • Responde rapido: Devuelve 200 OK inmediatamente
  • Usa HTTPS: Solo aceptamos endpoints con SSL valido
  • Verifica la firma: Siempre valida X-Webhook-Signature
  • No confies en el orden: Los webhooks pueden llegar desordenados