Inbetalningar

Inbetalningsresursen speglar Fortnox /3/invoicepayments. En betalning registreras mot en faktura och bokförs direkt – det finns ingen obokförd betalning i Klirr. Betalningen adresseras på sitt publika nummer (Number).

Scope: invoice · Kräver AI Pro

EndpointsCopy Anchor Link

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

ListparametrarCopy Anchor Link

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

Återförda betalningar visas aldrig i listan.

FältCopy Anchor Link

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

Booked, VoucherNumber, VoucherSeries och VoucherYear ignoreras om de skickas vid POST. Fält som Klirr inte modellerar sparas och returneras oförändrade.

ListformCopy Anchor Link

GET /3/invoicepayments returnerar: @url, Number, InvoiceNumber, Amount, PaymentDate, Currency, CurrencyRate, AmountCurrency, InvoiceCustomerName, InvoiceCustomerNumber, InvoiceTotal, ModeOfPaymentAccount, VoucherNumber, VoucherSeries, VoucherYear. Belopp och nummer är strängar i listformen – utom InvoiceNumber, som är ett tal i båda formerna.

Belopp och valutaCopy Anchor Link

Klirr följer Fortnox definition: Amount är kronor och AmountCurrency är beloppet i fakturans valuta.

• Kronfaktura: Amount är betalningens belopp. AmountCurrency behövs inte.
• Faktura i utländsk valuta: AmountCurrency är obligatoriskt (och får inte vara 0). Amount är valfritt och anger kronorna som faktiskt kom in på kontot. Utan Amount och CurrencyRate används Riksbankens kurs för betalningsdagen, och kursdifferensen mot fordran bokförs.
• Ett belopp som inte går att tolka (t.ex. "1 500 kr") ger 400 – det tolkas aldrig som "hela beloppet".

DelbetalningCopy Anchor Link

Utelämnas beloppet regleras hela det öppna beloppet. Ett lägre belopp ger en delbetalning; fakturan står då kvar som obetald och Balance på fakturan visar återstoden.

• Beloppet måste vara större än noll och får inte överstiga fakturans öppna belopp – Klirr har ingen modell för överbetalning (400).
• Fakturan måste vara bokförd och obetald (skickad eller förfallen), annars 400. En avskriven kundförlust ger 409.
• En förskottsfaktura kan inte delbetalas (400).
• Organisationer som använder kontantmetoden kan inte delbetala ännu (400) – registrera hela beloppet eller kreditera mellanskillnaden.
• WriteOffs (öres- och kursdifferenser) stöds inte och ger 400.
• Är det öppna beloppet redan noll (fakturan är utkvittad av krediteringar) svarar API:t 409; fakturan markeras då som betald.

Registrera en betalningCopy Anchor Link

curl -X POST https://app.klirr.ai/api/v1/3/invoicepayments \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"InvoicePayment":{"InvoiceNumber":42,"Amount":5000,"PaymentDate":"2026-10-15","ModeOfPayment":"BG"}}'

Svar (201):

{
  "InvoicePayment": {
    "@url": "https://app.klirr.ai/api/v1/3/invoicepayments/7",
    "Number": "7",
    "InvoiceNumber": 42,
    "Amount": 5000,
    "PaymentDate": "2026-10-15",
    "ModeOfPaymentAccount": 1930,
    "ModeOfPayment": "BG",
    "Booked": true,
    "InvoiceCustomerName": "Bergström Bygg AB",
    "InvoiceCustomerNumber": "1001",
    "InvoiceDueDate": "2026-11-17",
    "InvoiceOCR": "4200007",
    "InvoiceTotal": 11875,
    "Currency": "SEK",
    "CurrencyRate": 1,
    "CurrencyUnit": 1,
    "AmountCurrency": 5000,
    "VoucherNumber": 18,
    "VoucherSeries": "C",
    "VoucherYear": 1,
    "Source": "manual"
  }
}

Lista betalningarCopy Anchor Link

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

{
  "InvoicePayments": [
    {
      "@url": "https://app.klirr.ai/api/v1/3/invoicepayments/7",
      "Number": "7",
      "InvoiceNumber": 42,
      "Amount": "5000",
      "PaymentDate": "2026-10-15",
      "Currency": "SEK",
      "CurrencyRate": "1",
      "AmountCurrency": "5000",
      "InvoiceCustomerName": "Bergström Bygg AB",
      "InvoiceCustomerNumber": "1001",
      "InvoiceTotal": "11875",
      "ModeOfPaymentAccount": "1930",
      "VoucherNumber": "18",
      "VoucherSeries": "C",
      "VoucherYear": "1"
    }
  ],
  "MetaInformation": { "@TotalResources": 1, "@TotalPages": 1, "@CurrentPage": 1 }
}

Uppdatera en betalningCopy Anchor Link

Belopp, datum och konto är bokförda och kan inte ändras (bokföringslagen 5 kap. 5 §). PUT ändrar bara de fria fälten, som ModeOfPayment och Source, och lägger till dem utan att ersätta tidigare lagrade fält. Skickar du tillbaka belopp, datum eller konto oförändrade (t.ex. ditt eget GET-svar) går anropet igenom; ett ändrat värde ger 409. Vill du rätta beloppet: återför betalningen med DELETE och registrera en ny.

curl -X PUT https://app.klirr.ai/api/v1/3/invoicepayments/7 \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"InvoicePayment":{"ModeOfPayment":"SWISH"}}'

Återföra en betalningCopy Anchor Link

DELETE raderar inte betalningen. Klirr bokför ett rättelseverifikat (BFNAR 2013:2 p. 2.17), markerar betalningen som återförd och öppnar fakturans saldo igen. Svaret är 204, och betalningen försvinner ur GET /3/invoicepayments. Ett nytt DELETE eller GET på samma nummer ger 404. Numret återanvänds aldrig.

curl -X DELETE https://app.klirr.ai/api/v1/3/invoicepayments/7 \
  -H "Authorization: Bearer <access_token>"

bookkeepCopy Anchor Link

PUT /3/invoicepayments/{Number}/bookkeep gör ingenting i Klirr, eftersom betalningen bokfördes redan när den registrerades. Endpointen finns för att Fortnox-integrationer som anropar den ska fungera, och svarar 200 med {"InvoicePayment": {...}}.

FelCopy Anchor Link

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