Konton

Kontoresursen speglar Fortnox /3/accounts. Kontot adresseras på sitt kontonummer (Number), fyra siffror enligt BAS. Saldona räknas fram ur bokföringen för ett visst räkenskapsår och lagras inte på kontot.

Scope: bookkeeping · Kräver AI Pro

EndpointsCopy Anchor Link

Bas-URL: https://app.klirr.ai/api/v1. Skrivningar kuverteras i Account.

RäkenskapsårCopy Anchor Link

Alla fem anrop läser ?financialyear=. Det styr Year och vilket år BalanceBroughtForward/BalanceCarriedForward räknas för. Värdet är räkenskapsårets Id från /3/financialyears, inte ett årtal. Utelämnat gäller det räkenskapsår som innehåller dagens datum, annars det senaste.

• Ett värde som inte bara består av siffror ger 400.
• Ett okänt Id ger 404.
• Saknar organisationen räkenskapsår svarar alla anrop 404. Vid POST/PUT görs kontrollen före skrivningen, så inget sparas.

ListparametrarCopy Anchor Link

Utöver paginering (page, limit, offset) och sortorder (asc/desc, även ascending/descending):

Det finns inget filter. Listan innehåller alla konton, både aktiva och inaktiva (Active: false). Fortnox-parametrarna sru och lastmodified stöds inte och ger 400.

FältCopy Anchor Link

Fullständig form (GET /3/accounts/{Number}, och svaret på POST/PUT).

"Bärs vidare" betyder att Klirr sparar värdet och returnerar det oförändrat, men det påverkar inte bokföringen. Kontotyp och normalsida härleds ur kontonumret.

ListformCopy Anchor Link

GET /3/accounts returnerar exakt dessa tolv fält: @url, Active, BalanceBroughtForward, CostCenter, CostCenterSettings, Description, Number, Project, ProjectSettings, SRU, Year, VATCode. BalanceCarriedForward ingår inte i listan. Belopp och nummer är tal (JSON-nummer) även i listformen.

Skapa ett kontoCopy Anchor Link

curl -X POST https://app.klirr.ai/api/v1/3/accounts \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"Account":{"Number":6991,"Description":"Övriga externa kostnader, ej avdragsgilla"}}'

Svar (201):

{
  "Account": {
    "@url": "https://app.klirr.ai/api/v1/3/accounts/6991",
    "Number": 6991,
    "Description": "Övriga externa kostnader, ej avdragsgilla",
    "Active": true,
    "VATCode": "",
    "BalanceBroughtForward": 0,
    "BalanceCarriedForward": 0,
    "Year": 3,
    "SRU": 0,
    "CostCenter": "",
    "CostCenterSettings": "NOTALLOWED",
    "Project": "",
    "ProjectSettings": "NOTALLOWED",
    "TransactionInformation": "",
    "TransactionInformationSettings": "NOTALLOWED",
    "QuantitySettings": "NOTALLOWED",
    "QuantityUnit": "",
    "OpeningQuantities": []
  }
}

Lista kontonCopy Anchor Link

curl "https://app.klirr.ai/api/v1/3/accounts?financialyear=3&limit=100" \
  -H "Authorization: Bearer <access_token>"

{
  "Accounts": [
    {
      "@url": "https://app.klirr.ai/api/v1/3/accounts/1930",
      "Number": 1930,
      "Description": "Företagskonto",
      "Active": true,
      "VATCode": "",
      "BalanceBroughtForward": 125000.5,
      "Year": 3,
      "SRU": 0,
      "CostCenter": "",
      "CostCenterSettings": "NOTALLOWED",
      "Project": "",
      "ProjectSettings": "NOTALLOWED"
    }
  ],
  "MetaInformation": { "@TotalResources": 1, "@TotalPages": 1, "@CurrentPage": 1 }
}

Uppdatera ett kontoCopy Anchor Link

PUT ändrar bara de fält du skickar. Omodellerade fält slås ihop med de redan sparade i stället för att ersätta dem. Se Fortnox-kompatibilitet.

curl -X PUT https://app.klirr.ai/api/v1/3/accounts/6991 \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"Account":{"Description":"Ej avdragsgilla kostnader"}}'

Inaktivera ett kontoCopy Anchor Link

DELETE raderar inte kontot. Det inaktiveras (Active: false), eftersom bokförda rader refererar till det. Svaret är 204, och kontot finns kvar på sin URL. Systemkonton i BAS-kontoplanen (t.ex. 1930) kan varken inaktiveras eller få ändrad momskod, varken via PUT eller DELETE. Det ger 409.

FelCopy Anchor Link

Allmänna fel (401, 403, 429) beskrivs under Felkoder.