feat(webshop): generate orderunderlag and attach it to the verifikat at booking (#1899)
* feat(webshop): generate orderunderlag PDF and attach it to the verifikat at booking Booked webshop orders only carried the VAT split; the verifikat showed no product lines, customer or payment method although the sync already stores all of it in webshop_orders.line_items (#1881). - lib/webshop-orders/order-underlag.tsx: pure model builder + react-pdf template (order lines, customer, payment method, per-rate VAT summary, SEK conversion facts) + archiveWebshopOrderUnderlag, which renders and archives the PDF on the committed verifikat through uploadDocument (upload_source system, extraction none), mirroring archiveIssuedInvoicePdf. Never throws: the booking is immutable by then. - book route: archive after commitEntry; response gains underlag_archived. FX-retry now also syncs the in-memory row so the underlag shows the resolved SEK facts. - webshop_order added to NEEDS_DOC_SOURCE_TYPES and (new migration 20260825140000) to the verifikat_without_documents needs-doc list, so a failed attach or a historical booking surfaces on the saknar-underlag worklist. transactions_without_documents is deliberately unchanged. - tests: underlag model/render/archive unit tests, book-route archive and failure-isolation cases, pg test extended (per-source-type probe now covers webshop_order; explicit flagged/silenced pair). Fixes #1881 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * chore(migrations): move webshop needs-doc migration after main's 20260825150000 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * test(webshop): add manually_booked fields to the underlag order fixture Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(webshop): skeptic findings on the orderunderlag (#1881) Two refutations from the skeptic pass on PR #1899, both fixed: 1. Correctness: sv-SE Intl emits U+2212 MINUS SIGN for negatives, which Helvetica/WinAnsi PDF fonts drop silently, so refund and discount amounts on the archived underlag rendered as POSITIVE. formatAmount now replaces U+2212 with an ASCII hyphen (same guard as formatPdfCurrency), is exported, and is pinned by a regression test. 2. Regression: NEEDS_DOC_SOURCE_TYPES had two hardcoded copies that missed webshop_order, so flagged rows rendered without the "Underlag saknas" chip, waiver toggle, or batch-exempt selection, and the weekly missing-underlag push cron disagreed with the badge. The constant now lives in dependency-free lib/worklist/types.ts (client-safe), is re-exported from categories.ts, and both JournalEntryList.tsx and push-notifications/notification-scheduler.ts consume it instead of their own copies. Also: "Bokfört i SEK" reworded to "Motsvarande i SEK" (compliance skeptic observation: the dialog's lines are user-editable, so the underlag must state the order's conversion, not claim a booking fact). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Mattsson
co-authored by
Claude Fable 5
Claude Fable 5
parent
c6f2bebab9
commit
5fc0be9ed7
@@ -0,0 +1,309 @@
|
||||
import { describe, it, expect, vi, beforeEach } from 'vitest'
|
||||
import type { SupabaseClient } from '@supabase/supabase-js'
|
||||
import { createMockSupabase } from '@/tests/helpers'
|
||||
import type { WebshopOrder } from '@/types'
|
||||
import type { Logger } from '@/lib/logger'
|
||||
|
||||
const mockUploadDocument = vi.fn()
|
||||
vi.mock('@/lib/core/documents/document-service', () => ({
|
||||
uploadDocument: (...args: unknown[]) => mockUploadDocument(...args),
|
||||
}))
|
||||
|
||||
import {
|
||||
buildOrderUnderlagModel,
|
||||
orderUnderlagFilename,
|
||||
archiveWebshopOrderUnderlag,
|
||||
formatAmount,
|
||||
} from '../order-underlag'
|
||||
|
||||
function makeOrder(overrides: Partial<WebshopOrder> = {}): WebshopOrder {
|
||||
return {
|
||||
id: 'order-1',
|
||||
company_id: 'company-1',
|
||||
user_id: 'user-1',
|
||||
platform: 'woocommerce',
|
||||
store_scope: 'butik.example.se',
|
||||
store_label: 'Butiken',
|
||||
connection_id: null,
|
||||
row_type: 'order',
|
||||
parent_order_id: null,
|
||||
external_id: 'woo_butik.example.se_order_1001',
|
||||
platform_order_id: '1001',
|
||||
order_number: '1001',
|
||||
status: 'processing',
|
||||
is_paid: true,
|
||||
order_date: '2026-08-01',
|
||||
paid_date: '2026-08-01',
|
||||
currency: 'SEK',
|
||||
total: 500,
|
||||
total_tax: 100,
|
||||
total_sek: 500,
|
||||
exchange_rate: 1,
|
||||
vat_breakdown: [{ rate: 25, net: 400, tax: 100 }],
|
||||
line_items: [
|
||||
{ name: 'Kaffekopp', quantity: 2, total: 300, total_tax: 75, vat_rate: 25 },
|
||||
{ name: 'Frakt', quantity: 1, total: 100, total_tax: 25, vat_rate: 25 },
|
||||
],
|
||||
customer_name: 'Anna Andersson',
|
||||
customer_company: null,
|
||||
customer_email: 'anna@example.se',
|
||||
customer_orgnr: null,
|
||||
customer_country: 'SE',
|
||||
payment_method: 'swish',
|
||||
payment_method_title: 'Swish',
|
||||
gateway_reference: 'SW-123',
|
||||
refunded_total: 0,
|
||||
journal_entry_id: null,
|
||||
invoice_id: null,
|
||||
legacy_transaction_id: null,
|
||||
manually_booked_at: null,
|
||||
manually_booked_by: null,
|
||||
manually_booked_journal_entry_id: null,
|
||||
remote_changed_after_freeze: false,
|
||||
created_at: '2026-08-01T00:00:00Z',
|
||||
updated_at: '2026-08-01T00:00:00Z',
|
||||
...overrides,
|
||||
}
|
||||
}
|
||||
|
||||
const log = {
|
||||
error: vi.fn(),
|
||||
warn: vi.fn(),
|
||||
info: vi.fn(),
|
||||
debug: vi.fn(),
|
||||
} as unknown as Logger
|
||||
|
||||
describe('buildOrderUnderlagModel', () => {
|
||||
it('maps line items, customer, payment method and per-rate totals', () => {
|
||||
const model = buildOrderUnderlagModel(makeOrder())
|
||||
expect(model.title).toBe('Orderunderlag')
|
||||
expect(model.orderNumber).toBe('1001')
|
||||
expect(model.platformLabel).toBe('WooCommerce')
|
||||
expect(model.storeLabel).toBe('Butiken')
|
||||
expect(model.lines).toEqual([
|
||||
{ name: 'Kaffekopp', quantity: 2, net: 300, tax: 75, vatRateLabel: '25%' },
|
||||
{ name: 'Frakt', quantity: 1, net: 100, tax: 25, vatRateLabel: '25%' },
|
||||
])
|
||||
expect(model.customerLines).toEqual(['Anna Andersson', 'anna@example.se', 'Land: SE'])
|
||||
expect(model.paymentMethod).toBe('Swish')
|
||||
expect(model.gatewayReference).toBe('SW-123')
|
||||
expect(model.vatRows).toEqual([{ rateLabel: '25%', net: 400, tax: 100, gross: 500 }])
|
||||
expect(model.totalNet).toBe(400)
|
||||
expect(model.totalTax).toBe(100)
|
||||
expect(model.totalGross).toBe(500)
|
||||
// SEK order: no conversion facts.
|
||||
expect(model.totalSek).toBeNull()
|
||||
expect(model.exchangeRate).toBeNull()
|
||||
})
|
||||
|
||||
it('keeps every rate on a multi-rate order', () => {
|
||||
const model = buildOrderUnderlagModel(
|
||||
makeOrder({
|
||||
total: 456,
|
||||
total_tax: 68,
|
||||
vat_breakdown: [
|
||||
{ rate: 25, net: 200, tax: 50 },
|
||||
{ rate: 12, net: 150, tax: 18 },
|
||||
{ rate: 0, net: 38, tax: 0 },
|
||||
],
|
||||
}),
|
||||
)
|
||||
expect(model.vatRows).toEqual([
|
||||
{ rateLabel: '25%', net: 200, tax: 50, gross: 250 },
|
||||
{ rateLabel: '12%', net: 150, tax: 18, gross: 168 },
|
||||
{ rateLabel: '0%', net: 38, tax: 0, gross: 38 },
|
||||
])
|
||||
expect(model.totalNet).toBe(388)
|
||||
})
|
||||
|
||||
it('rounds öre amounts and never emits float drift', () => {
|
||||
const model = buildOrderUnderlagModel(
|
||||
makeOrder({
|
||||
total: 100.3,
|
||||
total_tax: 20.06,
|
||||
vat_breakdown: [{ rate: 25, net: 80.239999999, tax: 20.060000001 }],
|
||||
line_items: [
|
||||
{ name: 'Vara', quantity: 3, total: 80.239999999, total_tax: 20.060000001, vat_rate: 25 },
|
||||
],
|
||||
}),
|
||||
)
|
||||
expect(model.lines[0].net).toBe(80.24)
|
||||
expect(model.lines[0].tax).toBe(20.06)
|
||||
expect(model.vatRows[0]).toEqual({ rateLabel: '25%', net: 80.24, tax: 20.06, gross: 100.3 })
|
||||
expect(model.totalNet).toBe(80.24)
|
||||
})
|
||||
|
||||
it('handles a missing customer entirely', () => {
|
||||
const model = buildOrderUnderlagModel(
|
||||
makeOrder({
|
||||
customer_name: null,
|
||||
customer_company: null,
|
||||
customer_email: null,
|
||||
customer_country: null,
|
||||
}),
|
||||
)
|
||||
expect(model.customerLines).toEqual([])
|
||||
})
|
||||
|
||||
it('puts the company name before the contact person', () => {
|
||||
const model = buildOrderUnderlagModel(
|
||||
makeOrder({ customer_company: 'Kund AB', customer_name: 'Anna Andersson' }),
|
||||
)
|
||||
expect(model.customerLines[0]).toBe('Kund AB')
|
||||
expect(model.customerLines[1]).toBe('Anna Andersson')
|
||||
})
|
||||
|
||||
it('negates the stored positive breakdown magnitudes on refund rows', () => {
|
||||
const model = buildOrderUnderlagModel(
|
||||
makeOrder({
|
||||
row_type: 'refund',
|
||||
total: -500,
|
||||
total_tax: -100,
|
||||
vat_breakdown: [{ rate: 25, net: 400, tax: 100 }],
|
||||
line_items: [],
|
||||
}),
|
||||
)
|
||||
expect(model.title).toBe('Orderunderlag: återbetalning')
|
||||
expect(model.isRefund).toBe(true)
|
||||
expect(model.vatRows).toEqual([{ rateLabel: '25%', net: -400, tax: -100, gross: -500 }])
|
||||
expect(model.totalGross).toBe(-500)
|
||||
expect(model.totalNet).toBe(-400)
|
||||
})
|
||||
|
||||
it('keeps signed buckets as stored on order rows (discount bucket)', () => {
|
||||
const model = buildOrderUnderlagModel(
|
||||
makeOrder({
|
||||
total: 375,
|
||||
total_tax: 75,
|
||||
vat_breakdown: [
|
||||
{ rate: 25, net: 400, tax: 100 },
|
||||
{ rate: 0, net: -100, tax: -25 },
|
||||
],
|
||||
}),
|
||||
)
|
||||
expect(model.vatRows[1]).toEqual({ rateLabel: '0%', net: -100, tax: -25, gross: -125 })
|
||||
})
|
||||
|
||||
it('falls back to the inferred single bucket when the breakdown is empty', () => {
|
||||
const model = buildOrderUnderlagModel(
|
||||
makeOrder({ vat_breakdown: [], total: 125, total_tax: 25 }),
|
||||
)
|
||||
expect(model.vatRows).toEqual([{ rateLabel: '25%', net: 100, tax: 25, gross: 125 }])
|
||||
})
|
||||
|
||||
it('labels an unresolved line rate with a dash', () => {
|
||||
const model = buildOrderUnderlagModel(
|
||||
makeOrder({
|
||||
line_items: [{ name: 'Vara', quantity: 1, total: 100, total_tax: 0, vat_rate: null }],
|
||||
}),
|
||||
)
|
||||
expect(model.lines[0].vatRateLabel).toBe('-')
|
||||
})
|
||||
|
||||
it('carries the SEK conversion facts on non-SEK orders', () => {
|
||||
const model = buildOrderUnderlagModel(
|
||||
makeOrder({ currency: 'EUR', total: 50, total_tax: 10, total_sek: 561.5, exchange_rate: 11.23 }),
|
||||
)
|
||||
expect(model.currency).toBe('EUR')
|
||||
expect(model.totalSek).toBe(561.5)
|
||||
expect(model.exchangeRate).toBe(11.23)
|
||||
})
|
||||
})
|
||||
|
||||
describe('formatAmount', () => {
|
||||
it('renders negatives with an ASCII hyphen, never U+2212 (WinAnsi PDF fonts drop it)', () => {
|
||||
const formatted = formatAmount(-500)
|
||||
// sv-SE Intl emits U+2212 MINUS SIGN; Helvetica/WinAnsi has no glyph for
|
||||
// it, so an unguarded refund amount would silently render as positive in
|
||||
// the archived underlag (skeptic finding).
|
||||
expect(formatted.includes(String.fromCharCode(0x2212))).toBe(false)
|
||||
expect(formatted.startsWith('-')).toBe(true)
|
||||
expect(formatted.endsWith('500,00')).toBe(true)
|
||||
})
|
||||
|
||||
it('formats two decimals with a Swedish decimal comma', () => {
|
||||
expect(formatAmount(80.24).endsWith('80,24')).toBe(true)
|
||||
expect(formatAmount(0)).toBe('0,00')
|
||||
})
|
||||
})
|
||||
|
||||
describe('orderUnderlagFilename', () => {
|
||||
it('names order and refund underlag distinctly', () => {
|
||||
expect(
|
||||
orderUnderlagFilename({ isRefund: false, orderNumber: '1001', orderDate: '2026-08-01' }),
|
||||
).toBe('Orderunderlag_1001_2026-08-01.pdf')
|
||||
expect(
|
||||
orderUnderlagFilename({ isRefund: true, orderNumber: '1001', orderDate: '2026-08-05' }),
|
||||
).toBe('Orderunderlag_aterbetalning_1001_2026-08-05.pdf')
|
||||
})
|
||||
})
|
||||
|
||||
describe('archiveWebshopOrderUnderlag', () => {
|
||||
const { supabase: supabaseMock, mockResult } = createMockSupabase()
|
||||
const supabase = supabaseMock as unknown as SupabaseClient
|
||||
|
||||
beforeEach(() => {
|
||||
vi.clearAllMocks()
|
||||
mockResult({ data: { company_name: 'Testbolag AB', org_number: '556677-8899' } })
|
||||
mockUploadDocument.mockResolvedValue({ id: 'doc-1' })
|
||||
})
|
||||
|
||||
it('renders a PDF and archives it anchored to the verifikat', async () => {
|
||||
const result = await archiveWebshopOrderUnderlag({
|
||||
supabase,
|
||||
companyId: 'company-1',
|
||||
userId: 'user-1',
|
||||
order: makeOrder(),
|
||||
journalEntryId: 'je-1',
|
||||
log,
|
||||
})
|
||||
expect(result).toEqual({ ok: true, documentId: 'doc-1' })
|
||||
expect(mockUploadDocument).toHaveBeenCalledTimes(1)
|
||||
const [, userId, companyId, file, metadata] = mockUploadDocument.mock.calls[0]
|
||||
expect(userId).toBe('user-1')
|
||||
expect(companyId).toBe('company-1')
|
||||
expect(file.name).toBe('Orderunderlag_1001_2026-08-01.pdf')
|
||||
expect(file.type).toBe('application/pdf')
|
||||
// Real render: the buffer must actually be a PDF.
|
||||
const head = Buffer.from(file.buffer as ArrayBuffer).subarray(0, 5).toString('utf8')
|
||||
expect(head).toBe('%PDF-')
|
||||
expect(metadata).toMatchObject({
|
||||
upload_source: 'system',
|
||||
journal_entry_id: 'je-1',
|
||||
extractionOwner: 'none',
|
||||
})
|
||||
})
|
||||
|
||||
it('returns ok=false and logs instead of throwing when the archive fails', async () => {
|
||||
mockUploadDocument.mockRejectedValueOnce(new Error('storage down'))
|
||||
const result = await archiveWebshopOrderUnderlag({
|
||||
supabase,
|
||||
companyId: 'company-1',
|
||||
userId: 'user-1',
|
||||
order: makeOrder(),
|
||||
journalEntryId: 'je-1',
|
||||
log,
|
||||
})
|
||||
expect(result).toEqual({ ok: false, documentId: null })
|
||||
expect(log.error).toHaveBeenCalled()
|
||||
})
|
||||
|
||||
it('renders without customer data and without company settings', async () => {
|
||||
mockResult({ data: null })
|
||||
const result = await archiveWebshopOrderUnderlag({
|
||||
supabase,
|
||||
companyId: 'company-1',
|
||||
userId: 'user-1',
|
||||
order: makeOrder({
|
||||
customer_name: null,
|
||||
customer_company: null,
|
||||
customer_email: null,
|
||||
customer_country: null,
|
||||
line_items: [],
|
||||
}),
|
||||
journalEntryId: 'je-1',
|
||||
log,
|
||||
})
|
||||
expect(result.ok).toBe(true)
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,532 @@
|
||||
import { Document, Page, Text, View, StyleSheet, renderToBuffer } from '@react-pdf/renderer'
|
||||
import type { SupabaseClient } from '@supabase/supabase-js'
|
||||
import { roundOre } from '@/lib/money'
|
||||
import { uploadDocument } from '@/lib/core/documents/document-service'
|
||||
import { fallbackVatBreakdown } from '@/lib/webshop-orders/booking-lines'
|
||||
import type { Logger } from '@/lib/logger'
|
||||
import type { WebshopOrder } from '@/types'
|
||||
|
||||
/**
|
||||
* Orderunderlag for a booked webshop order (issue #1881).
|
||||
*
|
||||
* The booking verifikat only carries the VAT split (buildOrderBookingLines),
|
||||
* so without this document the archived affärshändelse loses everything the
|
||||
* sync already knows: product lines, customer, payment method. BFL 5 kap 7 §
|
||||
* requires the verifikation to rest on underlag that shows what the
|
||||
* affärshändelse was; this module renders that underlag from the stored
|
||||
* webshop_orders row and archives it on the verifikat through the same WORM
|
||||
* document path the issued-invoice PDF uses (archiveIssuedInvoicePdf).
|
||||
*
|
||||
* Swedish-only on purpose: underlag is räkenskapsinformation, the same
|
||||
* stays-Swedish surface class as invoice PDFs and SIE exports.
|
||||
*/
|
||||
|
||||
/** Everything the PDF renders, precomputed so it is testable without react-pdf. */
|
||||
export interface OrderUnderlagModel {
|
||||
title: string
|
||||
isRefund: boolean
|
||||
orderNumber: string
|
||||
platformLabel: string
|
||||
storeLabel: string | null
|
||||
orderDate: string
|
||||
paidDate: string | null
|
||||
status: string
|
||||
/** Company/person lines shown under "Kund"; empty when the store sent none. */
|
||||
customerLines: string[]
|
||||
paymentMethod: string | null
|
||||
gatewayReference: string | null
|
||||
currency: string
|
||||
lines: Array<{
|
||||
name: string
|
||||
quantity: number
|
||||
/** Net (excl. VAT), in the order's currency, signed as stored. */
|
||||
net: number
|
||||
tax: number
|
||||
/** '25%' | '12%' | '6%' | '0%' | '-' (unresolved rate). */
|
||||
vatRateLabel: string
|
||||
}>
|
||||
/** Per-rate summary; signed like the row (negative on refunds). */
|
||||
vatRows: Array<{ rateLabel: string; net: number; tax: number; gross: number }>
|
||||
totalNet: number
|
||||
totalTax: number
|
||||
totalGross: number
|
||||
/** SEK conversion facts for non-SEK orders; null when SEK or unresolved. */
|
||||
totalSek: number | null
|
||||
exchangeRate: number | null
|
||||
}
|
||||
|
||||
const PLATFORM_LABELS: Record<string, string> = {
|
||||
woocommerce: 'WooCommerce',
|
||||
shopify: 'Shopify',
|
||||
}
|
||||
|
||||
function vatRateLabel(rate: number | null): string {
|
||||
if (rate === null) return '-'
|
||||
return `${rate}%`
|
||||
}
|
||||
|
||||
/**
|
||||
* Build the render model from a stored order row. Pure; all money through
|
||||
* roundOre. Refund rows keep their negative signs so the underlag reads like
|
||||
* the money movement it documents.
|
||||
*/
|
||||
export function buildOrderUnderlagModel(
|
||||
order: Pick<
|
||||
WebshopOrder,
|
||||
| 'row_type'
|
||||
| 'platform'
|
||||
| 'store_label'
|
||||
| 'store_scope'
|
||||
| 'order_number'
|
||||
| 'status'
|
||||
| 'order_date'
|
||||
| 'paid_date'
|
||||
| 'currency'
|
||||
| 'total'
|
||||
| 'total_tax'
|
||||
| 'total_sek'
|
||||
| 'exchange_rate'
|
||||
| 'vat_breakdown'
|
||||
| 'line_items'
|
||||
| 'customer_name'
|
||||
| 'customer_company'
|
||||
| 'customer_email'
|
||||
| 'customer_country'
|
||||
| 'payment_method'
|
||||
| 'payment_method_title'
|
||||
| 'gateway_reference'
|
||||
>,
|
||||
): OrderUnderlagModel {
|
||||
const isRefund = order.row_type === 'refund'
|
||||
const currency = order.currency.toUpperCase()
|
||||
const isSek = currency === 'SEK'
|
||||
|
||||
const lines = (order.line_items ?? []).map((item) => ({
|
||||
name: item.name,
|
||||
quantity: item.quantity,
|
||||
net: roundOre(item.total),
|
||||
tax: roundOre(item.total_tax),
|
||||
vatRateLabel: vatRateLabel(item.vat_rate),
|
||||
}))
|
||||
|
||||
// Refund rows store the breakdown as positive magnitudes (direction lives
|
||||
// in row_type, mirroring booking-lines); re-apply the sign so the summary
|
||||
// matches the negative totals. Order rows keep the buckets as stored:
|
||||
// they are SIGNED there (a discount bucket carries a negative net). Fall
|
||||
// back to the inferred single bucket exactly like the booking prefill when
|
||||
// the sync could not build one.
|
||||
const breakdown =
|
||||
order.vat_breakdown.length > 0
|
||||
? order.vat_breakdown
|
||||
: fallbackVatBreakdown(order.total, order.total_tax)
|
||||
const vatRows = breakdown.map((bucket) => {
|
||||
const net = roundOre(isRefund ? -Math.abs(bucket.net) : bucket.net)
|
||||
const tax = roundOre(isRefund ? -Math.abs(bucket.tax) : bucket.tax)
|
||||
return {
|
||||
rateLabel: vatRateLabel(bucket.rate),
|
||||
net,
|
||||
tax,
|
||||
gross: roundOre(net + tax),
|
||||
}
|
||||
})
|
||||
|
||||
const totalGross = roundOre(order.total)
|
||||
const totalTax = roundOre(order.total_tax)
|
||||
|
||||
const customerLines = [
|
||||
order.customer_company,
|
||||
order.customer_name,
|
||||
order.customer_email,
|
||||
order.customer_country ? `Land: ${order.customer_country.toUpperCase()}` : null,
|
||||
].filter((line): line is string => !!line)
|
||||
|
||||
return {
|
||||
title: isRefund ? 'Orderunderlag: återbetalning' : 'Orderunderlag',
|
||||
isRefund,
|
||||
orderNumber: order.order_number,
|
||||
platformLabel: PLATFORM_LABELS[order.platform] ?? order.platform,
|
||||
storeLabel: order.store_label || order.store_scope || null,
|
||||
orderDate: order.order_date,
|
||||
paidDate: order.paid_date,
|
||||
status: order.status,
|
||||
customerLines,
|
||||
paymentMethod: order.payment_method_title || order.payment_method || null,
|
||||
gatewayReference: order.gateway_reference,
|
||||
currency,
|
||||
lines,
|
||||
vatRows,
|
||||
totalNet: roundOre(totalGross - totalTax),
|
||||
totalTax,
|
||||
totalGross,
|
||||
totalSek: isSek ? null : order.total_sek !== null ? roundOre(order.total_sek) : null,
|
||||
exchangeRate: isSek ? null : order.exchange_rate,
|
||||
}
|
||||
}
|
||||
|
||||
/** Sanitized-enough name; uploadDocument sanitizes the storage key itself. */
|
||||
export function orderUnderlagFilename(model: Pick<OrderUnderlagModel, 'isRefund' | 'orderNumber' | 'orderDate'>): string {
|
||||
const kind = model.isRefund ? 'Orderunderlag_aterbetalning' : 'Orderunderlag'
|
||||
return `${kind}_${model.orderNumber}_${model.orderDate}.pdf`
|
||||
}
|
||||
|
||||
const styles = StyleSheet.create({
|
||||
page: {
|
||||
paddingTop: 40,
|
||||
paddingHorizontal: 40,
|
||||
paddingBottom: 60,
|
||||
fontSize: 9,
|
||||
fontFamily: 'Helvetica',
|
||||
},
|
||||
header: {
|
||||
flexDirection: 'row',
|
||||
justifyContent: 'space-between',
|
||||
alignItems: 'flex-start',
|
||||
marginBottom: 20,
|
||||
paddingBottom: 12,
|
||||
borderBottomWidth: 1,
|
||||
borderBottomColor: '#d4d4d4',
|
||||
},
|
||||
title: {
|
||||
fontSize: 18,
|
||||
fontWeight: 'bold',
|
||||
color: '#1a1a1a',
|
||||
marginBottom: 4,
|
||||
},
|
||||
subtitle: {
|
||||
fontSize: 10,
|
||||
color: '#333',
|
||||
marginBottom: 2,
|
||||
},
|
||||
meta: {
|
||||
fontSize: 9,
|
||||
color: '#666',
|
||||
},
|
||||
companyInfo: {
|
||||
textAlign: 'right',
|
||||
},
|
||||
companyName: {
|
||||
fontSize: 11,
|
||||
fontWeight: 'bold',
|
||||
marginBottom: 2,
|
||||
},
|
||||
block: {
|
||||
marginBottom: 12,
|
||||
},
|
||||
blockRow: {
|
||||
flexDirection: 'row',
|
||||
gap: 32,
|
||||
marginBottom: 14,
|
||||
},
|
||||
blockLabel: {
|
||||
fontSize: 7.5,
|
||||
fontWeight: 'bold',
|
||||
color: '#555',
|
||||
textTransform: 'uppercase',
|
||||
marginBottom: 3,
|
||||
},
|
||||
blockText: {
|
||||
fontSize: 9,
|
||||
color: '#1a1a1a',
|
||||
marginBottom: 1,
|
||||
},
|
||||
blockMuted: {
|
||||
fontSize: 9,
|
||||
color: '#888',
|
||||
fontStyle: 'italic',
|
||||
},
|
||||
sectionHeading: {
|
||||
fontSize: 11,
|
||||
fontWeight: 'bold',
|
||||
color: '#1a1a1a',
|
||||
marginTop: 8,
|
||||
marginBottom: 5,
|
||||
paddingBottom: 3,
|
||||
borderBottomWidth: 1,
|
||||
borderBottomColor: '#1a1a1a',
|
||||
},
|
||||
tableHeader: {
|
||||
flexDirection: 'row',
|
||||
paddingVertical: 3,
|
||||
borderBottomWidth: 0.8,
|
||||
borderBottomColor: '#999',
|
||||
},
|
||||
headerCell: {
|
||||
fontSize: 7.5,
|
||||
fontWeight: 'bold',
|
||||
color: '#555',
|
||||
textTransform: 'uppercase',
|
||||
},
|
||||
row: {
|
||||
flexDirection: 'row',
|
||||
paddingVertical: 3,
|
||||
borderBottomWidth: 0.4,
|
||||
borderBottomColor: '#e4e4e4',
|
||||
},
|
||||
totalRow: {
|
||||
flexDirection: 'row',
|
||||
paddingVertical: 4,
|
||||
marginTop: 2,
|
||||
borderTopWidth: 1,
|
||||
borderTopColor: '#1a1a1a',
|
||||
},
|
||||
colName: {
|
||||
flex: 1,
|
||||
paddingRight: 8,
|
||||
color: '#1a1a1a',
|
||||
},
|
||||
colQty: {
|
||||
width: 40,
|
||||
textAlign: 'right',
|
||||
fontFamily: 'Courier',
|
||||
},
|
||||
colAmount: {
|
||||
width: 70,
|
||||
textAlign: 'right',
|
||||
fontFamily: 'Courier',
|
||||
color: '#1a1a1a',
|
||||
},
|
||||
colRate: {
|
||||
width: 50,
|
||||
textAlign: 'right',
|
||||
color: '#666',
|
||||
},
|
||||
bold: {
|
||||
fontWeight: 'bold',
|
||||
},
|
||||
footer: {
|
||||
position: 'absolute',
|
||||
bottom: 24,
|
||||
left: 40,
|
||||
right: 40,
|
||||
borderTopWidth: 0.5,
|
||||
borderTopColor: '#d4d4d4',
|
||||
paddingTop: 6,
|
||||
flexDirection: 'row',
|
||||
justifyContent: 'space-between',
|
||||
},
|
||||
footerText: {
|
||||
fontSize: 8,
|
||||
color: '#888',
|
||||
},
|
||||
})
|
||||
|
||||
// U+2212 MINUS SIGN, which sv-SE Intl emits for negatives. Standard PDF
|
||||
// fonts (Helvetica/WinAnsi) have no glyph for it and drop it silently, so a
|
||||
// refund would render as a POSITIVE amount in the archived underlag (skeptic
|
||||
// finding; same guard as formatPdfCurrency in lib/invoices/pdf-template).
|
||||
// Built via fromCharCode so no escape sequence can mangle in transit.
|
||||
const UNICODE_MINUS = String.fromCharCode(0x2212)
|
||||
|
||||
/** Exported for tests: the sign guard must never regress. */
|
||||
export function formatAmount(amount: number): string {
|
||||
return new Intl.NumberFormat('sv-SE', {
|
||||
minimumFractionDigits: 2,
|
||||
maximumFractionDigits: 2,
|
||||
})
|
||||
.format(amount)
|
||||
.replaceAll(UNICODE_MINUS, '-')
|
||||
}
|
||||
|
||||
export interface OrderUnderlagCompany {
|
||||
company_name?: string | null
|
||||
org_number?: string | null
|
||||
}
|
||||
|
||||
export function WebshopOrderUnderlagPDF({
|
||||
model,
|
||||
company,
|
||||
generatedAt,
|
||||
}: {
|
||||
model: OrderUnderlagModel
|
||||
company: OrderUnderlagCompany
|
||||
generatedAt: string
|
||||
}) {
|
||||
return (
|
||||
<Document>
|
||||
<Page size="A4" style={styles.page}>
|
||||
<View style={styles.header} fixed>
|
||||
<View>
|
||||
<Text style={styles.title}>{model.title}</Text>
|
||||
<Text style={styles.subtitle}>
|
||||
Order {model.orderNumber}
|
||||
{model.storeLabel ? ` · ${model.storeLabel}` : ''} ({model.platformLabel})
|
||||
</Text>
|
||||
<Text style={styles.meta}>
|
||||
Orderdatum: {model.orderDate}
|
||||
{model.paidDate ? ` · Betald: ${model.paidDate}` : ''} · Status: {model.status}
|
||||
</Text>
|
||||
</View>
|
||||
<View style={styles.companyInfo}>
|
||||
{company.company_name ? (
|
||||
<Text style={styles.companyName}>{company.company_name}</Text>
|
||||
) : null}
|
||||
{company.org_number ? (
|
||||
<Text style={styles.meta}>Org.nr: {company.org_number}</Text>
|
||||
) : null}
|
||||
</View>
|
||||
</View>
|
||||
|
||||
<View style={styles.blockRow}>
|
||||
<View style={styles.block}>
|
||||
<Text style={styles.blockLabel}>Kund</Text>
|
||||
{model.customerLines.length > 0 ? (
|
||||
model.customerLines.map((line, i) => (
|
||||
<Text key={i} style={styles.blockText}>
|
||||
{line}
|
||||
</Text>
|
||||
))
|
||||
) : (
|
||||
<Text style={styles.blockMuted}>Uppgift saknas i ordern</Text>
|
||||
)}
|
||||
</View>
|
||||
<View style={styles.block}>
|
||||
<Text style={styles.blockLabel}>Betalning</Text>
|
||||
<Text style={styles.blockText}>{model.paymentMethod ?? 'Okänd betalmetod'}</Text>
|
||||
{model.gatewayReference ? (
|
||||
<Text style={styles.blockText}>Referens: {model.gatewayReference}</Text>
|
||||
) : null}
|
||||
{model.totalSek !== null ? (
|
||||
<Text style={styles.blockText}>
|
||||
Motsvarande i SEK: {formatAmount(model.totalSek)} kr
|
||||
{model.exchangeRate ? ` (kurs ${model.exchangeRate})` : ''}
|
||||
</Text>
|
||||
) : null}
|
||||
</View>
|
||||
</View>
|
||||
|
||||
<Text style={styles.sectionHeading}>Orderrader ({model.currency})</Text>
|
||||
{model.lines.length === 0 ? (
|
||||
<Text style={styles.blockMuted}>Ordern saknar radspecifikation från butiken.</Text>
|
||||
) : (
|
||||
<View>
|
||||
<View style={styles.tableHeader}>
|
||||
<Text style={[styles.colName, styles.headerCell]}>Beskrivning</Text>
|
||||
<Text style={[styles.colQty, styles.headerCell]}>Antal</Text>
|
||||
<Text style={[styles.colAmount, styles.headerCell]}>Exkl. moms</Text>
|
||||
<Text style={[styles.colAmount, styles.headerCell]}>Moms</Text>
|
||||
<Text style={[styles.colRate, styles.headerCell]}>Sats</Text>
|
||||
</View>
|
||||
{model.lines.map((line, i) => (
|
||||
<View key={i} style={styles.row} wrap={false}>
|
||||
<Text style={styles.colName}>{line.name}</Text>
|
||||
<Text style={styles.colQty}>{line.quantity}</Text>
|
||||
<Text style={styles.colAmount}>{formatAmount(line.net)}</Text>
|
||||
<Text style={styles.colAmount}>{formatAmount(line.tax)}</Text>
|
||||
<Text style={styles.colRate}>{line.vatRateLabel}</Text>
|
||||
</View>
|
||||
))}
|
||||
</View>
|
||||
)}
|
||||
|
||||
<Text style={styles.sectionHeading}>Belopp per momssats ({model.currency})</Text>
|
||||
<View>
|
||||
<View style={styles.tableHeader}>
|
||||
<Text style={[styles.colName, styles.headerCell]}>Momssats</Text>
|
||||
<Text style={[styles.colAmount, styles.headerCell]}>Netto</Text>
|
||||
<Text style={[styles.colAmount, styles.headerCell]}>Moms</Text>
|
||||
<Text style={[styles.colAmount, styles.headerCell]}>Summa</Text>
|
||||
</View>
|
||||
{model.vatRows.map((row, i) => (
|
||||
<View key={i} style={styles.row} wrap={false}>
|
||||
<Text style={styles.colName}>{row.rateLabel}</Text>
|
||||
<Text style={styles.colAmount}>{formatAmount(row.net)}</Text>
|
||||
<Text style={styles.colAmount}>{formatAmount(row.tax)}</Text>
|
||||
<Text style={styles.colAmount}>{formatAmount(row.gross)}</Text>
|
||||
</View>
|
||||
))}
|
||||
<View style={styles.totalRow}>
|
||||
<Text style={[styles.colName, styles.bold]}>Totalt</Text>
|
||||
<Text style={[styles.colAmount, styles.bold]}>{formatAmount(model.totalNet)}</Text>
|
||||
<Text style={[styles.colAmount, styles.bold]}>{formatAmount(model.totalTax)}</Text>
|
||||
<Text style={[styles.colAmount, styles.bold]}>{formatAmount(model.totalGross)}</Text>
|
||||
</View>
|
||||
</View>
|
||||
|
||||
<View style={styles.footer} fixed>
|
||||
<Text style={styles.footerText}>
|
||||
Underlag genererat ur butikens orderdata vid bokföring
|
||||
</Text>
|
||||
<Text
|
||||
style={styles.footerText}
|
||||
render={({ pageNumber, totalPages }) =>
|
||||
`Genererad ${generatedAt} · Sida ${pageNumber} av ${totalPages}`
|
||||
}
|
||||
/>
|
||||
</View>
|
||||
</Page>
|
||||
</Document>
|
||||
)
|
||||
}
|
||||
|
||||
export interface ArchiveOrderUnderlagResult {
|
||||
ok: boolean
|
||||
documentId: string | null
|
||||
}
|
||||
|
||||
/**
|
||||
* Render the orderunderlag and archive it on the just-committed verifikat.
|
||||
* Mirrors archiveIssuedInvoicePdf: never throws, the booking is already
|
||||
* committed and immutable, so a failure here is logged and surfaced to the
|
||||
* caller as ok=false. The verifikat then stays on the "saknar underlag"
|
||||
* worklist (webshop_order is a needs-doc source type), which is exactly the
|
||||
* recovery mechanism: the user attaches an underlag by hand.
|
||||
*/
|
||||
export async function archiveWebshopOrderUnderlag(args: {
|
||||
supabase: SupabaseClient
|
||||
companyId: string
|
||||
userId: string
|
||||
order: WebshopOrder
|
||||
journalEntryId: string
|
||||
log: Logger
|
||||
}): Promise<ArchiveOrderUnderlagResult> {
|
||||
const { supabase, companyId, userId, order, journalEntryId, log } = args
|
||||
try {
|
||||
const model = buildOrderUnderlagModel(order)
|
||||
|
||||
// Header context only; the underlag is valid without it.
|
||||
let company: OrderUnderlagCompany = {}
|
||||
try {
|
||||
const { data } = await supabase
|
||||
.from('company_settings')
|
||||
.select('company_name, org_number')
|
||||
.eq('company_id', companyId)
|
||||
.maybeSingle()
|
||||
company = (data as OrderUnderlagCompany | null) ?? {}
|
||||
} catch {
|
||||
company = {}
|
||||
}
|
||||
|
||||
const pdfBuffer = await renderToBuffer(
|
||||
WebshopOrderUnderlagPDF({
|
||||
model,
|
||||
company,
|
||||
generatedAt: new Date().toISOString().split('T')[0],
|
||||
}),
|
||||
)
|
||||
const pdfArrayBuffer = new Uint8Array(pdfBuffer).buffer as ArrayBuffer
|
||||
|
||||
const document = await uploadDocument(
|
||||
supabase,
|
||||
userId,
|
||||
companyId,
|
||||
{
|
||||
name: orderUnderlagFilename(model),
|
||||
buffer: pdfArrayBuffer,
|
||||
type: 'application/pdf',
|
||||
},
|
||||
{
|
||||
upload_source: 'system',
|
||||
journal_entry_id: journalEntryId,
|
||||
// Self-generated from structured data: nothing to extract.
|
||||
extractionOwner: 'none',
|
||||
},
|
||||
)
|
||||
return { ok: true, documentId: document.id }
|
||||
} catch (err) {
|
||||
log.error('failed to archive webshop order underlag', err as Error, {
|
||||
orderId: order.id,
|
||||
journalEntryId,
|
||||
})
|
||||
return { ok: false, documentId: null }
|
||||
}
|
||||
}
|
||||
@@ -16,21 +16,11 @@ import {
|
||||
} from '@/lib/invoices/matchable-statuses'
|
||||
import type { SuggestedMatch } from './types'
|
||||
|
||||
const log = createLogger('worklist')
|
||||
// Canonical home is lib/worklist/types.ts (dependency-free, client-safe);
|
||||
// re-exported here so existing server-side imports keep working.
|
||||
export { NEEDS_DOC_SOURCE_TYPES } from './types'
|
||||
|
||||
/**
|
||||
* Journal-entry source types that require underlag (BFL 5 kap 7§). Source
|
||||
* types representing system-generated entries (VAT settlement, year-end,
|
||||
* currency revaluation, …) are exempt by omission.
|
||||
*/
|
||||
export const NEEDS_DOC_SOURCE_TYPES = [
|
||||
'manual',
|
||||
'bank_transaction',
|
||||
'supplier_invoice_registered',
|
||||
'supplier_invoice_paid',
|
||||
'supplier_invoice_cash_payment',
|
||||
'import',
|
||||
] as const
|
||||
const log = createLogger('worklist')
|
||||
|
||||
/**
|
||||
* Upper bound on the unconsumed-inbox scan in countInboxDocuments. An inbox
|
||||
|
||||
@@ -117,3 +117,27 @@ export interface SuggestedMatch {
|
||||
counterparty_name: string | null
|
||||
candidate_total: number | null
|
||||
}
|
||||
|
||||
/**
|
||||
* Journal-entry source types that require underlag (BFL 5 kap 7 §). Source
|
||||
* types representing system-generated entries (VAT settlement, year-end,
|
||||
* currency revaluation, ...) are exempt by omission.
|
||||
*
|
||||
* Single source of truth for EVERY TS surface (worklist counts, journal-list
|
||||
* chip/waiver UI, no-doc-required batch route, push notifications); the SQL
|
||||
* mirror lives in the verifikat_without_documents RPC, pinned by
|
||||
* tests/pg/document-surfaces-unification.pg.test.ts. Lives here (not in
|
||||
* categories.ts) because this module is dependency-free and safe to import
|
||||
* from client components.
|
||||
*/
|
||||
export const NEEDS_DOC_SOURCE_TYPES = [
|
||||
'manual',
|
||||
'bank_transaction',
|
||||
'supplier_invoice_registered',
|
||||
'supplier_invoice_paid',
|
||||
'supplier_invoice_cash_payment',
|
||||
'import',
|
||||
// Webshop order bookings rest on the generated orderunderlag (#1881); an
|
||||
// entry whose underlag failed to attach must surface here.
|
||||
'webshop_order',
|
||||
] as const
|
||||
|
||||
Reference in New Issue
Block a user