Webhooks que no salen
Qué revisar si un tracking no aparece, sigue en curso o el receptor lo rechaza.
Abra Configuración → Conectores → Envíos webhook. El recuadro de Facturas ya no muestra el historial: use Ver envíos.
La guía de uso está en Webhooks v1.
Síntoma y qué hacer
| Lo que ve | Causa habitual | Qué hacer |
|---|---|---|
| No hay filas | El conector está apagado, la URL no es HTTPS, o está en la pestaña equivocada | Prenda el conector de ese origen y guarde la URL. Mire Atención, En curso y Enviados. Busque el tracking |
| Aviso En cola: 10 y todavía no dice enviado | El aviso solo confirma que se encoló. El POST sale después | Deje abierta Envíos webhook. Se actualiza sola. No vuelva a enviar |
| El webhook de facturas está apagado | El interruptor de Facturas está off | Enciéndalo, guarde URL y secreto, y use Enviar webhooks en la lista. Crear la factura otra vez no hace falta si ya existe |
| HTTP 403 o 429 | El receptor rechazó o pidió espera. Los demás envíos pausan | Lea el aviso de la pantalla. Corrija el acceso en el receptor. Reintente una fila fallida cuando el aviso de espera desaparezca |
| HTTP 200 y el paquete no está en el receptor | Droka acredita la respuesta HTTP, no que el otro sistema lo haya guardado | Abra la fila y copie el texto de respuesta. No cambie el estado para forzar otro POST de una fila ya enviada |
| Sin mensaje del servidor | El receptor contestó 200 con cuerpo vacío, o el texto success | El envío HTTP sí salió. Confirme en el receptor con el _id |
| No veo Reintentar | La fila no está fallida, o no está en Atención | Reintentar solo existe en una fila rechazada. Una enviada no se duplica |
| Esperaba el webhook al guardar la salida | La salida (MS) y Origin no envían este webhook | Cree la factura, o use Enviar webhooks sobre esa factura. La línea MS · N piezas manda los trackings de esa salida |
| Edité la factura y no salió nada | Editar no encola | Use Enviar webhooks en la lista. Solo agrega códigos nuevos y reintenta los fallidos |
| Un enviado de hace meses no está en Enviados | Esa pestaña muestra los últimos 30 días | No se borró. La limpieza manual solo quita enviados de más de 90 días |
| El icono de la factura sigue ámbar | La lista se consultó antes de que terminaran los POST | Espere unos segundos en la lista, o abra Envíos webhook |
| Dos filas del “mismo” tracking | Distinta mayúscula o espacios distintos | TRK-A y trk-a son dos códigos. Un texto idéntico se envía una sola vez |
| No veo el menú Envíos webhook | Hace falta administrar conectores | Pida a un administrador el permiso de conectores. Ver facturas no alcanza para esta pantalla |
La factura sí se guardó
Si el webhook no se encola o el receptor falla, la factura, el manifiesto o el saco siguen guardados. Arregle el conector y reintente desde Envíos webhook o con Enviar webhooks. No recree el documento para “volver a mandarlo”: una factura ya creada no se reenvía sola al recargar.
Qué no reenviar
Si la fila dice enviada y el HTTP es 200, no pulse Enviar webhooks otra vez para ese tracking. Droka no crea una segunda fila. Si el receptor no lo guardó, el arreglo es del receptor, con el _id y el texto de respuesta.
URL que Droka no usa
Droka no encola la fila si la dirección no es HTTPS, si apunta a un sitio no público, o si trae un hueco distinto de `{WAREHOUSE}` y `{manifesto_number}`.
Guarde de nuevo después de corregir la URL. Los documentos ya creados no salen solos: use Enviar en el saco o Enviar webhooks en la factura. La entrada nueva sale al guardar el siguiente ME.