Docupath — Integración
Docupath es una plataforma de Intelligent Document Processing (IDP) basada en IA generativa. A diferencia del OCR tradicional —que lee caracteres—, Docupath usa LLMs para entender el layout, el idioma y la lógica del documento sin plantillas ni reglas rígidas. Para Gosocket, Docupath actúa como el motor que transforma PDFs fiscales (facturas, notas de crédito, etc.) en datos estructurados/XML que el pipeline de Gosocket puede procesar: no es Gosocket quien hace el reconocimiento del PDF, es Docupath.
La integración es bidireccional y consta de dos flujos con endpoints y autenticación distintos, más un tercer mecanismo de consulta periódica (polling) que reutiliza la API y autenticación del primer flujo.
¿Qué hace la integración Gosocket + Docupath?
Mecanismo de integración
La integración opera sobre dos APIs REST — la API de Docupath (OAuth 2.0) y la API de Gosocket (Basic Auth) — más un tercer mecanismo que reutiliza la API de Docupath. Gosocket envía PDFs al pipeline IA de Docupath; el resultado (XML + PDF original) puede llegar de dos formas: por push — UploadZipDocument (Flujo ②) — que es solo una contingencia manual, porque depende de que alguien apruebe el documento a mano en el portal de Docupath; o por polling — GET /v1/documents/search (Flujo ③) — que es el proceso automático: Gosocket consulta el resultado cada 5 minutos (máx. 10 reintentos) sin depender de esa aprobación. Gosocket genera external_id y batch_id al enviar; Docupath los almacena y los devuelve sin cambio, cerrando el ciclo de trazabilidad por cualquiera de las dos vías.
Consulta Cómo funciona para la arquitectura completa y los diagramas de secuencia.
¿Para quién es esta documentación?
Esta documentación está dirigida a:
- Desarrolladores que implementan la integración Gosocket + Docupath en cualquiera de los dos sentidos
- Equipos técnicos de Docupath que configuran el envío de documentos procesados hacia Gosocket
- Partners e integradores que operan cualquiera de los dos flujos en ambientes de prueba o producción
Por dónde empezar
Si es la primera vez que trabajas con esta integración, sigue este orden:
- Lee Cómo funciona para entender la arquitectura bidireccional y el ciclo de trazabilidad
- Identifica cuál flujo implementas:
- Gosocket envía documentos a Docupath → genera las credenciales OAuth en el portal de Docupath, luego implementa Autenticación y Enviar documento
- Docupath entrega documentos a Gosocket (push, contingencia manual) → solicita las credenciales Basic Auth al equipo de Gosocket, luego implementa Preparar el ZIP y Enviar el documento
- Gosocket consulta el resultado por polling (proceso automático) → no requiere credenciales nuevas (reutiliza el access_token del Flujo ①); implementa Consulta periódica
- Consulta la referencia técnica para los detalles completos de cada método
Secciones de esta documentación
Cómo funcionaGuíaArquitectura bidireccional, modelo de integración, diagramas de ambos flujos y ciclo de vida del documento.Gosocket → DocupathFlujoProceso paso a paso: autenticación, envío del PDF y entrega del resultado.Docupath → GosocketFlujoContingencia manual: preparación del ZIP y entrega del documento procesado cuando alguien lo aprueba a mano en el portal.Consulta periódica (Polling)FlujoProceso automático: Gosocket consulta el resultado directamente, sin depender del push ni de la aprobación manual.APIsReferenciaReferencia técnica completa: autenticación, parámetros, ejemplos de request/response y catálogo de errores.