Bug/open banking flow (#854)
* fix(enable-banking): pin Mobile BankID (decoupled) auth_method so Handelsbanken corporate connects We never sent auth_method to Enable Banking, so it fell back to the ASPSP's visible default — REDIRECT for Handelsbanken. For Handelsbanken *corporate* PSUs the redirect flow does not support Mobile BankID, so authorization failed right after the user approved in the BankID app. Mobile BankID at Handelsbanken is a DECOUPLED method flagged hidden_method=true, which Enable Banking only uses when requested explicitly. Resolve the bank's preferred auth method before /auth: query the ASPSP's auth_methods and pick the DECOUPLED (Mobile BankID) method when present, otherwise leave auth_method unset so banks that already work are untouched. The method name is read dynamically per psu_type, so it is robust across sandbox/production naming. - api-client: add approach/hidden_method to AuthMethod, fix ASPSP.auth_methods field name (was available_auth_methods, never populated), add getPreferredAuthMethod(), thread optional authMethod through startAuthorization - index: resolve authMethod in /connect and pass it on both fresh + reconnect - tests: cover method selection and request-body shaping Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(invoice-inbox): clean up bulk-selection toolbar UI Redesign the selection toolbar shown when inbox items are checked: one solid primary "Bokför valda" button with outlined secondary actions ("Fråga assistenten", "Ta bort") and a plain selection count. Removes the redundant "Avmarkera" button (users uncheck the still-visible box), fixes label clipping, and gives the toolbar more breathing room. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * chore(entitlements): bypass paywall in local development Add isPaywallBypassed() so all gated capabilities are testable locally without a subscription. Fires only on NODE_ENV=development (npm run dev) or an explicit DISABLE_PAYWALL=true escape hatch — production builds run under NODE_ENV=production and the entitlement suite runs under 'test', so both keep exercising the real gate. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(tic): resolve enskild firma bolagsuppgifter via 12-digit personnummer TIC's Lens search is fuzzy and only resolves an enskild firma from the 12-digit (century-prefixed) personnummer; a 10-digit form fuzzy-matched an unrelated entity. Expand personnummer to 12 digits before querying and reject hits whose registration number is unrelated to the request. Add a "Hämta" action to the settings Bolagsuppgifter panel to (re)fetch on demand. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(transactions): implement categorize core for bank transaction categorization - Added `categorize-core.ts` to handle categorization of bank transactions, supporting single and bulk operations. - Introduced `categorizeMatchedTransaction` and `bulkBookMatchedInboxItems` functions for transaction processing. - Implemented fiscal period validation and duplicate booking detection. - Enhanced logging and error handling for transaction categorization. feat(scripts): add diagnostic script for Handelsbanken ASPSP metadata - Created `check-handelsbanken-aspsp.mjs` to fetch and display available authentication methods for Handelsbanken. - Outputs metadata for business and personal PSU types, including default authentication methods. fix(migrations): increase statement timeout for SIE bulk delete operations - Updated `20260629160000_sie_bulk_delete_statement_timeout.sql` to set a longer statement timeout for bulk delete RPCs to prevent cancellations during large imports. feat(migrations): add bulk book inbox items to pending operations - Expanded `pending_operations` table to include `bulk_book_inbox_items` operation type in `20260630120000_pending_operations_add_bulk_book_inbox_items.sql`. - Supports bulk booking of matched inbox items against bank transactions. test(pg): add tests for replace_period_opening_balance_link RPC - Implemented tests in `replace-period-opening-balance-link.pg.test.ts` to validate the functionality of the opening-balance correction flow. - Ensured immutability of opening balance links and proper handling of posted vs. non-posted entries. * fix(sie-export): update journal entries and lines handling in SIE export tests * fix(migrations): resolve version collision on 20260629160000 The SIE bulk-delete statement_timeout migration shared version 20260629160000 with journal_entries_list_series_filter (merged from main via #798/#823), causing a schema_migrations_pkey duplicate key error on apply. Rename the branch's migration to 20260629160100. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(compliance): resolve compliance-swarm + review findings - opening-balance/correct: compensating rollback for the non-atomic storno+rebook so a mid-sequence failure never leaves two posted OB entries (ASVS V2.3); durable audit event on every failure path (V16); reference the original verifikationsnummer in the corrected entry per BFL 5 kap 5§; document that requireWrite already enforces write-role + membership (V8.2.1 was a false positive) - reports sources routes: validate the cursor date component as ISO (/^\d{4}-\d{2}-\d{2}$/) before use, 400 on malformed (ASVS V1.2), applied to both the VAT-declaration and trial-balance routes - AgentSessionList: await the rename PATCH, revert the optimistic title and toast on failure (ASVS V4.5) - bank booking: exclude same-batch siblings from the booking-time duplicate guard so bulk-booking distinct same-(date,amount) transactions no longer false-positives; pre-existing duplicate detection is preserved - BulkBookInboxDialog: drop the unsafe currency-based reverse_charge default, add an omvänd skattskyldighet advisory, and type VAT options to the backend VatTreatment union - OpeningBalanceRowEditor: hold onChange in a ref (synced in effect, not during render) so an unstable callback can't cause a render loop Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Mattsson
co-authored by
Claude Opus 4.8
Claude Opus 4.8
parent
2da9c71eb3
commit
f63d3e3100
@@ -0,0 +1,139 @@
|
||||
import { describe, it, expect } from 'vitest'
|
||||
import { verifikationDraft } from '../verifikation-draft'
|
||||
|
||||
// verifikation.draft is the assistant entry point on the manual bookkeeping
|
||||
// surfaces (Bokföring → "Skapa med assistent", the Ny verifikat-dialog handoff,
|
||||
// and a draft verifikat's own page). These tests lock in the two things that
|
||||
// make it actually useful:
|
||||
// 1. it carries the underlag-reading tools its ground rules already reference
|
||||
// (the intent shipped without them — instructions for tools it couldn't
|
||||
// call), and
|
||||
// 2. the prompt drives "read the underlag → suggest accounts → stage a
|
||||
// voucher", while guarding against duplicating an existing draft (there's
|
||||
// no MCP edit-draft tool, so for an existing draft the agent must advise,
|
||||
// not stage a second verifikat).
|
||||
|
||||
type Captured = Parameters<typeof verifikationDraft.promptTemplate>[0]['captured']
|
||||
|
||||
function baseCaptured(overrides: Partial<Captured> = {}): Captured {
|
||||
return {
|
||||
entry: null,
|
||||
current_lines: [],
|
||||
period_status: null,
|
||||
description_hint: null,
|
||||
underlag: [],
|
||||
...overrides,
|
||||
}
|
||||
}
|
||||
|
||||
function renderPrompt(overrides: Partial<Captured> = {}, profileSummary: string | null = null): string {
|
||||
return verifikationDraft.promptTemplate({
|
||||
captured: baseCaptured(overrides),
|
||||
profileSummary,
|
||||
activeMemory: [],
|
||||
})
|
||||
}
|
||||
|
||||
describe('verifikation.draft tool scope', () => {
|
||||
it('carries the underlag-reading tools its ground rules reference', () => {
|
||||
// shared-rules.ts tells the agent to call gnubok_list_inbox_items /
|
||||
// gnubok_get_document_content before proposing a booking. The intent
|
||||
// originally omitted them, so those instructions were dead. Lock them in.
|
||||
expect(verifikationDraft.tools).toContain('gnubok_get_document_content')
|
||||
expect(verifikationDraft.tools).toContain('gnubok_list_inbox_items')
|
||||
expect(verifikationDraft.tools).toContain('gnubok_get_inbox_item')
|
||||
expect(verifikationDraft.tools).toContain('gnubok_list_unmatched_documents')
|
||||
})
|
||||
|
||||
it('can still stage the voucher', () => {
|
||||
expect(verifikationDraft.tools).toContain('gnubok_create_voucher')
|
||||
})
|
||||
})
|
||||
|
||||
describe('verifikation.draft prompt template', () => {
|
||||
it('renders the shared ground rules (underlag-first discipline)', () => {
|
||||
const out = renderPrompt()
|
||||
expect(out).toContain('UNDERLAG FÖRST')
|
||||
})
|
||||
|
||||
it('tells the agent to read the underlag before proposing accounts', () => {
|
||||
const out = renderPrompt()
|
||||
expect(out).toContain('UNDERLAG FÖRST.')
|
||||
expect(out).toContain('gnubok_list_inbox_items')
|
||||
expect(out).toContain('gnubok_get_document_content')
|
||||
})
|
||||
|
||||
it('stages a new voucher and links the inbox underlag to it', () => {
|
||||
const out = renderPrompt()
|
||||
expect(out).toContain('gnubok_create_voucher')
|
||||
// The kvitto must follow the booking — create_voucher takes inbox_item_id
|
||||
// and attaches the OCR document on commit.
|
||||
expect(out).toContain('inbox_item_id')
|
||||
})
|
||||
|
||||
it('guards against duplicating an existing draft', () => {
|
||||
// No MCP tool edits a draft in place, so for an existing draft the agent
|
||||
// must advise (suggest accounts / check balance) rather than stage a
|
||||
// second verifikat — otherwise "help me finish this draft" creates a dupe.
|
||||
const out = renderPrompt({
|
||||
entry: { id: 'e1', entry_date: '2026-05-01', description: 'Utkast', status: 'draft' },
|
||||
})
|
||||
expect(out).toContain('Staga INTE en ny verifikation för ett utkast som redan finns')
|
||||
})
|
||||
|
||||
it('surfaces extracted underlag fields so the agent does not re-ask', () => {
|
||||
const out = renderPrompt({
|
||||
entry: { id: 'e1', entry_date: '2026-05-01', description: 'Inköp', status: 'draft' },
|
||||
underlag: [
|
||||
{
|
||||
document_id: 'doc-1',
|
||||
file_name: 'kvitto.pdf',
|
||||
merchant_name: 'Clas Ohlson',
|
||||
receipt_date: '2026-05-01',
|
||||
total_amount: 499,
|
||||
vat_amount: 99.8,
|
||||
currency: 'SEK',
|
||||
raw_extraction: null,
|
||||
},
|
||||
],
|
||||
})
|
||||
expect(out).toContain('UNDERLAG kopplat till verifikationen')
|
||||
expect(out).toContain('Clas Ohlson')
|
||||
expect(out).toContain('document_id=doc-1')
|
||||
})
|
||||
|
||||
it('warns when the entry sits in a locked period', () => {
|
||||
const out = renderPrompt({
|
||||
entry: { id: 'e1', entry_date: '2025-12-31', description: 'Inköp', status: 'draft' },
|
||||
period_status: { period_id: 'p1', status: 'locked', lock_date: '2025-12-31' },
|
||||
})
|
||||
expect(out).toContain('PERIODEN ÄR LÅST')
|
||||
})
|
||||
|
||||
it('flags an unbalanced set of existing lines', () => {
|
||||
const out = renderPrompt({
|
||||
entry: { id: 'e1', entry_date: '2026-05-01', description: 'Inköp', status: 'draft' },
|
||||
current_lines: [
|
||||
{ account_number: '5410', debit_amount: 500, credit_amount: null, description: 'Förbrukning' },
|
||||
{ account_number: '1930', debit_amount: null, credit_amount: 400, description: 'Bank' },
|
||||
],
|
||||
})
|
||||
expect(out).toContain('debet ≠ kredit')
|
||||
})
|
||||
})
|
||||
|
||||
describe('verifikation.draft capture', () => {
|
||||
it('returns an empty draft (with an underlag array) when no entry id is given', async () => {
|
||||
// The fresh-start path (Bokföring → "Skapa med assistent") passes no
|
||||
// journal_entry_id and must not touch the database — the agent discovers
|
||||
// underlag itself via the inbox tools.
|
||||
const captured = await verifikationDraft.capture(
|
||||
{ description: 'Köp av router' },
|
||||
{ supabase: {} as never, userId: 'u1', companyId: 'c1' },
|
||||
)
|
||||
expect(captured.entry).toBeNull()
|
||||
expect(captured.current_lines).toEqual([])
|
||||
expect(captured.underlag).toEqual([])
|
||||
expect(captured.description_hint).toBe('Köp av router')
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,197 @@
|
||||
import { defineAgentIntent } from './types'
|
||||
import { SONNET_MODEL, THINKING_BUDGET_STANDARD } from '@/lib/agent/composer/client'
|
||||
|
||||
// inbox.bulk-book — "Fråga assistenten" on a multi-selection in the Underlag
|
||||
// view (Dokumentinkorgen). Unlike transaction.categorization (which keys off the
|
||||
// single previewed item), this intent receives the user's CHECKBOX selection
|
||||
// (selectedIds) so Lena acts on exactly what the user marked — not whatever
|
||||
// happens to be open in the preview pane.
|
||||
//
|
||||
// Booking model (Modell B): each selected item is booked against its matched
|
||||
// bank transaction with one shared category + VAT treatment via
|
||||
// gnubok_bulk_book_inbox_items (which stages one approval). The agent groups the
|
||||
// selection by vendor/kind and books each homogeneous group, detecting
|
||||
// reverse-charge for foreign services.
|
||||
|
||||
interface InboxBulkBookArgs {
|
||||
item_ids: string[]
|
||||
}
|
||||
|
||||
interface CapturedInboxItem {
|
||||
item_id: string
|
||||
// bookable = matched to a tx and not yet booked; not_matched = needs a bank
|
||||
// match first; already_booked = resolved (skip).
|
||||
status: 'bookable' | 'not_matched' | 'already_booked'
|
||||
merchant_name: string | null
|
||||
invoice_date: string | null
|
||||
total: number | null
|
||||
vat_amount: number | null
|
||||
currency: string | null
|
||||
tx_date: string | null
|
||||
tx_amount_sek: number | null
|
||||
tx_description: string | null
|
||||
}
|
||||
|
||||
interface CapturedInboxBulk {
|
||||
items: CapturedInboxItem[]
|
||||
bookable_count: number
|
||||
}
|
||||
|
||||
// SEK magnitude of a (usually-SEK) bank transaction. Foreign rows are
|
||||
// normalised via their stored amount_sek/exchange_rate.
|
||||
function txSek(tx: {
|
||||
amount: number | null
|
||||
currency: string | null
|
||||
amount_sek: number | null
|
||||
exchange_rate: number | null
|
||||
}): number | null {
|
||||
if (tx.amount == null) return null
|
||||
const cur = String(tx.currency ?? 'SEK').toUpperCase()
|
||||
if (cur === 'SEK') return Math.abs(Number(tx.amount))
|
||||
const sek = tx.amount_sek ?? Number(tx.amount) * Number(tx.exchange_rate ?? 1)
|
||||
return Number.isFinite(sek) ? Math.abs(Number(sek)) : null
|
||||
}
|
||||
|
||||
export const inboxBulkBook = defineAgentIntent<InboxBulkBookArgs, CapturedInboxBulk>({
|
||||
id: 'inbox.bulk-book',
|
||||
buttonLabel: 'Fråga assistenten',
|
||||
sheetTitle: 'Bulkbokför underlag',
|
||||
|
||||
atoms: {
|
||||
mode: 'declarative',
|
||||
horizontal: ['swedish-vat', 'swedish-accounting-compliance', 'swedish-invoice-compliance'],
|
||||
includeCompanyVertical: true,
|
||||
includeCompanyModifiers: true,
|
||||
},
|
||||
|
||||
tools: [
|
||||
'gnubok_bulk_book_inbox_items',
|
||||
'gnubok_categorize_transaction',
|
||||
'gnubok_query_journal',
|
||||
'gnubok_get_document_content',
|
||||
'gnubok_list_inbox_items',
|
||||
'gnubok_load_skill',
|
||||
'gnubok_search_tools',
|
||||
'gnubok_remember_fact',
|
||||
'gnubok_forget_fact',
|
||||
],
|
||||
|
||||
model: SONNET_MODEL,
|
||||
|
||||
// Reason before proposing — group the selection and work out category + VAT
|
||||
// treatment in the thinking channel, so the visible reply is one short
|
||||
// motivation, not a play-by-play.
|
||||
thinking: { budgetTokens: THINKING_BUDGET_STANDARD },
|
||||
|
||||
capture: async ({ item_ids }, { supabase, companyId }) => {
|
||||
const ids = Array.isArray(item_ids) ? item_ids.filter((x): x is string => typeof x === 'string') : []
|
||||
if (ids.length === 0) return { items: [], bookable_count: 0 }
|
||||
|
||||
const { data: rows } = await supabase
|
||||
.from('invoice_inbox_items')
|
||||
.select('id, matched_transaction_id, created_journal_entry_id, created_supplier_invoice_id, extracted_data')
|
||||
.eq('company_id', companyId)
|
||||
.in('id', ids)
|
||||
|
||||
const txIds = Array.from(
|
||||
new Set((rows ?? []).map((r) => r.matched_transaction_id).filter(Boolean) as string[]),
|
||||
)
|
||||
interface TxRow {
|
||||
id: string
|
||||
date: string | null
|
||||
amount: number | null
|
||||
currency: string | null
|
||||
amount_sek: number | null
|
||||
exchange_rate: number | null
|
||||
description: string | null
|
||||
}
|
||||
const txById = new Map<string, TxRow>()
|
||||
if (txIds.length > 0) {
|
||||
const { data: txs } = await supabase
|
||||
.from('transactions')
|
||||
.select('id, date, amount, currency, amount_sek, exchange_rate, description')
|
||||
.eq('company_id', companyId)
|
||||
.in('id', txIds)
|
||||
for (const t of ((txs ?? []) as TxRow[])) txById.set(t.id, t)
|
||||
}
|
||||
|
||||
const items: CapturedInboxItem[] = (rows ?? []).map((r) => {
|
||||
const ex = (r.extracted_data ?? {}) as {
|
||||
supplier?: { name?: string | null }
|
||||
invoice?: { invoiceDate?: string | null; currency?: string | null }
|
||||
totals?: { total?: number | null; vatAmount?: number | null }
|
||||
}
|
||||
const tx = r.matched_transaction_id ? txById.get(r.matched_transaction_id as string) ?? null : null
|
||||
const status: CapturedInboxItem['status'] =
|
||||
r.created_journal_entry_id || r.created_supplier_invoice_id
|
||||
? 'already_booked'
|
||||
: r.matched_transaction_id
|
||||
? 'bookable'
|
||||
: 'not_matched'
|
||||
return {
|
||||
item_id: r.id as string,
|
||||
status,
|
||||
merchant_name: ex.supplier?.name ?? null,
|
||||
invoice_date: ex.invoice?.invoiceDate ?? null,
|
||||
total: ex.totals?.total ?? null,
|
||||
vat_amount: ex.totals?.vatAmount ?? null,
|
||||
currency: ex.invoice?.currency ?? null,
|
||||
tx_date: tx?.date ?? null,
|
||||
tx_amount_sek: tx ? txSek(tx) : null,
|
||||
tx_description: tx?.description ?? null,
|
||||
}
|
||||
})
|
||||
|
||||
return { items, bookable_count: items.filter((i) => i.status === 'bookable').length }
|
||||
},
|
||||
|
||||
promptTemplate: ({ captured, profileSummary }) => {
|
||||
const lines: string[] = []
|
||||
if (profileSummary) lines.push(`Företagets profil: ${profileSummary}`, '')
|
||||
|
||||
if (captured.items.length === 0) {
|
||||
return [
|
||||
'Användaren öppnade hjälpfönstret från en markering i Dokumentinkorgen, men inga underlag kunde läsas.',
|
||||
'Be användaren markera underlagen igen och försök på nytt.',
|
||||
].join(' ')
|
||||
}
|
||||
|
||||
const bookable = captured.items.filter((i) => i.status === 'bookable')
|
||||
const notMatched = captured.items.filter((i) => i.status === 'not_matched')
|
||||
const alreadyBooked = captured.items.filter((i) => i.status === 'already_booked')
|
||||
|
||||
lines.push(`Användaren har markerat ${captured.items.length} underlag i Dokumentinkorgen och vill bulkbokföra dem.`)
|
||||
lines.push('')
|
||||
lines.push(
|
||||
`MARKERADE UNDERLAG (${bookable.length} bokförbara, ${notMatched.length} saknar matchad transaktion, ${alreadyBooked.length} redan bokförda):`,
|
||||
)
|
||||
for (const it of bookable) {
|
||||
const parts: string[] = [`item_id=${it.item_id}`]
|
||||
if (it.merchant_name) parts.push(`leverantör=${it.merchant_name}`)
|
||||
if (it.total != null) parts.push(`belopp=${it.total.toLocaleString('sv-SE')} ${it.currency ?? 'SEK'}`)
|
||||
if (it.vat_amount != null) parts.push(`moms=${it.vat_amount.toLocaleString('sv-SE')} ${it.currency ?? 'SEK'}`)
|
||||
if (it.tx_amount_sek != null) parts.push(`bank=${it.tx_amount_sek.toLocaleString('sv-SE')} SEK`)
|
||||
if (it.tx_date) parts.push(`datum=${it.tx_date}`)
|
||||
lines.push(` • ${parts.join(', ')}`)
|
||||
}
|
||||
if (notMatched.length > 0) {
|
||||
lines.push('')
|
||||
lines.push('EJ MATCHADE (kan inte bulkbokföras förrän de matchats mot en banktransaktion):')
|
||||
for (const it of notMatched) {
|
||||
const label = it.merchant_name ?? it.tx_description ?? it.item_id
|
||||
lines.push(` • ${label}${it.total != null ? ` (${it.total.toLocaleString('sv-SE')} ${it.currency ?? 'SEK'})` : ''}`)
|
||||
}
|
||||
}
|
||||
lines.push('')
|
||||
lines.push('Arbetssätt:')
|
||||
lines.push('- Boka via banktransaktionen (Modell B): verktyget bokför varje underlag mot dess matchade banktransaktion, som redan bär SEK-beloppet. Du behöver inte räkna om valuta.')
|
||||
lines.push('- GRUPPERA de bokförbara underlagen efter leverantör/typ. Samma slags kostnad → samma kategori + momsbehandling. För varje homogen grupp anropar du gnubok_bulk_book_inbox_items med gruppens item_ids, en kategori (enum) och vat_treatment.')
|
||||
lines.push('- MOMS: en utländsk tjänst (t.ex. USD/EUR-prenumeration som Cursor/Anysphere där säljaren INTE debiterat svensk moms) är omvänd skattskyldighet → vat_treatment="reverse_charge". En svensk faktura med debiterad moms → standard_25 (eller den sats kvittot visar). Gissa aldrig — utgå från valuta + om underlaget visar moms.')
|
||||
lines.push('- KOLLA HUR MOTPARTEN BOKFÖRTS FÖRUT med gnubok_query_journal({ text: "<leverantör>", limit: 5 }) innan du väljer kategori. Följ ett tydligt tidigare mönster om inte underlaget motsäger det.')
|
||||
lines.push('- HOPPA ÖVER ej matchade underlag: be användaren matcha dem mot en banktransaktion först ("Matcha mot transaktion" i Dokumentinkorgen), så kan de bulkbokföras i nästa runda. Bokför ALDRIG ett underlag utan matchad transaktion via det här flödet.')
|
||||
lines.push('- Förklara kort på svenska VARFÖR du valde kategori + momsbehandling — använd kategori-namn (t.ex. "Programvara/IT-tjänster"), aldrig ett BAS-kontonummer. Godkännandekortet visar antal, konto och moms; upprepa inte de siffrorna och säg inte att operationen är "stagead".')
|
||||
lines.push('')
|
||||
lines.push('Svara på svenska och var direkt.')
|
||||
return lines.join('\n')
|
||||
},
|
||||
})
|
||||
@@ -1,6 +1,7 @@
|
||||
import type { AgentIntent } from './types'
|
||||
import { generalHelp } from './general-help'
|
||||
import { transactionCategorization } from './transaction-categorization'
|
||||
import { inboxBulkBook } from './inbox-bulk-book'
|
||||
import { invoiceDraft } from './invoice-draft'
|
||||
import { supplierInvoiceReview } from './supplier-invoice-review'
|
||||
import { vatReview } from './vat-review'
|
||||
@@ -23,6 +24,7 @@ import { onboardingIntake } from './onboarding-intake'
|
||||
const INTENTS: AgentIntent<any, any>[] = [
|
||||
generalHelp,
|
||||
transactionCategorization,
|
||||
inboxBulkBook,
|
||||
invoiceDraft,
|
||||
supplierInvoiceReview,
|
||||
vatReview,
|
||||
|
||||
@@ -44,6 +44,7 @@ export const AGENT_GROUND_RULES: string[] = [
|
||||
// standard-BAS account backfill in the engine/storno service.
|
||||
'- RÄTTA FEL I BOKFÖRDA VERIFIKATIONER — så fungerar det i Accounted (beskriv aldrig andra vägar än dessa):',
|
||||
' • En bokförd verifikation kan aldrig redigeras direkt (Bokföringslagen). Rättelse görs från verifikationens egen sida: Bokföring → öppna verifikationen → knappen "Rätta". "Rätta rader" skapar automatiskt en storno som nollställer originalet plus en ny rättelseverifikation med de rätta raderna, båda i originalets period. "Rätta datum" flyttar verifikationen till rätt datum/år (storno + ombokning under huven). Hela kedjan original → storno → rättelse länkas och visas på verifikationssidan.',
|
||||
' • INGÅENDE BALANSER (IB) rättas på sitt eget sätt — INTE via "Rätta rader". Gå till Bokföring, öppna IB-verifikationen (beskrivning "Ingående balanser", serie A) och klicka "Korrigera ingående balanser". Då öppnas IB-raderna så att beloppen kan ändras direkt; när man sparar stornas den gamla IB-verifikationen och en korrigerad bokförs, och periodens ingående balans pekas om till den nya. Detta gäller oavsett om IB kom från SIE-import, CSV/Excel-import eller föregående års bokslut. IB finns alltså INTE under Inställningar eller Kontoplan — korrigeringen görs på själva verifikationen.',
|
||||
' • Är verifikationen den SENASTE i sin serie kan den även raderas helt ("Radera verifikat") — då återanvänds löpnumret och ingen lucka uppstår.',
|
||||
' • Konton som finns i BAS-kontoplanen men saknas i företagets kontoplan läggs till AUTOMATISKT vid bokföring och rättelse. Be aldrig användaren registrera standardkonton manuellt innan de bokför — bara okända kontonummer eller avaktiverade konton stoppar.',
|
||||
' • När en bokning makuleras (storno utan rättelse) släpps den kopplade banktransaktionen och blir bokföringsbar igen i transaktionsvyn — användaren kan alltid klicka på transaktionen och bokföra om. Vid en rättelse följer transaktionen och underlaget med till rättelseverifikationen.',
|
||||
|
||||
@@ -2,12 +2,16 @@ import { defineAgentIntent } from './types'
|
||||
import { SONNET_MODEL, THINKING_BUDGET_STANDARD } from '@/lib/agent/composer/client'
|
||||
import { renderAgentGroundRules } from './shared-rules'
|
||||
|
||||
// verifikation.draft — "Fråga [namn]" on the journal entry creation form.
|
||||
// verifikation.draft — "Fråga om denna verifikation" on the journal entry
|
||||
// creation/draft surfaces (Bokföring → "Skapa med assistent", the Ny
|
||||
// verifikat-dialog, and a draft verifikat's own page).
|
||||
//
|
||||
// Helps the user construct a balanced verifikation: pick the right BAS
|
||||
// accounts, handle VAT splits, and detect when a transaction should instead
|
||||
// be matched to an invoice or supplier invoice (rather than booked from
|
||||
// scratch). Reads any in-progress draft state passed via intent_args.
|
||||
// Helps the user construct a balanced verifikation end to end: read the
|
||||
// underlag (kvitto/faktura) the user often can't see themselves and pull the
|
||||
// figures from it, pick the right BAS accounts, handle VAT splits, and detect
|
||||
// when a transaction should instead be matched to an invoice or supplier
|
||||
// invoice (rather than booked from scratch). Reads any in-progress draft state
|
||||
// + linked underlag passed via intent_args.
|
||||
|
||||
interface VerifikationDraftArgs {
|
||||
// Optional id when the user is editing an existing draft. null for /new.
|
||||
@@ -36,6 +40,21 @@ interface CapturedVerifikationDraft {
|
||||
lock_date: string | null
|
||||
} | null
|
||||
description_hint: string | null
|
||||
// Underlag already linked to the entry (when editing a draft). Flattened
|
||||
// from document_attachments.extracted_data the same way
|
||||
// transaction.categorization does, so the agent can read the figures
|
||||
// without a round-trip. Empty for a brand-new verifikation — there the
|
||||
// agent discovers underlag via gnubok_list_inbox_items.
|
||||
underlag: {
|
||||
document_id: string | null
|
||||
file_name: string | null
|
||||
merchant_name: string | null
|
||||
receipt_date: string | null
|
||||
total_amount: number | null
|
||||
vat_amount: number | null
|
||||
currency: string | null
|
||||
raw_extraction: Record<string, unknown> | null
|
||||
}[]
|
||||
}
|
||||
|
||||
export const verifikationDraft = defineAgentIntent<
|
||||
@@ -57,6 +76,13 @@ export const verifikationDraft = defineAgentIntent<
|
||||
'gnubok_get_trial_balance',
|
||||
'gnubok_query_journal',
|
||||
'gnubok_create_voucher',
|
||||
// Underlag reading — the ground rules (shared-rules.ts) already instruct
|
||||
// the agent to look in the inbox and read the underlag before proposing a
|
||||
// booking; these are the tools that make those instructions callable.
|
||||
'gnubok_get_document_content',
|
||||
'gnubok_list_inbox_items',
|
||||
'gnubok_list_unmatched_documents',
|
||||
'gnubok_get_inbox_item',
|
||||
'gnubok_load_skill',
|
||||
'gnubok_search_tools',
|
||||
'gnubok_remember_fact',
|
||||
@@ -76,6 +102,7 @@ export const verifikationDraft = defineAgentIntent<
|
||||
let entry: CapturedVerifikationDraft['entry'] = null
|
||||
let lines: CapturedVerifikationDraft['current_lines'] = []
|
||||
let periodStatus: CapturedVerifikationDraft['period_status'] = null
|
||||
const underlag: CapturedVerifikationDraft['underlag'] = []
|
||||
|
||||
if (journal_entry_id) {
|
||||
const { data: e } = await supabase
|
||||
@@ -114,6 +141,37 @@ export const verifikationDraft = defineAgentIntent<
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Underlag already linked to this draft — surface the extracted fields
|
||||
// so the agent suggests accounts from what's on the kvitto without
|
||||
// re-asking. Mirrors transaction.categorization's document_attachments
|
||||
// read (same table, same extracted_data shape).
|
||||
const { data: docs } = await supabase
|
||||
.from('document_attachments')
|
||||
.select('id, file_name, extracted_data')
|
||||
.eq('journal_entry_id', journal_entry_id)
|
||||
.eq('company_id', companyId)
|
||||
.eq('is_current_version', true)
|
||||
for (const d of (docs ?? []) as {
|
||||
id: string
|
||||
file_name: string | null
|
||||
extracted_data: Record<string, unknown> | null
|
||||
}[]) {
|
||||
const ex = d.extracted_data ?? null
|
||||
const supplier = (ex?.supplier as { name?: string | null } | undefined) ?? null
|
||||
const invoice = (ex?.invoice as { invoiceDate?: string | null; currency?: string | null } | undefined) ?? null
|
||||
const totals = (ex?.totals as { total?: number | null; vatAmount?: number | null } | undefined) ?? null
|
||||
underlag.push({
|
||||
document_id: d.id,
|
||||
file_name: d.file_name,
|
||||
merchant_name: supplier?.name ?? null,
|
||||
receipt_date: invoice?.invoiceDate ?? null,
|
||||
total_amount: totals?.total ?? null,
|
||||
vat_amount: totals?.vatAmount ?? null,
|
||||
currency: invoice?.currency ?? null,
|
||||
raw_extraction: ex,
|
||||
})
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -122,6 +180,7 @@ export const verifikationDraft = defineAgentIntent<
|
||||
current_lines: lines,
|
||||
period_status: periodStatus,
|
||||
description_hint: description ?? null,
|
||||
underlag,
|
||||
}
|
||||
},
|
||||
|
||||
@@ -164,6 +223,28 @@ export const verifikationDraft = defineAgentIntent<
|
||||
}
|
||||
}
|
||||
|
||||
if (captured.underlag.length > 0) {
|
||||
lines.push('')
|
||||
lines.push(`UNDERLAG kopplat till verifikationen: ${captured.underlag.length} st. Extraherade fält:`)
|
||||
for (const u of captured.underlag) {
|
||||
const parts: string[] = []
|
||||
if (u.document_id) parts.push(`document_id=${u.document_id}`)
|
||||
if (u.merchant_name) parts.push(`leverantör=${u.merchant_name}`)
|
||||
if (u.receipt_date) parts.push(`datum=${u.receipt_date}`)
|
||||
if (u.total_amount != null) {
|
||||
parts.push(`total=${u.total_amount.toLocaleString('sv-SE')} ${u.currency ?? 'SEK'}`)
|
||||
}
|
||||
if (u.vat_amount != null) {
|
||||
parts.push(`moms=${u.vat_amount.toLocaleString('sv-SE')} ${u.currency ?? 'SEK'}`)
|
||||
}
|
||||
lines.push(
|
||||
` • ${parts.join(', ') || `${u.file_name ?? 'underlag'} (ingen extraherad data — läs med gnubok_get_document_content)`}`,
|
||||
)
|
||||
}
|
||||
lines.push('')
|
||||
lines.push('Extraktionen ovan är det vi REDAN VET — fråga inte om leverantör/belopp som står där. Räcker den inte (t.ex. saknar momsbelopp), läs underlaget med gnubok_get_document_content(document_id=…).')
|
||||
}
|
||||
|
||||
if (captured.period_status) {
|
||||
lines.push('')
|
||||
lines.push(
|
||||
@@ -177,10 +258,13 @@ export const verifikationDraft = defineAgentIntent<
|
||||
}
|
||||
lines.push('')
|
||||
lines.push('Arbetssätt:')
|
||||
lines.push('1. Föreslå rätt BAS-konton baserat på beskrivningen. Syns en motpart i beskrivningen — kolla historiken med gnubok_query_journal({ text: "<motpartens namn>", limit: 5 }).')
|
||||
lines.push('2. Säkerställ att debet = kredit. Förklara varje rad kort.')
|
||||
lines.push('3. Om transaktionen i själva verket är en faktura/leverantörsfaktura/bankrad — be användaren matcha det istället. Direktbokning skapar dubbletter.')
|
||||
lines.push('4. Staga via gnubok_create_voucher när allt stämmer.')
|
||||
lines.push('1. UNDERLAG FÖRST. Saknas underlaget i sammanhanget ovan: leta i Dokumentinkorgen med gnubok_list_inbox_items (och gnubok_list_unmatched_documents). Läs det relevanta underlaget med gnubok_get_inbox_item / gnubok_get_document_content och dra fram datum, belopp, moms och motpart INNAN du föreslår konton. Användaren ser ofta inte underlagets innehåll själv — det är just det du hjälper till med.')
|
||||
lines.push('2. Föreslå rätt BAS-konton utifrån underlaget och beskrivningen. Syns en motpart — kolla historiken med gnubok_query_journal({ text: "<motpartens namn>", limit: 5 }) och följ tidigare mönster.')
|
||||
lines.push('3. Säkerställ att debet = kredit. Förklara varje rad kort (i kategori-/kontonamn, inte kontonummer).')
|
||||
lines.push('4. Är detta egentligen en kund-/leverantörsfaktura eller en bankrad? Be användaren matcha den istället — direktbokning skapar dubbletter.')
|
||||
lines.push('5. Skapa verifikationen:')
|
||||
lines.push(' • NY verifikation (inget utkast visas ovan): staga via gnubok_create_voucher när allt stämmer. Ligger underlaget i Dokumentinkorgen — skicka med inbox_item_id så kvittot kopplas till verifikationen automatiskt vid godkännande.')
|
||||
lines.push(' • BEFINTLIGT utkast (visas ovan): föreslå konton/moms och kontrollera balansen så att användaren kan färdigställa utkastet i formuläret. Staga INTE en ny verifikation för ett utkast som redan finns — det skapar en dubblett.')
|
||||
lines.push('')
|
||||
lines.push('Svara på svenska, kort och konkret.')
|
||||
return lines.join('\n')
|
||||
|
||||
Reference in New Issue
Block a user