Leverantörsfakturor

Leverantörsfakturaresursen speglar Fortnox /3/supplierinvoices. Fakturan adresseras på Klirrs eget löpnummer (GivenNumber), inte på leverantörens fakturanummer (InvoiceNumber), som varken är unikt eller Klirrs att dela ut. GivenNumber kan inte ändras.

POST skapar ett utkast. Bokföringen görs i ett separat steg med /bookkeep.

Scope: supplierinvoice · Kräver AI Pro

EndpointsCopy Anchor Link

Det finns ingen DELETE. Vägen bort är /cancel. Bas-URL: https://app.klirr.ai/api/v1. Skrivningar kuverteras i SupplierInvoice.

ListparametrarCopy Anchor Link

Utöver paginering (page, limit, offset). Det finns ingen sortby. Listan sorteras alltid på GivenNumber, nyast först.

Fortnox-parametrarna suppliername, serialnumber, ocr, costcenter, project, ourreference, yourreference, fromfinalpaydate, tofinalpaydate och lastmodified stöds inte ännu och ger 400 i stället för ett tyst ofiltrerat svar.

FältCopy Anchor Link

Fullständig form (GET /3/supplierinvoices/{GivenNumber}, och svaret på POST, PUT och åtgärderna).

Beloppen (Total, VAT, Balance, CurrencyRate m.fl.) är strängar även i den fullständiga formen, till skillnad från kundfakturan. Det är så Fortnox typar just den här resursen. Det finns inget Net.

RaderCopy Anchor Link

Fortnox-raden har ingen momssats. Klirr härleder den ur fakturans VAT mot radernas netto: den måste landa på 25, 12 eller 6 % (med öresavrundning), annars 400. VAT = 0 ger 0 %. För omvänd skattskyldighet antas 25 %. En faktura med blandade momssatser kan alltså inte registreras via det här API:t.

ListformCopy Anchor Link

GET /3/supplierinvoices returnerar en reducerad rad med fälten @url, AuthorizerName (alltid ""), Balance, Booked, Cancel, CostCenter, Credit, Currency, CurrencyRate, CurrencyUnit, DisablePaymentFile, DueDate, ExternalInvoiceNumber, ExternalInvoiceSeries, FinalPayDate, GivenNumber, InvoiceDate, InvoiceNumber, Project, SupplierName, SupplierNumber, Total och Vouchers. Observera att makuleringsflaggan heter Cancel i listan men Cancelled i den fullständiga formen, precis som hos Fortnox.

Registrera en leverantörsfakturaCopy Anchor Link

curl -X POST https://app.klirr.ai/api/v1/3/supplierinvoices \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"SupplierInvoice":{"SupplierNumber":"1","InvoiceNumber":"F-2026-118","InvoiceDate":"2026-10-01","DueDate":"2026-10-31","VAT":250,"SupplierInvoiceRows":[{"Account":4010,"ItemDescription":"Byggmaterial","Quantity":1,"Price":1000}]}}'

Svar (201), förkortat:

{
  "SupplierInvoice": {
    "@url": "https://app.klirr.ai/api/v1/3/supplierinvoices/42",
    "GivenNumber": "42",
    "SupplierNumber": "1",
    "SupplierName": "Lindqvist Grossist AB",
    "InvoiceNumber": "F-2026-118",
    "InvoiceDate": "2026-10-01",
    "DueDate": "2026-10-31",
    "FinalPayDate": "",
    "Currency": "SEK",
    "CurrencyRate": "1",
    "CurrencyUnit": 1,
    "Total": "1250",
    "VAT": "250",
    "Balance": "0",
    "VATType": "NORMAL",
    "Booked": false,
    "Cancelled": false,
    "Credit": false,
    "PaymentPending": false,
    "AccountingMethod": "ACCRUAL",
    "Vouchers": [],
    "SupplierInvoiceRows": [
      {
        "Account": 4010,
        "ItemDescription": "Byggmaterial",
        "Quantity": 1,
        "Price": 1000,
        "Debit": 1000,
        "DebitCurrency": 1000,
        "Credit": 0,
        "CreditCurrency": 0,
        "Total": 1000,
        "Unit": "",
        "Code": ""
      }
    ]
  }
}

Lista leverantörsfakturorCopy Anchor Link

curl "https://app.klirr.ai/api/v1/3/supplierinvoices?filter=unpaid&suppliernumber=1" \
  -H "Authorization: Bearer <access_token>"

{
  "SupplierInvoices": [
    {
      "@url": "https://app.klirr.ai/api/v1/3/supplierinvoices/42",
      "AuthorizerName": "",
      "Balance": "1250",
      "Booked": true,
      "Cancel": false,
      "CostCenter": "",
      "Credit": false,
      "Currency": "SEK",
      "CurrencyRate": "1",
      "CurrencyUnit": 1,
      "DisablePaymentFile": false,
      "DueDate": "2026-10-31",
      "ExternalInvoiceNumber": "",
      "ExternalInvoiceSeries": "",
      "FinalPayDate": "",
      "GivenNumber": "42",
      "InvoiceDate": "2026-10-01",
      "InvoiceNumber": "F-2026-118",
      "Project": "",
      "SupplierName": "Lindqvist Grossist AB",
      "SupplierNumber": "1",
      "Total": "1250",
      "Vouchers": [{ "Number": 12, "Year": 1, "Series": "L", "ReferenceType": "SUPPLIERINVOICE" }]
    }
  ],
  "MetaInformation": { "@TotalResources": 1, "@TotalPages": 1, "@CurrentPage": 1 }
}

Uppdatera ett utkastCopy Anchor Link

PUT ändrar bara de fält du skickar och fungerar bara på utkast. En bokförd eller makulerad faktura ger 409, eftersom bokförd räkenskapsinformation inte får ändras. Skickar du SupplierInvoiceRows ersätts raderna. Se Fortnox-kompatibilitet.

curl -X PUT https://app.klirr.ai/api/v1/3/supplierinvoices/42 \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"SupplierInvoice":{"DueDate":"2026-11-15"}}'

ÅtgärderCopy Anchor Link

Alla åtgärder är PUT utan kropp och kräver scope supplierinvoice. Ett okänt GivenNumber ger 404 före allt annat.

Bokför (/bookkeep)Copy Anchor Link

Bokför fakturan med en verifikation i serie L: debet kostnadskonto per rad, ingående moms på 2640 och kredit 2440 leverantörsskuld. Svaret är 200 med fakturan som den ser ut efteråt (Booked: true, Balance och Vouchers ifyllda).

Anropet är idempotent: en redan bokförd eller betald faktura svarar 200 med resursen. En makulerad faktura ger 409, liksom ett stängt räkenskapsår eller en låst period. Kroppen ignoreras, så uppdatera med PUT först och bokför sedan.

curl -X PUT https://app.klirr.ai/api/v1/3/supplierinvoices/42/bookkeep \
  -H "Authorization: Bearer <access_token>"

Makulera (/cancel)Copy Anchor Link

Vad som händer beror på fakturans läge:

Kreditera (/credit)Copy Anchor Link

Stöds inte och svarar alltid 400. Klirr har inget kreditflöde och inga negativa rader på leverantörssidan. Vill du backa bokföringen använder du /cancel.

Attest (/approvalbookkeep, /approvalpayment)Copy Anchor Link

Stöds inte och svarar alltid 400. Klirr har inget attestflöde: en leverantörsfaktura går direkt från utkast till bokförd med /bookkeep. /approvalpayment registrerar ingen betalning, och det externa API:et har ingen betalningsresurs för leverantörsfakturor.

FelCopy Anchor Link

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