Accounting Settings

Every Accounting-related toggle and default lives under Settings → Accounting. This tab is the configuration counterpart to the Accounting feature; operational pages (inbox, expenses, tax report) live at /admin/accounting/*, settings live here.

The tab appears in Settings only when the accounting feature flag is on (Settings → Features → Accounting).

Default rates

Single-line settings that drive the Internal expenses entry form:

Stored as integer minor units (Rappen) in app_settings; the UI input is in decimal CHF.

VAT registration & reclaim

The single most important block to get right — it drives whether the tax report computes a VAT payable at all, and whether input VAT on costs is reclaimable.

Are you VAT-registered?

Single toggle: VAT-registered (charge output VAT + reclaim input VAT).

• On — your invoices charge output VAT; supplier input VAT is reclaimable (subject to the reclaim-country list below). The tax report computes vatPayableMinor = output VAT − reclaimable input VAT.
• Off — small business / under threshold. You charge no VAT; supplier input VAT is a cost (not reclaimable). The tax report reports vatPayableMinor: null and surfaces a “configure VAT registration” warning rather than guessing.

Reclaim countries

When VAT-registered, pick the countries whose input VAT is reclaimable on your tax filing. Typically just your domestic country (CH / LI for a Swiss-based business). Costs from any other country are treated as foreign_vat_non_reclaimable regardless of how they’re categorised on the document.

The picker is multi-select — Cmd/Ctrl-click to add. Stored as an ISO-3166-1 alpha-2 code list in accounting_vat_reclaim_countries.

VAT codes

The full set of VAT codes the system knows about. Seeded with the Swiss/LI MWST codes from migration 129:

You can add codes, deactivate codes (instead of deleting — keeps mappings + exports stable for past data), and edit names. Deleting a code that’s been used on documents is refused.

Treatment → code maps

Two mapping settings drive what code gets attached when categorising:

• Cost tax-treatment → input-VAT code — maps the inbound-document tax-treatment field (domestic / reverse_charge_service / foreign_vat_non_reclaimable / import_goods) to a default input VAT code. Used when you categorise a supplier invoice.
• Revenue rate → output-VAT code — maps an invoice’s VAT rate (e.g. 8.1) to a default output VAT code (UN81). Used when an invoice is sent; the code is snapshotted onto the invoice (migration 130) so future code-renames don’t retroactively change historical exports.

Both maps live in app_settings (accounting_tax_treatment_vat_code_map, accounting_rate_vat_code_map_output).

Chart of accounts

The full chart of accounts — ledger_accounts rows from migration 129. Seeded with a condensed Swiss/LI KMU-Kontenrahmen suitable for a services / photography SME.

Seeded accounts

CRUD rules

• Add any account number — the form validates type (asset / liability / equity / revenue / expense) and uniqueness on the number.
• Edit name and type. Number is immutable once created (it’s the cross-reference key used by every other mapping).
• Delete is refused for any account currently referenced by a category mapping, a default-account setting, or a VAT code. Deactivate instead by removing all references first.
• Default accounts (Debitors 1100, Creditors 2000, output VAT 2200, input VAT 1170, etc.) live in app_settings and can be remapped to a different account number if your accountant uses a different chart layout.

Expense category → ledger account

Each expense category maps to a ledger account. Editable inline from the chart-of-accounts manager:

• Infrastruktur & Miete → 6000
• Equipment & Hardware → 6700
• Software & Lizenzen → 6570
• Material & Verbrauch → 4000
• (plus any custom categories — pick an account when you create them)

The mapping is what drives the DebitAccount column in the Treuhänder export for expense rows.

Feature flags vs. Settings

The Accounting settings tab does NOT contain the feature on/off toggles. Those live in Settings → Features:

• accounting — master (parent of everything below)
• incomingInvoices — supplier invoice capture
• incomingMail — IMAP poller
• expenses — internal expense ledger
• taxReport — tax report + Treuhänder export

The Accounting settings tab is hidden when accounting is off.

IMAP credentials

IMAP host / user / password for the incoming-mail poller live in Settings → Email, NOT here. They sit alongside the existing SMTP outbound config because they’re the inbound half of the same mail server (typically same host, different port).

Where this maps in the data model