@fullqueso/mcp-bc-gastos 1.14.2 → 1.19.0

package/scripts/generate-pending-sales-invoices-xlsx.py

@@ -0,0 +1,372 @@
+#!/usr/bin/env python3
+"""
+Generate Pending Sales Invoices Excel — Dynamic
+3 tabs: Sin Draft, Con Draft, Pago Parcial
+Each tab lists posted sales invoice numbers for auditing.
+
+Usage: python3 generate-pending-sales-invoices-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="2E75B6", end_color="2E75B6", fill_type="solid")
+HEADER_FONT = Font(bold=True, color="FFFFFF", size=10)
+SUBTOTAL_FILL = PatternFill(start_color="D6E4F0", end_color="D6E4F0", 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
+
+
+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": 22, "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 de venta pendientes sin draft de cobro | Total: ${total_amount:,.2f} USD").font = BOLD_11
+
+    headers = ["No. Factura (Posted SI)", "Mes", "Fecha Posting", "No. Cliente", "Cliente", "Monto (USD)", "Dias 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:
+            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("customer_no", ""))
+        ws.cell(row=row, column=5, value=inv.get("customer_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
+
+    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
+
+    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": 22, "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 cobro | Total: ${total_amount:,.2f} USD | Drafted: ${total_drafted:,.2f} USD").font = BOLD_11
+
+    headers = ["No. Factura (Posted SI)", "Mes", "Fecha Posting", "No. Cliente", "Cliente", "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("customer_no", ""))
+        ws.cell(row=row, column=5, value=inv.get("customer_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
+
+    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
+
+    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": 22, "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 cobro parcial | Total: ${total_amount:,.2f} USD | Cobrado: ${total_drafted:,.2f} | Pendiente: ${total_net:,.2f}").font = BOLD_11
+
+    headers = ["No. Factura (Posted SI)", "Mes", "Fecha Posting", "No. Cliente", "Cliente", "Monto (USD)", "No. Multi-Payment", "Status MP", "Cobrado (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("customer_no", ""))
+        ws.cell(row=row, column=5, value=inv.get("customer_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
+
+    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
+
+    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-pending-sales-invoices-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()

package/scripts/report-pending-invoices.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+/**
+ * Reporte dinámico: Posted Purchase Invoices Pendientes
+ * 3 tabs Excel: Sin Draft, Con Draft, Pago Parcial
+ *
+ * Usage:
+ *   node scripts/report-pending-invoices.js --store FQ01 --from 2025-12 --to 2026-01
+ *   node scripts/report-pending-invoices.js --store FQ28 --from 2025-05 --to 2025-07
+ *   node scripts/report-pending-invoices.js --store all --from 2026-02 --to 2026-02
+ */
+
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { writeFileSync, unlinkSync, existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { parseArgs } from 'node:util';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PROJECT_ROOT = dirname(__dirname);
+
+// ── Parse CLI args ──
+const { values: args } = parseArgs({
+  options: {
+    store: { type: 'string', short: 's' },
+    from:  { type: 'string', short: 'f' },
+    to:    { type: 'string', short: 't' },
+    out:   { type: 'string', short: 'o' },
+  },
+});
+
+if (!args.store || !args.from || !args.to) {
+  console.error('Usage: node scripts/report-pending-invoices.js --store FQ01 --from 2025-12 --to 2026-01');
+  console.error('  --store  FQ01 | FQ28 | FQ88 | all');
+  console.error('  --from   YYYY-MM (mes inicio)');
+  console.error('  --to     YYYY-MM (mes fin)');
+  console.error('  --out    (opcional) ruta Excel de salida');
+  process.exit(1);
+}
+
+// ── Validate month format and build date range ──
+function parseMonth(ym) {
+  const m = ym.match(/^(\d{4})-(\d{2})$/);
+  if (!m) { console.error(`Formato inválido: "${ym}". Usar YYYY-MM`); process.exit(1); }
+  return { year: parseInt(m[1]), month: parseInt(m[2]), raw: ym };
+}
+
+function lastDayOfMonth(year, month) {
+  return new Date(year, month, 0).getDate();
+}
+
+const fromM = parseMonth(args.from);
+const toM = parseMonth(args.to);
+const DATE_START = `${fromM.raw}-01`;
+const DATE_END = `${toM.raw}-${lastDayOfMonth(toM.year, toM.month)}`;
+
+// ── Load env & modules ──
+const envPath = join(PROJECT_ROOT, '.env');
+if (existsSync(envPath)) {
+  const dotenv = await import('dotenv');
+  dotenv.config({ path: envPath });
+}
+
+const { BCClient } = await import('../lib/bc-client.js');
+const { resolveStores } = await import('../config/company-config.js');
+
+const storeParam = args.store.toUpperCase();
+const stores = resolveStores(storeParam === 'ALL' ? null : [storeParam]);
+const bcClient = new BCClient();
+
+// ── Process each store ──
+async function processStore(storeInfo) {
+  const companyId = storeInfo.companyId;
+  const code = storeInfo.code;
+
+  const ledgerUrl = bcClient.buildBetaApiUrl(companyId, 'vendorLedgerEntries', {
+    $filter: `open eq true and documentType eq 'Invoice' and postingDate ge ${DATE_START} and postingDate le ${DATE_END}`,
+    $select: 'entryNumber,documentNumber,vendorNumber,postingDate,amount,amountLocalCurrency,currencyCode,description',
+  });
+
+  const mpUrl = bcClient.buildMultiPaymentApiUrl(companyId, 'purchMultiPaymentHeaders', {
+    $filter: "status ne 'Posted'",
+    $select: 'no,invoiceNo,vendorNo,vendorName,invoiceAmount,remainingAmount,totalPaymentAmount,status,postingDate,currencyCode',
+  });
+
+  const [openInvoices, mpHeaders, exchangeRates] = await Promise.all([
+    bcClient.apiCallAllPages(ledgerUrl),
+    bcClient.apiCallAllPages(mpUrl),
+    bcClient.getExchangeRates(code),
+  ]);
+
+  console.error(`[${code}] ${openInvoices.length} open invoices, ${mpHeaders.length} PMP headers`);
+
+  // Build PMP lookup
+  const mpByInvoice = {};
+  const vendorNames = {};
+  for (const mp of mpHeaders) {
+    if (!mpByInvoice[mp.invoiceNo]) mpByInvoice[mp.invoiceNo] = [];
+    mpByInvoice[mp.invoiceNo].push(mp);
+    if (mp.vendorNo && mp.vendorName) vendorNames[mp.vendorNo] = mp.vendorName;
+  }
+
+  // Fetch PMP lines in bulk
+  const linesByMp = {};
+  if (mpHeaders.length > 0) {
+    const mpNos = new Set(mpHeaders.map((mp) => mp.no));
+    const linesParams = {
+      $select: 'documentNo,lineNo,paymentMethod,amountLCY,currencyCode,bankAccountNo,referenceNo,description',
+    };
+    if (mpHeaders.length <= 50) {
+      linesParams.$filter = [...mpNos].map((no) => `documentNo eq '${no}'`).join(' or ');
+    }
+    const allLinesUrl = bcClient.buildMultiPaymentApiUrl(companyId, 'purchMultiPaymentLines', linesParams);
+    const allLines = await bcClient.apiCallAllPages(allLinesUrl);
+    for (const line of allLines) {
+      if (mpNos.has(line.documentNo)) {
+        if (!linesByMp[line.documentNo]) linesByMp[line.documentNo] = [];
+        linesByMp[line.documentNo].push(line);
+      }
+    }
+  }
+
+  // Compute USD for each PMP
+  const mpUsdInfo = {};
+  for (const mp of mpHeaders) {
+    mpUsdInfo[mp.no] = computeMpUsd(bcClient, mp, linesByMp[mp.no] || [], exchangeRates);
+  }
+
+  // Classify invoices
+  const invoices = [];
+  for (const inv of openInvoices) {
+    const docNo = inv.documentNumber;
+    const amountUsd = round2(Math.abs(inv.amountLocalCurrency || 0));
+    const mps = mpByInvoice[docNo] || [];
+
+    let tier, multiPayment = null;
+
+    if (mps.length === 0) {
+      tier = 'fully_pending';
+    } else {
+      let totalDraftedUsd = 0;
+      for (const mp of mps) totalDraftedUsd += mpUsdInfo[mp.no].usd;
+      totalDraftedUsd = round2(totalDraftedUsd);
+      const hasTransferred = mps.some((mp) => mp.status === 'Transferred');
+      tier = hasTransferred ? 'in_journal' : 'draft_in_progress';
+      multiPayment = {
+        mp_no: mps[0].no,
+        status: mps[0].status,
+        total_payment_amount: totalDraftedUsd,
+        net_pending: round2(Math.max(0, amountUsd - totalDraftedUsd)),
+      };
+      if (mps.length > 1) {
+        multiPayment.additional_mps = mps.slice(1).map((mp) => ({
+          mp_no: mp.no, status: mp.status, total_payment_amount: mpUsdInfo[mp.no].usd,
+        }));
+      }
+    }
+
+    invoices.push({
+      invoice_no: docNo,
+      vendor_no: inv.vendorNumber,
+      vendor_name: vendorNames[inv.vendorNumber] || inv.description || inv.vendorNumber,
+      posting_date: inv.postingDate,
+      invoice_amount: amountUsd,
+      currency_code: inv.currencyCode || 'USD',
+      tier,
+      multi_payment: multiPayment,
+    });
+  }
+
+  invoices.sort((a, b) => a.posting_date.localeCompare(b.posting_date));
+  return { store: code, store_name: storeInfo.name, invoices };
+}
+
+// ── Helpers ──
+function round2(n) { return Math.round(n * 100) / 100; }
+
+function computeMpUsd(bcClient, mp, lines, exchangeRates) {
+  const rateInfo = bcClient.getExchangeRateForDate(exchangeRates, mp.postingDate);
+  const rate = rateInfo ? rateInfo.rate : null;
+  if (lines.length === 0) {
+    if (rate) return { usd: round2((mp.totalPaymentAmount || 0) / rate), rate };
+    return { usd: round2(mp.totalPaymentAmount || 0), rate: null };
+  }
+  if (lines.some((l) => l.currencyCode === 'VES') && !rate) {
+    return { usd: round2(mp.totalPaymentAmount || 0), rate: null };
+  }
+  let usdTotal = 0;
+  for (const line of lines) {
+    const amount = line.amountLCY || 0;
+    usdTotal += line.currencyCode === 'VES' ? amount / rate : amount;
+  }
+  return { usd: round2(usdTotal), rate };
+}
+
+// ── Main ──
+console.error(`[report] Stores: ${stores.map(s => s.code).join(', ')} | Period: ${DATE_START} → ${DATE_END}`);
+
+const results = await Promise.all(stores.map(processStore));
+
+// Merge all invoices (for multi-store) or use single result
+const allInvoices = results.flatMap(r => r.invoices);
+const storeLabel = results.length === 1 ? results[0].store : 'ALL';
+const storeName = results.length === 1 ? results[0].store_name : 'Todas las tiendas';
+
+const counts = { sin_draft: 0, con_draft: 0, pago_parcial: 0 };
+for (const inv of allInvoices) {
+  if (inv.tier === 'fully_pending') counts.sin_draft++;
+  else if (inv.tier === 'draft_in_progress') counts.con_draft++;
+  else if (inv.tier === 'in_journal') counts.pago_parcial++;
+}
+
+console.error(`[report] Total: ${allInvoices.length} invoices | Sin Draft=${counts.sin_draft}, Con Draft=${counts.con_draft}, Pago Parcial=${counts.pago_parcial}`);
+
+// Write JSON
+const reportDate = new Date().toISOString().substring(0, 10);
+const jsonData = {
+  store: storeLabel,
+  store_name: storeName,
+  report_date: reportDate,
+  date_range: { start: DATE_START, end: DATE_END },
+  invoices: allInvoices,
+};
+
+const ts = Date.now();
+const jsonPath = `/tmp/pending_${storeLabel}_${ts}.json`;
+writeFileSync(jsonPath, JSON.stringify(jsonData, null, 2), 'utf-8');
+
+// Generate Excel
+const periodSlug = `${args.from.replace('-', '')}-${args.to.replace('-', '')}`;
+const defaultOut = join(process.env.HOME || '/tmp', 'Downloads', `${storeLabel}_Pendientes_${periodSlug}_${reportDate.replace(/-/g, '')}.xlsx`);
+const outputPath = args.out ? args.out.replace(/^~/, process.env.HOME || '/tmp') : defaultOut;
+
+const scriptPath = join(PROJECT_ROOT, 'scripts', 'generate-pending-invoices-xlsx.py');
+const venvPython = join(process.env.HOME || '/tmp', 'mcp-venv', 'bin', 'python3');
+const pythonCmd = existsSync(venvPython) ? venvPython : 'python3';
+
+try {
+  const stdout = execSync(`"${pythonCmd}" "${scriptPath}" "${jsonPath}" "${outputPath}"`, {
+    timeout: 60000, stdio: ['pipe', 'pipe', 'pipe'], encoding: 'utf-8',
+  });
+  console.error(`[report] ✓ Excel: ${outputPath}`);
+  console.error(stdout);
+} catch (e) {
+  console.error(`[report] Error: ${e.message}`);
+  if (e.stderr) console.error(e.stderr);
+  process.exit(1);
+} finally {
+  try { unlinkSync(jsonPath); } catch (_) {}
+}