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.

BOOKKEEPING_LOCK_REOPENS_FILED_VAT

HTTP 409: Conflict

The lock date would reopen VAT periods already filed with Skatteverket. Send acknowledge_filed_vat_periods: true if a correction must be booked there (then file a corrected return).

Swedish: Låsdatumet skulle öppna momsperioder som redan är deklarerade till Skatteverket.

JOURNAL_ENTRY_NOTE_FAILED

HTTP 400: Bad request

The note could not be saved.

Swedish: Anteckningen kunde inte sparas.

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.

HTTP 500: Server error

The inline rättelse failed unexpectedly. Nothing was changed.

Swedish: Kunde inte rätta verifikationen. Försök igen.

JOURNAL_RATTELSE_LOG_FAILED

HTTP 500: Server error

Could not read the rättelse log.

Swedish: Kunde inte hämta rättelsehistorik.

JOURNAL_RATTELSE_PERIOD_LOCKED

HTTP 409: Conflict

Inline rättelse is only allowed in an open, unlocked period after the company lock date. Past a lock or close, storno is the only lawful correction (BFL 5 kap 5 §).

Swedish: Perioden är stängd eller låst: använd rättelseverifikat (storno).

Remediation: Correct the verifikat with storno (gnubok_correct_entry, POST /journal-entries/{id}/correct). Unlock the period only if the user explicitly asks for it. Related tool: gnubok_correct_entry

JOURNAL_RATTELSE_REFUSED

HTTP 409: Conflict

The inline rättelse was refused by a bookkeeping rule (the Swedish message names it). Correct the verifikat with storno instead: POST /journal-entries/{id}/correct.

Swedish: Rättelsen kan inte göras i samma verifikat. Använd rättelseverifikat (storno) i stället.

Remediation: Read the message. If the rule cannot be met inside the verifikat (linked underlag, foreign currency, bank-anchored amount, structural entry type), use the storno correction (gnubok_correct_entry) instead. Related tool: gnubok_correct_entry

Periods + year-end

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

FX_CLOSING_RATE_UNAVAILABLE

HTTP 502

No Riksbanken observation is available for the closing date. The revaluation was refused rather than posted from an estimated rate; details.missingRates lists each currency and date.

Swedish: Ingen valutakurs från Riksbanken finns för balansdagen. Valutaomvärderingen har inte bokförts: en uppskattad kurs får inte bokföras mot 3960/7960 (ÅRL 4 kap. 13 §). Försök igen när kursen är publicerad.

Remediation: Retry once Riksbanken has published the closing-date rate, or run the revaluation for a closing date that has a published observation.

PERIOD_ALREADY_CLOSED

HTTP 409: Conflict

Period is already closed: year-end has been run and the period is sealed.

Swedish: Perioden är redan stängd: bokslutet är genomfört och perioden kan inte öppnas igen.

Remediation: Nothing more to do on this period. gnubok_run_year_end locks, closes and seeds the next period's opening balances in one step, so gnubok_close_period, gnubok_lock_period and gnubok_set_opening_balances are not follow-up calls. Confirm the state with gnubok_list_fiscal_periods and continue in the next period. Related tool: gnubok_list_fiscal_periods

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

Period is locked or closed; entries cannot be added.

Swedish: Bokföringen är låst för denna period.

Remediation: Either unlock the period via gnubok_unlock_period (if status is "locked", not "closed") or change the entry date to fall inside an open period. A bank transaction that is not a business event (duplicate, never executed) needs no verifikat: ignore it instead (POST /transactions/{id}/ignore, gnubok_ignore_transaction). Related tool: gnubok_unlock_period

PERIOD_LOCK_ALREADY_LOCKED

HTTP 409: Conflict

Period is already locked.

Swedish: Perioden är redan låst.

Remediation: A lock only freezes the period. If the intent is bokslut, do not lock first: gnubok_run_year_end posts the closing entry into the period and then locks and closes it itself, so it needs an unlocked period (gnubok_unlock_period reopens a locked, not closed, one). If the period should simply stay frozen, nothing more is needed. Related tool: gnubok_unlock_period

PERIOD_LOCK_FAILED

HTTP 400: Bad request

Failed to lock period.

Swedish: Perioden kunde inte låsas.

PERIOD_LOCK_HAS_DRAFTS

HTTP 400: Bad request

Period contains draft journal entries.

Swedish: Perioden innehåller verifikationsutkast som måste bokföras eller raderas innan låsning.

PERIOD_NOT_FOUND

HTTP 404: Not found

Fiscal period not found.

Swedish: Räkenskapsperioden kunde inte hittas.

PERIOD_NOT_LOCKED

HTTP 400: Bad request

HTTP 400: Bad request

Trial balance does not balance.

HTTP 400: Bad request

Bookkeeping is locked for today's date; the credit note cannot be created.

Swedish: Bokföringen är låst för dagens datum. Kreditfakturan kan inte skapas.

Remediation: The credit note is dated today (Europe/Stockholm) and that date falls in a closed or locked period, or on/before the company lock date (details.reason). Unlock the period in the dashboard or wait for the next open period; the API cannot backdate or forward-date a credit note.

INVOICE_CREDIT_REPAIR_REQUIRED

HTTP 500: Server error

The credit-note voucher was created, but issuance must be completed. Retry or contact support.

Swedish: Kreditfakturans verifikat skapades, men utfärdandet måste slutföras. Försök igen eller kontakta support.

INVOICE_CREDIT_ROT_RUT_RECLAIMED

HTTP 400: Bad request

The invoice carries a refused ROT/RUT deduction booked as a customer receivable. Reverse that voucher before crediting the invoice, otherwise the credit note splits 1510 and 1513 wrongly.

Swedish: Fakturan har ett nekat ROT/RUT-avdrag bokfört som kundfordran. Makulera den bokningen (verifikationen med nekat avdrag) innan fakturan krediteras, annars stämmer inte kreditfakturans fördelning mellan konto 1510 och 1513.

INVOICE_CUSTOMER_NOT_FOUND

HTTP 404: Not found

Customer not found.

Swedish: Kunden kunde inte hittas.

INVOICE_DELETE_FAILED

HTTP 500: Server error

The invoice could not be deleted or cancelled.

Swedish: Fakturan kunde inte tas bort eller makuleras.

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_FX_RATE_MISSING

HTTP 400: Bad request

The invoice is in a foreign currency but has no exchange rate on file. Set the invoice exchange rate before booking; without it the amounts cannot be translated to SEK and the output VAT would be understated.

Swedish: Fakturan är i utländsk valuta men saknar växelkurs. Ange fakturans växelkurs innan den bokförs: utan kurs kan beloppen inte räknas om till kronor och momsen blir fel.

Remediation: Set exchange_rate on the invoice (the rate at the taxable-event date) and retry. On an unbooked invoice, POST /api/invoices/{id}/refresh-exchange-rate fetches it from Riksbanken.

INVOICE_FX_REFRESH_BOOKED

HTTP 409: Conflict

The invoice already has a verifikat, so its SEK conversion cannot be re-rated here. The SEK amounts are posted entries and may only be changed through one of the two sanctioned rättelse tracks (BFL 5 kap 5 §): storno + correcting entry, or the inline rättelse RPCs on an open unlocked period.

Swedish: Fakturan är redan bokförd, så växelkursen kan inte räknas om här. Beloppen i kronor sitter i verifikatet och får bara ändras genom rättelse: makulera med storno och bokför om, eller rätta verifikatet inifrån (BFL 5 kap. 5 §).

Remediation: Reverse the invoice verifikat (gnubok_reverse_journal_entry) and rebook it with the correct rate, or correct it inline via gnubok_correct_entry while the period is still open and unlocked. Never update invoice.exchange_rate behind a posted entry. Related tool: gnubok_reverse_journal_entry

INVOICE_FX_REFRESH_PERIOD_LOCKED

HTTP 409: Conflict

The fiscal period covering the invoice date is locked or closed, so the exchange rate cannot be updated. details.period_status carries the verdict; lookup_failed: true means the lock state could not be read and the request was refused fail-closed.

Swedish: Räkenskapsperioden för fakturadatumet är låst eller stängd, så växelkursen kan inte uppdateras. Öppna perioden eller rätta med storno i en öppen period.

Remediation: Unlock the period via gnubok_unlock_period (only if the status is "locked", not "closed"), then retry. Past a close, the correction belongs in an open period as a storno. Related tool: gnubok_unlock_period

INVOICE_FX_REFRESH_RATE_UNAVAILABLE

INVOICE_PAID_LIKELY_DUPLICATE

HTTP 409: Conflict

HTTP 400: Bad request

The bank account cannot be the payee on this invoice: it does not belong to the company, is not shown on customer invoices, or lacks details for the invoice currency.

Swedish: Bankkontot kan inte användas som betalningsmottagare på fakturan: det tillhör inte företaget, visas inte på kundfakturor eller saknar uppgifter för fakturans valuta.

Remediation: Välj ett av företagets bankkonton som är markerat "Visas på fakturor" och har betaluppgifter för fakturans valuta.

INVOICE_PAYEE_SNAPSHOT_FAILED

HTTP 500: Server error

The payment details could not be saved on the invoice. The invoice was not sent; try again.

Swedish: Betaluppgifterna kunde inte sparas på fakturan. Fakturan skickades inte; försök igen.

INVOICE_PAYMENT_CONFIRMATION_NOT_PAID

HTTP 409: Conflict

HTTP 400: Bad request

A quote cannot be paid. Convert it to an invoice first.

Swedish: En offert kan inte betalas. Skapa en faktura från offerten först.

Remediation: Convert the accepted quote with POST /api/invoices/{id}/convert, then register the payment on the invoice.

INVOICE_RECURRING_UPDATE_PARTIAL

HTTP 500: Server error

The recurring schedule update failed and the compensating rollback did not fully apply: the schedule may be left in a partial state (header fields and items out of sync). Inspect the schedule fields and items before retrying.

Swedish: Ändringen av det återkommande schemat kunde inte slutföras och schemat kan ha hamnat i ett halvsparat läge. Öppna schemat och kontrollera både fält och rader innan du sparar igen.

INVOICE_SEND_CANCELLED

HTTP 400: Bad request

Cancelled invoices cannot be sent; create a new invoice instead.

Swedish: Makulerade fakturor kan inte skickas. Skapa en ny faktura istället.

INVOICE_SEND_COMPANY_SETTINGS_MISSING

HTTP 404: Not found

Company settings are missing.

Swedish: Företagsinställningar saknas.

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 (eller SMTP_HOST och SMTP_FROM_EMAIL med EMAIL_PROVIDER=smtp).

Remediation: Set RESEND_API_KEY and RESEND_FROM_EMAIL (or SMTP_HOST and SMTP_FROM_EMAIL with EMAIL_PROVIDER=smtp) 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_PAYMENT_ACCOUNT_INVALID

HTTP 400: Bad request

The bank account this invoice is to be paid to can no longer be used: it is disabled, no longer shown on customer invoices, or lacks details for the invoice currency. Pick another account on the invoice or update the account under Inställningar → Fakturering (Settings → Invoicing).

Swedish: Bankkontot som fakturan ska betalas till kan inte längre användas: det är avstängt, borttaget från kundfakturor eller saknar uppgifter för fakturans valuta. Välj ett annat konto på fakturan eller uppdatera kontot under Inställningar → Fakturering.

Remediation: Välj ett annat bankkonto på fakturan, eller återaktivera kontot och fyll i dess betaluppgifter under Inställningar → Fakturering.

INVOICE_SEND_PAYMENT_ACCOUNT_MISSING

HTTP 400: Bad request

The invoice has no payment details for its currency: bankgiro, plusgiro, Swish or a bank account for SEK, an IBAN for other currencies. Add them under Inställningar → Fakturering (Settings → Invoicing) before generating the PDF or sending the invoice.

Swedish: Fakturan saknar betalningsuppgifter för sin valuta: bankgiro, plusgiro, Swish eller bankkonto för SEK, IBAN för andra valutor. Lägg till dem under Inställningar → Fakturering innan du skapar PDF-filen eller skickar fakturan.

Remediation: Lägg till betalningsuppgifter för fakturans valuta under Inställningar → Fakturering: bankgiro, plusgiro, Swish eller bankkonto för SEK, IBAN för andra valutor.

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_SEND_SNAPSHOT_FAILED

HTTP 500: Server error

The delivery snapshot could not be saved. No email was sent.

Swedish: Utskicksinformationen kunde inte sparas. Ingen e-post skickades.

INVOICE_SEND_TOO_MANY_RECIPIENTS

HTTP 400: Bad request

An invoice email may have at most 20 recipients in total.

Swedish: Ett fakturautskick får ha högst 20 mottagare totalt.

Remediation: Remove CC or BCC recipients before sending the invoice.

INVOICE_SEND_VAT_NUMBER_MISSING

HTTP 400: Bad request

The company is VAT-registered but has no VAT number, which is a mandatory invoice element (ML 17 kap. 24 §). Add it under Inställningar → Skatt (Settings → Tax) before issuing the invoice.

Swedish: Företaget är momsregistrerat men saknar momsregistreringsnummer, som måste anges på fakturan (ML 17 kap. 24 §). Lägg till det under Inställningar → Skatt innan du skickar fakturan.

Remediation: Lägg till företagets momsregistreringsnummer under Inställningar → Skatt.

INVOICE_UPDATE_DOCUMENT_TYPE_LOCKED

HTTP 400: Bad request

The document type of a quote or delivery note cannot change: its number belongs to that series. Create a new document instead.

Swedish: Dokumenttypen kan inte ändras på en offert eller följesedel: numret hör till serien. Skapa ett nytt dokument i stället.

INVOICE_UPDATE_DROPS_ORDER_LINK

HTTP 409: Conflict

The invoice was created from a sales order and this edit would drop the link to its order lines. Keep sales_order_item_id on the lines, or cancel the invoice and create a new one from the order.

Swedish: Fakturan är skapad från en kundorder och ändringen skulle tappa kopplingen till orderraderna. Skicka med sales_order_item_id på raderna, eller makulera fakturan och skapa en ny från kundordern.

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

Invoice has already been fully paid or is no longer matchable.

Swedish: Fakturan har redan slutbetalats av en annan förfrågan.

MATCH_INVOICE_BOOKING_RATE_MISSING

Remediation: Link the bank row to the existing voucher instead of booking a second one: gnubok_link_transaction_to_journal_entry (pass invoice_id to settle the kundfaktura at the same time) or gnubok_reconcile_match. Only if the row is a genuinely separate payment, call again with force=true and expected_journal_entry_id set to the id the refusal named. Related tool: gnubok_link_transaction_to_journal_entry

MATCH_INVOICE_RECORD_PAYMENT_FAILED

HTTP 500: Server error

Failed to record invoice payment.

Swedish: Kunde inte registrera fakturabetalningen.

MATCH_INVOICE_TX_ALREADY_LINKED

HTTP 400: Bad request

Transaction is already linked to an invoice.

Swedish: Transaktionen är redan kopplad till en faktura.

MATCH_INVOICE_TX_FX_RATE_MISSING

TRANSACTION_ALREADY_CATEGORIZED

HTTP 409: Conflict

HTTP 403: Forbidden

Import history is retained. Open the import to review its status and available actions.

Swedish: Importhistoriken bevaras. Öppna importen för att granska dess status och tillgängliga åtgärder.

Remediation: Read the import status with the same import_id. Related tool: gnubok_sie_import_status Related resource: /import?mode=sie

SIE_IMPORT_LEGACY_REVIEW_REQUIRED

HTTP 409: Conflict

Import history is retained. This legacy SIE import needs an outcome review before it can be undone or replaced. Open import history and choose Review.

Swedish: Importhistoriken bevaras. Den här äldre SIE-importens utfall behöver granskas innan den kan ångras eller ersättas. Öppna importhistoriken och välj Granska.

Remediation: Read gnubok_sie_import_status with the same import_id for the assessment. In the app, open SIE import history and choose Review. No recovery mutation is available for this legacy import yet. Related tool: gnubok_sie_import_status Related resource: /import?mode=sie

SIE_IMPORT_UNEXPECTED

HTTP 500: Server error

The import outcome could not be confirmed. Check import history before retrying.

Swedish: Importens resultat kunde inte bekräftas. Kontrollera importhistoriken innan du försöker igen.

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.

Remediation: Map every source account to a BAS account before importing.

SIE_IMPORT_UNSUPPORTED_ACCOUNT_CLASS

HTTP 400: Bad request

Map accounts carrying amounts to accounts 1000-8999 before importing. Target classes 0 and 9 are not supported by the balance sheet and income statement. Unused account definitions may be retained.

Swedish: Konton med belopp måste mappas till konton 1000-8999 före import. Målkonton i klass 0 och 9 stöds inte i balans- och resultatrapporterna. Oanvända kontodefinitioner kan behållas.

Documents

Document upload, link, signed-URL download, retention.

DOCUMENT_UPLOAD_NOT_FOUND

HTTP 404: Not found

The uploaded file was not found or the upload has expired. Upload the file again.

HTTP 400: Bad request

Payslips can only be sent after the salary run is approved.

Swedish: Lönespecifikationer kan bara skickas efter godkännande.

SALARY_PAYSLIPS_SEND_SANDBOX

HTTP 403: Forbidden

Payslips cannot be sent from the sandbox. Create an account to send email.

Swedish: Lönebesked kan inte skickas från sandlådan. Skapa ett konto för att skicka e-post.

SALARY_REGISTER_DATES_LOCKED_BY_RUN

Swedish: Kunde inte återkalla godkännandet.

SALARY_RUN_UNAPPROVE_NOT_APPROVED

HTTP 400: Bad request

Only an approved salary run can be unlocked. A paid or booked run is corrected through the correction flow.

Swedish: Bara en godkänd lönekörning kan låsas upp. En betald eller bokförd körning korrigeras via korrigeringsflödet.

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.

Swedish: Företaget kunde inte hittas.

COMPANY_RESET_CONFIRMATION_MISMATCH

HTTP 400: Bad request

The company name does not match.

Swedish: Företagsnamnet stämmer inte överens.

COMPANY_RESET_CONFIRMATION_REQUIRED

HTTP 400: Bad request

All safety confirmations are required.

Swedish: Alla säkerhetsbekräftelser krävs.

COMPANY_RESET_FAILED

HTTP 500: Server error

The migration reset failed. No changes were saved.

Swedish: Migreringen kunde inte startas om. Inga ändringar har sparats.

COMPANY_RESET_FORBIDDEN

HTTP 403: Forbidden

Only the company owner can reset a migration.

Swedish: Endast företagets ägare kan starta om en migrering.

COMPANY_RESET_INELIGIBLE

HTTP 409: Conflict

The company is not eligible for a self-service reset. Contact support for an individual review.

Swedish: Företaget kan inte återställas med självservice. Kontakta supporten för en individuell bedömning.

COMPANY_RESET_NOT_FOUND

HTTP 404: Not found

Company not found.

Swedish: Företaget kunde inte hittas.

COMPANY_RESET_REASON_INVALID

HTTP 400: Bad request

Explain why the migration must be redone using 20 to 1,000 characters.

Swedish: Beskriv varför migreringen behöver göras om med 20 till 1 000 tecken.

Provider connections

External provider OAuth, sync, consent.

PROVIDER_ACCEPT_FAILED

HTTP 500: Server error

Failed to accept consent.

Swedish: Kunde inte slutföra anslutningen.

PROVIDER_API_MODULE_INACTIVE

HTTP 403: Forbidden

Visma refused access because the API module is not activated for the company ("No access to module: api_standard"). Activate the API in Visma/Spiris under Settings, Apps and extensions (on smaller plans the API is a paid add-on called Integration), and make sure no default company is selected in the top-right menu. Then try again. You can also import via SIE file in the meantime.

Swedish: Visma nekade åtkomst eftersom API-modulen inte är aktiverad för företaget ("No access to module: api_standard"). Aktivera API:et i Visma/Spiris under Inställningar, Appar och tillägg. På de mindre abonnemangen är API:et ett tillägg (Integration) som kostar extra. Kontrollera också att inget standardföretag är valt i menyn uppe till höger i Visma, det kan göra att inloggningen hamnar på ett företag utan giltig licens. Försök sedan igen. Du kan även importera via SIE-fil under tiden.

PROVIDER_AUTH_EXPIRED

HTTP 401: Unauthorized

Provider authentication expired or refresh failed.

Swedish: Anslutningen till leverantören har gått ut. Återanslut för att fortsätta.

PROVIDER_COMPANY_ID_REQUIRED

HTTP 400: Bad request

companyId is required for this provider.

Swedish: companyId krävs för den här leverantören.

PROVIDER_COMPANY_MISMATCH

HTTP 422: Unprocessable

These credentials belong to a different company than the one you are importing into. Check that you picked the right company at the provider and try again.

Swedish: Uppgifterna gäller ett annat företag än det du importerar till. Kontrollera att du valt rätt företag hos leverantören och försök igen.

PROVIDER_CONFIGURATION_ERROR

HTTP 503

The Fortnox connection needs attention from Accounted. Contact support. You do not need to reconnect.

Swedish: Fortnox-anslutningen behöver åtgärdas av Accounted. Kontakta supporten. Du behöver inte återansluta.

PROVIDER_CONNECT_FAILED

HTTP 500: Server error

Failed to start provider connection flow.

Swedish: Kunde inte starta anslutningen till leverantören.

PROVIDER_CONSENT_NOT_FOUND

HTTP 404: Not found

Provider consent not found.

Swedish: Anslutningen kunde inte hittas.

PROVIDER_CONSENT_NOT_READY

HTTP 400: Bad request

Provider consent is not ready; finish authentication first.

Swedish: Anslutningen är inte klar. Slutför inloggningen först.

PROVIDER_DISCONNECT_FAILED

HTTP 500: Server error

Provider disconnect failed.

Swedish: Frånkoppling från leverantören misslyckades.

PROVIDER_DOCUMENT_SCOPES_REQUIRED

HTTP 403: Forbidden

The Fortnox connection lacks Archive and Connect file access. Reconnect Fortnox and approve those permissions to import documents.

Swedish: Fortnox-anslutningen saknar behörighet till Arkiv och Koppla fil. Koppla om Fortnox och godkänn behörigheterna för att importera underlag.

PROVIDER_DOCUMENT_SCOPES_UNAVAILABLE

HTTP 403: Forbidden

Fortnox file import is not enabled yet: the Archive and Connect file permissions are missing for the Accounted integration at Fortnox. Reconnecting will not help; we enable this as soon as the permission is in place. Everything else in the migration was imported.

Swedish: Filimport från Fortnox är inte påslagen än: behörigheterna Arkiv och Koppla fil saknas för Accounted-integrationen hos Fortnox. Att koppla om hjälper inte, vi aktiverar det så snart behörigheten är på plats. Allt annat i migreringen är importerat.

PROVIDER_IMPORT_DOCUMENTS_FAILED

HTTP 500: Server error

Failed to import documents from provider.

Swedish: Kunde inte importera underlag från leverantören.

PROVIDER_INVALID

HTTP 400: Bad request

Unknown provider.

Swedish: Okänd leverantör.

PROVIDER_LICENSE_MISSING

HTTP 403: Forbidden

Fortnox refused access because a license is missing or inactive. Check the integration or app license in Fortnox, then try again. You can also import via SIE file in the meantime.

Swedish: Fortnox nekade åtkomst eftersom en licens saknas eller inte är aktiv. Kontrollera integrations- eller applicensen i Fortnox och försök sedan igen. Du kan även importera via SIE-fil under tiden.

PROVIDER_MIGRATE_FAILED

HTTP 500: Server error

Provider migration failed.

Swedish: Migrationen från leverantören misslyckades.

PROVIDER_PREVIEW_FAILED

HTTP 500: Server error

Provider preview failed.

Swedish: Förhandsgranskningen från leverantören misslyckades.

PROVIDER_RATE_LIMITED

HTTP 429: Rate limited

Provider rate limit exceeded.

Swedish: Leverantören begränsar antalet anrop just nu. Vänta en stund och försök igen.

PROVIDER_RESOURCE_FORBIDDEN

HTTP 403: Forbidden

The provider refused access to part of the data, but the connection itself works. Reconnecting will not help: check that register's permissions with the provider (in Fortnox the user rights and licence, in Bokio the integration token rights) and try again.

Swedish: Leverantören nekade åtkomst till en del av uppgifterna, men anslutningen fungerar. Att återansluta hjälper inte: kontrollera behörigheterna för det registret hos leverantören (i Fortnox användarens rättigheter och licens, i Bokio rättigheterna på integrationstoken) och försök igen.

PROVIDER_SIE_FETCH_FAILED

HTTP 502

Failed to fetch SIE data from the provider.

Swedish: Kunde inte hämta SIE-data från leverantören.

PROVIDER_SIE_IMPORT_REQUIRED

HTTP 409: Conflict

A completed SIE import is required first. Import the SIE file (chart of accounts, opening balances and verifications) before importing customers, suppliers, invoices and fixed assets from this provider.

Swedish: Bokföringsdata (SIE) måste importeras först. Ladda upp en SIE-fil med kontoplan, ingående balanser och verifikationer innan du hämtar kunder, leverantörer, fakturor och anläggningstillgångar från den här leverantören.

PROVIDER_SIE_NOT_SUPPORTED

HTTP 400: Bad request

This provider does not support fetching SIE via API. Upload a SIE file manually instead.

Swedish: Den här leverantören stöder inte SIE-hämtning via API. Ladda upp en SIE-fil manuellt istället.

PROVIDER_SIE_NO_YEARS

HTTP 404: Not found

No fiscal years available within the supported range.

Swedish: Inga räkenskapsår inom det stödda intervallet hittades hos leverantören.

PROVIDER_STATUS_FAILED

HTTP 500: Server error

Failed to fetch provider status.

Swedish: Kunde inte hämta status från leverantören.

PROVIDER_TOKEN_INVALID

HTTP 422: Unprocessable

The provider rejected the authentication. Check the integration details and try again.

Swedish: Leverantören avvisade autentiseringen. Kontrollera integrationsuppgifterna och försök igen.

PROVIDER_TOKEN_REQUIRED

HTTP 400: Bad request

apiToken is required for this provider.

Swedish: API-token krävs för den här leverantören.

PROVIDER_TOKEN_SUBMIT_FAILED

HTTP 409: Conflict

The account number already exists in this company chart of accounts but is deactivated.

Swedish: Kontot finns redan i din kontoplan men är inaktiverat.

Remediation: Reactivate the existing account instead of creating it: POST /api/v1/companies/{companyId}/accounts/activate with { account_numbers: [number] }, or gnubok_update_account with is_active=true. Related resource: Accounted://chart-of-accounts

ACCOUNT_IN_USE

HTTP 409: Conflict

The account has journal lines in this company and cannot be deleted (BFL: verifikat are immutable). Deactivate it instead (is_active=false).

Swedish: Kontot kan inte tas bort eftersom det används i bokförda verifikationer. Inaktivera det istället.

Remediation: Deactivate the account: PATCH /accounts/{number} with { is_active: false }, or gnubok_update_account. Related tool: gnubok_update_account

ACCOUNT_NOTHING_TO_UPDATE

HTTP 400: Bad request

Nothing to update: send at least one account field.

Swedish: Inget att uppdatera.

ACCOUNT_NOT_FOUND

Remediation: Give the user the connect_url from gnubok_connect_bank (or GET /bank-connections). Do not retry: no API call can revive a dead consent. Related tool: gnubok_connect_bank

BANK_SYNC_COOLDOWN

HTTP 429: Rate limited

This connection was synced recently. Wait until next_allowed_at before syncing again; the data you have is already fresh.

Swedish: Anslutningen synkades nyligen. Vänta tills next_allowed_at innan du synkar igen.

BANK_SYNC_FAILED

HTTP 502

The bank sync failed upstream. Retry after the cooldown; if it keeps failing the user should renew the connection.

Swedish: Banksynkningen misslyckades. Försök igen om en stund, eller förnya anslutningen om felet kvarstår.

BANK_SYNC_NOT_ACTIVE

HTTP 409: Conflict

Remediation: Retry after a short backoff. A staged operation refused this way is auto-rejected: stage it again with the same force + expected_journal_entry_ids, or link the row to the vouchers with gnubok_reconcile_match instead.

BATCH_TX_NOT_FOUND

HTTP 404: Not found

Transaction not found.

Swedish: Transaktionen kunde inte hittas.

BATCH_TX_POSSIBLE_DUPLICATE

HTTP 409: Conflict

The transaction already looks booked: one or more posted vouchers with no bank link add up exactly to its amount. Link the transaction to them instead, or pass force=true with expected_journal_entry_ids to book anyway.

Swedish: Transaktionen ser redan ut att vara bokförd: en eller flera verifikationer utan bankkoppling summerar exakt till beloppet. Koppla transaktionen till dem i stället, eller bokför ändå om de inte hör ihop.

Remediation: Link the bank row to the vouchers the message names instead of booking it again: gnubok_reconcile_match with account_key "bank:<cash_account_id>" and one pair { external_ids: [transaction_id], journal_entry_ids: [...], allocations }. Only if the row is a genuinely separate affärshändelse, call again with force=true and expected_journal_entry_ids set to exactly the ids the refusal listed. Related tool: gnubok_reconcile_match

BATCH_TX_ZERO_AMOUNT

HTTP 400: Bad request

Zero-amount transactions cannot be allocated.

Swedish: Transaktioner med beloppet 0 kan inte bokföras.

BATCH_UNAUTHORIZED

HTTP 403: Forbidden

You are not authorized to allocate transactions for this company.

Swedish: Du har inte behörighet att fördela transaktioner för det här företaget.

BL_COMPANY_KEY_NOT_FOUND

HTTP 422: Unprocessable

Björn Lundén found no company for this company key. Check that the whole key (GUID) was copied from Integrations → the gear icon in Lundify and try again.

Swedish: Björn Lundén hittade inget företag för den här företagsnyckeln. Kontrollera att hela nyckeln (GUID) är kopierad från Integrationer → kugghjulet i Lundify och försök igen.

BL_INTEGRATION_NOT_ACTIVATED

HTTP 422: Unprocessable

The company key is valid, but the company has not activated Accounted as an integration in Björn Lundén. Activate the integration under Integrations in Lundify or BL Administration and try again. If Accounted is missing from the list, the integration has not been released for your company yet: import via a SIE file for now.

Swedish: Företagsnyckeln stämmer, men företaget har inte aktiverat Accounted som integration i Björn Lundén. Aktivera integrationen under Integrationer i Lundify eller BL Administration och försök igen. Saknas Accounted i listan är integrationen inte släppt för ditt företag ännu: importera via SIE-fil så länge.

BOKIO_COMPANY_NOT_FOUND

HTTP 422: Unprocessable

Bokio could not find the company. Check the company ID and that the integration token was created for the same company.

Swedish: Bokio hittade inte företaget. Kontrollera företags-ID:t och att integrationstoken skapades för samma företag.

BOLAGSVERKET_API_ERROR

HTTP 502

The Bolagsverket API returned an error. See details for the upstream message.

Swedish: Bolagsverkets tjänst svarade med ett fel. Se detaljerna och försök igen.

BOLAGSVERKET_ARELLE_FAILED

HTTP 409: Conflict

Arelle found blocking errors in the iXBRL document. Correct them and create a new version.

Swedish: Arelle hittade blockerande fel i iXBRL-dokumentet. Rätta felen och skapa en ny version.

BOLAGSVERKET_ARELLE_UNAVAILABLE

HTTP 503

Arelle taxonomy validation is unavailable. Filing was stopped before anything was sent.

Swedish: Taxonomivalideringen med Arelle är inte tillgänglig. Inlämningen har stoppats innan något skickades.

BOLAGSVERKET_CERTIFICATE_SIGNER_MISMATCH

HTTP 409: Conflict

The certificate signer does not match the person locked into the annual report version.

Swedish: Undertecknaren av fastställelseintyget stämmer inte med den person som låstes i årsredovisningsversionen.

BOLAGSVERKET_CONFIG_MISSING

HTTP 503

Server configuration required by the Bolagsverket integration is missing (see details).

Swedish: Serverkonfiguration saknas för Bolagsverket-integrationen. Kontakta administratören.

BOLAGSVERKET_DIGITAL_INELIGIBLE

HTTP 409: Conflict

The locked annual report version is not eligible for connected filing. Use the paper workflow and review the Annual Report Studio checks.

Swedish: Den låsta årsredovisningsversionen är inte godkänd för digital inlämning. Använd pappersflödet och följ kontrollpunkterna i årsredovisningsstudion.

BOLAGSVERKET_ENV_NOT_ALLOWED

HTTP 403: Forbidden

The selected Bolagsverket environment exceeds the platform ceiling set by BOLAGSVERKET_ENV (order: test < accept < prod; unset means test).

Swedish: Den valda Bolagsverket-miljön är inte tillåten i den här installationen. Plattformens BOLAGSVERKET_ENV sätter taket.

BOLAGSVERKET_FORBIDDEN

HTTP 403: Forbidden

Insufficient role to file an årsredovisning for this company (viewer members cannot submit).

Swedish: Otillräcklig behörighet för att lämna in årsredovisning för det här företaget.

BOLAGSVERKET_INVALID_ENVIRONMENT

HTTP 400: Bad request

Invalid Bolagsverket environment. Allowed values: 'test', 'accept', 'prod'.

Swedish: Ogiltig Bolagsverket-miljö. Tillåtna värden: 'test', 'accept', 'prod'.

BOLAGSVERKET_NOT_RELEASED

HTTP 503

Connected filing to Bolagsverket is not enabled for this installation. Use the paper flow until acceptance is complete.

Swedish: Direktinlämning till Bolagsverket är inte öppnad i den här installationen. Använd pappersflödet tills anslutningen är godkänd.

BOLAGSVERKET_NO_SUBSCRIPTION

HTTP 404: Not found

No Bolagsverket event subscription exists for this company yet. One is created on the first submission.

Swedish: Ingen händelseprenumeration finns för företaget ännu.

BOLAGSVERKET_SIGNATURE_EVIDENCE_INCOMPLETE

HTTP 409: Conflict

Verifiable signature evidence is missing for one or more required signers.

Swedish: Verifierbart underskriftsunderlag saknas för en eller flera undertecknare.

BOLAGSVERKET_SUBMISSION_EXISTS

HTTP 409: Conflict

An active årsredovisning submission already exists for this fiscal period. Wait for Bolagsverket to resolve it before submitting again.

Swedish: Det finns redan en aktiv inlämning av årsredovisningen för räkenskapsåret. Invänta Bolagsverkets besked innan du lämnar in på nytt.

BOLAGSVERKET_VERSION_NOT_FOUND

HTTP 404: Not found

The selected annual report version was not found.

Swedish: Den valda versionen av årsredovisningen finns inte.

BOLAGSVERKET_VERSION_NOT_SIGNED

HTTP 409: Conflict

The annual report version must be finalized and signed before submission.

Swedish: Årsredovisningsversionen måste vara låst och undertecknad före inlämning.

BULK_BOOK_AMOUNT_MISMATCH

HTTP 400: Bad request

The sum of the selected transactions does not match the bank-line net amount on the journal entry.

Swedish: Summan av transaktionerna stämmer inte med bankradens nettobelopp på verifikationen.

HTTP 409: Conflict

Only draft entries can be cancelled; a posted entry must be reversed (storno) instead.

Swedish: Endast utkast kan makuleras. En bokförd verifikation måste stornas i stället.

Remediation: Storno the posted entry with POST /api/v1/companies/{companyId}/journal-entries/{id}/reverse. Cancelling a draft that is already cancelled succeeds: the endpoint is idempotent.

CANNOT_CORRECT_NON_POSTED

HTTP 400: Bad request

Only posted entries can be corrected.

Swedish: Endast bokförda verifikationer kan rättas.

CANNOT_EDIT_NON_DRAFT

CONNECTOR_UPSTREAM_ERROR

HTTP 502

The Peppol access point answered with an error. Try again shortly.

Swedish: Peppol-operatören svarade med ett fel. Försök igen om en stund.

CORRECTION_CHAIN_TOO_DEEP

DIMENSION_REFERENCED

HTTP 409: Conflict

The dimension is referenced by posted vouchers and cannot be deleted: archive (inactivate) it instead.

Swedish: Dimensionen används på bokförda verifikat och kan inte tas bort: avaktivera den istället.

Remediation: Archive the dimension instead: PATCH /api/dimensions/[id] with { "is_active": false }. Numbers tagged on posted lines are retained for the BFL 7-year period.

DIMENSION_SYSTEM_DELETE

HTTP 400: Bad request

System dimensions (kostnadsställe/projekt) cannot be deleted: archive (inactivate) them instead.

Swedish: Systemdimensioner (kostnadsställe och projekt) kan inte tas bort: avaktivera dem istället.

DIMENSION_SYSTEM_RENAME

HTTP 400: Bad request

System dimensions (kostnadsställe/projekt) cannot be renamed.

Swedish: Systemdimensioner kan inte döpas om.

DIMENSION_UPDATE_FAILED

HTTP 500: Server error

Failed to update dimension.

Swedish: Dimensionen kunde inte uppdateras.

DIMENSION_VALIDATION_FAILED

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

HTTP 409: Conflict

The value is referenced by posted vouchers and cannot be deleted: archive (inactivate) it instead.

Swedish: Värdet används på bokförda verifikat och kan inte tas bort: arkivera det istället.

Remediation: Archive the value instead: PATCH the dimension value with { "is_active": false }. Codes referenced by posted lines are retained for the BFL 7-year period.

DIMENSION_VALUE_UPDATE_FAILED

HTTP 500: Server error

Failed to update dimension value.

Swedish: Dimensionsvärdet kunde inte uppdateras.

DOC_ATTACH_OTHER_VERIFIKAT

HTTP 409: Conflict

The document is already the underlag of another journal entry.

Swedish: Underlaget är redan kopplat till en annan verifikation.

DOC_ATTACH_PERIOD_LOCKED

HTTP 409: Conflict

The document was attached to the transaction, but its journal entry is in a locked period, so it could not be linked to the entry.

Swedish: Bilagan kopplades till transaktionen men verifikationens period är låst: den kunde inte länkas till verifikationen.

DOC_ATTACH_PROPAGATION_FAILED

HTTP 500: Server error

The document was attached to the transaction but could not be linked to its journal entry. Retry: the operation is idempotent.

Swedish: Bilagan kopplades till transaktionen men kunde inte länkas till verifikationen. Försök igen: operationen är idempotent.

DOC_ATTACH_REPLACES_POSTED

HTTP 409: Conflict

The document currently on the transaction belongs to a posted journal entry and cannot be replaced. Reverse the entry first.

Swedish: Bilagan är kopplad till en bokförd verifikation och kan inte ersättas. Storno verifikationen först.

DOC_DELETE_LINKED

HTTP 409: Conflict

The document is linked to a journal entry and is accounting records under BFL 7 kap 2 §: it must be kept for 7 years and cannot be deleted. Upload a new version instead.

Swedish: Underlaget är knutet till en verifikation och utgör räkenskapsinformation enligt Bokföringslagen 7 kap 2§. Räkenskapsinformation ska bevaras i minst 7 år och får inte raderas. Använd "Ersätt med ny version" om underlaget behöver korrigeras.

DOC_DETACH_CONCURRENT

HTTP 409: Conflict

The transaction changed at the same time. Reload and try again.

Swedish: Transaktionen ändrades samtidigt. Ladda om sidan och försök igen.

DOC_DETACH_INBOX_UNLINK_FAILED

HTTP 500: Server error

The inbox item could not be released, so the document is still attached. Retry.

Swedish: Inkorgsposten kunde inte släppas, så underlaget är fortfarande kopplat. Försök igen.

DOC_DETACH_POSTED

HTTP 409: Conflict

The document is the underlag of a journal entry and cannot be detached. Reverse the entry first.

Swedish: Bilagan är kopplad till en bokförd verifikation och kan inte tas bort. Storno verifikationen först.

DOC_DOWNLOAD_FAILED

HTTP 500: Server error

Failed to create signed download URL.

Swedish: Det gick inte att skapa nedladdningslänken.

DOC_LINK_ALREADY_LINKED

HTTP 409: Conflict

Document is already linked to a journal entry.

Swedish: Dokumentet är redan kopplat till en verifikation.

DOC_LINK_ENTRY_NOT_FOUND

HTTP 404: Not found

Journal entry not found.

Swedish: Verifikationen kunde inte hittas.

DOC_LINK_FAILED

HTTP 500: Server error

Failed to link document to journal entry.

Swedish: Kopplingen misslyckades.

DOC_NOT_FOUND

HTTP 404: Not found

Document not found.

Swedish: Dokumentet kunde inte hittas.

DOC_UPLOAD_EMPTY

HTTP 400: Bad request

The uploaded file is empty. Upload the file again.

Swedish: Filen är tom. Ladda upp filen igen.

DOC_UPLOAD_INVALID_CONTENT

HTTP 400: Bad request

The file could not be read as a valid PDF or image. Check that the file is not corrupted.

Swedish: Filen kunde inte läsas som en giltig PDF eller bild. Kontrollera att filen inte är skadad.

DOC_UPLOAD_NO_FILE

HTTP 400: Bad request

No file attached.

Swedish: Ingen fil bifogad.

DOC_UPLOAD_PERIOD_LOCKED

HTTP 400: Bad request

Cannot attach documents to entries in a locked or closed fiscal period.

Swedish: Det går inte att bifoga underlag till verifikationer i en låst eller stängd period.

DOC_UPLOAD_STORAGE_FAILED

HTTP 500: Server error

Document storage failed.

Swedish: Filen kunde inte sparas.

DOC_UPLOAD_TOO_LARGE

HTTP 400: Bad request

Uploaded file exceeds the size limit.

Swedish: Filen är för stor.

DOC_UPLOAD_UNSUPPORTED_TYPE

HTTP 400: Bad request

Unsupported file type.

Swedish: Filtypen stöds inte.

EAI_AGAIN

HTTP 503

An upstream network call failed. Retry the same request after a short backoff.

Swedish: Kunde inte nå en extern tjänst. Försök igen om en stund.

ECONNREFUSED

HTTP 503

An upstream network call failed. Retry the same request after a short backoff.

Swedish: Kunde inte nå en extern tjänst. Försök igen om en stund.

ECONNRESET

HTTP 503

An upstream network call failed. Retry the same request after a short backoff.

Swedish: Kunde inte nå en extern tjänst. Försök igen om en stund.

EF_DECLARATION_WRONG_LEGAL_FORM

HTTP 400: Bad request

The NE-bilaga preview (egenavgifter, räntefördelning, periodiseringsfond and expansionsfond) applies only to an enskild firma, not to this company's legal form.

Swedish: NE-bilagans beräkningar (egenavgifter, räntefördelning, periodiseringsfond och expansionsfond) gäller bara enskild firma, inte företagets företagsform.

ENOTFOUND

HTTP 503

An upstream network call failed. Retry the same request after a short backoff.

Swedish: Kunde inte nå en extern tjänst. Försök igen om en stund.

ENTRY_ALREADY_REVERSED

HTTP 409: Conflict

Entry was already reversed by a concurrent operation.

Swedish: Verifikationen har redan stornats av en annan användare. Ladda om sidan och försök igen.

ENTRY_DATE_OUTSIDE_FISCAL_PERIOD

FISCAL_PERIOD_CLOSE_EXTERNAL_NATIVE_BOOKKEEPING

HTTP 409: Conflict

HTTP 404: Not found

No fiscal period covers the entry date.

Swedish: Räkenskapsperioden kunde inte hittas.

Remediation: Create or extend the relevant fiscal period before retrying. Related resource: Accounted://period/active

FISCAL_PERIOD_OVERLAP

HTTP 409: Conflict

The fiscal year overlaps an existing one (details.overlapping_period_id / overlapping_period_name). Fiscal years never overlap.

Swedish: Räkenskapsåret överlappar ett befintligt räkenskapsår.

Remediation: List the existing years with GET /fiscal-periods (gnubok_list_fiscal_periods) and choose dates that do not overlap any of them. Related tool: gnubok_list_fiscal_periods

FISCAL_PERIOD_START_NOT_FIRST_OF_MONTH

HTTP 400: Bad request

period_start must be the 1st of a month: only the company's first fiscal year may start mid-month (BFL 3 kap. 1 and 3 §§).

Swedish: Räkenskapsåret måste börja den 1:a i en månad. Bara företagets första räkenskapsår får börja mitt i en månad (BFL 3 kap. 1 och 3 §§).

FISCAL_PERIOD_TOO_LONG

HTTP 400: Bad request

A fiscal year may be at most 18 months (BFL 3 kap.). details.months holds the length requested.

Swedish: Ett räkenskapsår får vara högst 18 månader (BFL 3 kap.).

FISCAL_PERIOD_UPDATE_CLOSED

HTTP 409: Conflict

A closed fiscal year cannot be edited.

Swedish: Ett stängt räkenskapsår kan inte ändras.

FISCAL_PERIOD_UPDATE_FAILED

HTTP 500: Server error

Failed to update the fiscal year.

Swedish: Räkenskapsåret kunde inte sparas. Försök igen.

FISCAL_PERIOD_UPDATE_LOCKED

NO_DOC_REQUIRED_FAILED

HTTP 400: Bad request

The "no document required" flag could not be saved.

Swedish: Markeringen "Inget underlag krävs" kunde inte sparas.

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

OB_PNL_ACCOUNT

HTTP 400: Bad request

Profit & loss accounts (class 3-8) are not allowed in opening balances.

Swedish: Resultatkonton (klass 3-8) kan inte användas i ingående balanser.

OB_SET_COMPANY_LOCK_DATE

HTTP 409: Conflict

The company-wide bookkeeping lock date covers the first day of the fiscal year, so opening balances cannot be booked. Move the lock date under Settings → Bookkeeping and try again.

Swedish: Bokföringen är låst t.o.m. ett låsdatum som täcker räkenskapsårets första dag, så ingående balanser kan inte bokföras. Flytta låsdatumet under Inställningar → Bokföring och försök igen.

Remediation: Move the bookkeeping lock date (company_settings.bookkeeping_locked_through) to a date before the period start, then retry.

OB_TOO_FEW_LINES

HTTP 400: Bad request

At least two lines with amounts are required.

Swedish: Minst två rader med belopp krävs.

OB_UNBALANCED

HTTP 400: Bad request

Opening balance debits and credits do not match.

Swedish: Debet och kredit balanserar inte.

OPENING_BALANCES_LOCKED

HTTP 409: Conflict

Opening balances are locked: the employee has a booked salary run.

Swedish: Ingående saldon är låsta: den anställda har en bokförd lönekörning.

OUTSIDE_UNKNOWN

HTTP 400: Bad request

The outside balance is unknown, so the account cannot be reconciled. Fetch it first, or sign with force and a note.

Swedish: Saldot utanför bokföringen är okänt, så kontot kan inte stämmas av. Hämta det först, eller signera med en notering.

PEPPOL_ACCESS_ALREADY_ENABLED

HTTP 409: Conflict

Peppol is already enabled for the company.

Swedish: Peppol är redan aktiverat för bolaget.

PEPPOL_ACCESS_REQUIRED

HTTP 403: Forbidden

Peppol is not enabled for this company. Request access under Settings > Invoicing > E-invoicing via Peppol and we will enable it.

Swedish: Peppol är inte aktiverat för det här bolaget. Begär åtkomst under Inställningar > Fakturering > E-faktura via Peppol, så aktiverar vi det.

PEPPOL_FISCAL_PERIOD_MISSING

HTTP 422: Unprocessable

The invoice date falls outside every fiscal year. Create the fiscal year before sending the invoice via Peppol.

Swedish: Fakturadatumet saknar ett räkenskapsår. Skapa räkenskapsåret innan fakturan skickas via Peppol.

PEPPOL_LOOKUP_FAILED

HTTP 502

Could not look up the recipient in the Peppol network. Try again shortly.

Swedish: Kunde inte slå upp mottagaren i Peppol-nätverket. Försök igen om en stund.

PEPPOL_RECEIVING_NOT_ENABLED

HTTP 403: Forbidden

Receiving via Peppol is not enabled for this company. Contact support and we will open a slot.

Swedish: Mottagning via Peppol är inte aktiverad för det här bolaget. Hör av dig till support så öppnar vi en plats.

PEPPOL_RECEIVING_UNSUPPORTED

HTTP 503

The configured Peppol access point does not support receiving e-invoices.

Swedish: Den konfigurerade Peppol-operatören stöder inte mottagning av e-fakturor.

PEPPOL_RECIPIENT_NOT_REACHABLE

HTTP 422: Unprocessable

The recipient is not registered to receive e-invoices via Peppol. Check the organisation number or deliver the invoice another way.

Swedish: Mottagaren är inte registrerad för att ta emot e-fakturor via Peppol. Kontrollera organisationsnumret eller skicka fakturan på annat sätt.

PEPPOL_REGISTRATION_CAP_REACHED

HTTP 409: Conflict

All Peppol receiving slots are taken right now. Contact support and we will open more. Sending e-invoices works regardless.

Swedish: Alla platser för Peppol-mottagning är upptagna just nu. Hör av dig till support så öppnar vi fler. Att skicka e-fakturor fungerar ändå.

PEPPOL_REGISTRATION_COMPANY_NAME_REQUIRED

HTTP 422: Unprocessable

The company needs a company name in company settings before it can be registered for Peppol.

Swedish: Bolaget behöver ett företagsnamn i företagsinställningarna innan det kan registreras för Peppol.

PEPPOL_REGISTRATION_FAILED

HTTP 502

The Peppol access point could not complete the registration. Try again shortly.

Swedish: Peppol-operatören kunde inte genomföra registreringen. Försök igen om en stund.

PEPPOL_REGISTRATION_NOT_FOUND

HTTP 404: Not found

The company is not registered for Peppol receiving.

Swedish: Bolaget är inte registrerat för Peppol-mottagning.

PEPPOL_REGISTRATION_ORG_NUMBER_REQUIRED

HTTP 422: Unprocessable

The company needs a valid organisation number in company settings before it can receive e-invoices via Peppol.

Swedish: Bolaget behöver ett giltigt organisationsnummer i företagsinställningarna innan det kan ta emot e-fakturor via Peppol.

PEPPOL_REGISTRATION_PERSONAL_NUMBER

HTTP 422: Unprocessable

A sole trader identified by a personal identity number cannot be registered for Peppol yet: it would publish personal data in the Peppol directory. GLN support is coming.

Swedish: Enskild firma med personnummer kan ännu inte registreras för Peppol: det skulle publicera personuppgifter i Peppol-katalogen. Stöd för GLN-nummer kommer.

PEPPOL_REGISTRATION_REJECTED

HTTP 422: Unprocessable

The Peppol access point rejected the registration. Contact support if the problem persists.

Swedish: Registreringen avvisades av Peppol-operatören. Kontakta support om felet kvarstår.

PEPPOL_SANDBOX_NOT_ALLOWED

HTTP 403: Forbidden

Peppol registration is not available in the demo company. Create a real account to receive e-invoices.

Swedish: Peppol-registrering är inte tillgänglig i demobolaget. Skapa ett riktigt konto för att ta emot e-fakturor.

PEPPOL_SEND_INVALID_STATUS

HTTP 409: Conflict

Only draft and sent invoices can be sent via Peppol. Cancelled, credited and proforma invoices cannot be sent.

Swedish: Bara utkast och skickade fakturor kan skickas via Peppol. Makulerade, krediterade och proformafakturor kan inte skickas.

PEPPOL_SEND_LIMIT_REACHED

HTTP 409: Conflict

The company has used its Peppol sends. Contact support for more.

Swedish: Bolaget har använt sina Peppol-sändningar. Hör av dig till support för fler.

PEPPOL_SEND_PRECONDITION_FAILED

HTTP 409: Conflict

The invoice could not be sent via Peppol yet: check the Peppol settings and try again.

Swedish: Fakturan kunde inte skickas via Peppol ännu: kontrollera Peppol-inställningarna och försök igen.

PEPPOL_SUBMISSION_FAILED

HTTP 502

The Peppol access point could not be reached. The invoice has not been sent; try again shortly.

Swedish: Peppol-operatören kunde inte nås just nu. Fakturan har inte skickats; försök igen om en stund.

PEPPOL_SUBMISSION_REJECTED

HTTP 422: Unprocessable

The Peppol access point rejected the invoice during validation. The invoice has not been sent.

Swedish: Peppol-operatören avvisade fakturan vid valideringen. Fakturan har inte skickats.

PEPPOL_TRANSPORT_UNAVAILABLE

HTTP 503

Peppol sending is not enabled in this environment. A contracted Peppol access point must be configured.

Swedish: Peppol-utskick är inte aktiverat i den här miljön. En avtalad Peppol-operatör måste vara konfigurerad.

PERSONNUMMER_ENCRYPTION_NOT_CONFIGURED

HTTP 503

Payroll is not configured: the personal-number encryption key (PERSONNUMMER_ENCRYPTION_KEY) is missing from the deployment environment. Contact support.

Swedish: Lönemodulen är inte konfigurerad: krypteringsnyckeln för personnummer (PERSONNUMMER_ENCRYPTION_KEY) saknas i driftmiljön. Kontakta supporten.

Swedish: Länken är ogiltig eller har gått ut.

HTTP 400: Bad request

Details are fetched for legal persons only, not for sole traders.

Swedish: Uppgifter hämtas bara för juridiska personer, inte för enskilda firmor.

SCB_NOT_CONFIGURED

HTTP 503

Lookups against the SCB business register are not enabled in this environment.

Swedish: Uppslag mot SCB:s företagsregister är inte aktiverat i den här miljön.

SCHABLONINTAKT_RATE_NOT_CONFIGURED

HTTP 500: Server error

HTTP 400: Bad request

SI_BATCH_INELIGIBLE_INVOICE

HTTP 400: Bad request

One or more invoices cannot be included in the payment batch. See details for the per-invoice reason.

Swedish: En eller flera fakturor kan inte ingå i betalfilen. Se detaljerna för orsak per faktura.

SI_BATCH_INVALID_AMOUNT

HTTP 400: Bad request

The payment amount must be greater than zero.

Swedish: Betalbeloppet måste vara större än noll.

SI_BATCH_NOT_FOUND

HTTP 404: Not found

Payment batch not found.

Swedish: Betalfilen kunde inte hittas.

SI_BATCH_PAYEE_CHANGED

HTTP 409: Conflict

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

SKATTEVERKET_API_ERROR

HTTP 502

The Skatteverket API returned an error. See details for the upstream message.

Swedish: Skatteverkets tjänst svarade med ett fel. Se detaljerna och försök igen.

SKATTEVERKET_CAPABILITY_BLOCKED

HTTP 403: Forbidden

Talking to Skatteverket directly requires a paid subscription for this company.

Swedish: Den här funktionen kräver en betald prenumeration. Uppgradera för att fortsätta använda externa tjänster.

SKATTEVERKET_NOT_CONNECTED

HTTP 401: Unauthorized

The Skatteverket connection is missing or has expired. If the company was connected before this is expected: Skatteverket personal sessions last only about 1 hour. Tell the user to connect (or reconnect) with BankID under Inställningar → Skatteverket in Accounted. Only a person can do this; do not retry until they confirm they have reconnected.

Swedish: Anslutningen till Skatteverket saknas eller har gått ut. Om företaget varit anslutet tidigare är detta normalt: Skatteverkets personliga inloggning gäller bara ca 1 timme. Be användaren ansluta (igen) med BankID under Inställningar → Skatteverket.

Remediation: A person must connect (or reconnect) to Skatteverket with BankID under Inställningar → Skatteverket. Personal Skatteverket sessions expire after about 1 hour by SKV design, so an expired session is normal, not a fault. Do not retry until the user confirms they have reconnected.

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.

STORAGE_PROXY_BODY_TOO_LARGE

HTTP 413

The file is too large to upload through this link.

Swedish: Filen är för stor för att laddas upp via länken.

STORAGE_PROXY_TOKEN_REQUIRED

HTTP 400: Bad request

The link is missing its signed token.

Swedish: Länken saknar sin signerade token.

STORAGE_PROXY_UNCONFIGURED

HTTP 503

Storage is not configured on this server.

Swedish: Lagringen är inte konfigurerad på den här servern.

STORAGE_PROXY_UNSUPPORTED_PATH

HTTP 404: Not found

The storage proxy does not serve this path.

Swedish: Sökvägen stöds inte av lagringsproxyn.

STORAGE_PROXY_UPSTREAM_UNAVAILABLE

HTTP 502

Storage did not respond.

Swedish: Lagringen svarade inte.

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.

TRANSIENT_ERROR

HTTP 503

Transient failure: retry the same request after a short backoff.

Swedish: Tillfälligt fel: försök igen om en stund.

TX_BATCH_CATEGORIZE_EMPTY

HTTP 400: Bad request

Batch is empty: pass at least one item.

Swedish: Batchen är tom.

TX_CATEGORIZE_IGNORED_CONFLICT

HTTP 409: Conflict

The transaction is still marked as ignored and cannot be linked to a journal entry.

Swedish: Transaktionen är fortfarande markerad som ignorerad och kan därför inte kopplas till en verifikation.

Remediation: Reload and retry categorization. Report the conflict if it persists.

TX_CATEGORIZE_INVALID_ACCOUNT

HTTP 400: Bad request

The supplied account does not exist in the chart of accounts.

Swedish: Det valda kontot finns inte i kontoplanen.

Remediation: Activate the account in the chart of accounts or pick a different one. Related resource: Accounted://chart-of-accounts

TX_CATEGORIZE_INVALID_MAPPING

HTTP 400: Bad request

Mapping result is missing a debit or credit account.

Swedish: Konteringen saknar debet- eller kreditkonto.

TX_CATEGORIZE_INVALID_TEMPLATE

HTTP 400: Bad request

The supplied booking template is invalid or does not match the entity type.

Swedish: Bokföringsmallen är ogiltig eller passar inte din bolagsform.

TX_CATEGORIZE_INVALID_VAT_AMOUNT

HTTP 400: Bad request

The document's VAT amount cannot be used for this booking. Check the amount and the VAT treatment.

Swedish: Underlagets moms kunde inte användas för den här bokföringen. Kontrollera beloppet och momssatsen.

TX_CATEGORIZE_JOURNAL_ENTRY_FAILED

HTTP 409: Conflict

The journal entry could not be created, so the transaction was not booked and stays in the unbooked list.

Swedish: Verifikationen kunde inte skapas, så transaktionen är inte bokförd. Den ligger kvar under Att bokföra.

Remediation: Fix the cause in details.cause (PERIOD_LOCKED / BOOKKEEPING_DATABASE_ERROR with a locked-period message: unlock the period or use gnubok_unlock_period; NO_OPEN_PERIOD_FOR_DATE: create or open the fiscal year) and retry the same request. Nothing was written.

TX_CATEGORIZE_ORPHANED_COUNTER_ACCOUNT

HTTP 400: Bad request

The counter-account is a bank ledger of the transaction's own account or of a disconnected bank connection and cannot be used. Pick a revenue or expense account instead.

Swedish: Motkontot är ett bankkonto som hör till transaktionens eget konto eller till en frånkopplad bankanslutning och kan inte användas. Välj ett intäkts- eller kostnadskonto i stället.

Remediation: Choose a revenue or expense account as the counter-account; a twin or orphaned bank ledger must not receive new postings. Related resource: Accounted://chart-of-accounts

TX_CATEGORIZE_PRIVATE_PERIOD_LOCKED

HTTP 502

Could not fetch the exchange rate from Riksbanken. The verifikation must be posted in SEK.

Swedish: Kunde inte hämta växelkursen från Riksbanken. Försök igen om en stund: verifikationen måste bokföras i SEK.

TX_IGNORE_ALREADY_BOOKED

HTTP 409: Conflict

WEBSHOP_ORDER_ZERO_RATE_CONTEXT_MISMATCH

HTTP 422: Unprocessable

The order has a 0 % part but the billing country does not match the chosen 0 % account (export or EU account). The check uses the billing address, not the delivery address: if the goods ship to another country the account may still be right. Book the order individually and confirm the account for the right box (ruta 35-42).

Swedish: Ordern har en momsfri del men faktureringslandet stämmer inte med det valda 0 %-kontot (export- eller EU-konto). Kontrollen bygger på faktureringsadressen, inte leveransadressen: går varorna till ett annat land kan kontot ändå vara rätt. Bokför ordern enskilt och bekräfta kontot för ruta 35-42.