@fullqueso/mcp-bc-gastos 1.26.0 → 1.28.0

package/.env.example

@@ -13,6 +13,7 @@ BC_ENVIRONMENT=production
 BC_COMPANY_FQ01=guid-for-store-fq01
 BC_COMPANY_FQ28=guid-for-store-fq28
 BC_COMPANY_FQ88=guid-for-store-fq88
+BC_COMPANY_FQFR=guid-for-franquicias
 
 # Optional
 LOG_LEVEL=info

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # CHANGELOG
 
+## [1.28.0] — 2026-06-12
+
+### Added
+- **Cuarta compañía: `FQFR` — Full Queso Franquicias, C.A.** El MCP solo exponía FQ01/FQ28/FQ88; ahora la compañía de Franquicias está disponible en todas las herramientas.
+  - **Datos BC** (descubiertos del endpoint `/companies`): `companyId` (GUID) = `30e63c27-6336-f011-9a4a-000d3afe29c3`; `name` OData V4 = `Full Queso Franquicias` (→ `companyName: 'Full%20Queso%20Franquicias'`).
+  - Nueva entrada `FQFR` en `config/company-config.js` (`getStores()`) y agregada a `ALL_STORE_CODES` → `"all"` ahora incluye Franquicias en consolidados/comparativas.
+  - Nueva env var **`BC_COMPANY_FQFR`** (opcional, como FQ28/FQ88) en `.env`, `.env.example` y README. La validación de `server.js` no cambia (solo FQ01 es obligatoria).
+  - **52 herramientas** tenían el `enum` de tiendas hardcodeado (`['FQ01','FQ28','FQ88'(,'all')]`) — esto rechazaba `FQFR` en la validación del schema MCP. Se agregó `'FQFR'` a los 52 enums (39 sin `'all'`, 13 con `'all'`).
+  - **Verificado contra BC real:** token OK; API v2.0 (GUID) → 200; OData V4 (nombre) → 200; `getGLEntries` ingresos 2025 de FQFR → 116 asientos; `resolveStores(['all'])` → `FQ01,FQ28,FQ88,FQFR`. `node --check` OK en todos los .js.
+
+### Nota operativa
+- **Reiniciar Claude Desktop** tras el publish para que los tools recarguen con FQFR (G-002).
+
+---
+
+## [1.27.0] — 2026-06-05
+
+### Changed
+- **`get_cash_flow` — efecto cambiario revaluado contra el SALDO REAL del banco + asiento sugerido (corrige v1.26.0).** FP detectó que el saldo VES del GL está inflado por **backlog de conciliación** (transacciones que el banco ya procesó pero BC no postea). Ej FQ88: GL cuenta 18250 = 12.44M VES vs saldo real del banco = 1.19M VES. Por eso el `fx_adjustment` de v1.26.0 (sobre GL, −$2,290) **sobrestimaba** la pérdida real. Ahora se revalúa el **saldo real** (`BankAccReconciliation.StatementEndingBalance`, en VES) y se aísla el backlog.
+  - **Matemática robusta:** por cuenta, `implied_rate = gl_ves/gl_usd` (tasa promedio histórica), `fx_real = stmt_ves × (1/rate_close − 1/implied_rate)` — escala por el saldo **real**, no el GL inflado. `recon_gap = gl_ves − stmt_ves` se reporta aparte (backlog a postear, NO es FX).
+  - **3 buckets de cuentas VES:** (1) banco real con statement → entra al total y al **asiento sugerido**; (2) banco sin statement → provisional, flag, fuera del total; (3) ajuste/tránsito (lista explícita en config: 18275, 18297) → solo informativo. Flag de tasa implícita atípica.
+  - **Asiento sugerido de diferencial cambiario** (READ-ONLY texto, cuadra DR=CR): débito Diferencial Cambiario / crédito cada banco VES por su `fx_real`. Es la hoja de trabajo del cierre.
+  - Nuevo módulo compartido `tools/financials/fx-cash.js` (computeCashPosition, buildFxJournal, consolidateCashPositions) — reutilizable por get_cash_flow y, a futuro, por el paso de cierre-mensual (Fase 3B). Nuevo `bcClient.getBankStatementBalances` (OData V4 `BankAccReconciliation`, elige la statement ≤ fin de período). Completado el mapeo banco→GL de FQ88 en `config/bank-gl-map.json` (desde fq-239-audit) + lista `adjustment_accounts_ves`.
+  - El bloque `cash_position` cambia de forma: `bank_accounts`/`pending_no_statement`/`informational` + `totals` (solo bucket 1) + `fx_journal` + `gl_basis` (referencia v1.26.0). Insight separa "brecha de conciliación" de "efecto cambiario sobre caja real". **El FCF sigue intacto** (el FX es memo de balance).
+  - **Verificado contra BC real (FQ88, mayo 2026):** GL libro $34,880 / FX sobre GL −$2,290 (v1.26.0, sobrestimado) → **caja real $5,884 / FX real −$500.89** (correcto); brecha de conciliación 14.36M VES (~$25,897, backlog). Asiento cuadra ($500.89). FCF intacto.
+
+### Pendiente (Fase 3B)
+- `generate_fx_revaluation` en cierre-mensual: emitir el asiento de diferencial cambiario integrado al journal de cierre (reusa el módulo `fx-cash.js`).
+
+---
+
 ## [1.26.0] — 2026-06-05
 
 ### Added

package/README.md

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

package/config/bank-gl-map.json

@@ -41,18 +41,18 @@
     },
     "FQ88": {
       "store_name": "FQ88 - La Candelaria",
-      "_nota": "GL accounts pendientes de confirmar con CoA de FQ88",
+      "_nota": "GL confirmados 2026-06-05 desde fq-239-audit/data/fq_bancos_all.json (consolidacion_por_banco).",
       "accounts": {
-        "MN0001": { "gl": null, "name": "Bancamiga 0240 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0002": { "gl": null, "name": "Bancamiga 9379 Bs. *", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0003": { "gl": null, "name": "BDV 9127 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0004": { "gl": null, "name": "BDV 7191 Bs. *", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0005": { "gl": null, "name": "Bancrecer 2558 Bs.", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0007": { "gl": null, "name": "BDV Pago Movil 5145", "currency": "VES", "category": "bancos_nacionales" },
-        "MN0028": { "gl": null, "name": "Ubii Bank", "currency": "VES", "category": "bancos_nacionales" },
+        "MN0001": { "gl": "18210", "name": "Bancamiga 0240 Bs.", "currency": "VES", "category": "bancos_nacionales" },
+        "MN0002": { "gl": "18220", "name": "Bancamiga 9379 Bs. *", "currency": "VES", "category": "bancos_nacionales" },
+        "MN0003": { "gl": "18230", "name": "BDV 9127 Bs.", "currency": "VES", "category": "bancos_nacionales" },
+        "MN0004": { "gl": "18240", "name": "BDV 7191 Bs. *", "currency": "VES", "category": "bancos_nacionales" },
+        "MN0005": { "gl": "18250", "name": "Bancrecer 2558 Bs.", "currency": "VES", "category": "bancos_nacionales" },
+        "MN0007": { "gl": "18270", "name": "BDV Pago Movil 5145", "currency": "VES", "category": "bancos_nacionales" },
+        "MN0028": { "gl": "18290", "name": "Ubii Bank", "currency": "VES", "category": "bancos_nacionales" },
         "MN0030": { "gl": "18130", "name": "Caja tienda ventas Bs.", "currency": "VES", "category": "caja" },
         "ME0030": { "gl": "18140", "name": "Caja tienda ventas $", "currency": "USD", "category": "caja" },
-        "ME0005": { "gl": null, "name": "Zelle USD", "currency": "USD", "category": "bancos_extranjeros" }
+        "ME0005": { "gl": "18410", "name": "Zelle USD", "currency": "USD", "category": "bancos_extranjeros" }
       }
     }
   },
@@ -89,5 +89,7 @@
     "18499": "Total Bancos Extranjeros Divisas",
     "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"]
 }

package/config/company-config.js

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

package/lib/bc-client.js

@@ -329,6 +329,38 @@ export class BCClient {
     return this.apiCallAllPages(url, maxPages);
   }
 
+  // Saldos REALES de banco (statement) por cuenta, vía BankAccReconciliation (OData V4).
+  // Por cada BankAccountNo elige la statement más reciente con StatementDate ≤ asOfDate
+  // (los bancos tienen varias statements semanales + cierre de mes). Devuelve un mapa
+  // { 'FQ88-MN0005': { ending: 1190029.52, statementDate, statementNo, stale } }.
+  async getBankStatementBalances(storeCode, asOfDate) {
+    const url = this.buildODataUrl(storeCode, 'BankAccReconciliation', {
+      $select: 'BankAccountNo,StatementNo,StatementDate,StatementEndingBalance',
+    });
+    const rows = await this.odataCallAllPages(url);
+    const list = rows.value || rows || [];
+    const ad = String(asOfDate);
+    const byAcct = {};
+    for (const r of list) {
+      const acct = r.BankAccountNo;
+      if (!acct) continue;
+      const date = r.StatementDate ? String(r.StatementDate) : '';
+      // Preferir statements ≤ asOfDate (la más reciente). Si no hay, usar la más antigua futura (stale).
+      const cur = byAcct[acct];
+      const within = date && date <= ad;
+      if (!cur) {
+        byAcct[acct] = { ending: r.StatementEndingBalance || 0, statementDate: date, statementNo: r.StatementNo, stale: !within };
+      } else if (within) {
+        // entre las ≤ asOfDate, quedarse con la fecha mayor
+        if (cur.stale || date > cur.statementDate) byAcct[acct] = { ending: r.StatementEndingBalance || 0, statementDate: date, statementNo: r.StatementNo, stale: false };
+      } else if (cur.stale && date < cur.statementDate) {
+        // todas futuras: quedarse con la más cercana (menor fecha futura)
+        byAcct[acct] = { ending: r.StatementEndingBalance || 0, statementDate: date, statementNo: r.StatementNo, stale: true };
+      }
+    }
+    return byAcct;
+  }
+
   // Fetch revenue entries (40000-49999) - credit balance = income
   async getRevenueEntries(companyId, startDate, endDate) {
     return this.getGLEntries(companyId, startDate, endDate, '40000', '49999');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullqueso/mcp-bc-gastos",
-  "version": "1.26.0",
+  "version": "1.28.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/account-transactions.js

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

package/tools/anomaly-detection.js

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

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

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

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

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

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

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

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

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

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

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

package/tools/auditoria/pm-receipts.js

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

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

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

package/tools/auditoria/reconciliation-status.js

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/tools/cobranzas/collection-status.js

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

package/tools/cobranzas/customer-balances.js

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

package/tools/cobranzas/customer-ledger.js

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

package/tools/cobranzas/customer-list.js

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

package/tools/cobranzas/open-payables.js

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

package/tools/cobranzas/open-receivables.js

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

package/tools/cobranzas/vendor-ledger.js

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

package/tools/efficiency-ratios.js

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

package/tools/expense-analysis.js

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

package/tools/expense-details.js

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

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

@@ -271,24 +271,52 @@ function renderCapexCard(s) {
 </div>`;
 }
 
-// Posición de caja + efecto cambiario sobre la caja VES (no afecta el FCF).
+// Posición de caja · conciliación · efecto cambiario (base saldo REAL del banco). NO afecta el FCF.
 function renderCashPositionCard(s) {
   const cp = s.cash_position;
-  if (!cp || !cp.ves || !cp.ves.accounts.length) return '';
-  const adj = cp.ves.fx_adjustment;
+  if (!cp || !cp.bank_accounts) return '';
+  const t = cp.totals;
   const dev = cp.month_devaluation_pct != null ? ` · devaluación mes ${cp.month_devaluation_pct}%` : '';
-  const acctRows = cp.ves.accounts
-    .map((a) => `<div class="pnl-row sub"><span class="pnl-label">${esc(a.account)} ${esc(a.name || '')}${a.store ? ` <span class="pnl-acct">${esc(a.store)}</span>` : ''}</span><span class="pnl-amt ${a.fx_adjustment < 0 ? 'val-red' : ''}">${signed(a.fx_adjustment)}</span></div>`)
-    .join('');
+  const st = (store) => (store ? ` <span class="pnl-acct">${esc(store)}</span>` : '');
+
+  // Bucket 1 — bancos con statement: GL vs real, brecha, tasa implícita, fx_real
+  const bankRows = cp.bank_accounts.map((b) => {
+    const flag = b.flags && b.flags.length ? ` <span class="pnl-acct">⚠ ${esc(b.flags.join(','))}</span>` : '';
+    return `<div class="pnl-row sub">
+      <span class="pnl-label">${esc(b.account)} ${esc(b.name || '')}${st(b.store)}${flag}<br>
+        <span class="kpi-cell-sub">GL ${fmt(b.gl_ves)} → real ${fmt(b.stmt_ves)} VES · impl ${b.implied_rate || '—'} vs ${cp.rate_end}</span></span>
+      <span class="pnl-amt ${b.fx_real < 0 ? 'val-red' : 'val-green'}">${signed(b.fx_real)}</span>
+    </div>`;
+  }).join('');
+
+  // Bucket 3 — ajuste/tránsito (informativo)
+  const infoRows = (cp.informational || []).map((b) =>
+    `<div class="pnl-row sub"><span class="pnl-label">${esc(b.account)} ${esc(b.name || '')}${st(b.store)} <span class="pnl-acct">informativo</span></span><span class="pnl-amt">${signed(b.fx_theoretical)}</span></div>`
+  ).join('');
+  // Bucket 2 — sin statement (provisional)
+  const pendRows = (cp.pending_no_statement || []).map((b) =>
+    `<div class="pnl-row sub"><span class="pnl-label">${esc(b.account)} ${esc(b.name || '')}${st(b.store)} <span class="pnl-acct">sin statement</span></span><span class="pnl-amt">${signed(b.fx_provisional)}</span></div>`
+  ).join('');
+
+  // Asiento sugerido (solo bucket 1)
+  const j = cp.fx_journal;
+  const jRows = (j && j.rows || []).map((r) =>
+    `<div class="pnl-row sub"><span class="pnl-label">${esc(String(r.account))} <span class="pnl-acct">${esc(r.account_type)}</span></span><span class="pnl-amt">${r.debit_usd ? 'DR ' + signed(r.debit_usd) : 'CR ' + signed(r.credit_usd)}</span></div>`
+  ).join('');
+
+  const reconUsd = cp.rate_end ? t.recon_gap_ves / cp.rate_end : 0;
   return `<div class="card">
-  <div class="card-hd"><span class="card-icon">&#x1F4B1;</span><span class="card-title">Posición de Caja · Efecto Cambiario (VES)</span></div>
+  <div class="card-hd"><span class="card-icon">&#x1F4B1;</span><span class="card-title">Posición de Caja · Conciliación · Efecto Cambiario (VES)</span></div>
   <div class="card-bd"><div class="pnl">
-    <div class="pnl-row"><span class="pnl-label">Caja VES — libro (USD)</span><span class="pnl-amt">${signed(cp.ves.book_usd)}</span></div>
-    <div class="pnl-row"><span class="pnl-label">Caja VES — real (a ${cp.rate_end} VES/USD)</span><span class="pnl-amt">${signed(cp.ves.real_usd)}</span></div>
-    <div class="pnl-row gross"><span class="pnl-label">= Ajuste cambiario no contabilizado${dev}</span><span class="pnl-amt ${adj < 0 ? 'val-red' : 'val-green'}">${signed(adj)}</span></div>
-    <div class="pnl-section-hd">Por cuenta VES</div>
-    ${acctRows}
-    <div class="pnl-row total"><span class="pnl-label">Caja total — libro ${signed(cp.total_cash_book_usd)} → real</span><span class="pnl-amt">${signed(cp.total_cash_real_usd)}</span></div>
+    <div class="pnl-row"><span class="pnl-label">Caja VES real (statement, a ${cp.rate_end} VES/USD)</span><span class="pnl-amt">${signed(t.ves_real_usd)}</span></div>
+    <div class="pnl-row"><span class="pnl-label">Brecha de conciliación (backlog a postear, NO es FX)</span><span class="pnl-amt">${fmt(t.recon_gap_ves)} VES (~${signed(reconUsd)})</span></div>
+    <div class="pnl-row gross"><span class="pnl-label">= Efecto cambiario sobre caja real${dev}</span><span class="pnl-amt ${t.fx_real < 0 ? 'val-red' : 'val-green'}">${signed(t.fx_real)}</span></div>
+    <div class="pnl-row sub"><span class="pnl-label">(ref. libro GL: ${signed(cp.gl_basis.ves_book_usd)} · FX s/GL ${signed(cp.gl_basis.fx_on_gl)})</span><span class="pnl-amt"></span></div>
+    <div class="pnl-section-hd">Bancos VES (saldo real vs libro)</div>
+    ${bankRows}
+    ${pendRows ? `<div class="pnl-section-hd">Sin statement (provisional)</div>${pendRows}` : ''}
+    ${infoRows ? `<div class="pnl-section-hd">Ajustes / Tránsito (informativo, fuera del total)</div>${infoRows}` : ''}
+    ${jRows ? `<div class="pnl-section-hd">Asiento sugerido — Diferencial Cambiario ${j.balanced ? '✓ cuadra' : '✗'}</div>${jRows}` : ''}
   </div></div>
 </div>`;
 }