Autentisering Fortnox

Introduktion

Från och med sommaren 2021 startade Fortnox utfasning av det autentiseringsalternativet som innebär att man arbetar med statiska API-nycklar, dvs API-nycklar man kopierar och klistrar in mellan systemen. Övergången blir i stället till det mer säkrare och användarvänligare alternativet OAuth 2.0. Detta gäller både autentiseringar som initieras från Fortnox Marketplace och direkt inifrån integratörers plattformar. 

Sharespine är kompatibla med nya förutsättningarna i vår integrationsplattform och nedan går vi igenom de olika alternativen och bra saker att känna till.  

Autentiseringsalternativ

När man autentiserar sig via OAuth flow så innebär det att man aldrig manuellt hanterar några API-nycklar eller dylikt. Vid autentiseringstillfället så stannar slutanvändaren i webbläsaren och slussas genom onboardingprocessen för autentisering. 

Vilket av nedanstående alternativ som skall användas beror på om det är första kopplingen mot Fortnox som sätts upp eller om det finns behov av att komplettera med ytterligare kopplingar. 

Start från Fortnox Marketplace

Att utgå ifrån Fortnox Marketplace skall alltid göras för den första kopplingen mot Fortnox som sätts upp.

1. Starta i Fortnox och klicka på ikonen för Marknadsplatsen
2. Klicka sedan på länken Appar 
3. Leta upp den app/integration som gäller för ert e-handelssystem. I exemplet nedan väljs Magento.
4. Aktivera appen genom att klicka på Aktivera
5. Klicka OK
   
6. Är du inte redan inloggad i integrationsplattformen så kommer du till inloggningsformuläret
7. Sedan blir du ombedd att logga in i Fortnox
8. Nästa steg är att godkänna nödvändiga behörigheter för integrationen

Du landar nu i den skapade kopplingen i integrationsplattformen. Allt är nu klart.

Start från Sharespine

Skall ytterligare en koppling mot Fortnox sättas upp så startar du istället inne i integrationsplattformen. Inne på Fortnox connectorn så klickar du Anslut företag för att påbörja autentiseringen direkt via webbläsaren:

Steg 1: Logga in i ditt Fortnox företag (läs här om ni använder Fortnox Bolagshanterare)

Steg 2: Godkänn integrationen

Du kommer nu tillbaka och du har autentiserat din integration mot det specifika Fortnox företaget. Allt är nu klart.  

Viktigt att tänka på 

I det fallet man vill ansluta flera integrationer mot samma Fortnox företag så måste man använda olika Fortnox användare för varje koppling. Gör man inte det kommer föregående koppling sluta fungera när man autentiserar den nya. Så det gäller vara noggrann med vilken eller vilka användare man använder i Fortnox när man autentiserar sig. Så man inte av misstag slår ut en befintlig integration.