Registra un endpoint que recibirá los eventos de tu compañía por POST, en vez
de que tengas que consultar el estado de cada documento.

DGMax verifica tu endpoint antes de aceptarlo. Ejecuta la autenticación que
declaraste en auth (incluido el token dance de OAuth2) y envía un ping firmado
de tipo webhook.verification. Si las credenciales son inválidas o el endpoint
no responde 2xx, el registro se rechaza con 422 y no se guarda nada. Una
credencial mal configurada se detecta al momento, no la primera vez que se cae
una notificación real.

La respuesta incluye una sola vez el signing_secret. Es el secret key con
el que verificas la cabecera X-DGMax-Signature de cada entrega; no se vuelve
a mostrar.

Límites por compañía: hasta
5 endpoints por evento y
20 en total. Al alcanzar un tope
la operación responde 409.

Entrega y reintentos

Responde 2xx lo antes posible; encola el trabajo pesado. DGMax trata
cualquier 2xx como entrega exitosa.

Cuándo desistimos. Una entrega transitoria se reintenta hasta
5 veces después del intento inicial
(6 intentos en total), con backoff
exponencial que arranca en ~1 segundo y se topa en 5 minutos. Agotados los
intentos, la entrega queda en FAILED y no se vuelve a enviar: ese evento
se pierde para tu endpoint, y debes reconciliar por API los documentos que no
recibiste.

Auto-desactivación. Si un endpoint acumula
20 fallos consecutivos, DGMax lo
desactiva (active: false, disabled_reason: consecutive_failures) para dejar
de golpear un destino caído. Reactívalo con PATCH cuando lo arregles: eso
reinicia el contador.

Idempotencia. La entrega es al menos una vez. Cada transición final
produce un event_id determinista, también enviado en X-DGMax-Event-Id.
Úsalo como idempotency key.