Files
accounted/lib/payments/__tests__/batch-service.test.ts
T
Jakob Wennberg 4655f3da48 fix(payments): creditor address per Swedbank TwnNm rule (Validex round 2) (#1508)
A present PstlAdr must carry TwnNm from November 2026 (PFH_222), so
BGNR-to-BGNR payments now carry no creditor address at all (rule 020
requires none there), IBAN-debited payments carry the supplier's town
(snapshotted as payee_city) plus Ctry SE, and the debtor address comes
from company settings, clearing the info-level rule 236 as well.

Co-authored-by: Jakob Wennberg <311770904+jakobwennberg-oss@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-08-10 21:19:44 +02:00

464 lines
14 KiB
TypeScript

import { beforeEach, describe, expect, it, vi } from 'vitest'
import type { SupabaseClient } from '@supabase/supabase-js'
import { eventBus } from '@/lib/events'
import { createQueuedMockSupabase } from '@/tests/helpers'
import {
createSupplierPaymentBatch,
previewSupplierPaymentBatch,
renderSupplierPaymentBatchFile,
} from '@/lib/payments/batch-service'
import type { SupplierPaymentBatch, SupplierPaymentBatchItem } from '@/types'
const COMPANY_ID = 'c0000000-0000-0000-0000-000000000001'
const USER_ID = 'u0000000-0000-0000-0000-000000000001'
const companyRow = { name: 'Testbolaget AB', org_number: '556677-8899' }
const settingsRow = {
company_name: 'Testbolaget AB',
org_number: '556677-8899',
city: 'Stockholm',
iban: 'SE3550000000054910000003',
bic: 'ESSESESS',
bankgiro: '991-2346',
clearing_number: null,
bank_name: null,
}
function invoiceRow(overrides: Record<string, unknown> = {}) {
return {
id: 'inv-1',
status: 'approved',
approved_at: '2026-08-01T10:00:00Z',
due_date: '2099-08-20',
remaining_amount: 737.5,
currency: 'SEK',
is_credit_note: false,
payment_reference: null,
supplier_invoice_number: 'CD3014794407',
supplier: {
id: 'sup-1',
name: 'Derome Bygg & Industri AB',
city: 'Veddige',
bankgiro: '5050-1055',
plusgiro: null,
bank_account: null,
clearing_number: null,
account_number: null,
},
...overrides,
}
}
function batchRow(overrides: Record<string, unknown> = {}): SupplierPaymentBatch {
return {
id: 'b0000000-0000-0000-0000-000000000001',
company_id: COMPANY_ID,
user_id: USER_ID,
format: 'pain001',
status: 'created',
currency: 'SEK',
total_amount: 737.5,
item_count: 1,
msg_id: 'ACCOUNTED-5566778899-BB0000000',
debtor_snapshot: {
name: 'Testbolaget AB',
org_number: '556677-8899',
iban: 'SE3550000000054910000003',
bic: 'ESSESESS',
},
file_generated_at: null,
download_count: 0,
cancelled_at: null,
cancelled_by: null,
created_at: '2026-08-10T12:00:00Z',
updated_at: '2026-08-10T12:00:00Z',
...overrides,
} as SupplierPaymentBatch
}
describe('previewSupplierPaymentBatch', () => {
beforeEach(() => {
vi.clearAllMocks()
eventBus.clear()
})
it('returns eligible lines with payee, reference and totals', async () => {
const mock = createQueuedMockSupabase()
// from() order: supplier_invoices, batch items (active map), companies, settings
mock.enqueueMany([
{ data: [invoiceRow()] },
{ data: [] },
{ data: companyRow },
{ data: settingsRow },
])
const preview = await previewSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
{ ids: ['inv-1'] },
)
expect(preview.excluded).toEqual([])
expect(preview.eligible).toHaveLength(1)
expect(preview.eligible[0]).toMatchObject({
id: 'inv-1',
supplier_name: 'Derome Bygg & Industri AB',
amount: 737.5,
payment_date: '2099-08-20',
payee: { type: 'bankgiro', label: 'BG 5050-1055' },
reference: { type: 'invoice_number', value: 'CD3014794407' },
warnings: [],
})
expect(preview.total).toBe(737.5)
expect(preview.debtor_ok).toBe(true)
})
it('excludes ineligible invoices with a reason and unknown ids as not_found', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([
{ data: [invoiceRow({ status: 'paid' })] },
{ data: [] },
{ data: companyRow },
{ data: settingsRow },
])
const preview = await previewSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
{ ids: ['inv-1', 'inv-ghost'] },
)
expect(preview.eligible).toEqual([])
expect(preview.excluded).toEqual([
{ id: 'inv-1', reason: 'not_payable' },
{ id: 'inv-ghost', reason: 'not_found' },
])
})
it('fails closed when the active-batch lookup errors', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([
{ data: [invoiceRow()] },
{ error: { message: 'relation missing' } },
{ data: companyRow },
{ data: settingsRow },
])
await expect(
previewSupplierPaymentBatch(mock.supabase as unknown as SupabaseClient, COMPANY_ID, {
ids: ['inv-1'],
}),
).rejects.toBeTruthy()
})
it('reports a missing debtor IBAN without blocking the preview', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([
{ data: [invoiceRow()] },
{ data: [] },
{ data: companyRow },
{ data: { ...settingsRow, iban: null } },
])
const preview = await previewSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
{ ids: ['inv-1'] },
)
expect(preview.debtor_ok).toBe(false)
expect(preview.debtor_missing).toBe('iban')
expect(preview.eligible).toHaveLength(1)
})
})
describe('createSupplierPaymentBatch', () => {
beforeEach(() => {
vi.clearAllMocks()
eventBus.clear()
})
// from() order for create: companies, settings (debtor first), then
// supplier_invoices, batch items, then the two inserts.
it('creates a batch with snapshotted payee rows and a derived msg_id', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([
{ data: companyRow },
{ data: settingsRow },
{ data: [invoiceRow()] },
{ data: [] },
{ data: batchRow() },
{ data: null },
])
const result = await createSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
USER_ID,
{ format: 'pain001', items: [{ supplier_invoice_id: 'inv-1' }] },
)
expect(result.ok).toBe(true)
const batchInsert = mock.findCall('supplier_payment_batches', 'insert')?.[0] as Record<
string,
unknown
>
expect(batchInsert).toMatchObject({
company_id: COMPANY_ID,
user_id: USER_ID,
format: 'pain001',
status: 'created',
currency: 'SEK',
total_amount: 737.5,
item_count: 1,
debtor_snapshot: {
name: 'Testbolaget AB',
org_number: '556677-8899',
iban: 'SE3550000000054910000003',
bic: 'ESSESESS',
bankgiro: '9912346',
city: 'Stockholm',
},
})
const msgId = batchInsert.msg_id as string
expect(msgId.startsWith('ACCOUNTED-5566778899-B')).toBe(true)
expect(msgId.length).toBeLessThanOrEqual(35)
const itemsInsert = mock.findCall('supplier_payment_batch_items', 'insert')?.[0] as Array<
Record<string, unknown>
>
expect(itemsInsert).toHaveLength(1)
expect(itemsInsert[0]).toMatchObject({
batch_id: batchInsert.id,
company_id: COMPANY_ID,
supplier_invoice_id: 'inv-1',
amount: 737.5,
payment_date: '2099-08-20',
payee_type: 'bankgiro',
payee_bankgiro: '50501055',
payee_name: 'Derome Bygg & Industri AB',
payee_city: 'Veddige',
reference_type: 'invoice_number',
reference: 'CD3014794407',
})
})
it('rejects the whole batch when any invoice is ineligible', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([
{ data: companyRow },
{ data: settingsRow },
{ data: [invoiceRow(), invoiceRow({ id: 'inv-2', currency: 'EUR' })] },
{ data: [] },
])
const result = await createSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
USER_ID,
{
format: 'pain001',
items: [{ supplier_invoice_id: 'inv-1' }, { supplier_invoice_id: 'inv-2' }],
},
)
expect(result).toEqual({
ok: false,
code: 'ineligible',
details: [{ id: 'inv-2', reason: 'foreign_currency' }],
})
expect(mock.findCall('supplier_payment_batches', 'insert')).toBeUndefined()
})
it('rejects an amount override above the remaining amount', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([
{ data: companyRow },
{ data: settingsRow },
{ data: [invoiceRow()] },
{ data: [] },
])
const result = await createSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
USER_ID,
{ format: 'pain001', items: [{ supplier_invoice_id: 'inv-1', amount: 800 }] },
)
expect(result).toEqual({
ok: false,
code: 'amount_exceeds_remaining',
details: [{ id: 'inv-1' }],
})
})
it('refuses an invoice already in an active batch unless confirmed', async () => {
const mock = createQueuedMockSupabase()
const activeItems = [
{ supplier_invoice_id: 'inv-1', batch: { id: 'batch-9', status: 'created' } },
]
mock.enqueueMany([
{ data: companyRow },
{ data: settingsRow },
{ data: [invoiceRow()] },
{ data: activeItems },
])
const result = await createSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
USER_ID,
{ format: 'pain001', items: [{ supplier_invoice_id: 'inv-1' }] },
)
expect(result).toEqual({
ok: false,
code: 'already_batched',
details: [{ id: 'inv-1', batch_id: 'batch-9' }],
})
})
it('proceeds past an active batch when explicitly confirmed', async () => {
const mock = createQueuedMockSupabase()
const activeItems = [
{ supplier_invoice_id: 'inv-1', batch: { id: 'batch-9', status: 'created' } },
]
mock.enqueueMany([
{ data: companyRow },
{ data: settingsRow },
{ data: [invoiceRow()] },
{ data: activeItems },
{ data: batchRow() },
{ data: null },
])
const result = await createSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
USER_ID,
{
format: 'pain001',
items: [{ supplier_invoice_id: 'inv-1' }],
confirm_already_batched: true,
},
)
expect(result.ok).toBe(true)
})
it('fails closed when the active-batch lookup errors instead of skipping the guard', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([
{ data: companyRow },
{ data: settingsRow },
{ data: [invoiceRow()] },
{ error: { message: 'relation missing' } },
])
await expect(
createSupplierPaymentBatch(mock.supabase as unknown as SupabaseClient, COMPANY_ID, USER_ID, {
format: 'pain001',
items: [{ supplier_invoice_id: 'inv-1' }],
}),
).rejects.toBeTruthy()
expect(mock.findCall('supplier_payment_batches', 'insert')).toBeUndefined()
})
it('fails up front when the debtor is incomplete', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([{ data: companyRow }, { data: { ...settingsRow, iban: null } }])
const result = await createSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
USER_ID,
{ format: 'pain001', items: [{ supplier_invoice_id: 'inv-1' }] },
)
expect(result).toEqual({ ok: false, code: 'debtor_incomplete', missing: 'iban' })
})
it('drops an invalid company bankgiro from the snapshot instead of debiting it', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([
{ data: companyRow },
{ data: { ...settingsRow, bankgiro: '1234-5678' } },
{ data: [invoiceRow()] },
{ data: [] },
{ data: batchRow() },
{ data: null },
])
const result = await createSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
USER_ID,
{ format: 'pain001', items: [{ supplier_invoice_id: 'inv-1' }] },
)
expect(result.ok).toBe(true)
const batchInsert = mock.findCall('supplier_payment_batches', 'insert')?.[0] as {
debtor_snapshot: { bankgiro: string | null }
}
expect(batchInsert.debtor_snapshot.bankgiro).toBeNull()
})
it('requires an organisation number for the InitgPty OrgId', async () => {
const mock = createQueuedMockSupabase()
mock.enqueueMany([
{ data: { ...companyRow, org_number: null } },
{ data: { ...settingsRow, org_number: null } },
])
const result = await createSupplierPaymentBatch(
mock.supabase as unknown as SupabaseClient,
COMPANY_ID,
USER_ID,
{ format: 'pain001', items: [{ supplier_invoice_id: 'inv-1' }] },
)
expect(result).toEqual({ ok: false, code: 'debtor_incomplete', missing: 'org_number' })
})
})
describe('renderSupplierPaymentBatchFile', () => {
it('renders a deterministic pain.001 file from stored rows alone', () => {
const batch = batchRow()
const items: SupplierPaymentBatchItem[] = [
{
id: 'item-1',
batch_id: batch.id,
company_id: COMPANY_ID,
supplier_invoice_id: 'inv-1',
amount: 737.5,
payment_date: '2026-08-15',
payee_type: 'bankgiro',
payee_bankgiro: '50501055',
payee_plusgiro: null,
payee_clearing: null,
payee_account: null,
payee_name: 'Derome Bygg & Industri AB',
payee_city: null,
reference_type: 'invoice_number',
reference: 'CD3014794407',
created_at: '2026-08-10T12:00:00Z',
},
]
const first = renderSupplierPaymentBatchFile(batch, items)
const second = renderSupplierPaymentBatchFile(batch, items)
expect(first.content).toBe(second.content)
expect(first.content).toContain(`<MsgId>${batch.msg_id}</MsgId>`)
expect(first.content).toContain('<CreDtTm>2026-08-10T12:00:00Z</CreDtTm>')
expect(first.contentType).toBe('application/xml; charset=utf-8')
expect(first.filename).toBe('betalfil_20260810_b0000000.xml')
})
it('refuses a format the renderer does not support', () => {
expect(() => renderSupplierPaymentBatchFile(batchRow({ format: 'bg_lb' }), [])).toThrow()
})
})