Endpoints / Categorías
Obtener categoría
Obtiene el detalle de una categoría por su identificador dentro de la empresa del usuario autenticado.
/categories/:idCaso de Uso
Se usa cuando la aplicación necesita consultar la información completa de una categoría específica, por ejemplo para mostrar su detalle o cargar sus datos en una pantalla de edición. Al usarlo, el usuario obtiene los datos registrados de la categoría solicitada.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`.
Parámetros de ruta
idstringobligatorioIdentificador de la categoría.
Body
No aplica.
Reglas de negocio
Solo permite consultar categorías de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
El usuario autenticado debe tener rol jefe o empleado.
La categoría debe existir dentro de la empresa autenticada.
El identificador id corresponde al campo ctgriaid de la categoría.
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 categoría no existe o no pertenece a la empresa autenticada.
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 usuario autenticado intentó acceder a información de una empresa distinta a la suya.
El rol del usuario no está permitido para acceder al módulo de categorías.
El usuario autenticado no tiene un rol permitido para consultar categorías.
El usuario autenticado está inactivo y no puede usar el sistema.
Ocurrió un error interno al consultar la categoría por identificador.
Notas de uso
Este endpoint no recibe body.
Envía el identificador de la categoría en la ruta, reemplazando :id.
Usa este endpoint para consultar una sola categoría; para listados paginados usa GET /categories.
El campo ctgriadescripcion puede venir como null si no fue registrado.
La respuesta incluye el estado actual de la categoría en ctgriaestado.