Files
accounted/lib/import/shared/column-utils.ts
T
Jakob Wennberg 2d6ddeafc5 feat(import/export): article import + register export (xlsx/csv) (#750)
* feat(import/export): article import + register export (xlsx/csv)

Add CSV/Excel import for the article register (artiklar), mirroring the
existing customer/supplier import pipeline, plus Excel + CSV export for
articles, customers and suppliers.

Import (lib/import/articles + app/api/import/articles):
- Column auto-detection tuned to Fortnox/Visma/Bokio export headers,
  Swedish-decimal price parsing, VAT snapped to {0,6,12,25}, type/unit
  normalization.
- Dedup by article number then name; 23505 soft-skip; auto-number
  backfill; revenue-account override kept only when active, otherwise
  dropped with a warning (never mutates the chart of accounts).
- New "Artiklar" flow in the /import hub.

Export (app/api/export/* + lib/export/register-export):
- Read-only xlsx (default) / csv (?format=csv, UTF-8 BOM) downloads.
- Headers chosen so files round-trip back through the importer.
- "Exportera" menu added to the articles, customers and suppliers pages.

Refs #746. Direct Fortnox/Visma API article fetch tracked in #749.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix(import/export): address PR review — lint ratchet + export hardening

- xlsx-export: keep `SheetSpec<any>` on the eslint-disabled line (fixes the
  core-only lint ratchet regression: no-explicit-any 16 -> 15) and define
  UTF8_BOM as an explicit `` escape instead of a raw BOM character.
- export routes (articles/customers/suppliers): move the data queries inside
  the try/catch, add `Cache-Control: no-store`, and emit a `register exported`
  audit log line (entity, format, rowCount).
- articles parse route: validate `column_overrides` against a Zod schema before
  trusting it to drive the parser.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* fix(import): drop öre-round pattern on article column-detector confidence

The confidence score is a 0-1 heuristic, not money, and is only compared
against the 0.8 skip-mapping threshold. Removing the Math.round(x*100)/100
form clears the core-only antipattern ratchet (naive-ore-round 660 -> 659).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* feat(import): flag adjusted VAT rows in the article import edit step

Surface VAT snapping/defaulting per row, not just as a file-level warning:
the parser sets `vat_rate_adjusted`, the edit step highlights those rows'
VAT selector and shows a count banner, and confirming a rate clears the flag.
Addresses the Swedish-compliance review note that silent snapping could
otherwise store a wrong VAT rate at scale.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:38:44 +02:00

69 lines
2.0 KiB
TypeScript

/**
* Shared column-detection helpers for register imports
* (customers, suppliers, articles).
*/
export function normalize(header: string): string {
return header.toLowerCase().trim().replace(/[_\-./]/g, ' ')
}
export function matchesKeywords(header: string, keywords: string[]): boolean {
const normalized = normalize(header)
return keywords.some((kw) => normalized === kw || normalized.includes(kw))
}
/**
* Find the first column index whose header matches one of `keywords`,
* skipping any indices already taken by other columns.
*/
export function findColumn(
headers: string[],
keywords: string[],
taken: Set<number>,
): number | null {
for (let i = 0; i < headers.length; i++) {
if (taken.has(i)) continue
if (matchesKeywords(headers[i], keywords)) {
taken.add(i)
return i
}
}
return null
}
/** Trim a string-or-blank cell, returning null when empty. */
export function cellOrNull(value: unknown): string | null {
if (value === null || value === undefined) return null
const str = String(value).trim()
return str === '' ? null : str
}
/** Parse an integer payment term ("30 dagar" → 30) with a default fallback. */
export function parsePaymentTerms(value: unknown, fallback: number): number {
const str = cellOrNull(value)
if (!str) return fallback
const match = str.match(/-?\d+/)
if (!match) return fallback
const n = parseInt(match[0], 10)
if (isNaN(n) || n < 0 || n > 365) return fallback
return n
}
/**
* Normalize an org/personal number to its dedup key (digits only).
* Returns null for empty input or strings that contain no digits.
*/
export function normalizeOrgNumber(value: string | null): string | null {
if (!value) return null
return value.replace(/\D/g, '') || null
}
/**
* Normalize an email to its dedup key (trimmed + lowercased).
* Returns null for empty/whitespace-only input.
*/
export function normalizeEmail(value: string | null): string | null {
if (!value) return null
return value.trim().toLowerCase() || null
}