/** * Maps Arcim Sync canonical DTOs to Accounted internal types. * * These mappers transform the normalized data from any Swedish accounting * provider into the exact shapes Accounted expects for database insertion. */ import type { CustomerType, SupplierType, VatTreatment } from '@/types' import type { CustomerDto, SupplierDto, SalesInvoiceDto, SalesInvoiceLineDto, SupplierInvoiceDto, SupplierInvoiceLineDto, CompanyInformationDto, PostalAddress, PartyDto, } from '@/lib/providers/dto' // ── Helpers ───────────────────────────────────────────────────────── function round2(n: number): number { return Math.round(n * 100) / 100 } function formatAddress(addr?: PostalAddress): { address_line1: string | null address_line2: string | null postal_code: string | null city: string | null country: string | null } { if (!addr) { return { address_line1: null, address_line2: null, postal_code: null, city: null, country: null } } const line1 = [addr.streetName, addr.buildingNumber].filter(Boolean).join(' ') || null return { address_line1: line1, address_line2: addr.additionalStreetName || null, postal_code: addr.postalZone || null, city: addr.cityName || null, country: addr.countryCode || null, } } function getOrgNumber(party: PartyDto): string | null { // Look for SE:ORGNR scheme first, then companyId in legalEntity const seOrg = party.identifications?.find(i => i.schemeId === 'SE:ORGNR') if (seOrg) return seOrg.id return party.legalEntity?.companyId || null } const EU_COUNTRIES = ['AT', 'BE', 'BG', 'CY', 'CZ', 'DE', 'DK', 'EE', 'EL', 'ES', 'FI', 'FR', 'GR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'MT', 'NL', 'PL', 'PT', 'RO', 'SI', 'SK'] /** * Check if a string looks like a Swedish org number (XXXXXX-XXXX or 10 digits). * Swedish org numbers are 10 digits where the third digit is >= 2 (to distinguish * from personal numbers where month 01-12 appears in positions 3-4). */ function looksLikeSwedishOrgNumber(orgNumber: string | null | undefined): boolean { if (!orgNumber) return false const digits = orgNumber.replace(/[-\s]/g, '') if (digits.length !== 10 || !/^\d+$/.test(digits)) return false // Third digit >= 2 distinguishes org numbers from personal numbers const thirdDigit = parseInt(digits[2], 10) return thirdDigit >= 2 } /** * Check if a string looks like a Swedish identity number — an organisation * number or personnummer in 10-digit form, or a personnummer in the 12-digit * century-prefixed form (19xx / 20xx). Used to avoid misclassifying a domestic * party as foreign just because its number isn't exactly 10 digits: a 12-digit * personnummer like 19700616-7113 is Swedish, not an unknown foreign org number. */ function looksLikeSwedishIdNumber(orgNumber: string | null | undefined): boolean { if (!orgNumber) return false const digits = orgNumber.replace(/[-+\s]/g, '') if (!/^\d+$/.test(digits)) return false if (digits.length === 10) return true return digits.length === 12 && /^(19|20)/.test(digits) } /** * Company name suffixes that indicate a foreign (non-Swedish) entity. * These override the default swedish_business assumption when no other * signals (VAT, country code, org number) are available. */ const FOREIGN_SUFFIXES: { suffix: string; region: 'eu' | 'non_eu' }[] = [ // German { suffix: 'gmbh', region: 'eu' }, { suffix: 'ag', region: 'eu' }, { suffix: 'e.v.', region: 'eu' }, { suffix: 'ohg', region: 'eu' }, { suffix: 'kg', region: 'eu' }, { suffix: 'ug', region: 'eu' }, // French { suffix: 'sarl', region: 'eu' }, { suffix: 's.a.r.l.', region: 'eu' }, { suffix: 'sas', region: 'eu' }, // Dutch/Belgian { suffix: 'b.v.', region: 'eu' }, { suffix: 'n.v.', region: 'eu' }, { suffix: 'bv', region: 'eu' }, { suffix: 'nv', region: 'eu' }, // Spanish/Italian { suffix: 's.l.', region: 'eu' }, { suffix: 's.r.l.', region: 'eu' }, // Finnish { suffix: 'oy', region: 'eu' }, { suffix: 'oyj', region: 'eu' }, // Danish/Norwegian { suffix: 'a/s', region: 'eu' }, { suffix: 'aps', region: 'eu' }, // Anglo (could be UK, US, etc. — treat as non-EU since UK left) { suffix: 'ltd', region: 'non_eu' }, { suffix: 'limited', region: 'non_eu' }, { suffix: 'llc', region: 'non_eu' }, { suffix: 'inc', region: 'non_eu' }, { suffix: 'corp', region: 'non_eu' }, { suffix: 'plc', region: 'non_eu' }, // Irish (EU) { suffix: 'dac', region: 'eu' }, ] function inferRegionFromName(name: string | undefined): 'eu' | 'non_eu' | null { if (!name) return null const lower = name.toLowerCase().trim() for (const { suffix, region } of FOREIGN_SUFFIXES) { // Match as a word boundary at the end: "Acme GmbH" but not "Gmbhsson" if (lower.endsWith(suffix) || lower.endsWith(suffix + '.')) { // Check that there's a space or start before the suffix const pos = lower.lastIndexOf(suffix) if (pos === 0 || lower[pos - 1] === ' ') { return region } } } return null } function inferTypeFromVatOrCountry( vatNumber: string | undefined, countryCode: string | undefined, orgNumber?: string | null, companyName?: string ): 'swedish_business' | 'eu_business' | 'non_eu_business' { // 1. VAT number prefix is the strongest signal if (vatNumber) { const prefix = vatNumber.substring(0, 2).toUpperCase() if (prefix === 'SE') return 'swedish_business' if (EU_COUNTRIES.includes(prefix)) return 'eu_business' return 'non_eu_business' } // 2. Explicit country code const country = countryCode?.toUpperCase() if (country === 'SE') return 'swedish_business' if (country && EU_COUNTRIES.includes(country)) return 'eu_business' if (country) return 'non_eu_business' // 3. Swedish-format org number is strong evidence of domestic entity if (looksLikeSwedishOrgNumber(orgNumber)) return 'swedish_business' // 4. A number that isn't a Swedish-format identity number → foreign entity. // Accepts both 10-digit and 12-digit (century-prefixed) Swedish numbers so // a domestic personnummer like 19700616-7113 isn't treated as foreign. if (orgNumber) { const digits = orgNumber.replace(/[-+\s]/g, '') if (digits.length > 0 && !looksLikeSwedishIdNumber(orgNumber)) { // Not a Swedish number — use name heuristic or default to non_eu const nameRegion = inferRegionFromName(companyName) if (nameRegion === 'eu') return 'eu_business' return 'non_eu_business' } } // 5. Company name suffix heuristic (GmbH, Ltd, etc.) const nameRegion = inferRegionFromName(companyName) if (nameRegion === 'eu') return 'eu_business' if (nameRegion === 'non_eu') return 'non_eu_business' // 6. No signal at all — default to swedish_business (most common in Swedish systems) return 'swedish_business' } function inferCustomerType(dto: CustomerDto): CustomerType { if (dto.type === 'private') return 'individual' return inferTypeFromVatOrCountry( dto.vatNumber, dto.party.postalAddress?.countryCode, getOrgNumber(dto.party), dto.party.name ) } function inferSupplierType(dto: SupplierDto): SupplierType { return inferTypeFromVatOrCountry( dto.vatNumber, dto.party.postalAddress?.countryCode, getOrgNumber(dto.party), dto.party.name ) } /** * Infer customer/supplier type from a PartyDto (used by orchestrator for * minimal entity creation from invoice data). */ export function inferTypeFromParty( party: PartyDto, vatNumber?: string ): 'swedish_business' | 'eu_business' | 'non_eu_business' { return inferTypeFromVatOrCountry( vatNumber, party.postalAddress?.countryCode, getOrgNumber(party), party.name ) } function inferVatTreatment(taxPercent?: number, currencyCode?: string): VatTreatment { if (taxPercent === 25) return 'standard_25' if (taxPercent === 12) return 'reduced_12' if (taxPercent === 6) return 'reduced_6' if (taxPercent === 0 && currencyCode && currencyCode !== 'SEK') return 'export' return 'standard_25' } function inferVatRate(taxPercent?: number): number { if (taxPercent === 25 || taxPercent === 12 || taxPercent === 6) return taxPercent if (taxPercent === 0) return 0 return 25 // Default to standard rate } // ── Public mappers ────────────────────────────────────────────────── export function mapCustomer(dto: CustomerDto, userId: string, companyId: string): Record { const addr = formatAddress(dto.party.postalAddress) const customerType = inferCustomerType(dto) const number = getOrgNumber(dto.party) // The provider exposes a single identity-number field, but Accounted stores a // personnummer in `personal_number` (individuals) and an org number in // `org_number` (businesses). Route it to the column the type expects — else a // Privatperson's personnummer lands in org_number and is hidden by the // individual customer form, which renders personal_number for individuals. const isIndividual = customerType === 'individual' return { user_id: userId, company_id: companyId, name: dto.party.name, customer_type: customerType, email: dto.party.contact?.email || null, phone: dto.party.contact?.telephone || null, ...addr, org_number: isIndividual ? null : number, personal_number: isIndividual ? number : null, vat_number: dto.vatNumber || null, vat_number_validated: false, default_payment_terms: dto.defaultPaymentTermsDays || 30, notes: dto.note || null, } } export function mapSupplier(dto: SupplierDto, userId: string, companyId: string): Record { const addr = formatAddress(dto.party.postalAddress) return { user_id: userId, company_id: companyId, name: dto.party.name, supplier_type: inferSupplierType(dto), email: dto.party.contact?.email || null, phone: dto.party.contact?.telephone || null, ...addr, org_number: getOrgNumber(dto.party), vat_number: dto.vatNumber || null, bankgiro: dto.bankGiro || null, plusgiro: dto.plusGiro || null, bank_account: dto.bankAccount || null, iban: null, bic: null, default_expense_account: null, default_payment_terms: dto.defaultPaymentTermsDays || 30, default_currency: 'SEK', notes: dto.note || null, } } export function mapSalesInvoice( dto: SalesInvoiceDto, userId: string, companyId: string, customerId: string ): { invoice: Record; items: Record[] } { const subtotal = round2(dto.legalMonetaryTotal.lineExtensionAmount.value) const total = round2(dto.legalMonetaryTotal.payableAmount.value) const vatAmount = round2(dto.taxTotal?.taxAmount.value ?? (total - subtotal)) // Determine primary VAT treatment from first line with tax const primaryTaxPercent = dto.lines.find(l => l.taxPercent != null)?.taxPercent const vatTreatment = inferVatTreatment(primaryTaxPercent, dto.currencyCode) // Map Arcim status to Accounted status const statusMap: Record = { draft: 'draft', sent: 'sent', booked: 'sent', // Accounted has no 'booked' status — treat as sent paid: 'paid', overdue: 'overdue', cancelled: 'cancelled', credited: 'credited', } const isCreditNote = dto.invoiceTypeCode === '381' const invoice: Record = { user_id: userId, company_id: companyId, customer_id: customerId, invoice_number: dto.invoiceNumber, invoice_date: dto.issueDate, due_date: dto.dueDate || dto.issueDate, status: statusMap[dto.status] || 'sent', currency: dto.currencyCode || 'SEK', exchange_rate: dto.currencyCode === 'SEK' ? null : null, subtotal, subtotal_sek: dto.currencyCode === 'SEK' ? subtotal : null, vat_amount: vatAmount, vat_amount_sek: dto.currencyCode === 'SEK' ? vatAmount : null, total, total_sek: dto.currencyCode === 'SEK' ? total : null, vat_treatment: vatTreatment, vat_rate: inferVatRate(primaryTaxPercent), your_reference: null, our_reference: null, notes: dto.note || null, document_type: isCreditNote ? 'credit_note' : 'invoice', paid_at: dto.paymentStatus.paid ? dto.paymentStatus.lastPaymentDate || dto.issueDate : null, paid_amount: dto.paymentStatus.paid ? total : round2(total - dto.paymentStatus.balance.value), } const items = dto.lines.map((line, idx) => mapSalesInvoiceLine(line, idx)) return { invoice, items } } function mapSalesInvoiceLine(line: SalesInvoiceLineDto, index: number): Record { return { sort_order: index + 1, description: line.description || line.itemName || '', quantity: line.quantity || 1, unit: line.unitCode || 'st', unit_price: round2(line.unitPrice?.value ?? line.lineExtensionAmount.value), line_total: round2(line.lineExtensionAmount.value), vat_rate: inferVatRate(line.taxPercent), vat_amount: round2(line.taxAmount?.value ?? 0), } } export function mapSupplierInvoice( dto: SupplierInvoiceDto, userId: string, companyId: string, supplierId: string ): { invoice: Record; items: Record[] } { const subtotal = round2(dto.legalMonetaryTotal.lineExtensionAmount.value) const total = round2(dto.legalMonetaryTotal.payableAmount.value) const vatAmount = round2(dto.taxTotal?.taxAmount.value ?? (total - subtotal)) const primaryTaxPercent = dto.lines.find(l => l.taxPercent != null)?.taxPercent const vatTreatment = inferVatTreatment(primaryTaxPercent, dto.currencyCode) const statusMap: Record = { draft: 'registered', sent: 'registered', booked: 'registered', paid: 'paid', overdue: 'overdue', cancelled: 'credited', credited: 'credited', } const isCreditNote = dto.invoiceTypeCode === '381' // Payment-derived amounts. Treat Balance numerically (never strict === 0) so // floating drift or a residual öre resolves cleanly to paid/unpaid. const balance = round2(dto.paymentStatus.balance.value) const paidAmount = dto.paymentStatus.paid ? total : round2(total - balance) // Status MUST stay consistent with the payment amounts. The provider's // lifecycle status (dto.status) and its payment status are computed // independently upstream and can contradict each other (e.g. a Fortnox // invoice that is "booked" but fully paid). Payment state wins: // fully paid -> 'paid' // 0 < paid < total -> 'partially_paid' // otherwise -> the mapped lifecycle status const mappedStatus = statusMap[dto.status] || 'registered' let resolvedStatus: string if (isCreditNote) { // A kreditfaktura is never an open or "paid" payable. Force a credit-note // terminal status regardless of the provider's lifecycle status — the // arcim gateway is the only source of invoiceTypeCode and is NOT guaranteed // to also send status='credited', so trusting dto.status here could persist // a credit note as 'registered'/'paid' (contradicting its amounts). resolvedStatus = mappedStatus === 'reversed' ? 'reversed' : 'credited' } else if (mappedStatus === 'credited' || mappedStatus === 'reversed') { // Terminal states from the provider: never flipped by payment. resolvedStatus = mappedStatus } else if (dto.paymentStatus.paid || balance <= 0) { resolvedStatus = 'paid' } else if (paidAmount > 0 && paidAmount < total) { resolvedStatus = 'partially_paid' } else { resolvedStatus = mappedStatus } const invoice: Record = { user_id: userId, company_id: companyId, supplier_id: supplierId, supplier_invoice_number: dto.invoiceNumber, invoice_date: dto.issueDate, due_date: dto.dueDate || dto.issueDate, received_date: dto.issueDate, delivery_date: dto.deliveryDate || null, status: resolvedStatus, currency: dto.currencyCode || 'SEK', exchange_rate: dto.currencyCode === 'SEK' ? null : null, subtotal, subtotal_sek: dto.currencyCode === 'SEK' ? subtotal : null, vat_amount: vatAmount, vat_amount_sek: dto.currencyCode === 'SEK' ? vatAmount : null, total, total_sek: dto.currencyCode === 'SEK' ? total : null, vat_treatment: vatTreatment, reverse_charge: vatTreatment === 'reverse_charge', payment_reference: dto.ocrNumber || null, paid_at: resolvedStatus === 'paid' || resolvedStatus === 'partially_paid' ? dto.paymentStatus.lastPaymentDate || dto.issueDate : null, paid_amount: resolvedStatus === 'paid' ? total : Math.max(0, paidAmount), remaining_amount: resolvedStatus === 'paid' ? 0 : Math.max(0, balance), is_credit_note: isCreditNote, notes: dto.note || null, } const items = dto.lines.map((line, idx) => mapSupplierInvoiceLine(line, idx)) return { invoice, items } } function mapSupplierInvoiceLine(line: SupplierInvoiceLineDto, index: number): Record { return { sort_order: index + 1, description: line.description || line.itemName || '', quantity: line.quantity || 1, unit: line.unitCode || 'st', unit_price: round2(line.unitPrice?.value ?? line.lineExtensionAmount.value), line_total: round2(line.lineExtensionAmount.value), account_number: line.accountNumber || '4000', // Default to purchases vat_rate: inferVatRate(line.taxPercent), vat_amount: round2(line.taxAmount?.value ?? 0), } } export function mapCompanyInfo(dto: CompanyInformationDto): { company_name: string | null org_number: string | null vat_number: string | null fiscal_year_start_month: number address_line1: string | null postal_code: string | null city: string | null phone: string | null email: string | null } { const addr = formatAddress(dto.address) // Parse fiscal year start month from "MM-DD" format let fiscalYearStartMonth = 1 if (dto.fiscalYearStart) { const month = parseInt(dto.fiscalYearStart.split('-')[0], 10) if (month >= 1 && month <= 12) fiscalYearStartMonth = month } return { company_name: dto.companyName || null, org_number: dto.organizationNumber || null, vat_number: dto.vatNumber || null, fiscal_year_start_month: fiscalYearStartMonth, address_line1: addr.address_line1, postal_code: addr.postal_code, city: addr.city, phone: dto.contact?.telephone || null, email: dto.contact?.email || null, } }