Endpoints / Marcas
Crear marca
Crea una nueva marca dentro de la empresa indicada.
/brandsCaso de Uso
Se usa cuando la aplicación necesita registrar una marca para organizar el catálogo de productos. Al usarlo, el usuario obtiene la marca creada con su identificador, 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
mrcemidstringobligatorioIdentificador de la empresa a la que pertenecerá la marca.
mrcnombrestringobligatorioNombre de la marca.
Reglas de negocio
Solo permite crear marcas 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.
mrcemid y mrcnombre son obligatorios.
mrcnombre no puede repetirse dentro de la misma empresa.
La marca 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ó mrcemid o se envió vacío.
No se envió mrcnombre o se envió vacío.
La empresa indicada en mrcemid 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.
mrcemid pertenece a una empresa distinta a la del usuario autenticado.
El rol del usuario no está permitido para acceder al módulo de marcas.
El usuario autenticado no tiene un rol permitido para crear marcas.
El usuario autenticado está inactivo y no puede usar el sistema.
Ya hay una marca registrada con el mismo mrcnombre dentro de la empresa.
Ocurrió un error interno al guardar la marca.
La marca 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 marca debe ser único dentro de la empresa.
La comparación de nombres existentes se realiza ignorando mayúsculas, minúsculas y espacios extremos.
La respuesta devuelve los datos guardados de la marca creada.