@fullqueso/mcp-bc-gastos 1.23.0 → 1.24.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # CHANGELOG
 
+## [1.24.0] — 2026-06-05
+
+### Changed
+- **`get_cash_flow` — working capital 100% desde net-change G/L (7 líneas) + D&A/EBITDA.** Se unificó todo el capital de trabajo sobre el Chart of Accounts real de BC, con la regla universal de impacto en caja `delta = −Σ(debit − credit)` (vale para activos: sube = uso, y pasivos: sube = fuente). Antes ΔAR/ΔAP venían del customer/vendor ledger y ΔInventario del item ledger (fuentes mezcladas); ahora las 7 líneas salen del balance general, misma base USD que el EBIT.
+  - **7 líneas de WC** (orden del bridge): ΔAR `15100–15199 + 15900–15998` · Δ Impuestos (activo) `15200–15299` · Δ Prepagados `16000–16999` · Δ Inventario `14000–14999` · ΔAP `22000–22999` · **Δ Impuestos por pagar `23000–23999`** (nueva) · **Δ Pasivos laborales `24000–25999`** (nueva). `net_wc_change` = suma de las 7.
+  - **CapEx** afinado a PP&E `11110–11190 + 12110–12240` (excluye `12900` depreciación). Implementado con **2 umbrella queries** (activos `11110–16999`, pasivos `22000–25999`) bucketizadas en código por rango de cuenta — `12900` se trae pero no matchea bucket → se descarta; `17xxx`/`18xxx` quedan fuera de rango. Reemplaza 6 consultas (3 G/L + 3 subledger) por 2.
+  - **D&A / EBITDA**: `get_financial_statements` ahora calcula D&A = `Σ(debit−credit)` en `58000–58999` (COGS) + `80000–89999` (OpEx) — filtrando las entries que ya trae (sin query nueva) — y expone `depreciation_amortization` + `ebitda` (`{amount, pct}`). EBIT no cambia; EBITDA = EBIT + D&A. `get_cash_flow` los hereda. Insight automático cuando D&A = 0 ("verificar si se registra depreciación en BC, cuentas 58100-58300 / 81000-82000"). Hoy D&A ≈ 0 → EBIT ≈ EBITDA.
+  - `fcf_bridge` pasa a **13 filas** (7 líneas WC). HTML: tarjeta de Capital de Trabajo con las 7 líneas; KPIs EBITDA + D&A; CapEx etiquetado `PP&E 11110-12240`; fila D&A + EBITDA en el P&L de `get_financial_statements`; fila EBITDA en el comparativo multi-tienda.
+  - **Verificado contra BC real (FQ88, mayo 2026):** CapEx ANTES `$8,760.92` (cuentas 151xx/152xx) → `$0.00` (sin movimientos PP&E). Cross-check G/L vs subledger casi idéntico (ΔInventario 8,643.73 → 8,644.31; ΔAP 10,559.77 → 10,594.77). Nuevas líneas: Δ Imp. por pagar `+$6,052.21`, Δ Pasivos laborales `+$1,294.00`. Bridge cuadra: NOPAT `$12,340.71` + ΔWC `$17,824.37` − CapEx `$0` = FCF `$30,165.08`. EBIT/EBITDA `$18,698.05` (D&A 0).
+
+### Pendiente (Fase 2)
+- **Efecto cambiario sobre caja VES** — línea reconciliadora bajo el FCF (`FCF + Efecto cambiario = Δ Caja real USD`) para reflejar la erosión en USD del saldo en bolívares por la devaluación diaria (~0.75–1%). Se estimará desde el saldo VES de las cuentas 18xxx-VES × tasas. No incluido en esta versión.
+
+---
+
+## [1.23.1] — 2026-06-05
+
+### Fixed
+- **`get_cash_flow` — CapEx y Working Capital alineados al Chart of Accounts real de BC.** El CapEx sumaba el rango `15000–17999`, que en el CoA real son **activos corrientes** (cuentas por cobrar 151xx, impuestos corrientes 152xx, prepagados 16xxx, inversiones corto plazo 17xxx), **no** activos fijos. Esto inflaba CapEx y distorsionaba el FCF.
+  - **CapEx ahora = net change en PP&E `11110–12899`** (intangibles 11110–11190 + tangibles 12110–12240), **excluye `12900`** (depreciación acumulada), `17000–17999` (inversiones corto plazo) y `18000–18999` (caja/bancos).
+  - **Nueva línea WC `Δ Impuestos corrientes`** (`15210–15280`: IVA crédito fiscal, retenciones IVA/ISLR, anticipos/excedente ISLR) = `−Σ(debit−credit)`.
+  - **Nueva línea WC `Δ Prepagados`** (`16110–16900`: anticipos a proveedores, alquileres/otros prepagados) = `−Σ(debit−credit)`.
+  - `net_wc_change = ΔAR + ΔAP + ΔInv + ΔImpuestos + ΔPrepagados`. ΔAR (subledger, equivale a 151xx) y ΔInventario (`itemLedgerEntries`, equivale a 14xxx) sin cambios — no se duplican vía G/L.
+  - `fcf_bridge` agrega filas `Δ Impuestos` y `Δ Prepagados` (11 ítems). Insight de "CapEx detectado" solo aparece si hay net change real en `11110–12899`; el insight de mayor uso de caja ahora reporta cualquier driver dominante (no solo inventario).
+  - HTML: tarjeta de Capital de Trabajo muestra las dos líneas nuevas; KPI CapEx etiquetado `PP&E 11110-12899`.
+  - **Verificado contra BC real (FQ88, mayo 2026):** CapEx ANTES `$8,760.92` (cuentas 151xx/152xx) → DESPUÉS `$0` (sin movimientos PP&E). Bridge cuadra: NOPAT `$12,340.71` + ΔWC `$10,794.99` − CapEx `$0` = FCF `$23,135.70`. Cuentas 15110/15135/15210 ya no aparecen en CapEx.
+
+---
+
 ## [1.23.0] — 2026-05-31
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullqueso/mcp-bc-gastos",
-  "version": "1.23.0",
+  "version": "1.24.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/tools/financials/aggregator.js

@@ -289,10 +289,21 @@ export function calcScore(ratios) {
 // generateInsights — array ordenado por severidad (critical → warning → success)
 // ─────────────────────────────────────────────────────────────────────────────
 
-export function generateInsights(categories, ratios) {
+export function generateInsights(categories, ratios, da = null) {
   const insights = [];
   const sevOrder = { critical: 0, warning: 1, success: 2 };
 
+  // D&A en cero — la depreciación periódica no se está contabilizando en BC
+  // (por eso EBIT ≈ EBITDA). Avisar para que se verifique el registro.
+  if (da === 0) {
+    insights.push({
+      type: 'warning',
+      category: 'depreciation',
+      message: 'D&A en cero — verificar si se registra depreciación en BC (cuentas 58100-58300 y 81000-82000).',
+      action: 'Confirmar con contabilidad si falta contabilizar la depreciación periódica del período.',
+    });
+  }
+
   // Margen operativo
   const op = ratios.operating_margin_pct;
   if (op.status === 'critical') {

package/tools/financials/cash-flow-html.js

@@ -208,9 +208,11 @@ function renderKpis(s) {
   const fcfCls = statusValClass(s.fcf.status);
   return `<div class="kpi-grid cf-kpis">
   ${cell('EBIT', signed(s.ebit.amount), `${s.ebit.pct}%`)}
+  ${cell('D&amp;A', signed(s.da ? s.da.amount : 0), 'dep. 58xxx+8xxxx')}
+  ${cell('EBITDA', signed(s.ebitda ? s.ebitda.amount : s.ebit.amount), `${s.ebitda ? s.ebitda.pct : s.ebit.pct}%`)}
   ${cell('NOPAT', signed(s.nopat.amount), `tax ${signed(-s.tax_estimated.amount)}`)}
   ${cell('CFO', signed(s.cfo.amount), `${s.cfo.pct}%`)}
-  ${cell('CapEx', signed(-s.capex.amount), 'activos fijos')}
+  ${cell('CapEx', signed(-s.capex.amount), 'PP&amp;E 11110-12240')}
   ${cell('FCF', signed(s.fcf.amount), statusWord(s.fcf.status), fcfCls)}
   ${cell('FCF Margin', `${s.fcf.pct}%`, '% ingresos', fcfCls)}
 </div>`;
@@ -236,8 +238,12 @@ function renderWorkingCapital(s) {
   <div class="card-bd">
     <div class="wc">
       ${row('Δ Cobranzas (AR)', wc.delta_ar)}
-      ${row('Δ Proveedores (AP)', wc.delta_ap)}
+      ${row('Δ Impuestos (activo)', wc.delta_taxes || 0)}
+      ${row('Δ Prepagados', wc.delta_prepaid || 0)}
       ${row('Δ Inventario', wc.delta_inventory)}
+      ${row('Δ Proveedores (AP)', wc.delta_ap)}
+      ${row('Δ Impuestos por pagar', wc.delta_taxes_payable || 0)}
+      ${row('Δ Pasivos laborales', wc.delta_labor || 0)}
       <div class="wc-row total">
         <span class="wc-label">Cambio neto WC</span>
         <span class="wc-arrow ${wc.net_wc_change >= 0 ? 'up' : 'down'}">${wc.net_wc_change >= 0 ? '&#x2191;' : '&#x2193;'}</span>
@@ -277,6 +283,7 @@ function renderStoresComparison(result) {
 
   const body = [
     row('EBIT', (c) => signed(c.ebit.amount)),
+    row('EBITDA', (c) => signed(c.ebitda ? c.ebitda.amount : c.ebit.amount)),
     row('NOPAT', (c) => signed(c.nopat.amount)),
     row('CFO', (c) => `<span class="${c.cfo.amount >= 0 ? 'val-green' : 'val-red'}">${signed(c.cfo.amount)}</span>`),
     row('CapEx', (c) => signed(-c.capex.amount)),

package/tools/financials/cash-flow.js

@@ -1,18 +1,31 @@
 // tools/financials/cash-flow.js
 //
 // Tool get_cash_flow — Free Cash Flow (FCF) por método indirecto para tiendas FQ.
-// Reutiliza el bloque P&L/EBIT de get_financial_statements (fetchStoreFinancials) y
-// le agrega impuesto estimado, capital de trabajo (ΔAR/ΔAP/ΔInventario), CapEx,
-// CFO, FCF, bridge tipo waterfall e insights. READ-ONLY.
+// Reutiliza el bloque P&L/EBIT/D&A/EBITDA de get_financial_statements
+// (fetchStoreFinancials) y le agrega impuesto estimado, capital de trabajo (7 líneas),
+// CapEx, CFO, FCF, bridge tipo waterfall e insights. READ-ONLY.
 //
-// CONVENCIÓN DE SIGNOS (impacto en caja; + = fuente de caja, − = uso de caja):
-//   delta_ar        = −Σ amountLocalCurrency(customerLedgerEntries)  → + = cobró más de lo facturado
-//   delta_ap        = −Σ amountLocalCurrency(vendorLedgerEntries)    → + = debe más (fuente)
-//   delta_inventory = −Σ costAmountActual(itemLedgerEntries)         → + = inventario bajó (fuente)
-//   net_wc_change   = delta_ar + delta_ap + delta_inventory
-//   nopat = ebit − tax ;  cfo = nopat + net_wc_change ;  fcf = cfo − capex
-// (Resuelve la inconsistencia del spec entre los comentarios del schema y la fórmula:
-//  se adopta la convención de los comentarios — los 3 deltas ya con signo de caja.)
+// WORKING CAPITAL — las 7 líneas salen de net-change G/L (balance general), misma
+// base USD que el EBIT. REGLA UNIVERSAL de impacto en caja (+ = fuente, − = uso):
+//   delta = −Σ(debit − credit) sobre el rango de cuenta. Vale para activos (sube =
+//   uso) y pasivos (sube = fuente). Rangos (Chart of Accounts real de BC):
+//     delta_ar            = 15100–15199 + 15900–15998   (cuentas por cobrar + otras CxC)
+//     delta_taxes         = 15200–15299                 (impuestos corrientes activo)
+//     delta_prepaid       = 16000–16999                 (anticipos y prepagados)
+//     delta_inventory     = 14000–14999                 (inventarios)
+//     delta_ap            = 22000–22999                 (cuentas por pagar)
+//     delta_taxes_payable = 23000–23999                 (impuestos por pagar)
+//     delta_labor         = 24000–25999                 (pasivos laborales)
+//   net_wc_change = suma de las 7 ; nopat = ebit − tax ; cfo = nopat + net_wc_change ;
+//   fcf = cfo − capex.
+//
+// CAPEX = +Σ(debit − credit) en PP&E 11110–11190 (intangibles) + 12110–12240
+//   (tangibles). EXCLUYE 12900 (depreciación acumulada), 17000–17999 (inversiones
+//   corto plazo) y 18000–18999 (caja y bancos = posición de caja final).
+//
+// D&A / EBITDA: D&A = Σ(debit−credit) en 58000–58999 (COGS) + 80000–89999 (OpEx),
+//   calculada por get_financial_statements. EBITDA = EBIT + D&A (KPI; no es paso del
+//   bridge). Hoy D&A suele ser 0 (no se contabiliza depreciación) → EBIT ≈ EBITDA.
 //
 // Montos en USD (LCY = Additional Reporting Currency), igual que get_financial_statements.
 
@@ -38,8 +51,10 @@ export const cashFlowTool = {
   description:
     'Free Cash Flow (FCF) por método indirecto para una o más tiendas Full Queso (FQ01, FQ28, FQ88). ' +
     'Parte del EBIT (igual que get_financial_statements), resta impuesto estimado (ISLR 34%), ajusta por capital de trabajo ' +
-    '(Δ cuentas por cobrar, Δ cuentas por pagar, Δ inventario) para obtener el flujo de caja operativo (CFO), y resta CapEx ' +
-    '(activos fijos 15000-17999) para el FCF. Incluye NOPAT, margen FCF, status (healthy/positive_low/negative_watch/' +
+    '(7 líneas desde net-change G/L: Δ cuentas por cobrar, Δ impuestos corrientes, Δ prepagados, Δ inventario, Δ cuentas por pagar, ' +
+    'Δ impuestos por pagar, Δ pasivos laborales) para obtener el flujo de caja operativo (CFO), y resta CapEx (PP&E 11110-12240) ' +
+    'para el FCF. Reporta también D&A y EBITDA (EBIT + D&A). Incluye NOPAT, margen FCF, status ' +
+    '(healthy/positive_low/negative_watch/' +
     'negative_critical), bridge tipo waterfall e insights automáticos. Multi-tienda calcula consolidado. Con render_html=true ' +
     'genera un dashboard HTML (lo guarda en ~/Downloads y retorna la ruta). Úsalo cuando el usuario pida flujo de caja, ' +
     'cash flow, FCF, liquidez, "cuánta caja genera", o capital de trabajo. READ-ONLY.',
@@ -202,9 +217,15 @@ async function buildStoreCashFlow(bcClient, store, start, end) {
       cogs: financials.cogs.total,
       gross_margin_amount: financials.gross_margin.amount,
       ebit: financials.operating_income.amount,
+      da: financials.depreciation_amortization.amount,
+      ebitda: financials.ebitda.amount,
       delta_ar: wc.delta_ar,
-      delta_ap: wc.delta_ap,
+      delta_taxes: wc.delta_taxes,
+      delta_prepaid: wc.delta_prepaid,
       delta_inventory: wc.delta_inventory,
+      delta_ap: wc.delta_ap,
+      delta_taxes_payable: wc.delta_taxes_payable,
+      delta_labor: wc.delta_labor,
       capex: wc.capex,
       capex_accounts: wc.capex_accounts,
       warnings: wc.warnings,
@@ -212,70 +233,90 @@ async function buildStoreCashFlow(bcClient, store, start, end) {
   );
 }
 
-// Consultas BC para capital de trabajo (AR/AP/Inventario) + CapEx — todas en paralelo
+// Buckets del balance general (Chart of Accounts real de BC), por rango de cuenta.
+// REGLA UNIVERSAL de impacto en caja: delta = −Σ(debit − credit) sobre el rango.
+//   - Activo que sube (debit) → −Σ < 0 = uso de caja.
+//   - Pasivo que sube (credit) → −Σ > 0 = fuente de caja.
+// CapEx es la excepción: capex = +Σ(debit − credit) sobre PP&E (un débito = inversión).
+// Montos en USD (LCY = Additional Reporting Currency), consistentes con el EBIT.
+const ASSET_BUCKETS = [
+  { key: 'capex',           ranges: [[11110, 11190], [12110, 12240]] }, // PP&E (excluye 12900 deprec.)
+  { key: 'delta_inventory', ranges: [[14000, 14999]] },                 // Inventarios
+  { key: 'delta_ar',        ranges: [[15100, 15199], [15900, 15998]] }, // Cuentas por cobrar + otras CxC
+  { key: 'delta_taxes',     ranges: [[15200, 15299]] },                 // Impuestos corrientes (activo)
+  { key: 'delta_prepaid',   ranges: [[16000, 16999]] },                 // Anticipos y prepagados
+];
+const LIAB_BUCKETS = [
+  { key: 'delta_ap',            ranges: [[22000, 22999]] }, // Cuentas por pagar
+  { key: 'delta_taxes_payable', ranges: [[23000, 23999]] }, // Impuestos por pagar (pasivo)
+  { key: 'delta_labor',         ranges: [[24000, 25999]] }, // Pasivos laborales
+];
+
+function bucketOf(accountNumber, buckets) {
+  const n = parseInt(accountNumber, 10);
+  for (const b of buckets) for (const [lo, hi] of b.ranges) if (n >= lo && n <= hi) return b.key;
+  return null; // 12900 (deprec.), gaps, etc. → fuera de todo bucket = descartado
+}
+
+// Capital de trabajo + CapEx desde 2 umbrella queries G/L (activos + pasivos),
+// bucketizadas en código por rango de cuenta. Reemplaza el enfoque mixto
+// subledger/G/L: ahora TODO el WC sale del balance general (net-change G/L),
+// misma base USD que el EBIT. AR/Inventario/AP ya no usan customer/vendor/item
+// ledger — todo es net change de las cuentas de balance.
 async function fetchWorkingCapitalAndCapex(bcClient, companyId, start, end) {
-  const sd = bcClient._sanitizeOData(start);
-  const ed = bcClient._sanitizeOData(end);
-  const periodFilter = `postingDate ge ${sd} and postingDate le ${ed}`;
-
-  const arUrl = bcClient.buildBetaApiUrl(companyId, 'customerLedgerEntries', {
-    $filter: periodFilter,
-    $select: 'postingDate,documentType,amountLocalCurrency',
-  });
-  const apUrl = bcClient.buildBetaApiUrl(companyId, 'vendorLedgerEntries', {
-    $filter: periodFilter,
-    $select: 'postingDate,documentType,amountLocalCurrency',
-  });
-  const ileUrl = bcClient.buildApiUrl(companyId, 'itemLedgerEntries', {
-    $filter: periodFilter,
-    $select: 'postingDate,entryType,quantity,costAmountActual',
-  });
-
-  const [arEntries, apEntries, ileEntries, capexEntries] = await Promise.all([
-    bcClient.apiCallAllPages(arUrl).catch((e) => { logger.warn(`[cash-flow] AR fetch failed: ${e.message}`); return null; }),
-    bcClient.apiCallAllPages(apUrl).catch((e) => { logger.warn(`[cash-flow] AP fetch failed: ${e.message}`); return null; }),
-    bcClient.apiCallAllPages(ileUrl).catch((e) => { logger.warn(`[cash-flow] ILE fetch failed: ${e.message}`); return null; }),
-    bcClient.getGLEntries(companyId, start, end, '15000', '17999').catch((e) => { logger.warn(`[cash-flow] CapEx fetch failed: ${e.message}`); return null; }),
+  // Umbrella de activos 11110–16999: cubre CapEx (11xxx–12xxx), inventario (14xxx),
+  // AR (151xx/159xx), impuestos activo (152xx) y prepagados (16xxx). 12900 cae dentro
+  // pero no matchea bucket → se descarta. 17xxx (inversiones) y 18xxx (caja) quedan fuera.
+  // Umbrella de pasivos 22000–25999: AP (22xxx), impuestos por pagar (23xxx), laborales (24-25xxx).
+  const [assetEntries, liabEntries] = await Promise.all([
+    bcClient.getGLEntries(companyId, start, end, '11110', '16999').catch((e) => { logger.warn(`[cash-flow] activos G/L fetch failed: ${e.message}`); return null; }),
+    bcClient.getGLEntries(companyId, start, end, '22000', '25999').catch((e) => { logger.warn(`[cash-flow] pasivos G/L fetch failed: ${e.message}`); return null; }),
   ]);
 
   const warnings = [];
+  const raw = { capex: 0, delta_inventory: 0, delta_ar: 0, delta_taxes: 0, delta_prepaid: 0, delta_ap: 0, delta_taxes_payable: 0, delta_labor: 0 };
+  const capex_accounts = {};
 
-  // ΔAR — impacto en caja = −Σ amountLocalCurrency (invoices +, payments −)
-  let delta_ar = 0;
-  if (arEntries == null) warnings.push('Customer ledger no disponible — ΔAR asumido en 0.');
-  else delta_ar = round2(-arEntries.reduce((s, e) => s + (e.amountLocalCurrency || 0), 0));
-
-  // ΔAP — impacto en caja = −Σ amountLocalCurrency (invoices −, payments +)
-  let delta_ap = 0;
-  if (apEntries == null) warnings.push('Vendor ledger no disponible — ΔAP asumido en 0.');
-  else delta_ap = round2(-apEntries.reduce((s, e) => s + (e.amountLocalCurrency || 0), 0));
-
-  // ΔInventario — impacto en caja = −Σ costAmountActual (compras +, ventas −)
-  // costAmountActual ya es el costo total de la entrada (no multiplicar por quantity).
-  let delta_inventory = 0;
-  if (ileEntries == null) warnings.push('Item ledger no disponible — Δinventario asumido en 0.');
-  else {
-    delta_inventory = round2(-ileEntries.reduce((s, e) => s + (e.costAmountActual || 0), 0));
-    if (ileEntries._truncated) warnings.push('Item ledger truncado (muchas entradas) — Δinventario puede estar incompleto.');
+  if (assetEntries == null) {
+    warnings.push('G/L de activos (11110–16999) no disponible — CapEx/ΔAR/ΔImpuestos/ΔPrepagados/ΔInventario asumidos en 0.');
+  } else {
+    for (const e of assetEntries) {
+      const key = bucketOf(e.accountNumber, ASSET_BUCKETS);
+      if (!key) continue;
+      const net = (e.debitAmount || 0) - (e.creditAmount || 0);
+      raw[key] += net;
+      if (key === 'capex') capex_accounts[e.accountNumber] = round2((capex_accounts[e.accountNumber] || 0) + net);
+    }
+    if (assetEntries._truncated) warnings.push('G/L de activos truncado (muchas entradas) — WC de activos puede estar incompleto.');
   }
 
-  // CapEx — débitos netos en activos fijos 15000-17999 (excluye 18xxx bancos)
-  let capex = 0;
-  const capex_accounts = {};
-  if (capexEntries == null) {
-    warnings.push('G/L de activos fijos no disponible — CapEx asumido en 0.');
+  if (liabEntries == null) {
+    warnings.push('G/L de pasivos (22000–25999) no disponible — ΔAP/ΔImpuestos x pagar/ΔPasivos laborales asumidos en 0.');
   } else {
-    for (const e of capexEntries) {
-      const net = (e.debitAmount || 0) - (e.creditAmount || 0);
-      capex += net;
-      capex_accounts[e.accountNumber] = round2((capex_accounts[e.accountNumber] || 0) + net);
+    for (const e of liabEntries) {
+      const key = bucketOf(e.accountNumber, LIAB_BUCKETS);
+      if (!key) continue;
+      raw[key] += (e.debitAmount || 0) - (e.creditAmount || 0);
     }
-    capex = round2(capex);
-    // limpiar cuentas con neto 0
-    for (const k of Object.keys(capex_accounts)) if (capex_accounts[k] === 0) delete capex_accounts[k];
+    if (liabEntries._truncated) warnings.push('G/L de pasivos truncado (muchas entradas) — WC de pasivos puede estar incompleto.');
   }
 
-  return { delta_ar, delta_ap, delta_inventory, capex, capex_accounts, warnings };
+  // Aplicar signos: CapEx = +Σ(debit−credit); cada delta de WC = −Σ(debit−credit).
+  const capex = round2(raw.capex);
+  for (const k of Object.keys(capex_accounts)) if (capex_accounts[k] === 0) delete capex_accounts[k];
+
+  return {
+    delta_ar: round2(-raw.delta_ar),
+    delta_taxes: round2(-raw.delta_taxes),
+    delta_prepaid: round2(-raw.delta_prepaid),
+    delta_inventory: round2(-raw.delta_inventory),
+    delta_ap: round2(-raw.delta_ap),
+    delta_taxes_payable: round2(-raw.delta_taxes_payable),
+    delta_labor: round2(-raw.delta_labor),
+    capex,
+    capex_accounts,
+    warnings,
+  };
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -291,10 +332,22 @@ function assembleCashFlow(meta, c) {
   const tax = ebit > 0 ? round2(ebit * TAX_RATE) : 0;
   const nopat = round2(ebit - tax);
 
+  // D&A / EBITDA — EBIT no cambia (D&A ya está en COGS/OpEx); EBITDA la re-suma.
+  const da = round2(c.da || 0);
+  const ebitda = round2(c.ebitda != null ? c.ebitda : ebit + da);
+  const ebitdaPct = income > 0 ? round2((ebitda / income) * 100) : 0;
+
+  // Working capital — las 7 líneas desde net-change G/L (regla −Σ(debit−credit)).
   const delta_ar = round2(c.delta_ar);
-  const delta_ap = round2(c.delta_ap);
+  const delta_taxes = round2(c.delta_taxes || 0);
+  const delta_prepaid = round2(c.delta_prepaid || 0);
   const delta_inventory = round2(c.delta_inventory);
-  const net_wc_change = round2(delta_ar + delta_ap + delta_inventory);
+  const delta_ap = round2(c.delta_ap);
+  const delta_taxes_payable = round2(c.delta_taxes_payable || 0);
+  const delta_labor = round2(c.delta_labor || 0);
+  const net_wc_change = round2(
+    delta_ar + delta_taxes + delta_prepaid + delta_inventory + delta_ap + delta_taxes_payable + delta_labor
+  );
 
   const cfo = round2(nopat + net_wc_change);
   const cfoPct = income > 0 ? round2((cfo / income) * 100) : 0;
@@ -304,8 +357,9 @@ function assembleCashFlow(meta, c) {
   const fcfPct = income > 0 ? round2((fcf / income) * 100) : 0;
 
   const status = fcfStatus(fcf, fcfPct, ebit);
-  const bridge = buildBridge({ ebit, tax, nopat, delta_ar, delta_ap, delta_inventory, cfo, capex, fcf });
-  const insights = buildInsights({ ebit, delta_ar, delta_ap, delta_inventory, capex, fcf, fcfPct, status, warnings: c.warnings || [] });
+  const wc = { delta_ar, delta_taxes, delta_prepaid, delta_inventory, delta_ap, delta_taxes_payable, delta_labor };
+  const bridge = buildBridge({ ebit, tax, nopat, ...wc, cfo, capex, fcf });
+  const insights = buildInsights({ ebit, ...wc, da, capex, fcf, fcfPct, status, warnings: c.warnings || [] });
 
   return {
     store_code: meta.store_code,
@@ -314,9 +368,11 @@ function assembleCashFlow(meta, c) {
     cogs: { total: round2(c.cogs) },
     gross_margin: { amount: round2(c.gross_margin_amount), pct: gmPct },
     ebit: { amount: ebit, pct: ebitPct },
+    da: { amount: da },
+    ebitda: { amount: ebitda, pct: ebitdaPct },
     tax_estimated: { amount: tax, rate: TAX_RATE, note: 'Estimado ISLR 34%' },
     nopat: { amount: nopat },
-    working_capital: { delta_ar, delta_ap, delta_inventory, net_wc_change },
+    working_capital: { ...wc, net_wc_change },
     cfo: { amount: cfo, pct: cfoPct },
     capex: { amount: capex, accounts: c.capex_accounts || {} },
     fcf: { amount: fcf, pct: fcfPct, status },
@@ -331,32 +387,40 @@ function fcfStatus(fcf, fcfPct, ebit) {
   return fcf > ebit * -0.2 ? 'negative_watch' : 'negative_critical';
 }
 
-function buildBridge({ ebit, tax, nopat, delta_ar, delta_ap, delta_inventory, cfo, capex, fcf }) {
+function buildBridge({ ebit, tax, nopat, delta_ar, delta_taxes, delta_prepaid, delta_inventory, delta_ap, delta_taxes_payable, delta_labor, cfo, capex, fcf }) {
   const flow = (label, amount) => ({ label, amount: round2(amount), type: amount >= 0 ? 'source' : 'use' });
   return [
     { label: 'EBIT', amount: ebit, type: 'source' },
     { label: 'Impuesto est.', amount: round2(-tax), type: 'use' },
     { label: 'NOPAT', amount: nopat, type: 'subtotal' },
     flow('Δ Cob. (AR)', delta_ar),
-    flow('Δ Prov. (AP)', delta_ap),
+    flow('Δ Impuestos (activo)', delta_taxes),
+    flow('Δ Prepagados', delta_prepaid),
     flow('Δ Inventario', delta_inventory),
+    flow('Δ Prov. (AP)', delta_ap),
+    flow('Δ Imp. x pagar', delta_taxes_payable),
+    flow('Δ Pasivos laborales', delta_labor),
     { label: 'CFO', amount: cfo, type: 'subtotal' },
     { label: 'CapEx', amount: round2(-capex), type: 'use' },
     { label: 'FCF', amount: fcf, type: 'total' },
   ];
 }
 
-function buildInsights({ ebit, delta_ar, delta_ap, delta_inventory, capex, fcf, fcfPct, status, warnings }) {
+function buildInsights({ ebit, delta_ar, delta_taxes, delta_prepaid, delta_inventory, delta_ap, delta_taxes_payable, delta_labor, da, capex, fcf, fcfPct, status, warnings }) {
   const insights = [];
 
-  // Mayor driver negativo entre los usos de capital de trabajo
+  // Mayor driver negativo entre los usos de capital de trabajo (7 líneas)
   const uses = [
     { key: 'delta_inventory', label: 'Inventario', val: delta_inventory },
     { key: 'delta_ar', label: 'Cobranza (AR)', val: delta_ar },
     { key: 'delta_ap', label: 'Pagos a proveedores (AP)', val: delta_ap },
+    { key: 'delta_taxes', label: 'Impuestos corrientes', val: delta_taxes },
+    { key: 'delta_prepaid', label: 'Prepagados', val: delta_prepaid },
+    { key: 'delta_taxes_payable', label: 'Impuestos por pagar', val: delta_taxes_payable },
+    { key: 'delta_labor', label: 'Pasivos laborales', val: delta_labor },
   ].filter((u) => u.val < 0).sort((a, b) => a.val - b.val);
-  if (uses.length && uses[0].key === 'delta_inventory') {
-    insights.push(`Inventario es el mayor uso de caja del período ($${fmtAbs(delta_inventory)}).`);
+  if (uses.length) {
+    insights.push(`${uses[0].label} es el mayor uso de caja del período ($${fmtAbs(uses[0].val)}).`);
   }
 
   // AR consume >20% del EBIT (cobranza lenta)
@@ -364,9 +428,16 @@ function buildInsights({ ebit, delta_ar, delta_ap, delta_inventory, capex, fcf,
     insights.push(`Cobranza lenta presiona caja: ΔAR −$${fmtAbs(delta_ar)} (>20% del EBIT).`);
   }
 
-  // CapEx detectado
+  // D&A en cero — depreciación posiblemente no contabilizada en BC
+  if (da === 0) {
+    insights.push('D&A en cero — verificar si se registra depreciación en BC (cuentas 58100-58300 y 81000-82000).');
+  }
+
+  // CapEx — solo si hay net change real en PP&E (11110–12240)
   if (capex > 0) {
-    insights.push(`CapEx $${fmtAbs(capex)} en activos fijos detectado.`);
+    insights.push(`CapEx $${fmtAbs(capex)} en PP&E (activos fijos 11110–12240) detectado.`);
+  } else if (capex < 0) {
+    insights.push(`Desinversión neta en PP&E $${fmtAbs(capex)} (fuente de caja).`);
   }
 
   // Margen FCF bajo
@@ -412,9 +483,15 @@ function consolidateCashFlow(storeObjs) {
       cogs: sum((o) => o.cogs.total),
       gross_margin_amount: sum((o) => o.gross_margin.amount),
       ebit: sum((o) => o.ebit.amount),
+      da: sum((o) => (o.da ? o.da.amount : 0)),
+      ebitda: sum((o) => (o.ebitda ? o.ebitda.amount : 0)),
       delta_ar: sum((o) => o.working_capital.delta_ar),
-      delta_ap: sum((o) => o.working_capital.delta_ap),
+      delta_taxes: sum((o) => o.working_capital.delta_taxes || 0),
+      delta_prepaid: sum((o) => o.working_capital.delta_prepaid || 0),
       delta_inventory: sum((o) => o.working_capital.delta_inventory),
+      delta_ap: sum((o) => o.working_capital.delta_ap),
+      delta_taxes_payable: sum((o) => o.working_capital.delta_taxes_payable || 0),
+      delta_labor: sum((o) => o.working_capital.delta_labor || 0),
       capex: sum((o) => o.capex.amount),
       capex_accounts,
       warnings: allWarnings,

package/tools/financials/html-template.js

@@ -222,7 +222,9 @@ function renderPnlCard(s) {
       ${expenseRows}
       <div class="pnl-row total"><span class="pnl-label">(&minus;) Total Gastos Operativos</span><span class="pnl-amt">$${fmt(s.expenses.total)}</span></div>
 
-      <div class="pnl-row operating"><span class="pnl-label">= Utilidad Operativa <span class="pnl-pct ${valClass(s.ratios.operating_margin_pct.status)}">${s.operating_income.pct}%</span></span><span class="pnl-amt ${valClass(s.ratios.operating_margin_pct.status)}">$${fmt(s.operating_income.amount)}</span></div>
+      <div class="pnl-row operating"><span class="pnl-label">= Utilidad Operativa (EBIT) <span class="pnl-pct ${valClass(s.ratios.operating_margin_pct.status)}">${s.operating_income.pct}%</span></span><span class="pnl-amt ${valClass(s.ratios.operating_margin_pct.status)}">$${fmt(s.operating_income.amount)}</span></div>
+      ${s.ebitda ? `<div class="pnl-row sub"><span class="pnl-label">(+) Depreciación y Amortización</span><span class="pnl-amt">$${fmt(s.depreciation_amortization.amount)}</span></div>
+      <div class="pnl-row gross"><span class="pnl-label">= EBITDA <span class="pnl-pct">${s.ebitda.pct}%</span></span><span class="pnl-amt">$${fmt(s.ebitda.amount)}</span></div>` : ''}
     </div>
   </div>
 </div>`;

package/tools/financials/statements.js

@@ -39,9 +39,16 @@ function buildStoreFinancials(storeCode, storeName, incomeEntries, cogsEntries,
   const opAmount = round2(gmAmount - expenses.total);
   const opPct = income.total > 0 ? round2((opAmount / income.total) * 100) : 0;
 
+  // D&A — depreciación/amortización ya contenida en COGS (58000-58999) y OpEx
+  // (80000-89999). Se calcula filtrando las entries ya traídas (sin query nueva).
+  // EBIT NO cambia (D&A ya está restada); EBITDA = EBIT + D&A la re-suma.
+  const da = computeDepreciation(cogsEntries, expenseEntries);
+  const ebitdaAmount = round2(opAmount + da);
+  const ebitdaPct = income.total > 0 ? round2((ebitdaAmount / income.total) * 100) : 0;
+
   const ratios = calcRatios(income, cogs, expenses);
   const score = calcScore(ratios);
-  const insights = generateInsights(expenses.categories, ratios);
+  const insights = generateInsights(expenses.categories, ratios, da);
 
   return {
     store_code: storeCode,
@@ -51,12 +58,24 @@ function buildStoreFinancials(storeCode, storeName, incomeEntries, cogsEntries,
     gross_margin: { amount: gmAmount, pct: gmPct },
     expenses,
     operating_income: { amount: opAmount, pct: opPct },
+    depreciation_amortization: { amount: da },
+    ebitda: { amount: ebitdaAmount, pct: ebitdaPct },
     ratios,
     insights,
     score,
   };
 }
 
+// D&A = Σ(debit − credit) sobre 58000-58999 (en COGS) + 80000-89999 (en OpEx).
+// Mismas entries del P&L — no requiere consulta adicional a BC.
+function computeDepreciation(cogsEntries, expenseEntries) {
+  const inRange = (acct, lo, hi) => { const n = parseInt(acct, 10); return n >= lo && n <= hi; };
+  let da = 0;
+  for (const e of cogsEntries) if (inRange(e.accountNumber, 58000, 58999)) da += (e.debitAmount || 0) - (e.creditAmount || 0);
+  for (const e of expenseEntries) if (inRange(e.accountNumber, 80000, 89999)) da += (e.debitAmount || 0) - (e.creditAmount || 0);
+  return round2(da);
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // fetchStoreFinancials — 3 queries BC en paralelo para una tienda
 // Devuelve { financials, raw } (raw se usa para consolidar sin re-consultar BC)