Skapa och skicka en faktura

Skapa kundenCopy Anchor Link

Hoppa över steget om kunden redan finns – sök i så fall med GET /3/customers. Enda obligatoriska fältet är Name. Ange Email om fakturan ska mailas. Utan e-postadress svarar /email med 400.

curl -X POST https://app.klirr.ai/api/v1/3/customers \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"Customer":{"Name":"Lundgrens Måleri AB","OrganisationNumber":"556000-0002","Email":"[email protected]","Address1":"Verkstadsgatan 4","ZipCode":"702 10","City":"Örebro"}}'

Svaret är 201 med {"Customer": {...}}. Spara CustomerNumber, det är en sträng.

Skapa fakturautkastetCopy Anchor Link

CustomerNumber är obligatoriskt och kunden måste finnas (annars 404). Varje rad behöver Description, DeliveredQuantity (sträng), Price exklusive moms och VAT i procent. TermsOfPayment är antal dagar; utan det blir förfallodatum 30 dagar efter fakturadatum.

curl -X POST https://app.klirr.ai/api/v1/3/invoices \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"Invoice":{"CustomerNumber":"1002","InvoiceDate":"2026-10-18","TermsOfPayment":"30","Comments":"Avser målning av trapphus, oktober","InvoiceRows":[{"Description":"Målning trapphus","DeliveredQuantity":"24","Price":650,"VAT":25},{"Description":"Material","DeliveredQuantity":"1","Price":3200,"VAT":25}]}}'

Svaret (201, förkortat) visar ett utkast: Booked: false, tomt OCR och VoucherNumber: 0.

{
  "Invoice": {
    "@url": "https://app.klirr.ai/api/v1/3/invoices/57",
    "DocumentNumber": "57",
    "CustomerNumber": "1002",
    "CustomerName": "Lundgrens Måleri AB",
    "InvoiceDate": "2026-10-18",
    "DueDate": "2026-11-17",
    "Net": 18800,
    "TotalVAT": 4700,
    "Total": 23500,
    "Booked": false,
    "Sent": false,
    "Cancelled": false,
    "OCR": "",
    "VoucherNumber": 0
  }
}

Utkastet kan ändras med PUT /3/invoices/{DocumentNumber}. Skickar du InvoiceRows ersätts alla rader, så ta med { "RowId": n } för rader som ska stå kvar. Se Fakturor.

Förhandsgranska (valfritt)Copy Anchor Link

GET /3/invoices/{DocumentNumber}/preview returnerar en PDF märkt UTKAST utan sidoeffekter. Fakturan utfärdas inte.

curl https://app.klirr.ai/api/v1/3/invoices/57/preview \
  -H "Authorization: Bearer <access_token>" \
  -o forhandsgranskning-57.pdf

Använd inte /print för förhandsgranskning: den utfärdar och bokför utkastet.

Utfärda och mailaCopy Anchor Link

GET /3/invoices/{DocumentNumber}/email utfärdar utkastet (nummer, OCR och verifikat) och mailar det till kundens e-postadress i samma anrop. Det är en GET med sidoeffekt, precis som hos Fortnox. Anropet tar ingen kropp.

curl https://app.klirr.ai/api/v1/3/invoices/57/email \
  -H "Authorization: Bearer <access_token>"

Svaret är 200 med {"Invoice": {...}}, läst om efter utskicket: Booked: true, Sent: true och ifyllda OCR, VoucherNumber, VoucherSeries och VoucherYear.

Levererar du fakturan själv i stället? Anropa PUT /3/invoices/{DocumentNumber}/bookkeep (eller /externalprint, som gör samma sak) och hämta PDF:en med /print. Ingenting mailas då.

Hantera omförsökCopy Anchor Link

• /email på en redan bokförd faktura skickar bara mejlet igen. Inget nytt nummer och inget nytt verifikat skapas.
• Misslyckas utskicket av en bokförd faktura blir svaret 502. Fakturan är oförändrad och anropet kan göras om.
• /bookkeep är idempotent och svarar 200 med resursen även om fakturan redan är bokförd.