@fullqueso/mcp-bc-gastos 1.31.0 → 1.35.0

package/CHANGELOG.md

@@ -1,5 +1,86 @@
 # 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)
+Nuevo tool en `tools/financials/income-statement.js`. READ-ONLY.
+
+- **Qué expone:** el reporte "Income Statement by Month" de Power BI (G/L Account **Level 1**)
+  para una tienda y un mes, agregando los General Ledger entries por cuenta level-1 con la
+  convención de signos de Power BI (`amount = debitAmount − creditAmount` → ingresos negativos,
+  costos/gastos positivos, Total negativo = ganancia). Devuelve las 3 secciones (40001/50001/60001),
+  cuentas level-1, totales, Total general y un **`accounts_map`** listo para el generador Excel
+  del skill-fq-resultados-mensual (`data.json`). Con `level=2` incluye las cuentas de posteo
+  hijas con su nombre real de BC.
+- **Por qué:** resuelve las fronteras que `get_financial_statements` (agrega por categoría) no
+  separa: nómina **71000** vs impuestos **74000**, y otros **74000** (80xxx) vs **90000** (9xxxx).
+  Trabaja desde los entries por cuenta, así que cuadra 1:1 con Power BI.
+- **Estructura level-1** embebida (`COA_PBI`) — fuente: screenshots Power BI FQ28, CoA compartido
+  FQ01/FQ28/FQ88. Espejo de `skill-fq-resultados-mensual/references/income_statement_coa.json`.
+- **Nuevo en bc-client:** `getChartOfAccountNames(companyId)` (entidad BC `accounts`, cache por
+  companyId) para etiquetar las cuentas hijas en level 2.
+- **Test:** `tests/test-income-statement.js` (agregación pura con GL entries mock, sin BC):
+  valida signos, mapeo por rangos, fronteras 71000/74000 y 74000/90000, totales y level 2.
+- La columna **Ajustado** (drafts como posteados) y la reclasificación de dividendos las agrega
+  el skill sobre el `posted` — el MCP entrega solo el posted objetivo del GL.
+
+## [1.32.1] — 2026-07-04
+
+### Docs — README "Tools" regenerado desde el código (22 stale → 57 reales)
+- **`scripts/generate-tools-doc.mjs`**: importa dinámicamente todos los `*Tool` de
+  `tools/**/*.js` (incluye definiciones en `index.js`, dedup por `name`), agrupa por
+  categoría y reescribe la sección `## Tools (N)` del README. Verificado 57/57 contra
+  el switch de `server.js`. Uso: `node scripts/generate-tools-doc.mjs --write`
+  (sin flag = dry-run a stdout). La sección queda marcada como autogenerada.
+
+## [1.32.0] — 2026-07-04
+
+### Added — `get_unposted_invoices`: facturas sin postear para Cierre Parcial
+Nuevo tool en el cluster de draft visibility (`tools/multi-payment/unposted-invoices.js`).
+Verificado contra BC real (mayo 2026, 4 empresas). READ-ONLY.
+
+- **Qué expone:** facturas de compra y venta con `status` `Draft`/`In Review` en
+  `api/v2.0` `purchaseInvoices`/`salesInvoices` — documentos que NO están en el GL.
+  Complementa a `get_draft_payables`/`receivables`/`summary`, que son Multi-Payments
+  (settlement) sobre facturas ya posteadas y por tanto no sirven como ajuste P&L.
+- **Para qué:** ajuste de CIERRE PARCIAL del P&L en `skill-fq-resultados-mensual`
+  (compras draft → +costo/gasto; ventas draft no-IC → +ingreso). Cada tienda incluye
+  `pl_adjustment_hint` con los montos listos.
+- **Params:** `store` (incl. `all`), `type` (purchases|sales|both), `start_date`/`end_date`
+  (filtro por `postingDate`), `include_in_review` (default true), `summary_only`.
+- **Multi-moneda correcto:** totales SIEMPRE por moneda (`by_currency`,
+  `non_ic_by_currency`, consolidado por moneda) — nunca se suman VES con USD.
+  `LCY` = USD; VES se convierte aguas arriba con `get_exchange_rate`.
+- **Ventas IC:** separa clientes `IC-*` (`intercompany`) del total ajustable.
+- **Smoke test:** `tests/test-unposted-invoices.js` (store y mes por CLI).
+- Hallazgo del estreno (mayo 2026): FQ01 11 compras sin postear (Bs 1,838,737.54),
+  FQ28 4 (Bs 1,210,031.04), FQFR 2 ($7,116.50), FQ01 1 venta IC (Bs 165,456.04).
+
 ## [1.31.0] — 2026-07-01
 
 ### Added — KPIs de nómina operativa: tienda vs eventos, activos vs pagados

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,111 +64,268 @@ cp .env.example .env
 npm start
 ```
 
-## Tools (22)
+## Tools (59)
 
-### Expense Analysis (5 tools)
+_Sección generada por `scripts/generate-tools-doc.mjs` — no editar a mano._
+_Regenerar con: `node scripts/generate-tools-doc.mjs --write`_
 
-#### get_expense_analysis
-Detailed expense analysis by category with account-level detail and benchmark comparisons.
-- Params: `stores`, `period`, `month`, `start_date`, `end_date`
-
-#### get_efficiency_ratios
-Financial ratios: expense-to-income, payroll, rent, utilities, marketing, operating margin.
-- Params: `stores`, `period`, `month`, `start_date`, `end_date`
+### Expense Analysis & Core (11 tools)
 
 #### compare_stores
-Compare all stores with efficiency rankings, variances, and savings opportunities.
+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
-Detect expense anomalies with severity levels, root causes, and recommended actions.
-- Params: `stores`, `period`, `month`, `start_date`, `end_date`
+Detecta anomalías en los gastos operacionales de Full Queso: gastos por encima de benchmarks, incrementos inusuales vs periodo anterior, concentración excesiva en una cuenta, y alertas de margen.
+- Params: `period`, `month`, `start_date`, `end_date`, `stores`, `sensitivity`
 
-#### get_trends
-Historical trend analysis (up to 6 months) with growth rates, seasonality, and ASCII charts.
-- Params: `store`, `months`
+#### get_account_transactions
+Listado completo de transacciones para una cuenta contable específica con balance running y nombre de proveedor.
+- Params: `account_number`*, `store`*, `start_date`*, `end_date`*
+
+#### get_crm_rate
+Obtiene la tasa de cambio Bs/USD desde el CRM de Full Queso (hora Caracas).
+- Params: `coin`*, `date`
+
+#### get_efficiency_ratios
+Calcula ratios de eficiencia financiera de Full Queso: gastos/ingresos, nómina/ingresos, alquiler/ingresos, servicios/ingresos, marketing/ingresos y margen operativo.
+- Params: `period`, `month`, `start_date`, `end_date`, `stores`
+
+#### get_exchange_rate
+Obtiene la tasa de cambio USD → VES desde Business Central.
+- Params: `store`*, `date`, `start_date`, `end_date`
 
-### Drill-Down & Vendors (4 tools)
+#### get_expense_analysis
+Análisis detallado de gastos operacionales de Full Queso por categoría (nómina, alquiler, servicios, marketing, etc.) con números de cuenta específicos.
+- Params: `period`, `month`, `start_date`, `end_date`, `stores`
 
 #### get_expense_details
-Transaction-level drill-down with vendor lookup, category/account filters, and pagination.
-- Params: `store` (req), `period`, `month`, `start_date`, `end_date`, `category`, `account_number`, `min_amount`, `vendor_search`, `limit`, `offset`
+Drill-down de transacciones individuales de gastos operacionales.
+- Params: `store`*, `period`, `month`, `start_date`, `end_date`, `category`, `account_number`, `min_amount`, `vendor_search`, `limit`, `offset`
 
-#### get_account_transactions
-Per-account ledger with running balance and vendor information.
-- Params: `account_number` (req), `store` (req), `start_date` (req), `end_date` (req)
+#### get_trends
+Análisis de tendencias históricas de gastos e ingresos de Full Queso.
+- Params: `months`, `store`
 
 #### get_vendor_transactions
-All transactions for a vendor (partial name search) with account breakdown.
-- Params: `store` (req), `vendor_search` (req), `start_date` (req), `end_date` (req)
+Todas las transacciones de gastos operacionales de un proveedor específico.
+- Params: `store`*, `vendor_search`*, `start_date`*, `end_date`*
 
 #### list_vendors
-Directory of active vendors ordered by total amount paid.
-- Params: `store` (req), `start_date`, `end_date`
+Lista todos los proveedores activos de una tienda en un periodo, con monto total pagado y número de transacciones.
+- Params: `store`*, `start_date`, `end_date`
 
-### Bank Reconciliation (7 tools)
+### Auditoría / POS Reconciliation (11 tools)
 
-> These tools use OData V4 Web Services. Amounts in VES. Read-only.
+#### find_potential_matches
+Para una línea no conciliada del banco, busca posibles correspondencias en las entradas contables de BC por monto, fecha y descripción.
+- Params: `store`*, `bank_account`*, `statement_amount`*, `transaction_date`*, `description`, `date_tolerance_days`, `amount_tolerance_pct`
 
-#### list_bank_accounts
-List active bank accounts for a store.
-- Params: `store` (req)
+#### get_bank_ledger_entries
+Todos los movimientos del libro de banco (abiertos y cerrados) para una cuenta bancaria.
+- Params: `store`*, `bank_account`*, `date_from`*, `date_to`*, `open_only`
+
+#### get_bank_reconciliation_report
+Reporte consolidado de reconciliación bancaria: progreso de todos los statements abiertos, líneas no conciliadas (débitos y créditos por separado), y sugerencias de asientos contables para débitos.
+- Params: `store`*, `bank_account`*, `statement_no`, `month`, `min_amount`, `include_suggestions`, `save_to_file`, `excel_output`
+
+#### get_gl_account_entries
+Movimientos del libro mayor (G/L) para una cuenta específica.
+- Params: `store`*, `gl_account`*, `date_from`*, `date_to`*
+
+#### get_pm_receipts
+Recibos de Pago Móvil (PM) registrados en BC para una cuenta bancaria.
+- Params: `store`*, `bank_account`*, `date_from`*, `date_to`*
 
 #### get_reconciliation_status
-Open reconciliation summary: matched vs unmatched lines per bank account.
-- Params: `store` (req), `bank_account`
+Resumen del estado de reconciliaciones bancarias abiertas: total líneas, conciliadas, pendientes y diferencia.
+- Params: `store`*, `bank_account`
+
+#### get_unmatched_ledger_entries
+Entradas contables del banco en BC sin correspondencia en el estado de cuenta.
+- Params: `store`*, `bank_account`*, `date_from`, `date_to`
 
 #### get_unmatched_statement_lines
-Bank statement lines not reconciled with BC, categorized by type (payments/deposits).
-- Params: `store` (req), `bank_account` (req), `statement_no`, `min_amount`, `type_filter`
+Líneas del estado de cuenta bancario NO conciliadas con entradas en BC.
+- Params: `store`*, `bank_account`*, `statement_no`, `min_amount`, `type_filter`
 
-#### get_unmatched_ledger_entries
-BC ledger entries not cleared at the bank, with stale entry detection (>30 days).
-- Params: `store` (req), `bank_account` (req), `date_from`, `date_to`
+#### list_bank_accounts
+Lista las cuentas bancarias de una tienda Full Queso.
+- Params: `store`*
 
-#### find_potential_matches
-Scoring-based match finder (0-100) for unmatched bank lines against BC entries.
-- Params: `store` (req), `bank_account` (req), `statement_amount` (req), `transaction_date` (req), `description`, `date_tolerance_days`, `amount_tolerance_pct`
+#### reconcile_pos_sales
+Conciliación automática de ventas POS: cruza montos bancarios de BC (BankAccountLedgerEntries) con liquidaciones bancarias por número de lote, agrupa por liquidación bancaria (settlement batches), calcula comisiones reales.
+- Params: `store`*, `start_date`*, `end_date`*, `bank_account`
 
 #### suggest_journal_entries
-Suggest GL journal entries for unreconciled bank payments using keyword matching and historical patterns.
-- Params: `store` (req), `bank_account` (req), `statement_no`, `auto_categorize`
+Para pagos del banco sin correspondencia en BC, sugiere asientos contables basándose en la descripción y patrones históricos.
+- Params: `store`*, `bank_account`*, `statement_no`, `auto_categorize`
 
-#### reconcile_pos_sales
-Multi-bank POS sales reconciliation. Matches bank deposits against BC lot records with commission tracking.
-- **Banesco**: lot-based matching, commission netted in deposit
-- **Bancrecer**: lot-based with separate commission/ISLR lines
-- **BDV**: aggregate matching by period totals (no lot numbers)
-- **UBII**: cross-account matching (BC virtual account → Bancrecer/BDV deposits)
-- Params: `store` (req), `start_date` (req), `end_date` (req), `bank_account`
+### Cierre Mensual Bancario (6 tools)
+
+#### generate_closing_journal
+Genera el EXCEL del CIERRE MENSUAL bancario (mes completo, multi-banco).
+- Params: `store`*, `month`*, `output_dir`, `allow_partial`, `strict`
 
-### Accounts Receivable & Payable (6 tools)
+#### get_closing_match_results
+CIERRE MENSUAL bancario: vista paginada de las 4 listas con auto-clasificación.
+- Params: `store`*, `month`*, `list`, `bank_account`, `category`, `source`, `confidence`, `min_abs_amount_ves`, `sort`, `limit`, `offset`
 
-> These tools use the Finance Reports Beta API. Amounts in VES and USD. Read-only.
+#### get_closing_questionnaire
+CIERRE MENSUAL bancario: vista paginada/filtrada de las entradas del cuestionario del MES.
+- Params: `store`*, `month`*, `bucket`, `counterparty_no`, `bank_account`, `status_filter`, `min_abs_amount_ves`, `min_abs_amount_usd`, `limit`, `offset`, `sort`, `pair_by_amount`, `pair_tolerance_pct`, `pair_max_days`, `description_regex`
+
+#### reconcile_closing_with_bc
+CIERRE MENSUAL bancario: refresca el estado contra BC para detectar drift desde la última corrida.
+- Params: `store`*, `month`*
+
+#### start_month_closing
+CIERRE MENSUAL bancario (mes completo, multi-banco) en Business Central.
+- Params: `store`*, `month`, `force_refresh`
+
+#### submit_closing_answers
+CIERRE MENSUAL bancario: registra respuestas/aprobaciones al cuestionario del MES.
+- Params: `store`*, `month`*, `user`, `answers`*
+
+### Cobranzas (AR / AP) (7 tools)
+
+#### get_collection_status
+Verificación rápida del estado de cobranza de un período específico.
+- Params: `store`*, `start_date`*, `end_date`*
 
 #### get_customer_balances
-Customers with outstanding balances.
-- Params: `store` (req), `only_with_balance`, `customer_number`
+Lista clientes con saldos pendientes, montos vencidos y estado de cobranza.
+- Params: `store`*, `only_with_balance`, `customer_number`
 
 #### get_customer_ledger
-Customer transaction history: invoices, payments, credit memos with collection rate.
-- Params: `store` (req), `start_date` (req), `end_date` (req), `customer_number`, `document_type`, `open_only`
+Movimientos del libro mayor de clientes: facturas emitidas, pagos recibidos, notas de crédito.
+- Params: `store`*, `start_date`*, `end_date`*, `customer_number`, `document_type`, `open_only`
 
-#### get_open_receivables
-Open accounts receivable by customer with aging buckets (0-30, 31-60, 61-90, 90+).
-- Params: `store` (req), `as_of_date`, `customer_number`, `min_amount`
+#### get_customer_list
+Lista de clientes con número, nombre y RIF (taxRegistrationNumber).
+- Params: `store`*, `customer_number`
 
-#### get_collection_status
-Period collection completeness: "Were all December invoices collected?"
-- Params: `store` (req), `start_date` (req), `end_date` (req)
+#### get_open_payables
+Resumen de todas las cuentas por pagar abiertas.
+- Params: `store`*, `as_of_date`, `vendor_number`, `min_amount`
+
+#### get_open_receivables
+Resumen rápido de todas las cuentas por cobrar abiertas.
+- Params: `store`*, `as_of_date`, `customer_number`, `min_amount`
 
 #### get_vendor_ledger
-Vendor transaction history: bills received, payments made.
-- Params: `store` (req), `start_date` (req), `end_date` (req), `vendor_number`, `document_type`, `open_only`
+Movimientos del libro mayor de proveedores: facturas recibidas, pagos realizados, notas de crédito.
+- Params: `store`*, `start_date`*, `end_date`*, `vendor_number`, `document_type`, `open_only`
 
-#### get_open_payables
-Open accounts payable by vendor with aging buckets (0-30, 31-60, 61-90, 90+).
-- Params: `store` (req), `as_of_date`, `vendor_number`, `min_amount`
+### Financial Statements & Cash Flow (3 tools)
+
+#### get_cash_flow
+Free Cash Flow (FCF) por método indirecto para una o más tiendas Full Queso (FQ01, FQ28, FQ88).
+- Params: `stores`, `period`, `month`, `start_date`, `end_date`, `compare_previous`, `include_cash_position`, `render_html`, `output_path`, `open_browser`, `inline_html`
+
+#### get_financial_statements
+Estado financiero completo (P&L / Profit & Loss) para una o más tiendas Full Queso (FQ01, FQ28, FQ88, FQFR) en un período.
+- Params: `stores`, `period`, `month`, `start_date`, `end_date`, `render_html`, `compare_previous`, `output_path`, `open_browser`, `inline_html`
+
+#### get_income_statement
+Estado de resultados (Income Statement) en el formato EXACTO del reporte Power BI "Income Statement by Month" (G/L Account Level 1) para una tienda Full Queso (FQ01, FQ28, FQ88) y un mes.
+- Params: `store`, `stores`, `period`, `month`, `start_date`, `end_date`, `level`
+
+### Inventario (7 tools)
+
+#### get_inventory_by_location
+Inventario desglosado por ubicación (Location Code) dentro de una tienda.
+- Params: `store`*, `location_code`, `item_category`, `classification`, `as_of_date`
+
+#### get_inventory_change
+Cambio de inventario WoW (semana) o MoM (mes).
+- Params: `store`*, `period`*, `periods_back`, `item_category`, `classification`
+
+#### get_inventory_levels
+Niveles de inventario agrupados por itemCategoryCode y/o inventoryPostingGroupCode (congelados, importado, local).
+- Params: `store`*, `item_category`, `classification`, `as_of_date`
+
+#### get_item_card
+Datos maestros de ítems de inventario: unitCost (BC), calculated_unit_cost (real desde últimas entradas), inventory qty, unitPrice, categoría.
+- Params: `store`*, `item_number`, `item_search`, `item_category`
+
+#### get_item_cost_analysis
+Análisis de costo de un ítem — calcula costo promedio ponderado de entradas recientes (compras, ensamblaje, ajustes positivos), compara con el unitCost actual de BC, y muestra el historial de costos por mes.
+- Params: `store`*, `item_number`*, `months`
+
+#### get_item_cost_trend
+Tendencia de costo de ítems: compara weighted avg inbound cost de últimas 2 semanas vs últimas 4 semanas.
+- Params: `store`*, `item_number`, `item_category`, `period_days`
+
+#### get_item_ledger_entries
+Entradas del libro de artículos (Item Ledger Entries) — historial de movimientos de inventario con costo real por entrada.
+- Params: `store`*, `item_number`*, `entry_type`, `start_date`, `end_date`, `top`
+
+### Draft Visibility (Multi-Payments + facturas sin postear) (4 tools)
+
+#### get_draft_payables
+Muestra facturas de compra abiertas clasificadas en tres niveles: totalmente pendientes (sin documento de pago), con Purch.
+- Params: `store`*, `status_filter`, `vendor_number`, `include_lines`, `report`, `summary_only`, `save_to_file`, `excel_output`
+
+#### get_draft_receivables
+Muestra facturas de venta abiertas clasificadas en tres niveles: totalmente pendientes (sin documento de cobro), con Multi-Payment en borrador (Open o Transferred), y el monto neto realmente sin cubrir.
+- Params: `store`*, `status_filter`, `customer_number`, `include_lines`, `report`, `summary_only`, `save_to_file`, `excel_output`
+
+#### get_draft_summary
+Resumen ejecutivo consolidado de todos los Multi-Payments en borrador (Open y Transferred) para una o todas las tiendas.
+- Params: `store`*
+
+#### get_unposted_invoices
+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 (4 tools)
+
+#### get_employees
+Lista empleados de una tienda con datos de nomina: tipo, status, salarios base, bonos predeterminados, fechas.
+- Params: `store`*, `status`, `payroll_type`, `exclude_managerial`, `employee_search`, `employee_code`
+
+#### get_payroll_documents
+Lista documentos de nomina (headers) con filtros por periodo, tipo, status.
+- Params: `store`*, `period_code`, `payroll_type`, `exclude_managerial`, `status`, `start_date`, `end_date`, `include_employee_count`, `summary_only`
+
+#### get_payroll_lines
+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
+Genera reporte Excel de Cuentas por Pagar con 3 hojas: Sin Draft, Draft No Posteado, Pago Parcial + hoja Resumen con desglose por proveedor.
+- Params: `store`*, `output_path`
+
+#### generate_manager_report
+Genera el Reporte Gerente HTML completo para una tienda FQ.
+- Params: `store`*, `date`, `output_path`, `open_browser`, `payroll_days`
+
+### 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, FQYK City Market).
+- Params: `period`, `month`, `start_date`, `end_date`, `metrics`
+
+#### get_item_sales_detail
+Detalle de ventas por ítem específico (1–50 SKUs) con granularidad día/semana/mes/total y desglose por tienda.
+- Params: `items`*, `start_date`*, `end_date`*, `stores`, `granularity`, `include_zero_days`
+
+#### get_product_performance
+Análisis detallado de rendimiento de productos de Full Queso.
+- Params: `period`, `month`, `start_date`, `end_date`, `stores`, `sort_by`, `top_n`
+
+#### get_sales_analysis
+Análisis multidimensional de ventas de Full Queso.
+- Params: `period`, `month`, `start_date`, `end_date`, `stores`, `dimensions`, `metrics`
+
+_Los params marcados con `*` son requeridos. Detalle completo en `docs/tool_*.md`._
 
 ## API Integrations