Voordat je gegevens kunt uitwisselen via de jortt API, moet je jouw software toegang geven tot je jortt-administratie. Dit proces heet authenticatie.
Authenticatie zorgt ervoor dat jortt weet welke applicatie gegevens opvraagt of wijzigt en voor welke administratie dit mag gebeuren.
Wil je niet zelf een koppeling maken? Dan kun je kiezen voor een standaardoplossing via bijvoorbeeld Webwinkelfacturen. Zij bieden kant-en-klare koppelingen aan die direct werken met jortt. Voor het gebruik betaal je kosten aan hen.
Via de jortt API kun je verschillende processen automatiseren. In dit artikel lees je hoe authenticatie werkt en welke mogelijkheden er zijn.
Wil je zelf of samen met een ontwikkelaar aan de slag? Bekijk de volledige documentatie: developer.jortt.nl.
Authenticatie is nodig voor iedere koppeling die gegevens wil lezen of schrijven in jortt. Bijvoorbeeld wanneer je:
Zonder authenticatie kan een koppeling geen gegevens uitwisselen met jortt.
Jortt ondersteunt twee manieren om een koppeling te authenticeren.
Gebruik deze methode wanneer meerdere jortt-gebruikers jouw koppeling kunnen gebruiken.
Iedere gebruiker geeft zelf toestemming aan de koppeling. Daardoor kan dezelfde applicatie worden gebruikt door meerdere administraties.
Gebruik deze methode wanneer de koppeling alleen toegang nodig heeft tot één administratie.
De koppeling krijgt rechtstreeks toegang tot die administratie. Er is geen toestemmingsscherm nodig voor andere jortt-gebruikers.
Wanneer een koppeling toegang nodig heeft tot jouw administratie, vraagt jortt eerst om toestemming. Je logt in bij jortt en ziet welke rechten de applicatie aanvraagt. Daarna bepaal je zelf of je deze toegang wilt geven.
Pas na jouw toestemming kan de applicatie gegevens lezen of schrijven in jouw administratie. Dit zorgt ervoor dat je controle houdt over welke software toegang heeft tot jouw gegevens.
Een koppeling krijgt alleen toegang tot de onderdelen waarvoor toestemming is gegeven. Voorbeelden van rechten zijn:
Een ontwikkelaar bepaalt vooraf welke rechten nodig zijn voor de koppeling. Tijdens het autoriseren wordt hiervoor toestemming gevraagd.
Voor iedere koppeling zijn identificatiegegevens nodig. Na registratie van een applicatie ontvangt een ontwikkelaar een:
Met deze gegevens kan de koppeling zich identificeren bij jortt en toegang aanvragen.
Nadat een koppeling succesvol is geauthenticeerd, ontvangt deze een access token. Met dit access token kan de koppeling gegevens lezen of wijzigen binnen de toegestane rechten. De koppeling gebruikt dit token bij ieder verzoek aan de jortt API.
Wil je een eigen koppeling bouwen? Dan moet de applicatie eerst worden geregistreerd. Stuur hiervoor een e-mail naar support@jortt.nl.
Bij het registreren van een applicatie geef je onder andere aan:
Na registratie ontvangt de ontwikkelaar de gegevens die nodig zijn om de koppeling in te richten.
Na het instellen van authenticatie kan jouw software veilig gegevens uitwisselen met jortt. Daarmee leg je de basis voor koppelingen met klanten, facturen, boekingen en andere onderdelen van je administratie.