@fullqueso/mcp-bc-gastos 1.14.2 → 1.19.0

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()