@fullqueso/mcp-bc-gastos 1.1.0 → 1.10.0

package/CHANGELOG.md

@@ -1,49 +1,173 @@
 # CHANGELOG
 
+## [1.10.0] - 2026-02-26
+
+### Highlights
+- **26 tools** across 5 domains
+- **New**: Consolidated bank reconciliation report tool — single call replaces 3-5 sequential tool calls
+- **Performance**: Parallel API fetching in reconciliation-status, bulk MP line fetching
+
+### Added
+- `get_bank_reconciliation_report` — consolidated bank reconciliation: progress + unmatched debits/credits + journal entry suggestions in ONE MCP call. Statement selection by number, month (`month: "2025-12"`), or latest. Includes `matchBankDescription` keyword matching + historical GL pattern matching for debit suggestions.
+- Skill spec: `docs/SKILL_bank_reconciliation.md` — trigger phrases, presentation guide, example queries
+
+### Performance
+- **Bank reconciliation**: `get_reconciliation_status` now fetches statement lines in parallel (`Promise.all`) instead of sequential `for...of` loop
+- **Multi-Payment draft tools**: Replaced per-MP-header parallel line fetch (`Promise.all` on N headers) with single bulk fetch + in-memory grouping. Fixes BC 429 rate limiting for large stores (FQ28: ~1,173 invoices)
+- **BC client**: `fetchWithRetry` now handles HTTP 429 with `Retry-After` header support and exponential backoff
+
+---
+
+## [1.9.0] - 2026-02-25
+
+### Highlights
+- **25 tools** across 5 domains: expenses, bank reconciliation, POS reconciliation, AR/AP, **Multi-Payment draft visibility**
+- **4 API integrations**: Standard v2.0, OData V4, Finance Reports Beta, **Custom Extension API**
+- Three-tier invoice classification: Fully Pending → Drafted → In Journal
+
+### Added
+
+**Multi-Payment Draft Visibility — 3 herramientas (Custom Extension API):**
+- `get_draft_receivables` — facturas de venta abiertas con clasificación de tres niveles: sin documento, con borrador Open, con borrador Transferred. Incluye monto neto realmente pendiente y desglose por método de pago
+- `get_draft_payables` — mismo análisis para facturas de compra (proveedores)
+- `get_draft_summary` — resumen ejecutivo del pipeline de cobros y pagos en borrador por tienda
+
+**Aging Reports — nuevo parámetro `report` en get_draft_receivables y get_draft_payables:**
+- `report: "aging_pending"` — facturas SIN multipago agrupadas por mes con top vendors/customers, age_days_avg, y aging buckets (0-30, 31-60, 61-90, 90+)
+- `report: "aging_full"` — ambas categorías por mes: sin multipago + con draft sin postear, incluyendo drafted_amount y net_pending
+- `report: "default"` (o sin parámetro) — comportamiento existente sin cambios
+
+### Fixed
+- **Currency conversion bug**: `totalPaymentAmount` on MP headers is a VES FlowField sum — was being reported as USD. Now fetches MP lines + BCV exchange rates to compute accurate USD totals per line (VES lines ÷ BCV rate, USD lines as-is). Affects all 3 draft tools.
+
+### Technical
+- Custom Extension API integration (`buildCustomApiUrl`, `buildMultiPaymentApiUrl`) in BCClient
+- Supports 4 new API pages from Sales Invoice Payment Automation extension v1.4.0.0:
+  `multiPaymentHeaders`, `multiPaymentLines`, `purchMultiPaymentHeaders`, `purchMultiPaymentLines`
+- Three-tier classification logic cross-referencing customer/vendor ledger entries with MP headers
+- Multi-store parallel fetching with consolidated summaries
+- Payment method breakdown via MP lines (optional `include_lines` parameter)
+- Aging logic is pure post-processing on existing data — no additional API calls
+- Entity-parameterized aging builders (`VENDOR_ENTITY` / `CUSTOMER_ENTITY`) for correct field names per tool
+
+---
+
+## [1.8.0] - 2026-02-23
+
+### Highlights
+- **22 tools** across 4 domains: expenses, bank reconciliation, POS reconciliation, AR/AP
+- **3 API integrations**: Standard v2.0, OData V4, Finance Reports Beta
+- **4-bank POS reconciliation**: Banesco, Bancrecer, BDV, UBII (cross-account)
+- **Performance**: in-memory caching, parallel fetching, request deduplication
+
+This npm release consolidates all changes from v1.2.0 through v1.8.0.
+
+### Added
+- UBII cross-account POS reconciliation — matches sales in virtual account MN0012 against deposits in Bancrecer/BDV
+- In-memory caching for store financial data (5-min TTL) and exchange rates (15-min TTL)
+- Inflight request deduplication in BCClient (concurrent calls share one promise)
+- Parallel store fetching via `Promise.all` in `getAllStoresFinancialData`
+- Test suite: `test-pos-reconciliation.js` for multi-bank POS reconciliation
+
+---
+
+## [1.6.0] - 2026-02-22
+
+### Added
+- BDV aggregate POS matching — reconciliation by period totals (no lot numbers in bank statements)
+- Bancrecer lot-based POS reconciliation with separate commission (`N/D COM.`) and ISLR (`N/D ISLR`) line handling
+- Daily summary with status pipeline: `OK`, `MISSING_MPCR`, `HIGH_COMMISSION`, `BANK_EXCEEDS_BC`, `MPCR_NO_BANK`, `BANK_ONLY`, `COMMISSION_UNKNOWN`
+- Data source indicators: `BALE_DIRECT` vs `CLE_WITH_BALE_CORRECTION`
+- `COMMISSION_UNKNOWN` status for uncalculable commissions (BALE correction fallback)
+
+---
+
+## [1.5.0] - 2026-02-21
+
+### Added
+- Herramienta `reconcile_pos_sales` — conciliación POS por número de lote (Banesco)
+- BALE (BankAccountLedgerEntries) OData V4 integration for precise per-bank POS amounts
+- Settlement batch grouping by bank deposit date
+- Commission calculations and journal entry suggestions (debit 67100, credit 182XX)
+- Lot parsing: `parseBCLots()`, `parseBankStatementLot()` for compound lot numbers
+- POS reconciliation skill spec documentation
+
+---
+
+## [1.4.0] - 2026-02-21
+
+### Added
+
+**Auditoría Bancaria — 6 herramientas (OData V4):**
+- `list_bank_accounts` — cuentas bancarias activas por tienda
+- `get_reconciliation_status` — resumen de reconciliaciones abiertas (matched vs pending)
+- `get_unmatched_statement_lines` — líneas del estado de cuenta no conciliadas con BC
+- `get_unmatched_ledger_entries` — entradas contables de BC sin correspondencia en banco
+- `find_potential_matches` — scoring 0-100 para encontrar correspondencias (monto/fecha/descripción)
+- `suggest_journal_entries` — sugerencias de asientos contables para líneas no conciliadas
+
+**Cobranzas y Cuentas por Pagar — 6 herramientas (Finance Reports Beta API):**
+- `get_customer_balances` — clientes con saldos pendientes
+- `get_customer_ledger` — movimientos de clientes (facturas, pagos, notas de crédito)
+- `get_open_receivables` — cuentas por cobrar abiertas con aging (0-30, 31-60, 61-90, 90+)
+- `get_collection_status` — verificación de cobranza completa por período
+- `get_vendor_ledger` — movimientos de proveedores (facturas recibidas, pagos realizados)
+- `get_open_payables` — cuentas por pagar abiertas con aging
+
+### Technical
+- OData V4 Web Service integration (`buildODataUrl`, `odataCall`, `odataCallAllPages`)
+- Finance Reports Beta API integration (`buildBetaApiUrl`)
+- Bank keywords configuration (`config/bank-keywords.js`)
+- Company name mapping in `config/company-config.js`
+
+---
+
+## [1.2.0] - 2026-02-20
+
+### Added
+- Herramienta `get_vendor_transactions` — todas las transacciones de un proveedor con desglose por cuenta contable
+- Herramienta `list_vendors` — directorio de proveedores activos ordenados por monto pagado
+- `vendor_search` — búsqueda parcial case-insensitive por nombre de proveedor en `get_expense_details`
+- Paginación (`offset`/`limit`) para `get_expense_details`
+- Archivo LICENSE (MIT)
+- `.env.example` con documentación completa de variables
+
+---
+
 ## [1.1.0] - 2026-02-19
 
 ### Added
-- Herramienta `get_expense_details` - Drill-down transaccional de gastos con filtros por categoría, cuenta, monto mínimo y límite configurable
-- Herramienta `get_account_transactions` - Listado completo de transacciones por cuenta contable con running balance
-- Vendor lookup automático en ambas herramientas nuevas: cada transacción incluye `vendor_name` y `vendor_number` vía cruce con Vendor Ledger Entries
-- Métodos `getVendorLedgerEntries()`, `getVendors()` y `buildVendorMap()` en bc-client.js
-- Método `getDetailedGLEntries()` con filtros flexibles (cuenta específica, rango, fechas, top)
+- Herramienta `get_expense_details` — drill-down transaccional con filtros por categoría, cuenta, monto mínimo
+- Herramienta `get_account_transactions` — listado por cuenta contable con running balance
+- Vendor lookup automático: `vendor_name` y `vendor_number` vía cruce con Vendor Ledger Entries
+- Métodos `getVendorLedgerEntries()`, `getVendors()`, `buildVendorMap()` en bc-client.js
+- `getDetailedGLEntries()` con filtros flexibles
 
 ### Technical
-- `buildVendorMap()` es resiliente: retorna `{}` si los endpoints de vendor no están disponibles (try/catch con logger.warn)
-- GL entries y vendor map se fetchean en paralelo con `Promise.all` en ambas herramientas
-- Tests 6 y 7 agregados a test-tools.js (total: 7 tools testeadas)
+- `buildVendorMap()` resiliente: retorna `{}` si endpoints no disponibles
+- GL entries y vendor map en paralelo con `Promise.all`
 
 ---
 
 ## [1.0.0] - 2026-02-18
 
 ### Added
-- Herramienta `get_expense_analysis` - Análisis detallado de gastos por categoría
-- Herramienta `get_efficiency_ratios` - Cálculo de ratios financieros
-- Herramienta `compare_stores` - Comparación entre tiendas
-- Herramienta `detect_anomalies` - Detección automática de anomalías
-- Herramienta `get_trends` - Análisis de tendencias históricas
-- Integración con Business Central API vía OAuth 2.0
-- Mapeo completo del Chart of Accounts (60000-99999, 50000-59999)
+- Herramienta `get_expense_analysis` — análisis detallado por categoría con benchmarks
+- Herramienta `get_efficiency_ratios` — ratios financieros
+- Herramienta `compare_stores` — comparación entre tiendas con rankings
+- Herramienta `detect_anomalies` — detección de anomalías por severidad
+- Herramienta `get_trends` — tendencias históricas (6 meses)
+- Cliente Business Central con OAuth 2.0
+- Chart of Accounts mapping (60000-99999 gastos, 50000-59999 ingresos)
 - Conversión automática VES/USD
 - Benchmarking contra rangos esperados
 - Insights accionables automáticos
 
-### Technical
-- Cliente Business Central con OAuth 2.0
-- ExpenseAnalyzer para análisis de gastos
-- RatioCalculator para métricas financieras
-- AnomalyDetector para alertas
-- TrendAnalyzer para análisis histórico
-- Formatter para outputs bien formateados
-
 ---
 
 ## [0.1.0] - 2026-02-18
 
 ### Added
 - Proyecto inicializado
-- Documentación completa (CLAUDE.md, TODO.md, PLAN_SUMMARY.md)
+- Documentación completa
 - Estructura de proyecto definida
-- Chart of Accounts mapeado

package/README.md

@@ -1,16 +1,15 @@
 # @fullqueso/mcp-bc-gastos
 
-MCP server for analyzing operational expenses and financial ratios from Microsoft Business Central. Built for the Full Queso franchise (3 stores: FQ01 Chacao, FQ28 Marques, FQ88 Candelaria).
+MCP server for Microsoft Business Central — operational expenses, bank reconciliation, POS reconciliation, and accounts receivable/payable. Built for the Full Queso franchise (3 stores: FQ01 Chacao, FQ28 Marques, FQ88 Candelaria).
+
+**22 tools** across 4 domains, powered by 3 BC API integrations.
 
 ## Features
 
-- **Expense Analysis** - Detailed breakdown by 10 categories with account-level detail and benchmarks
-- **Efficiency Ratios** - Expense-to-income, payroll, rent, utilities, marketing, operating margin
-- **Store Comparison** - Rankings, variances, and savings opportunities across stores
-- **Anomaly Detection** - Automatic alerts by severity with root-cause analysis
-- **Trend Analysis** - 6-month historical trends with growth rates and seasonality
-- **Expense Details** - Transaction-level drill-down with vendor information
-- **Account Transactions** - Per-account ledger with running balance and vendor lookup
+- **Expense Analysis** — Breakdown by 10 categories, efficiency ratios, store comparison, anomaly detection, 6-month trends
+- **Drill-Down & Vendors** — Transaction-level detail with vendor lookup, per-account ledger, vendor directory
+- **Bank Reconciliation** — Unmatched statement lines/ledger entries, match scoring, journal entry suggestions, multi-bank POS reconciliation (Banesco, Bancrecer, BDV, UBII)
+- **Accounts Receivable & Payable** — Customer/vendor ledger entries, open receivables/payables with aging, collection status
 
 ## Installation
 
@@ -52,35 +51,121 @@ cp .env.example .env
 npm start
 ```
 
-## Tools
+## Tools (22)
+
+### Expense Analysis (5 tools)
 
-### get_expense_analysis
-Detailed expense analysis by category with benchmark comparisons.
-- Parameters: `stores`, `period`, `month`, `start_date`, `end_date`
+#### 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
+#### get_efficiency_ratios
 Financial ratios: expense-to-income, payroll, rent, utilities, marketing, operating margin.
-- Parameters: `stores`, `period`, `month`, `start_date`, `end_date`
+- Params: `stores`, `period`, `month`, `start_date`, `end_date`
+
+#### compare_stores
+Compare all stores with efficiency rankings, variances, and savings opportunities.
+- 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`
+
+#### get_trends
+Historical trend analysis (up to 6 months) with growth rates, seasonality, and ASCII charts.
+- Params: `store`, `months`
+
+### Drill-Down & Vendors (4 tools)
+
+#### 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`
+
+#### 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_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)
+
+#### list_vendors
+Directory of active vendors ordered by total amount paid.
+- Params: `store` (req), `start_date`, `end_date`
+
+### Bank Reconciliation (7 tools)
+
+> These tools use OData V4 Web Services. Amounts in VES. Read-only.
+
+#### list_bank_accounts
+List active bank accounts for a store.
+- Params: `store` (req)
+
+#### get_reconciliation_status
+Open reconciliation summary: matched vs unmatched lines per bank account.
+- Params: `store` (req), `bank_account`
+
+#### 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`
 
-### compare_stores
-Compare all stores with efficiency rankings and savings opportunities.
-- Parameters: `period`, `month`, `start_date`, `end_date`
+#### 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`
 
-### detect_anomalies
-Detect expense anomalies with severity levels and recommended actions.
-- Parameters: `stores`, `period`, `month`, `start_date`, `end_date`, `sensitivity`
+#### 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`
 
-### get_trends
-Historical trend analysis (up to 6 months) with growth rates and ASCII charts.
-- Parameters: `store`, `months`
+#### 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`
 
-### get_expense_details
-Transaction-level drill-down with vendor lookup and filters.
-- Parameters: `store`, `period`, `month`, `start_date`, `end_date`, `category`, `account_number`, `min_amount`, `limit`
+#### 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`
 
-### get_account_transactions
-Per-account ledger view with running balance and vendor information.
-- Parameters: `account_number`, `store`, `start_date`, `end_date`
+### Accounts Receivable & Payable (6 tools)
+
+> These tools use the Finance Reports Beta API. Amounts in VES and USD. Read-only.
+
+#### get_customer_balances
+Customers with outstanding balances.
+- Params: `store` (req), `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`
+
+#### 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_collection_status
+Period collection completeness: "Were all December invoices collected?"
+- Params: `store` (req), `start_date` (req), `end_date` (req)
+
+#### 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`
+
+#### 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`
+
+## API Integrations
+
+| API | Used By | URL Pattern |
+|-----|---------|-------------|
+| **Standard v2.0** | Expenses, vendors, customers | `v2.0/{tenant}/{environment}/api/v2.0/companies({guid})/...` |
+| **OData V4** | Bank reconciliation, BALE | `ODataV4/Company('{name}')/{service}` |
+| **Finance Reports Beta** | Customer/vendor ledger entries | `api/microsoft/reportsFinance/beta/companies({guid})/...` |
+
+All APIs share the same OAuth 2.0 credentials (Azure AD client credentials flow).
 
 ## Environment Variables
 
@@ -96,22 +181,50 @@ Per-account ledger view with running balance and vendor information.
 | `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 |
-| `LOG_LEVEL` | No | Log level: `debug`, `info`, `warn`, `error` (default: `info`) |
+| `LOG_LEVEL` | No | `debug`, `info`, `warn`, `error` (default: `info`) |
 
 ## Chart of Accounts
 
 10 expense categories mapped to account ranges 60000-99999:
 
-1. **Planta Fisica** (60000-60999) - Rent, utilities
-2. **Alquiler Equipos** (61000-61999) - Equipment rental
-3. **Logistica** (62000-62999) - Vehicles, delivery
-4. **Marketing** (63000-63999) - Advertising, commissions
-5. **Administrativos** (64000-64999) - Office, software
-6. **Seguros** (65000-65999) - Insurance
-7. **Bancarios** (67000-67999) - Banking fees, interest
-8. **Servicios Contratados** (68000-68999) - Contracted services
-9. **Nomina** (70000-74999) - Payroll, benefits
-10. **Otros** (80000-99999) - Depreciation, other
+1. **Planta Fisica** (60000-60999) — Rent, utilities
+2. **Alquiler Equipos** (61000-61999) — Equipment rental
+3. **Logistica** (62000-62999) — Vehicles, delivery
+4. **Marketing** (63000-63999) — Advertising, commissions
+5. **Administrativos** (64000-64999) — Office, software
+6. **Seguros** (65000-65999) — Insurance
+7. **Bancarios** (67000-67999) — Banking fees, interest
+8. **Servicios Contratados** (68000-68999) — Contracted services
+9. **Nomina** (70000-74999) — Payroll, benefits
+10. **Otros** (80000-99999) — Depreciation, other
+
+## Architecture
+
+```
+mcp-fullqueso-bc-gastos/
+├── server.js              # MCP server entry point (22 tools)
+├── lib/
+│   ├── bc-client.js       # OAuth + BC API (v2.0, OData V4, Beta)
+│   ├── expense-analyzer.js
+│   ├── ratio-calculator.js
+│   ├── anomaly-detector.js
+│   ├── trend-analyzer.js
+│   └── formatter.js
+├── config/
+│   ├── expense-accounts.js
+│   ├── income-accounts.js
+│   ├── benchmarks.js
+│   ├── company-config.js
+│   └── bank-keywords.js
+├── tools/
+│   ├── [9 expense/vendor tools]
+│   ├── auditoria/         # 7 bank reconciliation tools
+│   └── cobranzas/         # 6 AR/AP tools
+└── utils/
+    ├── date-helper.js
+    ├── currency-converter.js
+    └── logger.js
+```
 
 ## License
 

package/config/bank-keywords.js

@@ -0,0 +1,50 @@
+// Bank Statement Keywords → GL Account Mapping
+// Used by suggest_journal_entries tool for automatic categorization
+// Keywords are matched case-insensitively against bank statement descriptions
+
+export const BANK_KEYWORDS = [
+  // Servicios públicos
+  { keywords: ['CANTV', 'MOVISTAR', 'DIGITEL'], account: '60530', name: 'Telecomunicaciones' },
+  { keywords: ['CORPOELEC', 'ELECTRICIDAD'], account: '60510', name: 'Electricidad' },
+  { keywords: ['HIDRO', 'AGUA'], account: '60520', name: 'Agua' },
+  { keywords: ['ASEO'], account: '60540', name: 'Aseo Urbano' },
+
+  // Gastos bancarios
+  { keywords: ['COMISION', 'COMISIÓN'], account: '67100', name: 'Comisiones Bancarias' },
+  { keywords: ['ITF', 'IGTF', 'IDB'], account: '67200', name: 'Impuestos Transacciones Financieras' },
+  { keywords: ['INTERES', 'INTERÉS', 'INTERESES'], account: '67300', name: 'Intereses Bancarios' },
+
+  // Nómina
+  { keywords: ['NOMINA', 'NÓMINA'], account: '71100', name: 'Sueldos y Salarios' },
+  { keywords: ['BONO', 'BONIFICACION'], account: '71120', name: 'Bonos' },
+
+  // Alquiler
+  { keywords: ['ALQUILER', 'ARRENDAMIENTO', 'CANON'], account: '60110', name: 'Alquiler Local' },
+
+  // Seguros
+  { keywords: ['SEGURO', 'POLIZA', 'PÓLIZA'], account: '65100', name: 'Seguros' },
+
+  // POS / Ventas (credits)
+  { keywords: ['PUNTO DE VENTA', 'POS', 'VISA', 'MASTERCARD'], account: '11300', name: 'Depósito POS' },
+
+  // Transfers
+  { keywords: ['TRANSF RECIBIDA', 'TRANSFERENCIA RECIBIDA'], account: '11000', name: 'Transferencia Recibida' },
+  { keywords: ['TRANSF ENVIADA', 'TRANSFERENCIA ENVIADA'], account: '11000', name: 'Transferencia Enviada' },
+];
+
+// Match a bank description against keywords
+// Returns { account, name } or null if no match
+export function matchBankDescription(description) {
+  if (!description) return null;
+  const upper = description.toUpperCase();
+
+  for (const rule of BANK_KEYWORDS) {
+    for (const keyword of rule.keywords) {
+      if (upper.includes(keyword.toUpperCase())) {
+        return { account: rule.account, name: rule.name };
+      }
+    }
+  }
+
+  return null;
+}

package/config/company-config.js

@@ -5,18 +5,21 @@ function getStores() {
   return {
     FQ01: {
       companyId: process.env.BC_COMPANY_FQ01,
+      companyName: 'Alimentos%20FQ-01',
       name: 'FQ01 Chacao',
       shortName: 'Chacao',
       location: 'Chacao, Caracas',
     },
     FQ28: {
       companyId: process.env.BC_COMPANY_FQ28,
+      companyName: 'Alimentos%20FQ-28',
       name: 'FQ28 Marqués',
       shortName: 'Marqués',
       location: 'El Marqués, Caracas',
     },
     FQ88: {
       companyId: process.env.BC_COMPANY_FQ88,
+      companyName: 'Alimentos%20FQ-88',
       name: 'FQ88 Candelaria',
       shortName: 'Candelaria',
       location: 'La Candelaria, Caracas',