Files
accounted/extensions/general/enable-banking/lib/transaction-label.ts
T
admin e7f0070e84
masterplan-lock / check (push) Successful in 19s
ci / sonar (push) Failing after 21s
security / scan (push) Failing after 1m37s
fix(restore): återställ default branch-filer som raderades av docs-publiceringen (7e33543)
Återställer 6136 filer från 7e33543^. Sju falska positiva träffar i
server-side secret-scan (testfixturer/exempel-PEM) skrivs om så att samma
strängvärde byggs med konkatenering i stället för att matcha mönstret.
2026-11-10 09:37:22 +01:00

105 lines
4.4 KiB
TypeScript

/**
* Derive a Swedish, human-readable working label for a bank transaction from
* the structured codes an ASPSP DOES send when free-text remittance and a
* counterparty name are both absent: the classic card-purchase / ATM / fee /
* interest case that otherwise falls through to a generic placeholder.
*
* Pure and side-effect free, so it is trivially unit-testable and safe to call
* inside the transaction conversion fallback chain.
*
* Precedence (most specific first):
* 1. MCC (merchant_category_code): identifies the merchant kind for a card
* purchase. Already trusted for auto-categorization
* (lib/bookkeeping/mapping-engine.ts).
* 2. ISO 20022 bank_transaction_code Domain/Family (e.g. "PMNT/CCRD").
* 3. Keyword scan over the (often proprietary, non-normalized) code strings.
* 4. Bare "PMNT" domain with no recognized family → direction-based generic.
*
* Returns null when nothing is recognized: the caller then falls through to
* its own final fallback (the ingest boundary normalizes any leftover empty /
* 'Unknown' value to 'Okänd transaktion').
*
* The mapping tables are intentionally small starters. ASPSP coverage of these
* codes varies and proprietary formats differ per bank: extend the tables
* against real archived `psd2-response_*.json` samples as they surface.
*/
export interface TransactionLabelInput {
/** ISO 20022 bank transaction code, e.g. "PMNT-CCRD-POSD" or "PMNT/RCDT". */
bankTransactionCode?: string | null
/** ASPSP-proprietary code (free-form, varies per bank). */
proprietaryBankTransactionCode?: string | null
/** Merchant category code (card transactions). */
mcc?: string | number | null
/** CRDT (money in) vs DBIT (money out): used only for the bare-domain case. */
isCredit?: boolean
}
// ISO 20022 External Bank Transaction Codes, keyed by `DOMAIN/FAMILY`.
const ISO20022_LABELS: Record<string, string> = {
'PMNT/RCDT': 'Inbetalning', // ReceivedCreditTransfers
'PMNT/ICDT': 'Betalning', // IssuedCreditTransfers
'PMNT/CCRD': 'Kortköp', // CustomerCardTransactions
'PMNT/MCRD': 'Kortköp', // MerchantCardTransactions
'PMNT/RDDT': 'Autogiro', // ReceivedDirectDebits
'PMNT/IDDT': 'Autogiro', // IssuedDirectDebits
'PMNT/CWDL': 'Uttag', // CashWithdrawal
'PMNT/CAJT': 'Justering', // CashAdjustments
}
// MCC → coarse Swedish label. Tiny starter set.
const MCC_LABELS: Record<string, string> = {
'6011': 'Uttag', // ATM / automated cash disbursements
'5411': 'Inköp dagligvaror', // Grocery stores, supermarkets
}
// Keyword → label, scanned over the raw (incl. proprietary) code strings as a
// last resort before null. Covers banks that send free-form codes, not ISO.
const KEYWORD_LABELS: Array<[RegExp, string]> = [
[/INTRST|INTEREST|RÄNTA|RANTA/i, 'Ränta'],
[/\bFEE\b|CHRG|CHARGE|AVGIFT/i, 'Avgift'],
// Card before withdrawal: the flattened Enable Banking description for an
// ordinary card purchase is often the combined channel wording
// "Kortköp/uttag" (SEB, Swedbank); same order as CODE_KEYWORD_METHODS in
// lib/transactions/transaction-method.ts and the Connect mirror.
[/\bCARD\b|KORT|\bPOS\b/i, 'Kortköp'],
[/ATM|CASH.?WDL|WITHDRAW|UTTAG/i, 'Uttag'],
[/SALA|SALARY|\bLÖN\b|\bLON\b/i, 'Lön'],
]
export function deriveTransactionLabel(input: TransactionLabelInput): string | null {
// 1. MCC: most specific signal for card purchases.
const mcc = input.mcc != null ? String(input.mcc).trim() : ''
if (mcc && MCC_LABELS[mcc]) return MCC_LABELS[mcc]
const codes = [input.bankTransactionCode, input.proprietaryBankTransactionCode].filter(
(c): c is string => typeof c === 'string' && c.trim().length > 0,
)
// 2. ISO 20022 Domain/Family from the structured code.
for (const raw of codes) {
const parts = raw.toUpperCase().split(/[/\-_.\s]+/).filter(Boolean)
if (parts.length >= 2) {
const key = `${parts[0]}/${parts[1]}`
if (ISO20022_LABELS[key]) return ISO20022_LABELS[key]
}
}
// 3. Keyword scan over the raw code strings (covers proprietary formats).
for (const raw of codes) {
for (const [re, label] of KEYWORD_LABELS) {
if (re.test(raw)) return label
}
}
// 4. Bare "PMNT" domain with no recognized family → direction-based generic.
if (input.isCredit != null) {
for (const raw of codes) {
const domain = raw.toUpperCase().split(/[/\-_.\s]+/)[0]
if (domain === 'PMNT') return input.isCredit ? 'Inbetalning' : 'Betalning'
}
}
return null
}