Wat je nodig hebt
- De rol Admin of Member in je organisatie. Viewers hebben geen toegang tot Koppelen. Zie Wie mag koppelen?.
- Tweestapsverificatie (2FA) op je APIboard-account.
- Een vrije plek in je pakket: Proefperiode en Basis 3 koppelingen, Team 7, Pro 10 (plus eventueel een gekochte extra koppeling).
- Een Jortt-account met toegang tot de administratie die je wilt koppelen.
- Jortt MKB of Plus. Jortt geeft de API alleen vrij voor administraties met een van die pakketten. Heeft je administratie een ander pakket, dan weigert APIboard de koppeling met de melding “Deze Jortt-administratie heeft geen Jortt MKB of Plus. Jortt geeft de API alleen vrij vanaf die pakketten.”
Verbinden
- Ga in APIboard naar Koppelen > Koppelingen.
- Zoek Jortt bij Beschikbare koppelingen (of typ de naam in het zoekveld) en klik op de kaart. Er opent een venster dat je stap voor stap begeleidt.
- Klik op Verbind met Jortt. Je gaat naar de inlogpagina van Jortt.
- Log in met je Jortt-account en geef APIboard toestemming. APIboard vraagt alleen leesrechten en schrijft nooit iets terug naar Jortt.
- Kies de administratie die je wilt koppelen, als je er meerdere hebt (zie hieronder).
- APIboard haalt direct de eerste gegevens op. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.
Account of administratie kiezen
Heeft je login meerdere administraties, dan kies je er een in Kies je administratie. Al gekoppelde administraties staan niet in de lijst. Is er precies één administratie, dan zie je Koppeling bevestigen. Je kunt daar een Naam voor deze koppeling invullen. Heeft een van je administraties geen Jortt MKB of Plus, dan slaat APIboard alleen die over en meldt dat.
Meer administraties koppelen? Open de kaart van de koppeling en klik op + Account toevoegen. In het venster kies je een administratie van een login die al gekoppeld is, zonder opnieuw in te loggen, of je kiest Ander account koppelen om met een andere login in te loggen. Elke administratie telt mee als account in je pakket. Gebruik je Ander account koppelen terwijl je in je browser nog bij Jortt bent ingelogd met een ander account, log daar dan eerst uit.
Welke gegevens je krijgt
| Onderwerp | Tabellen |
|---|---|
| Verkoop | Facturen, Regels van facturen, Offertes, Regels van offertes, Betalingen |
| Inkoop | Kosten, Regels van kosten |
| Bank | Bankrekeningen, Banktransacties |
| Boekhouding | Grootboekrekeningen, Grootboeksaldi per maand (winst- en verliesrekening en balans), Labels |
| Relaties en projecten | Relaties, Projecten, Uren |
| Personeel | Loonjournaalposten |
| Beheer | Administratie |
Bij facturen en offertes staat de handelsnaam als kolom. Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank.
Wat we niet ophalen
Bonnetjes en andere bijlagen, PDF’s van facturen, Peppol-berichten en betaalsuggesties haalt APIboard niet op. APIboard leest alleen en schrijft nooit iets terug naar Jortt.
Hoe vaak vernieuwd
APIboard haalt de gegevens op per administratie, op de momenten die bij je pakket horen: Basis 1x per week, Team 1x per dag, Pro 3x per dag. Zie Hoe vaak worden gegevens vernieuwd?.
De eerste vulling van gegevens met een datum (zoals facturen, kosten, uren en banktransacties) begint op 1 januari van het jaar dat bij je pakket hoort: Proefperiode en Basis dit kalenderjaar, Team ook vorig jaar, Pro ook twee jaar terug. Stamgegevens (zoals relaties, projecten en rekeningen) worden altijd volledig opgehaald. Wat al is opgehaald, verwijdert APIboard niet als je pakket kleiner wordt.
Goed om te weten
- Per administratie loopt er één synchronisatie tegelijk. Jortt beperkt het aantal aanroepen; APIboard pauzeert vanzelf als de limiet dichtbij komt en gaat daarna door.
- Records die uit Jortt verdwijnen, markeert APIboard als verwijderd.
- Bij kosten gebruikt APIboard het teken van Jortt: kosten zijn negatief, inkomsten positief.
- Opnieuw verbinden vervangt alleen je inloggegevens. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan en de status gaat terug naar Actief. Je vindt Opnieuw verbinden in het zijpaneel dat opent als je op de kaart van de koppeling klikt. Log je in met een ander account, dan weigert APIboard dat; dan is het een nieuwe koppeling.
- Een koppeling of account verwijderen wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.
Problemen oplossen
- Deze Jortt-administratie heeft geen Jortt MKB of Plus. Upgrade de administratie in Jortt naar MKB of Plus en koppel opnieuw.
- De toegang is ingetrokken of verlopen. De pil Fout bij de koppeling verschijnt. Gebruik Opnieuw verbinden en geef opnieuw toestemming.
- De administratie is geblokkeerd. Jortt heeft de administratie geblokkeerd en geeft geen gegevens meer vrij. Neem contact op met Jortt.
- Koppelen mislukt. Controleer je gegevens en probeer het opnieuw. Dit is de standaardmelding. Controleer of je inlogt met een Jortt-account dat de administratie kan zien.
- Je hebt geen toestemming gegeven. Start de koppeling opnieuw en accepteer de gevraagde rechten.
- OAuth-sessie verlopen, probeer opnieuw te verbinden. Rond de koppeling in één keer af, in dezelfde browser.
- Viewers kunnen geen koppelingen beheren. Vraag een Admin om je de rol Member te geven, of om de koppeling te maken.
Meer meldingen staan bij Veelvoorkomende koppelfouten.
Was dit artikel behulpzaam?