Finance settings
Tax rate selection date, reverse-charge label, and document tax display toggles.
Overview
Finance settings control billing behaviour consumed by checkout and document rendering — tax rate selection date, default tax-inclusive pricing, tax breakdown display, VAT validation window, reverse-charge label, pricing rounding and discount limits, write-off ceilings, portal payments, and the billing-run undo window.
Where it lives
Route: /admin/settings/finance (admin.settings.finance)
Open Admin → Money & Pricing → Finance. Requires settings.manage.
Key settings
- Tax rate selection date:
supply_dateorinvoice_datechooses the applicable tax rate. This is not the legal tax point: the legal tax point and tax reporting period remain the invoice issue date. - New rentals default to prices include tax
- Show tax breakdown on documents
- VAT validation validity days (0–3650)
- Reverse charge label
- Pricing rounding direction:
half_up(default) orbankers - Maximum line discount percent (0–100, default 100): caps category, automatic and manual line discounts; authorised agreed prices remain a separate override
- Unresolved zone fallback: currently only
seller_domestic(seller domestic zone) - Default item tax code: optional; leave blank when items must choose an item tax code explicitly
- Write-off ceilings: a maximum per currency, in minor units, applied to invoice write-offs; add a currency to set a new ceiling
- Portal payments: allow customers to pay from the document portal, an optional deposit percentage, and checkout experience (
hostedredirect to the provider, orembeddedcard entry in the portal page) - Account settings on the same page: require the current account version for changes, allow new credit exposure, credit check mode (report only, warn, enforce)
- Billing-run undo window (
invoices.billing_run_undo_minutes, default 15, range 1–1440). Stamped onto a run when its issue batch finishes; changing the setting does not move an existing deadline.
External accounting export seam
AccountingPostingExportSource exposes immutable financial postings for a tenant-local accounting integration. A named user needs invoices.view, reports.export and unrestricted warehouse access, including unassigned cash. It is a PHP integration point only: there is no built-in accounting connector, scheduled job or public endpoint.
Call page(user, destination, cursor, limit) with a destination namespace of 1–100 ASCII letters, digits, dots, underscores, colons or hyphens (starting with a letter or digit). A page contains up to 500 posting UUIDs, the original posting header and ordered lines, and a SHA-256 payload hash. Each posting is verified against its retained source before export. Missing or inconsistent facts refuse the read; live invoice balances and current exchange rates are never substituted.
The returned cursor rotates through pending UUIDs and wraps, so a later posting with an ID below a preceding cursor still appears. An unacknowledged posting may appear again. The cursor is advisory; a durable receipt is the completion checkpoint. The receiving integration must deduplicate by destination and posting UUID before calling acknowledge(user, destination, postingId, payloadHash, reference) after its successful import.
Acknowledgements are unique per destination and posting. Retrying the same hash and reference returns the original receipt; a changed hash or reference refuses. A different destination has its own pending set. Receipts retain the actor, acknowledgement time, reference and hash, and cannot be updated or deleted. Reading and acknowledging never change invoices, payments, financial postings or provider facts.
Demo finance cleanup refuses to delete a posting retained by an export receipt; acknowledged postings are kept.
The receipt migration can roll back an empty table. Once acknowledgements exist, rollback refuses to discard them; any later schema change needs a new forward migration.
Related
- Deeper topic: Tax & Compliance
- Multi-Currency & Tax
- Billing runs
- Finance operations — reconciliation, recovery and multi-currency commands