Docupath: Consulta periódica (Polling) — proceso automático

El Flujo ② (Docupath → Gosocket) entrega el documento procesado por push, pero solo ocurre cuando el documento llega a estado approved en Docupath — una transición que requiere revisión manual en el portal, ya que la función de auto-aprobación ("autoreview") de Docupath no se comporta de forma confiable. Por eso el Flujo ② es solo una contingencia manual, no el mecanismo principal.

Este flujo (③) es el proceso automático de la integración: Gosocket consulta directamente el resultado por su cuenta, con una política de reintentos escalonada en tres niveles, sin depender de que alguien apruebe nada a mano en el portal.

Actores del proceso

Gosocket

Genera el external_id en el Flujo ①, programa el polling con la política de reintentos en tres niveles y extrae el XML y el PDF cuando están disponibles

API Docupath

Expone GET /v1/documents/search?external_id= con el estado actual y, desde pending_review, el XML procesado y la URL del PDF

Ambientes

Ambiente	Base URL
DEV / Pruebas	`https://api.docupathdev.app`
PRD / Producción	`https://api.docupath.app`

Mismas credenciales y access_token que el Flujo ① (Gosocket → Docupath) — no se requiere autenticación adicional.

Flujo del proceso

Paso 1 — Autenticación

Este flujo reutiliza el access_token OAuth 2.0 obtenido en el Flujo ①. Si expiró (dura ~1 hora), se renueva con el refresh_token antes de continuar el polling — ver POST /v1/oauth/token. Como la ventana total del polling puede extenderse hasta 15 horas (ver más abajo), el token se renueva varias veces a lo largo del proceso.

Paso 2 — Consultar periódicamente

GET /v1/documents/search?external_id={id} usando el mismo external_id que Gosocket envió en el Flujo ①. La política de reintentos tiene tres niveles anidados:

1. Consultas por envío

5 consultas con un intervalo de 3 minutos entre cada una, inmediatamente después de enviar el PDF (ventana de ~15 minutos)

2. Reproceso del mensaje

Si las 5 consultas se agotan sin resultado, el mensaje se reprocesa (dequeue count) hasta 5 veces — cada reproceso repite el envío y sus 5 consultas

3. Repetición del ciclo completo

Si los 5 reprocesos también se agotan, el ciclo completo (envío + 5 reprocesos) se repite 5 veces más, con 3 horas de diferencia entre cada repetición

uploaded / processing

Aún sin resultado — esperar el intervalo correspondiente y reintentar

rejected / expired

Fin sin éxito — no tiene sentido seguir reintentando; marcar error en la tabla de monitoreo

Reintentos agotados

En el peor de los casos (nunca hay una respuesta válida), Gosocket realiza un total de 125 consultas (5 consultas × 5 reprocesos × 5 repeticiones), con una diferencia de entre 12 y 15 horas entre la primera y la última consulta. Si se agotan todos los reintentos sin que current_status llegue a pending_review o approved, el documento debe marcarse como pendiente/error en la tabla de monitoreo de Gosocket para revisión manual — Docupath no notifica proactivamente cuando un documento queda atascado en processing.

Paso 3 — Obtener XML y PDF

En cuanto la respuesta incluye processed_info, el polling se considera resuelto — no es necesario esperar a approved:

XML procesado

Viene directamente en el campo processed_info de la respuesta, en formato nativo de Gosocket. No requiere una llamada adicional.

PDF original

El campo file_url es una URL firmada con expiración — debe descargarse de inmediato tras recibir la respuesta, no debe guardarse como referencia permanente.

Referencia técnica

GET /v1/documents/searchGETParámetros, política de reintentos, catálogo de estados y campos de la respuesta (processed_info, file_url).