quints 0.1.1__tar.gz → 0.3.0__tar.gz

{quints-0.1.1 → quints-0.3.0}/.gitignore

@@ -6,6 +6,7 @@ build/
 *.egg-info/
 .pytest_cache/
 .ruff_cache/
+site/
 .env
 .DS_Store
 .claude/settings.local.json

{quints-0.1.1 → quints-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quints
-Version: 0.1.1
+Version: 0.3.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
 License: GPL-2.0-only
 License-File: LICENSE
@@ -11,7 +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: beanprice-bazg>=0.1.0
+Requires-Dist: beanprice-bazg>=0.2.0
 Requires-Dist: fava>=1.30
 Requires-Dist: pydantic>=2.7
 Requires-Dist: python-stdnum>=1.20
@@ -27,7 +27,7 @@ Description-Content-Type: text/markdown
 
 Swiss VAT & accounting toolkit for plain-text ([beancount](https://github.com/beancount/beancount)) books.
 
-Everything a Swiss micro-company (GmbH/AG) needs on top of beancount + Fava:
+Everything a Swiss micro-company (GmbH, AG, or Einzelfirma) needs on top of beancount + Fava:
 
 - **MWST**: quarterly VAT report mapped to the ESTV form Ziffern, settlement
   transactions, VAT status, and Bezugsteuer (reverse-charge, Art. 45 ff. MWSTG)

{quints-0.1.1 → quints-0.3.0}/README.md

@@ -2,7 +2,7 @@
 
 Swiss VAT & accounting toolkit for plain-text ([beancount](https://github.com/beancount/beancount)) books.
 
-Everything a Swiss micro-company (GmbH/AG) needs on top of beancount + Fava:
+Everything a Swiss micro-company (GmbH, AG, or Einzelfirma) needs on top of beancount + Fava:
 
 - **MWST**: quarterly VAT report mapped to the ESTV form Ziffern, settlement
   transactions, VAT status, and Bezugsteuer (reverse-charge, Art. 45 ff. MWSTG)

{quints-0.1.1 → quints-0.3.0}/examples/.gitignore

@@ -3,3 +3,6 @@
 .env
 __pycache__/
 *.pdf
+.venv/
+.DS_Store
+.wise/

{quints-0.1.1 → quints-0.3.0}/examples/AGENTS.md

@@ -5,20 +5,31 @@ with [`quints`](https://github.com/sealambda/quints). **`quints` is a
 deterministic tool — you drive it, it never calls a model.** Your job is to
 extend and maintain the ledger; `quints` validates and reports on it.
 
+## Setup
+
+`uv sync` once — it installs quints, which brings beancount and fava along.
+Then `uv run quints check` (or activate the venv and call `quints` and the
+standard beancount tools directly).
+
 ## Layout
 
-- `main.bean` — the ledger (accounts + transactions). `plugin
-  "quints.plugins.kmu"` is enabled: every `*:CH:GmbH:*` account **must** be
-  opened with a four-digit `kmu:` code (Swiss KMU Kontenrahmen).
-- `prices.bean` — FX rates; refresh with `quints prices sync`.
-- `quints.toml` — entity config (name, VAT, importer rules). VAT *rates* are
-  law and live in code, not here.
-- `staging/` — importer drafts land here; `inbox/` — source documents.
+- `main.bean` — options, plugins, includes; the entry point every tool loads.
+  `plugin "quints.plugins.kmu"` is enabled: every `*:CH:GmbH:*` account
+  **must** be opened with a four-digit `kmu:` code (Swiss KMU Kontenrahmen).
+- `accounts.bean` — the chart of accounts (all `open` directives).
+- `books/2026.bean` — transactions, one file per fiscal year. `main.bean`
+  includes `books/*.bean`, so a new year just needs a new file.
+- `commodities.bean` — currencies; `prices.bean` — FX rates, refresh with
+  `quints prices sync`.
+- `quints.toml` — entity config (name, legal form, VAT, importer rules). VAT
+  *rates* are law and live in code, not here.
+- `staging/` — importer drafts land here; `inbox/` — incoming source
+  documents; `documents/` — filed documents, mirroring the account tree.
 
 ## Extending the chart of accounts (the part that needs judgement)
 
-Add income/expense sub-trees for this business as `open` directives, each with
-the KMU code it rolls up to, e.g.:
+Add income/expense sub-trees for this business as `open` directives in
+`accounts.bean`, each with the KMU code it rolls up to, e.g.:
 
 ```beancount
 2026-01-01 open Expenses:CH:GmbH:Marketing:Ads CHF
@@ -33,7 +44,7 @@ KMU Kontenrahmen; `quints check` fails on a `:CH:GmbH:` account with no valid
 
 1. Draft bank/PSP activity: `quints import ubs <file>` → `staging/`.
 2. Review, add the VAT decision (InputVAT / Bezugsteuer / none) and a linked
-   document, then move drafts into `main.bean`.
+   document, then move drafts into `books/2026.bean`.
 3. **Always** `quints check` before you consider the books consistent.
 
 ## Machine-readable surfaces (prefer these over scraping text)

quints-0.3.0/examples/accounts.bean

@@ -0,0 +1,43 @@
+; Chart of accounts — Swiss KMU Kontenrahmen. Every *:CH:GmbH:* account
+; must carry the four-digit kmu: code it rolls up to (enforced by
+; quints.plugins.kmu). Extend the chart by adding more open directives;
+; see AGENTS.md and `quints report konten`.
+
+2026-01-01 open Assets:CH:GmbH:Current:UBS:CHF CHF
+  kmu: "1020"  ; Bank deposits
+2026-01-01 open Assets:CH:GmbH:Receivable:Trade
+  kmu: "1100"  ; Trade receivables
+2026-01-01 open Assets:CH:GmbH:Tax:InputVAT CHF
+  kmu: "1170"  ; Input VAT
+2026-01-01 open Liabilities:CH:GmbH:Tax:OutputVAT CHF
+  kmu: "2200"  ; VAT due
+2026-01-01 open Liabilities:CH:GmbH:Tax:Bezugsteuer CHF
+  kmu: "2200"  ; VAT due
+2026-01-01 open Liabilities:CH:GmbH:Tax:PayableVAT CHF
+  kmu: "2200"  ; VAT due
+2026-01-01 open Equity:CH:GmbH:Capital:Share CHF
+  kmu: "2800"  ; Share capital
+2026-01-01 open Income:CH:GmbH:Consulting:External:Domestic
+  kmu: "3400"  ; Revenue from services
+2026-01-01 open Income:CH:GmbH:Consulting:External:Export
+  kmu: "3400"  ; Revenue from services
+2026-01-01 open Expenses:CH:GmbH:IT:Hosting
+  kmu: "6570"  ; IT expenses
+2026-01-01 open Expenses:CH:GmbH:FX:CurrencyLoss CHF
+  kmu: "6900"  ; Financial expenses
+2026-01-01 open Income:CH:GmbH:Rounding CHF
+  kmu: "6950"  ; Financial income
+2026-01-01 open Income:CH:GmbH:FX:CurrencyGain CHF
+  kmu: "6950"  ; Financial income
+2026-01-01 open Assets:CH:GmbH:Current:Wise:CHF CHF
+  kmu: "1020"  ; Bank deposits
+2026-01-01 open Assets:CH:GmbH:Current:Wise:EUR EUR
+  kmu: "1020"  ; Bank deposits
+2026-01-01 open Assets:CH:GmbH:Current:Wise:USD USD
+  kmu: "1020"  ; Bank deposits
+2026-01-01 open Expenses:CH:GmbH:BankFees:Wise
+  kmu: "6940"  ; Bank charges
+2026-01-01 open Assets:CH:GmbH:Current:Stripe:EUR EUR
+  kmu: "1020"  ; Bank deposits
+2026-01-01 open Expenses:CH:GmbH:BankFees:Stripe
+  kmu: "6940"  ; Bank charges

{quints-0.1.1 → quints-0.3.0}/examples/answers.toml

@@ -8,6 +8,7 @@
 # never hand-maintained) and that the reporting commands agree on the numbers.
 
 entity_name = "Example GmbH"
+legal_form = "gmbh"                # or "ag" / "einzelfirma"
 vat_method = "effective"
 vat_registered_since = 2026-01-01
 operating_currency = "CHF"

quints-0.3.0/examples/books/2026.bean

@@ -0,0 +1,28 @@
+; 2026 — transactions for the fiscal year. Reviewed importer drafts
+; move here from staging/. main.bean includes books/*.bean, so a new
+; year just needs a new books/<year>.bean file.
+
+; ── sample activity (remove once you book your own) ───────────────────
+
+2026-01-02 * "Founders" "Share capital paid in"
+  Assets:CH:GmbH:Current:UBS:CHF                  20000.00 CHF
+  Equity:CH:GmbH:Capital:Share                   -20000.00 CHF
+
+2026-07-02 * "Acme AG" "Consulting — July" ^INV2026014
+  Assets:CH:GmbH:Receivable:Trade                  1081.00 CHF
+  Income:CH:GmbH:Consulting:External:Domestic     -1000.00 CHF
+  Liabilities:CH:GmbH:Tax:OutputVAT                 -81.00 CHF
+
+2026-07-20 * "Acme AG" "Payment INV2026014" ^INV2026014
+  Assets:CH:GmbH:Current:UBS:CHF                   1081.00 CHF
+  Assets:CH:GmbH:Receivable:Trade                 -1081.00 CHF
+
+2026-08-05 * "Globex Ltd" "Export consulting" ^INV2026015
+  Assets:CH:GmbH:Receivable:Trade                   500.00 EUR
+  Income:CH:GmbH:Consulting:External:Export        -500.00 EUR
+
+2026-08-12 * "Foreign SaaS" "Cloud hosting (reverse charge)"
+  Expenses:CH:GmbH:IT:Hosting                       100.00 EUR
+  Assets:CH:GmbH:Tax:InputVAT                         7.53 CHF @@ 8.10 EUR
+  Liabilities:CH:GmbH:Tax:Bezugsteuer                -7.53 CHF @@ 8.10 EUR
+  Assets:CH:GmbH:Current:Wise:EUR                  -100.00 EUR

quints-0.3.0/examples/commodities.bean

@@ -0,0 +1,9 @@
+; Currencies in use. Non-CHF commodities carry the beanprice source
+; (official BAZG/EZV daily CHF rates) that `quints prices sync` and
+; `bean-price` read.
+
+2026-01-01 commodity CHF
+2026-01-01 commodity EUR
+  price: "CHF:beanprice_bazg/EUR"
+2026-01-01 commodity USD
+  price: "CHF:beanprice_bazg/USD"

quints-0.3.0/examples/invoicing/acme-2026-07.yaml

@@ -0,0 +1,15 @@
+# Sample domestic invoice — a Swiss QR-bill. It ties to the ^INV2026014
+# booking in books/2026.bean (net 1'000.00 + 8.1% VAT = 1'081.00), so
+# `quints invoice` cross-checks it clean against the ledger.
+number: INV2026014
+kind: domestic
+currency: CHF
+issue_date: 2026-07-02
+supply: Juli 2026
+customer: acme
+items:
+  - description: Consulting — July
+    quantity: 1
+    unit_price: 1000.00
+    unit: Pauschal
+locale: de_CH

quints-0.3.0/examples/invoicing/customers.yaml

@@ -0,0 +1,15 @@
+# Customer registry — invoices reference these entries by key. A customer
+# is a flat entry, or a dated `versions` history for address changes.
+acme:
+  name: Acme AG
+  address:
+    - Bahnhofstrasse 1
+    - 8001 Zürich
+globex:
+  name: Globex Ltd
+  country: IE
+  # Reverse-charge exports must carry the customer's VAT number.
+  vat_id: IE1234567T
+  address:
+    - 1 Liffey Street
+    - Dublin 1

quints-0.3.0/examples/invoicing/globex-2026-08.yaml

@@ -0,0 +1,13 @@
+# Sample export invoice — foreign currency, reverse charge, no QR part.
+# Ties to the ^INV2026015 booking in books/2026.bean (500.00 EUR).
+number: INV2026015
+kind: export
+currency: EUR
+issue_date: 2026-08-05
+supply: August 2026
+customer: globex
+items:
+  - description: Export consulting
+    quantity: 1
+    unit_price: 500.00
+locale: en

quints-0.3.0/examples/invoicing/issuer.yaml

@@ -0,0 +1,16 @@
+# Issuer identity for `quints invoice` — name, address, VAT ID, and one
+# bank account per invoicing currency. Sample data: replace the VAT ID
+# and IBANs with your own before issuing a real invoice.
+name: Example GmbH
+address:
+  - Beispielstrasse 1
+  - 8000 Zürich
+vat_id: CHE-267.359.056 MWST
+email: billing@example.ch
+bank:
+  CHF:
+    # QR-IBAN (QR-IID variant) — a Swiss QR-bill with a QRR reference.
+    qr_iban: CH44 3199 9123 0008 8901 2
+  EUR:
+    # Regular IBAN — foreign transfers can't use the QR-bill scheme.
+    iban: CH93 0076 2011 6238 5295 7

quints-0.3.0/examples/main.bean

@@ -0,0 +1,23 @@
+; Example GmbH — books managed with quints (https://github.com/sealambda/quints)
+;
+; Generated by `quints init`. Layout:
+;   accounts.bean      chart of accounts (KMU Kontenrahmen)
+;   commodities.bean   currencies and their price sources
+;   prices.bean        FX rates — refresh with `quints prices sync`
+;   books/2026.bean    transactions, one file per fiscal year
+; Validate with `quints check`; after `uv sync`, plain
+; `bean-check main.bean` and `fava main.bean` work too.
+
+plugin "quints.plugins.kmu" ":CH:GmbH:"
+plugin "fava.plugins.link_documents"
+
+2026-01-01 custom "fava-extension" "quints.fava"
+
+include "accounts.bean"
+include "commodities.bean"
+include "prices.bean"
+include "books/*.bean"
+
+option "title" "Example GmbH"
+option "operating_currency" "CHF"
+option "documents" "documents/"

quints-0.3.0/examples/pyproject.toml

@@ -0,0 +1,14 @@
+# `uv sync` installs quints — which brings beancount, fava, the statement
+# importers, and the BAZG price source along as its own dependencies — so
+# the standard beancount toolchain (`bean-check main.bean`, `fava
+# main.bean`, `bean-query`) works in this repo, not only the quints CLI.
+[project]
+name = "example-gmbh"
+version = "0.1.0"
+requires-python = ">=3.10"
+dependencies = [
+    "quints",
+]
+
+[tool.uv]
+package = false

{quints-0.1.1 → quints-0.3.0}/examples/quints.toml

@@ -1,9 +1,9 @@
 # quints.toml — everything entity-specific lives here, next to main.bean.
-# Account names below are the built-in defaults (CH:GmbH namespacing);
-# uncomment and edit in quints.toml + main.bean together to change them.
+# Account names mirror accounts.bean; change them in both files together.
 
 [entity]
 name = "Example GmbH"
+legal_form = "gmbh"           # gmbh | ag | einzelfirma
 vat_method = "effective"            # "saldo" is not supported yet
 vat_registered_since = 2026-01-01   # earlier periods are pre-liability
 operating_currency = "CHF"
@@ -12,6 +12,21 @@ operating_currency = "CHF"
 main = "main.bean"
 prices = "prices.bean"
 
+[accounts]
+entity_marker = ":CH:GmbH:"         # scopes KMU statements and the plugin
+input_vat = "Assets:CH:GmbH:Tax:InputVAT"
+output_vat = "Liabilities:CH:GmbH:Tax:OutputVAT"
+bezugsteuer = "Liabilities:CH:GmbH:Tax:Bezugsteuer"
+payable_vat = "Liabilities:CH:GmbH:Tax:PayableVAT"
+receivable = "Assets:CH:GmbH:Receivable:Trade"
+income_prefix = "Income:CH:GmbH"
+export_marker = ":Export"           # income sub-account marker → Ziffer 221
+income_domestic = "Income:CH:GmbH:Consulting:External:Domestic"
+income_export = "Income:CH:GmbH:Consulting:External:Export"
+fx_gain = "Income:CH:GmbH:FX:CurrencyGain"
+fx_loss = "Expenses:CH:GmbH:FX:CurrencyLoss"
+rounding_income = "Income:CH:GmbH:Rounding"
+
 [report]
 language = "en"                     # or "de"; --lang overrides
 
@@ -42,7 +57,7 @@ USD = "Assets:CH:GmbH:Current:Wise:USD"
 [import.stripe]
 account_id = "acct_XXXXXXXXXXXX"   # guard: refuse a key for another account
 fees_account = "Expenses:CH:GmbH:BankFees:Stripe"
-tax_account = "Assets:CH:GmbH:Tax:InputVAT"   # VAT inside Stripe's monthly fee debits
+tax_account = "Assets:CH:GmbH:Tax:InputVAT"   # VAT inside Stripe's own fees
 rules = [
     ['\bpayout\b', "Assets:CH:GmbH:Current:Wise:EUR", "*"],
 ]

{quints-0.1.1 → quints-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "quints"
-version = "0.1.1"
+version = "0.3.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"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -15,7 +15,7 @@ dependencies = [
     "beangulp-mt940>=0.1.0",
     "beangulp-stripe>=0.1.0",
     "beangulp-wise[sca]>=0.1.0",
-    "beanprice-bazg>=0.1.0",
+    "beanprice-bazg>=0.2.0",
     "fava>=1.30",
     "pydantic>=2.7",
     "python-stdnum>=1.20",

{quints-0.1.1 → quints-0.3.0}/src/quints/__init__.py

@@ -1,3 +1,3 @@
 """quints — Swiss VAT & accounting for plain-text (beancount) books."""
 
-__version__ = "0.1.0"
+__version__ = "0.3.0"

{quints-0.1.1 → quints-0.3.0}/src/quints/cli.py

@@ -330,8 +330,37 @@ def prices_sync(
     Without --from: extend each currency forward to today (fast, daily use).
     With --from DATE: re-scan the whole range and fill any missing days.
     """
+    from rich.progress import (
+        BarColumn,
+        MofNCompleteColumn,
+        Progress,
+        TaskID,
+        TextColumn,
+        TimeRemainingColumn,
+    )
+
     repair = _parse_date(from_) if from_ else None
-    result = prices_mod.sync(out, repair_from=repair)
+    # BAZG has no bulk endpoint — the fetch is one request per calendar day per
+    # currency, so a backfill takes a while: show a live per-currency bar
+    # (stderr, transient) unless the caller asked for machine-readable output.
+    with Progress(
+        TextColumn("[progress.description]{task.description}"),
+        BarColumn(),
+        MofNCompleteColumn(),
+        TextColumn("days"),
+        TimeRemainingColumn(),
+        console=ui.err_console,
+        transient=True,
+        disable=as_json,
+    ) as bars:
+        tasks: dict[str, TaskID] = {}
+
+        def on_progress(ccy: str, done: int, total: int) -> None:
+            if ccy not in tasks:
+                tasks[ccy] = bars.add_task(ccy, total=total)
+            bars.update(tasks[ccy], completed=done)
+
+        result = prices_mod.sync(out, repair_from=repair, progress=on_progress)
     if as_json:
         _json_out(
             {
@@ -801,6 +830,11 @@ def init(
         Path("."), help="Target project directory (created if missing)."
     ),
     name: str | None = typer.Option(None, "--name", help="Entity name, e.g. 'Acme GmbH'."),
+    legal_form: str | None = typer.Option(
+        None,
+        "--legal-form",
+        help="Legal form: gmbh, ag, or einzelfirma (sole proprietorship / freelancer).",
+    ),
     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)."
@@ -815,7 +849,8 @@ def init(
     yes: bool = typer.Option(False, "--yes", "-y", help="Skip prompts; accept defaults."),
     as_json: bool = typer.Option(False, "--json", help="Machine-readable output."),
 ):
-    """Scaffold a new quints project (chart of accounts, quints.toml, AGENTS.md).
+    """Scaffold a new quints project (chart of accounts, per-year books,
+    quints.toml, pyproject.toml, AGENTS.md).
 
     Deterministic: the same answers always produce the same files. Run
     interactively, or feed a TOML answer-file with --answers for CI/repeatable
@@ -829,6 +864,22 @@ def init(
         answers = init_mod.Answers()
 
     interactive = answers_file is None and not yes
+    if legal_form is not None:
+        answers = replace(answers, legal_form=legal_form.strip().lower())
+    elif interactive:
+        answers = replace(
+            answers,
+            legal_form=typer.prompt("Legal form (gmbh/ag/einzelfirma)", default=answers.legal_form)
+            .strip()
+            .lower(),
+        )
+    # An answer-file's entity name is authoritative; otherwise suggest one
+    # that matches the chosen legal form instead of the GmbH default.
+    example_names = {"gmbh": "Example GmbH", "ag": "Example AG", "einzelfirma": "Jane Doe"}
+    if answers_file is None and answers.entity_name == init_mod.Answers.entity_name:
+        answers = replace(
+            answers, entity_name=example_names.get(answers.legal_form, answers.entity_name)
+        )
     if name is not None:
         answers = replace(answers, entity_name=name)
     elif interactive:
@@ -875,7 +926,7 @@ def init(
     if result.written and not result.skipped:
         ui.console.print(
             f"\nScaffolded [b]{answers.entity_name}[/] in {directory}. "
-            "Next: [b]quints check[/] then [b]quints mwst -q 2026-Q3[/]."
+            "Next: [b]uv sync[/], then [b]quints check[/] and [b]quints mwst -q 2026-Q3[/]."
         )
 
 

{quints-0.1.1 → quints-0.3.0}/src/quints/config.py

@@ -28,6 +28,16 @@ else:  # pragma: no cover
 
 DEFAULT_PATH = Path("quints.toml")
 
+# Legal form → account-name component (Assets:CH:<component>:…). The keys are
+# the entity families the official KMU Kontenrahmen (veb.ch) prints Klasse-28
+# variants for: juristische Personen (gmbh, ag) and Einzelunternehmen;
+# Personengesellschaft (per-partner capital blocks) is not supported yet.
+LEGAL_FORMS: dict[str, str] = {
+    "gmbh": "GmbH",
+    "ag": "AG",
+    "einzelfirma": "Einzelfirma",
+}
+
 
 @dataclass(frozen=True)
 class UbsImport:
@@ -76,6 +86,7 @@ class StripeImport:
 class Config:
     # [entity]
     entity_name: str = "Example GmbH"
+    legal_form: str = "gmbh"  # key into LEGAL_FORMS; picks the Klasse-28 equity variant
     vat_method: str = "effective"  # "saldo" would need a different Form-310 mapping
     vat_registered_since: Date | None = None
     operating_currency: str = "CHF"
@@ -159,6 +170,7 @@ def _from_mapping(raw: dict) -> Config:
             updates[field] = cast(value) if cast else value
 
     take(entity, "name", "entity_name")
+    take(entity, "legal_form", "legal_form")
     take(entity, "vat_method", "vat_method")
     take(entity, "vat_registered_since", "vat_registered_since")
     take(entity, "operating_currency", "operating_currency")