Webhooks eventos principales

Last updated: January 14, 2026

Invofox permite integrar webhooks para facilitar la comunicación asincrónica con tu sistema, ideal para obtener respuestas rápidas y sin bloquear procesos. A continuación, te explicamos los eventos más relevantes que puedes configurar y cómo interpretarlos correctamente.

📌 Eventos principales

Los webhooks en Invofox envían eventos que reflejan el estado del procesamiento de documentos. Los dos eventos clave que debes tener en cuenta son:

1. document.processed

Este es el evento general que indica que el documento ha sido completamente procesado. Dentro de este evento pueden existir tres estados diferentes que describen el resultado del procesamiento:

  • discarded: El documento ha sido descartado por errores graves como estar vacío, tener formato inválido o ser ilegible.
    ✅ No deberías recibir estos documentos en condiciones normales.

  • approved: El documento ha sido procesado correctamente y no requiere revisión adicional.
    ✅ Este es el flujo esperado para documentos válidos.

  • pendingCorrection: El sistema no pudo validar automáticamente el documento y necesita revisión manual.
    🕵 Este estado se da cuando falta información o hay ambigüedades.

⚠ Nota: Recientemente se ha realizado un cambio importante: los documentos que antes quedaban en pendingCorrection ahora serán reenviados como approved una vez se complete la revisión manual. Esto te permite recibirlos mediante el webhook document.approved.

2. document.approved

Este evento indica que un documento ha sido revisado y aprobado, ya sea automáticamente o tras una corrección manual.

🔄 Si tu sistema depende de la aprobación final de documentos, este es el evento más fiable para integraciones críticas.

🧹 Evento deprecado: document.finished

Este evento ya no está operativo, ya que ha sido oficialmente deprecado por Invofox. Toda la información útil que proveía está ahora cubierta por document.processed y document.approved.

✅ Recomendación: elimínalo de tu flujo si aún lo estás utilizando.

Consejos adicionales

  • Si estás recibiendo datos duplicados, verifica si estás escuchando tanto a document.processed como a document.approved y ajusta tu lógica según lo necesites.

  • Siempre responde a los webhooks con un código HTTP 200 lo antes posible para evitar reintentos innecesarios.

  • Puedes configurar múltiples endpoints si quieres manejar distintos eventos de manera separada.

Si después de leer este artículo tienes alguna duda, puedes contactar al equipo de soporte en: support@invofox.com