Endpoints / Configuración
Crear configuración
Registra una nueva configuración de tipo clave-valor para una empresa, desde administración central.
/configsCaso de Uso
Se usa cuando un administrador necesita crear un nuevo parámetro de configuración para una empresa, como porcentajes, valores por defecto o ajustes del sistema. Al usarlo, el usuario obtiene los datos de la configuración creada, incluyendo su identificador único.
Autenticación
Requiere token JWT en el header `Authorization: Bearer <token>`. Solo permite acceso a usuarios con rol administrador. La empresa del usuario autenticado debe estar activa y ser empresa padre.
Parámetros de ruta
Este endpoint no recibe parámetros de ruta.
Body
cfemidstringobligatorioIdentificador de la empresa a la que pertenecerá la configuración.
cfclavestringobligatorioClave única de configuración dentro de la empresa; no puede repetirse en la misma empresa.
cfvalorstringobligatorioValor asociado a la clave de configuración.
Reglas de negocio
Solo un usuario con rol administrador puede registrar configuraciones.
La empresa del usuario autenticado debe ser empresa padre.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
Todos los campos del body son obligatorios.
cfclave no puede repetirse dentro de la misma empresa.
Este endpoint permite crear configuraciones para cualquier empresa, no solo para la empresa del usuario autenticado.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
cfemid fue enviado vacío.
cfclave fue enviado vacío.
cfvalor fue enviado vacío.
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 no tiene el rol requerido para crear configuraciones.
El usuario autenticado está inactivo y no puede usar el sistema.
La empresa del usuario autenticado no es empresa padre.
Ya hay una configuración registrada con la misma cfclave dentro de la empresa indicada.
La configuración fue guardada, pero no pudo consultarse para devolver la respuesta.
Ocurrió un error interno al guardar la configuración.
Notas de uso
Este endpoint no recibe parámetros de ruta ni query params.
cfclave debe ser única por empresa; dos empresas pueden tener la misma clave con valores distintos.
Este endpoint está pensado para administración central y permite operar sobre cualquier empresa, no solo la del usuario autenticado.