Endpoints / Configuración
Actualizar configuración
Actualiza el valor de una configuración existente, identificada por su clave y empresa, desde administración central.
/configs/:configKeyCaso de Uso
Se usa cuando un administrador necesita modificar el valor de una clave de configuración ya registrada para una empresa. Al usarlo, el usuario obtiene los datos completos de la configuración actualizada, incluyendo su identificador único, empresa, clave y nuevo valor.
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
configKeystringobligatorioClave de configuración.
Query params
companyIdstringobligatorioIdentificador de la empresa donde se actualizará la clave.
Body
cfvalorstringobligatorioNuevo valor para la clave de configuración; debe ser diferente al valor actual.
Reglas de negocio
Solo un usuario con rol administrador puede actualizar configuraciones.
La empresa del usuario autenticado debe ser empresa padre.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
configKey, companyId y cfvalor son obligatorios.
La actualización se realiza por la combinación de companyId y configKey.
Si el valor enviado es igual al valor actual, la actualización se rechaza.
Este endpoint solo actualiza cfvalor; no permite cambiar la clave ni la empresa.
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 configKey en la ruta.
No se envió el query param companyId.
No existe una configuración con la combinación de companyId y configKey indicada.
cfvalor fue enviado vacío.
El cfvalor enviado es igual al valor actual de la configuración.
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 actualizar configuraciones.
El usuario autenticado está inactivo y no puede usar el sistema.
La empresa del usuario autenticado no es empresa padre.
Notas de uso
Este endpoint solo actualiza el campo cfvalor; no permite modificar cfclave ni cfemid.
companyId se envía como query param en la URL.
Si el nuevo valor es igual al valor actual, el backend responde con error.