Registrera en leverantörsfaktura
Från leverantör till bokförd leverantörsfaktura – skapa leverantör, registrera utkast, rätta och bokför.
Den här guiden registrerar en inkommande faktura från en leverantör och bokför den i leverantörsreskontran. Alla namn, nummer och belopp är påhittade exempel.
Du behöver en access token med scopes supplier och supplierinvoice.
Två adresser för samma faktura
En leverantörsfaktura adresseras på Klirrs löpnummer GivenNumber, inte på leverantörens eget fakturanummer InvoiceNumber. Spara GivenNumber från svaret på POST.
Skapa leverantören
Leverantören måste finnas innan fakturan registreras. Enda obligatoriska fältet är Name. Hoppa över steget om leverantören redan finns. Sök med GET /3/suppliers?suppliernumber=....
curl -X POST https://app.klirr.ai/api/v1/3/suppliers \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"Supplier":{"Name":"Norrlands Trävaror AB","OrganisationNumber":"556000-0003","BG":"000-0001","TermsOfPayment":"30"}}'Registrera fakturan som utkast
POST skapar alltid ett utkast. SupplierNumber, InvoiceNumber, InvoiceDate, DueDate och minst en rad är obligatoriska. Raderna har ingen momssats. Klirr härleder den ur VAT mot radernas netto, och den måste landa på 25, 12 eller 6 %.
curl -X POST https://app.klirr.ai/api/v1/3/supplierinvoices \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"SupplierInvoice":{"SupplierNumber":"7","InvoiceNumber":"NT-40921","InvoiceDate":"2026-10-12","DueDate":"2026-11-11","OCR":"409210","VAT":1600,"SupplierInvoiceRows":[{"Account":4010,"ItemDescription":"Konstruktionsvirke 45x95","Quantity":40,"Price":160}]}}'Svar (201, förkortat). Beloppen är strängar även i den fullständiga formen:
{
"SupplierInvoice": {
"@url": "https://app.klirr.ai/api/v1/3/supplierinvoices/88",
"GivenNumber": "88",
"SupplierNumber": "7",
"SupplierName": "Norrlands Trävaror AB",
"InvoiceNumber": "NT-40921",
"InvoiceDate": "2026-10-12",
"DueDate": "2026-11-11",
"Total": "8000",
"VAT": "1600",
"VATType": "NORMAL",
"Booked": false,
"Cancelled": false,
"Vouchers": []
}
}Samma fakturanummer hos samma leverantör i samma räkenskapsår ger 409. Det skyddar mot dubbelregistrering.
Rätta utkastet (valfritt)
PUT ändrar bara de fält du skickar och fungerar bara på utkast. Skickar du SupplierInvoiceRows ersätts raderna.
curl -X PUT https://app.klirr.ai/api/v1/3/supplierinvoices/88 \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{"SupplierInvoice":{"DueDate":"2026-11-15","Comments":"Leverans till Sundsvall"}}'Bokför fakturan
PUT /3/supplierinvoices/{GivenNumber}/bookkeep bokför fakturan med en verifikation i serie L: debet kostnadskonto per rad, ingående moms på 2640 och kredit 2440 leverantörsskuld. Anropet tar ingen kropp och är idempotent.
curl -X PUT https://app.klirr.ai/api/v1/3/supplierinvoices/88/bookkeep \
-H "Authorization: Bearer <access_token>"Ett stängt räkenskapsår eller en låst period ger 409.
Om något blev fel
PUT /3/supplierinvoices/{GivenNumber}/cancel makulerar fakturan:
| Läge | Resultat |
|---|---|
| Utkast | Utkastet raderas. |
| Bokförd | Bokföringen återförs med ett rättelseverifikat i serie M. |
| Betald | 409. Betalningen måste ångras först. |
/credit, /approvalbookkeep och /approvalpayment stöds inte och svarar alltid 400. Det externa API:t har ingen betalningsresurs för leverantörsfakturor, så betalningen registreras i Klirr.
Se Leverantörsfakturor och Leverantörer för alla fält.