codexier.

Integrationer och CRM

Vad kan man bygga med Fortnox API?

Av CodexierPublicerad 5 min läsning

Fortnox är ekonomisystemet en stor andel svenska småföretag kör, och dess API är skälet till att så många andra verktyg kan prata med det. Har du en webbshop, ett bokningssystem, ett CRM eller ett kalkylblad som slutar i dubbel registrering i Fortnox är API:et sättet det upphör på. Den här guiden förklarar vad det exponerar, mönstren vi bygger oftast och begränsningarna som avgör om en integration är en veckas arbete eller en månads.

Det korta svaret

Fortnox-integrationer är den vanligaste posten i vårt integrations- och automationsarbete, vilket är varför vi kan vara konkreta om var tiden går.

Vad API:et ger åtkomst till

OmrådeObjektTypisk användning
FörsäljningKunder, artiklar, offerter, ordrar, fakturor, inbetalningarSkicka ordrar från en butik eller ett bokningssystem, skapa och skicka fakturor
InköpLeverantörer, leverantörsfakturor, utbetalningarRegistrera inkommande fakturor från ett inläsningsflöde, markera som betalda
BokföringVerifikationer, konton, räkenskapsår, kostnadsställen, projektBokföra poster från lön, betalningar eller lagersystem
FilerBilagor, inkorg, arkivBifoga PDF:en till den verifikation eller faktura den hör till
RegisterdataPrislistor, enheter, valutor, betalningsvillkor, momskoderHålla produkt- och prisdata konsekventa mellan system

Täckningen beror på kundens Fortnox-paket och på vilka behörigheter kunden beviljar; en endpoint som finns är inte alltid tillgänglig för en viss koppling.

Vad API:et inte gör bra: läsa stora huvudböcker effektivt, köra rapporter och allt som ska ske i realtid. Det är byggt för operationer post för post, och integrationer som respekterar det är de som förblir pålitliga.

Vanliga integrationsmönster

Webbshop till Fortnox

Varje betald order blir en kund, artiklar vid behov och en faktura eller order i Fortnox med betalningen matchad. Shopify och WooCommerce har kopplingar; egen kod börjar när ni säljer paket, B2B-villkor eller via flera kanaler.

Bokning eller CRM till fakturering

Ett avslutat jobb eller en bokning skapar ett fakturautkast med rätt kund, artikel och projekt. Tar bort faktureringsmaratonet vid månadsskiftet i tjänsteföretag.

Inläsning av leverantörsfakturor

Ett inläsningsverktyg eller Peppol-flöde registrerar leverantörsfakturor med konteringsförslag och bilagor, klara för attest.

Lön och tid till verifikationer

Timmar från ett tidrapporteringsverktyg blir underlag för lön, och lönebokningarna landar som verifikationer på rätt konton.

Rapporter och dashboards

Nattlig uttag av fakturor och betalningar till en egen datalagring ni kan fråga, eftersom API:et inte är en rapportmotor.

Behörigheter och appregistrering

Fortnox använder OAuth 2.0 med auktoriseringskoder. Du registrerar en integration i utvecklarportalen, anger vilka behörigheter den behöver och får ett klient-ID och en hemlighet. Varje kund som vill använda den loggar in i Fortnox, godkänner behörigheterna, och din integration får tokens för det företaget. Åtkomsttokens går ut och förnyas med en refresh-token, som i sin tur roterar, så integrationen behöver en säker plats att lagra och uppdatera tokens per anslutet företag. Integrationer byggda för ett enda företag går ändå genom samma registrering; det finns ingen permanent API-nyckel längre.

  • Begär minsta möjliga behörigheter. En kund som ombeds bevilja allt tvekar, och en granskning senare frågar varför.
  • Lagra tokens krypterat, per företag, och hantera fallet där en förnyelse misslyckas för att någon återkallat appen.
  • Publicering på appmarknaden kräver granskning av Fortnox; en privat integration för det egna företaget gör det inte.
  • Testa mot ett sandlådeföretag innan du rör riktiga böcker; API:et skapar gladeligen hundra fakturor i produktion.

Begränsningar och felhantering

API:et tillåter ett begränsat antal anrop per sekund per anslutet företag och svarar med en strypning när du överskrider det. Det låter generöst tills en nattlig synk försöker uppdatera varje artikel på en gång. Designa för det: köa arbetet, skicka i jämn takt, gör om strypta anrop efter en paus och ha ett idempotensschema så att en omkörd faktura inte blir en dubblett. Använd filtren för senast ändrad för att hämta bara det som ändrats, och prenumerera på webhooks där Fortnox erbjuder dem så att du reagerar på händelser i stället för att polla efter dem. Logga varje anrop med Fortnox felmeddelande; deras felkoder är specifika och sparar timmar av gissande.

Färdiga appar eller egen lösning

Ni ska inte beställa en egen Fortnox-integration om en app på marknadsplatsen redan gör det ni behöver. För standardfall som webbshop, betalningar, tidrapportering och fakturainläsning finns apparna, kostar en måttlig månadsavgift och underhålls av någon annan när Fortnox ändrar sig. Egen kod är rätt när det andra systemet är ert eget, när reglerna är specifika för hur ni säljer eller projektkodar, när flera system måste stämmas av, eller när ingen app stödjer er plattform. Väljer ni också själva ekonomisystemet kommer vår jämförelse av Fortnox och Visma eEkonomi ur integrationsperspektiv först. Har ni ett konkret dubbelregistreringsproblem, boka ett samtal och beskriv det; fasta priser för integrationsarbete finns på prissidan.

Vanliga frågor

Behöver vi ett utvecklarkonto hos Fortnox för att bygga en integration till vårt eget företag?

Ja. Även en privat integration registreras som en app i Fortnox utvecklarportal och kopplas via OAuth av ert företags Fortnox-användare. Registreringen är kostnadsfri; det ni slipper för en privat integration är granskningen för appmarknaden.

Kan API:et skapa och skicka fakturor, inklusive e-fakturor?

Det kan skapa fakturor och trigga utskick via Fortnox egna kanaler, inklusive e-faktura där kunden nås via Peppol, mejl och utskriftstjänster. Att bokföra fakturan och registrera betalningar är separata anrop, så en integration måste bestämma vem som äger varje steg.

Går det att läsa data för rapporter utan att slå i gränserna?

Ja, om ni hämtar stegvis med filter för senast ändrad och lagrar resultatet själva. Att försöka bygga en live-dashboard direkt på API:et faller på anropsgränser och svarstider; ett nattligt eller timvis uttag till en egen databas är mönstret som fungerar.

Vad händer med integrationen när Fortnox uppdaterar API:et?

Fortnox aviserar ändringar till utvecklare med framförhållning, och de flesta är tillägg. Någon måste läsa de aviseringarna och testa; det är den löpande kostnaden för varje egen integration, och det är därför vi erbjuder ett underhållsalternativ med dem vi bygger.

Knappar ni in samma data i Fortnox två gånger?

Beskriv systemet på andra sidan och posterna som registreras om. På en kvart säger vi om en app på marknadsplatsen täcker det, vad en egen integration skulle innebära och vad det kostar.

Boka ett kostnadsfritt 15-minuterssamtal