Digital

Fortnox-integration – koppla affärssystemet till webbshop, offert och CRM

En bra Fortnox-integration tar bort dubbelinmatning mellan försäljning och ekonomi. Här är vilka flöden som brukar kopplas, hur API:et fungerar och vad som brukar gå fel.

I korthet

  • Fortnox API använder OAuth 2.0; äldre fasta nycklar slutade gälla 30 april 2025
  • Gränsen är i genomsnitt 25 anrop per 5 sekunder per integration och företag
  • Överskriden gräns ger felkod 429 och kräver omförsök
  • Fortnox WebSockets ger händelser för fakturor, ordrar, offerter, kunder med mera
  • Missade händelser kan hämtas upp till 14 dagar bakåt
  • E-faktura krävs vid försäljning till offentlig sektor enligt lag (2018:1277)
Innehåll
  1. Vad en integration brukar göra
  2. Bestäm vem som äger vilken data
  3. Så fungerar Fortnox API i korthet
  4. Färdig app eller egen integration?
  5. Exempel: webbshop till Fortnox
  6. Offert och CRM
  7. Så brukar ett integrationsprojekt se ut
  8. Frågor att ställa till den som bygger
  9. Felhantering och övervakning
  10. Säkerhet och personuppgifter
  11. E-faktura till offentlig sektor
  12. Kom igång

Kort svar: Fortnox har ett REST-API som låter andra system skapa och läsa kunder, artiklar, offerter, ordrar, fakturor och betalningar. Sedan den 30 april 2025 sker all åtkomst med OAuth 2.0, där kunden godkänner kopplingen och ni får behörigheter per område. API:et tillåter i genomsnitt 25 anrop per 5 sekunder, alltså 300 per minut, per integration och företag. Det viktigaste beslutet är inte tekniskt utan vilket system som äger vilken information, till exempel om kundregistret ska ligga i CRM:et eller i Fortnox.

Vad en integration brukar göra

FlödeFrånTillNär
Ny kundWebbshop, CRM eller offertverktygFortnox kundregisterNär kunden handlar eller offerten godkänns
Order blir fakturaWebbshopFortnox order eller fakturaNär ordern är betald eller skickad
Offert blir orderOffertverktyg eller eget systemFortnox offert, order eller fakturaNär kunden godkänner
Artiklar och priserFortnoxWebbshopVid ändring eller enligt schema
LagersaldoFortnox eller lagersystemWebbshopVid ändring
Betalning registrerasBetalväxelFortnoxNär utbetalningen kommer
FakturastatusFortnoxCRM eller kundportalNär fakturan betalas eller förfaller

Ingen integration behöver göra allt. Börja med flödet där det i dag skrivs in mest för hand, oftast order till faktura.

Bestäm vem som äger vilken data

Innan något byggs ska ni bestämma vilket system som är "master" för varje typ av information:

  • Kunder: CRM:et om säljarna arbetar där, Fortnox om ekonomin är navet.
  • Artiklar och priser: oftast Fortnox eller ett lagersystem, sällan webbshoppen.
  • Offerter: det verktyg där säljarna arbetar. Fortnox kan ta emot dem som offert eller order.
  • Fakturor och betalningar: alltid bokföringssystemet.

Om två system kan ändra samma uppgift samtidigt uppstår konflikter. Låt därför information flöda åt ett håll per fält, och bestäm vad som händer när en uppgift ändras på fel ställe.

Så fungerar Fortnox API i korthet

  • Behörighet. Integrationen registreras som en app hos Fortnox. Kunden aktiverar den från sitt Fortnox-konto och godkänner vilka områden appen får åtkomst till, till exempel fakturor, kunder eller artiklar. Ni får tokens som används vid anropen och som måste förnyas löpande. De äldre fasta åtkomstnycklarna slutade gälla den 30 april 2025.
  • Gränser. Fortnox tillåter i genomsnitt 25 anrop per 5 sekunder per integration och företag. Överskrids gränsen svarar API:et med felkod 429, och integrationen måste vänta och försöka igen. En webbshop med många ordrar eller en stor artikelsynk måste därför byggas med kö och omförsök.
  • Händelser. I stället för att fråga Fortnox om ändringar hela tiden kan integrationen prenumerera på händelser via Fortnox WebSockets. Det finns ämnen för bland annat fakturor, ordrar, offerter, kunder, artiklar, leverantörsfakturor, verifikationer och lagersaldon. Händelserna säger vad som ändrats men inte allt innehåll, så integrationen hämtar detaljerna via API:et. Missade händelser kan hämtas upp till 14 dagar bakåt.
  • Dubbletter. Händelser levereras minst en gång, vilket betyder att samma händelse kan komma två gånger. Integrationen måste klara det utan att till exempel skapa två fakturor.

Färdig app eller egen integration?

Färdig integration från Fortnox IntegrationerEgenbyggd integration
PassarVanliga plattformar och standardflödenEgna system, ovanliga flöden eller flera system i kedja
StartSnabb, ofta inom en dagVeckor beroende på omfattning
KostnadMånadsavgiftUtveckling plus drift och underhåll
FlexibilitetDet appen stöderDet ni behöver
Ansvar vid felAppleverantörenNi och er utvecklare

Använder ni en vanlig e-handelsplattform finns det ofta en färdig koppling som räcker. Egen integration lönar sig när flödet är specifikt för er, till exempel när offerter skapas i ett eget system eller när flera system ska hänga ihop.

Exempel: webbshop till Fortnox

  1. Kunden betalar i kassan och betalväxeln bekräftar betalningen.
  2. Integrationen letar upp kunden i Fortnox via e-post eller kundnummer, eller skapar en ny.
  3. En order eller faktura skapas med rätt artiklar, momssatser, frakt och rabatter.
  4. När utbetalningen från betalväxeln kommer registreras betalningen, med avgifterna bokförda separat.
  5. Lagersaldot uppdateras i webbshoppen om det styrs från Fortnox.

Detaljerna som brukar ta tid är moms på frakt, rabattkoder som ska fördelas på rader, returer och kreditfakturor, samt avstämning när en betalväxel betalar ut ett samlat belopp för många ordrar minus avgifter.

Offert och CRM

För tjänsteföretag är det ofta offertflödet som ger mest. När kunden godkänner en offert kan en order eller faktura skapas i Fortnox automatiskt, och när fakturan är betald kan statusen synas i CRM:et eller kundportalen. Säljaren slipper fråga ekonomi om kunden har betalat, och ekonomi slipper skriva av offerten.

På fixco.se använder vi ett eget system där förfrågan blir ärende, ärendet blir offert, offerten godkänns av kunden via en länk och blir sedan jobb och faktura. Principen är densamma oavsett bokföringssystem: varje uppgift skrivs in en gång.

Så brukar ett integrationsprojekt se ut

  1. Kartläggning. Vilka flöden, vilka fält, vilket system som äger vad och hur ofta data ändras. Här bestäms också hur moms, frakt, rabatter och kreditfakturor ska hanteras.
  2. Testkonto. Integrationen byggs och testas mot ett Fortnox-konto som inte är ert riktiga bokföringskonto, eller med tydligt avgränsade testdata.
  3. Första flödet. Oftast order till faktura eller offert till order. Det körs parallellt med det manuella arbetet en period så att ekonomi kan jämföra.
  4. Fler flöden. Kundsynk, artiklar, betalningar och status tillbaka till CRM:et läggs till ett i taget.
  5. Överlämning. Dokumentation av vad som synkas, hur fel visas och vem som gör vad när något stoppar.

Låt ekonomiansvarig vara med från början. Det är den personen som vet hur bokföringen ska se ut och som märker först om något blir fel.

Frågor att ställa till den som bygger

  • Vilka flöden ingår, och åt vilket håll går varje fält?
  • Hur hanteras gränsen för antal anrop och tillfälliga fel?
  • Hur undviker integrationen dubbletter om samma händelse kommer två gånger?
  • Var syns fel, och vem får larm?
  • Hur förnyas behörigheten, och vad händer om kunden återkallar den?
  • Ingår underhåll när Fortnox ändrar sitt API?

Felhantering och övervakning

En integration som tyst slutar fungera är värre än ingen integration. Bygg därför in:

  • En logg över varje överförd order, faktura och betalning med status
  • Automatiska omförsök vid tillfälliga fel som 429 eller avbrott
  • Larm till en ansvarig person när något misslyckas flera gånger
  • En daglig eller veckovis avstämning mellan systemen
  • En rutin för när kundens godkännande av integrationen behöver förnyas

Säkerhet och personuppgifter

Tokens till Fortnox ger åtkomst till företagets ekonomi och ska lagras krypterat på servern, aldrig i en app eller webbläsare. Begär bara de behörigheter integrationen behöver. Behandlar integrationen kunduppgifter åt er behövs ett personuppgiftsbiträdesavtal med den som driftar den.

E-faktura till offentlig sektor

Säljer ni till kommuner, regioner eller myndigheter ska fakturorna vara elektroniska enligt lagen (2018:1277) om elektroniska fakturor till följd av offentlig upphandling. Se till att flödet från ert system till Fortnox och vidare till e-faktura fungerar för de kunderna.

Kom igång

Rita först upp flödet från förfrågan eller order till betald faktura och markera var det skrivs in för hand. Det är där integrationen ska börja. Vi bygger system och integrationer och webbshoppar med koppling till bokföringen. Har ni en tydlig bild av flödet kan ni begära offert på ett system.

Vanliga frågor

Det mesta som skapar eller behöver ekonomisk information: webbshoppar, offertverktyg, CRM, kundportaler, tidrapportering och lagersystem. Vanliga flöden är order till faktura, offert till order, kundsynk, artikelsynk och registrering av betalningar.

Källor

Fixco Digital

Skriven av teamet bakom Fixco Digital, som bygger hemsidor, appar och system för företag.