De jortt API en koppelingen bouwen
Een API is een vaste ingang waarlangs software met jortt praat. Voor software-ontwikkelaars is er een jortt API beschikbaar waarmee je je eigen applicatie aan jortt koppelt. De volledige documentatie staat op developer.jortt.nl. Wat je allemaal met jortt kunt koppelen, en waarom, staat in het API-center.
Wat je met de API doet
Met de API zet software gegevens in jortt, of haalt ze eruit, zonder dat iemand iets overtypt. Een paar voorbeelden:
| Je hebt | Wat de koppeling doet |
|---|---|
| een webshop of kassa | maakt van elke bestelling een factuur in jortt, en verstuurt hem als je dat wilt |
| een urenregistratie of werkbonnenapp | zet de gewerkte uren of de werkbon als factuurregels in jortt |
| een salarisprogramma | zet de loonjournaalposten van elke maand in jortt |
| een dashboard of rapportagetool | haalt je omzet, je winst-en-verliesrekening en je balans op |
| een scanner of eigen app | uploadt bonnen naar je Inbox, waar de Boekhoudbot ze verwerkt |
Vanaf welk abonnement
De API-koppeling is beschikbaar vanaf jortt MKB, dus ook met jortt Plus. In je proefperiode werkt hij ook, zodat
je een koppeling kunt testen voordat je een pakket kiest. In jortt Starter en jortt ZZP zit geen API-koppeling. Krijgt
een koppeling de foutmelding organization.requires_mkb_plan, dan heeft je administratie geen jortt MKB of jortt Plus.
Zo upgrade je je account.
Twee soorten API-koppelingen
Alle API-koppelingen staan in jortt bij Instellingen, onder Koppelingen, bij Jortt API-koppeling. Daar kies je tussen twee soorten:
API-koppeling met softwareleveranciers. De leverancier van je software heeft een koppeling met jortt gebouwd, bijvoorbeeld je webshop of je urenregistratie. Je geeft toegang vanuit die software, en hier zie je welke applicaties toegang hebben en met welke rechten. Hoe je die toegang bekijkt en intrekt, lees je bij gekoppelde apps beheren.
Eigen API-koppeling. Je maakt zelf een koppeling tussen je eigen applicatie en jortt, of laat die maken door een ontwikkelaar. Daarvoor maak je hier een applicatie aan en krijg je een client ID en een client secret. Zo’n applicatie werkt alleen voor je eigen administratie.
Zo zet je een koppeling aan
Een koppeling van je softwareleverancier zet je aan in die software. Je klikt daar op koppelen met jortt, logt in bij jortt en geeft toestemming. Daarna staat de applicatie bij API-koppeling met softwareleveranciers.
Een eigen API-koppeling maak je zo aan:
- Klik linksonder in het hoofdmenu op Instellingen.
- Kies onder Koppelingen voor Jortt API-koppeling.
- Klik op Eigen API-koppeling. Je ziet de applicaties die je al hebt aangemaakt.
- Klik op . Het scherm Nieuwe applicatie opent.
- Vul bij Naam een naam in en vink bij Scopes (rechten) aan wat de applicatie mag lezen en schrijven.
- Klik op . Je ziet de client ID en de client secret.
Behandel de client secret als een wachtwoord: wie hem heeft, kan met de rechten van de applicatie in je administratie. Wil je een applicatie stoppen, open hem dan bij Eigen API-koppeling en klik op Verwijderen. Ook alle tokens van die applicatie worden dan ingetrokken.
Welke rechten een koppeling kan krijgen
Een koppeling krijgt alleen de rechten die je aanvinkt, of die je softwareleverancier vraagt en jij goedkeurt. Zo heten ze in jortt, met de naam die een ontwikkelaar gebruikt:
| In jortt | Scope |
|---|---|
| Klanten bekijken | customers:read |
| Klanten aanmaken, wijzigen en verwijderen | customers:write |
| Facturen bekijken | invoices:read |
| Facturen aanmaken en versturen | invoices:write |
| Offertes bekijken | estimates:read |
| Offertes aanmaken en versturen | estimates:write |
| Boekingen bekijken | expenses:read |
| Boekingen aanmaken en wijzigen | expenses:write |
| Bonnen bekijken | receipts:read |
| Bonnen uploaden naar de Inbox | inbox:write |
| Rapporten bekijken | reports:read |
| Bankrekeningen en transacties bekijken | financing:read |
| Geregistreerde betalingen bekijken | reconciling:read |
| Betalingen registreren en ongedaan maken | reconciling:write |
| Salarisadministratie bekijken | payroll:read |
| Salarisadministratie wijzigen | payroll:write |
| Administratie gegevens en instellingen bekijken | organizations:read |
| Administratie gegevens en instellingen wijzigen | organizations:write |
Vink alleen aan wat de koppeling echt nodig heeft. Een dashboard heeft genoeg aan Rapporten bekijken; een webshop heeft Klanten en Facturen nodig, maar niet je salarisadministratie.
Wat je technisch moet weten
De belangrijkste gegevens uit de documentatie, zodat je weet waar je aan begint:
| Onderdeel | Hoe het werkt |
|---|---|
| Basis-URL | https://api.jortt.nl, met JSON als formaat |
| Autorisatie | OAuth 2.0. Voor je eigen applicatie gebruik je client credentials; bouw je iets dat namens andere jortt-gebruikers werkt, dan gebruik je de authorization code-flow |
| Versies | elk onderdeel heeft zijn eigen nieuwste versie, bijvoorbeeld v3 voor facturen en v2 voor klanten; v1 is sinds 28 augustus 2026 verouderd |
| Limiet | 10 verzoeken per seconde, en maximaal 100 resultaten per pagina |
| Specificatie | OpenAPI 2.0 op api.jortt.nl/swagger_doc |
Bouw je een koppeling voor andere ondernemers, lees dan een koppeling met jortt bouwen.
Een foutmelding van je koppeling
De API geeft bij een fout altijd een vaste sleutel terug. Daaraan zie je wat er mis is:
| Sleutel | Wat het betekent | Wat je doet |
|---|---|---|
organization.requires_mkb_plan | je administratie heeft geen jortt MKB of jortt Plus | upgrade naar jortt MKB |
scopes.insufficient | de koppeling mist een recht | geef de applicatie het recht dat hij nodig heeft |
access_token.expired | het token is verlopen; dat gebeurt na 2 uur | laat de koppeling een nieuw token ophalen met het refresh token |
access_token.revoked | de toegang is ingetrokken | koppel opnieuw vanuit de software |
request.throttled | meer dan 10 verzoeken per seconde | laat de koppeling even wachten en het opnieuw proberen |
Jortt geeft geen ondersteuning op de technische integratie zelf. Een koppeling van een andere partij laat je daarom nakijken door die partij.
De oude API met een API-key
Zie je bij Koppelingen ook Jortt API (oud en wordt niet meer ondersteund), dan heeft je administratie nog een koppeling via de oude API, met een applicatienaam en een API-key. Die API wordt niet meer ondersteund. Vraag de partij die de koppeling heeft gemaakt om over te stappen naar de huidige API, via Jortt API-koppeling.
Koppelen aan een AI-assistent
Wil je je administratie aan een AI-assistent zoals ChatGPT, Claude of elke andere AI-tool koppelen, dan gebruik je niet de API maar de MCP-server van jortt. Daarvoor hoef je niets te bouwen en geen applicatie aan te maken.
De jortt MCP-koppeling voor AI-assistenten
Liever niet zelf bouwen
Onze partner APIcenter.io maakt koppelingen tussen jortt en 50+ apps: CRM-systemen, ERP-systemen, marketingautomatisering, marktplaatsen en e-commerce. Met Zapier en Make koppel je jortt zonder te programmeren aan andere apps, en partijen als WeProcess en Brixxs bouwen een koppeling op maat.
Een overzicht van alle beschikbare koppelingen staat bij Koppelingen met jortt en bij kant-en-klare koppelingen.
Exporteren in plaats van koppelen
Wil je je cijfers in rapportage- of BI-software inlezen, dan kan een koppeling met Rapporten bekijken je winst-en-verliesrekening en balans ophalen. Zonder koppeling is de auditfile het startpunt. Zo maak je die: Export van mijn Inbox, facturen en boekingen.