* feat(arcim-migration): Briox provider with SIE-over-API import - Briox auth via account ID + application token (no app-level credentials); both tokens rotate on refresh and are persisted - New sie-fetcher pulls the general ledger as SIE through the provider API for Fortnox, Briox and Bjorn Lunden - Wizard stops on a failed SIE import and surfaces the real errors instead of proceeding to the misleading migrate-guard message - PROVIDER_SIE_ONLY_FORTNOX renamed to PROVIDER_SIE_NOT_SUPPORTED; new PROVIDER_TOKEN_INVALID for rejected provider credentials Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(bookkeeping): per-line accruals (periodisering) on invoices and supplier invoices Defer revenue/costs per invoice line to 29xx/17xx interim accounts with automatic monthly dissolution (nightly cron + catch-up at registration), schedule cancellation on credit, year-end auto-detect exclusion for already-scheduled invoices, invoice-inbox service-period extraction for prefill, and an MCP tool to list schedules. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(bokslut): iXBRL arsredovisning generation and Bolagsverket digital filing Generate the annual report as iXBRL from a generated taxonomy registry (K2 element lists, taxonomy:generate/check scripts + CI guard), expose it via the fiscal-period API, and add the bolagsverket extension for digital submission to eget utrymme with webhook-driven status tracking (submissions table + pg tests, lifecycle events, year-end wizard UI). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * test(mcp): raise origin-guard test timeout to 20s The dynamic import pulls in the full server module; the parse alone flirts with the 5s default under full-suite parallel load. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * Add new scripts and documentation for K2 AB taxonomy generation and validation - Introduced `generate-taxonomy-registry.ts` to automate the generation of the iXBRL taxonomy concept registry from official element lists and tuple models. - Added `validate-ixbrl.mjs` for validating generated iXBRL reports against the official taxonomy package using Arelle. - Included new documentation files: - `k2-ab-arsredovisning-elementlista-2024-09-12_rev20250312_sv.xlsx` - `tuple-innehallsmodell-arsredovisning-k2-2024-09-12.xlsx` - `taxonomi-paket-2024-09-12_rev20250312.zip` * Add tests for bookkeeping accruals dissolution and supplier invoices - Implement tests for the POST /api/bookkeeping/accruals/[id]/dissolve route, covering success and error scenarios. - Add tests for the DELETE /api/supplier-invoices/[id] route, including authentication checks and validation of invoice deletion conditions. - Introduce tests for the Arcim migration provider client, ensuring token handling and error classification. - Create tests for the Bolagsverket extension, validating submission role enforcement and environment settings. - Add Zod schemas for Bolagsverket response payloads to ensure proper validation. - Implement tests for MCP server's list accrual schedules, confirming registration and scope mapping. - Add consistency tests for IXBRL document generation, ensuring duplicate facts and XML escaping are handled correctly. - Introduce typed domain errors for accrual schedules to improve error handling in the service. - Add tests for resolving consent with Briox token refresh concurrency, ensuring proper token management and error handling. * fix(tests): update payload size guard comments to reflect recent changes in tool descriptions and ceiling adjustments * fix(gitattributes): mark generated JSON files in bokslut taxonomy as linguist-generated * feat(migrations): add backfill for invoices.journal_entry_id and fallback for next_voucher_number user_id * feat(bokslut): enhance compliance and financial processing features with new submission details and security measures --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
197 lines
6.7 KiB
TypeScript
197 lines
6.7 KiB
TypeScript
/**
|
|
* Bridges invoice flows to accrual schedules: after the registration/revenue
|
|
* entry is committed, every line that carries a periodisering period gets a
|
|
* schedule (+ synchronous catch-up posting for months that already began).
|
|
*
|
|
* Idempotent per line: lines already covered by a schedule are skipped, so
|
|
* event replays (supplier_invoice.confirmed) can never double-schedule.
|
|
* Failures are logged and counted, never thrown — the origin entry is already
|
|
* committed and must not be rolled back by a schedule hiccup; the caller
|
|
* surfaces a warning instead.
|
|
*/
|
|
|
|
import type { SupabaseClient } from '@supabase/supabase-js'
|
|
import type { Invoice, InvoiceItem, SupplierInvoice, SupplierInvoiceItem } from '@/types'
|
|
import { resolveSekAmount } from '@/lib/bookkeeping/currency-utils'
|
|
import { createAccrualSchedule } from '@/lib/bookkeeping/accruals/service'
|
|
import {
|
|
itemHasAccrual,
|
|
suggestBalanceAccount,
|
|
} from '@/lib/bookkeeping/accruals/account-suggestions'
|
|
import { getRevenueAccount } from '@/lib/bookkeeping/invoice-entries'
|
|
import { getVatTreatmentForRate } from '@/lib/invoices/vat-rules'
|
|
import type { EntityType } from '@/types'
|
|
import { createLogger } from '@/lib/logger'
|
|
|
|
const log = createLogger('bookkeeping.accruals.from-invoices')
|
|
|
|
export interface ScheduleCreationResult {
|
|
created: number
|
|
failed: number
|
|
}
|
|
|
|
export async function createSchedulesForSupplierInvoice(
|
|
supabase: SupabaseClient,
|
|
companyId: string,
|
|
userId: string,
|
|
invoice: SupplierInvoice,
|
|
items: SupplierInvoiceItem[],
|
|
originJournalEntryId: string,
|
|
): Promise<ScheduleCreationResult> {
|
|
const accrualItems = items.filter(itemHasAccrual)
|
|
const result: ScheduleCreationResult = { created: 0, failed: 0 }
|
|
if (accrualItems.length === 0) return result
|
|
|
|
const { data: existing } = await supabase
|
|
.from('accrual_schedules')
|
|
.select('supplier_invoice_item_id')
|
|
.eq('company_id', companyId)
|
|
.eq('supplier_invoice_id', invoice.id)
|
|
const covered = new Set(
|
|
((existing ?? []) as Array<{ supplier_invoice_item_id: string | null }>).map(
|
|
(row) => row.supplier_invoice_item_id,
|
|
),
|
|
)
|
|
|
|
for (const item of accrualItems) {
|
|
if (item.id && covered.has(item.id)) continue
|
|
try {
|
|
const totalSek =
|
|
Math.round(
|
|
resolveSekAmount(item.line_total, null, invoice.currency, invoice.exchange_rate) *
|
|
100,
|
|
) / 100
|
|
await createAccrualSchedule(
|
|
supabase,
|
|
companyId,
|
|
userId,
|
|
{
|
|
direction: 'expense',
|
|
supplierInvoiceId: invoice.id,
|
|
supplierInvoiceItemId: item.id ?? null,
|
|
balanceAccount:
|
|
item.accrual_balance_account ??
|
|
suggestBalanceAccount('expense', item.account_number),
|
|
targetAccount: item.account_number,
|
|
totalAmountSek: totalSek,
|
|
periodStart: item.accrual_period_start as string,
|
|
periodEnd: item.accrual_period_end as string,
|
|
description: `${item.description} (leverantörsfaktura ${invoice.supplier_invoice_number})`,
|
|
},
|
|
{
|
|
originJournalEntryId,
|
|
// The registration entry is dated invoice_date — dissolutions may
|
|
// never precede it.
|
|
postingFloorDate: invoice.invoice_date,
|
|
},
|
|
)
|
|
result.created++
|
|
} catch (error) {
|
|
result.failed++
|
|
log.error('failed to create accrual schedule for supplier invoice line', error, {
|
|
companyId,
|
|
entityId: invoice.id,
|
|
})
|
|
}
|
|
}
|
|
|
|
return result
|
|
}
|
|
|
|
export async function createSchedulesForCustomerInvoice(
|
|
supabase: SupabaseClient,
|
|
companyId: string,
|
|
userId: string,
|
|
invoice: Invoice,
|
|
items: InvoiceItem[],
|
|
originJournalEntryId: string,
|
|
entityType: EntityType = 'enskild_firma',
|
|
): Promise<ScheduleCreationResult> {
|
|
const accrualItems = items.filter(
|
|
(item) => itemHasAccrual(item) && item.line_type !== 'text' && !item.deduction_type,
|
|
)
|
|
const result: ScheduleCreationResult = { created: 0, failed: 0 }
|
|
if (accrualItems.length === 0) return result
|
|
|
|
const { data: existing } = await supabase
|
|
.from('accrual_schedules')
|
|
.select('invoice_item_id')
|
|
.eq('company_id', companyId)
|
|
.eq('invoice_id', invoice.id)
|
|
const covered = new Set(
|
|
((existing ?? []) as Array<{ invoice_item_id: string | null }>).map(
|
|
(row) => row.invoice_item_id,
|
|
),
|
|
)
|
|
|
|
for (const item of accrualItems) {
|
|
if (item.id && covered.has(item.id)) continue
|
|
const target = resolveRevenueTarget(item, invoice.vat_treatment, entityType)
|
|
// reverse_charge/export lines keep their statutory account (3308/3305) so
|
|
// ruta 39/40 in the momsdeklaration stay correct — never deferred. The
|
|
// generator applies the same exclusion, so the net stays on 3308/3305.
|
|
if (target.special) continue
|
|
try {
|
|
const targetAccount = target.account
|
|
const totalSek =
|
|
Math.round(
|
|
resolveSekAmount(item.line_total, null, invoice.currency, invoice.exchange_rate) *
|
|
100,
|
|
) / 100
|
|
await createAccrualSchedule(
|
|
supabase,
|
|
companyId,
|
|
userId,
|
|
{
|
|
direction: 'revenue',
|
|
invoiceId: invoice.id,
|
|
invoiceItemId: item.id ?? null,
|
|
balanceAccount:
|
|
item.accrual_balance_account ?? suggestBalanceAccount('revenue', targetAccount),
|
|
targetAccount,
|
|
totalAmountSek: totalSek,
|
|
periodStart: item.accrual_period_start as string,
|
|
periodEnd: item.accrual_period_end as string,
|
|
description: `${item.description} (faktura ${invoice.invoice_number ?? ''})`.trim(),
|
|
},
|
|
{
|
|
originJournalEntryId,
|
|
postingFloorDate: invoice.invoice_date,
|
|
},
|
|
)
|
|
result.created++
|
|
} catch (error) {
|
|
result.failed++
|
|
log.error('failed to create accrual schedule for invoice line', error, {
|
|
companyId,
|
|
entityId: invoice.id,
|
|
})
|
|
}
|
|
}
|
|
|
|
return result
|
|
}
|
|
|
|
/**
|
|
* Resolve a line's revenue account exactly the way generatePerRateLines does:
|
|
* per-line override only for ordinary domestic rates; reverse_charge/export
|
|
* force the statutory account and are flagged `special` (never deferrable).
|
|
*/
|
|
function resolveRevenueTarget(
|
|
item: InvoiceItem,
|
|
invoiceTreatment: Invoice['vat_treatment'],
|
|
entityType: EntityType,
|
|
): { account: string; special: boolean } {
|
|
const rate = item.vat_rate ?? 0
|
|
const treatment =
|
|
rate === 0 && (invoiceTreatment === 'reverse_charge' || invoiceTreatment === 'export')
|
|
? invoiceTreatment
|
|
: getVatTreatmentForRate(rate)
|
|
const special = treatment === 'reverse_charge' || treatment === 'export'
|
|
const account =
|
|
!special && item.revenue_account
|
|
? item.revenue_account
|
|
: getRevenueAccount(treatment, entityType)
|
|
return { account, special }
|
|
}
|