Saltar al contenido
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Notificaciones de envíos

La URL que implementa tu Carrier para recibir los eventos de sus envíos.

Notificaciones de envíos (las recibe el carrier)

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.
Parámetros de encabezado
X-Zipnova-Eventstring · enumRequerido

Evento notificado (igual al campo event del body)

Valores posibles:
X-Zipnova-TimestampstringRequerido

Timestamp Unix del envío

Example: 1790000000
X-Zipnova-SignaturestringRequerido

v1=hex(HMAC-SHA256(hmac_secret, "{timestamp}.{body}")). Ver el security scheme zipnovaSignature.

Carga útil

Aviso liviano: el detalle completo del envío se consulta con GET /shipments/{shipment_id}.

notification_idstringRequerido

Identificador de la notificación: es el mismo en los reintentos y si un evento llega más de una vez. Usarlo para deduplicar.

Example: dmnd293fwn229f3
eventstring · enumRequerido

new: 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.

Example: newValores posibles:
shipment_idintegerRequerido

ID del envío en Zipnova

Example: 26461102
carrier_idintegerRequerido

ID del carrier

Example: 312
occurred_atstring · date-timeRequerido

Momento del evento (ISO 8601)

Example: 2026-09-25T10:15:00-03:00
Respuestas
2XX

Notificación recibida

Sin contenido

Payload

{
  "notification_id": "dmnd293fwn229f3",
  "event": "new",
  "shipment_id": 26461102,
  "carrier_id": 312,
  "occurred_at": "2026-09-25T10:15:00-03:00"
}

Última actualización