Docupath: Docupath → Gosocket (contingencia manual)
Gosocket expone el endpoint UploadZipDocument para recibir los documentos que Docupath ha procesado. Una vez que el motor IA completa el procesamiento, Docupath empaqueta el resultado (XML + PDF original) en un .zip y lo entrega a Gosocket, que valida el paquete, registra el documento y retorna el estado del procesamiento.
Este flujo solo se dispara cuando el documento llega a estado approved en Docupath, lo cual requiere revisión manual en el portal — la función de auto-aprobación ("autoreview") de Docupath no se comporta de forma confiable. Por eso no es el mecanismo automático de la integración: es simplemente una contingencia manual, útil para los casos en que alguien efectivamente aprueba el documento a mano en el portal. El proceso automático real de la integración es el Flujo ③ — Consulta periódica (Polling), que Gosocket ejecuta por su cuenta, sin intervención humana.
Actores del proceso
Ambientes
| Ambiente | Endpoint URL |
|---|---|
| Sandbox (Pruebas) | https://systemintegrator-sbx.gosocket.net/api/v1/UploadZipDocument |
| Producción | https://systemintegrator.gosocket.net/api/v1/UploadZipDocument |
Flujo del proceso
Paso 1 — Autenticación
HTTP Basic Auth con las credenciales (Username + Password) que Gosocket asigna a Docupath, una por ambiente. Las credenciales van directamente en cada request; no hay endpoint de obtención de token.
Paso 2 — Preparar el ZIP
El .zip debe cumplir estas reglas para ser procesado correctamente:
Paso 3 — Enviar el documento
POST /api/v1/UploadZipDocument con body JSON: country, externalId, batchId (los mismos valores que Gosocket envió en el Flujo ①, devueltos sin cambio), fileBase64, fileExt="zip" y fileName. Gosocket registra el documento, retorna los datos extraídos del XML (filesProcessed[]) y el estado isSuccess.
Son las claves de correlación para el tracking end-to-end. Reusar un UUID nuevo en un reintento en lugar del original rompe la trazabilidad.