Fortnox API: så kopplar du Fortnox mot andra system

Kort svar: Fortnox API är det gränssnitt som låter andra system läsa och skriva data i Fortnox, till exempel kunder, artiklar, order, fakturor och verifikationer. Du kan koppla Fortnox till andra system på tre sätt: med en färdig integration från Fortnox egen marknadsplats, med ett kopplingsverktyg som Make eller Zapier, eller med en egen integration byggd direkt mot API:et. Oavsett väg behöver Fortnox-kunden en integrationslicens.

Vad är Fortnox API?

Fortnox används av över en halv miljon svenska företag, enligt Fortnox själva (Fortnox). API:et är dörren in. Det gör att din webshop, ditt CRM eller ditt betalsystem kan skapa fakturor, uppdatera kunder och hämta bokföringsdata utan att någon skriver in samma sak två gånger.

Tekniskt är det ett REST-API som pratar JSON. Alla anrop går till adresser som börjar med api.fortnox.se/3/ följt av resursen, till exempel invoices för fakturor (Fortnox Developer).

Vad kan man koppla?

API:et är uppdelat i behörigheter, så kallade scopes, som styr vilka delar av Fortnox en integration får komma åt (Fortnox Developer). De vanligaste:

Vissa delar kräver att kunden har rätt licens i Fortnox. Bokföring kräver till exempel licensen Bokföring eller Kundfaktura, lager kräver Lager och lön kräver Lön (Fortnox Developer).

Tre sätt att koppla Fortnox

1. Färdig integration

Fortnox marknadsplats har över 500 integrationer, varav drygt 200 för e-handel och över 100 för betalningar. Där finns bland annat Shopify, WooCommerce, Stripe, PayPal och Zettle (Fortnox). Det är det snabbaste och billigaste sättet när flödet är standard, till exempel att order från en Shopify-butik ska bli fakturor.

2. Kopplingsverktyg

Make har en officiell Fortnox-app med 47 moduler för att skapa och hämta data (Make). Zapier har en Fortnox-app som kan starta flöden när en kund skapas, en faktura bokförs eller betalas eller en ny order kommer in (Zapier). Det passar när du vill koppla ihop flera system utan att skriva kod och flödena är ganska enkla.

3. Egen integration

En egen integration byggs direkt mot API:et efter era regler. Det lönar sig när flödet är unikt, när många system ska vara med eller när de färdiga lösningarna inte hanterar era undantag, som kundspecifika priser, flera lager eller särskilda momsregler.

Läs mer om hur vi bygger Fortnox-integrationer och kopplar ihop andra system med systemintegration.

Vad kostar det?

För att använda integrationer behöver Fortnox-kunden en integrationslicens. Den kostar 189 kronor i månaden och gäller oavsett hur många integrationer du har (Fortnox). Till det kommer kostnaden för själva integrationen: en månadsavgift för en färdig app eller ett kopplingsverktyg, eller utvecklingstid för en egen lösning.

För den som bygger integrationer finns en utvecklarlicens och upp till 30 testmiljöer samtidigt (Fortnox Developer). Integrationer som säljs via Fortnox marknadsplats delar intäkterna med 75 procent till utvecklaren och 25 procent till Fortnox (Fortnox Developer).

Så fungerar API:et tekniskt

Det här avsnittet är för den som ska bygga eller beställa en integration.

Inloggning med OAuth 2.0

Kunden godkänner integrationen med sitt vanliga Fortnox-konto och väljer vilka behörigheter den får. Integrationen får då en åtkomstnyckel som gäller i en timme och en förnyelsenyckel som gäller i 45 dagar. Varje förnyelse ger en ny förnyelsenyckel, och den gamla slutar fungera (Fortnox Developer). Den äldre inloggningen med fasta nycklar fick inte användas efter 30 april 2025 (Fortnox Developer).

Ett anrop som hämtar fakturor ser ut så här:

GET https://api.fortnox.se/3/invoices?limit=100&page=1
Authorization: Bearer <åtkomstnyckel>
Accept: application/json

Gränser

Gränsen är 300 anrop per minut per integration och kund, mätt i ett glidande fönster på fem sekunder, alltså ungefär 25 anrop var femte sekund. Går du över får du felkoden 429 (Fortnox Developer). Listor hämtas sidvis med högst 500 poster per sida (Fortnox Developer).

Händelser i realtid

I stället för att fråga Fortnox om ändringar hela tiden kan integrationen lyssna på händelser via WebSocket, till exempel när en faktura, kund eller order skapas eller ändras. Händelsen innehåller bara vad som hänt, och integrationen hämtar sedan hela posten via API:et. Samma händelse kan komma mer än en gång, och missade händelser kan hämtas upp till 14 dagar bakåt (Fortnox Developer).

Säkerhet

Trafiken krypteras med TLS (Fortnox). Ge integrationen så få behörigheter som möjligt, spara nycklarna krypterat och logga varje synk så att det går att följa vad som hänt.

Vanliga fallgropar

• Dubbletter. Samma order skickas två gånger och blir två fakturor. Bygg så att samma händelse kan hanteras flera gånger utan att något dubbleras.
• Glömda förnyelsenycklar. Används integrationen inte på 45 dagar slutar förnyelsenyckeln gälla och kunden måste godkänna den igen.
• Toppar i trafiken. En kampanj ger hundratals order på en timme. Lägg anropen i kö så att gränsen inte slår i taket.
• Moms och konton. Fel konto eller momssats i kopplingen ger fel i bokföringen. Låt ekonomiansvarig godkänna kontoplanen innan ni går live.
• Ingen äger flödet. Bestäm vem som får larmet när en synk misslyckas.