De jortt API en koppelingen bouwen

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.

Vanaf welk abonnement

De API-koppeling is beschikbaar vanaf jortt MKB, dus ook met jortt Plus. In jortt Starter en jortt ZZP zit geen API-koppeling. Werkt je koppeling niet en krijg je een foutmelding zoals “retry later”, controleer dan eerst welk abonnement je hebt: bij Starter en ZZP is de API namelijk niet beschikbaar. Zo upgrade je je account.

Zo zet je een koppeling aan

Je maakt de koppeling zelf aan in jortt:

  1. Klik linksonder in het hoofdmenu op Instellingen.
  2. Klik op Koppelingen.
  3. Kies Jortt API-koppeling als je een bestaande app koppelt, of Eigen API-koppeling als je zelf iets bouwt.

Wat je technisch moet weten

De belangrijkste gegevens uit de documentatie, zodat je weet waar je aan begint:

  • 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.
  • Rechten per onderdeel: je vraagt alleen de scopes aan die je nodig hebt, bijvoorbeeld voor klanten, facturen, offertes, uitgaven, rapporten, salaris of de Inbox, elk apart voor lezen en schrijven.
  • Limiet: 10 verzoeken per seconde, en maximaal 100 resultaten per pagina.

Koppelen aan een AI-assistent

Wil je je administratie aan een AI-assistent zoals ChatGPT, Claude of Cursor koppelen, dan gebruik je niet de API maar de MCP-server van jortt. Daarvoor hoef je niets te bouwen.

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.

Koppel via APIcenter

Een overzicht van alle beschikbare koppelingen staat bij Koppelingen met jortt.

Exporteren in plaats van koppelen

Wil je je cijfers in rapportage- of BI-software inlezen, dan is de auditfile het startpunt. Zo maak je die: Export van mijn Inbox, facturen en boekingen.

Let op
Auditfiles zijn primair niet gemaakt om data in te lezen in externe software zoals rapportagetools. Jortt geeft hier geen ondersteuning op, of garanties dat dit werkt. Het is aan de inlezende partij te zorgen dat dit werkt.

Veelgestelde vragen over de jortt API

Heb je een vraag? Wij hebben de antwoorden!

De documentatie voor software-ontwikkelaars staat op developer.jortt.nl. Daar lees je hoe je je eigen applicatie aan jortt koppelt. Kom je er niet uit, stuur dan een e-mail naar support@jortt.nl met je bedrijfsnaam zoals die in jortt staat en een duidelijke omschrijving van je vraag.

De API-koppeling zit vanaf jortt MKB, dus ook in jortt Plus. In jortt Starter en jortt ZZP zit geen API-koppeling.

Ja. Partner APIcenter.io maakt kant-en-klare koppelingen tussen jortt en 50 plus apps: CRM-systemen, ERP-systemen, marketingautomatisering, marktplaatsen en e-commerce. Daarnaast zijn er standaardkoppelingen met je bank, Mollie, Employes, Time On, Simple Simon, eHour, Keeping, OutSmart en Webwinkelfacturen.

Je exporteert je hele boekhouding als auditfile (XAF 4.0.3) via Boekhoudbot, Maak voor mij een auditfile. Let op: auditfiles zijn primair niet gemaakt om data in te lezen in externe software zoals rapportagetools. Jortt geeft hier geen ondersteuning op en geen garantie dat dit werkt; het is aan de inlezende partij om te zorgen dat het werkt. De jaarrekening, de aangifte inkomstenbelasting en de aangifte vennootschapsbelasting download je bij Rapporten rechtstreeks uit jortt.

Ja. Naast de API heeft jortt een MCP-server waarmee je je administratie aan een AI-assistent zoals ChatGPT, Claude of Cursor koppelt. Die zit, net als de API, vanaf jortt MKB. Lees hoe dat werkt bij De jortt MCP-koppeling voor AI-assistenten.

Die maak je zelf aan in jortt. Ga naar Instellingen linksonder in het hoofdmenu en klik op Koppelingen. Daar kies je Jortt API-koppeling of Eigen API-koppeling. De technische documentatie staat op developer.jortt.nl.

Controleer eerst welk abonnement je hebt. De API-koppeling zit vanaf jortt MKB; in jortt Starter en jortt ZZP is de API niet beschikbaar en werkt een koppeling dus niet. Heb je wel MKB of Plus, kijk dan of je koppeling de juiste rechten heeft aangevraagd en of je niet boven de limiet van 10 verzoeken per seconde uitkomt. Jortt geeft geen ondersteuning op de technische integratie zelf.

Je vraagt per onderdeel rechten aan, apart voor lezen en voor schrijven: klanten, facturen, offertes, uitgaven, organisatiegegevens, rapporten, salarisgegevens, financiering en het uploaden van bonnen naar de Inbox. De volledige lijst met scopes en endpoints staat op developer.jortt.nl.