Subir Documento
Referencia API
Subir Documento
Sube un documento y opcionalmente asócialo con una entidad y categoría — en la plataforma gu1 para KYC, KYB y evidencia de compliance.
POST
Subir Documento
Sube archivos asociados a entidades usando multipart/form-data.
Categorías comunes incluyen:
Autenticación
Este endpoint requiere autenticación mediante token Bearer y contexto de organización. Headers Requeridos:Authorization: Bearer <jwt-token>X-Organization-ID: <organization-id>
Parámetros del Form Data
File
required
El archivo a subir (cualquier tipo soportado)
UUID
ID de la entidad a la que asociar el documento
UUID
ID de la categoría del documento (UBO, Representante Legal, Corporativo, etc.)
Ejemplo de Request
Respuesta
UUID
Identificador único del documento
string
Nombre del documento
string
Nombre original del archivo subido
number
Tamaño del archivo en bytes
string
Tipo MIME del archivo
string
Ruta donde se almacena el archivo (clave S3 o ruta local)
string
Proveedor de almacenamiento usado (‘s3’ o ‘local’)
UUID
ID de la categoría del documento (si se asignó)
UUID
ID de la organización propietaria del documento
timestamp
Fecha de creación del documento
Ejemplo de Respuesta
Qué Sucede Después de la Subida
- Almacenamiento: El archivo se sube a S3 (si está habilitado) o almacenamiento local
- Registro en Base de Datos: Se crea el registro del documento en la base de datos
- Versionamiento: Se crea automáticamente la versión inicial (v1)
- Relación con Entidad: Si se proporciona
entityId, se crea la relación automáticamente - Análisis de Riesgo: Se activa el análisis automático de riesgo si hay reglas configuradas
Tipos de Archivo Soportados
- Documentos: PDF, DOC, DOCX, TXT
- Imágenes: PNG, JPG, JPEG, GIF
- Hojas de Cálculo: XLS, XLSX, CSV
- Otros: Cualquier tipo de archivo
Categorías de Documentos
Para obtener las categorías disponibles, usa:- UBO (Beneficiario Final)
- Representante Legal
- Documentos Corporativos
- Debida Diligencia Reforzada
Respuestas de Error
error
Bad Request - Falta archivo o autenticación
error
No Autorizado - Token inválido
error
Error Interno del Servidor
Notas
El sistema detecta automáticamente si el almacenamiento S3 está configurado y lo usa, de lo contrario usa almacenamiento local.