Webhooks v1
Enviar un tracking por POST desde entrada, sacos y facturas, y revisar el resultado.
Droka avisa a su servidor con un POST por tracking. No manda una lista de códigos en un solo mensaje.
Guardar un manifiesto de salida (MS) o un manifiesto de Origin no dispara este webhook. Los códigos de una salida salen cuando se crea la factura que los incluye.
Qué se envía
| Origen | Cuándo | Dónde se prende |
|---|---|---|
| Entrada (ME) | Al guardar el manifiesto de entrada | Conectores, webhook de entrada |
| Saco mal identificado | Al pulsar Enviar en sacos pendientes. Generar ME no lo envía | Conectores, webhook de saco (URL, secreto y prefijo propios) |
| Factura | Al crear la factura, si el interruptor está encendido. También con Enviar webhooks en la lista | Conectores → Facturas |
Apagado, o sin una URL HTTPS válida, no encola nada. La factura o el manifiesto se guardan igual.
Cómo armar la URL
Use HTTPS. En la plantilla puede poner `{WAREHOUSE}` o `{manifesto_number}`. Droka lo cambia por el identificador público. Si la URL no trae ese hueco, el identificador se agrega al final.
Ejemplo de factura con prefijo FA y número FACT-3675:
POST https://su-servidor.example/webhooks/scan/FA-FACT-3675
X-Webhook-Secret: el secreto de Facturas
El secreto de entrada, el del saco y el de facturas son distintos. El encabezado siempre se llama X-Webhook-Secret.
El identificador de la factura se guarda en mayúsculas. fa + fact-3675 queda FA-FACT-3675.
Ejemplo de cuerpo
Factura. is_unknown va en false. Las fechas salen de la creación de la factura, en hora de Panamá (AAAA-MM-DD HH:mm:ss).
{
"_id": "TESTFANTASMAFIX92",
"package_type": 0,
"date_of_admission": "2026-06-15 14:22:33",
"modified": "2026-06-15 14:22:33",
"created": "2026-06-15 14:22:33",
"stage": "FA-FACT-3675",
"state": 2,
"is_processed": 1,
"user_id": 1,
"is_unknown": false
}
Saco: el mismo cuerpo, con is_unknown en true y stage igual al id público del saco (por ejemplo SACO-12).
Entrada: el mismo cuerpo. is_unknown sigue el interruptor Mal identificado de ese manifiesto.
stage y la última parte de la URL son el mismo identificador.
De dónde salen los códigos de la factura
- Línea normal: los trackings escritos en la factura.
- Línea MS · N piezas: solo los trackings de ese manifiesto de salida.
- Un código idéntico se envía una vez.
TRK-Aytrk-ason dos envíos.
Editar la factura no vuelve a enviar. Recargar la pantalla de confirmación tampoco.
Revisar
Abrir Envíos webhook
Configuración → Conectores → Envíos webhook. Desde Facturas también sirve Ver envíos.
Elegir la pestaña
Atención abre primero: solo rechazados. En curso: pendientes. Enviados: aceptados de los últimos 30 días.
Buscar
Escriba el tracking o el número (FA-FACT-3675, ME-1042, SACO-12). Puede filtrar Factura, Entrada o Saco.
Abrir la fila
Vea el código HTTP y el texto que contestó el receptor. Un HTTP 200 con cuerpo vacío dice Sin mensaje del servidor.
La pantalla se actualiza sola mientras la tiene abierta y hay envíos en curso. No recargue para ver el resultado.
En la lista de facturas, el icono junto al correo dice lo mismo en corto: ámbar en curso, verde enviado, rojo si alguno falló.
Reintentar
Reintentar aparece solo en una fila de Atención. Vuelve a mandar ese tracking. No crea una fila nueva.
No reintente una fila que ya está en Enviados. Enviar webhooks en la lista de facturas tampoco la duplica: la deja como ya enviada.
Si el receptor contestó 403 o 429, la pantalla avisa que los demás esperan. No pulse reintento en masa.
Liberar espacio
Borrar enviados de más de 90 días quita solo lo ya aceptado y viejo. Pendientes, en curso y rechazados se quedan. El diálogo dice cuántos va a borrar.
Quien no administra conectores no ve esta pantalla.
Si algo no aparece o el receptor lo rechazó, siga Webhooks que no salen.