Docupath: Gosocket → Docupath
Gosocket actúa como cliente de la API REST de Docupath: envía PDFs fiscales al pipeline del vertical Finn (finanzas), que los procesa con IA sin plantillas, extrae los datos estructurados y los valida. El resultado se exporta en Docupath AI Format (DIF) y se mapea al XML nativo de Gosocket, que Docupath entrega a Gosocket mediante el flujo Docupath → Gosocket.
Actores del proceso
Ambientes
| Ambiente | Base URL | Portal |
|---|---|---|
| DEV / Pruebas | https://api.docupathdev.app | https://gosocket.docupathdev.app |
| PRD / Producción | https://api.docupath.app | https://gosocket.docupath.app |
Flujo del proceso
Paso 1 — Autenticación
Gosocket obtiene un access_token vía OAuth 2.0 Client Credentials (POST /v1/oauth/token) antes de cada sesión. Las credenciales se generan desde el portal de Docupath en Settings → Destination Format & APIs. El token expira en ~1 hora y puede renovarse con el refresh_token sin volver a autenticar.
Paso 2 — Enviar documento
POST /v1/documents con el PDF y los metadatos en multipart/form-data. Gosocket genera un external_id único y un batch_id de lote; ambos se incluyen en los metadatos y Docupath los almacena para devolvérselos a Gosocket en el Flujo ②. El campo additional_metadata.client_id identifica la organización en Docupath y es distinto al client_id OAuth.
Paso 3 — Procesamiento y entrega
Docupath procesa el documento con el vertical Finn (extracción, validación, exportación DIF → XML). Una vez completado, entrega el resultado a Gosocket vía el flujo ② (UploadZipDocument). Los documentos con errores de procesamiento se gestionan desde el portal privado de Docupath.