@fullqueso/mcp-bc-gastos 1.33.0 → 1.35.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # CHANGELOG
 
+## [1.35.0] — 2026-09-03
+
+Release de publicación: npm estaba en 1.33.0 mientras el repo ya tenía 1.34.0 + FQYK.
+Esta versión sube a npm todo lo pendiente (incluye lo que 1.34.0 nunca documentó acá).
+
+### Added — `get_payroll_payments` (venía de 1.34.0, sin entrada en el CHANGELOG)
+Documentos y líneas de pago de nómina para diagnóstico de residuales. `tools/payroll/`.
+
+### Added — FQYK City Market operativa en los 59 tools
+- `config/company-config.js`: nueva compañía **FQYK** (City Market, Sabana Grande; alta en
+  producción 2026-08-29) y `ALL_STORE_CODES` como **fuente única** del universo de tiendas.
+  Los enum `store` de todos los tools la importan en vez de hardcodear la lista — agregar una
+  tienda ya no requiere tocar 50 archivos.
+- `companyName` = `ALIMENTOS%20YELLOW%20KING%2C%20C.A`: al PATCHear `companyInformation`, BC
+  renombra la compañía a su `displayName`. Las URLs OData usan **ese** nombre; con el anterior
+  devuelven `company does not exist`.
+- Si falta `BC_COMPANY_FQYK` en el entorno, `resolveStores()` avisa una vez por stderr: los
+  tools OData (por nombre) siguen funcionando, los REST (por GUID) fallan con 404.
+
+### Changed — README
+- El bloque de ejemplo de `claude_desktop_config.json` ahora incluye `BC_COMPANY_FQYK`.
+- Notas de instalación en macOS: rutas absolutas de Node (Claude Desktop no hereda el `PATH`
+  del shell) y setup de `~/mcp-venv` con `openpyxl` para los tools que exportan Excel.
+- Conteo de tools corregido: 59 en 10 dominios (decía 22 en 4) y sección de tools regenerada.
+
 ## [1.33.0] — 2026-07-11
 
 ### Added — `get_income_statement`: estado de resultados en formato Power BI (Level 1)

package/README.md

@@ -1,8 +1,8 @@
 # @fullqueso/mcp-bc-gastos
 
-MCP server for Microsoft Business Central — operational expenses, bank reconciliation, POS reconciliation, and accounts receivable/payable. Built for the Full Queso franchise (3 stores: FQ01 Chacao, FQ28 Marques, FQ88 Candelaria).
+MCP server for Microsoft Business Central — operational expenses, bank reconciliation, POS reconciliation, and accounts receivable/payable. Built for the Full Queso franchise (4 stores: FQ01 Chacao, FQ28 Marques, FQ88 Candelaria, FQYK City Market — plus FQFR, the franchisor).
 
-**22 tools** across 4 domains, powered by 3 BC API integrations.
+**59 tools** across 10 domains, powered by 4 BC API integrations.
 
 ## Features
 
@@ -34,6 +34,7 @@ Add to your `claude_desktop_config.json`:
         "BC_COMPANY_FQ01": "company-guid-fq01",
         "BC_COMPANY_FQ28": "company-guid-fq28",
         "BC_COMPANY_FQ88": "company-guid-fq88",
+        "BC_COMPANY_FQYK": "company-guid-fqyk",
         "BC_COMPANY_FQFR": "company-guid-franquicias"
       }
     }
@@ -41,6 +42,17 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
+> **macOS — rutas absolutas.** Claude Desktop no hereda el `PATH` del shell: si Node vino de
+> Homebrew o nvm, `"command": "npx"` falla con `spawn npx ENOENT`. Lo robusto es
+> `npm install -g @fullqueso/mcp-bc-gastos` y luego apuntar el config al server con rutas
+> absolutas — `"command"` = salida de `command -v node`, `"args"` = `["<npm root -g>/@fullqueso/mcp-bc-gastos/server.js"]`.
+
+> **Exportación a Excel.** Los tools que generan `.xlsx` (`generate_cxp_report`,
+> `get_bank_reconciliation_report` con `excel_output`, `get_cash_flow`, drafts, cierre mensual)
+> usan `~/mcp-venv/bin/python3` con `openpyxl`. Setup:
+> `python3 -m venv ~/mcp-venv && ~/mcp-venv/bin/pip install openpyxl`.
+> El resto de los tools funciona sin esto.
+
 ### Local Development
 
 ```bash
@@ -52,7 +64,7 @@ cp .env.example .env
 npm start
 ```
 
-## Tools (58)
+## Tools (59)
 
 _Sección generada por `scripts/generate-tools-doc.mjs` — no editar a mano._
 _Regenerar con: `node scripts/generate-tools-doc.mjs --write`_
@@ -60,7 +72,7 @@ _Regenerar con: `node scripts/generate-tools-doc.mjs --write`_
 ### Expense Analysis & Core (11 tools)
 
 #### compare_stores
-Compara la eficiencia de gastos entre las tiendas de Full Queso (FQ01 Chacao, FQ28 Marqués, FQ88 Candelaria).
+Compara la eficiencia de gastos entre las tiendas de Full Queso (FQ01 Chacao, FQ28 Marqués, FQ88 Candelaria, FQYK City Market).
 - Params: `period`, `month`, `start_date`, `end_date`
 
 #### detect_anomalies
@@ -267,7 +279,7 @@ Resumen ejecutivo consolidado de todos los Multi-Payments en borrador (Open y Tr
 Facturas de compra y/o venta SIN POSTEAR en Business Central (status Draft o In Review).
 - Params: `store`*, `type`, `start_date`, `end_date`, `include_in_review`, `summary_only`
 
-### Nómina (3 tools)
+### Nómina (4 tools)
 
 #### get_employees
 Lista empleados de una tienda con datos de nomina: tipo, status, salarios base, bonos predeterminados, fechas.
@@ -281,6 +293,10 @@ Lista documentos de nomina (headers) con filtros por periodo, tipo, status.
 Detalle de nomina por empleado para un documento.
 - Params: `store`*, `document_no`*, `employee_code`, `employee_search`
 
+#### get_payroll_payments
+Documentos de PAGO de nómina (tabla separada de la obligación) con sus líneas por empleado.
+- Params: `store`*, `payroll_document_no`, `payment_no`, `status`, `include_lines`
+
 ### Reports (2 tools)
 
 #### generate_cxp_report
@@ -294,7 +310,7 @@ Genera el Reporte Gerente HTML completo para una tienda FQ.
 ### Ventas (4 tools)
 
 #### compare_sales_by_store
-Comparación de rendimiento de VENTAS entre las tiendas de Full Queso (FQ01 Chacao, FQ28 Marqués, FQ88 Candelaria).
+Comparación de rendimiento de VENTAS entre las tiendas de Full Queso (FQ01 Chacao, FQ28 Marqués, FQ88 Candelaria, FQYK City Market).
 - Params: `period`, `month`, `start_date`, `end_date`, `metrics`
 
 #### get_item_sales_detail

package/config/bank-gl-map.json

@@ -1,59 +1,319 @@
 {
-  "version": "1.0",
-  "last_updated": "2026-05-17",
+  "version": "1.1",
+  "last_updated": "2026-08-27",
   "description": "Mapeo banco_code (BC Bank Account suffix) → cuenta GL (Chart of Accounts). Usado por POS reconciliation y journal entry suggestions. Cada tienda tiene su propio CoA con bancos distintos.",
   "stores": {
     "FQ01": {
       "store_name": "FQ01 - Chacao Sambil",
       "accounts": {
-        "MN0001": { "gl": "18210", "name": "Banesco 4421 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0002": { "gl": "18220", "name": "BDV 1925 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0003": { "gl": "18230", "name": "Bancamiga 7015 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0004": { "gl": "18240", "name": "BDV 5550 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0005": { "gl": "18250", "name": "Bancamiga 4523 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0006": { "gl": "18260", "name": "Bancrecer 2450 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0007": { "gl": "18270", "name": "Bancrecer 2467 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0008": { "gl": "18280", "name": "BDV 5187 Bs. (Pago Móvil)", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0012": { "gl": "18290", "name": "UBII", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0030": { "gl": "18130", "name": "Caja tienda ventas Bs.", "currency": "VES", "category": "caja" },
-        "ME0030": { "gl": "18140", "name": "Caja tienda ventas $", "currency": "USD", "category": "caja" },
-        "ME0006": { "gl": null, "name": "Zelle USD (Wells Fargo)", "currency": "USD", "category": "bancos_extranjeros", "_nota": "GL pendiente de confirmar" }
+        "MN0001": {
+          "gl": "18210",
+          "name": "Banesco 4421 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0002": {
+          "gl": "18220",
+          "name": "BDV 1925 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0003": {
+          "gl": "18230",
+          "name": "Bancamiga 7015 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0004": {
+          "gl": "18240",
+          "name": "BDV 5550 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0005": {
+          "gl": "18250",
+          "name": "Bancamiga 4523 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0006": {
+          "gl": "18260",
+          "name": "Bancrecer 2450 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0007": {
+          "gl": "18270",
+          "name": "Bancrecer 2467 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0008": {
+          "gl": "18280",
+          "name": "BDV 5187 Bs. (Pago Móvil)",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0012": {
+          "gl": "18290",
+          "name": "UBII",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0030": {
+          "gl": "18130",
+          "name": "Caja tienda ventas Bs.",
+          "currency": "VES",
+          "category": "caja"
+        },
+        "ME0030": {
+          "gl": "18140",
+          "name": "Caja tienda ventas $",
+          "currency": "USD",
+          "category": "caja"
+        },
+        "ME0006": {
+          "gl": null,
+          "name": "Zelle USD (Wells Fargo)",
+          "currency": "USD",
+          "category": "bancos_extranjeros",
+          "_nota": "GL pendiente de confirmar"
+        }
       }
     },
     "FQ28": {
       "store_name": "FQ28 - Marqués El Unicentro",
       "accounts": {
-        "MN0001": { "gl": "18210", "name": "BDV 8139 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0002": { "gl": "18220", "name": "Bancrecer 5474 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0028": { "gl": "18290", "name": "UBII 6249 Bs", "currency": "VES", "category": "bancos_nacionales", "_nota": "Punto 2 + Punto 3." },
-        "MN0029": { "gl": "18291", "name": "UBII 6442 Bs", "currency": "VES", "category": "bancos_nacionales", "_nota": "Punto 4 + Punto 7." },
-        "MN0030": { "gl": "18130", "name": "Caja tienda ventas Bs.", "currency": "VES", "category": "caja" },
-        "MN0031": { "gl": "18160", "name": "Caja transitoria tienda ventas Bs.", "currency": "VES", "category": "caja" },
-        "MN0032": { "gl": "18292", "name": "UBII 4 y 7 (duplicada)", "currency": "VES", "category": "bancos_nacionales", "_nota": "Cuenta duplicada creada por error — NO usar. Punto 4 y Punto 7 van a MN0029. Confirmado 2026-05-17." },
-        "MN0033": { "gl": "18295", "name": "UBII 7 bloqueado (duplicada)", "currency": "VES", "category": "bancos_nacionales", "_nota": "Cuenta duplicada creada por error — NO usar. Punto 7 va a MN0029. Confirmado 2026-05-17." },
-        "MN0098": { "gl": "18298", "name": "Operaciones en Tránsito", "currency": "VES", "category": "bancos_nacionales" },
-        "ME0002": { "gl": "18310", "name": "Bancrecer $", "currency": "USD", "category": "bancos_nacionales_divisas" },
-        "ME0005": { "gl": "18410", "name": "Zelle Bofa $ *", "currency": "USD", "category": "bancos_extranjeros" },
-        "ME0030": { "gl": "18140", "name": "Caja tienda ventas $", "currency": "USD", "category": "caja" },
-        "ME0031": { "gl": "18170", "name": "Caja transitoria tienda ventas $", "currency": "USD", "category": "caja" },
-        "ME0035": { "gl": "18150", "name": "Banco Bóveda $", "currency": "USD", "category": "caja" }
+        "MN0001": {
+          "gl": "18210",
+          "name": "BDV 8139 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0002": {
+          "gl": "18220",
+          "name": "Bancrecer 5474 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0028": {
+          "gl": "18290",
+          "name": "UBII 6249 Bs",
+          "currency": "VES",
+          "category": "bancos_nacionales",
+          "_nota": "Punto 2 + Punto 3."
+        },
+        "MN0029": {
+          "gl": "18291",
+          "name": "UBII 6442 Bs",
+          "currency": "VES",
+          "category": "bancos_nacionales",
+          "_nota": "Punto 4 + Punto 7."
+        },
+        "MN0030": {
+          "gl": "18130",
+          "name": "Caja tienda ventas Bs.",
+          "currency": "VES",
+          "category": "caja"
+        },
+        "MN0031": {
+          "gl": "18160",
+          "name": "Caja transitoria tienda ventas Bs.",
+          "currency": "VES",
+          "category": "caja"
+        },
+        "MN0032": {
+          "gl": "18292",
+          "name": "UBII 4 y 7 (duplicada)",
+          "currency": "VES",
+          "category": "bancos_nacionales",
+          "_nota": "Cuenta duplicada creada por error — NO usar. Punto 4 y Punto 7 van a MN0029. Confirmado 2026-05-17."
+        },
+        "MN0033": {
+          "gl": "18295",
+          "name": "UBII 7 bloqueado (duplicada)",
+          "currency": "VES",
+          "category": "bancos_nacionales",
+          "_nota": "Cuenta duplicada creada por error — NO usar. Punto 7 va a MN0029. Confirmado 2026-05-17."
+        },
+        "MN0098": {
+          "gl": "18298",
+          "name": "Operaciones en Tránsito",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "ME0002": {
+          "gl": "18310",
+          "name": "Bancrecer $",
+          "currency": "USD",
+          "category": "bancos_nacionales_divisas"
+        },
+        "ME0005": {
+          "gl": "18410",
+          "name": "Zelle Bofa $ *",
+          "currency": "USD",
+          "category": "bancos_extranjeros"
+        },
+        "ME0030": {
+          "gl": "18140",
+          "name": "Caja tienda ventas $",
+          "currency": "USD",
+          "category": "caja"
+        },
+        "ME0031": {
+          "gl": "18170",
+          "name": "Caja transitoria tienda ventas $",
+          "currency": "USD",
+          "category": "caja"
+        },
+        "ME0035": {
+          "gl": "18150",
+          "name": "Banco Bóveda $",
+          "currency": "USD",
+          "category": "caja"
+        }
       }
     },
     "FQ88": {
       "store_name": "FQ88 - La Candelaria",
       "_nota": "GL confirmados 2026-06-05 desde fq-239-audit/data/fq_bancos_all.json (consolidacion_por_banco).",
       "accounts": {
-        "MN0001": { "gl": "18210", "name": "Bancamiga 0240 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0002": { "gl": "18220", "name": "Bancamiga 9379 Bs. *", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0003": { "gl": "18230", "name": "BDV 9127 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0004": { "gl": "18240", "name": "BDV 7191 Bs. *", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0005": { "gl": "18250", "name": "Bancrecer 2558 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0007": { "gl": "18270", "name": "BDV Pago Movil 5145", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0008": { "gl": "18275", "name": "Banesco 9547 Bs.", "currency": "VES", "category": "bancos_nacionales", "_nota": "Banco nuevo agregado 2026-07-10 (Puntos 20 y 21, BANESCO_9547_BS., banco 0134). gl 18275 removido de adjustment_accounts_ves el 2026-07-10 (FP): ahora es banco real, entra normal en revaluación/reconciliación." },
-        "MN0028": { "gl": "18290", "name": "Ubii Bank", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0030": { "gl": "18130", "name": "Caja tienda ventas Bs.", "currency": "VES", "category": "caja" },
-        "ME0030": { "gl": "18140", "name": "Caja tienda ventas $", "currency": "USD", "category": "caja" },
-        "ME0005": { "gl": "18410", "name": "Zelle USD", "currency": "USD", "category": "bancos_extranjeros" }
+        "MN0001": {
+          "gl": "18210",
+          "name": "Bancamiga 0240 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0002": {
+          "gl": "18220",
+          "name": "Bancamiga 9379 Bs. *",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0003": {
+          "gl": "18230",
+          "name": "BDV 9127 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0004": {
+          "gl": "18240",
+          "name": "BDV 7191 Bs. *",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0005": {
+          "gl": "18250",
+          "name": "Bancrecer 2558 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0007": {
+          "gl": "18270",
+          "name": "BDV Pago Movil 5145",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0008": {
+          "gl": "18275",
+          "name": "Banesco 9547 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales",
+          "_nota": "Banco nuevo agregado 2026-07-10 (Puntos 20 y 21, BANESCO_9547_BS., banco 0134). gl 18275 removido de adjustment_accounts_ves el 2026-07-10 (FP): ahora es banco real, entra normal en revaluación/reconciliación."
+        },
+        "MN0028": {
+          "gl": "18290",
+          "name": "Ubii Bank",
+          "currency": "VES",
+          "category": "bancos_nacionales"
+        },
+        "MN0030": {
+          "gl": "18130",
+          "name": "Caja tienda ventas Bs.",
+          "currency": "VES",
+          "category": "caja"
+        },
+        "ME0030": {
+          "gl": "18140",
+          "name": "Caja tienda ventas $",
+          "currency": "USD",
+          "category": "caja"
+        },
+        "ME0005": {
+          "gl": "18410",
+          "name": "Zelle USD",
+          "currency": "USD",
+          "category": "bancos_extranjeros"
+        }
+      }
+    },
+    "FQYK": {
+      "store_name": "FQYK - City Market Sabana Grande",
+      "_nota": "Tienda nueva (provisionada 2026). Bancos del levantamiento \"CUENTAS FQYK.xlsx\" (FP 2026-08-26). Mercantil 9220 recibe Puntos 1 y 3 + Pago Móvil Tienda/Delivery — una sola cuenta real, un solo banco_code.",
+      "accounts": {
+        "MN0001": {
+          "gl": "18210",
+          "name": "Mercantil 9220 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales",
+          "_nota": "Puntos 1 y 3 + Pago Móvil Tienda/Delivery. EMPRESARIAL. Cuenta 01050193891193639220."
+        },
+        "MN0002": {
+          "gl": "18220",
+          "name": "BNC 2988 Bs. *",
+          "currency": "VES",
+          "category": "bancos_nacionales",
+          "_nota": "Puntos 2 y 4. PERSONAL. Cuenta 01910259942100022988."
+        },
+        "MN0003": {
+          "gl": "18230",
+          "name": "Banesco 1055 Bs.",
+          "currency": "VES",
+          "category": "bancos_nacionales",
+          "_nota": "Punto 5. EMPRESARIAL. Cuenta 01340328733281081055."
+        },
+        "MN0030": {
+          "gl": "18130",
+          "name": "Caja tienda ventas Bs.",
+          "currency": "VES",
+          "category": "caja"
+        },
+        "MN0031": {
+          "gl": "18160",
+          "name": "Caja transitoria tienda ventas Bs.",
+          "currency": "VES",
+          "category": "caja"
+        },
+        "MN0097": {
+          "gl": "18297",
+          "name": "Diferencias de caja diaria",
+          "currency": "VES",
+          "category": "caja"
+        },
+        "ME0005": {
+          "gl": "18410",
+          "name": "Zelle $",
+          "currency": "USD",
+          "category": "bancos_extranjeros"
+        },
+        "ME0030": {
+          "gl": "18140",
+          "name": "Caja tienda ventas $",
+          "currency": "USD",
+          "category": "caja"
+        },
+        "ME0031": {
+          "gl": "18170",
+          "name": "Caja transitoria tienda ventas $",
+          "currency": "USD",
+          "category": "caja"
+        },
+        "ME0035": {
+          "gl": "18150",
+          "name": "Banco Bóveda $",
+          "currency": "USD",
+          "category": "caja"
+        }
       }
     }
   },
@@ -93,5 +353,7 @@
     "18999": "Total Caja y Bancos"
   },
   "_adjustment_accounts_nota": "Cuentas VES de ajuste/tránsito (NO son bancos reales, no tienen statement). Se tratan como informativas en la revaluación cambiaria (fuera del total de pérdida y del asiento sugerido). FP 2026-06-05. 18275 removido 2026-07-10: BC lo reasignó al banco real Banesco 9547 (FQ88-MN0008).",
-  "adjustment_accounts_ves": ["18297"]
+  "adjustment_accounts_ves": [
+    "18297"
+  ]
 }

package/config/company-config.js

@@ -31,10 +31,23 @@ function getStores() {
       shortName: 'Franquicias',
       location: 'Franquicias',
     },
+    // Tienda nueva (provisionada en producción el 2026-08-29 con fq-company-provisioning).
+    // ⚠️ companyName = el DISPLAY name: al PATCHear companyInformation, BC renombra la compañía
+    // al displayName ("Alimentos Yellow King" → "ALIMENTOS YELLOW KING, C.A"). Las URLs OData
+    // usan ese nombre; con el otro devuelven "company does not exist".
+    FQYK: {
+      companyId: process.env.BC_COMPANY_FQYK,
+      companyName: 'ALIMENTOS%20YELLOW%20KING%2C%20C.A',
+      name: 'FQYK City Market',
+      shortName: 'City Market',
+      location: 'Sabana Grande, Caracas',
+    },
   };
 }
 
-export const ALL_STORE_CODES = ['FQ01', 'FQ28', 'FQ88', 'FQFR'];
+const warnedMissingId = new Set();
+
+export const ALL_STORE_CODES = ['FQ01', 'FQ28', 'FQ88', 'FQFR', 'FQYK'];
 
 export function resolveStores(storeCodes) {
   const stores = getStores();
@@ -44,6 +57,14 @@ export function resolveStores(storeCodes) {
   return storeCodes.map((code) => {
     const info = stores[code];
     if (!info) throw new Error(`Tienda desconocida: ${code}. Opciones: ${ALL_STORE_CODES.join(', ')}`);
+    // Una tienda recién provisionada existe acá antes de que su GUID llegue al .env (lo
+    // escribe scan-ecosystem.js --apply --company-id). No se lanza error porque los tools
+    // que van por OData usan companyName y funcionan igual; solo se avisa una vez para que
+    // un 404 de la API REST no parezca otra cosa.
+    if (!info.companyId && !warnedMissingId.has(code)) {
+      warnedMissingId.add(code);
+      console.error(`[company-config] ⚠️ Falta BC_COMPANY_${code} en el .env: los tools que usan la API REST (por GUID) van a fallar para ${code}. Los de OData (por nombre) funcionan. Fix: node scripts/scan-ecosystem.js --store-code ${code} --company-id <GUID> --apply (repo fq-company-provisioning).`);
+    }
     return { code, ...info };
   });
 }

package/config/income-accounts.js

@@ -43,8 +43,9 @@ export const NON_SALES_REVENUE_ACCOUNTS = ['40580', '40540', '40550'];
 // 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'];
+// Tiendas a las que aplica el KPI nómina/ventas (FQFR excluido por completo: es la
+// franquiciadora, no una tienda). FQYK entra desde su alta en 2026-08.
+export const KPI_PAYROLL_STORES = ['FQ01', 'FQ28', 'FQ88', 'FQYK'];
 
 // Cuentas de clasificación de ingreso por tienda (interco/eventos/no-venta).
 export function getRevenueClassification(storeCode) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullqueso/mcp-bc-gastos",
-  "version": "1.33.0",
+  "version": "1.35.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

@@ -69,6 +69,7 @@ import {
 import {
   payrollDocumentsTool, handlePayrollDocuments,
   payrollLinesTool, handlePayrollLines,
+  payrollPaymentsTool, handlePayrollPayments,
   employeesTool, handleEmployees,
 } from './tools/payroll/index.js';
 
@@ -170,6 +171,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       // Payroll
       payrollDocumentsTool,
       payrollLinesTool,
+      payrollPaymentsTool,
       employeesTool,
       // Inventario (inventory cost analysis)
       itemCardTool,
@@ -319,6 +321,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'get_payroll_lines':
         result = await handlePayrollLines(bcClient, args);
         break;
+      case 'get_payroll_payments':
+        result = await handlePayrollPayments(bcClient, args);
+        break;
       case 'get_employees':
         result = await handleEmployees(bcClient, args);
         break;

package/tools/account-transactions.js

@@ -1,5 +1,5 @@
 import { getExpenseCategory, getAccountName } from '../config/expense-accounts.js';
-import { resolveStores } from '../config/company-config.js';
+import { resolveStores, ALL_STORE_CODES } from '../config/company-config.js';
 import { round2 } from '../utils/currency-converter.js';
 
 export const accountTransactionsTool = {
@@ -15,7 +15,7 @@ export const accountTransactionsTool = {
       },
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
+        enum: ALL_STORE_CODES,
         description: 'Tienda a consultar.',
       },
       start_date: {

package/tools/anomaly-detection.js

@@ -1,3 +1,4 @@
+import { ALL_STORE_CODES } from '../config/company-config.js';
 import { getDateRange, getPreviousPeriodRange } from '../utils/date-helper.js';
 import { detectAnomalies } from '../lib/anomaly-detector.js';
 
@@ -28,7 +29,7 @@ export const anomalyDetectionTool = {
       },
       stores: {
         type: 'array',
-        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR', 'all'] },
+        items: { type: 'string', enum: [...ALL_STORE_CODES, 'all'] },
         description: 'Tiendas a analizar.',
         default: ['all'],
       },

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

@@ -1,4 +1,4 @@
-import { resolveStores } from '../../config/company-config.js';
+import { resolveStores, ALL_STORE_CODES } from '../../config/company-config.js';
 
 export const bankLedgerEntriesTool = {
   name: 'get_bank_ledger_entries',
@@ -9,7 +9,7 @@ export const bankLedgerEntriesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
+        enum: ALL_STORE_CODES,
         description: 'Tienda a consultar.',
       },
       bank_account: {

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

@@ -1,5 +1,5 @@
 import { DateTime } from 'luxon';
-import { resolveStores } from '../../config/company-config.js';
+import { resolveStores, ALL_STORE_CODES } from '../../config/company-config.js';
 import { matchBankDescription } from '../../config/bank-keywords.js';
 import { logger } from '../../utils/logger.js';
 
@@ -12,7 +12,7 @@ export const bankReconciliationReportTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
+        enum: ALL_STORE_CODES,
         description: 'Tienda a consultar.',
       },
       bank_account: {

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

@@ -1,5 +1,5 @@
 import { DateTime } from 'luxon';
-import { resolveStores } from '../../config/company-config.js';
+import { resolveStores, ALL_STORE_CODES } from '../../config/company-config.js';
 
 export const findPotentialMatchesTool = {
   name: 'find_potential_matches',
@@ -10,7 +10,7 @@ export const findPotentialMatchesTool = {
     properties: {
       store: {
         type: 'string',
-        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
+        enum: ALL_STORE_CODES,
         description: 'Tienda a consultar.',
       },
       bank_account: {