db8983ba9e
* 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>
744 lines
27 KiB
TypeScript
744 lines
27 KiB
TypeScript
import { createJournalEntry, findFiscalPeriod } from './engine'
|
|
import { resolveSekAmount, buildCurrencyMetadata } from './currency-utils'
|
|
import { resolveBookingAccount } from './accruals/account-suggestions'
|
|
import { generateSalesVatLines } from './vat-entries'
|
|
import { getVatTreatmentForRate } from '@/lib/invoices/vat-rules'
|
|
import { computeDeduction } from '@/lib/invoices/rot-rut-rules'
|
|
import { createLogger } from '@/lib/logger'
|
|
import type { SupabaseClient } from '@supabase/supabase-js'
|
|
import type {
|
|
CreateJournalEntryInput,
|
|
CreateJournalEntryLineInput,
|
|
EntityType,
|
|
Invoice,
|
|
InvoiceItem,
|
|
JournalEntry,
|
|
VatTreatment,
|
|
} from '@/types'
|
|
|
|
const log = createLogger('invoice-entries')
|
|
|
|
/**
|
|
* Build the invoice identifier used in line_description. Prefers the assigned
|
|
* invoice number; falls back to a draft tag with the first 8 chars of the
|
|
* invoice UUID so the verifikation still identifies *vad affärshändelsen avser*
|
|
* per BFL 5 kap 6§ p.3 even if a journal entry is somehow created against an
|
|
* unnumbered invoice. The send path always assigns a number first, so this
|
|
* fallback is defensive — but it leaves no ambiguity if a future caller skips
|
|
* ensureInvoiceNumber.
|
|
*/
|
|
function invoiceTag(invoice: Pick<Invoice, 'id' | 'invoice_number'>): string {
|
|
return invoice.invoice_number ?? `utkast ${invoice.id.slice(0, 8)}`
|
|
}
|
|
|
|
/**
|
|
* Build a BFL-compliant verifikation description with event type and counterparty.
|
|
* Falls back to prefix + invoiceNumber if name is not provided (backward compat).
|
|
*/
|
|
function buildInvoiceDescription(
|
|
prefix: string, invoiceNumber: string | null, counterpartyName?: string,
|
|
invoiceId?: string,
|
|
): string {
|
|
const tag = invoiceNumber ?? (invoiceId ? `utkast ${invoiceId.slice(0, 8)}` : null)
|
|
const tagPart = tag ? ` ${tag}` : ''
|
|
return counterpartyName
|
|
? `${prefix}${tagPart}, ${counterpartyName}`
|
|
: `${prefix}${tagPart}`
|
|
}
|
|
|
|
/**
|
|
* Group invoice items by VAT rate and generate per-rate revenue + VAT lines.
|
|
* Returns credit lines only (revenue + VAT). The caller adds the debit side.
|
|
*
|
|
* options.deferAccruals: substitute the 29xx interim account for lines with a
|
|
* periodisering period. Only the callers that also create/cancel accrual
|
|
* schedules may pass true (invoice entry + credit note) — the cash-method
|
|
* entry books revenue directly even if a line carries stale accrual fields,
|
|
* since no schedule would ever dissolve the interim balance.
|
|
*/
|
|
function generatePerRateLines(
|
|
items: InvoiceItem[],
|
|
invoiceVatTreatment: VatTreatment,
|
|
entityType: EntityType,
|
|
invoiceTagText: string,
|
|
currency?: string | null,
|
|
exchangeRate?: number | null,
|
|
options?: { deferAccruals?: boolean }
|
|
): CreateJournalEntryLineInput[] {
|
|
const lines: CreateJournalEntryLineInput[] = []
|
|
const isForeign = currency != null && currency !== 'SEK'
|
|
|
|
// Free-text / blank rows carry no amounts and never book — drop them before
|
|
// grouping so they can't produce a zero-amount revenue line.
|
|
items = items.filter((item) => item.line_type !== 'text')
|
|
|
|
// Helper: convert item amount to SEK when dealing with foreign currency
|
|
const toSek = (amount: number): number => {
|
|
if (!isForeign) return amount
|
|
if (exchangeRate != null && exchangeRate > 0) {
|
|
return Math.round(amount * exchangeRate * 100) / 100
|
|
}
|
|
return amount // fallback for legacy data
|
|
}
|
|
|
|
// Check if items have per-line vat_rate set (new invoices)
|
|
const hasPerLineVat = items.some((item) => item.vat_rate !== undefined && item.vat_rate !== null)
|
|
|
|
if (!hasPerLineVat) {
|
|
// Legacy fallback: single rate from invoice level
|
|
const revenueAccount = getRevenueAccount(invoiceVatTreatment, entityType)
|
|
const subtotal = items.reduce((sum, item) => sum + item.line_total, 0)
|
|
const subtotalSek = toSek(subtotal)
|
|
lines.push({
|
|
account_number: revenueAccount,
|
|
debit_amount: 0,
|
|
credit_amount: subtotalSek,
|
|
line_description: `Försäljning faktura ${invoiceTagText}`,
|
|
})
|
|
|
|
const totalVat = items.reduce((sum, item) => sum + (item.vat_amount || 0), 0)
|
|
if (totalVat > 0) {
|
|
if (isForeign) {
|
|
// For foreign currency, compute VAT in SEK directly
|
|
const vatSek = toSek(totalVat)
|
|
const vatAccount = getOutputVatAccount(invoiceVatTreatment)
|
|
lines.push({
|
|
account_number: vatAccount,
|
|
debit_amount: 0,
|
|
credit_amount: vatSek,
|
|
line_description: `Utgående moms faktura ${invoiceTagText}`,
|
|
})
|
|
} else {
|
|
const vatLines = generateSalesVatLines({
|
|
vatTreatment: invoiceVatTreatment,
|
|
baseAmount: subtotal,
|
|
direction: 'sales',
|
|
})
|
|
lines.push(...vatLines)
|
|
}
|
|
}
|
|
return lines
|
|
}
|
|
|
|
// Group items by vat_rate (preserve first-seen rate order). Within each rate,
|
|
// sub-group revenue by the resolved BAS account so a per-line/article account
|
|
// override produces its own credit line. VAT stays aggregated per rate (the
|
|
// VAT account is a function of the treatment, never of the revenue override).
|
|
type RateGroup = {
|
|
vatAmount: number
|
|
// resolved revenue account -> summed line_total (first-seen account order)
|
|
byAccount: Map<string, number>
|
|
}
|
|
const rateGroups = new Map<number, RateGroup>()
|
|
|
|
for (const item of items) {
|
|
const rate = item.vat_rate ?? 0
|
|
const treatment = rate === 0 && (invoiceVatTreatment === 'reverse_charge' || invoiceVatTreatment === 'export')
|
|
? invoiceVatTreatment
|
|
: getVatTreatmentForRate(rate)
|
|
// reverse_charge / export force the statutory revenue account (3308/3305);
|
|
// a per-line override only applies to ordinary domestic rates so EU/export
|
|
// sales keep landing in the right VAT-declaration ruta.
|
|
const isSpecialTreatment = treatment === 'reverse_charge' || treatment === 'export'
|
|
const plAccount = !isSpecialTreatment && item.revenue_account
|
|
? item.revenue_account
|
|
: getRevenueAccount(treatment, entityType)
|
|
// Periodiserade lines credit the 29xx interim account (förutbetalda
|
|
// intäkter) instead of revenue; the schedule dissolves it monthly. Output
|
|
// VAT below is untouched — moms is never deferred. Special treatments are
|
|
// never deferred (ruta 39/40 must reflect the full period's sales).
|
|
const account = isSpecialTreatment || !options?.deferAccruals
|
|
? plAccount
|
|
: resolveBookingAccount('revenue', item, plAccount)
|
|
|
|
const group = rateGroups.get(rate) ?? { vatAmount: 0, byAccount: new Map<string, number>() }
|
|
group.vatAmount += item.vat_amount || 0
|
|
group.byAccount.set(account, (group.byAccount.get(account) ?? 0) + item.line_total)
|
|
rateGroups.set(rate, group)
|
|
}
|
|
|
|
// Generate revenue + VAT lines per rate group.
|
|
for (const [rate, group] of rateGroups) {
|
|
const treatment = rate === 0 && (invoiceVatTreatment === 'reverse_charge' || invoiceVatTreatment === 'export')
|
|
? invoiceVatTreatment
|
|
: getVatTreatmentForRate(rate)
|
|
|
|
// The rate-level rounded subtotal is the balance anchor — identical to the
|
|
// pre-override single-account behaviour. When a rate splits across multiple
|
|
// accounts, distribute that exact total so independent per-account rounding
|
|
// can never introduce a 1-öre imbalance against the 1510 debit: every
|
|
// account but the last rounds normally; the last absorbs the remainder.
|
|
const rateSubtotalSek = Math.round(
|
|
toSek(Array.from(group.byAccount.values()).reduce((sum, v) => sum + v, 0)) * 100
|
|
) / 100
|
|
|
|
const accounts = Array.from(group.byAccount.entries())
|
|
let allocated = 0
|
|
accounts.forEach(([account, subtotal], idx) => {
|
|
const isLast = idx === accounts.length - 1
|
|
const credit = isLast
|
|
? Math.round((rateSubtotalSek - allocated) * 100) / 100
|
|
: Math.round(toSek(subtotal) * 100) / 100
|
|
allocated = Math.round((allocated + credit) * 100) / 100
|
|
lines.push({
|
|
account_number: account,
|
|
debit_amount: 0,
|
|
credit_amount: credit,
|
|
line_description: `Försäljning faktura ${invoiceTagText}`,
|
|
})
|
|
})
|
|
|
|
const roundedVat = Math.round(toSek(group.vatAmount) * 100) / 100
|
|
if (roundedVat !== 0) {
|
|
const vatAccount = getOutputVatAccount(treatment)
|
|
lines.push({
|
|
account_number: vatAccount,
|
|
debit_amount: 0,
|
|
credit_amount: roundedVat,
|
|
line_description: `Utgående moms ${rate}% faktura ${invoiceTagText}`,
|
|
})
|
|
}
|
|
}
|
|
|
|
return lines
|
|
}
|
|
|
|
/**
|
|
* Generate ROT/RUT-avdrag debit lines from invoice items.
|
|
*
|
|
* For each item flagged with `deduction_type`, produces a debit on BAS 1513
|
|
* (Övriga kortfristiga fordringar — Skatteverket) for the computed
|
|
* deduction amount. The caller must REDUCE the 1510 debit (kundfordringar)
|
|
* by the same total — the customer only owes the post-deduction amount;
|
|
* Skatteverket pays the rest via Husavdragstjänsten. Returns both the
|
|
* lines and the total so callers can apply both adjustments atomically.
|
|
*
|
|
* Foreign-currency invoices: ROT/RUT-avdrag is a Sweden-only rule, so
|
|
* receivables on 1513 are always recorded in SEK. We use the same SEK
|
|
* conversion as the rest of the entry (toSek closure logic on the caller
|
|
* side reproduced here for parity with generatePerRateLines).
|
|
*/
|
|
function generateRotRutLines(
|
|
items: InvoiceItem[],
|
|
invoiceTagText: string,
|
|
currency?: string | null,
|
|
exchangeRate?: number | null,
|
|
): { lines: CreateJournalEntryLineInput[]; totalSek: number } {
|
|
const lines: CreateJournalEntryLineInput[] = []
|
|
const isForeign = currency != null && currency !== 'SEK'
|
|
|
|
const toSek = (amount: number): number => {
|
|
if (!isForeign) return amount
|
|
if (exchangeRate != null && exchangeRate > 0) {
|
|
return Math.round(amount * exchangeRate * 100) / 100
|
|
}
|
|
return amount
|
|
}
|
|
|
|
let totalSek = 0
|
|
|
|
for (const item of items) {
|
|
if (!item.deduction_type) continue
|
|
// Recompute server-side to defend against tampered client values.
|
|
const amount = computeDeduction({
|
|
unit_price: item.unit_price,
|
|
quantity: item.quantity,
|
|
deduction_type: item.deduction_type,
|
|
})
|
|
if (amount <= 0) continue
|
|
const amountSek = Math.round(toSek(amount) * 100) / 100
|
|
if (amountSek <= 0) continue
|
|
totalSek += amountSek
|
|
const kind = item.deduction_type === 'rot' ? 'ROT' : 'RUT'
|
|
lines.push({
|
|
account_number: '1513',
|
|
debit_amount: amountSek,
|
|
credit_amount: 0,
|
|
line_description: `${kind}-avdrag faktura ${invoiceTagText}`,
|
|
})
|
|
}
|
|
|
|
return { lines, totalSek: Math.round(totalSek * 100) / 100 }
|
|
}
|
|
|
|
/**
|
|
* Create journal entry when an invoice is created (status != draft)
|
|
*
|
|
* Supports mixed VAT rates per line item. Groups items by vat_rate
|
|
* and creates separate revenue + VAT lines per rate.
|
|
*
|
|
* Standard domestic invoice (25% VAT):
|
|
* Debit 1510 Kundfordringar [total incl VAT]
|
|
* Credit 30xx Försäljning [subtotal per rate]
|
|
* Credit 26xx Utgående moms [vat per rate]
|
|
*
|
|
* EU reverse charge:
|
|
* Debit 1510 Kundfordringar [subtotal]
|
|
* Credit 3308 Försäljning tjänst EU [subtotal]
|
|
*
|
|
* Export (non-EU):
|
|
* Debit 1510 Kundfordringar [subtotal]
|
|
* Credit 3305 Försäljning tjänst Export [subtotal]
|
|
*/
|
|
export async function createInvoiceJournalEntry(
|
|
supabase: SupabaseClient,
|
|
companyId: string,
|
|
userId: string,
|
|
invoice: Invoice,
|
|
entityType: EntityType = 'enskild_firma',
|
|
customerName?: string,
|
|
/**
|
|
* Overrides for non-standard sales that still book identically to a customer
|
|
* invoice. Used by self-billing received (mottagen självfaktura): the
|
|
* verifikation should read "Självfaktura <external number>" rather than
|
|
* "Kundfaktura <our number>", and the number tag must be the counterparty's
|
|
* external number because the row has no own `invoice_number`.
|
|
*/
|
|
options?: { descriptionPrefix?: string; numberOverride?: string | null }
|
|
): Promise<JournalEntry | null> {
|
|
const fiscalPeriodId = await findFiscalPeriod(supabase, companyId, invoice.invoice_date)
|
|
if (!fiscalPeriodId) {
|
|
log.warn('No open fiscal period found for invoice date:', invoice.invoice_date)
|
|
return null
|
|
}
|
|
|
|
const lines: CreateJournalEntryLineInput[] = []
|
|
const isForeign = invoice.currency !== 'SEK'
|
|
const tag = options?.numberOverride ?? invoiceTag(invoice)
|
|
|
|
// Credit lines: revenue + VAT per rate group (compute first to guarantee balance)
|
|
const creditLines: CreateJournalEntryLineInput[] = []
|
|
|
|
if (invoice.items && invoice.items.length > 0) {
|
|
creditLines.push(...generatePerRateLines(
|
|
invoice.items, invoice.vat_treatment, entityType, tag,
|
|
invoice.currency, invoice.exchange_rate,
|
|
// Schedules are created right after this entry commits (send/mark-sent
|
|
// flows), so deferring to 29xx here is safe.
|
|
{ deferAccruals: true }
|
|
))
|
|
} else {
|
|
// Fallback: no items available, use invoice-level amounts
|
|
const revenueAccount = getRevenueAccount(invoice.vat_treatment, entityType)
|
|
const subtotalSek = resolveSekAmount(invoice.subtotal, invoice.subtotal_sek, invoice.currency, invoice.exchange_rate)
|
|
|
|
creditLines.push({
|
|
account_number: revenueAccount,
|
|
debit_amount: 0,
|
|
credit_amount: subtotalSek,
|
|
line_description: `Försäljning faktura ${tag}`,
|
|
})
|
|
|
|
if (invoice.vat_amount > 0) {
|
|
if (isForeign) {
|
|
const vatSek = resolveSekAmount(invoice.vat_amount, invoice.vat_amount_sek, invoice.currency, invoice.exchange_rate)
|
|
const vatAccount = getOutputVatAccount(invoice.vat_treatment)
|
|
creditLines.push({
|
|
account_number: vatAccount,
|
|
debit_amount: 0,
|
|
credit_amount: vatSek,
|
|
line_description: `Utgående moms faktura ${tag}`,
|
|
})
|
|
} else {
|
|
const vatLines = generateSalesVatLines({
|
|
vatTreatment: invoice.vat_treatment,
|
|
baseAmount: invoice.subtotal,
|
|
direction: 'sales',
|
|
})
|
|
creditLines.push(...vatLines)
|
|
}
|
|
}
|
|
}
|
|
|
|
// ROT/RUT-avdrag debit lines (1513 Skatteverket). When present, they
|
|
// reduce the 1510 debit by the same total so the verifikation stays
|
|
// balanced (debits 1510 + 1513 = credits revenue + VAT). The customer
|
|
// only owes the post-deduction amount; Skatteverket pays the rest.
|
|
const rotRut = invoice.items && invoice.items.length > 0
|
|
? generateRotRutLines(invoice.items, tag, invoice.currency, invoice.exchange_rate)
|
|
: { lines: [], totalSek: 0 }
|
|
|
|
// Debit: Kundfordringar — balance guarantee: debit = sum of all credit
|
|
// lines MINUS the ROT/RUT total which goes to 1513 instead.
|
|
const totalCredits = creditLines.reduce((sum, l) => sum + l.credit_amount, 0)
|
|
const debitAmount = isForeign
|
|
? Math.round(totalCredits * 100) / 100
|
|
: resolveSekAmount(invoice.total, invoice.total_sek, invoice.currency, invoice.exchange_rate)
|
|
const arAmount = Math.round((debitAmount - rotRut.totalSek) * 100) / 100
|
|
|
|
lines.push({
|
|
account_number: '1510',
|
|
debit_amount: arAmount,
|
|
credit_amount: 0,
|
|
line_description: `Faktura ${tag}`,
|
|
...buildCurrencyMetadata(invoice.currency, isForeign ? invoice.total : undefined, invoice.exchange_rate),
|
|
})
|
|
|
|
lines.push(...rotRut.lines)
|
|
lines.push(...creditLines)
|
|
|
|
const input: CreateJournalEntryInput = {
|
|
fiscal_period_id: fiscalPeriodId,
|
|
entry_date: invoice.invoice_date,
|
|
description: buildInvoiceDescription(
|
|
options?.descriptionPrefix ?? 'Kundfaktura',
|
|
options?.numberOverride ?? invoice.invoice_number,
|
|
customerName,
|
|
invoice.id,
|
|
),
|
|
source_type: 'invoice_created',
|
|
source_id: invoice.id,
|
|
lines,
|
|
}
|
|
|
|
return createJournalEntry(supabase, companyId, userId, input)
|
|
}
|
|
|
|
/**
|
|
* Create journal entry when an invoice is marked as paid
|
|
*
|
|
* Debit 1930 Företagskonto [total]
|
|
* Credit 1510 Kundfordringar [total]
|
|
*/
|
|
export async function createInvoicePaymentJournalEntry(
|
|
supabase: SupabaseClient,
|
|
companyId: string,
|
|
userId: string,
|
|
invoice: Invoice,
|
|
paymentDate: string,
|
|
exchangeRateDifference?: number,
|
|
customerName?: string,
|
|
paymentAmount?: number
|
|
): Promise<JournalEntry | null> {
|
|
const fiscalPeriodId = await findFiscalPeriod(supabase, companyId, paymentDate)
|
|
if (!fiscalPeriodId) {
|
|
log.warn('No open fiscal period found for payment date:', paymentDate)
|
|
return null
|
|
}
|
|
|
|
const isPartial = paymentAmount != null
|
|
const desc = buildInvoiceDescription(
|
|
isPartial ? 'Delbetalning kundfaktura' : 'Inbetalning kundfaktura',
|
|
invoice.invoice_number,
|
|
customerName,
|
|
invoice.id,
|
|
)
|
|
|
|
// When paymentAmount is provided, use it for the 1930/1510 line amounts.
|
|
// Otherwise use the full invoice total (backward compatible).
|
|
const bookedSekAmount = isPartial
|
|
? resolveSekAmount(paymentAmount, null, invoice.currency, invoice.exchange_rate)
|
|
: resolveSekAmount(invoice.total, invoice.total_sek, invoice.currency, invoice.exchange_rate)
|
|
|
|
const lines: CreateJournalEntryLineInput[] = []
|
|
|
|
if (!isPartial && exchangeRateDifference && exchangeRateDifference !== 0) {
|
|
// Foreign currency with exchange rate difference
|
|
// For receivables: positive diff = gain (received more), negative = loss (received less)
|
|
const actualSekReceived = bookedSekAmount + exchangeRateDifference
|
|
|
|
// Debit: Bank at actual SEK received
|
|
lines.push({
|
|
account_number: '1930',
|
|
debit_amount: Math.round(actualSekReceived * 100) / 100,
|
|
credit_amount: 0,
|
|
line_description: desc,
|
|
})
|
|
|
|
// Credit: Clear kundfordringar at original booked SEK amount
|
|
lines.push({
|
|
account_number: '1510',
|
|
debit_amount: 0,
|
|
credit_amount: Math.round(bookedSekAmount * 100) / 100,
|
|
line_description: desc,
|
|
})
|
|
|
|
// Exchange rate difference
|
|
if (exchangeRateDifference > 0) {
|
|
// Gain: Credit 3960 (received more than booked)
|
|
lines.push({
|
|
account_number: '3960',
|
|
debit_amount: 0,
|
|
credit_amount: Math.round(exchangeRateDifference * 100) / 100,
|
|
line_description: 'Valutakursvinst',
|
|
})
|
|
} else {
|
|
// Loss: Debit 7960 (received less than booked)
|
|
lines.push({
|
|
account_number: '7960',
|
|
debit_amount: Math.round(Math.abs(exchangeRateDifference) * 100) / 100,
|
|
credit_amount: 0,
|
|
line_description: 'Valutakursförlust',
|
|
})
|
|
}
|
|
} else {
|
|
// Standard SEK payment or no exchange rate difference
|
|
lines.push(
|
|
{
|
|
account_number: '1930',
|
|
debit_amount: Math.round(bookedSekAmount * 100) / 100,
|
|
credit_amount: 0,
|
|
line_description: desc,
|
|
},
|
|
{
|
|
account_number: '1510',
|
|
debit_amount: 0,
|
|
credit_amount: Math.round(bookedSekAmount * 100) / 100,
|
|
line_description: desc,
|
|
}
|
|
)
|
|
}
|
|
|
|
const input: CreateJournalEntryInput = {
|
|
fiscal_period_id: fiscalPeriodId,
|
|
entry_date: paymentDate,
|
|
description: desc,
|
|
source_type: 'invoice_paid',
|
|
source_id: invoice.id,
|
|
lines,
|
|
}
|
|
|
|
return createJournalEntry(supabase, companyId, userId, input)
|
|
}
|
|
|
|
/**
|
|
* Create journal entry for a credit note (reversed version of original invoice entry)
|
|
* Supports per-item VAT rates with reversed debit/credit sides.
|
|
*
|
|
* Debit 30xx Försäljning [subtotal per rate]
|
|
* Debit 26xx Utgående moms [vat per rate]
|
|
* Credit 1510 Kundfordringar [total]
|
|
*/
|
|
export async function createCreditNoteJournalEntry(
|
|
supabase: SupabaseClient,
|
|
companyId: string,
|
|
userId: string,
|
|
creditNote: Invoice,
|
|
entityType: EntityType = 'enskild_firma',
|
|
customerName?: string,
|
|
/**
|
|
* Original voucher reference (e.g. "A-42") to embed in the JE description and
|
|
* line-level descriptions. BFL 5 kap. 5 § requires a correction to point back
|
|
* to the corrected verifikation; the invoice number alone is insufficient
|
|
* because it doesn't identify the entry in the verifikationsserie.
|
|
*/
|
|
originalVoucherRef?: string
|
|
): Promise<JournalEntry | null> {
|
|
const fiscalPeriodId = await findFiscalPeriod(supabase, companyId, creditNote.invoice_date)
|
|
if (!fiscalPeriodId) {
|
|
log.warn('No open fiscal period found for credit note date:', creditNote.invoice_date)
|
|
return null
|
|
}
|
|
|
|
const lines: CreateJournalEntryLineInput[] = []
|
|
const tag = invoiceTag(creditNote)
|
|
const lineSuffix = originalVoucherRef ? ` (avser ${originalVoucherRef})` : ''
|
|
|
|
// Generate reversed revenue + VAT lines per rate group (debit side for credit notes)
|
|
const debitLines: CreateJournalEntryLineInput[] = []
|
|
|
|
if (creditNote.items && creditNote.items.length > 0) {
|
|
// Use absolute items for generatePerRateLines, then swap debit/credit
|
|
const creditLines = generatePerRateLines(
|
|
creditNote.items, creditNote.vat_treatment, entityType, tag,
|
|
creditNote.currency, creditNote.exchange_rate,
|
|
// Credit-note items carry the original's accrual fields so the reversal
|
|
// hits the same 29xx interim account; the original's schedule is
|
|
// cancelled/stornoed by the credit flow.
|
|
{ deferAccruals: true }
|
|
)
|
|
for (const line of creditLines) {
|
|
debitLines.push({
|
|
...line,
|
|
debit_amount: Math.abs(line.credit_amount),
|
|
credit_amount: Math.abs(line.debit_amount),
|
|
line_description: `Kreditfaktura ${tag}${lineSuffix}`,
|
|
})
|
|
}
|
|
} else {
|
|
// Fallback: invoice-level amounts
|
|
const revenueAccount = getRevenueAccount(creditNote.vat_treatment, entityType)
|
|
const absSubtotal = Math.abs(resolveSekAmount(creditNote.subtotal, creditNote.subtotal_sek, creditNote.currency, creditNote.exchange_rate))
|
|
const absVat = Math.abs(resolveSekAmount(creditNote.vat_amount, creditNote.vat_amount_sek, creditNote.currency, creditNote.exchange_rate))
|
|
|
|
debitLines.push({
|
|
account_number: revenueAccount,
|
|
debit_amount: absSubtotal,
|
|
credit_amount: 0,
|
|
line_description: `Kreditfaktura ${tag}`,
|
|
})
|
|
|
|
if (absVat > 0) {
|
|
const vatAccount = getOutputVatAccount(creditNote.vat_treatment)
|
|
debitLines.push({
|
|
account_number: vatAccount,
|
|
debit_amount: absVat,
|
|
credit_amount: 0,
|
|
line_description: `Moms kreditfaktura ${tag}${lineSuffix}`,
|
|
})
|
|
}
|
|
}
|
|
|
|
lines.push(...debitLines)
|
|
|
|
// Credit: Kundfordringar — balance guarantee: credit = sum of all debit lines
|
|
const totalDebits = debitLines.reduce((sum, l) => sum + l.debit_amount, 0)
|
|
lines.push({
|
|
account_number: '1510',
|
|
debit_amount: 0,
|
|
credit_amount: Math.round(totalDebits * 100) / 100,
|
|
line_description: `Kreditfaktura ${tag}`,
|
|
})
|
|
|
|
const baseDescription = buildInvoiceDescription('Kreditfaktura', creditNote.invoice_number, customerName, creditNote.id)
|
|
const input: CreateJournalEntryInput = {
|
|
fiscal_period_id: fiscalPeriodId,
|
|
entry_date: creditNote.invoice_date,
|
|
description: originalVoucherRef
|
|
? `${baseDescription} (avser verifikation ${originalVoucherRef})`
|
|
: baseDescription,
|
|
source_type: 'credit_note',
|
|
source_id: creditNote.id,
|
|
lines,
|
|
}
|
|
|
|
return createJournalEntry(supabase, companyId, userId, input)
|
|
}
|
|
|
|
/**
|
|
* Create journal entry for kontantmetoden (cash method) when payment is received.
|
|
* Supports per-item VAT rates. Revenue + VAT recognised at payment.
|
|
*
|
|
* Debit 1930 Företagskonto [total]
|
|
* Credit 30xx Försäljning [subtotal per rate]
|
|
* Credit 26xx Utgående moms [vat per rate] (if applicable)
|
|
*/
|
|
export async function createInvoiceCashEntry(
|
|
supabase: SupabaseClient,
|
|
companyId: string,
|
|
userId: string,
|
|
invoice: Invoice,
|
|
paymentDate: string,
|
|
entityType: EntityType = 'enskild_firma',
|
|
customerName?: string
|
|
): Promise<JournalEntry | null> {
|
|
const fiscalPeriodId = await findFiscalPeriod(supabase, companyId, paymentDate)
|
|
if (!fiscalPeriodId) {
|
|
log.warn('No open fiscal period found for payment date:', paymentDate)
|
|
return null
|
|
}
|
|
|
|
const lines: CreateJournalEntryLineInput[] = []
|
|
const isForeign = invoice.currency !== 'SEK'
|
|
const tag = invoiceTag(invoice)
|
|
|
|
// Credit lines: revenue + VAT per rate group (compute first to guarantee balance)
|
|
const creditLines: CreateJournalEntryLineInput[] = []
|
|
|
|
if (invoice.items && invoice.items.length > 0) {
|
|
creditLines.push(...generatePerRateLines(
|
|
invoice.items, invoice.vat_treatment, entityType, tag,
|
|
invoice.currency, invoice.exchange_rate
|
|
))
|
|
} else {
|
|
// Fallback: invoice-level amounts
|
|
const revenueAccount = getRevenueAccount(invoice.vat_treatment, entityType)
|
|
const subtotalSek = resolveSekAmount(invoice.subtotal, invoice.subtotal_sek, invoice.currency, invoice.exchange_rate)
|
|
|
|
creditLines.push({
|
|
account_number: revenueAccount,
|
|
debit_amount: 0,
|
|
credit_amount: subtotalSek,
|
|
line_description: `Försäljning faktura ${tag}`,
|
|
})
|
|
|
|
if (invoice.vat_amount > 0) {
|
|
const vatSek = resolveSekAmount(invoice.vat_amount, invoice.vat_amount_sek, invoice.currency, invoice.exchange_rate)
|
|
const vatAccount = getOutputVatAccount(invoice.vat_treatment)
|
|
creditLines.push({
|
|
account_number: vatAccount,
|
|
debit_amount: 0,
|
|
credit_amount: vatSek,
|
|
line_description: `Utgående moms faktura ${tag}`,
|
|
})
|
|
}
|
|
}
|
|
|
|
// ROT/RUT-avdrag debit lines (1513 Skatteverket). On cash method the
|
|
// bank account (1930) receives only the post-deduction amount in real
|
|
// life; the rest comes from Skatteverket later. We model that by
|
|
// splitting the debit: 1930 = total - deduction, 1513 = deduction.
|
|
const rotRut = invoice.items && invoice.items.length > 0
|
|
? generateRotRutLines(invoice.items, tag, invoice.currency, invoice.exchange_rate)
|
|
: { lines: [], totalSek: 0 }
|
|
|
|
// Debit: Företagskonto — balance guarantee: debit = sum of credit lines
|
|
// minus the ROT/RUT total which goes to 1513 instead.
|
|
const totalCredits = creditLines.reduce((sum, l) => sum + l.credit_amount, 0)
|
|
const cashDebit = isForeign
|
|
? Math.round(totalCredits * 100) / 100
|
|
: resolveSekAmount(invoice.total, invoice.total_sek, invoice.currency, invoice.exchange_rate)
|
|
const bankAmount = Math.round((cashDebit - rotRut.totalSek) * 100) / 100
|
|
lines.push({
|
|
account_number: '1930',
|
|
debit_amount: bankAmount,
|
|
credit_amount: 0,
|
|
line_description: buildInvoiceDescription('Kontantbetalning kundfaktura', invoice.invoice_number, customerName, invoice.id),
|
|
})
|
|
|
|
lines.push(...rotRut.lines)
|
|
lines.push(...creditLines)
|
|
|
|
const input: CreateJournalEntryInput = {
|
|
fiscal_period_id: fiscalPeriodId,
|
|
entry_date: paymentDate,
|
|
description: buildInvoiceDescription('Kontantbetalning kundfaktura', invoice.invoice_number, customerName, invoice.id),
|
|
source_type: 'invoice_cash_payment',
|
|
source_id: invoice.id,
|
|
lines,
|
|
}
|
|
|
|
return createJournalEntry(supabase, companyId, userId, input)
|
|
}
|
|
|
|
/**
|
|
* Get the appropriate revenue account based on VAT treatment
|
|
*
|
|
* For 'exempt': AB uses 3004 (Försäljning inom Sverige, momsfri),
|
|
* EF uses 3100 (Momsfria intäkter, mapped to R2 in NE engine).
|
|
*/
|
|
export function getRevenueAccount(vatTreatment: VatTreatment, entityType: EntityType = 'enskild_firma'): string {
|
|
switch (vatTreatment) {
|
|
case 'standard_25':
|
|
return '3001' // Försäljning 25%
|
|
case 'reduced_12':
|
|
return '3002' // Försäljning 12%
|
|
case 'reduced_6':
|
|
return '3003' // Försäljning 6%
|
|
case 'reverse_charge':
|
|
return '3308' // Försäljning tjänst EU
|
|
case 'export':
|
|
return '3305' // Försäljning tjänst Export
|
|
case 'exempt':
|
|
return entityType === 'aktiebolag' ? '3004' : '3100'
|
|
default:
|
|
return '3001'
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the output VAT account based on VAT treatment
|
|
*/
|
|
export function getOutputVatAccount(vatTreatment: VatTreatment): string {
|
|
switch (vatTreatment) {
|
|
case 'standard_25':
|
|
return '2611'
|
|
case 'reduced_12':
|
|
return '2621'
|
|
case 'reduced_6':
|
|
return '2631'
|
|
default:
|
|
return '2611'
|
|
}
|
|
}
|