quints 0.1.0__py3-none-any.whl

quints/invoice/template.typ

@@ -0,0 +1,140 @@
+// quints invoice template — data-driven (reads data.json), two modes.
+#let d = json("data.json")
+#let L = d.labels
+#let accent = rgb(d.brand.accent)
+#let display = (d.brand.font_display, d.brand.font, "Liberation Sans", "Arial")
+#let dstretch = d.brand.display_stretch * 1%
+#let muted = luma(105)
+#let lines(a) = a.join(linebreak())
+#let qrbill = d.payment.type == "qrbill"
+
+#set document(title: L.invoice + " " + d.invoice.number, author: d.issuer.name)
+#set page(
+  paper: "a4",
+  margin: (x: 20mm, top: 18mm, bottom: if qrbill { 108mm } else { 24mm }),
+)
+#set text(font: (d.brand.font, "Liberation Sans", "Arial"), size: 10pt, fill: luma(20))
+#set par(justify: false, leading: 0.62em)
+
+// ── Header: wordmark left, issuer identity right (Art. 26 Abs. 2 lit. a MWSTG) ─
+#grid(columns: (1fr, auto),
+  align(left + top,
+    if d.brand.logo != none {
+      image(d.brand.logo, height: 12mm)
+    } else {
+      text(font: display, stretch: dstretch, size: 15pt, weight: "bold", fill: accent)[#d.issuer.name]
+    }
+  ),
+  align(right + top)[
+    #set text(size: 8pt, fill: muted)
+    #set par(leading: 0.5em)
+    #text(weight: "semibold", fill: luma(60))[#d.issuer.name] \
+    #lines(d.issuer.address) \
+    #d.issuer.vat_id
+    #if d.issuer.email != none [ \ #link("mailto:" + d.issuer.email)[#d.issuer.email] ]
+    #if d.issuer.phone != none [ \ #d.issuer.phone ]
+  ],
+)
+
+// ── Recipient (right, window-envelope position) ───────────────────────
+#place(top + left, dx: 112mm, dy: 34mm, block(width: 78mm)[
+  #set text(size: 10pt)
+  #strong(d.customer.name) \
+  #lines(d.customer.address)
+  #if d.customer.country != d.issuer.country [ \ #d.customer.country ]
+  #if d.customer.vat_id != none [ \ #d.customer.vat_id ]
+])
+
+#v(38mm)
+
+// ── Title + meta ──────────────────────────────────────────────────────
+#text(font: display, stretch: dstretch, size: 20pt, weight: "semibold", fill: accent)[#L.invoice]
+#v(3mm)
+#grid(columns: (auto, auto), column-gutter: 8mm, row-gutter: 3pt,
+  text(fill: muted)[#L.invoice_no], text(weight: "bold")[#d.invoice.number],
+  text(fill: muted)[#L.date], [#d.invoice.issue_date],
+  ..(if d.invoice.supply != "" { (text(fill: muted)[#L.supply], [#d.invoice.supply]) } else { () }),
+)
+#v(7mm)
+
+// ── Line items ────────────────────────────────────────────────────────
+#table(
+  columns: (auto, 1fr, auto, auto, auto),
+  inset: (x: 4pt, y: 6.5pt),
+  align: (x, y) => if x >= 2 { right } else { left },
+  stroke: none,
+  table.hline(stroke: 0.7pt + accent),
+  table.header(
+    text(size: 9pt, fill: accent, weight: "bold")[#L.pos],
+    text(size: 9pt, fill: accent, weight: "bold")[#L.description],
+    text(size: 9pt, fill: accent, weight: "bold")[#L.qty],
+    text(size: 9pt, fill: accent, weight: "bold")[#L.unit_price],
+    text(size: 9pt, fill: accent, weight: "bold")[#L.line_total],
+  ),
+  table.hline(stroke: 0.7pt + accent),
+  ..d.items.map(it => (
+    [#it.pos],
+    [#it.description],
+    [#it.quantity#if it.unit != "" [ #it.unit]],
+    [#it.unit_price],
+    [#it.total],
+  )).flatten(),
+  table.hline(stroke: 0.4pt + luma(210)),
+)
+
+// ── Totals ────────────────────────────────────────────────────────────
+#v(3mm)
+#align(right, block(width: 72mm)[
+  #let row(l, v, strong: false) = grid(
+    columns: (1fr, auto), column-gutter: 6mm,
+    if strong { text(weight: "bold")[#l] } else { text(fill: muted)[#l] },
+    if strong { text(weight: "bold")[#v] } else [#v],
+  )
+  #row(L.subtotal, [#d.currency #d.totals.subtotal])
+  #if not d.totals.export {
+    v(2.2pt)
+    row(L.vat + " " + d.totals.vat_rate + "%", [#d.currency #d.totals.vat_amount])
+  }
+  #if d.totals.show_rounding {
+    v(2.2pt)
+    row(L.rounding, [#d.currency #d.totals.rounding])
+  }
+  #v(4pt)
+  #line(length: 100%, stroke: 0.5pt + luma(180))
+  #v(4pt)
+  #row(L.grand_total, text(fill: accent)[#d.currency #d.totals.grand_total], strong: true)
+])
+
+// ── Export legal notes ────────────────────────────────────────────────
+#if d.totals.export {
+  v(6mm)
+  block(fill: luma(246), inset: 8pt, radius: 3pt, width: 100%)[
+    #text(size: 9pt)[#L.export_note]
+    #if d.reverse_charge [ \ #text(size: 9pt, fill: muted)[#L.reverse_charge] ]
+  ]
+}
+
+// ── Payment terms + notes ─────────────────────────────────────────────
+#if d.terms != none or d.notes.len() > 0 {
+  v(6mm)
+  set text(size: 9pt, fill: muted)
+  if d.terms != none [ #d.terms \ ]
+  for n in d.notes [ #n \ ]
+}
+
+// ── Payment ───────────────────────────────────────────────────────────
+#if qrbill {
+  // Full-width Swiss QR-bill payment part, flush at the page bottom.
+  place(bottom + left, dx: -20mm, dy: 108mm, image("qrbill.svg", width: 210mm))
+} else {
+  v(8mm)
+  block(stroke: 0.6pt + accent, inset: 10pt, radius: 3pt, width: 100%)[
+    #text(fill: accent, weight: "bold")[#L.payment_to] \
+    #v(2pt)
+    #grid(columns: (auto, 1fr), column-gutter: 6mm, row-gutter: 3pt,
+      text(fill: muted)[IBAN], [#d.payment.iban],
+      ..(if d.payment.bic != none { (text(fill: muted)[BIC], [#d.payment.bic]) } else { () }),
+      text(fill: muted)[#L.reference], [#d.payment.reference],
+    )
+  ]
+}

quints/invoice/vatid.py

@@ -0,0 +1,48 @@
+"""Offline VAT-number validation via python-stdnum (per-country checksums).
+
+Strategy: try the country's national module (stdnum.<cc>.vat or its alias,
+e.g. ee.kmkr) and, for alpha-prefixed numbers, the EU-wide dispatcher. The
+number is accepted if any applicable validator passes; countries without a
+VAT module (e.g. US — no VAT regime) are accepted as-is. Online checks
+(VIES/UID register) are deliberately out of scope here.
+"""
+
+from __future__ import annotations
+
+from stdnum.eu import vat as euvat
+from stdnum.exceptions import ValidationError
+from stdnum.util import get_cc_module
+
+_EU_PREFIX = {"GR": "EL"}  # country code → VAT prefix that differs
+
+
+def validate(vat_id: str, country: str) -> None:
+    """Raise ValueError if `vat_id` fails every applicable checksum for `country`."""
+    cc = country.upper()
+    compact = "".join(vat_id.split()).upper()
+    errors: list[str] = []
+
+    national = get_cc_module(cc.lower(), "vat")
+    if national is not None:
+        for candidate in (vat_id, _strip_prefix(compact, cc)):
+            try:
+                national.validate(candidate)
+                return
+            except ValidationError as e:
+                errors.append(str(e))
+
+    if compact[:2] == _EU_PREFIX.get(cc, cc) and compact[:2].isalpha():
+        try:
+            euvat.validate(compact)
+            return
+        except ValidationError as e:
+            errors.append(str(e))
+
+    if not errors:  # no validator knows this country → accept
+        return
+    raise ValueError(f"invalid VAT number {vat_id!r} for country {country}: {errors[0]}")
+
+
+def _strip_prefix(compact: str, cc: str) -> str:
+    prefix = _EU_PREFIX.get(cc, cc)
+    return compact[2:] if compact.startswith(prefix) else compact

quints/invoice/verify.py

@@ -0,0 +1,60 @@
+"""Cross-check a rendered invoice against its ledger transaction."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from decimal import Decimal
+from pathlib import Path
+
+from beancount.core import data
+
+from .. import config, ledger
+from .model import Invoice, Totals
+
+
+@dataclass
+class CrossCheck:
+    found: bool
+    date: str | None = None
+    ledger_total: Decimal | None = None
+    invoice_total: Decimal | None = None
+    ok: bool = False
+    date_ok: bool = True  # booking date equals the invoice issue date
+
+
+def cross_check(
+    ledger_path: Path, inv: Invoice, totals: Totals, tol: Decimal = Decimal("0.005")
+) -> CrossCheck:
+    """Match by invoice id (metadata `invoice:` or a `^<number>` link); compare
+    the invoice grand total to the income + output VAT across ALL matching
+    transactions (the payment-clearing entry may carry the same link — its
+    lack of income legs makes it contribute zero)."""
+    cfg = config.get()
+    entries, _ = ledger.load_entries(ledger_path)
+    matches = []
+    for e in entries:
+        if not isinstance(e, data.Transaction):
+            continue
+        if inv.number == (e.meta or {}).get("invoice") or inv.number in (e.links or set()):
+            matches.append(e)
+    if not matches:
+        return CrossCheck(found=False)
+
+    expected = Decimal("0")
+    booking = None  # the transaction that carries the income legs
+    for e in matches:
+        for p in e.postings:
+            if p.units.currency != inv.currency:
+                continue
+            if p.account.startswith(cfg.income_prefix) or p.account == cfg.output_vat:
+                expected += -p.units.number
+                booking = booking or e
+    booking = booking or matches[0]
+    return CrossCheck(
+        found=True,
+        date=str(booking.date),
+        ledger_total=expected,
+        invoice_total=totals.grand_total,
+        ok=abs(expected - totals.grand_total) <= tol,
+        date_ok=booking.date == inv.issue_date,
+    )