Fortnox koppelen aan APIcenter

Je koppelt Fortnox aan APIcenter door in te loggen bij Fortnox en toestemming te geven. Je doet dit één keer. Daarna gebruik je Fortnox in al je integraties.

Wat je nodig hebt

• Een Fortnox-account.
• Een Fortnox-licentie die past bij de onderdelen die je wilt gebruiken. Fortnox geeft alleen toegang tot een onderdeel als het bedrijf daar een licentie voor heeft. Voor klanten, facturen en artikelen is dat een licentie voor Kundfaktura of Order, voor orders de licentie Order en voor boekingen, rekeningen en boekjaren Bokföring of Kundfaktura. Het overzicht staat in de uitleg over scopes van Fortnox.
• Een Fortnox-gebruiker die de koppeling mag activeren. Heeft de gebruiker te weinig rechten, laat dan een gebruiker met de juiste rechten de koppeling activeren. Een boekhouder die via een digitaal kantoor inlogt, moet de koppeling ook activeren via digital byrå.

Hoe Fortnox toegang geeft

Fortnox gebruikt voor koppelingen OAuth 2.0: een gebruiker logt in bij Fortnox en geeft in Fortnox zelf toestemming voor de onderdelen waar de koppeling bij mag. Fortnox noemt die onderdelen scopes. Alle scopes geven lees- en schrijftoegang tot dat onderdeel.

Fortnox geeft de koppeling een toegangssleutel die één uur geldig is en een vernieuwsleutel die 45 dagen geldig is. Is de vernieuwsleutel verlopen of ongeldig geworden, dan moet je de koppeling opnieuw activeren. Dat staat in de uitleg van Fortnox over autorisatie.

Zo koppel je Fortnox

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Fortnox.
2. Volg de stappen die APIcenter voor Fortnox toont. Fortnox vraagt je in te loggen en toestemming te geven.
3. Sla de verbinding op.
4. Klik op Testverbinding. Zie je "Verbinding is goed!", dan is Fortnox klaar voor gebruik.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Als het niet lukt

Fortnox geeft bij een fout een foutcode terug. Die zie je in de activiteit.

• 2000310 of 2000311: de toegangssleutel ontbreekt of is onjuist. Zie Verbinding of inloggen mislukt.
• 2001103: het Fortnox-account heeft geen licentie voor de API.
• 2001101: er is geen actieve licentie voor het onderdeel dat nodig is.
• 2000663: de koppeling heeft geen toegang tot dat onderdeel (scope).

De oplossingen staan in Fortnox: veelvoorkomende fouten.

Volgende stappen

Maak een integratie met Fortnox en controleer de instellingen. Zie Fortnox verbindings- en integratie-instellingen.

Meer informatie van Fortnox zelf staat in de documentatie voor ontwikkelaars van Fortnox.