quints 0.1.0__tar.gz → 0.2.0__tar.gz

{quints-0.1.0 → quints-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quints
-Version: 0.1.0
+Version: 0.2.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
@@ -8,10 +8,10 @@ Keywords: accounting,beancount,fava,invoice,kmu,mwst,plain-text-accounting,qr-bi
 Requires-Python: >=3.10
 Requires-Dist: babel>=2.13
 Requires-Dist: beancount>=3.2.0
-Requires-Dist: beangulp-mt940
-Requires-Dist: beangulp-stripe
-Requires-Dist: beangulp-wise[sca]
-Requires-Dist: beanprice-bazg
+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: fava>=1.30
 Requires-Dist: pydantic>=2.7
 Requires-Dist: python-stdnum>=1.20

{quints-0.1.0 → quints-0.2.0}/examples/.gitignore

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

{quints-0.1.0 → quints-0.2.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.2.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.0 → quints-0.2.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.2.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.2.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.2.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.2.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.0 → quints-0.2.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.0 → quints-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "quints"
-version = "0.1.0"
+version = "0.2.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"
@@ -12,10 +12,10 @@ keywords = [
 dependencies = [
     "babel>=2.13",
     "beancount>=3.2.0",
-    "beangulp-mt940",
-    "beangulp-stripe",
-    "beangulp-wise[sca]",
-    "beanprice-bazg",
+    "beangulp-mt940>=0.1.0",
+    "beangulp-stripe>=0.1.0",
+    "beangulp-wise[sca]>=0.1.0",
+    "beanprice-bazg>=0.1.0",
     "fava>=1.30",
     "pydantic>=2.7",
     "python-stdnum>=1.20",

{quints-0.1.0 → quints-0.2.0}/src/quints/cli.py

@@ -801,6 +801,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 +820,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 +835,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 +897,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.0 → quints-0.2.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")