Add an automatic excess-depreciation calculator for machinery and equipment under IL 18 kap: 30-rule and 20-rule residuals (fiscal-period aware for short and long years), ledger vs asset-register reconciliation, fail-closed blocking states, and a signed proposal that books via the dispositions flow (8853/2153). Releases of an over-target reserve are mandatory and not overridable; increases are optional and capped server-side. Fixes #323 Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
377 lines
14 KiB
TypeScript
377 lines
14 KiB
TypeScript
/**
|
||
* K3 framework integration test for the dispositions builder.
|
||
*
|
||
* Verifies that:
|
||
* - K3 companies get an `uppskjuten_skatt` proposal at the end of the chain.
|
||
* - K2 companies (the default) do NOT receive that proposal.
|
||
* - The latent tax amount equals 20.6 % × projected closing 21xx − current
|
||
* 2240 balance.
|
||
*
|
||
* Mocks generateIncomeStatement and generateTrialBalance directly so the
|
||
* test can drive numeric inputs without touching the database.
|
||
*/
|
||
import { describe, it, expect, vi, beforeEach } from 'vitest'
|
||
|
||
vi.mock('@/lib/reports/income-statement', () => ({
|
||
generateIncomeStatement: vi.fn(),
|
||
}))
|
||
|
||
vi.mock('@/lib/reports/trial-balance', () => ({
|
||
generateTrialBalance: vi.fn(),
|
||
}))
|
||
|
||
vi.mock('@/lib/bokslut/reserves/overavskrivningar-calculator', () => ({
|
||
calculateOveravskrivningar: vi.fn(),
|
||
}))
|
||
|
||
import { buildDispositionsProposal } from '../dispositions-proposal-builder'
|
||
import { generateIncomeStatement } from '@/lib/reports/income-statement'
|
||
import { generateTrialBalance } from '@/lib/reports/trial-balance'
|
||
import { calculateOveravskrivningar } from '@/lib/bokslut/reserves/overavskrivningar-calculator'
|
||
|
||
interface ChainableMock {
|
||
from: ReturnType<typeof vi.fn>
|
||
}
|
||
|
||
function makeSupabase(opts: {
|
||
entityType: 'aktiebolag' | 'enskild_firma'
|
||
accountingFramework: 'k2' | 'k3' | null
|
||
periodEnd?: string
|
||
/** Existing periodiseringsfond rows the builder queries. */
|
||
periodiseringsfondRows?: Array<{ account_number: string; cohort_year: number; balance: number; must_return_this_year: boolean }>
|
||
}): ChainableMock {
|
||
const periodEnd = opts.periodEnd ?? '2026-12-31'
|
||
// The builder makes several .from(...) queries. We respond per-table.
|
||
const from = vi.fn((table: string) => {
|
||
if (table === 'fiscal_periods') {
|
||
return {
|
||
select: () => ({
|
||
eq: () => ({
|
||
eq: () => ({
|
||
// The builder's own period read.
|
||
single: () =>
|
||
Promise.resolve({
|
||
data: {
|
||
id: 'fp1',
|
||
name: '2026',
|
||
period_start: '2026-01-01',
|
||
period_end: periodEnd,
|
||
},
|
||
error: null,
|
||
}),
|
||
// sumPostedYearEndDispositions reads closing_entry_id with
|
||
// .eq('id').eq('company_id').maybeSingle() to exclude the final
|
||
// bokslutsverifikation from the add-back (#1051).
|
||
maybeSingle: () =>
|
||
Promise.resolve({ data: { closing_entry_id: null }, error: null }),
|
||
}),
|
||
}),
|
||
}),
|
||
}
|
||
}
|
||
if (table === 'company_settings') {
|
||
return {
|
||
select: () => ({
|
||
eq: () => ({
|
||
maybeSingle: () =>
|
||
Promise.resolve({
|
||
data: { entity_type: opts.entityType },
|
||
error: null,
|
||
}),
|
||
}),
|
||
}),
|
||
}
|
||
}
|
||
if (table === 'companies') {
|
||
return {
|
||
select: () => ({
|
||
eq: () => ({
|
||
maybeSingle: () =>
|
||
Promise.resolve({
|
||
data: { accounting_framework: opts.accountingFramework },
|
||
error: null,
|
||
}),
|
||
}),
|
||
}),
|
||
}
|
||
}
|
||
if (table === 'journal_entry_lines') {
|
||
// Used by listExistingPeriodiseringsfonder and calculateSarskildLoneskatt.
|
||
// We return either the test-supplied periodiseringsfond rows (when the
|
||
// builder is walking 21xx) or an empty SLP result.
|
||
const rows = opts.periodiseringsfondRows
|
||
? opts.periodiseringsfondRows.flatMap((f) => [
|
||
{
|
||
account_number: f.account_number,
|
||
credit_amount: f.balance,
|
||
debit_amount: 0,
|
||
entry_date: `${f.cohort_year}-12-31`,
|
||
journal_entries: { entry_date: `${f.cohort_year}-12-31`, status: 'posted' },
|
||
},
|
||
])
|
||
: []
|
||
return {
|
||
select: () => {
|
||
// Make the chainable builder resolve to { data: rows, error: null }
|
||
const result: { data: typeof rows; error: null } = { data: rows, error: null }
|
||
const handler: ProxyHandler<object> = {
|
||
get(_t, prop) {
|
||
if (prop === 'then') {
|
||
return (resolve: (v: unknown) => void) => resolve(result)
|
||
}
|
||
return () => new Proxy({}, handler)
|
||
},
|
||
}
|
||
return new Proxy({}, handler)
|
||
},
|
||
}
|
||
}
|
||
// Catch-all chainable that resolves to empty.
|
||
const handler: ProxyHandler<object> = {
|
||
get(_t, prop) {
|
||
if (prop === 'then') {
|
||
return (resolve: (v: unknown) => void) =>
|
||
resolve({ data: null, error: null })
|
||
}
|
||
return () => new Proxy({}, handler)
|
||
},
|
||
}
|
||
return new Proxy({}, handler)
|
||
})
|
||
return { from } as ChainableMock
|
||
}
|
||
|
||
beforeEach(() => {
|
||
vi.clearAllMocks()
|
||
vi.mocked(calculateOveravskrivningar).mockResolvedValue({
|
||
status: 'not_applicable',
|
||
proposal: null,
|
||
warning: null,
|
||
currentReserve: 0,
|
||
currentPeriodChange: 0,
|
||
targetReserve: 0,
|
||
maximumSignedChange: 0,
|
||
})
|
||
// Zero result so the builder doesn't propose a new avsättning: keeps the
|
||
// 21xx balance stable at the trial-balance value, which makes the latent
|
||
// tax math testable in isolation.
|
||
vi.mocked(generateIncomeStatement).mockResolvedValue({
|
||
net_result: 0,
|
||
} as Awaited<ReturnType<typeof generateIncomeStatement>>)
|
||
vi.mocked(generateTrialBalance).mockResolvedValue({
|
||
rows: [
|
||
// 100 000 in periodiseringsfond → 20 600 latent tax target.
|
||
{
|
||
account_number: '2125',
|
||
account_name: 'Periodiseringsfond 2025',
|
||
account_class: 2,
|
||
closing_credit: 100_000,
|
||
closing_debit: 0,
|
||
opening_credit: 0,
|
||
opening_debit: 0,
|
||
period_credit: 100_000,
|
||
period_debit: 0,
|
||
},
|
||
// No existing 2240 balance.
|
||
],
|
||
totalDebit: 0,
|
||
totalCredit: 100_000,
|
||
isBalanced: false,
|
||
} as unknown as Awaited<ReturnType<typeof generateTrialBalance>>)
|
||
})
|
||
|
||
describe('buildDispositionsProposal: K3 framework', () => {
|
||
it('appends an uppskjuten_skatt proposal for K3 aktiebolag', async () => {
|
||
const supabase = makeSupabase({ entityType: 'aktiebolag', accountingFramework: 'k3' })
|
||
const result = await buildDispositionsProposal(
|
||
supabase as unknown as Parameters<typeof buildDispositionsProposal>[0],
|
||
'co',
|
||
'fp1',
|
||
)
|
||
expect(result.entityType).toBe('aktiebolag')
|
||
const latentTax = result.proposals.find((p) => p.kind === 'uppskjuten_skatt')
|
||
expect(latentTax).toBeDefined()
|
||
expect(latentTax!.amount).toBe(20_600)
|
||
expect(latentTax!.lines).toHaveLength(2)
|
||
// Liability increased → debit 8940 / credit 2240.
|
||
const debit = latentTax!.lines.find((l) => l.account_number === '8940')!
|
||
const credit = latentTax!.lines.find((l) => l.account_number === '2240')!
|
||
expect(debit.debit_amount).toBe(20_600)
|
||
expect(credit.credit_amount).toBe(20_600)
|
||
})
|
||
|
||
it('computes bolagsskatt on the result AFTER the periodiseringsfond avsättning', async () => {
|
||
// Regression (customer report): the preview computed bolagsskatt on the
|
||
// pre-disposition net result, ignoring the avsättning it proposes in the
|
||
// same snapshot: so the previewed/agent-facing tax was too high and
|
||
// diverged from ÅR/INK2. With a 1,000,000 result and no existing fonder:
|
||
// avsättning = 25 % × 1,000,000 = 250,000
|
||
// skattem. res = 1,000,000 − 250,000 = 750,000
|
||
// bolagsskatt = 20.6 % × 750,000 = 154,500 (NOT 206,000)
|
||
vi.mocked(generateIncomeStatement).mockResolvedValue({
|
||
net_result: 1_000_000,
|
||
} as Awaited<ReturnType<typeof generateIncomeStatement>>)
|
||
|
||
const supabase = makeSupabase({ entityType: 'aktiebolag', accountingFramework: 'k2' })
|
||
const result = await buildDispositionsProposal(
|
||
supabase as unknown as Parameters<typeof buildDispositionsProposal>[0],
|
||
'co',
|
||
'fp1',
|
||
)
|
||
|
||
const avsattning = result.proposals.find((p) => p.kind === 'periodiseringsfond_avsattning')
|
||
const bolagsskatt = result.proposals.find((p) => p.kind === 'bolagsskatt')
|
||
expect(avsattning?.amount).toBe(250_000)
|
||
expect(bolagsskatt?.amount).toBe(154_500)
|
||
})
|
||
|
||
it('includes excess depreciation in the periodiseringsfond and tax bases', async () => {
|
||
vi.mocked(generateIncomeStatement).mockResolvedValue({
|
||
net_result: 1_000_000,
|
||
} as Awaited<ReturnType<typeof generateIncomeStatement>>)
|
||
vi.mocked(calculateOveravskrivningar).mockResolvedValue({
|
||
status: 'ready',
|
||
proposal: {
|
||
kind: 'overavskrivningar',
|
||
label: 'Överavskrivningar',
|
||
description: 'Skillnad mellan bokförd och skattemässig avskrivning.',
|
||
amount: 100_000,
|
||
signedAmount: 100_000,
|
||
lines: [
|
||
{ account_number: '8853', debit_amount: 100_000, credit_amount: 0 },
|
||
{ account_number: '2153', debit_amount: 0, credit_amount: 100_000 },
|
||
],
|
||
warnings: [],
|
||
},
|
||
warning: null,
|
||
currentReserve: 0,
|
||
currentPeriodChange: 0,
|
||
targetReserve: 100_000,
|
||
maximumSignedChange: 100_000,
|
||
})
|
||
|
||
const supabase = makeSupabase({ entityType: 'aktiebolag', accountingFramework: 'k2' })
|
||
const result = await buildDispositionsProposal(
|
||
supabase as unknown as Parameters<typeof buildDispositionsProposal>[0],
|
||
'co',
|
||
'fp1',
|
||
)
|
||
|
||
const avsattning = result.proposals.find((p) => p.kind === 'periodiseringsfond_avsattning')
|
||
const bolagsskatt = result.proposals.find((p) => p.kind === 'bolagsskatt')
|
||
expect(avsattning?.amount).toBe(225_000)
|
||
expect(bolagsskatt?.amount).toBe(139_050)
|
||
})
|
||
|
||
it('includes a pending 2153 increase in the K3 latent tax proposal', async () => {
|
||
vi.mocked(calculateOveravskrivningar).mockResolvedValue({
|
||
status: 'ready',
|
||
proposal: {
|
||
kind: 'overavskrivningar',
|
||
label: 'Överavskrivningar',
|
||
description: 'Skillnad mellan bokförd och skattemässig avskrivning.',
|
||
amount: 10_000,
|
||
signedAmount: 10_000,
|
||
lines: [
|
||
{ account_number: '8853', debit_amount: 10_000, credit_amount: 0 },
|
||
{ account_number: '2153', debit_amount: 0, credit_amount: 10_000 },
|
||
],
|
||
warnings: [],
|
||
},
|
||
warning: null,
|
||
currentReserve: 0,
|
||
currentPeriodChange: 0,
|
||
targetReserve: 10_000,
|
||
maximumSignedChange: 10_000,
|
||
})
|
||
|
||
const supabase = makeSupabase({ entityType: 'aktiebolag', accountingFramework: 'k3' })
|
||
const result = await buildDispositionsProposal(
|
||
supabase as unknown as Parameters<typeof buildDispositionsProposal>[0],
|
||
'co',
|
||
'fp1',
|
||
)
|
||
|
||
const latentTax = result.proposals.find((p) => p.kind === 'uppskjuten_skatt')
|
||
expect(latentTax?.amount).toBe(22_660)
|
||
expect(latentTax?.computation).toEqual(
|
||
expect.objectContaining({ untaxedReserves: 110_000, target2240: 22_660 }),
|
||
)
|
||
})
|
||
|
||
it('does NOT add an uppskjuten_skatt proposal for K2 aktiebolag', async () => {
|
||
const supabase = makeSupabase({ entityType: 'aktiebolag', accountingFramework: 'k2' })
|
||
const result = await buildDispositionsProposal(
|
||
supabase as unknown as Parameters<typeof buildDispositionsProposal>[0],
|
||
'co',
|
||
'fp1',
|
||
)
|
||
expect(result.entityType).toBe('aktiebolag')
|
||
expect(result.proposals.find((p) => p.kind === 'uppskjuten_skatt')).toBeUndefined()
|
||
})
|
||
|
||
it('defaults to K2 when accounting_framework is null on the company row', async () => {
|
||
const supabase = makeSupabase({ entityType: 'aktiebolag', accountingFramework: null })
|
||
const result = await buildDispositionsProposal(
|
||
supabase as unknown as Parameters<typeof buildDispositionsProposal>[0],
|
||
'co',
|
||
'fp1',
|
||
)
|
||
expect(result.proposals.find((p) => p.kind === 'uppskjuten_skatt')).toBeUndefined()
|
||
})
|
||
|
||
it('does NOT add an uppskjuten_skatt proposal for enskild firma even if mislabelled K3', async () => {
|
||
// EF should never carry K3 (validation rejects it on the API side), but if
|
||
// somehow set the EF branch returns early with an empty proposal list.
|
||
const supabase = makeSupabase({ entityType: 'enskild_firma', accountingFramework: 'k3' })
|
||
const result = await buildDispositionsProposal(
|
||
supabase as unknown as Parameters<typeof buildDispositionsProposal>[0],
|
||
'co',
|
||
'fp1',
|
||
)
|
||
expect(result.entityType).toBe('enskild_firma')
|
||
expect(result.proposals).toEqual([])
|
||
})
|
||
|
||
it('skips uppskjuten_skatt when 2240 already matches target (no change)', async () => {
|
||
// Bump 2240 to exactly 20 600 so the delta is zero: calculator should
|
||
// return null and the builder skip the proposal entirely.
|
||
vi.mocked(generateTrialBalance).mockResolvedValue({
|
||
rows: [
|
||
{
|
||
account_number: '2125',
|
||
account_name: 'Periodiseringsfond 2025',
|
||
account_class: 2,
|
||
closing_credit: 100_000,
|
||
closing_debit: 0,
|
||
opening_credit: 0,
|
||
opening_debit: 0,
|
||
period_credit: 100_000,
|
||
period_debit: 0,
|
||
},
|
||
{
|
||
account_number: '2240',
|
||
account_name: 'Avsättningar för uppskjutna skatter',
|
||
account_class: 2,
|
||
closing_credit: 20_600,
|
||
closing_debit: 0,
|
||
opening_credit: 20_600,
|
||
opening_debit: 0,
|
||
period_credit: 0,
|
||
period_debit: 0,
|
||
},
|
||
],
|
||
totalDebit: 0,
|
||
totalCredit: 120_600,
|
||
isBalanced: false,
|
||
} as unknown as Awaited<ReturnType<typeof generateTrialBalance>>)
|
||
const supabase = makeSupabase({ entityType: 'aktiebolag', accountingFramework: 'k3' })
|
||
const result = await buildDispositionsProposal(
|
||
supabase as unknown as Parameters<typeof buildDispositionsProposal>[0],
|
||
'co',
|
||
'fp1',
|
||
)
|
||
expect(result.proposals.find((p) => p.kind === 'uppskjuten_skatt')).toBeUndefined()
|
||
})
|
||
})
|