@fullqueso/mcp-bc-gastos 1.14.2 → 1.17.0

package/CHANGELOG.md

@@ -1,5 +1,98 @@
 # CHANGELOG
 
+## [1.17.0] - 2026-03-18
+
+### Highlights
+- **Ventas domain consolidated** from `mcp-bc-analisis-ventas` — 3 new sales analysis tools
+- Full Queso now has one unified BC MCP with 41 tools across 8 domains
+
+### Added
+
+**New domain: Ventas (tools/ventas/) — 3 tools:**
+- `get_sales_analysis` — Multi-dimensional sales analysis by product, category, customer, store, time period. Revenue from GL entries (USD), trend comparison vs previous period, actionable insights
+- `get_product_performance` — Top/bottom product performers with growth trends, per-store breakdown, margin analysis, and promotion opportunities
+- `compare_sales_by_store` — Sales comparison across FQ01/FQ28/FQ88: revenue, transactions, avg ticket, top products, daily patterns, cross-store insights
+
+**bc-client.js — Sales API methods:**
+- `getSalesInvoicesExpanded()` — Sales invoices with `$expand=salesInvoiceLines`
+- `getSalesInvoicesWithLines()` — Flattened invoices + enriched lines
+- `getItemsCatalog()` — Items master data for product enrichment
+- `getSalesStoreData()` — Per-store sales orchestration (invoices + items + GL revenue + exchange rate enrichment)
+- `getAllSalesStoreData()` — Multi-store sequential fetch with shared exchange rates
+
+**Utilities:**
+- `utils/sales-aggregation.js` — Sales-specific aggregation: by field, by date, summary calculation, growth, top/bottom N
+- `utils/sales-insights.js` — Business insight generation: revenue trends, margin alerts, store gap analysis, product opportunities
+
+### Notes
+- `compare_sales_by_store` (sales) is separate from `compare_stores` (expenses) to avoid naming conflict
+- Revenue uses GL entries (accounts 40000-49999) as authoritative USD source
+- Line-level amounts used only for relative product/category breakdowns
+- This consolidation deprecates the standalone `@fullqueso/mcp-bc-analisis-ventas` package
+
+## [1.16.0] - 2026-03-16
+
+### Highlights
+- **Dynamic CLI reports** for pending invoice auditing — both Purchase and Sales
+- Parametric scripts: any store (FQ01/FQ28/FQ88/all), any month range, auto-generated Excel
+- 3-tab Excel output: Sin Draft, Con Draft, Pago Parcial — with subtotals by month and invoice numbers for audit
+
+### Added
+
+**Scripts — Posted Purchase Invoices Pendientes:**
+- `scripts/report-pending-invoices.js` — Node.js CLI that fetches open vendor ledger entries + purchMultiPaymentHeaders/Lines, classifies invoices by payment status, and generates Excel via Python
+- `scripts/generate-pending-invoices-xlsx.py` — Python (openpyxl) Excel generator with 3 tabs, month subtotals, color-coded tiers, and grand totals
+
+**Scripts — Posted Sales Invoices Pendientes:**
+- `scripts/report-pending-sales-invoices.js` — Same pattern for customer side: customerLedgerEntries + multiPaymentHeaders/Lines
+- `scripts/generate-pending-sales-invoices-xlsx.py` — Sales-specific Excel generator (Cliente instead of Proveedor, Posted SI instead of Posted PI)
+
+### Usage
+```bash
+# Purchase invoices
+node scripts/report-pending-invoices.js --store FQ28 --from 2025-05 --to 2025-07
+
+# Sales invoices
+node scripts/report-pending-sales-invoices.js --store FQ01 --from 2025-12 --to 2026-01
+
+# All stores, custom output path
+node scripts/report-pending-invoices.js --store all --from 2026-03 --to 2026-03 --out ~/Desktop/report.xlsx
+```
+
+### Technical
+- CLI args via `node:util/parseArgs`: `--store`, `--from`, `--to`, `--out`
+- Parallel API calls: ledger + MP headers + exchange rates fetched concurrently
+- Bulk MP line fetching with server-side $filter for ≤50 headers
+- USD conversion via BCV exchange rate for VES payment lines
+- JSON intermediate file (auto-cleaned) passed to Python for Excel generation
+- Output defaults to `~/Downloads/{STORE}_{Type}_{period}_{date}.xlsx`
+
+---
+
+## [1.15.0] - 2026-03-15
+
+### Highlights
+- **36 tools** across 7 domains — new `get_item_cost_trend` tool for inventory cost trending
+- 2W vs 4W rolling average comparison to detect rising/falling ingredient costs
+- Documented `calculated_unit_cost` methodology for cross-project use (MCP + Dashboard)
+
+### Added
+
+**Inventario — 1 new tool:**
+- `get_item_cost_trend` — compares weighted avg inbound cost of last 2 weeks vs last 4 weeks. Detects if cost is trending up (>+5%), down (<-5%), or stable. Supports single item or bulk analysis by category. Includes stale cost detection (no inbound > 30 days).
+
+**Documentation:**
+- `docs/calculated_unit_cost_method.md` — complete methodology for calculated unit cost (Last 3 Inbound) and cost trending (2W vs 4W). Shared reference for mcp-fullqueso-bc-gastos and mcp-fullqueso-dashboard COGS table implementation.
+
+### Technical
+- New file: `tools/inventario/item-cost-trend.js`
+- Configurable `period_days` parameter (default 28, recent = half)
+- Results sorted by severity: cost spikes first, then stable items
+- Batch API calls (5 concurrent) to avoid BC rate limiting
+- Category filtering via cross-reference with items endpoint
+
+---
+
 ## [1.14.0] - 2026-03-15
 
 ### Highlights

package/lib/bc-client.js

@@ -530,6 +530,149 @@ export class BCClient {
     return filters.top ? this.apiCall(url) : this.apiCallAllPages(url);
   }
 
+  // ── Sales Analysis Methods ──────────────────────────────────────
+
+  async getSalesInvoicesExpanded(companyId, startDate, endDate) {
+    const url = this.buildApiUrl(companyId, 'salesInvoices', {
+      $filter: `postingDate ge ${startDate} and postingDate le ${endDate}`,
+      $orderby: 'postingDate desc',
+      $expand: 'salesInvoiceLines',
+    });
+    return this.apiCallAllPages(url);
+  }
+
+  async getSalesInvoicesWithLines(companyId, startDate, endDate) {
+    const expandedInvoices = await this.getSalesInvoicesExpanded(companyId, startDate, endDate);
+    const invoices = [];
+    const lines = [];
+
+    for (const inv of expandedInvoices) {
+      const { salesInvoiceLines, ...invoiceData } = inv;
+      invoices.push(invoiceData);
+
+      for (const line of (salesInvoiceLines || [])) {
+        lines.push({
+          ...line,
+          postingDate: inv.postingDate,
+          invoiceDate: inv.invoiceDate,
+          documentNo: inv.number,
+          customerName: inv.customerName,
+          amount: line.amountExcludingTax || line.netAmount || 0,
+        });
+      }
+    }
+
+    return { invoices, lines };
+  }
+
+  async getItemsCatalog(companyId) {
+    const url = this.buildApiUrl(companyId, 'items', {
+      $select: 'id,number,displayName,type,unitPrice,unitCost,itemCategoryCode,lastDirectCost',
+    });
+    return this.apiCallAllPages(url);
+  }
+
+  async getSalesStoreData(storeCode, startDate, endDate, exchangeRates = null) {
+    const stores = resolveStores([storeCode]);
+    const store = stores[0];
+
+    logger.info(`Fetching sales data for ${store.name}: ${startDate} to ${endDate}`);
+
+    const salesData = await this.getSalesInvoicesWithLines(store.companyId, startDate, endDate);
+    const items = await this.getItemsCatalog(store.companyId);
+
+    // Revenue from GL (40000-49999) for authoritative USD amounts
+    const revenueEntries = await this.getRevenueEntries(store.companyId, startDate, endDate);
+    const glRevenue = { total_usd: 0, breakdown: {} };
+    for (const e of revenueEntries) {
+      const amount = (e.creditAmount || 0) - (e.debitAmount || 0);
+      glRevenue.total_usd += amount;
+      const acct = e.accountNumber;
+      glRevenue.breakdown[acct] = (glRevenue.breakdown[acct] || 0) + amount;
+    }
+    for (const acct of Object.keys(glRevenue.breakdown)) {
+      glRevenue.breakdown[acct] = Math.round(glRevenue.breakdown[acct] * 100) / 100;
+    }
+    glRevenue.total_usd = Math.round(glRevenue.total_usd * 100) / 100;
+
+    // Exchange rates
+    if (!exchangeRates) {
+      try {
+        exchangeRates = await this.getExchangeRates(storeCode);
+      } catch (err) {
+        logger.warn('Could not fetch exchange rates:', err.message);
+        exchangeRates = [];
+      }
+    }
+
+    const periodRate = this.getExchangeRateForDate(exchangeRates, endDate);
+
+    // Build items lookup
+    const itemsMap = {};
+    for (const item of items) {
+      itemsMap[item.number] = item;
+    }
+
+    // Enrich lines with item data and converted costs
+    for (const line of salesData.lines) {
+      const itemNo = line.lineObjectNumber || line.itemId;
+      const item = itemsMap[itemNo];
+      if (item) {
+        line.itemCategoryCode = item.itemCategoryCode;
+        line.unitCostUSD = item.lastDirectCost || item.unitCost || 0;
+        line.displayName = item.displayName || line.description;
+      }
+      if (!line.displayName) {
+        line.displayName = line.description || 'Sin nombre';
+      }
+      line.itemNumber = line.lineObjectNumber || '';
+      line.unitCostUSD = line.unitCostUSD || 0;
+
+      if (exchangeRates.length > 0 && line.unitCostUSD) {
+        const rateForDate = this.getExchangeRateForDate(exchangeRates, line.postingDate || endDate);
+        const rate = rateForDate ? rateForDate.rate : (periodRate ? periodRate.rate : 0);
+        line.unitCostVES = line.unitCostUSD * rate;
+        line.exchangeRate = rate;
+      } else {
+        line.unitCostVES = 0;
+        line.exchangeRate = periodRate ? periodRate.rate : null;
+      }
+    }
+
+    return {
+      invoices: salesData.invoices,
+      lines: salesData.lines,
+      items,
+      itemsMap,
+      exchangeRate: periodRate,
+      glRevenue,
+      storeName: store.name,
+      storeCode: store.code,
+    };
+  }
+
+  async getAllSalesStoreData(storeCodes, startDate, endDate) {
+    const stores = resolveStores(storeCodes);
+    const results = {};
+
+    // Fetch exchange rates once (shared across all companies in same tenant)
+    let exchangeRates = [];
+    try {
+      exchangeRates = await this.getExchangeRates(stores[0].code);
+      logger.info(`Exchange rates loaded: ${exchangeRates.length} entries`);
+    } catch (err) {
+      logger.warn('Could not fetch exchange rates:', err.message);
+    }
+
+    // Fetch stores sequentially to avoid BC API rate limiting
+    for (const store of stores) {
+      const data = await this.getSalesStoreData(store.code, startDate, endDate, exchangeRates);
+      results[store.code] = data;
+    }
+
+    return results;
+  }
+
   async getCompanies() {
     const url = `${this.baseUrl}/${this.tenantId}/${this.environment}/api/v2.0/companies`;
     return this.apiCall(url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullqueso/mcp-bc-gastos",
-  "version": "1.14.2",
+  "version": "1.17.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-pending-invoices-xlsx.py

@@ -0,0 +1,378 @@
+#!/usr/bin/env python3
+"""
+Generate FQ28 Pending Invoices Excel — May/Jun/Jul 2025
+3 tabs: Sin Draft, Con Draft, Pago Parcial
+Each tab lists posted purchase invoice numbers for auditing.
+
+Usage: python3 generate-fq28-pending-xlsx.py <input.json> <output.xlsx>
+"""
+
+import json
+import sys
+from datetime import datetime, date
+from pathlib import Path
+
+try:
+    from openpyxl import Workbook
+    from openpyxl.styles import Font, Alignment, PatternFill, Border, Side
+except ImportError:
+    print("Error: openpyxl required. Install: pip3 install openpyxl", file=sys.stderr)
+    sys.exit(1)
+
+# ─── Styles ───
+BOLD = Font(bold=True)
+BOLD_14 = Font(bold=True, size=14)
+BOLD_12 = Font(bold=True, size=12)
+BOLD_11 = Font(bold=True, size=11)
+HEADER_FILL = PatternFill(start_color="4472C4", end_color="4472C4", fill_type="solid")
+HEADER_FONT = Font(bold=True, color="FFFFFF", size=10)
+SUBTOTAL_FILL = PatternFill(start_color="D9E2F3", end_color="D9E2F3", fill_type="solid")
+SUBTOTAL_FONT = Font(bold=True, size=10)
+NUM_FMT = '#,##0.00'
+
+TIER_FILLS = {
+    "fully_pending": PatternFill(start_color="FCE4EC", end_color="FCE4EC", fill_type="solid"),
+    "draft_in_progress": PatternFill(start_color="FFF3E0", end_color="FFF3E0", fill_type="solid"),
+    "in_journal": PatternFill(start_color="E8F5E9", end_color="E8F5E9", fill_type="solid"),
+}
+
+MONTH_NAMES_ES = {
+    "01": "Enero", "02": "Febrero", "03": "Marzo", "04": "Abril",
+    "05": "Mayo", "06": "Junio", "07": "Julio", "08": "Agosto",
+    "09": "Septiembre", "10": "Octubre", "11": "Noviembre", "12": "Diciembre",
+}
+
+def month_label(ym):
+    """Convert '2025-05' to 'Mayo 2025'."""
+    if len(ym) >= 7:
+        mm = ym[5:7]
+        yyyy = ym[:4]
+        return f"{MONTH_NAMES_ES.get(mm, mm)} {yyyy}"
+    return ym
+
+# Keep MONTH_LABELS as a fallback dict that uses the dynamic function
+class _MonthLabels(dict):
+    def get(self, key, default=None):
+        return month_label(key) if key and len(key) >= 7 else (default or key)
+    def __getitem__(self, key):
+        return month_label(key)
+    def __contains__(self, key):
+        return key is not None and len(key) >= 7
+
+MONTH_LABELS = _MonthLabels()
+
+
+def set_col_widths(ws, widths):
+    for col_letter, width in widths.items():
+        ws.column_dimensions[col_letter].width = width
+
+
+def write_header_row(ws, row, headers, start_col=1):
+    for i, header in enumerate(headers):
+        cell = ws.cell(row=row, column=start_col + i, value=header)
+        cell.font = HEADER_FONT
+        cell.fill = HEADER_FILL
+        cell.alignment = Alignment(horizontal="center")
+
+
+def days_since(date_str, today):
+    try:
+        d = datetime.strptime(date_str, "%Y-%m-%d").date()
+        return max(0, (today - d).days)
+    except (ValueError, TypeError):
+        return 0
+
+
+def get_month(date_str):
+    return date_str[:7] if date_str and len(date_str) >= 7 else ""
+
+
+# ─── Tab: Sin Draft ───
+def build_sin_draft(wb, invoices, today, ctx=None):
+    ctx = ctx or {}
+    ws = wb.active
+    ws.title = "Sin Draft"
+    tier_invs = [i for i in invoices if i.get("tier") == "fully_pending"]
+    tier_invs.sort(key=lambda i: i.get("posting_date", ""))
+    fill = TIER_FILLS["fully_pending"]
+
+    set_col_widths(ws, {"A": 20, "B": 16, "C": 16, "D": 14, "E": 35, "F": 16, "G": 14})
+
+    total_amount = sum(i.get("invoice_amount", 0) for i in tier_invs)
+    title = f"SIN DRAFT — {ctx.get('store','')} {ctx.get('store_name','')} — {ctx.get('period','')}"
+    ws.cell(row=1, column=1, value=title).font = BOLD_14
+    ws.cell(row=2, column=1, value=f"{len(tier_invs)} facturas pendientes sin ningún draft de pago | Total: ${total_amount:,.2f} USD").font = BOLD_11
+
+    headers = ["No. Factura (Posted PI)", "Mes", "Fecha Posting", "No. Proveedor", "Proveedor", "Monto (USD)", "Días Pendiente"]
+    write_header_row(ws, 4, headers)
+    ws.freeze_panes = "A5"
+
+    row = 5
+    current_month = None
+    month_start_row = row
+
+    for inv in tier_invs:
+        month = get_month(inv.get("posting_date", ""))
+        if current_month and month != current_month:
+            # Month subtotal
+            ws.cell(row=row, column=1, value=f"Subtotal {MONTH_LABELS.get(current_month, current_month)}").font = SUBTOTAL_FONT
+            ws.cell(row=row, column=6, value=f"=SUM(F{month_start_row}:F{row - 1})").number_format = NUM_FMT
+            ws.cell(row=row, column=6).font = SUBTOTAL_FONT
+            for c in range(1, 8):
+                ws.cell(row=row, column=c).fill = SUBTOTAL_FILL
+            row += 1
+            month_start_row = row
+
+        current_month = month
+
+        ws.cell(row=row, column=1, value=inv.get("invoice_no", ""))
+        ws.cell(row=row, column=2, value=MONTH_LABELS.get(month, month))
+        ws.cell(row=row, column=3, value=inv.get("posting_date", ""))
+        ws.cell(row=row, column=4, value=inv.get("vendor_no", ""))
+        ws.cell(row=row, column=5, value=inv.get("vendor_name", ""))
+        ws.cell(row=row, column=6, value=inv.get("invoice_amount", 0)).number_format = NUM_FMT
+        ws.cell(row=row, column=7, value=days_since(inv.get("posting_date", ""), today))
+        for c in range(1, 8):
+            ws.cell(row=row, column=c).fill = fill
+        row += 1
+
+    # Last month subtotal
+    if current_month and tier_invs:
+        ws.cell(row=row, column=1, value=f"Subtotal {MONTH_LABELS.get(current_month, current_month)}").font = SUBTOTAL_FONT
+        ws.cell(row=row, column=6, value=f"=SUM(F{month_start_row}:F{row - 1})").number_format = NUM_FMT
+        ws.cell(row=row, column=6).font = SUBTOTAL_FONT
+        for c in range(1, 8):
+            ws.cell(row=row, column=c).fill = SUBTOTAL_FILL
+        row += 1
+
+    # Grand total
+    if tier_invs:
+        row += 1
+        ws.cell(row=row, column=1, value="TOTAL SIN DRAFT").font = BOLD_12
+        ws.cell(row=row, column=5, value=f"{len(tier_invs)} facturas").font = BOLD
+        ws.cell(row=row, column=6, value=round(total_amount, 2)).number_format = NUM_FMT
+        ws.cell(row=row, column=6).font = BOLD_12
+
+    return len(tier_invs)
+
+
+# ─── Tab: Con Draft ───
+def build_con_draft(wb, invoices, today, ctx=None):
+    ctx = ctx or {}
+    ws = wb.create_sheet("Con Draft")
+    tier_invs = [i for i in invoices if i.get("tier") == "draft_in_progress"]
+    tier_invs.sort(key=lambda i: i.get("posting_date", ""))
+    fill = TIER_FILLS["draft_in_progress"]
+
+    set_col_widths(ws, {"A": 20, "B": 16, "C": 16, "D": 14, "E": 35, "F": 16, "G": 18, "H": 14, "I": 16, "J": 16})
+
+    total_amount = sum(i.get("invoice_amount", 0) for i in tier_invs)
+    total_drafted = sum((i.get("multi_payment") or {}).get("total_payment_amount", 0) for i in tier_invs)
+    title = f"CON DRAFT (No Posteado) — {ctx.get('store','')} {ctx.get('store_name','')} — {ctx.get('period','')}"
+    ws.cell(row=1, column=1, value=title).font = BOLD_14
+    ws.cell(row=2, column=1, value=f"{len(tier_invs)} facturas con draft de pago creado | Total: ${total_amount:,.2f} USD | Drafted: ${total_drafted:,.2f} USD").font = BOLD_11
+
+    headers = ["No. Factura (Posted PI)", "Mes", "Fecha Posting", "No. Proveedor", "Proveedor", "Monto (USD)", "No. Multi-Payment", "Status MP", "Drafted (USD)", "Pendiente Neto"]
+    write_header_row(ws, 4, headers)
+    ws.freeze_panes = "A5"
+
+    row = 5
+    current_month = None
+    month_start_row = row
+
+    for inv in tier_invs:
+        month = get_month(inv.get("posting_date", ""))
+        mp = inv.get("multi_payment") or {}
+
+        if current_month and month != current_month:
+            ws.cell(row=row, column=1, value=f"Subtotal {MONTH_LABELS.get(current_month, current_month)}").font = SUBTOTAL_FONT
+            ws.cell(row=row, column=6, value=f"=SUM(F{month_start_row}:F{row - 1})").number_format = NUM_FMT
+            ws.cell(row=row, column=6).font = SUBTOTAL_FONT
+            ws.cell(row=row, column=9, value=f"=SUM(I{month_start_row}:I{row - 1})").number_format = NUM_FMT
+            ws.cell(row=row, column=9).font = SUBTOTAL_FONT
+            ws.cell(row=row, column=10, value=f"=SUM(J{month_start_row}:J{row - 1})").number_format = NUM_FMT
+            ws.cell(row=row, column=10).font = SUBTOTAL_FONT
+            for c in range(1, 11):
+                ws.cell(row=row, column=c).fill = SUBTOTAL_FILL
+            row += 1
+            month_start_row = row
+
+        current_month = month
+
+        ws.cell(row=row, column=1, value=inv.get("invoice_no", ""))
+        ws.cell(row=row, column=2, value=MONTH_LABELS.get(month, month))
+        ws.cell(row=row, column=3, value=inv.get("posting_date", ""))
+        ws.cell(row=row, column=4, value=inv.get("vendor_no", ""))
+        ws.cell(row=row, column=5, value=inv.get("vendor_name", ""))
+        ws.cell(row=row, column=6, value=inv.get("invoice_amount", 0)).number_format = NUM_FMT
+        ws.cell(row=row, column=7, value=mp.get("mp_no", ""))
+        ws.cell(row=row, column=8, value=mp.get("status", ""))
+        ws.cell(row=row, column=9, value=mp.get("total_payment_amount", 0)).number_format = NUM_FMT
+        ws.cell(row=row, column=10, value=mp.get("net_pending", inv.get("invoice_amount", 0))).number_format = NUM_FMT
+        for c in range(1, 11):
+            ws.cell(row=row, column=c).fill = fill
+        row += 1
+
+    # Last month subtotal
+    if current_month and tier_invs:
+        ws.cell(row=row, column=1, value=f"Subtotal {MONTH_LABELS.get(current_month, current_month)}").font = SUBTOTAL_FONT
+        ws.cell(row=row, column=6, value=f"=SUM(F{month_start_row}:F{row - 1})").number_format = NUM_FMT
+        ws.cell(row=row, column=6).font = SUBTOTAL_FONT
+        ws.cell(row=row, column=9, value=f"=SUM(I{month_start_row}:I{row - 1})").number_format = NUM_FMT
+        ws.cell(row=row, column=9).font = SUBTOTAL_FONT
+        ws.cell(row=row, column=10, value=f"=SUM(J{month_start_row}:J{row - 1})").number_format = NUM_FMT
+        ws.cell(row=row, column=10).font = SUBTOTAL_FONT
+        for c in range(1, 11):
+            ws.cell(row=row, column=c).fill = SUBTOTAL_FILL
+        row += 1
+
+    # Grand total
+    if tier_invs:
+        row += 1
+        ws.cell(row=row, column=1, value="TOTAL CON DRAFT").font = BOLD_12
+        ws.cell(row=row, column=5, value=f"{len(tier_invs)} facturas").font = BOLD
+        ws.cell(row=row, column=6, value=round(total_amount, 2)).number_format = NUM_FMT
+        ws.cell(row=row, column=6).font = BOLD_12
+        ws.cell(row=row, column=9, value=round(total_drafted, 2)).number_format = NUM_FMT
+        ws.cell(row=row, column=9).font = BOLD_12
+
+    return len(tier_invs)
+
+
+# ─── Tab: Pago Parcial ───
+def build_pago_parcial(wb, invoices, today, ctx=None):
+    ctx = ctx or {}
+    ws = wb.create_sheet("Pago Parcial")
+    tier_invs = [i for i in invoices if i.get("tier") == "in_journal"]
+    tier_invs.sort(key=lambda i: i.get("posting_date", ""))
+    fill = TIER_FILLS["in_journal"]
+
+    set_col_widths(ws, {"A": 20, "B": 16, "C": 16, "D": 14, "E": 35, "F": 16, "G": 18, "H": 14, "I": 16, "J": 16})
+
+    total_amount = sum(i.get("invoice_amount", 0) for i in tier_invs)
+    total_drafted = sum((i.get("multi_payment") or {}).get("total_payment_amount", 0) for i in tier_invs)
+    total_net = sum((i.get("multi_payment") or {}).get("net_pending", 0) for i in tier_invs)
+    title = f"PAGO PARCIAL (Transferred) — {ctx.get('store','')} {ctx.get('store_name','')} — {ctx.get('period','')}"
+    ws.cell(row=1, column=1, value=title).font = BOLD_14
+    ws.cell(row=2, column=1, value=f"{len(tier_invs)} facturas con pago parcial | Total: ${total_amount:,.2f} USD | Pagado: ${total_drafted:,.2f} | Pendiente: ${total_net:,.2f}").font = BOLD_11
+
+    headers = ["No. Factura (Posted PI)", "Mes", "Fecha Posting", "No. Proveedor", "Proveedor", "Monto (USD)", "No. Multi-Payment", "Status MP", "Pagado (USD)", "Pendiente Neto"]
+    write_header_row(ws, 4, headers)
+    ws.freeze_panes = "A5"
+
+    row = 5
+    current_month = None
+    month_start_row = row
+
+    for inv in tier_invs:
+        month = get_month(inv.get("posting_date", ""))
+        mp = inv.get("multi_payment") or {}
+
+        if current_month and month != current_month:
+            ws.cell(row=row, column=1, value=f"Subtotal {MONTH_LABELS.get(current_month, current_month)}").font = SUBTOTAL_FONT
+            ws.cell(row=row, column=6, value=f"=SUM(F{month_start_row}:F{row - 1})").number_format = NUM_FMT
+            ws.cell(row=row, column=6).font = SUBTOTAL_FONT
+            ws.cell(row=row, column=9, value=f"=SUM(I{month_start_row}:I{row - 1})").number_format = NUM_FMT
+            ws.cell(row=row, column=9).font = SUBTOTAL_FONT
+            ws.cell(row=row, column=10, value=f"=SUM(J{month_start_row}:J{row - 1})").number_format = NUM_FMT
+            ws.cell(row=row, column=10).font = SUBTOTAL_FONT
+            for c in range(1, 11):
+                ws.cell(row=row, column=c).fill = SUBTOTAL_FILL
+            row += 1
+            month_start_row = row
+
+        current_month = month
+
+        ws.cell(row=row, column=1, value=inv.get("invoice_no", ""))
+        ws.cell(row=row, column=2, value=MONTH_LABELS.get(month, month))
+        ws.cell(row=row, column=3, value=inv.get("posting_date", ""))
+        ws.cell(row=row, column=4, value=inv.get("vendor_no", ""))
+        ws.cell(row=row, column=5, value=inv.get("vendor_name", ""))
+        ws.cell(row=row, column=6, value=inv.get("invoice_amount", 0)).number_format = NUM_FMT
+        ws.cell(row=row, column=7, value=mp.get("mp_no", ""))
+        ws.cell(row=row, column=8, value=mp.get("status", ""))
+        ws.cell(row=row, column=9, value=mp.get("total_payment_amount", 0)).number_format = NUM_FMT
+        ws.cell(row=row, column=10, value=mp.get("net_pending", inv.get("invoice_amount", 0))).number_format = NUM_FMT
+        for c in range(1, 11):
+            ws.cell(row=row, column=c).fill = fill
+        row += 1
+
+    # Last month subtotal
+    if current_month and tier_invs:
+        ws.cell(row=row, column=1, value=f"Subtotal {MONTH_LABELS.get(current_month, current_month)}").font = SUBTOTAL_FONT
+        ws.cell(row=row, column=6, value=f"=SUM(F{month_start_row}:F{row - 1})").number_format = NUM_FMT
+        ws.cell(row=row, column=6).font = SUBTOTAL_FONT
+        ws.cell(row=row, column=9, value=f"=SUM(I{month_start_row}:I{row - 1})").number_format = NUM_FMT
+        ws.cell(row=row, column=9).font = SUBTOTAL_FONT
+        ws.cell(row=row, column=10, value=f"=SUM(J{month_start_row}:J{row - 1})").number_format = NUM_FMT
+        ws.cell(row=row, column=10).font = SUBTOTAL_FONT
+        for c in range(1, 11):
+            ws.cell(row=row, column=c).fill = SUBTOTAL_FILL
+        row += 1
+
+    # Grand total
+    if tier_invs:
+        row += 1
+        ws.cell(row=row, column=1, value="TOTAL PAGO PARCIAL").font = BOLD_12
+        ws.cell(row=row, column=5, value=f"{len(tier_invs)} facturas").font = BOLD
+        ws.cell(row=row, column=6, value=round(total_amount, 2)).number_format = NUM_FMT
+        ws.cell(row=row, column=6).font = BOLD_12
+        ws.cell(row=row, column=9, value=round(total_drafted, 2)).number_format = NUM_FMT
+        ws.cell(row=row, column=9).font = BOLD_12
+        ws.cell(row=row, column=10, value=round(total_net, 2)).number_format = NUM_FMT
+        ws.cell(row=row, column=10).font = BOLD_12
+
+    return len(tier_invs)
+
+
+# ─── Main ───
+def main():
+    if len(sys.argv) < 3:
+        print("Usage: python3 generate-fq28-pending-xlsx.py <input.json> <output.xlsx>", file=sys.stderr)
+        sys.exit(1)
+
+    input_path = Path(sys.argv[1])
+    output_path = Path(sys.argv[2])
+
+    if not input_path.exists():
+        print(f"Error: Input not found: {input_path}", file=sys.stderr)
+        sys.exit(1)
+
+    with open(input_path, "r", encoding="utf-8") as f:
+        data = json.load(f)
+
+    invoices = data.get("invoices", [])
+    today = date.today()
+    if data.get("report_date"):
+        try:
+            today = datetime.strptime(data["report_date"], "%Y-%m-%d").date()
+        except ValueError:
+            pass
+
+    store = data.get("store", "")
+    store_name = data.get("store_name", store)
+    dr = data.get("date_range", {})
+    period = ""
+    if dr.get("start") and dr.get("end"):
+        s_label = month_label(dr["start"][:7])
+        e_label = month_label(dr["end"][:7])
+        period = f"{s_label}" if s_label == e_label else f"{s_label} — {e_label}"
+
+    header_ctx = {"store": store, "store_name": store_name, "period": period}
+
+    wb = Workbook()
+    n_sin = build_sin_draft(wb, invoices, today, header_ctx)
+    n_draft = build_con_draft(wb, invoices, today, header_ctx)
+    n_parcial = build_pago_parcial(wb, invoices, today, header_ctx)
+
+    wb.save(str(output_path))
+    result = {
+        "file": str(output_path),
+        "sheets": {"sin_draft": n_sin, "con_draft": n_draft, "pago_parcial": n_parcial},
+        "total": len(invoices),
+    }
+    print(json.dumps(result))
+
+
+if __name__ == "__main__":
+    main()