Bokföra en verifikation
Bokför en manuell verifikation via API:t – räkenskapsår, låst period, serie, konton och rättelser.
Den här guiden bokför en manuell verifikation, till exempel ett kortköp av kontorsmaterial. Alla belopp och nummer är påhittade exempel.
Du behöver en access token med scope bookkeeping. Den täcker räkenskapsår, serier, konton och verifikationer. Låst period kräver dessutom settings.
En verifikation kan inte ändras
POST /3/vouchers skapar en riktig verifikation i Klirrs bokföring. Det finns ingen PUT och ingen DELETE. Ett fel rättas med en ny verifikation.
Hitta räkenskapsåret
?financialyear= är räkenskapsårets Id, inte ett årtal. Hämta id:t från /3/financialyears. Utelämnar du parametern gäller året som innehåller dagens datum.
curl https://app.klirr.ai/api/v1/3/financialyears \
-H "Authorization: Bearer <access_token>"{
"FinancialYears": [
{ "@url": "https://app.klirr.ai/api/v1/3/financialyears/3", "Id": 3, "FromDate": "2026-01-01", "ToDate": "2026-12-31", "AccountChartType": "BAS 2013", "AccountingMethod": "ACCRUAL" }
],
"MetaInformation": { "@TotalResources": 1, "@TotalPages": 1, "@CurrentPage": 1 }
}Kontrollera låst period
Ett bokföringsdatum i en låst period ger 409. Läs EndDate från /3/settings/lockedperiod. Fältet utelämnas när ingen period är låst.
curl https://app.klirr.ai/api/v1/3/settings/lockedperiod \
-H "Authorization: Bearer <access_token>"Välj serie och kontrollera kontona
Serien måste finnas och vara aktiv. Lista serierna med /3/voucherseries. Varje konto på raderna måste finnas och vara aktivt. Kontrollera med GET /3/accounts/{Number}.
curl "https://app.klirr.ai/api/v1/3/voucherseries?financialyear=3" \
-H "Authorization: Bearer <access_token>"
curl https://app.klirr.ai/api/v1/3/accounts/6110 \
-H "Authorization: Bearer <access_token>"Listan heter VoucherSeriesCollection, inte VoucherSeries.
Skapa verifikationen
VoucherSeries, TransactionDate och Description är obligatoriska. Summan av Debit måste vara exakt lika med summan av Credit, och en rad kan inte ha både debet och kredit. Skickar du financialyear måste TransactionDate ligga i det året.
curl -X POST "https://app.klirr.ai/api/v1/3/vouchers?financialyear=3" \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"Voucher":{"VoucherSeries":"A","TransactionDate":"2026-10-14","Description":"Kontorsmaterial, Pappershuset kvitto 8812","VoucherRows":[{"Account":6110,"Debit":1240},{"Account":2641,"Debit":310},{"Account":1930,"Credit":1550}]}}'Svar (201, förkortat):
{
"Voucher": {
"@url": "https://app.klirr.ai/api/v1/3/vouchers/A/58",
"VoucherNumber": 58,
"VoucherSeries": "A",
"Year": 3,
"TransactionDate": "2026-10-14",
"Description": "Kontorsmaterial, Pappershuset kvitto 8812",
"ReferenceType": "MANUAL",
"VoucherRows": [
{ "Account": 6110, "Debit": 1240, "Credit": 0, "Description": "Förbrukningsmaterial", "Removed": false },
{ "Account": 2641, "Debit": 310, "Credit": 0, "Description": "Debiterad ingående moms", "Removed": false },
{ "Account": 1930, "Debit": 0, "Credit": 1550, "Description": "Företagskonto", "Removed": false }
]
}
}Läs tillbaka verifikationen
En verifikation identifieras av serie, nummer och räkenskapsår. Ange alltid financialyear när du hämtar den.
curl "https://app.klirr.ai/api/v1/3/vouchers/A/58?financialyear=3" \
-H "Authorization: Bearer <access_token>"Rätta en verifikation
Bokför en ny verifikation som vänder de felaktiga raderna, och därefter en med rätt belopp. Exemplet backar verifikation A 58:
{
"Voucher": {
"VoucherSeries": "A",
"TransactionDate": "2026-10-16",
"Description": "Rättelse av A 58",
"VoucherRows": [
{ "Account": 1930, "Debit": 1550 },
{ "Account": 6110, "Credit": 1240 },
{ "Account": 2641, "Credit": 310 }
]
}
}Vanliga fel
| Status | Orsak |
|---|---|
400 | Obalanserad verifikation, konto som inte finns eller är inaktivt, okänd eller inaktiverad serie, eller ett datum utanför räkenskapsåret. |
404 | Okänt räkenskapsår eller verifikation som inte finns. |
409 | TransactionDate ligger i en låst period eller ett stängt räkenskapsår. |
Se Verifikationer för alla fält och Felkoder för felformatet.