Endpoints / Categorías
Crear categoría
Crea una nueva categoría dentro de la empresa indicada.
/categoriesCaso de Uso
Se usa cuando la aplicación necesita registrar una categoría para organizar el catálogo de productos. Al usarlo, el usuario obtiene la categoría creada con su identificador, descripción, estado y fecha de registro.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`.
Parámetros de ruta
Este endpoint no recibe parámetros de ruta.
Body
ctgriaemidstringobligatorioIdentificador de la empresa a la que pertenecerá la categoría.
ctgnombrestringobligatorioNombre de la categoría.
ctgriadescripcionstring | null opcionalDescripción de la categoría.
Reglas de negocio
Solo permite crear categorías en la misma 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.
ctgriaemid y ctgnombre son obligatorios.
ctgnombre no puede repetirse dentro de la misma empresa.
ctgriadescripcion puede enviarse como null.
La categoría se crea con estado activo.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
No se envió ctgriaemid o se envió vacío.
No se envió ctgnombre o se envió vacío.
La empresa indicada en ctgriaemid o la empresa del usuario autenticado no fue encontrada.
La empresa asociada a la solicitud 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.
ctgriaemid pertenece a una empresa distinta a la del usuario autenticado.
El rol del usuario no está permitido para acceder al módulo de categorías.
El usuario autenticado no tiene un rol permitido para crear categorías.
El usuario autenticado está inactivo y no puede usar el sistema.
Ya hay una categoría registrada con el mismo ctgnombre dentro de la empresa.
Ocurrió un error interno al guardar la categoría.
La categoría fue creada, pero ocurrió un error al consultar sus datos para devolver la respuesta.
Notas de uso
Este endpoint no recibe parámetros de ruta.
Envía el body en formato JSON con el header Content-Type: application/json.
El nombre de categoría debe ser único dentro de la empresa.
La comparación de nombres existentes se realiza ignorando mayúsculas, minúsculas y espacios extremos.
Si no tienes descripción, envía ctgriadescripcion como null o no envíes el campo.
La respuesta devuelve los datos guardados de la categoría creada.