Integrera Fortnox utan kod: steg och felsökning för svenska företag

För att integrera Fortnox aktiverar du integrationen via Fortnox marknadsplats eller registrerar din applikation i Fortnox Developer Portal och kör igenom OAuth2‑flödet. Du behöver rätt administratörsbehörighet, ibland en integrationslicens, och för utvecklare även Client ID, Client secret, redirect URI och korrekt uppsatta scopes. Med dessa tre bitar på plats fungerar kopplingen mot ditt affärssystem eller CRM.
Kort sagt:
- De flesta integrationer kräver ingen kodning och kan aktiveras direkt i Fortnox med rätt administratörsbehörighet.
- OAuth2‑flödet använder en redirect-URI och scopes som måste matcha exakt för att autentiseringen ska lyckas.
- Vid 403- eller 429-fel ska scopes verifieras och backoff-metoder implementeras för att hantera för många anrop.
- Att underhålla en egen API‑koppling för Fortnox kräver kontinuerlig tokenrotering och webbhook‑övervakning, vilket kan vara tidskrävande.
- En integrerad lösning minskar fel och underhåll genom att samla order, fakturering och kunddata i samma system.
Innehållsförteckning
- Steg för steg: aktivera en integration via Fortnox marknadsplats
- Vilka tekniska krav gäller för Fortnox API-integration?
- Hur fungerar de vanligaste integrationsscenarierna?
- Vad kostar det att integrera Fortnox?
- Hur felsöker du 403- och 429-fel i Fortnox API?
- SeeRMs perspektiv: varför ett integrerat affärssystem minskar underhåll och fel
- Fortnox-integration utan att bygga allt själv
- Källor
Steg för steg: aktivera en integration via Fortnox marknadsplats
De flesta integrationer kräver ingen kodning alls. Du hittar dem direkt i kontot om du har administratörsroll.
Så aktiverar du en integration som systemadministratör:
- Logga in i Fortnox och gå till Administrera integrationer.
- Klicka på Beställ fler licenser och öppna marknadsplatsen.
- Sök upp integrationen du vill koppla och läs om den kräver köp eller bara aktivering.
- Klicka Aktivera för fristående kopplingar eller Köp för sådana som debiteras separat.
- Bekräfta ansvarig användare och behörigheter för integrationen.
Skillnaden mellan de två knapparna spelar roll. ”Köp hos Fortnox” innebär att avgiften läggs på din ordinarie Fortnox‑faktura utan att du behöver teckna en separat integrationslicens, enligt Fortnox egen beskrivning av köpbara integrationer. Vanliga integrationer som bygger på öppna API‑anrop kräver i stället att integrationslicensen är aktiverad på kontot.
Är du inte administratör själv? Då går du via Köp & Aktivera i huvudmenyn och vidare till Utforska Integrationer, som visar samma marknadsplats i ett annat gränssnitt. Efter aktivering visas integrationen i listan under Administrera integrationer, där du ser ansvarig användare, vilka behörigheter den fått och en knapp för att bryta kopplingen om du byter leverantör. En del tredjepartsintegrationer hanteras dock helt utanför marknadsplatsen, och då kontaktar du leverantören direkt istället för att söka i Fortnox.
Vilka tekniska krav gäller för Fortnox API-integration?
Ska du bygga en egen koppling, till exempel för en fortnox integration crm eller ett ordersystem, börjar allt i Fortnox Developer Portal. Du skapar ett utvecklarkonto, registrerar din app och anger en redirect URI som exakt matchar den URL Fortnox ska skicka tillbaka autentiseringskoden till. Enligt Fivetrans installationsguide för Fortnox fastnar många integrationer redan här, eftersom en felaktig redirect URI ger ett generiskt avslag utan tydlig felbeskrivning.
Fortnox bygger sin API koppling fortnox‑autentisering på OAuth 2.0 Authorization Code Flow. Flödet fungerar i korthet så här:
- Din app skickar användaren till Fortnox inloggningssida med scopes, redirect URI och en state‑parameter som skydd mot förfalskade anrop.
- Användaren loggar in och godkänner de behörigheter appen begär.
- Fortnox skickar en auktoriseringskod tillbaka, giltig en kort stund, som du byter mot access token och refresh token.
- Access token gäller ungefär en timme innan den måste förnyas med refresh token.
Refresh token roteras löpande, ofta med en giltighetstid på runt 45 dagar, vilket betyder att du måste lagra den säkert och bygga in automatisk förnyelse i din integration. Ett vanligt misstag är att glömma att scopes i Fortnox API är allt‑eller‑inget per resurs: begär du skrivbehörighet till en modul får appen den fullt ut, även om du bara tänkt läsa data.
Proffstips: Skriv exakt vilka scopes appen begär i samtyckestexten användaren möter vid inloggning. Otydlig text är den vanligaste orsaken till att administratörer nekar behörigheter, vilket i sin tur ger 403‑fel senare i flödet.
Ett annat mönster att planera för: många list‑endpoints i Fortnox API returnerar bara summerad information, och du behöver ett extra GET‑anrop för att hämta det fullständiga objektet. Det dubblar i praktiken antalet anrop för vissa synkjobb. Kombinerat med Fortnox rate limit på 25 anrop per 5 sekunder blir batchning och kösystem inte valfritt utan en nödvändig del av arkitekturen redan från start.
Hur fungerar de vanligaste integrationsscenarierna?
De flesta fortnox integration erp‑projekt löser ett av ett fåtal återkommande behov, och lösningen ser olika ut beroende på flödet.
- E‑handel till fakturaflöde: skapa kunden i Fortnox innan fakturan skapas, annars riskerar du dubbletter. Matcha på organisationsnummer eller e‑post, inte bara namn.
- Artikel‑ och lagersynk: synka SKU, pris och lagersaldo mot ordersystemet i takt, gärna via schemalagd batch snarare än enskilda anrop per rad.
- Leverantörsfakturor: skicka med korrekt konteringsinformation redan vid skapande, och bygg en separat process som matchar inkommande betalningar mot fakturanumret.
- Persondata och löneflöden: kontrollera vilka fält som är låsta för automatisk skrivning innan du bygger en helt automatiserad process, särskilt vid känsliga personuppgifter.
Rekommenderad arkitektur kombinerar webhooks för händelser Fortnox stödjer med en fallback‑poller för objekt som saknar webhook‑stöd. Bygger du skrivoperationer idempotent, det vill säga att samma anrop aldrig skapar dubbletter oavsett hur många gånger det körs, undviker du de flesta race conditions som uppstår när flera system skriver mot samma kundpost samtidigt.
Vad kostar det att integrera Fortnox?
Kostnadsbilden styrs av två separata modeller som lätt blandas ihop.
En integrationslicens öppnar hela ditt Fortnox‑abonnemang för API‑åtkomst och läggs bara till en gång på kontot, oavsett hur många egna eller tredjeparts kopplingar du sedan bygger ovanpå den. En köpbar integration debiteras i stället direkt via din ordinarie Fortnox‑faktura och kräver ingen separat licens, enligt Fortnox egna villkor för köp av integration.
Innan du väljer väg, gå igenom denna checklista med leverantören:
- Behöver du integrationslicens, eller ingår allt i priset för den köpbara integrationen?
- Vad kostar leverantörens egen prenumeration eller startavgift?
- Finns testföretag eller sandbox för att verifiera flödet innan skarp drift?
- Vilken supportnivå ingår om synken fallerar en fredag eftermiddag?
Hur felsöker du 403- och 429-fel i Fortnox API?
De flesta driftstopp handlar om ett av två klassiska HTTP‑fel, och båda går att lösa systematiskt.
- 403 Forbidden: kontrollera att appens begärda scopes matchar exakt det administratören godkänt, och att den inloggade användaren faktiskt har adminroll i Fortnox.
- 429 Too Many Requests: din integration slår i taket på 25 anrop per 5 sekunder. Bygg exponentiell backoff och batcha anrop istället för att skicka dem i en tät loop.
- Datasynkfel mellan objekt: respektera ordningen, skapa alltid kunden före fakturan och artikeln före orderraden, annars misslyckas det andra anropet i kedjan.
- Tomma luckor i webhook‑flödet: komplettera med schemalagd polling för de objektstyper Fortnox inte skickar webhooks för, och gör skrivningarna idempotenta så att ett dubbelanrop aldrig skapar två fakturor.
Proffstips: Kör alltid mot ett Fortnox testföretag under utveckling. Det känns långsammare i början, men du undviker att en bugg i din retry‑logik skapar tio dubblettfakturor i produktionsmiljön samma dag du går live.
SeeRMs perspektiv: varför ett integrerat affärssystem minskar underhåll och fel

Vår erfarenhet från att bygga koppla Fortnox med andra system åt växande företag är att den tekniska integrationen sällan är det svåra. Det som slukar tid är underhållet: token som måste rotera, webhooks som tystnar, och tre olika verktyg som alla tror de äger ”sanningen” om en kund.
När fältarbete, order och fakturering redan ligger i samma system minskar antalet ställen där data kan glida isär. En tekniker avslutar ett jobb i mobilappen, ordern uppdateras automatiskt, och fakturan går vidare mot Fortnox utan att någon matchar kundnummer manuellt. Det är samma princip som våra tidigare texter om integrationer i affärssystem lyfter: färre fristående kopplingar betyder färre punkter där något kan gå fel klockan fem en fredag.
— SeeRM
Fortnox-integration utan att bygga allt själv
Att bygga och underhålla en egen fortnox integration api‑koppling kräver löpande arbete med tokenrotering, rate limits och webhook‑övervakning, tid de flesta små och medelstora företag hellre lägger på kunder än på kod. Seerm löser samma behov från insidan: orderhantering, fältappar för teknikerna och automatiserade arbetsflöden ligger redan i samma plattform, och Fortnox‑kopplingen sköter fakturering och kundregister utan att du behöver koda ett enda OAuth‑flöde själv.

Vår support hjälper dig genom hela uppsättningen, från att aktivera integrationen till att verifiera att kundnummer och fakturarader stämmer mot Fortnox. Vill du se hur orderhantering med automatisk fakturakoppling fungerar i praktiken, boka en genomgång av ditt Seerm-konto och få hela flödet, från order till bokförd faktura, uppsatt tillsammans med oss.