Skip to main content
POST
Subir Documento
Sube archivos asociados a entidades usando multipart/form-data.

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

  1. Almacenamiento: El archivo se sube a S3 (si está habilitado) o almacenamiento local
  2. Registro en Base de Datos: Se crea el registro del documento en la base de datos
  3. Versionamiento: Se crea automáticamente la versión inicial (v1)
  4. Relación con Entidad: Si se proporciona entityId, se crea la relación automáticamente
  5. 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:
Categorías comunes incluyen:
  • 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.
El tamaño máximo del archivo depende de la configuración del servidor (típicamente 50MB).
Incluso si entityId o categoryId no existen, el documento se creará de todos modos. La relación o asignación de categoría simplemente se omitirá.