Errors

Every error returned by the Accounted REST API uses a stable code from this catalogue. Codes never change once shipped: agents can pattern-match on them safely. The docs_url field on every error envelope points at the catalogue entry for that specific code.

Envelope shape

{
  "error": {
    "code": "PERIOD_LOCKED",
    "message": "Den valda perioden är låst.",
    "message_en": "The selected period is locked.",
    "details": { "fiscal_period_id": "..." },
    "recovery_hint": "Unlock via /fiscal-periods/{id}/unlock or pick an open period.",
    "docs_url": "https://app.gnubok.se/docs/api/errors/PERIOD_LOCKED",
    "request_id": "req_..."
  }
}

The message field is Swedish (matches the dashboard); message_en is English (for agent and developer logs). recovery_hint (when present) is a one-line description of the canonical fix. request_id echoes the request for support and log correlation — note it lives inside error on failures (there is no top-level meta block on an error response, unlike the success envelope). docs_url is built from the code (…/docs/api/errors/<CODE>).

Generic

Cross-cutting codes returned by any endpoint.

COMPANY_CONTEXT_MISSING

HTTP 400: Bad request

No active company context resolved for the request.

Swedish: Ingen aktiv företagskontext. Välj ett företag och försök igen.

CONFLICT

HTTP 409: Conflict

Conflict.

Swedish: En konflikt uppstod. Ladda om sidan och försök igen.

FORBIDDEN

HTTP 403: Forbidden

Insufficient permissions.

Swedish: Du har inte behörighet att utföra denna åtgärd.

IDEMPOTENCY_KEY_REUSE

HTTP 409: Conflict

Idempotency key was previously used with a different request body.

Swedish: Idempotensnyckeln har redan använts med en annan begäran.

Remediation: Use a fresh UUID for a new operation, or send the original request body to replay.

INSUFFICIENT_SCOPE

HTTP 403: Forbidden

The current API key does not have the required scope.

Swedish: API-nyckeln saknar behörighet för denna åtgärd.

Remediation: Mint a new key with the missing scope or grant it through the API key settings. Related resource: Accounted://capabilities

INTERNAL_ERROR

HTTP 500: Server error

Internal server error.

Swedish: Ett oväntat serverfel uppstod. Försök igen senare.

MFA_REQUIRED

HTTP 403: Forbidden

MFA verification required.

Swedish: Tvåstegsverifiering krävs för att utföra åtgärden.

NOT_FOUND

HTTP 404: Not found

Resource not found.

Swedish: Resursen kunde inte hittas.

NOT_IMPLEMENTED

HTTP 501: Not implemented

This feature is accepted by the schema but not yet implemented.

Swedish: Funktionen är inte implementerad ännu.

RATE_LIMITED

HTTP 429: Rate limited

Rate limit exceeded.

Swedish: För många förfrågningar. Vänta en stund och försök igen.

UNAUTHORIZED

HTTP 401: Unauthorized

Authentication required.

Swedish: Din session har gått ut. Logga in igen.

UNKNOWN_ERROR

HTTP 500: Server error

An unexpected error occurred.

Swedish: Något gick fel. Försök igen.

VALIDATION_ERROR

HTTP 400: Bad request

Validation error.

Swedish: Förfrågan innehåller ogiltiga uppgifter.

Bookkeeping engine

Errors from the journal-entry lifecycle (create, commit, reverse, correct).

BOOKKEEPING_DATABASE_ERROR

HTTP 500: Server error

Bookkeeping database operation failed.

Swedish: Verifikationen kunde inte sparas. Försök igen.

JOURNAL_ENTRY_NOT_BALANCED

HTTP 400: Bad request

Debits and credits do not match.

Swedish: Verifikationen balanserar inte.

Remediation: Recalculate the lines so totals are equal before retrying.

JOURNAL_ENTRY_NOT_FOUND

HTTP 404: Not found

Journal entry not found.

Swedish: Verifikationen kunde inte hittas.

Periods + year-end

Fiscal period locking, year-end closing, opening balances, FX revaluation.

FX_FAILED

HTTP 400: Bad request

Currency revaluation failed.

Swedish: Valutaomvärderingen misslyckades.

FX_PERIOD_CLOSED

HTTP 400: Bad request

Period is already closed; currency revaluation cannot be run.

Swedish: Perioden är redan stängd. Valutaomvärdering kan inte köras.

FX_PERIOD_NOT_FOUND

HTTP 404: Not found

Fiscal period not found.

Swedish: Räkenskapsperioden kunde inte hittas.

PERIOD_CREATE_BLOCKED_BY_OPEN_PERIODS

HTTP 409: Conflict

Cannot create a new fiscal year while a prior period is still open; lock it first.

Swedish: Du måste låsa föregående räkenskapsår innan du kan skapa ett nytt.

PERIOD_HAS_UNBOOKED_TRANSACTIONS

HTTP 400: Bad request

The period contains uncategorized business transactions.

Swedish: Perioden innehåller okategoriserade affärstransaktioner. Bokför eller markera dem som privata innan låsning.

Remediation: Categorize or mark uncategorized transactions before locking. Related tool: gnubok_list_uncategorized_transactions

PERIOD_LOCKED

HTTP 400: Bad request

HTTP 404: Not found

Customer not found.

Swedish: Kunden kunde inte hittas.

INVOICE_DELETE_NOT_DRAFT

HTTP 400: Bad request

Only draft invoices can be deleted; non-drafts must be credited.

Swedish: Endast utkast kan tas bort. Bokförda fakturor måste krediteras istället.

Remediation: Issue a credit note instead of deleting a posted invoice.

INVOICE_FINALIZE_INCOMPLETE

HTTP 500: Server error

The invoice number was assigned but the invoice could not be re-read. Reload the page and verify the invoice.

Swedish: Fakturanumret tilldelades men fakturan kunde inte läsas tillbaka. Ladda om sidan och kontrollera fakturan.

INVOICE_FINALIZE_NOT_DRAFT

HTTP 409: Conflict

Only unnumbered drafts can be finalized; this invoice already has a number or is not a draft.

Swedish: Endast onumrerade utkast kan skapas. Fakturan har redan ett nummer eller är inte ett utkast.

INVOICE_NOT_FOUND

HTTP 404: Not found

Invoice not found.

Swedish: Fakturan kunde inte hittas.

INVOICE_PAID_BOOK_FAILED

HTTP 500: Server error

Failed to create payment journal entry.

Swedish: Kunde inte bokföra betalningen.

INVOICE_PAID_LIKELY_DUPLICATE

HTTP 409: Conflict

A likely-matching unlinked inbound bank transaction was found for this customer. Suggest linking it instead of creating a new payment entry.

Swedish: Det finns redan en obokförd inkommande banktransaktion som kan vara denna betalning. Länka den istället, eller markera som betald ändå om du är säker.

Remediation: Match the candidate transaction via POST /api/transactions/{id}/match-invoice, or resend mark-paid with force: true to create the payment entry anyway. When using the v1 endpoint, the force retry requires a fresh Idempotency-Key (the original key is bound to the body hash).

INVOICE_SEND_EMAIL_NOT_CONFIGURED

HTTP 503

Email service is not configured.

Swedish: E-posttjänsten är inte konfigurerad. Kontrollera att RESEND_API_KEY och RESEND_FROM_EMAIL är satta.

Remediation: Set RESEND_API_KEY and RESEND_FROM_EMAIL in the deployment environment.

INVOICE_SEND_NO_CUSTOMER_EMAIL

HTTP 400: Bad request

Customer has no email address.

Swedish: Kunden saknar e-postadress. Uppdatera kunduppgifterna först.

Remediation: Add an email address on the customer record before sending.

INVOICE_SEND_NUMBER_ASSIGN_FAILED

HTTP 500: Server error

Failed to assign invoice number on send.

Swedish: Kunde inte tilldela fakturanummer.

INVOICE_SEND_PARTIAL

HTTP 200

Invoice was sent but a follow-up step (journal entry or PDF) failed.

Swedish: Fakturan skickades men en efterföljande åtgärd misslyckades (verifikation eller PDF-bilaga).

INVOICE_SEND_PDF_RENDER_FAILED

HTTP 500: Server error

Failed to render invoice PDF before send; no invoice number was consumed.

Swedish: Fakturans PDF kunde inte skapas. Kontrollera fakturarader och kunduppgifter och försök igen.

INVOICE_SEND_PROVIDER_FAILED

HTTP 502

The email provider could not deliver the message.

Swedish: E-postleverantören kunde inte skicka meddelandet.

INVOICE_UPDATE_NOT_DRAFT

HTTP 409: Conflict

Only draft invoices can be updated. Issued invoices are immutable: issue a credit note instead.

Swedish: Endast utkast kan ändras. Bokförda fakturor är oföränderliga: utfärda en kreditfaktura istället.

Remediation: Issue a credit note via POST /invoices/{id}:credit and create a fresh invoice with the corrected details.

Supplier invoices

AP lifecycle: register, approve, mark paid, credit.

SUPPLIER_CREATE_FAILED

HTTP 500: Server error

Failed to create supplier.

Swedish: Leverantören kunde inte skapas.

SUPPLIER_DELETE_FAILED

HTTP 500: Server error

Failed to delete supplier.

Swedish: Leverantören kunde inte tas bort.

SUPPLIER_DUPLICATE_ORG_NUMBER

HTTP 409: Conflict

A supplier with that organisation number already exists.

Swedish: En leverantör med samma organisationsnummer finns redan.

SUPPLIER_HAS_INVOICES

HTTP 409: Conflict

Supplier cannot be archived while open supplier invoices reference it.

Swedish: Leverantören kan inte arkiveras eftersom det finns öppna leverantörsfakturor som refererar till den.

Remediation: Close (credit / mark paid) every open supplier invoice before archiving the supplier. The dashboard exposes the same blocker.

SUPPLIER_NOT_FOUND

HTTP 404: Not found

Supplier not found.

Swedish: Leverantören kunde inte hittas.

SUPPLIER_UPDATE_FAILED

HTTP 500: Server error

Failed to update supplier.

HTTP 409: Conflict

The transaction already has a journal entry.

Swedish: Transaktionen är redan bokförd. Ångra kategoriseringen om du vill ändra den.

Remediation: Use gnubok_uncategorize_transaction first if you need to recategorize. Related tool: gnubok_uncategorize_transaction

TRANSACTION_BOOK_FORCE_CANDIDATE_MISMATCH

HTTP 409: Conflict

The duplicate candidate echoed in expected_duplicate_transaction_id / expected_duplicate_journal_entry_id no longer matches the one detected at request time. Re-run the booking pre-flight to obtain the current candidate, then retry.

Swedish: Den möjliga dubbletten som visades matchar inte längre. Ladda om och försök igen så att rätt kandidat visas.

TRANSACTION_BOOK_POSSIBLE_DUPLICATE

HTTP 409: Conflict

This business event already appears to be booked: either another transaction with the same date and amount, or a voucher that already books the same amount on the bank account (e.g. a paid invoice or a salary run). Do not book the same business event twice. Review the existing voucher and link this transaction to it, or pass force=true to book it anyway if they are genuinely unrelated.

Swedish: Den här affärshändelsen ser redan ut att vara bokförd: antingen en annan transaktion på samma datum och belopp, eller en verifikation som redan bokar samma belopp på bankkontot (t.ex. en betald faktura eller en lönekörning). Bokför inte samma affärshändelse två gånger. Granska den befintliga verifikationen och länka transaktionen till den, eller bokför ändå om de inte hör ihop.

TRANSACTION_TITLE_LOCKED

HTTP 409: Conflict

Cannot edit the title of a booked or matched transaction. Posted vouchers are corrected with storno.

Swedish: Importen avbröts oväntat. Ingen data har sparats.

SIE_IMPORT_UNMAPPED_ACCOUNTS

HTTP 400: Bad request

One or more accounts have no mapping target.

Swedish: Vissa konton saknar mappning. Gå tillbaka till kontomappningssteget och koppla alla konton.

HTTP 400: Bad request

Tax table is missing for the period.

Swedish: Skattetabellen saknas för perioden. Importera skattetabellen först.

Company + API keys

Multi-tenant + auth lifecycle.

API_KEY_CREATE_FAILED

HTTP 500: Server error

Failed to create API key.

Swedish: API-nyckeln kunde inte skapas.

API_KEY_NOT_FOUND

HTTP 404: Not found

API key not found.

Swedish: API-nyckeln kunde inte hittas.

API_KEY_QUOTA_EXCEEDED

HTTP 429: Rate limited

API key quota exceeded.

Swedish: Du har nått maxgränsen för antal API-nycklar.

API_KEY_REVOKE_FAILED

HTTP 500: Server error

Failed to revoke API key.

Swedish: API-nyckeln kunde inte återkallas.

API_KEY_SCOPE_INVALID

HTTP 400: Bad request

One or more requested scopes are invalid.

Swedish: En eller flera scopes är ogiltiga.

API_KEY_SOD_CONFLICT

HTTP 409: Conflict

This key combines a staging write scope with pending_operations:approve, letting an automated agent both stage and approve postings with no human in the loop (segregation of duties, ISO 27001 A.5.3 / BFNAR 2013:2).

Swedish: Nyckeln kombinerar ett skriv-scope som stagar bokföring med pending_operations:approve. Då kan en automatiserad agent både skapa och godkänna verifikationer utan mänsklig granskning (ansvarsfördelning, ISO 27001 A.5.3 / BFNAR 2013:2). Bekräfta att du förstår risken för att skapa nyckeln ändå.

Remediation: Inform the user of the segregation-of-duties risk, then re-POST the same scopes with acknowledge_sod: true to create the key anyway.

COMPANY_CREATE_BAS_SEED_FAILED

HTTP 500: Server error

Failed to seed the chart of accounts.

Swedish: Kontoplanen kunde inte skapas. Försök igen.

COMPANY_CREATE_DUPLICATE_ORG_NUMBER

HTTP 409: Conflict

A company with that organisation number already exists.

Swedish: Ett företag med samma organisationsnummer finns redan.

COMPANY_CREATE_FAILED

HTTP 500: Server error

Failed to create company.

Swedish: Företaget kunde inte skapas.

COMPANY_NOT_FOUND

HTTP 404: Not found

Company not found.

ACCOUNTS_NOT_IN_CHART

HTTP 400: Bad request

HTTP 400: Bad request

One or more dimension codes on the entry lines are missing from the dimension registry or archived. details.issues lists each offending sie_dim_no/code.

Swedish: Ett angivet kostnadsställe/projekt finns inte i dimensionsregistret eller är arkiverat. Skapa värdet i registret först.

Remediation: Create the missing dimension value in the register (or re-activate the archived value), then retry. Only companies with dimensions enabled are validated; each issue in details.issues carries sie_dim_no, code and reason (unknown_dimension | unknown_value | archived_value).

DIMENSION_VALUE_CREATE_FAILED

HTTP 500: Server error

Failed to create dimension value.

Swedish: Dimensionsvärdet kunde inte skapas.

DIMENSION_VALUE_DATES_NOT_ALLOWED

HTTP 400: Bad request

Start/end dates can only be set on accumulating dimensions (e.g. projects): this dimension resets annually.

Swedish: Datum kan bara sättas på ackumulerande dimensioner (t.ex. projekt).

DIMENSION_VALUE_DELETE_FAILED

HTTP 500: Server error

Failed to delete dimension value.

Swedish: Dimensionsvärdet kunde inte tas bort.

DIMENSION_VALUE_DUPLICATE_CODE

HTTP 409: Conflict

A value with that code already exists in the dimension.

Swedish: Ett värde med samma kod finns redan i dimensionen.

DIMENSION_VALUE_NOT_FOUND

HTTP 404: Not found

Dimension value not found.

Swedish: Dimensionsvärdet kunde inte hittas.

DIMENSION_VALUE_REFERENCED

Remediation: Use a date inside an open period or create one that covers it. Related resource: Accounted://period/active

EXTENSION_DISABLED

HTTP 503

The Skatteverket integration is not enabled in this environment.

Swedish: Skatteverket-integrationen är inte aktiverad i denna miljö.

FISCAL_PERIOD_NOT_FOUND

LINK_SI_VOUCHER_NO_AP_DEBIT

LINK_VOUCHER_NOT_POSTED

HTTP 409: Conflict

Journal entry is not posted. Only posted entries can be linked as a payment.

Swedish: Verifikationen är inte bokförd. Endast bokförda verifikationer kan länkas som betalning.

LINK_VOUCHER_NO_AR_CREDIT

HTTP 400: Bad request

The journal entry does not credit an accounts-receivable account (151x). Correct the booking first via a storno+correction (gnubok_correct_entry) that credits 1510.

Swedish: Verifikationen krediterar inte ett kundfordringskonto (151x). Bokföringen behöver först rättas med en stornoverifikation som krediterar 1510, t.ex. via gnubok_correct_entry.

Remediation: Use gnubok_correct_entry to storno the existing voucher and re-book the receipt as Dr 1930 / Cr 1510, then link the corrected voucher. Related tool: gnubok_correct_entry

LINK_VOUCHER_VOUCHER_NOT_FOUND

HTTP 404: Not found

Journal entry not found.

Swedish: Verifikationen kunde inte hittas.

MEANINGLESS_CORRECTION

HTTP 400: Bad request

The correction represents no economic event: nothing to correct.

Swedish: Rättelsen motsvarar ingen ekonomisk händelse: det finns inget att rätta.

NO_OPEN_PERIOD_FOR_DATE

HTTP 400: Bad request

No fiscal period covers the selected date.

Swedish: Det finns ingen räkenskapsperiod som täcker det valda datumet. Skapa eller öppna räkenskapsåret först.

Remediation: Create or open the fiscal year that covers the date before retrying. Related resource: Accounted://period/active

OB_ACCOUNT_ACTIVATION_FAILED

HTTP 500: Server error

Failed to activate accounts in the chart of accounts.

Swedish: Kunde inte aktivera konton i kontoplanen.

OB_COMPANY_LOCK_DATE

HTTP 500: Server error

Failed to record supplier invoice payment.

Swedish: Kunde inte registrera betalningen.

SI_PAID_LIKELY_DUPLICATE

HTTP 409: Conflict

A likely-matching unlinked bank transaction was found for this supplier. Suggest linking it instead of creating a new payment entry.

Swedish: Det finns redan en obokförd banktransaktion som kan vara denna betalning. Länka den istället, eller markera som betald ändå om du är säker.

Remediation: Match the candidate transaction via POST /api/transactions/{id}/match-supplier-invoice, or resend mark-paid with force: true to create the payment entry anyway.

SI_PAID_NOT_PAYABLE

HTTP 400: Bad request

Supplier invoice is not in a payable state.

Swedish: Leverantörsfakturan kan inte markeras som betald i nuvarande status.

SI_PAID_PERIOD_LOCKED

HTTP 400: Bad request

Bookkeeping is locked; payment cannot be recorded.

Swedish: Bokföringen är låst. Betalningen kan inte registreras.

SKATTEVERKET_ACCESS_DENIED

HTTP 403: Forbidden

Skatteverket denied access for this company (missing authorisation or scope).

Swedish: Behörighet saknas hos Skatteverket för det här företaget. Kontrollera att du är firmatecknare eller deklarationsombud.

Remediation: Verify the signed-in user is firmatecknare/deklarationsombud for this company at Skatteverket, then reconnect with BankID.

SKATTEVERKET_NOT_CONNECTED

HTTP 401: Unauthorized

No valid Skatteverket connection. Reconnect with BankID before retrying.

Swedish: Anslutningen till Skatteverket saknas eller har gått ut. Anslut med BankID under Inställningar → Skatteverket.

Remediation: Connect (or reconnect) to Skatteverket with BankID under Settings → Skatteverket, then retry.

SKATTEVERKET_RATE_LIMITED

HTTP 429: Rate limited

Skatteverket rate limit exceeded.

Swedish: För många förfrågningar mot Skatteverket. Vänta en stund och försök igen.

TARGET_PERIOD_CLOSED

HTTP 409: Conflict

The fiscal year covering the date is closed and cannot be reopened.

Swedish: Räkenskapsåret som täcker datumet är stängt (bokslut) och kan inte öppnas. Bokför i en öppen period i stället.

TARGET_PERIOD_LOCKED

HTTP 409: Conflict

The fiscal period covering the date is locked.

Swedish: Räkenskapsperioden som täcker datumet är låst.

Remediation: Unlock the period (if status is "locked", not "closed") or use a date inside an open period. Related tool: gnubok_unlock_period

TEST_KEY_WRITE_BLOCKED

HTTP 403: Forbidden

This endpoint cannot be simulated, so it is not available with a test key. Test keys force dry-run on every write; use a live key for endpoints that do not support dry-run.

Swedish: Den här åtgärden kan inte simuleras och är därför inte tillgänglig med en testnyckel. Använd en live-nyckel.

Remediation: Use a live key for this endpoint, or pick an endpoint that supports dry-run.