Fortnox API är det REST-API som låter andra system läsa och skriva data i ett Fortnox-företag: kunder, fakturor, artiklar, ordrar, betalningar och bokföring. Det är grunden för alla integrationer mot Fortnox, från webbshoppar och betallösningar till rapportverktyg och AI-agenter.
Den här guiden är skriven för utvecklare och byråer som ska bygga mot Fortnox. Vi går igenom vad API:t täcker, hur du kommer åt det, hur autentisering och gränser fungerar, de vanligaste fallgroparna, och tre sätt att arbeta med API:t.
Fortnox API i korthet: REST-API på
https://api.fortnox.se/3/. Autentisering med OAuth2 (Authorization Code Flow). Access token gäller i 1 timme, refresh token i 45 dagar. Gräns på 25 anrop per 5 sekunder (300 per minut) per integration och Fortnox-företag. Du skapar din integration i Fortnox Developer Portal.
Vad kan du göra med Fortnox API?
API:t täcker det mesta i Fortnox. Vilka delar en integration når styrs av vilka scopes den har och vilka moduler kundens Fortnox-företag har.
| Område | Exempel på vad du kan göra |
|---|---|
| Kunder och leverantörer | Söka, skapa och uppdatera kunder och leverantörer |
| Kundfakturor och betalningar | Skapa, bokföra, kreditera och skicka fakturor, registrera inbetalningar |
| Ordrar och offerter | Skapa ordrar och offerter och göra om dem till fakturor |
| Artiklar och priser | Hämta och uppdatera artiklar, prislistor och priser |
| Leverantörsfakturor | Läsa leverantörsfakturor och registrera utbetalningar |
| Bokföring | Konton, verifikationer, räkenskapsår, kostnadsställen och projekt |
| Lager | Lagersaldon och lagerhändelser, om kunden har lagermodulen |
Så kommer du igång med Fortnox API
- Registrera dig i Fortnox Developer Portal. Där skapar och hanterar du dina integrationer.
- Skapa en integration. Ange namn, välj de scopes integrationen behöver och ange en redirect URI. Du får ett Client-Id och ett Client-Secret.
- Testa i en testmiljö. I Developer Portal kan du skapa testföretag, så att du inte behöver testa mot riktig bokföring.
- Låt kunden aktivera integrationen. Kunden loggar in i Fortnox, ser vilka behörigheter integrationen ber om och godkänner. Du får en authorization code tillbaka till din redirect URI.
- Byt koden mot tokens och börja anropa API:t. Med access token anropar du till exempel
GET https://api.fortnox.se/3/companyinformation.
Autentisering: OAuth2 i Fortnox
Fortnox använder OAuth2 med Authorization Code Flow. Client-Id, Client-Secret och authorization code används bara när kopplingen till ett kundföretag skapas. Därefter arbetar du med tokens:
- Access token gäller i 1 timme och skickas som Bearer-token i varje anrop.
- Refresh token gäller i 45 dagar och används för att hämta en ny access token. Varje gång du gör det får du också en ny refresh token, och den gamla slutar fungera. Spara alltid den nya direkt.
- Om refresh token hinner gå ut måste kunden aktivera integrationen igen.
Det äldre sättet med en fast access token har fasats ut, så nya integrationer ska bygga på OAuth2. För integrationer som ska agera för hela företaget snarare än en enskild användare finns även tjänstekonton, som aktiveras av en administratör.
Scopes
Scopes avgränsar vilka delar av kundens Fortnox integrationen når, till exempel invoice, customer, article eller bookkeeping. Be bara om de scopes du verkligen behöver.
Tänk på en sak innan du går live: om du ändrar scopes på en integration gäller det inte kunder som redan har aktiverat den. De behåller sina gamla scopes tills de aktiverar integrationen igen.
Rate limits i Fortnox API
Fortnox tillåter 300 anrop per minut per integration och Fortnox-företag, mätt i ett glidande fönster på 5 sekunder. I praktiken betyder det 25 anrop per 5 sekunder. Går du över gränsen svarar API:t med HTTP 429 (Too Many Requests).
Gränsen gäller per access token, inte per IP-adress. Har din integration fem kunder har du alltså 300 anrop per minut för varje kund.
Så håller du dig under gränsen:
- Hantera 429 med väntetid och nytt försök, i stället för att göra om anropet direkt
- Hämta listor sida för sida med många poster per sida, i stället för en post i taget
- Cachea det som sällan ändras, som kontoplan, momskoder och betalvillkor
- Sprid ut stora importer över tid
Vanliga fallgropar när du bygger mot Fortnox
De flesta problem i Fortnox-integrationer handlar inte om API:t utan om hur kundens Fortnox är inställt. Det här ser vi oftast:
- Momskonton och momssatser. En order med en momssats som saknar konto i Fortnox går inte att bokföra. Kontrollera kundens momsinställningar, särskilt vid försäljning till andra EU-länder.
- OSS-konton. Säljer kunden till konsumenter i andra EU-länder behöver försäljning och moms per land rätt konton.
- Låsta perioder. I en låst period går det inte att bokföra. Planera för vad som ska hända med transaktioner som kommer in sent.
- Betalsätt och konton. Varje betalsätt i webbshoppen behöver motsvarande betalsätt och konto i Fortnox.
- Kunder och artiklar som skapas två gånger. Bestäm hur du matchar mot befintliga kunder och artiklar innan du skapar nya.
- Kundens licens. Kundens Fortnox-paket behöver inkludera integrationer, annars kan integrationen inte anslutas.
I guiden Fortnox-inställningar innan integration går vi igenom inställningarna steg för steg.
Tre sätt att arbeta med Fortnox API
| Bygga själv | Integrationsplattform | Via AI med Fortnox MCP | |
|---|---|---|---|
| Passar för | En unik integration med eget beteende | Vanliga flöden, som webbshop och betallösning till Fortnox | Frågor, analys och enstaka uppgifter |
| Du hanterar | OAuth2, tokens, rate limits, mappning, fel och underhåll | Inställningar och mappning | Frågan, och vilka behörigheter AI:n får |
| Tid till första resultat | Veckor | Dagar | Minuter |
1. Bygga själv
Du skapar integrationen i Developer Portal och sköter allt själv: autentisering, tokens, gränser, mappning, felhantering och uppdateringar när API:t ändras. Rätt val när integrationen är kärnan i din produkt.
2. Integrationsplattform
För vanliga e-handelsflöden, som ordrar, utbetalningar, returer och lager mellan webbshop, betallösning och Fortnox, finns färdiga integrationer. Junipeer har färdiga kopplingar mellan Fortnox och system som Shopify, WooCommerce, Magento, Klarna, Svea och Walley. Se Fortnox-integrationer.
3. Via AI med Fortnox MCP
Med Fortnox MCP kan en AI-agent, som Claude Code, Cursor, Claude eller ChatGPT, använda Fortnox API genom Junipeer. Agenten kan till exempel läsa en kunds kontoplan och momskoder innan du bygger, eller kontrollera vilka fält en faktura har. Du hanterar inga Client-Secrets eller tokens själv: de stannar hos Junipeer. Fortnox MCP kostar 39 €/mån plus 2 € per 1 000 anrop. Läs mer om Fortnox MCP.
Kommandona för Claude Code, Codex, Cursor, Gemini CLI och VS Code hittar du i MCP för utvecklarverktyg.