Pular para o conteúdo principal

Crear nuevo documento

POST 
/documents

Descripción​

Endpoint para crear nuevos documentos corporativos con sus archivos asociados en Amazon S3.

Requisitos de Acceso​

  • Autenticación: Token JWT válido
  • Rol mínimo: Gestor de compañía (isGestor)

Configuración de Archivos​

  • Máximo: 6 archivos por documento
  • Tamaño máximo: 10MB por archivo
  • Formatos soportados:
    • Documentos: PDF, DOCX, XLSX
    • Imágenes: JPG, PNG
  • Almacenamiento: Los archivos se guardan en S3 con estructura: documents/{companyId}/{timestamp_filename.ext}

Validaciones​

  • Todos los timestamps deben estar en UTC
  • El tipo de documento debe existir (/documents/types)
  • El nombre debe tener entre 3-100 caracteres

Flujo Técnico​

  1. Validación de metadatos y UTC
  2. Subida paralela de archivos a S3
  3. Creación de registro en base de datos
  4. Asociación automática a la compañía
  5. Estado inicial: pending

Ejemplo de Uso​

curl -X POST \
  -H "Authorization: Bearer {token}" \
  -F "name=Contrato de Servicios" \
  -F "documentType=5f8d3b7a9c2d1e0f4a6b5c4f" \
  -F "files=@contrato.pdf" \
  -F "files=@anexo.pdf" \
  https://api.example.com/v1/documents

Request​

Responses​

Documento creado exitosamente