@fullqueso/mcp-bc-gastos 1.10.0 → 1.11.1

package/config/income-accounts.js

@@ -25,6 +25,16 @@ export const COGS_ACCOUNTS = {
   57020: { name: 'Costos Diversos', nameEn: 'Diverse Costs' },
 };
 
+// Income group labels for breakdown (by 100-prefix: 40110 → 40100)
+export const INCOME_GROUP_LABELS = {
+  40100: '40100_ingreso_ventas',
+  40300: '40300_facturacion_directa',
+  40400: '40400_ingreso_servicios',
+  40500: '40500_otros_ingresos',
+  40600: '40600_ingreso_alquiler',
+  40900: '40900_extraordinarios',
+};
+
 // Ranges
 export const REVENUE_RANGE = { min: 40000, max: 49999 };
 export const COGS_RANGE = { min: 50000, max: 59999 };

package/lib/bc-client.js

@@ -1,5 +1,6 @@
 import { logger } from '../utils/logger.js';
 import { getExpenseCategory } from '../config/expense-accounts.js';
+import { INCOME_GROUP_LABELS } from '../config/income-accounts.js';
 import { resolveStores } from '../config/company-config.js';
 
 export class BCClient {
@@ -308,6 +309,26 @@ export class BCClient {
       0
     );
 
+    // Income breakdown by account group (401xx, 405xx, etc.)
+    const groupTotals = {};
+    for (const e of revenueEntries) {
+      const prefix = Math.floor(parseInt(e.accountNumber, 10) / 100) * 100;
+      groupTotals[prefix] = (groupTotals[prefix] || 0) + ((e.creditAmount || 0) - (e.debitAmount || 0));
+    }
+    const incomeBreakdown = {};
+    let breakdownSum = 0;
+    for (const [prefix, amount] of Object.entries(groupTotals)) {
+      const label = INCOME_GROUP_LABELS[prefix] || `${prefix}_other`;
+      incomeBreakdown[label] = Math.round(amount * 100) / 100;
+      breakdownSum += amount;
+    }
+    // Catch rounding drift vs totalRevenue
+    const drift = Math.round((totalRevenue - breakdownSum) * 100) / 100;
+    if (Math.abs(drift) > 0.005) {
+      incomeBreakdown.unclassified = drift;
+    }
+    incomeBreakdown.total = Math.round(totalRevenue * 100) / 100;
+
     // COGS (50000-59999): debit balance accounts, cost = debit - credit
     const totalCOGS = cogsEntries.reduce(
       (sum, e) => sum + ((e.debitAmount || 0) - (e.creditAmount || 0)),
@@ -341,6 +362,7 @@ export class BCClient {
       period: { start: startDate, end: endDate },
       expenses: categorizedExpenses,
       totalRevenue,
+      incomeBreakdown,
       totalCOGS,
       grossMargin,
       grossMarginPct,

package/lib/expense-analyzer.js

@@ -85,6 +85,7 @@ export function analyzeExpenses(storeData) {
     store_code: storeData.storeCode,
     period: storeData.period,
     total_revenue: round2(totalRevenue || totalIncome),
+    income_breakdown: storeData.incomeBreakdown || null,
     total_cogs: round2(totalCOGS || 0),
     gross_margin: round2(grossMargin || totalIncome),
     gross_margin_pct: round2(grossMarginPct || 0),

package/lib/ratio-calculator.js

@@ -90,6 +90,7 @@ export function calculateRatios(storeData) {
     store_code: storeData.storeCode,
     period: storeData.period,
     total_income: round2(totalIncome),
+    income_breakdown: storeData.incomeBreakdown || null,
     total_expenses: round2(totalExpenses),
     main_ratios: ratios,
     key_ratios: keyRatios,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullqueso/mcp-bc-gastos",
-  "version": "1.10.0",
+  "version": "1.11.1",
   "description": "MCP server for Business Central operational expense analysis, bank reconciliation, POS reconciliation, accounts receivable/payable, and multi-payment draft visibility - Full Queso franchise stores",
   "main": "server.js",
   "bin": {

package/server.js

@@ -32,6 +32,7 @@ import { expenseDetailsTool, handleExpenseDetails } from './tools/expense-detail
 import { accountTransactionsTool, handleAccountTransactions } from './tools/account-transactions.js';
 import { vendorTransactionsTool, handleVendorTransactions } from './tools/vendor-transactions.js';
 import { listVendorsTool, handleListVendors } from './tools/list-vendors.js';
+import { exchangeRateTool, handleGetExchangeRate } from './tools/get-exchange-rate.js';
 
 // Auditoria tools (bank reconciliation)
 import { listBankAccountsTool, handleListBankAccounts } from './tools/auditoria/list-bank-accounts.js';
@@ -86,6 +87,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       accountTransactionsTool,
       vendorTransactionsTool,
       listVendorsTool,
+      exchangeRateTool,
       // Auditoria (bank reconciliation)
       listBankAccountsTool,
       reconciliationStatusTool,
@@ -145,6 +147,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'list_vendors':
         result = await handleListVendors(bcClient, args);
         break;
+      case 'get_exchange_rate':
+        result = await handleGetExchangeRate(bcClient, args);
+        break;
       // Auditoria (bank reconciliation)
       case 'list_bank_accounts':
         result = await handleListBankAccounts(bcClient, args);

package/tools/get-exchange-rate.js

@@ -0,0 +1,112 @@
+import { resolveStores } from '../config/company-config.js';
+import { round2 } from '../utils/currency-converter.js';
+
+export const exchangeRateTool = {
+  name: 'get_exchange_rate',
+  description:
+    'Obtiene la tasa de cambio USD → VES desde Business Central. Modo fecha: retorna la tasa vigente para una fecha específica. Modo rango: retorna el historial de tasas en un período.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      store: {
+        type: 'string',
+        enum: ['FQ01', 'FQ28', 'FQ88'],
+        description: 'Tienda a consultar.',
+      },
+      date: {
+        type: 'string',
+        description:
+          'Fecha específica (YYYY-MM-DD). Retorna la tasa vigente (más reciente en o antes de esa fecha). Si no se indica fecha ni rango, usa hoy.',
+      },
+      start_date: {
+        type: 'string',
+        description:
+          'Inicio del rango (YYYY-MM-DD). Usar junto con end_date para obtener historial de tasas.',
+      },
+      end_date: {
+        type: 'string',
+        description:
+          'Fin del rango (YYYY-MM-DD). Usar junto con start_date para obtener historial de tasas.',
+      },
+    },
+    required: ['store'],
+  },
+};
+
+export async function handleGetExchangeRate(bcClient, args) {
+  const store = args.store;
+  if (!store) throw new Error('Parámetro requerido: store');
+
+  const stores = resolveStores([store]);
+  const storeInfo = stores[0];
+
+  const rates = await bcClient.getExchangeRates(store);
+
+  if (!rates || rates.length === 0) {
+    return {
+      store,
+      store_name: storeInfo.name,
+      error: 'No se encontraron tasas de cambio VES en Business Central.',
+    };
+  }
+
+  // Range mode
+  if (args.start_date && args.end_date) {
+    const filtered = rates.filter(
+      (r) => r.startingDate >= args.start_date && r.startingDate <= args.end_date
+    );
+
+    const rateList = filtered.map((r) => {
+      const rate = round2(r.exchangeRateAmount / r.relationalExchangeRateAmount);
+      return {
+        starting_date: r.startingDate,
+        rate,
+        label: `1 USD = ${rate} VES`,
+      };
+    });
+
+    // Also get the rate applicable at start_date (may be before the range)
+    const rateAtStart = bcClient.getExchangeRateForDate(rates, args.start_date);
+
+    return {
+      store,
+      store_name: storeInfo.name,
+      start_date: args.start_date,
+      end_date: args.end_date,
+      rate_at_start: rateAtStart
+        ? {
+            rate: round2(rateAtStart.rate),
+            starting_date: rateAtStart.startingDate,
+            label: `1 USD = ${round2(rateAtStart.rate)} VES`,
+          }
+        : null,
+      rates_in_range: rateList,
+      count: rateList.length,
+    };
+  }
+
+  // Single date mode (default: today)
+  const targetDate = args.date || new Date().toISOString().slice(0, 10);
+  const found = bcClient.getExchangeRateForDate(rates, targetDate);
+
+  if (!found) {
+    return {
+      store,
+      store_name: storeInfo.name,
+      date: targetDate,
+      exchange_rate: null,
+      message: 'No se encontró tasa de cambio para la fecha indicada.',
+    };
+  }
+
+  return {
+    store,
+    store_name: storeInfo.name,
+    date: targetDate,
+    exchange_rate: {
+      rate: round2(found.rate),
+      starting_date: found.startingDate,
+      label: `1 USD = ${round2(found.rate)} VES`,
+    },
+  };
+}