Bokföringsintegrationer

Each accounting backend is configured through an AccountingProviderConfig variant — FortnoxConfig, XeroConfig, VismaConfig, or QuickBooksConfig — that holds Key Vault refs for client_id, client_secret, access_token, and refresh_token, plus provider-specific identifiers (company_id for Fortnox/Visma, xero_tenant_id and tracking_category_id for Xero, realm_id and minor_version for QuickBooks). Tokens are refreshed automatically before expiry. Outbound sync runs as an AccountingSyncJob that batches invoices, payments, and customers, computes a content hash per record, and consults an idempotent AccountingSyncMapping to skip unchanged rows; dry-run mode shows the plan without mutating the provider.

Inbound notifications arrive at AccountingWebhookEvent endpoints, where Fortnox calls are authenticated with HMAC-SHA256 against a shared signing key and Xero/Visma/QuickBooks use their respective signature schemes; idempotency_key deduplication prevents double-posting. Swedish reporting needs are covered by SIE4Export, which renders the standard control codes (#FLAGGA 0, #PROGRAM, #FORMAT PC8, #GEN, #SIETYP 4, #FNR, #FNAMN, #RAR, #KONTO, #IB, #UB, #VER, #TRANS) with configurable fiscal year, date filter, opening/closing balances, and period balances; POST /accounting/sie4-exports/ generates the file and returns metadata, and GET .../download streams the PC8-encoded artefact. ProviderAccountMapping holds the per-tenant chart-of-accounts mapping with a draft→active→archived lifecycle and an AccountMappingRule per category linking internal_category and internal_account_number to provider_account_code, provider_account_name, vat_code, and cost_centre; the validator catches duplicates and enforces numeric account codes for Fortnox.

Out of the box, BAS2024 defaults ship for eight petanque categories — license fees, tournament fees, club fees, membership fees, sponsor income, grants, travel costs, and consumable equipment — and a sync-to-provider endpoint pushes the mapping when it leaves draft.