Jortt koppelen aan APIcenter

Je koppelt Jortt aan APIcenter door in te loggen bij Jortt en APIcenter toestemming te geven. Je hoeft zelf geen client ID, client secret of API-sleutel aan te maken. Je doet dit één keer. Daarna gebruik je Jortt in al je integraties.

Wat je nodig hebt

• Een Jortt-account met jortt MKB of jortt Plus. De API-koppeling van Jortt zit niet in jortt Starter en jortt ZZP. Tijdens je proefperiode werkt hij wel, zodat je de koppeling kunt testen.
• Een Jortt-gebruiker die klanten en facturen mag bekijken en aanmaken. Ontbreken er rechten, dan kan een beheerder van de administratie ze per module geven bij Instellingen > Gebruikers in Jortt.

Welke toegang APIcenter vraagt

Als je toestemming geeft, vraagt APIcenter in Jortt om deze rechten:

• Klanten bekijken
• Klanten aanmaken, wijzigen en verwijderen
• Facturen bekijken
• Facturen aanmaken en versturen
• Administratie gegevens en instellingen bekijken

Je geeft deze toestemming in Jortt zelf, na het inloggen. APIcenter krijgt geen andere rechten, bijvoorbeeld niet voor je salarisadministratie.

Zo koppel je Jortt

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Jortt.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je administratie, en klik op Opslaan.
3. Klik op Autoriseren, log in bij Jortt in het venster dat opent en geef toestemming voor de rechten hierboven.
4. Klik op Testverbinding. Zie je "Verbinding is goed!", dan is Jortt klaar voor gebruik.

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

Toegang bekijken of intrekken in Jortt

In Jortt zie je welke applicaties toegang hebben en met welke rechten. Ga naar Instellingen linksonder in het hoofdmenu, kies onder Koppelingen voor Jortt API-koppeling en open API-koppeling met softwareleveranciers. Daar kun je ook de toegang van een applicatie intrekken. Doe je dat voor APIcenter, dan werkt de koppeling niet meer tot je opnieuw op Autoriseren klikt.

Als het niet lukt

Jortt geeft bij een fout een vaste sleutel terug. Die zie je in de activiteit en in de foutmelding van de test.

• organization.requires_mkb_plan: je Jortt-administratie heeft geen jortt MKB of jortt Plus. Upgrade je abonnement in Jortt.
• scopes.insufficient: APIcenter mist een recht. Klik opnieuw op Autoriseren en geef alle rechten.
• access_token.revoked: de toegang is in Jortt ingetrokken. Klik opnieuw op Autoriseren.
• permissions.insufficient: de Jortt-gebruiker waarmee je hebt ingelogd heeft in Jortt te weinig rechten. Laat een beheerder ze geven bij Instellingen > Gebruikers.
• request.throttled: Jortt staat maximaal 10 verzoeken per seconde toe. Wacht even en probeer het opnieuw.

Volgende stappen

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

Meer informatie van Jortt zelf staat op De Jortt API en koppelingen.