Saltar al contenido principal

Listar documentos de la compañía

GET 

/documents

Obtiene una lista paginada de todos los documentos asociados a la compañía del usuario autenticado.

Requisitos de Acceso

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

Funcionalidades Clave

  • Paginación con control de límite por página
  • Filtrado por tipo de documento (/documents/types)
  • Visualización de historial completo con estados:
    • pending: Pendiente de revisión
    • approved: Aprobado por administración
    • rejected: Rechazado con motivo

Flujo de Uso

  1. Obtener tipos de documento disponibles (/documents/types)
  2. Listar documentos con filtros opcionales
  3. Analizar metadatos y estados
  4. Acceder a archivos asociados (/files)

Consideraciones Técnicas

  • Todos los timestamps están en UTC
  • Máximo 100 documentos por página
  • Ordenación predeterminada por fecha de creación descendente

Request

Responses

Lista de documentos paginada