Notificaciones de envíos
La URL que implementa tu Carrier para recibir los eventos de sus envíos.
Zipnova avisa a la URL de notificaciones del carrier los eventos de sus envíos, de forma asincrónica.
- Cualquier respuesta 2xx confirma la recepción.
- Timeout de 3 s (1 s de conexión). Sin respuesta 2xx, se reintenta hasta 5 veces con espera creciente (30 s, 2 min, 10 min, 15 min).
- Puede llegar más de una vez el mismo evento: procesarlo de forma idempotente por shipment_id + event.
- No se siguen redirecciones.
Evento notificado (igual al campo event del body)
Timestamp Unix del envío
1790000000v1=hex(HMAC-SHA256(hmac_secret, "{timestamp}.{body}")). Ver el security scheme zipnovaSignature.
Aviso liviano: el detalle completo del envío se consulta con GET /shipments/{shipment_id}.
Identificador de la notificación: es el mismo en los reintentos y si un evento llega más de una vez. Usarlo para deduplicar.
dmnd293fwn229f3new: envío creado (queda en Procesando hasta que el carrier suba la etiqueta). ready_to_ship: listo para despacho. cancelled: anulado. expired: vencido sin despacharse.
newValores posibles: ID del envío en Zipnova
26461102ID del carrier
312Momento del evento (ISO 8601)
2026-09-25T10:15:00-03:00Notificación recibida
Sin contenido
Cualquier otra respuesta se reintenta
Payload
{
"notification_id": "dmnd293fwn229f3",
"event": "new",
"shipment_id": 26461102,
"carrier_id": 312,
"occurred_at": "2026-09-25T10:15:00-03:00"
}Última actualización