accounted/types/skatteverket.ts

/**
 * Skatteverket data shapes used by core UI (the /transactions page lives
 * in core, but renders skattekonto rows alongside bank tx). The DB table
 * `skattekonto_transactions` lives in core migrations even when the
 * skatteverket extension is disabled: the extension only owns the API
 * that populates it. Keeping these types in core means components can
 * render the table's shape without depending on the extension module.
 *
 * If skatteverket is disabled, the API returns 503 and the UI just sees
 * an empty list: the types remain valid descriptors of the schema.
 */

/** Row shape for the `skattekonto_transactions` table (DB → app). */
export interface StoredSkattekontoTransaction {
  id: string
  company_id: string
  transaktionsidentitet: number | null
  dedup_key: string
  transaktionsdatum: string
  forfallodatum: string | null
  ranteberakningsdatum: string | null
  transaktionstext: string
  belopp_skatteverket: number
  belopp_kronofogden: number | null
  status: 'booked' | 'upcoming'
  journal_entry_id: string | null
  source: 'api' | 'file_import'
  file_import_id: string | null
  imported_at: string
  updated_at: string
}

/** Row shape for the `skattekonto_file_imports` tracking table (DB → app). */
export interface SkattekontoFileImportRecord {
  id: string
  company_id: string
  /** Importing user; null after that user's account is deleted. */
  user_id: string | null
  filename: string
  file_hash: string
  file_variant: 'csv' | 'skv'
  row_count: number
  imported_count: number
  duplicate_count: number
  promoted_count: number
  date_from: string | null
  date_to: string | null
  closing_saldo: number | null
  status: 'pending' | 'processing' | 'completed' | 'failed'
  error_message: string | null
  created_at: string
  updated_at: string
}

/**
 * Single best candidate verifikat for an unmatched SKV row. Attached by
 * the `/skattekonto/transaktioner` endpoint when exactly one strong match
 * exists, so the UI can offer a one-click "koppla till A12" hint instead
 * of forcing the user to open the full Matcha-dialog.
 */
export interface SkattekontoMatchSuggestion {
  journal_entry_id: string
  voucher_number: number | null
  voucher_series: string | null
  entry_date: string
  description: string
  status: 'draft' | 'posted' | 'reversed'
}

/**
 * The deterministic counter-account a "Bokför" on this row would use,
 * resolved from `skattekonto_rules` server-side. Lets the list show what a
 * booking will do ("Bokförs mot 8314 Skattefria ränteintäkter") and drives
 * bulk-booking eligibility. `account_name` comes from the BAS reference and
 * may be null for custom accounts; `label` is the matched rule's label.
 */
export interface SkattekontoBookingSuggestion {
  account: string
  account_name?: string | null
  label?: string | null
}

/**
 * API response variant: stored row plus optional auto-match suggestion.
 * `match_suggestion` is optional because kommande/upcoming rows skip the
 * enrichment step entirely (no journal entry can match a future event).
 * `booking_suggestion` is likewise only computed for unbooked genomförda
 * rows: undefined means "not computed", null means "no rule matched".
 */
export interface SkattekontoTransactionWithSuggestion extends StoredSkattekontoTransaction {
  match_suggestion?: SkattekontoMatchSuggestion | null
  booking_suggestion?: SkattekontoBookingSuggestion | null
}

/**
 * Per-row outcome from POST /skattekonto/transaktioner/bokfor-batch.
 * `journal_entry_id` is present on success AND on COMMIT_FAILED (the draft
 * was created and stays linked; only the commit step failed).
 */
export interface SkattekontoBatchRowResult {
  id: string
  ok: boolean
  journal_entry_id?: string
  voucher_number?: number | null
  voucher_series?: string | null
  error_code?:
    | 'NO_COUNTER_ACCOUNT'
    | 'NO_FISCAL_PERIOD'
    | 'PERIOD_LOCKED'
    | 'ALREADY_BOOKED'
    | 'NOT_SETTLED'
    | 'TRANSACTION_NOT_FOUND'
    | 'COMMIT_FAILED'
    | 'UNKNOWN'
  error_message?: string
}

/** Response envelope body for the bokfor-batch endpoint. */
export interface SkattekontoBatchResult {
  results: SkattekontoBatchRowResult[]
  summary: { total: number; succeeded: number; failed: number }
}