@fullqueso/mcp-bc-gastos 1.27.0 → 1.31.0

package/.env.example

@@ -13,6 +13,14 @@ BC_ENVIRONMENT=production
 BC_COMPANY_FQ01=guid-for-store-fq01
 BC_COMPANY_FQ28=guid-for-store-fq28
 BC_COMPANY_FQ88=guid-for-store-fq88
+BC_COMPANY_FQFR=guid-for-franquicias
 
 # Optional
 LOG_LEVEL=info
+
+# Per-request BC fetch timeout (ms). A hung request is aborted + retried instead
+# of blocking the MCP forever (BUG #1 fix). Default 90000. Raise for heavy reports.
+BC_FETCH_TIMEOUT_MS=90000
+
+# CRM rate endpoint (get_crm_rate) — opcional, default abajo
+CRM_RATE_BASE=https://crm-rate.fullqueso.com/api/v1

package/CHANGELOG.md

@@ -1,5 +1,91 @@
 # CHANGELOG
 
+## [1.31.0] — 2026-07-01
+
+### Added — KPIs de nómina operativa: tienda vs eventos, activos vs pagados
+Contratos existentes intactos (solo se agregan campos). Todo USD. Verificado contra BC real (mayo 2026, FQ01/FQ28/FQ88/FQFR).
+
+- **`paid_employees` en `get_payroll_documents` (con `include_employee_count=true`).** Además de `summary.unique_employees`, ahora `summary.paid_employees`: lista agregada por empleado en el período con `{ employee_code, employee_name, cedula, cost_usd, lines, payroll_types:[...], classification }`. Permite cruzar activos vs pagados sin leer las líneas doc por doc.
+- **Deduplicación por cédula.** `unique_employees` y `paid_employees` deduplican por `cedula` cuando existe (una persona puede tener un código SEMANAL y otro EVENTO → se consolidan costo y líneas en un registro). `summary.duplicate_codes: [{ cedula, codes:[...] }]` expone los casos multi-código para limpieza en BC. Si `cedula` es null se trata el código como persona única (no se fusiona por nombre). El consolidado (`store="all"`) re-deduplica también entre tiendas (misma cédula en dos tiendas = una persona).
+  - Resolución de cédula en 2 pasos: si un código tiene cédula en alguna línea, las líneas con cédula en blanco de ese código heredan la cédula (evita partir un código en dos personas). Verificado mayo 2026: 0 splits, 0 merges; 82 personas = 58 con cédula (1:1) + 24 códigos sin cédula en BC (data-quality, tratados como únicos).
+- **Clasificación evento/operativo por empleado** (relevante FQ01): `classification` = `"evento"` (todos sus pagos EVENTO), `"operativo"` (ningún EVENTO — SEMANAL/VACACIONES/LIQUIDACION), `"mixto"` (tiene EVENTO y no-EVENTO). Evita marcar como "inactivo no declarado" a quien solo trabaja eventos.
+- **Buckets de nómina tienda vs eventos** en `summary` (per-store y consolidado): `store_payroll` = Σ `cost_usd` de docs SEMANAL + VACACIONES + LIQUIDACION; `event_payroll` = Σ EVENTO. `total_cost_usd` se mantiene igual (gerencia queda solo ahí). Constantes `STORE_PAYROLL_TYPES`/`EVENT_PAYROLL_TYPES` en `tools/payroll/cost-model.js`.
+
+### Added — Denominador de ventas correcto para el KPI (get_sales_analysis / compare_sales_by_store)
+- **`revenue_store`, `revenue_events`, `revenue_intercompany`, `revenue_non_sales` + `revenue_total`** en `summary` (y por tienda en `compare_sales_by_store`), además del `total_revenue_usd` actual (sin cambios). Identidad: `revenue_total = revenue_store + revenue_intercompany + revenue_events + revenue_non_sales`.
+- **`revenue_store = revenue_total − intercompañía − eventos − no-venta`.** Se excluye del denominador de tienda la venta intercompañía, la venta de eventos y el ingreso **no-venta** (FX gains + rebajas de compra) — este último por recomendación aceptada por FP.
+- **Cuentas configurables (no inline), por tienda** en `config/income-accounts.js`, verificadas contra el CoA real:
+  - `INTERCOMPANY_REVENUE_ACCOUNTS = ['40310']` (tiendas operativas; FQ01/FQ88, FQ28=0).
+  - `EVENT_REVENUE_ACCOUNTS = ['40180','40700']` (solo FQ01 con movimiento).
+  - `NON_SALES_REVENUE_ACCOUNTS = ['40580','40540','40550']` (dif. cambiario + descuentos/rebajas de compra).
+  - **FQFR** usa `FQFR_INTERCOMPANY_REVENUE_ACCOUNTS = ['40420','40430','40660','40930']` (royalties/fees del master de franquicia, NO 40310) vía `getRevenueClassification(storeCode)` → sus buckets salen correctos aunque el KPI no aplique.
+  - Lógica en `splitRevenueBuckets(glRevenue, total, storeCode)` (`utils/sales-aggregation.js`); `calculateSummary` ahora recibe `storeCode` (los dos tools de ventas lo pasan por tienda).
+- **KPI** (lo calcula el consumidor cruzando ambos tools): `nomina_tienda_pct = store_payroll / revenue_store`; `nomina_eventos_pct = event_payroll / revenue_events` (**null si `revenue_events = 0`** → solo FQ01). **FQFR excluido por completo** del KPI (`KPI_PAYROLL_STORES = ['FQ01','FQ28','FQ88']`).
+  - Verificado mayo 2026 (2 fases, `tests/verify-payroll-sales-kpi.js`):
+    - **Estricto** (− interco − eventos), coincide con la validación de FP: FQ01 8.36% tienda / 31.02% eventos (rev_store 86,987.43); FQ28 10.22% (77,407.51); FQ88 8.75% (150,122.32).
+    - **Refinado** (además − no-venta): FQ01 8.36% (86,940.37); FQ28 10.25% (77,146.08); FQ88 8.80% (149,322.16).
+
+### Nota operativa
+- **Reiniciar Claude Desktop** tras el publish para que los tools recarguen (G-002).
+
+---
+
+## [1.30.0] — 2026-07-01
+
+### Fixed
+- **BUG #1 — `get_employees`/`get_payroll_documents` con `store="all"` podían colgar el MCP indefinidamente.** Causa raíz: `fetch()` no tenía timeout → una sola petición colgada nunca resolvía, y como el consolidado usaba `Promise.all`, una tienda colgada tumbaba todo el call (aparecía como "MCP no responde").
+  - **`lib/bc-client.js` — timeout por petición (AbortController).** Cada intento de `fetchWithRetry` aborta a los `BC_FETCH_TIMEOUT_MS` (default **90000**, env-tunable) y reintenta; al agotar reintentos lanza un error claro de timeout en vez de colgarse. Cubre token + todas las llamadas v2.0/OData/custom (afecta a las 54 tools; el default generoso no toca ninguna llamada legítima — todas las observadas <1s).
+  - **Consolidación multi-tienda resiliente.** `get_payroll_documents` y `get_employees` con `store="all"` ahora usan `Promise.allSettled`: una tienda que falle/timeoutee devuelve data parcial + un array `errors[]` por tienda, nunca cuelga ni bota el consolidado.
+  - Verificado: per-store discovery <500ms; el timeout aborta+reintenta (3x) y lanza error en ~6s con `BC_FETCH_TIMEOUT_MS=1`.
+
+### Changed / Added — KPIs de nómina operativa
+- **#2/#3 — Costo total en USD por documento (`total_cost_usd`) robusto a drafts sin distribuir.** Nuevo módulo `tools/payroll/cost-model.js` como **fuente única de verdad del costo**. Regla (verificada contra 448 docs reales): `total_cost_usd = totalGrossUSD (>0) → si no, bonos-equivalente USD → si no, neto (MAX, no suma)`. El campo `cost_basis` (`gross`|`bonuses`|`net`) hace auditable de dónde salió el número, y `net_distributed:false` marca los drafts cuyo neto aún no se reparte por método de pago (elimina el parche `max(neto,bonos)`).
+  - **Por qué la suma `net_usd + net_ves/tasa` estaba mal:** VACACIONES/LIQUIDACION contabilizan el MISMO monto en `totalNetUSD` **y** `totalNetVES` → esa suma **duplica** el costo. `totalGrossUSD` es el costo real y ya está en el header (antes no se seleccionaba).
+  - Expuestos en cada documento: `total_cost_usd`, `cost_basis`, `net_distributed`, `total_gross_usd`, `total_deductions_usd`. Agregado `total_cost_usd` a `summary` y `consolidated`.
+- **#4 — Enums de `payroll_type` corregidos a los valores reales de BC + `exclude_managerial`.** El enum viejo `[SEMANAL|QUINCENAL|MENSUAL]` estaba mal (QUINCENAL/MENSUAL no existen).
+  - `get_payroll_documents`: `SEMANAL, GERENCIAL, GERENCIAL_CIERRE, EVENTO, VACACIONES, LIQUIDACION`. Nuevo flag `exclude_managerial` → excluye GERENCIAL + GERENCIAL_CIERRE server-side (nómina operativa en un solo call).
+  - `get_employees`: `SEMANAL, GERENCIAL, EVENTO`. Nuevo flag `exclude_managerial` → excluye `payrollType GERENCIAL` + `employeeType Management`.
+- **#5 — `summary.by_type` ahora trae costo, no solo conteo.** De `{ TIPO: n }` a `{ TIPO: { count, lines, cost_usd } }` (per-store y consolidado).
+- **#6 — Headcount único de empleados pagados en el periodo.** Nuevo flag `include_employee_count` en `get_payroll_documents` → `summary.unique_employees` (y `consolidated.unique_employees`). Lee las líneas de los docs filtrados en lotes de OR (no doc-por-doc). Distingue el headcount real de `total_employees_lines` (que duplica al mismo empleado por cada corrida semanal).
+- **#7 — Costo por empleado en USD en `get_payroll_lines`.** Expuesto `total_ves_equivalent` (campo de la API antes sin usar) y `cost_usd` por línea = `totalVESEquivalent / tasa` (la tasa se lee del header en 1 llamada extra). `summary` trae `total_cost_usd`, `total_ves_equivalent`, `payroll_type`, `status`, `exchange_rate`.
+  - **Nota (L-001):** la API `fqPayrollLines` **no** expone días/horas trabajados ni FTE por línea → no se pueden calcular KPIs de productividad laboral sin ampliar la extensión de BC. Documentado, no fabricado.
+
+### Nota operativa
+- **Reiniciar Claude Desktop** tras el publish para que los tools recarguen (G-002).
+
+---
+
+## [1.29.0] — 2026-06-21
+
+### Added
+- **`get_crm_rate` — tasa de cambio Bs/USD desde el CRM de Full Queso (tasa de referencia, hora Caracas).** Complementa a `get_exchange_rate` (que trae la tasa BCV contable vigente en BC): este tool consulta el endpoint del CRM `https://crm-rate.fullqueso.com` y expone tanto la tasa **USDT/Binance** (paralelo) como la **BCV** (oficial), histórica o del día.
+  - **Dos monedas con sinónimos:** `coin` acepta `USDT`/`BINANCE` (paralelo, mismo valor) y `VES`/`BCV` (oficial). La descripción dispara con "tasa USDT, tasa Binance, dólar Binance, tasa paralelo/paralela, tasa BCV, tasa oficial, tasa del día, tasa histórica".
+  - **Histórica vs del día automático:** con `date` (YYYY-MM-DD) → `GET /api/v1/history/price?coin={VES|USDT}&date=...`; sin `date` → `GET /api/v1/coin/{bcv|usdt}` (momento de la consulta).
+  - Maneja `400` (coin/date inválidos → error claro), `404` (sin registro → `price: null` + mensaje) y fallo de conexión. Precio redondeado a 2 decimales; respuesta incluye `queried_at_caracas` y `source`.
+  - Base URL configurable vía env **`CRM_RATE_BASE`** (default `https://crm-rate.fullqueso.com/api/v1`). El endpoint no requiere auth de BC → tool autónomo (ignora `bcClient`).
+  - Nuevo `tools/get-crm-rate.js`; registrado en `server.js` (import + lista de tools + switch).
+  - **Verificado contra el endpoint real (21-jun-2026):** USDT del día ≈798.35; BCV del día 612.43; histórica USDT 19-jun 805.40; histórica VES 19-jun **607.39** (coincide con el ejemplo del doc); 404 (1990) y coin inválido (DOGE) manejados. `node --check` OK.
+
+### Nota operativa
+- **Reiniciar Claude Desktop** tras el publish para que el tool recargue (G-002).
+
+---
+
+## [1.28.0] — 2026-06-12
+
+### Added
+- **Cuarta compañía: `FQFR` — Full Queso Franquicias, C.A.** El MCP solo exponía FQ01/FQ28/FQ88; ahora la compañía de Franquicias está disponible en todas las herramientas.
+  - **Datos BC** (descubiertos del endpoint `/companies`): `companyId` (GUID) = `30e63c27-6336-f011-9a4a-000d3afe29c3`; `name` OData V4 = `Full Queso Franquicias` (→ `companyName: 'Full%20Queso%20Franquicias'`).
+  - Nueva entrada `FQFR` en `config/company-config.js` (`getStores()`) y agregada a `ALL_STORE_CODES` → `"all"` ahora incluye Franquicias en consolidados/comparativas.
+  - Nueva env var **`BC_COMPANY_FQFR`** (opcional, como FQ28/FQ88) en `.env`, `.env.example` y README. La validación de `server.js` no cambia (solo FQ01 es obligatoria).
+  - **52 herramientas** tenían el `enum` de tiendas hardcodeado (`['FQ01','FQ28','FQ88'(,'all')]`) — esto rechazaba `FQFR` en la validación del schema MCP. Se agregó `'FQFR'` a los 52 enums (39 sin `'all'`, 13 con `'all'`).
+  - **Verificado contra BC real:** token OK; API v2.0 (GUID) → 200; OData V4 (nombre) → 200; `getGLEntries` ingresos 2025 de FQFR → 116 asientos; `resolveStores(['all'])` → `FQ01,FQ28,FQ88,FQFR`. `node --check` OK en todos los .js.
+
+### Nota operativa
+- **Reiniciar Claude Desktop** tras el publish para que los tools recarguen con FQFR (G-002).
+
+---
+
 ## [1.27.0] — 2026-06-05
 
 ### Changed

package/README.md

@@ -33,7 +33,8 @@ Add to your `claude_desktop_config.json`:
         "BC_ENVIRONMENT": "production",
         "BC_COMPANY_FQ01": "company-guid-fq01",
         "BC_COMPANY_FQ28": "company-guid-fq28",
-        "BC_COMPANY_FQ88": "company-guid-fq88"
+        "BC_COMPANY_FQ88": "company-guid-fq88",
+        "BC_COMPANY_FQFR": "company-guid-franquicias"
       }
     }
   }
@@ -181,6 +182,7 @@ All APIs share the same OAuth 2.0 credentials (Azure AD client credentials flow)
 | `BC_COMPANY_FQ01` | Yes | Company GUID for store FQ01 |
 | `BC_COMPANY_FQ28` | No | Company GUID for store FQ28 |
 | `BC_COMPANY_FQ88` | No | Company GUID for store FQ88 |
+| `BC_COMPANY_FQFR` | No | Company GUID for Franquicias (FQFR) |
 | `LOG_LEVEL` | No | `debug`, `info`, `warn`, `error` (default: `info`) |
 
 ## Chart of Accounts

package/config/company-config.js

@@ -24,10 +24,17 @@ function getStores() {
       shortName: 'Candelaria',
       location: 'La Candelaria, Caracas',
     },
+    FQFR: {
+      companyId: process.env.BC_COMPANY_FQFR,
+      companyName: 'Full%20Queso%20Franquicias',
+      name: 'FQFR Franquicias',
+      shortName: 'Franquicias',
+      location: 'Franquicias',
+    },
   };
 }
 
-export const ALL_STORE_CODES = ['FQ01', 'FQ28', 'FQ88'];
+export const ALL_STORE_CODES = ['FQ01', 'FQ28', 'FQ88', 'FQFR'];
 
 export function resolveStores(storeCodes) {
   const stores = getStores();

package/config/income-accounts.js

@@ -25,6 +25,35 @@ export const COGS_ACCOUNTS = {
   57020: { name: 'Costos Diversos', nameEn: 'Diverse Costs' },
 };
 
+// ── Revenue classification for the store-payroll KPI denominator ─────────────
+// Verified against the real CoA (tests/discover-revenue-accounts.js, May 2026):
+//   40310 "Ventas Materia Prima otras tiendas" = intercompany de tienda (FQ01/FQ88,
+//          FQ28=0); su costo par es 50110 (see LESSONS L-011).
+//   40180 "Ventas Eventos - NEN" + 40700 "Ventas Eventos" = event sales (solo FQ01).
+//   40580 "Ganancia por dif. cambiario" + 40540/40550 "Descuentos/Rebajas en Compras"
+//          = ingreso NO-venta → fuera del denominador de tienda (confirmado por FP).
+// revenue_store = revenue_total − intercompany − events − non_sales.
+export const INTERCOMPANY_REVENUE_ACCOUNTS = ['40310'];
+export const EVENT_REVENUE_ACCOUNTS = ['40180', '40700'];
+export const NON_SALES_REVENUE_ACCOUNTS = ['40580', '40540', '40550'];
+
+// FQFR (master de franquicia): su intercompañía usa cuentas propias (royalties/fees),
+// NO 40310, y no tiene ventas de evento de tienda. El KPI de nómina/ventas NO aplica a
+// FQFR (ver KPI_PAYROLL_STORES) — esta clasificación es solo para que sus buckets de
+// venta salgan correctos si alguien consulta ventas de FQFR.
+export const FQFR_INTERCOMPANY_REVENUE_ACCOUNTS = ['40420', '40430', '40660', '40930'];
+
+// Tiendas a las que aplica el KPI nómina/ventas (FQFR excluido por completo).
+export const KPI_PAYROLL_STORES = ['FQ01', 'FQ28', 'FQ88'];
+
+// Cuentas de clasificación de ingreso por tienda (interco/eventos/no-venta).
+export function getRevenueClassification(storeCode) {
+  if (storeCode === 'FQFR') {
+    return { intercompany: FQFR_INTERCOMPANY_REVENUE_ACCOUNTS, events: [], nonSales: NON_SALES_REVENUE_ACCOUNTS };
+  }
+  return { intercompany: INTERCOMPANY_REVENUE_ACCOUNTS, events: EVENT_REVENUE_ACCOUNTS, nonSales: NON_SALES_REVENUE_ACCOUNTS };
+}
+
 // Income group labels for breakdown (by 100-prefix: 40110 → 40100)
 export const INCOME_GROUP_LABELS = {
   40100: '40100_ingreso_ventas',

package/lib/bc-client.js

@@ -18,6 +18,12 @@ export class BCClient {
     this._inflightRequests = new Map();
     this.STORE_DATA_TTL = 5 * 60 * 1000;      // 5 minutes
     this.EXCHANGE_RATE_TTL = 15 * 60 * 1000;   // 15 minutes
+
+    // Per-request hard timeout (ms). Without this a single hung fetch() never
+    // rejects → the whole tool call (and, via Promise.all consolidations, the
+    // MCP process) hangs forever. Generous default (all observed BC calls are
+    // <1s); tunable via env for unusually heavy OData reports. See L-015.
+    this.FETCH_TIMEOUT_MS = Number(process.env.BC_FETCH_TIMEOUT_MS) || 90000;
   }
 
   /**
@@ -135,8 +141,12 @@ export class BCClient {
 
   async fetchWithRetry(url, options, retries = 3) {
     for (let attempt = 1; attempt <= retries; attempt++) {
+      // Abort a hung request so it fails fast (and retries) instead of blocking
+      // forever. Each attempt gets its own controller/timer. See L-015.
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), this.FETCH_TIMEOUT_MS);
       try {
-        const response = await fetch(url, options);
+        const response = await fetch(url, { ...options, signal: controller.signal });
         if (response.status === 429 && attempt < retries) {
           const retryAfter = response.headers.get('Retry-After');
           const delay = retryAfter ? parseInt(retryAfter) * 1000 : attempt * 3000;
@@ -146,10 +156,20 @@ export class BCClient {
         }
         return response;
       } catch (err) {
-        if (attempt === retries) throw err;
+        const timedOut = err.name === 'AbortError';
+        if (attempt === retries) {
+          throw timedOut
+            ? new Error(`BC request timed out after ${this.FETCH_TIMEOUT_MS}ms (${retries} attempts): ${url}`)
+            : err;
+        }
         const delay = attempt * 2000;
-        logger.warn(`Fetch failed (attempt ${attempt}/${retries}), retrying in ${delay}ms...`);
+        logger.warn(
+          `Fetch ${timedOut ? `timed out (>${this.FETCH_TIMEOUT_MS}ms)` : 'failed'} ` +
+          `(attempt ${attempt}/${retries}), retrying in ${delay}ms...`
+        );
         await new Promise((r) => setTimeout(r, delay));
+      } finally {
+        clearTimeout(timer);
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullqueso/mcp-bc-gastos",
-  "version": "1.27.0",
+  "version": "1.31.0",
   "description": "MCP server for Business Central operational expense analysis, bank reconciliation, POS reconciliation, accounts receivable/payable, multi-payment draft visibility, payroll, inventory cost analysis, and manager reports - Full Queso franchise stores",
   "main": "server.js",
   "bin": {

package/server.js

@@ -33,6 +33,7 @@ import { accountTransactionsTool, handleAccountTransactions } from './tools/acco
 import { vendorTransactionsTool, handleVendorTransactions } from './tools/vendor-transactions.js';
 import { listVendorsTool, handleListVendors } from './tools/list-vendors.js';
 import { exchangeRateTool, handleGetExchangeRate } from './tools/get-exchange-rate.js';
+import { crmRateTool, handleGetCrmRate } from './tools/get-crm-rate.js';
 
 // Auditoria tools (bank reconciliation)
 import { listBankAccountsTool, handleListBankAccounts } from './tools/auditoria/list-bank-accounts.js';
@@ -138,6 +139,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       vendorTransactionsTool,
       listVendorsTool,
       exchangeRateTool,
+      crmRateTool,
       // Auditoria (bank reconciliation)
       listBankAccountsTool,
       reconciliationStatusTool,
@@ -234,6 +236,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'get_exchange_rate':
         result = await handleGetExchangeRate(bcClient, args);
         break;
+      case 'get_crm_rate':
+        result = await handleGetCrmRate(bcClient, args);
+        break;
       // Auditoria (bank reconciliation)
       case 'list_bank_accounts':
         result = await handleListBankAccounts(bcClient, args);

package/tools/account-transactions.js

@@ -15,7 +15,7 @@ export const accountTransactionsTool = {
       },
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       start_date: {

package/tools/anomaly-detection.js

@@ -28,7 +28,7 @@ export const anomalyDetectionTool = {
       },
       stores: {
         type: 'array',
-        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'all'] },
+        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR', 'all'] },
         description: 'Tiendas a analizar.',
         default: ['all'],
       },

package/tools/auditoria/bank-ledger-entries.js

@@ -9,7 +9,7 @@ export const bankLedgerEntriesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       bank_account: {

package/tools/auditoria/bank-reconciliation-report.js

@@ -12,7 +12,7 @@ export const bankReconciliationReportTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       bank_account: {

package/tools/auditoria/find-potential-matches.js

@@ -10,7 +10,7 @@ export const findPotentialMatchesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       bank_account: {

package/tools/auditoria/gl-account-entries.js

@@ -9,7 +9,7 @@ export const glAccountEntriesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       gl_account: {

package/tools/auditoria/list-bank-accounts.js

@@ -9,7 +9,7 @@ export const listBankAccountsTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
     },

package/tools/auditoria/pm-receipts.js

@@ -9,7 +9,7 @@ export const pmReceiptsTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       bank_account: {

package/tools/auditoria/reconcile-pos-sales.js

@@ -414,7 +414,7 @@ export const reconcilePOSSalesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a conciliar.',
       },
       start_date: {

package/tools/auditoria/reconciliation-status.js

@@ -10,7 +10,7 @@ export const reconciliationStatusTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       bank_account: {

package/tools/auditoria/suggest-journal-entries.js

@@ -12,7 +12,7 @@ export const suggestJournalEntriesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       bank_account: {

package/tools/auditoria/unmatched-ledger-entries.js

@@ -10,7 +10,7 @@ export const unmatchedLedgerEntriesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       bank_account: {

package/tools/auditoria/unmatched-statement-lines.js

@@ -10,7 +10,7 @@ export const unmatchedStatementLinesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       bank_account: {

package/tools/cierre-mensual/generate-closing-journal.js

@@ -19,7 +19,7 @@ export const generateClosingJournalTool = {
   inputSchema: {
     type: 'object',
     properties: {
-      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88'] },
+      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'] },
       month: { type: 'string', description: 'YYYY-MM' },
       output_dir: { type: 'string', description: 'Directorio de salida (default: /tmp).' },
       allow_partial: {

package/tools/cierre-mensual/get-match-results.js

@@ -23,7 +23,7 @@ export const getClosingMatchResultsTool = {
   inputSchema: {
     type: 'object',
     properties: {
-      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88'] },
+      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'] },
       month: { type: 'string', description: 'YYYY-MM' },
       list: {
         type: 'string',

package/tools/cierre-mensual/get-questionnaire.js

@@ -13,7 +13,7 @@ export const getClosingQuestionnaireTool = {
   inputSchema: {
     type: 'object',
     properties: {
-      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88'] },
+      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'] },
       month: { type: 'string', description: 'YYYY-MM' },
       bucket: {
         type: 'string',

package/tools/cierre-mensual/reconcile-with-bc.js

@@ -15,7 +15,7 @@ export const reconcileWithBcTool = {
   inputSchema: {
     type: 'object',
     properties: {
-      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88'] },
+      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'] },
       month: { type: 'string', description: 'YYYY-MM' },
     },
     required: ['store', 'month'],

package/tools/cierre-mensual/start-month-closing.js

@@ -19,7 +19,7 @@ export const startMonthClosingTool = {
   inputSchema: {
     type: 'object',
     properties: {
-      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88'] },
+      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'] },
       month: {
         type: 'string',
         description: 'Mes YYYY-MM (opcional). Si no se especifica, usa el mes más antiguo con statements abiertos.',

package/tools/cierre-mensual/submit-answers.js

@@ -10,7 +10,7 @@ export const submitClosingAnswersTool = {
   inputSchema: {
     type: 'object',
     properties: {
-      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88'] },
+      store: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'] },
       month: { type: 'string', description: 'YYYY-MM' },
       user: {
         type: 'string',

package/tools/cobranzas/collection-status.js

@@ -9,7 +9,7 @@ export const collectionStatusTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       start_date: {

package/tools/cobranzas/customer-balances.js

@@ -9,7 +9,7 @@ export const customerBalancesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       only_with_balance: {

package/tools/cobranzas/customer-ledger.js

@@ -9,7 +9,7 @@ export const customerLedgerTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       start_date: {

package/tools/cobranzas/customer-list.js

@@ -9,7 +9,7 @@ export const customerListTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       customer_number: {

package/tools/cobranzas/open-payables.js

@@ -9,7 +9,7 @@ export const openPayablesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       as_of_date: {

package/tools/cobranzas/open-receivables.js

@@ -9,7 +9,7 @@ export const openReceivablesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       as_of_date: {

package/tools/cobranzas/vendor-ledger.js

@@ -9,7 +9,7 @@ export const vendorLedgerTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       start_date: {

package/tools/efficiency-ratios.js

@@ -28,7 +28,7 @@ export const efficiencyRatiosTool = {
       },
       stores: {
         type: 'array',
-        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'all'] },
+        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR', 'all'] },
         description: 'Tiendas a analizar.',
         default: ['all'],
       },

package/tools/expense-analysis.js

@@ -29,7 +29,7 @@ export const expenseAnalysisTool = {
       },
       stores: {
         type: 'array',
-        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'all'] },
+        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR', 'all'] },
         description: 'Tiendas a analizar. Use ["all"] para todas.',
         default: ['all'],
       },

package/tools/expense-details.js

@@ -12,7 +12,7 @@ export const expenseDetailsTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88'],
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
         description: 'Tienda a consultar.',
       },
       period: {

package/tools/financials/cash-flow.js

@@ -66,7 +66,7 @@ export const cashFlowTool = {
     properties: {
       stores: {
         type: 'array',
-        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'all'] },
+        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR', 'all'] },
         description: 'Tiendas a analizar. Default: ["all"] (FQ01 + FQ28 + FQ88 + consolidado).',
         default: ['all'],
       },

package/tools/financials/index.js

@@ -12,7 +12,7 @@ export { cashFlowTool, handleCashFlow } from './cash-flow.js';
 export const financialStatementsTool = {
   name: 'get_financial_statements',
   description:
-    'Estado financiero completo (P&L / Profit & Loss) para una o más tiendas Full Queso (FQ01, FQ28, FQ88) en un período. ' +
+    'Estado financiero completo (P&L / Profit & Loss) para una o más tiendas Full Queso (FQ01, FQ28, FQ88, FQFR) en un período. ' +
     'Ejecuta las queries de Business Central en paralelo (ingresos 40000-49999, COGS 50000-59999, gastos 60000-99999) y ' +
     'devuelve JSON estructurado: ingresos por cuenta, COGS, margen bruto, gastos por categoría con benchmarks, margen ' +
     'operativo, ratios clave, score 0-100 e insights accionables. Multi-tienda calcula también el consolidado. ' +
@@ -24,8 +24,8 @@ export const financialStatementsTool = {
     properties: {
       stores: {
         type: 'array',
-        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'all'] },
-        description: 'Tiendas a analizar. Default: ["all"] (FQ01 + FQ28 + FQ88 + consolidado).',
+        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR', 'all'] },
+        description: 'Tiendas a analizar. Default: ["all"] (FQ01 + FQ28 + FQ88 + FQFR + consolidado).',
         default: ['all'],
       },
       period: {