Endpoints / Configuración
Listar configuraciones
Obtiene todas las configuraciones de una empresa, ordenadas por clave, desde administración central.
/configsCaso de Uso
Se usa cuando un administrador necesita cargar todas las claves de configuración de una empresa para una pantalla de administración o para inicializar ajustes internos. Al usarlo, el usuario obtiene un arreglo con todas las configuraciones de la empresa indicada, ordenadas alfabéticamente por clave.
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.
Query params
companyIdstring opcionalIdentificador de la empresa. Si no se envía, se usa la empresa del usuario autenticado.
Body
No aplica.
Reglas de negocio
Solo un usuario con rol administrador puede consultar configuraciones.
La empresa del usuario autenticado debe ser empresa padre.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
Si no se envía companyId, se consultan las configuraciones de la empresa del usuario autenticado.
Si se envía companyId, se consultan las configuraciones de la empresa indicada.
La respuesta no usa paginación; devuelve todas las configuraciones en un arreglo.
Los resultados se ordenan por cfclave en orden ascendente.
Si no existen configuraciones para la empresa, se devuelve un arreglo vacío.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
El companyId 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 consultar 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 no recibe parámetros de ruta ni body.
companyId es un query param opcional; si no se envía, se usa la empresa del usuario autenticado.
La respuesta es un arreglo simple, no un objeto paginado.