Endpoints / Empresas
Obtener empresa
Obtiene el detalle de una empresa por su identificador, limitado a la empresa del usuario autenticado.
/companies/:idCaso de Uso
Se usa cuando la aplicación necesita cargar la información completa de la empresa del usuario autenticado para una vista de detalle, un formulario de edición o el perfil corporativo. Al usarlo, el usuario obtiene los datos completos de la empresa incluyendo la URL pública del logo.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`. Permite acceso a usuarios con rol administrador, jefe o empleado, pero solo sobre la misma empresa del usuario autenticado.
Parámetros de ruta
idstringobligatorioIdentificador de la empresa.
Body
No aplica.
Reglas de negocio
Solo permite consultar la empresa del usuario autenticado; no permite consultar otras empresas.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
El usuario autenticado debe tener rol administrador, jefe o empleado.
El backend transforma emlogo a una URL pública completa.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
No se envió el parámetro id en la ruta.
La empresa consultada no existe.
La empresa asociada al usuario autenticado no fue encontrada.
La empresa asociada al usuario autenticado está inactiva.
El usuario autenticado no fue encontrado dentro de su empresa.
El usuario autenticado no pertenece a la empresa indicada por su sesión.
El id enviado no coincide con la empresa del usuario autenticado.
El rol del usuario no está permitido para acceder al módulo de empresas.
El usuario autenticado está inactivo y no puede usar el sistema.
La empresa solicitada no fue encontrada en la base de datos.
Notas de uso
Este endpoint no recibe query params ni body.
Solo devuelve información de la empresa del usuario autenticado; no permite consultas administrativas globales.
El campo emlogo se devuelve como URL pública completa, lista para usar en etiquetas <img>.