@fullqueso/mcp-bc-gastos 1.31.0 → 1.33.0

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # CHANGELOG
 
+## [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

@@ -52,111 +52,264 @@ cp .env.example .env
 npm start
 ```
 
-## Tools (22)
+## Tools (58)
 
-### 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).
 - 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`*
 
-### Drill-Down & Vendors (4 tools)
+#### 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`
+
+#### 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`
+
+### Auditoría / POS Reconciliation (11 tools)
 
-### Bank Reconciliation (7 tools)
+#### 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`
 
-> These tools use OData V4 Web Services. Amounts in VES. Read-only.
+#### 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`
 
-#### list_bank_accounts
-List active bank accounts for a store.
-- Params: `store` (req)
+#### 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 (3 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`
+
+### 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).
+- 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
 

package/config/bank-gl-map.json

@@ -49,6 +49,7 @@
         "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" },
@@ -74,6 +75,7 @@
     "18250": "Banco quinto Bs.",
     "18260": "Banco sexto Bs.",
     "18270": "Banco séptimo Bs.",
+    "18275": "Banesco 9547 Bs. (FQ88)",
     "18280": "Banco octavo Bs.",
     "18290": "UBII principal",
     "18291": "UBII secundario",
@@ -90,6 +92,6 @@
     "18998": "Total Bancos",
     "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.",
-  "adjustment_accounts_ves": ["18275", "18297"]
+  "_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"]
 }

package/lib/bc-client.js

@@ -336,6 +336,20 @@ export class BCClient {
     return this.apiCallAllPages(url);
   }
 
+  // Nombres del Chart of Accounts (entidad `accounts` de BC api/v2.0) → { number: displayName }.
+  // Cache por companyId (el CoA cambia rara vez). Usado por get_income_statement (level 2)
+  // para etiquetar las cuentas de posteo hijas con su nombre real de BC.
+  async getChartOfAccountNames(companyId) {
+    if (!this._coaNameCache) this._coaNameCache = {};
+    if (this._coaNameCache[companyId]) return this._coaNameCache[companyId];
+    const url = this.buildApiUrl(companyId, 'accounts', { $select: 'number,displayName' });
+    const rows = await this.apiCallAllPages(url);
+    const map = {};
+    for (const a of rows) if (a && a.number) map[String(a.number)] = a.displayName || '';
+    this._coaNameCache[companyId] = map;
+    return map;
+  }
+
   // Saldos acumulados (a fecha) de cuentas con AMBAS monedas: debit/creditAmount = USD (LCY)
   // y additionalCurrency*Amount = VES (moneda adicional). Para revaluación de caja VES.
   // postingDate le asOfDate (acumulado desde el inicio = saldo a la fecha).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullqueso/mcp-bc-gastos",
-  "version": "1.31.0",
+  "version": "1.33.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/scripts/generate-tools-doc.mjs

@@ -0,0 +1,129 @@
+// scripts/generate-tools-doc.mjs
+// Regenera la sección "## Tools (N)" del README.md leyendo las definiciones
+// REALES exportadas por tools/**/*.js (objetos *Tool con name/description/inputSchema).
+// Uso:  node scripts/generate-tools-doc.mjs            → imprime el markdown
+//       node scripts/generate-tools-doc.mjs --write    → reescribe README.md
+// Así el README nunca vuelve a quedar stale: se regenera desde el código.
+
+import { readdirSync, readFileSync, writeFileSync } from 'fs';
+import { fileURLToPath, pathToFileURL } from 'url';
+import { dirname, join, relative } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = join(__dirname, '..');
+const TOOLS_DIR = join(ROOT, 'tools');
+const README = join(ROOT, 'README.md');
+
+const CATEGORY_LABELS = {
+  '': 'Expense Analysis & Core',
+  'auditoria': 'Auditoría / POS Reconciliation',
+  'cierre-mensual': 'Cierre Mensual Bancario',
+  'cobranzas': 'Cobranzas (AR / AP)',
+  'financials': 'Financial Statements & Cash Flow',
+  'inventario': 'Inventario',
+  'multi-payment': 'Draft Visibility (Multi-Payments + facturas sin postear)',
+  'payroll': 'Nómina',
+  'reports': 'Reports',
+  'ventas': 'Ventas',
+};
+
+function jsFiles(dir) {
+  const out = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) out.push(...jsFiles(join(dir, entry.name)));
+    else if (entry.name.endsWith('.js') && !entry.name.startsWith('.')) {
+      // index.js incluido: algunos tools se DEFINEN ahí (ej. financials/index.js);
+      // los re-exports duplicados se filtran después con dedup por name.
+      out.push(join(dir, entry.name));
+    }
+  }
+  return out.sort();
+}
+
+function firstSentence(text, max = 240) {
+  const clean = String(text || '').replace(/\s+/g, ' ').trim();
+  const dot = clean.indexOf('. ');
+  const s = dot > 30 ? clean.slice(0, dot + 1) : clean;
+  return s.length > max ? s.slice(0, max - 1).trimEnd() + '…' : s;
+}
+
+function paramsLine(schema) {
+  const props = schema?.properties || {};
+  const required = new Set(schema?.required || []);
+  const parts = Object.keys(props).map((k) => (required.has(k) ? `\`${k}\`*` : `\`${k}\``));
+  return parts.length ? `- Params: ${parts.join(', ')}` : '- Params: (ninguno)';
+}
+
+async function collectTools() {
+  const byCategory = new Map();
+  for (const file of jsFiles(TOOLS_DIR)) {
+    const rel = relative(TOOLS_DIR, file);
+    const category = rel.includes('/') ? rel.split('/')[0] : '';
+    let mod;
+    try {
+      mod = await import(pathToFileURL(file).href);
+    } catch (e) {
+      console.error(`WARN: no se pudo importar ${rel}: ${e.message}`);
+      continue;
+    }
+    for (const [key, val] of Object.entries(mod)) {
+      if (!key.endsWith('Tool')) continue;
+      if (!val || typeof val !== 'object' || !val.name || !val.description) continue;
+      if (!byCategory.has(category)) byCategory.set(category, []);
+      byCategory.get(category).push(val);
+    }
+  }
+  // dedup por name (algunos módulos re-exportan)
+  for (const [cat, tools] of byCategory) {
+    const seen = new Set();
+    byCategory.set(cat, tools.filter((t) => (seen.has(t.name) ? false : seen.add(t.name))));
+  }
+  return byCategory;
+}
+
+function buildMarkdown(byCategory) {
+  const order = Object.keys(CATEGORY_LABELS).filter((k) => byCategory.has(k));
+  for (const k of byCategory.keys()) if (!order.includes(k)) order.push(k); // dirs nuevos
+  const total = [...byCategory.values()].reduce((n, t) => n + t.length, 0);
+
+  const lines = [`## Tools (${total})`, '',
+    '_Sección generada por `scripts/generate-tools-doc.mjs` — no editar a mano._',
+    '_Regenerar con: `node scripts/generate-tools-doc.mjs --write`_', ''];
+  for (const cat of order) {
+    const tools = byCategory.get(cat);
+    const label = CATEGORY_LABELS[cat] || cat;
+    lines.push(`### ${label} (${tools.length} tool${tools.length !== 1 ? 's' : ''})`, '');
+    for (const t of tools.sort((a, b) => a.name.localeCompare(b.name))) {
+      lines.push(`#### ${t.name}`);
+      lines.push(firstSentence(t.description));
+      lines.push(paramsLine(t.inputSchema), '');
+    }
+  }
+  lines.push('_Los params marcados con `*` son requeridos. Detalle completo en `docs/tool_*.md`._', '');
+  return lines.join('\n');
+}
+
+function spliceReadme(md) {
+  const readme = readFileSync(README, 'utf8');
+  const lines = readme.split('\n');
+  const start = lines.findIndex((l) => /^## Tools/.test(l));
+  if (start === -1) throw new Error('No se encontró la sección "## Tools" en README.md');
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i++) {
+    if (/^## /.test(lines[i])) { end = i; break; }
+  }
+  const next = [...lines.slice(0, start), ...md.split('\n'), ...lines.slice(end)];
+  writeFileSync(README, next.join('\n'));
+  return { start: start + 1, end, total_lines: next.length };
+}
+
+const byCategory = await collectTools();
+const md = buildMarkdown(byCategory);
+
+if (process.argv.includes('--write')) {
+  const info = spliceReadme(md);
+  const total = [...byCategory.values()].reduce((n, t) => n + t.length, 0);
+  console.log(`README.md actualizado: ${total} tools, sección en línea ${info.start} (antes terminaba en ${info.end}). Total ${info.total_lines} líneas.`);
+} else {
+  console.log(md);
+}

package/server.js

@@ -62,6 +62,7 @@ import {
   draftReceivablesTool, handleDraftReceivables,
   draftPayablesTool, handleDraftPayables,
   draftSummaryTool, handleDraftSummary,
+  unpostedInvoicesTool, handleUnpostedInvoices,
 } from './tools/multi-payment/index.js';
 
 // Payroll tools
@@ -104,10 +105,11 @@ import {
   reconcileWithBcTool, handleReconcileWithBc,
 } from './tools/cierre-mensual/index.js';
 
-// Financials (P&L / Financial Statements) + Cash Flow (FCF)
+// Financials (P&L / Financial Statements) + Cash Flow (FCF) + Income Statement (Power BI)
 import {
   financialStatementsTool, handleFinancialStatements,
   cashFlowTool, handleCashFlow,
+  incomeStatementTool, handleIncomeStatement,
 } from './tools/financials/index.js';
 
 const pkg = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf-8'));
@@ -164,6 +166,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       draftReceivablesTool,
       draftPayablesTool,
       draftSummaryTool,
+      unpostedInvoicesTool,
       // Payroll
       payrollDocumentsTool,
       payrollLinesTool,
@@ -191,9 +194,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       getClosingQuestionnaireTool,
       getClosingMatchResultsTool,
       reconcileWithBcTool,
-      // Financials (P&L / Financial Statements) + Cash Flow (FCF)
+      // Financials (P&L / Financial Statements) + Cash Flow (FCF) + Income Statement (Power BI)
       financialStatementsTool,
       cashFlowTool,
+      incomeStatementTool,
     ],
   };
 });
@@ -305,6 +309,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'get_draft_summary':
         result = await handleDraftSummary(bcClient, args);
         break;
+      case 'get_unposted_invoices':
+        result = await handleUnpostedInvoices(bcClient, args);
+        break;
       // Payroll
       case 'get_payroll_documents':
         result = await handlePayrollDocuments(bcClient, args);
@@ -383,6 +390,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'get_cash_flow':
         result = await handleCashFlow(bcClient, args);
         break;
+      case 'get_income_statement':
+        result = await handleIncomeStatement(bcClient, args);
+        break;
       default:
         return {
           content: [{ type: 'text', text: `Herramienta desconocida: ${name}` }],

package/tools/financials/income-statement.js

@@ -0,0 +1,265 @@
+// tools/financials/income-statement.js
+//
+// get_income_statement — Estado de resultados en el formato exacto del reporte Power BI
+// "Income Statement by Month" (G/L Account Level 1). Agrega los General Ledger entries por
+// bucket level-1 con la convención de signos de Power BI:
+//     amount = debitAmount − creditAmount
+//   → ingresos (crédito) salen NEGATIVOS, costos/gastos (débito) POSITIVOS,
+//     Total = Σ(debit − credit); Total NEGATIVO = ganancia.
+//
+// Resuelve la parte frágil que el skill hacía a mano: partir los gastos por las fronteras
+// level-1 (nómina 71000 vs impuestos 74000, otros 74000 vs 90000). Aquí se hace desde los
+// entries por cuenta, así que cuadra 1:1 con Power BI. La columna Ajustado (drafts como
+// posteados) y la reclasificación de dividendos las agrega el skill sobre este posted.
+//
+// Consumido por skill-fq-resultados-mensual (build_income_statement.py). READ-ONLY.
+
+import { resolveStores } from '../../config/company-config.js';
+import { getDateRange } from '../../utils/date-helper.js';
+import { round2 } from '../../utils/currency-converter.js';
+import { logger } from '../../utils/logger.js';
+import { periodLabel } from './statements.js';
+
+// ── Estructura level-1 de Power BI ────────────────────────────────────────────
+// Fuente: screenshots del reporte Power BI FQ28 (refresh 2026-05-04). CoA compartido
+// FQ01/FQ28/FQ88. MANTENER SINCRONIZADO con
+// skill-fq-resultados-mensual/references/income_statement_coa.json.
+export const COA_PBI = {
+  sections: [
+    {
+      id: 'ingresos', total_account: '40001', total_name: 'TOTAL INGRESOS', range: [40000, 49999],
+      level1: [
+        { account: '40100', name: 'Ingreso Ventas', from: 40000, to: 40299 },
+        { account: '40300', name: 'Ingreso Facturación Directa', from: 40300, to: 40399 },
+        { account: '40400', name: 'Ingreso por Servicios', from: 40400, to: 40499 },
+        { account: '40500', name: 'Otros Ingresos', from: 40500, to: 40599 },
+        { account: '40600', name: 'Ingresos por Alquiler', from: 40600, to: 40899 },
+        { account: '40900', name: 'Ingresos Extraordinarios', from: 40900, to: 49999 },
+      ],
+    },
+    {
+      id: 'costo_ventas', total_account: '50001', total_name: 'TOTAL COSTO DE VENTAS', range: [50000, 59999],
+      level1: [
+        { account: '50100', name: 'Costo de Productos', from: 50000, to: 50999 },
+        { account: '51000', name: 'Otros Costos de Producción', from: 51000, to: 51999 },
+        { account: '52000', name: 'Costos Desechables y Empaques', from: 52000, to: 55999 },
+        { account: '56000', name: 'Fletes', from: 56000, to: 56999 },
+        { account: '57000', name: 'Mantenimiento y reparación de equipos cocina', from: 57000, to: 59999 },
+      ],
+    },
+    {
+      id: 'gastos_operativos', total_account: '60001', total_name: 'TOTAL GASTOS OPERATIVOS', range: [60000, 99999],
+      level1: [
+        { account: '60002', name: 'Gastos Planta Física', from: 60000, to: 61999 },
+        { account: '62000', name: 'gastos de logistica', from: 62000, to: 62999 },
+        { account: '63000', name: 'Gastos Mercadeo, Publicidad y Ventas', from: 63000, to: 63999 },
+        { account: '64000', name: 'Gastos Administrativos Tienda', from: 64000, to: 66999 },
+        { account: '67000', name: 'Egresos Financieros', from: 67000, to: 67999 },
+        { account: '68000', name: 'Gastos Servicios Contratados', from: 68000, to: 70999 },
+        { account: '71000', name: 'sueldos y salarios', from: 71000, to: 73999 },
+        { account: '74000', name: 'Impuestos y permisologias', from: 74000, to: 89999 },
+        { account: '90000', name: 'Otros Egresos', from: 90000, to: 99999 },
+      ],
+    },
+  ],
+};
+
+function sectionIdFor(acctNum) {
+  if (acctNum >= 40000 && acctNum <= 49999) return 'ingresos';
+  if (acctNum >= 50000 && acctNum <= 59999) return 'costo_ventas';
+  if (acctNum >= 60000 && acctNum <= 99999) return 'gastos_operativos';
+  return null;
+}
+
+function bucketFor(section, acctNum) {
+  for (const b of section.level1) {
+    if (acctNum >= b.from && acctNum <= b.to) return b;
+  }
+  return section.level1[section.level1.length - 1]; // fallback defensivo
+}
+
+// ── Agregación pura (testeable sin BC) ────────────────────────────────────────
+// entries: [{ accountNumber, debitAmount, creditAmount, description? }]
+// opts: { level = 1, accountNames = {} }
+export function buildStatement(entries, { level = 1, accountNames = {} } = {}) {
+  const secDefById = Object.fromEntries(COA_PBI.sections.map((s) => [s.id, s]));
+  const acc = {};
+  for (const s of COA_PBI.sections) {
+    acc[s.id] = { total: 0, buckets: {} };
+    for (const b of s.level1) acc[s.id].buckets[b.account] = { amount: 0, children: {} };
+  }
+
+  for (const e of entries || []) {
+    const acctNum = parseInt(e.accountNumber, 10);
+    if (!Number.isFinite(acctNum)) continue;
+    const secId = sectionIdFor(acctNum);
+    if (!secId) continue;
+    const bucket = bucketFor(secDefById[secId], acctNum);
+    const amt = (e.debitAmount || 0) - (e.creditAmount || 0); // convención Power BI
+    const box = acc[secId];
+    box.total += amt;
+    box.buckets[bucket.account].amount += amt;
+    if (level >= 2) {
+      const key = String(e.accountNumber);
+      const ch = box.buckets[bucket.account].children;
+      if (!ch[key]) ch[key] = { account: key, name: accountNames[key] || e.description || `Cuenta ${key}`, amount: 0 };
+      ch[key].amount += amt;
+    }
+  }
+
+  const sections = [];
+  const accounts_map = {};
+  let grand = 0;
+  for (const s of COA_PBI.sections) {
+    const box = acc[s.id];
+    const accounts = [];
+    for (const b of s.level1) {
+      const bk = box.buckets[b.account];
+      const amount = round2(bk.amount);
+      const childArr = Object.values(bk.children)
+        .map((c) => ({ account: c.account, name: c.name, amount: round2(c.amount) }))
+        .sort((x, y) => x.account.localeCompare(y.account));
+      const row = { account: b.account, name: b.name, amount };
+      if (level >= 2) row.children = childArr;
+      accounts.push(row);
+
+      const mapEntry = { posted: amount };
+      if (level >= 2 && childArr.length) {
+        mapEntry.children = {};
+        for (const c of childArr) mapEntry.children[c.account] = { name: c.name, posted: c.amount };
+      }
+      accounts_map[b.account] = mapEntry;
+    }
+    const total = round2(box.total);
+    grand += total;
+    sections.push({ id: s.id, total_account: s.total_account, total_name: s.total_name, total, accounts });
+  }
+
+  return {
+    sign_convention: 'power_bi (amount = debit − credit): ingresos negativos, costos/gastos positivos, Total negativo = ganancia',
+    sections,
+    grand_total: round2(grand),
+    accounts_map,
+  };
+}
+
+// ── Orquestador ───────────────────────────────────────────────────────────────
+export async function getIncomeStatement(bcClient, params = {}) {
+  const t0 = Date.now();
+  const period = params.period || 'last_month';
+  const level = Number(params.level) === 2 ? 2 : 1;
+
+  let storeCodes = params.stores && params.stores.length ? params.stores : (params.store ? [params.store] : ['all']);
+  const stores = resolveStores(storeCodes.includes('all') ? null : storeCodes);
+  const { start, end } = getDateRange(period, params.start_date, params.end_date, params.month);
+  const label = periodLabel(start, end);
+
+  logger.info(`[income_statement] stores=${stores.map((s) => s.code).join(',')} ${start}→${end} level=${level}`);
+
+  const fxTask = bcClient
+    .getExchangeRates(stores[0].code)
+    .then((rates) => bcClient.getExchangeRateForDate(rates, end))
+    .catch((err) => {
+      logger.warn(`[income_statement] exchange rate fetch failed: ${err.message}`);
+      return null;
+    });
+
+  const perStore = await Promise.all(
+    stores.map(async (s) => {
+      const [income, cogs, expenses] = await Promise.all([
+        bcClient.getGLEntries(s.companyId, start, end, '40000', '49999'),
+        bcClient.getGLEntries(s.companyId, start, end, '50000', '59999'),
+        bcClient.getGLEntries(s.companyId, start, end, '60000', '99999'),
+      ]);
+      let accountNames = {};
+      if (level >= 2) {
+        accountNames = await bcClient.getChartOfAccountNames(s.companyId).catch((err) => {
+          logger.warn(`[income_statement] CoA names fetch failed (${s.code}): ${err.message}`);
+          return {};
+        });
+      }
+      const statement = buildStatement([...income, ...cogs, ...expenses], { level, accountNames });
+      return {
+        code: s.code, name: s.name,
+        companyName: decodeURIComponent(s.companyName || '') || s.name,
+        statement,
+      };
+    })
+  );
+
+  const fx = await fxTask;
+
+  const storesOut = {};
+  for (const r of perStore) {
+    storesOut[r.code] = {
+      store_code: r.code,
+      store_name: r.name,
+      company_name: r.companyName,
+      ...r.statement,
+    };
+  }
+
+  return {
+    format: 'power_bi_income_statement',
+    level,
+    period: { start, end, label },
+    exchange_rate: fx ? { rate: round2(fx.rate), label: `1 USD = ${round2(fx.rate)} VES` } : null,
+    generated_at: new Date().toISOString(),
+    note:
+      'Columna POSTED = Power BI tal cual (amount = debit − credit; ingresos negativos; Total negativo = ganancia). ' +
+      'El skill-fq-resultados-mensual agrega la columna Ajustado (drafts como posteados vía get_unposted_invoices + ' +
+      'nómina Draft) y la reclasificación de nómina gerencial a dividendos. `accounts_map` va listo para el data.json ' +
+      'del generador (build_income_statement.py): clave = cuenta level-1, valor = { posted, children? }.',
+    stores: storesOut,
+    query_duration_ms: Date.now() - t0,
+  };
+}
+
+// ── Definición del tool + handler ─────────────────────────────────────────────
+export const incomeStatementTool = {
+  name: 'get_income_statement',
+  description:
+    '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. Agrega los General Ledger entries ' +
+    'por cuenta level-1 con la convención de signos de Power BI (ingresos negativos, costos/gastos positivos, Total ' +
+    'negativo = ganancia), listo para comparar 1:1 con Power BI. Devuelve las 3 secciones (40001 TOTAL INGRESOS, ' +
+    '50001 TOTAL COSTO DE VENTAS, 60001 TOTAL GASTOS OPERATIVOS) con sus cuentas level-1, totales y Total general, ' +
+    'más un `accounts_map` listo para el generador Excel del skill. Con level=2 incluye las cuentas de posteo hijas ' +
+    'con su nombre real de BC. Resuelve las fronteras 71000/74000 y 74000/90000 que get_financial_statements no separa. ' +
+    'Úsalo para: income statement, estado de resultados level 1, resultado mensual comparable con Power BI, P&L por ' +
+    'cuenta. La columna Ajustado (drafts) la agrega el skill. READ-ONLY.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      store: {
+        type: 'string',
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR'],
+        description: 'Tienda a analizar (una sola, recomendado). Alternativa a `stores`.',
+      },
+      stores: {
+        type: 'array',
+        items: { type: 'string', enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR', 'all'] },
+        description: 'Tiendas a analizar. Default: ["all"]. Para el income statement de una tienda usar `store`.',
+      },
+      period: {
+        type: 'string',
+        enum: ['last_month', 'this_month', 'specific_month', 'custom'],
+        description: 'Período. Default: last_month. Para un mes exacto usar period="specific_month" + month.',
+        default: 'last_month',
+      },
+      month: { type: 'string', description: 'Mes "YYYY-MM" (con period="specific_month").' },
+      start_date: { type: 'string', description: 'Fecha inicio "YYYY-MM-DD" (con period="custom").' },
+      end_date: { type: 'string', description: 'Fecha fin "YYYY-MM-DD" (con period="custom").' },
+      level: {
+        type: 'number',
+        enum: [1, 2],
+        description: 'Nivel de detalle: 1 = level-1 como Power BI (default); 2 = con cuentas de posteo hijas.',
+        default: 1,
+      },
+    },
+  },
+};
+
+export async function handleIncomeStatement(bcClient, args) {
+  return getIncomeStatement(bcClient, args || {});
+}

package/tools/financials/index.js

@@ -8,6 +8,7 @@
 import { getFinancialStatements } from './statements.js';
 
 export { cashFlowTool, handleCashFlow } from './cash-flow.js';
+export { incomeStatementTool, handleIncomeStatement } from './income-statement.js';
 
 export const financialStatementsTool = {
   name: 'get_financial_statements',

package/tools/multi-payment/index.js

@@ -1,3 +1,4 @@
 export { draftReceivablesTool, handleDraftReceivables } from './draft-receivables.js';
 export { draftPayablesTool, handleDraftPayables } from './draft-payables.js';
 export { draftSummaryTool, handleDraftSummary } from './draft-summary.js';
+export { unpostedInvoicesTool, handleUnpostedInvoices } from './unposted-invoices.js';

package/tools/multi-payment/unposted-invoices.js

@@ -0,0 +1,224 @@
+// tools/multi-payment/unposted-invoices.js
+// Facturas de compra y venta SIN POSTEAR en Business Central (status Draft /
+// In Review en api/v2.0 purchaseInvoices y salesInvoices). A diferencia de los
+// tools de multi-payment (settlement de facturas ya posteadas), estos documentos
+// NO están en el GL todavía → son los ajustes de "Cierre Parcial" del P&L:
+//   compras draft → +COGS/gasto estimado; ventas draft → +ingreso estimado.
+// Consumido por skill-fq-resultados-mensual.
+
+import { resolveStores } from '../../config/company-config.js';
+import { logger } from '../../utils/logger.js';
+
+const round2 = (n) => Math.round((n + Number.EPSILON) * 100) / 100;
+
+export const unpostedInvoicesTool = {
+  name: 'get_unposted_invoices',
+  description:
+    'Facturas de compra y/o venta SIN POSTEAR en Business Central (status Draft o In Review). ' +
+    'Estos documentos NO están en el GL: son la base del ajuste de CIERRE PARCIAL del P&L ' +
+    '(compras draft → costo/gasto estimado; ventas draft → ingreso estimado). ' +
+    'NO confundir con get_draft_payables/receivables (Multi-Payments de cobro/pago sobre ' +
+    'facturas ya posteadas). Filtra por rango de postingDate, separa ventas intercompañía (IC-*) ' +
+    'y totaliza por moneda. Úsalo para: cierre parcial, resultados con drafts, facturas sin ' +
+    'postear, "qué falta por postear del mes". READ-ONLY.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      store: {
+        type: 'string',
+        enum: ['FQ01', 'FQ28', 'FQ88', 'FQFR', 'all'],
+        description: 'Tienda(s) a consultar.',
+      },
+      type: {
+        type: 'string',
+        enum: ['purchases', 'sales', 'both'],
+        description: 'Tipo de facturas. Default: both.',
+      },
+      start_date: {
+        type: 'string',
+        description: 'Fecha inicio YYYY-MM-DD (filtra por postingDate). Opcional.',
+      },
+      end_date: {
+        type: 'string',
+        description: 'Fecha fin YYYY-MM-DD (filtra por postingDate). Opcional.',
+      },
+      include_in_review: {
+        type: 'boolean',
+        description: "Incluir status 'In Review' además de 'Draft'. Default: true.",
+      },
+      summary_only: {
+        type: 'boolean',
+        description: 'Solo totales, sin lista de facturas. Default: false.',
+      },
+    },
+    required: ['store'],
+  },
+};
+
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+
+function buildStatusFilter(includeInReview) {
+  return includeInReview
+    ? "(status eq 'Draft' or status eq 'In Review')"
+    : "status eq 'Draft'";
+}
+
+function buildFilter(args) {
+  const parts = [buildStatusFilter(args.include_in_review !== false)];
+  if (args.start_date) {
+    if (!DATE_RE.test(args.start_date)) throw new Error(`start_date inválida: ${args.start_date}`);
+    parts.push(`postingDate ge ${args.start_date}`);
+  }
+  if (args.end_date) {
+    if (!DATE_RE.test(args.end_date)) throw new Error(`end_date inválida: ${args.end_date}`);
+    parts.push(`postingDate le ${args.end_date}`);
+  }
+  return parts.join(' and ');
+}
+
+function mapInvoice(inv, kind) {
+  return {
+    number: inv.number,
+    status: inv.status,
+    counterparty_number: kind === 'purchases' ? inv.vendorNumber : inv.customerNumber,
+    counterparty_name: kind === 'purchases' ? inv.vendorName : inv.customerName,
+    invoice_date: inv.invoiceDate,
+    posting_date: inv.postingDate,
+    currency: inv.currencyCode || 'LCY',
+    total_excl_tax: round2(inv.totalAmountExcludingTax ?? 0),
+    total_incl_tax: round2(inv.totalAmountIncludingTax ?? 0),
+  };
+}
+
+function summarize(invoices, kind) {
+  const by_currency = {};
+  const non_ic_by_currency = {};
+  const ic = { count: 0, by_currency: {} };
+  for (const inv of invoices) {
+    by_currency[inv.currency] = round2((by_currency[inv.currency] || 0) + inv.total_excl_tax);
+    const isIC = kind === 'sales' && String(inv.counterparty_number || '').toUpperCase().startsWith('IC-');
+    if (isIC) {
+      ic.count += 1;
+      ic.by_currency[inv.currency] = round2((ic.by_currency[inv.currency] || 0) + inv.total_excl_tax);
+    } else if (kind === 'sales') {
+      non_ic_by_currency[inv.currency] = round2((non_ic_by_currency[inv.currency] || 0) + inv.total_excl_tax);
+    }
+  }
+  const summary = {
+    count: invoices.length,
+    by_currency,
+    mixed_currency: Object.keys(by_currency).length > 1,
+    by_status: invoices.reduce((acc, i) => { acc[i.status] = (acc[i.status] || 0) + 1; return acc; }, {}),
+  };
+  if (kind === 'sales') {
+    summary.intercompany = ic;
+    summary.non_ic_by_currency = non_ic_by_currency;
+  }
+  return summary;
+}
+
+function fmtByCurrency(byCurrency) {
+  const parts = Object.entries(byCurrency).map(([cur, amt]) => {
+    const n = amt.toLocaleString('en-US', { minimumFractionDigits: 2 });
+    return cur === 'VES' ? `Bs ${n}` : `$${n}${cur === 'LCY' ? '' : ` ${cur}`}`;
+  });
+  return parts.join(' + ') || '0';
+}
+
+function mergeByCurrency(target, source) {
+  for (const [cur, amt] of Object.entries(source || {})) {
+    target[cur] = round2((target[cur] || 0) + amt);
+  }
+}
+
+async function fetchKind(bcClient, companyId, kind, filter) {
+  const endpoint = kind === 'purchases' ? 'purchaseInvoices' : 'salesInvoices';
+  const select = kind === 'purchases'
+    ? 'number,status,vendorNumber,vendorName,invoiceDate,postingDate,currencyCode,totalAmountExcludingTax,totalAmountIncludingTax'
+    : 'number,status,customerNumber,customerName,invoiceDate,postingDate,currencyCode,totalAmountExcludingTax,totalAmountIncludingTax';
+  const url = bcClient.buildApiUrl(companyId, endpoint, {
+    $filter: filter,
+    $select: select,
+    $orderby: 'postingDate desc',
+  });
+  const rows = await bcClient.apiCallAllPages(url);
+  return rows.map((r) => mapInvoice(r, kind));
+}
+
+async function processStore(bcClient, store, args, filter) {
+  const type = args.type || 'both';
+  const wantP = type === 'purchases' || type === 'both';
+  const wantS = type === 'sales' || type === 'both';
+
+  const [purchases, sales] = await Promise.all([
+    wantP ? fetchKind(bcClient, store.companyId, 'purchases', filter) : Promise.resolve(null),
+    wantS ? fetchKind(bcClient, store.companyId, 'sales', filter) : Promise.resolve(null),
+  ]);
+
+  const result = { store: store.code, store_name: store.name };
+  if (purchases) {
+    result.purchases = { summary: summarize(purchases, 'purchases') };
+    if (!args.summary_only) result.purchases.invoices = purchases;
+  }
+  if (sales) {
+    result.sales = { summary: summarize(sales, 'sales') };
+    if (!args.summary_only) result.sales.invoices = sales;
+  }
+  // Hint directo para el Cierre Parcial (skill-fq-resultados-mensual):
+  result.pl_adjustment_hint = {
+    purchases_by_currency: purchases ? result.purchases.summary.by_currency : null,
+    sales_non_ic_by_currency: sales ? result.sales.summary.non_ic_by_currency : null,
+    note: 'Estimación sin IVA de documentos no posteados en el rango. Montos VES convertir a USD con get_exchange_rate (BCV). No sustituye el posteo.',
+  };
+  return result;
+}
+
+export async function handleUnpostedInvoices(bcClient, args) {
+  if (!args.store) throw new Error('Parámetro requerido: store');
+  const filter = buildFilter(args);
+  const stores = resolveStores(args.store === 'all' ? null : [args.store]);
+
+  logger.info(`get_unposted_invoices: stores=${stores.map((s) => s.code).join(',')} filter="${filter}"`);
+
+  const storeResults = await Promise.all(
+    stores.map((s) => processStore(bcClient, s, args, filter))
+  );
+
+  const storesObj = {};
+  const consolidated = {
+    purchases_by_currency: {},
+    sales_by_currency: {},
+    sales_non_ic_by_currency: {},
+    invoice_count: 0,
+  };
+  const insights = [];
+
+  for (const r of storeResults) {
+    storesObj[r.store] = r;
+    if (r.purchases) {
+      mergeByCurrency(consolidated.purchases_by_currency, r.purchases.summary.by_currency);
+      consolidated.invoice_count += r.purchases.summary.count;
+      if (r.purchases.summary.count > 0) {
+        insights.push(`${r.store}: ${r.purchases.summary.count} factura(s) de compra sin postear por ${fmtByCurrency(r.purchases.summary.by_currency)} (sin IVA)`);
+      }
+    }
+    if (r.sales) {
+      mergeByCurrency(consolidated.sales_by_currency, r.sales.summary.by_currency);
+      mergeByCurrency(consolidated.sales_non_ic_by_currency, r.sales.summary.non_ic_by_currency);
+      consolidated.invoice_count += r.sales.summary.count;
+      if (r.sales.summary.count > 0) {
+        insights.push(`${r.store}: ${r.sales.summary.count} factura(s) de venta sin postear por ${fmtByCurrency(r.sales.summary.by_currency)} (sin IVA${r.sales.summary.intercompany.count ? `, ${r.sales.summary.intercompany.count} IC` : ''})`);
+      }
+    }
+  }
+
+  if (insights.length === 0) insights.push('Sin facturas pendientes de postear en el rango consultado.');
+
+  return {
+    filter_applied: filter,
+    period: { start: args.start_date || null, end: args.end_date || null },
+    stores: storesObj,
+    consolidated,
+    insights,
+  };
+}