Verifikationer

Verifikationsresursen speglar Fortnox /3/vouchers. En verifikation identifieras av tre delar: serie, nummer och räkenskapsår. Serie och nummer ligger i sökvägen, räkenskapsåret i ?financialyear=. Nummer 12 i serie A finns alltså en gång per räkenskapsår.

POST skapar en riktig verifikation i Klirrs bokföring, på samma väg som Klirrs egna bokföringar. Periodlås, balanskrav och nummerserie gäller. Det finns ingen PUT och ingen DELETE: en bokförd verifikation kan inte ändras eller tas bort, bara rättas med en ny verifikation.

Scope: bookkeeping · Kräver AI Pro

EndpointsCopy Anchor Link

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

RäkenskapsårCopy Anchor Link

Alla anrop läser ?financialyear=, 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 är ett positivt heltal ger 400, ett okänt Id ger 404.

Listorna visar bara verifikationer i det valda året. Vid POST måste TransactionDate ligga i det angivna året om du skickar financialyear. Annars bestäms året av datumet.

ListparametrarCopy Anchor Link

Gäller både /3/vouchers och /3/vouchers/sublist/{VoucherSeries}. Utöver paginering (page, limit, offset) och sortorder (asc/desc, även ascending/descending):

Fortnox-parametrarna costcenter och lastmodified stöds inte och ger 400.

En okänd serie i ?voucherseries= ger en tom lista. En okänd serie i sublist-sökvägen ger 404.

FältCopy Anchor Link

Fullständig form (GET /3/vouchers/{VoucherSeries}/{VoucherNumber}, och svaret på POST).

VoucherRowsCopy Anchor Link

Regler för raderna: belopp får inte vara negativa, en rad kan inte ha både Debit och Credit, högst 1000 rader, och summan av Debit måste vara exakt lika med summan av Credit (på öret).

ListformCopy Anchor Link

Listorna returnerar samma fält som den fullständiga formen utom VoucherRows, CostCenter och Project.

Skapa en verifikationCopy Anchor Link

curl -X POST https://app.klirr.ai/api/v1/3/vouchers \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"Voucher":{"VoucherSeries":"A","TransactionDate":"2026-03-15","Description":"Kontorsmaterial","VoucherRows":[{"Account":6110,"Debit":800},{"Account":2641,"Debit":200},{"Account":1930,"Credit":1000}]}}'

Svar (201):

{
  "Voucher": {
    "@url": "https://app.klirr.ai/api/v1/3/vouchers/A/42",
    "VoucherNumber": 42,
    "VoucherSeries": "A",
    "Year": 3,
    "TransactionDate": "2026-03-15",
    "Description": "Kontorsmaterial",
    "Comments": "",
    "ReferenceNumber": "",
    "ReferenceType": "MANUAL",
    "ApprovalState": 0,
    "CostCenter": "",
    "Project": "",
    "VoucherRows": [
      { "Account": 6110, "Debit": 800, "Credit": 0, "Description": "Förbrukningsmaterial", "CostCenter": "", "Project": "", "TransactionInformation": "", "Removed": false },
      { "Account": 2641, "Debit": 200, "Credit": 0, "Description": "Debiterad ingående moms", "CostCenter": "", "Project": "", "TransactionInformation": "", "Removed": false },
      { "Account": 1930, "Debit": 0, "Credit": 1000, "Description": "Företagskonto", "CostCenter": "", "Project": "", "TransactionInformation": "", "Removed": false }
    ]
  }
}

Lista verifikationerCopy Anchor Link

curl "https://app.klirr.ai/api/v1/3/vouchers/sublist/A?financialyear=3&fromdate=2026-03-01&todate=2026-03-31" \
  -H "Authorization: Bearer <access_token>"

{
  "Vouchers": [
    {
      "@url": "https://app.klirr.ai/api/v1/3/vouchers/A/42",
      "VoucherNumber": 42,
      "VoucherSeries": "A",
      "Year": 3,
      "TransactionDate": "2026-03-15",
      "Description": "Kontorsmaterial",
      "Comments": "",
      "ReferenceNumber": "",
      "ReferenceType": "MANUAL",
      "ApprovalState": 0
    }
  ],
  "MetaInformation": { "@TotalResources": 1, "@TotalPages": 1, "@CurrentPage": 1 }
}

Hämta en verifikationCopy Anchor Link

curl "https://app.klirr.ai/api/v1/3/vouchers/A/42?financialyear=3" \
  -H "Authorization: Bearer <access_token>"

FelCopy Anchor Link

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