quints 0.5.0__tar.gz → 0.7.0__tar.gz

{quints-0.5.0 → quints-0.7.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: quints
-Version: 0.5.0
-Summary: Swiss VAT & accounting toolkit for plain-text (beancount) books: MWST reports and quarterly settlement, Bezugsteuer helpers, BAZG daily FX rates, QR-bill invoicing, KMU statutory statements, and statement importers (UBS MT940, Wise, Stripe) that draft into a staging area
+Version: 0.7.0
+Summary: Swiss VAT & accounting toolkit for plain-text (beancount) books: MWST reports and quarterly settlement, Bezugsteuer helpers, BAZG daily FX rates, QR-bill invoicing, KMU statutory statements, and statement importers (UBS MT940, Yapeal, Wise, Stripe) that draft into a staging area
 License: GPL-2.0-only
 License-File: LICENSE
 Keywords: accounting,beancount,fava,invoice,kmu,mwst,plain-text-accounting,qr-bill,switzerland,vat
@@ -11,6 +11,7 @@ Requires-Dist: beancount>=3.2.0
 Requires-Dist: beangulp-mt940>=0.1.0
 Requires-Dist: beangulp-stripe>=0.1.0
 Requires-Dist: beangulp-wise[sca]>=0.1.0
+Requires-Dist: beangulp-yapeal>=0.1.0
 Requires-Dist: beanprice-bazg>=0.2.0
 Requires-Dist: fava>=1.30
 Requires-Dist: pydantic>=2.7
@@ -39,9 +40,10 @@ Everything a Swiss micro-company (GmbH, AG, or Einzelfirma) needs on top of bean
   (Art. 960 OR).
 - **QR-bill invoicing**: Swiss QR-bill (QRR) and SEPA (SCOR/RF) invoices as
   PDF/A via Typst, drafted straight into the ledger.
-- **Statement importers**: UBS (MT940), Wise, and Stripe statements draft into
-  a `staging/` area — idempotent re-imports, conversion merging, fee splitting,
-  open-invoice matching by QR reference — never directly into your books.
+- **Statement importers**: UBS (MT940), Yapeal, Wise, and Stripe statements
+  draft into a `staging/` area — idempotent re-imports, conversion merging,
+  fee splitting, open-invoice matching by QR reference — never directly into
+  your books.
 - **KMU statements**: statutory Bilanz/Erfolgsrechnung (OR Art. 959a/959b) by
   KMU Kontenrahmen code, English or German, terminal or PDF.
 - **Fava extension**: review panel inside the UI you already run.

{quints-0.5.0 → quints-0.7.0}/README.md

@@ -14,9 +14,10 @@ Everything a Swiss micro-company (GmbH, AG, or Einzelfirma) needs on top of bean
   (Art. 960 OR).
 - **QR-bill invoicing**: Swiss QR-bill (QRR) and SEPA (SCOR/RF) invoices as
   PDF/A via Typst, drafted straight into the ledger.
-- **Statement importers**: UBS (MT940), Wise, and Stripe statements draft into
-  a `staging/` area — idempotent re-imports, conversion merging, fee splitting,
-  open-invoice matching by QR reference — never directly into your books.
+- **Statement importers**: UBS (MT940), Yapeal, Wise, and Stripe statements
+  draft into a `staging/` area — idempotent re-imports, conversion merging,
+  fee splitting, open-invoice matching by QR reference — never directly into
+  your books.
 - **KMU statements**: statutory Bilanz/Erfolgsrechnung (OR Art. 959a/959b) by
   KMU Kontenrahmen code, English or German, terminal or PDF.
 - **Fava extension**: review panel inside the UI you already run.

quints-0.7.0/examples/statements/yapeal.csv

@@ -0,0 +1,4 @@
+Transaktions-ID,Belastung oder Gutschrift,Buchungs-Datum,Transaktions-Datum,Transaktions-Info,Betrag,Belastung (CHF),Gutschrift (CHF),Kontowährung,Saldo (CHF),Gegenpartei,IBAN Gegenpartei,Original Transaktionsbetrag,Transaktionswährung,Devisenkurs,Gebühr,Zahlungstyp,Letzte 4 der Kartennummer,Karteninhaber,Status der Spesen,Zahlungsreferenz,Eigene Notiz,Zahlungs-Notiz,Zahlung erfasst am,Zahlung genehmigt von,Zahlung genehmigt am,Kategorie,Karten Programm,usedTags,mentions,ultimateCreditorName,ultimateDebitorName
+e9839ff4-e419-432a-b553-801e13c7e8f1,DEBIT,05.01.2026,05.01.2026,Debit card payment,25.50,25.50,,CHF,-25.50,ACME Hosting Inc,CH9300762011623852957,25.50,CHF,,,,,,,,Subject Test,,,,general,,,,,,,
+f68eb96a-1776-4c4d-b099-12ef65be3b63,CREDIT,10.01.2026,10.01.2026,Invoice payment,1000.00,,1000.00,CHF,1000.00,Client AG,CH9300762011623852957,1000.00,CHF,,,,,,,,Subject Test,,,,general,,,,,,,
+a1b2c3d4-5678-90ab-cdef-1234567890ab,DEBIT,15.01.2026,15.01.2026,Monthly subscription,45.00,45.00,,CHF,-45.00,Swisscom,CH9300762011623852957,45.00,CHF,,,,,,,,Subject Test,,,,general,,,,,,,

{quints-0.5.0 → quints-0.7.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "quints"
-version = "0.5.0"
-description = "Swiss VAT & accounting toolkit for plain-text (beancount) books: MWST reports and quarterly settlement, Bezugsteuer helpers, BAZG daily FX rates, QR-bill invoicing, KMU statutory statements, and statement importers (UBS MT940, Wise, Stripe) that draft into a staging area"
+version = "0.7.0"
+description = "Swiss VAT & accounting toolkit for plain-text (beancount) books: MWST reports and quarterly settlement, Bezugsteuer helpers, BAZG daily FX rates, QR-bill invoicing, KMU statutory statements, and statement importers (UBS MT940, Yapeal, Wise, Stripe) that draft into a staging area"
 readme = "README.md"
 requires-python = ">=3.10"
 license = { text = "GPL-2.0-only" }
@@ -15,6 +15,7 @@ dependencies = [
     "beangulp-mt940>=0.1.0",
     "beangulp-stripe>=0.1.0",
     "beangulp-wise[sca]>=0.1.0",
+    "beangulp-yapeal>=0.1.0",
     "beanprice-bazg>=0.2.0",
     "fava>=1.30",
     "pydantic>=2.7",

{quints-0.5.0 → quints-0.7.0}/src/quints/cli.py

@@ -552,6 +552,27 @@ def fx_revalue(
     fx_mod.render(revaluations, at)
 
 
+@import_app.command("yapeal")
+def import_yapeal(
+    statement: Path = typer.Argument(..., help="Yapeal CSV statement file."),
+    out: Path = typer.Option(importing_mod.DEFAULT_STAGING, "--out", help="Staging directory."),
+    as_json: bool = typer.Option(False, "--json", help="Machine-readable output."),
+    file: Path = _file_option(),
+):
+    """Draft the Yapeal bank account's activity from a CSV statement."""
+    _require_ledger(file)
+    if not statement.exists():
+        typer.secho(f"ERROR: statement not found: {statement}", fg="red", err=True)
+        raise typer.Exit(1)
+    try:
+        result = importing_mod.run_yapeal(statement, file, out)
+    except ValueError as e:
+        typer.secho(f"ERROR: {e}", fg="red", err=True)
+        raise typer.Exit(1) from None
+
+    _report_import(result, as_json)
+
+
 @import_app.command("ubs")
 def import_ubs(
     statement: Path = typer.Argument(..., help="UBS MT940 statement file."),
@@ -927,7 +948,7 @@ def init(
     ),
     lang: str | None = typer.Option(None, "--lang", "-l", help="Report language: en or de."),
     importers: str | None = typer.Option(
-        None, "--importers", help="Comma-separated: ubs, wise, stripe (default: none)."
+        None, "--importers", help="Comma-separated: ubs, yapeal, wise, stripe (default: none)."
     ),
     samples: bool = typer.Option(
         False, "--samples", help="Include a demo quarter of transactions."

{quints-0.5.0 → quints-0.7.0}/src/quints/config.py

@@ -87,6 +87,16 @@ class StripeImport:
         return dict(self.accounts)
 
 
+@dataclass(frozen=True)
+class YapealImport:
+    """[import.yapeal] — Yapeal CSV statements for one CHF bank account."""
+
+    account: str = "Assets:CH:GmbH:Current:Bank:CHF"
+    iban: str | None = None  # optional — matched against file content
+    currency: str = "CHF"
+    rules: tuple[tuple[str, str, str], ...] = ()
+
+
 @dataclass(frozen=True)
 class Config:
     # [entity]
@@ -120,6 +130,7 @@ class Config:
     report_language: str = "en"
     # [import.*] — statement importers (plan 2); None = not configured
     import_ubs: UbsImport | None = None
+    import_yapeal: YapealImport | None = None
     import_wise: WiseImport | None = None
     import_stripe: StripeImport | None = None
 
@@ -153,6 +164,14 @@ def _import_sections(raw: dict[str, object]) -> dict[str, object]:
             currency=ubs.get("currency", UbsImport.currency),
             rules=_rules(ubs),
         )
+    yapeal = imports.get("yapeal")
+    if isinstance(yapeal, dict):
+        updates["import_yapeal"] = YapealImport(
+            account=yapeal.get("account", YapealImport.account),
+            iban=yapeal.get("iban"),
+            currency=yapeal.get("currency", YapealImport.currency),
+            rules=_rules(yapeal),
+        )
     wise = imports.get("wise")
     if isinstance(wise, dict):
         updates["import_wise"] = WiseImport(

{quints-0.5.0 → quints-0.7.0}/src/quints/importing.py

@@ -40,6 +40,7 @@ from beangulp_stripe import Importer as StripeImporter
 from beangulp_stripe import StripeClient, StripeError
 from beangulp_wise import Importer as WiseImporter
 from beangulp_wise import ScaChallenge, WiseClient, merge_conversions
+from beangulp_yapeal import Importer as YapealImporter
 
 from . import config, ledger
 from . import receivables as recv_mod
@@ -48,7 +49,9 @@ LEGACY_WINDOW_DAYS = 3
 DEFAULT_STAGING = Path("staging")
 
 
-_Section = TypeVar("_Section", config.UbsImport, config.WiseImport, config.StripeImport)
+_Section = TypeVar(
+    "_Section", config.UbsImport, config.YapealImport, config.WiseImport, config.StripeImport
+)
 
 
 def _require(section: _Section | None, name: str, *keys: str) -> _Section:
@@ -76,6 +79,17 @@ def ubs_importer(cfg: config.Config | None = None) -> Mt940Importer:
     )
 
 
+def yapeal_importer(cfg: config.Config | None = None) -> YapealImporter:
+    s = _require((cfg or config.get()).import_yapeal, "yapeal")
+    return YapealImporter(
+        s.account,
+        iban=s.iban,
+        currency=s.currency,
+        meta_key="bank_ref",
+        payee_rules=s.rules,
+    )
+
+
 def wise_importer(cfg: config.Config | None = None) -> WiseImporter:
     s = _require((cfg or config.get()).import_wise, "wise")
     return WiseImporter(
@@ -195,8 +209,14 @@ def match_receivables(
         if number is None:
             continue
         postings = list(draft.postings)
-        if len(postings) == 2:
+        if len(postings) == 1:
+            # Only the cash leg is known — add the elided receivable clearing
+            # posting so the matched draft still balances.
+            postings.append(data.Posting(cfg.receivable, None, None, None, None, None))
+        elif len(postings) == 2:
             postings[1] = postings[1]._replace(account=cfg.receivable)
+        else:
+            continue  # ambiguous shape — leave the draft unmatched, still flagged for review
         meta = dict(draft.meta or {})
         meta["invoice"] = number
         matched = draft._replace(
@@ -224,6 +244,30 @@ def _write_staging(result: ImportResult, out_dir: Path, source: str) -> None:
     result.out_path = out
 
 
+def run_yapeal(
+    statement: Path,
+    ledger_path: Path,
+    out_dir: Path = DEFAULT_STAGING,
+    cfg: config.Config | None = None,
+) -> ImportResult:
+    cfg = cfg or config.get()
+    importer = yapeal_importer(cfg)
+    yapeal = _require(cfg.import_yapeal, "yapeal")
+    if not importer.identify(str(statement)):
+        raise ValueError(f"{statement} is not a Yapeal CSV statement for {yapeal.account}")
+
+    existing, _ = ledger.load_entries(ledger_path)
+    total = len(importer.extract(str(statement), existing=[]))
+    extracted = importer.extract(str(statement), existing=existing)
+
+    result = ImportResult(source=str(statement))
+    result.skipped_ref = total - len(extracted)
+    _split(result, extracted, _cash_pool(existing, {yapeal.account}))
+    match_receivables(result, existing, cfg)
+    _write_staging(result, out_dir, "yapeal")
+    return result
+
+
 def run_ubs(
     statement: Path,
     ledger_path: Path,

{quints-0.5.0 → quints-0.7.0}/src/quints/init.py

@@ -55,7 +55,7 @@ _IT_HOSTING = "Expenses:CH:GmbH:IT:Hosting"
 _PRIMARY_BANK = "Assets:CH:GmbH:Current:UBS:CHF"
 _WISE_EUR = "Assets:CH:GmbH:Current:Wise:EUR"
 
-_KNOWN_IMPORTERS = ("ubs", "wise", "stripe")
+_KNOWN_IMPORTERS = ("ubs", "yapeal", "wise", "stripe")
 
 
 @dataclass(frozen=True)
@@ -207,6 +207,9 @@ def _backbone(answers: Answers) -> list[_Account]:
         _Account(cfg.rounding_income, "6950", (oc,)),
         _Account(cfg.fx_gain, "6950", (oc,)),
     ]
+    if "yapeal" in answers.importers:
+        d = config.YapealImport()
+        accounts.append(_Account(_sub(d.account, c), "1020", (d.currency,)))
     if "wise" in answers.importers:
         for ccy, acct in config.WiseImport().accounts:
             accounts.append(_Account(_sub(acct, c), "1020", (ccy,)))
@@ -617,6 +620,20 @@ def _import_section(importer: str, answers: Answers) -> str:
                 "]",
             ]
         )
+    if importer == "yapeal":
+        d = config.YapealImport()
+        return "\n".join(
+            [
+                "# Yapeal CSV statements → staging/. '*' = booked as drafted, '!' = still",
+                "# needs a VAT decision + linked document before it reaches your books.",
+                "[import.yapeal]",
+                f'account = "{_sub(d.account, c)}"',
+                'iban = "CH9300762011623852957"   # optional — matched against file content',
+                "rules = [",
+                f'    [\'\\bacme\\b\', "{_sub("Assets:CH:GmbH:Receivable:Trade", c)}", "*"],',
+                "]",
+            ]
+        )
     if importer == "wise":
         d = config.WiseImport()
         rows = "\n".join(f'{ccy} = "{_sub(acct, c)}"' for ccy, acct in d.accounts)
@@ -665,6 +682,10 @@ _IMPORTER_USAGE = {
         "`quints import ubs <statement.mt940>` — the MT940 export from UBS "
         "e-banking; no credentials."
     ),
+    "yapeal": (
+        "`quints import yapeal <statement.csv>` — the CSV export from Yapeal "
+        "e-banking; no credentials."
+    ),
     "wise": (
         "`quints import wise --fetch --from <date> --to <date>` — needs "
         "`QUINTS_WISE_API_TOKEN` in `.env` (plus `QUINTS_WISE_PRIVATE_KEY` for "
@@ -683,7 +704,7 @@ def _agents_import_step(answers: Answers) -> str:
         return (
             "1. Draft bank/PSP activity into `staging/` with `quints import`. No\n"
             "   importer is configured yet — add an `[import.<name>]` section to\n"
-            "   `quints.toml` (supported: ubs, wise, stripe)."
+            "   `quints.toml` (supported: ubs, yapeal, wise, stripe)."
         )
     lines = ["1. Draft bank/PSP activity into `staging/`. Configured importers:"]
     lines += [f"   - {_IMPORTER_USAGE[name]}" for name in answers.importers]
@@ -711,6 +732,8 @@ def _agents_sample_section(answers: Answers) -> str:
     ]
     if "ubs" in answers.importers:
         lines.append("- [ ] `quints.toml` — the placeholder IBAN under `[import.ubs]`.")
+    if "yapeal" in answers.importers:
+        lines.append("- [ ] `quints.toml` — the placeholder IBAN under `[import.yapeal]`.")
     return "\n".join(lines) + "\n"
 
 

quints-0.7.0/src/quints/invoice/fonts/LICENSE

@@ -0,0 +1,102 @@
+Digitized data copyright (c) 2010 Google Corporation
+	with Reserved Font Arimo, Tinos and Cousine.
+Copyright (c) 2012 Red Hat, Inc.
+	with Reserved Font Name Liberation.
+
+This Font Software is licensed under the SIL Open Font License,
+Version 1.1.
+
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+
+PREAMBLE The goals of the Open Font License (OFL) are to stimulate
+worldwide development of collaborative font projects, to support the font
+creation efforts of academic and linguistic communities, and to provide
+a free and open framework in which fonts may be shared and improved in
+partnership with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves.
+The fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works.  The fonts and derivatives,
+however, cannot be released under any other type of license.  The
+requirement for fonts to remain under this license does not apply to
+any document created using the fonts or their derivatives.
+
+ 
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such.
+This may include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components
+as distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting ? in part or in whole ?
+any of the components of the Original Version, by changing formats or
+by porting the Font Software to a new environment.
+
+"Author" refers to any designer, engineer, programmer, technical writer
+or other person who contributed to the Font Software.
+
+
+PERMISSION & CONDITIONS
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,in
+   Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+   redistributed and/or sold with any software, provided that each copy
+   contains the above copyright notice and this license. These can be
+   included either as stand-alone text files, human-readable headers or
+   in the appropriate machine-readable metadata fields within text or
+   binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+   Name(s) unless explicit written permission is granted by the
+   corresponding Copyright Holder. This restriction only applies to the
+   primary font name as presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+   Software shall not be used to promote, endorse or advertise any
+   Modified Version, except to acknowledge the contribution(s) of the
+   Copyright Holder(s) and the Author(s) or with their explicit written
+   permission.
+
+5) The Font Software, modified or unmodified, in part or in whole, must
+   be distributed entirely under this license, and must not be distributed
+   under any other license. The requirement for fonts to remain under
+   this license does not apply to any document created using the Font
+   Software.
+
+
+ 
+TERMINATION
+This license becomes null and void if any of the above conditions are not met.
+
+ 
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT.  IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER
+DEALINGS IN THE FONT SOFTWARE.
+

quints-0.7.0/src/quints/invoice/fonts/README.md

@@ -0,0 +1,15 @@
+# Bundled fallback fonts
+
+Liberation Sans, always added to the Typst font search path.
+
+It carries two guarantees the invoice template would otherwise only get by
+luck, from whatever the rendering machine happens to have installed:
+
+- `Brand.font` defaults to Liberation Sans, and the template names it as the
+  fallback behind every issuer-configured family.
+- The Swiss QR-bill Implementation Guidelines permit only Arial, Frutiger,
+  Helvetica and Liberation Sans in the payment part. Liberation Sans is the
+  one of the four that can be licensed and shipped, and it is metric-
+  compatible with Arial, which the `qrbill` library sizes its text boxes for.
+
+Liberation Fonts 2.1.5, SIL Open Font License 1.1 — see `LICENSE`.

{quints-0.5.0 → quints-0.7.0}/src/quints/invoice/model.py

@@ -14,10 +14,17 @@ import sys
 from datetime import date
 from decimal import ROUND_HALF_UP, Decimal
 from pathlib import Path
-from typing import Any, Literal
+from typing import Annotated, Any, Literal
 
 import yaml
-from pydantic import BaseModel, Field, RootModel, field_validator, model_validator
+from pydantic import (
+    BaseModel,
+    Field,
+    RootModel,
+    StringConstraints,
+    field_validator,
+    model_validator,
+)
 
 if sys.version_info >= (3, 11):
     import tomllib
@@ -249,13 +256,40 @@ class BankAccount(BaseModel):
         return v.replace(" ", "")
 
 
+# Every hex form Typst's `rgb()` takes: RGB, RGBA, RRGGBB, RRGGBBAA. `accent`
+# used to be a bare `str` handed straight to `rgb()`, so anything shorthand that
+# rendered before still loads; only strings Typst would have rejected anyway are
+# caught here, and now at config-load time instead of mid-render.
+HexColor = Annotated[
+    str, StringConstraints(pattern=r"^#([0-9A-Fa-f]{3,4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$")
+]
+
+
 class Brand(BaseModel):
-    accent: str = "#123c3a"
+    """Typography and colour tokens the template renders with.
+
+    The colour defaults reproduce the neutral greyscale the template used
+    before tokens existed, so an issuer config that sets none of them keeps
+    its previous look. An issuer with a palette overrides them all.
+    """
+
+    accent: HexColor = "#123c3a"
     font: str = "Liberation Sans"
     font_display: str | None = None  # title/wordmark family; defaults to `font`
     font_display_stretch: int = 100  # CSS-style font-stretch % (125 → Expanded cut)
+    # Title weight. Not every display family ships every cut — Mona Sans
+    # Expanded starts at Medium, so asking for "regular" silently drops back to
+    # the normal-width face; a serif title usually wants "regular".
+    font_display_weight: Literal["regular", "medium", "semibold", "bold"] = "semibold"
+    font_mono: str | None = None  # figures, IBAN, reference; defaults to `font`
     font_dir: str | None = None  # bundled fonts dir passed to typst (repo-relative)
     logo: str | None = None
+    logo_height: float = 12.0  # mm, as placed in the header
+
+    ink: HexColor = "#141414"  # body copy
+    subtle: HexColor = "#696969"  # labels and secondary text
+    rule: HexColor = "#d2d2d2"  # hairlines
+    panel: HexColor = "#f6f6f6"  # fill behind bounded blocks
 
 
 class Issuer(BaseModel):

{quints-0.5.0 → quints-0.7.0}/src/quints/invoice/qr.py

@@ -52,7 +52,7 @@ def build_bill(inv: Invoice, issuer: Issuer, account: BankAccount, grand: Decima
         raise ValueError(f"Swiss QR-bill supports only CHF or EUR, not {currency!r}")
     with warnings.catch_warnings():
         warnings.simplefilter("ignore")
-        return QRBill(
+        bill = QRBill(
             account=account.qr_iban or account.iban,
             creditor=_structured(issuer.name, issuer.address, issuer.country),
             debtor=_structured(customer.name, customer.address, customer.country),
@@ -61,6 +61,12 @@ def build_bill(inv: Invoice, issuer: Issuer, account: BankAccount, grand: Decima
             reference_number=reference_for(inv, account),
             additional_information=f"{inv.number}",
         )
+    # The Implementation Guidelines allow Arial, Frutiger, Helvetica and
+    # Liberation Sans in the payment part, and nothing else. qrbill asks for
+    # Arial/Helvetica only, which are system faces — an issuer that bundles
+    # fonts has system faces switched off, so name the OFL one it can ship.
+    bill.font_family = "Arial,Helvetica,Liberation Sans"
+    return bill
 
 
 def write_svg(bill: QRBill, path: Path) -> None:

{quints-0.5.0 → quints-0.7.0}/src/quints/invoice/render.py

@@ -18,6 +18,10 @@ from .labels import labels as get_labels
 from .model import Invoice, Issuer, Totals, compute, make_scor, money, number
 
 TEMPLATE = Path(__file__).parent / "template.typ"
+# Liberation Sans, always on the search path: the default `Brand.font`, the
+# template's last-resort fallback, and the only face the QR-bill payment part
+# is allowed to use that we can ship. See fonts/README.md.
+BUNDLED_FONTS = Path(__file__).parent / "fonts"
 
 
 class InvoiceContext(TypedDict):
@@ -36,7 +40,7 @@ class InvoiceContext(TypedDict):
     totals: dict[str, str | bool]
     payment: Mapping[str, str | None]
     notes: list[str]
-    brand: dict[str, str | int | None]
+    brand: dict[str, str | float | None]
 
 
 def _fmt_iban(iban: str) -> str:
@@ -113,20 +117,45 @@ def build_context(
             "font": issuer.brand.font,
             "font_display": issuer.brand.font_display or issuer.brand.font,
             "display_stretch": issuer.brand.font_display_stretch,
+            "display_weight": issuer.brand.font_display_weight,
+            "font_mono": issuer.brand.font_mono or issuer.brand.font,
+            "ink": issuer.brand.ink,
+            "subtle": issuer.brand.subtle,
+            "rule": issuer.brand.rule,
+            "panel": issuer.brand.panel,
             "logo": logo,
+            "logo_height": issuer.brand.logo_height,
         },
     }
 
 
-def _compile(main: Path, output: Path, root: Path, font_paths: list[Path]) -> None:
-    """Compile to PDF/A-2b (archival) when supported, else a plain PDF."""
+def _compile(
+    main: Path, output: Path, root: Path, font_paths: list[Path], only_bundled: bool
+) -> None:
+    """Compile to PDF/A-2b (archival) when supported, else a plain PDF.
+
+    `only_bundled` switches machine-installed families off, and is set when the
+    issuer ships their own font directory. Without it, a variable font installed
+    on the designer's machine shadows the bundled static cuts of the same family
+    and every weight silently collapses to the variable font's default instance,
+    so the same invoice renders differently on a colleague's machine. Issuers on
+    the default font keep system fonts, since their families may live there.
+    """
     fonts = [str(p) for p in font_paths]
-    try:
-        typst.compile(
-            str(main), output=str(output), root=str(root), font_paths=fonts, pdf_standards="a-2b"
-        )
-    except (TypeError, ValueError):  # older typst-py, or standard unsupported
-        typst.compile(str(main), output=str(output), root=str(root), font_paths=fonts)
+    base: dict[str, object] = {"output": str(output), "root": str(root), "font_paths": fonts}
+    # Most capable call first; drop the options an older typst-py may not know.
+    attempts = [
+        {**base, "ignore_system_fonts": only_bundled, "pdf_standards": "a-2b"},
+        {**base, "pdf_standards": "a-2b"},
+        base,
+    ]
+    for i, opts in enumerate(attempts):
+        try:
+            typst.compile(str(main), **opts)  # type: ignore[arg-type]
+            return
+        except (TypeError, ValueError):
+            if i == len(attempts) - 1:
+                raise
 
 
 def render(inv: Invoice, issuer: Issuer, out_path: Path) -> tuple[Path, Totals, str | None]:
@@ -184,11 +213,14 @@ def render(inv: Invoice, issuer: Issuer, out_path: Path) -> tuple[Path, Totals,
         shutil.copy(TEMPLATE, work / "template.typ")
 
         font_dir = issuer.brand.font_dir
-        font_paths = [Path(font_dir)] if font_dir and Path(font_dir).is_dir() else []
+        issuer_fonts = [Path(font_dir)] if font_dir and Path(font_dir).is_dir() else []
+        # Ours first so the guaranteed fallback is always resolvable; the
+        # issuer's own families win on name, not on search order.
+        font_paths = [BUNDLED_FONTS, *issuer_fonts]
 
         out_path = Path(out_path)
         out_path.parent.mkdir(parents=True, exist_ok=True)
-        _compile(work / "template.typ", out_path, work, font_paths)
+        _compile(work / "template.typ", out_path, work, font_paths, bool(issuer_fonts))
         return out_path, totals, qr_payload
     finally:
         shutil.rmtree(work, ignore_errors=True)