Je Jortt-API-applicatie aanmaken
In Jortt maak je eenmalig een eigen API-applicatie aan en plak je de client ID en de client secret in Schakel. Kost ongeveer een minuut. De applicatie hoort bij één administratie, dus je hoeft daarna niets te kiezen.
Wat je overhoudtEen client ID en client secret uit je eigen Jortt-administratie, ingevuld in Schakel.
- 01
Open het API-scherm in Jortt
Log in op Jortt en ga naar Instellingen, API. Kom je er niet uit, open dan rechtstreeks app.jortt.nl/new_profile/api/jortt/oauth_applications/list. Je ziet nu de lijst met applicaties die al bestaan, meestal leeg.
- 02
Maak een nieuwe applicatie
Klik op Nieuwe applicatie en geef als naam Schakel, zodat je later in de lijst ziet waar hij bij hoort. Vink alle gevraagde rechten aan: klanten, facturen en uitgaven lezen én schrijven, en de organisatie lezen. Mist er één, dan weigert Jortt de betreffende oproep met een foutmelding die eruitziet alsof je gegevens niet kloppen.
- 03
Kopieer beide waarden naar Schakel
Jortt toont nu de client ID en de client secret. De secret is versleuteld opgeslagen en is na het sluiten van dit scherm niet meer op te vragen, dus plak hem meteen in Schakel op de pagina Verbindingen. Schakel probeert de gegevens direct en laat zien welke administratie eraan hangt.
Goed om te weten
- Bevestig in Jortt het afzenderadres van je administratie, onder Instellingen en Facturen. Zolang dat niet bevestigd is, maakt Jortt elke factuur wel aan maar zet hij hem niet definitief: je omzet staat dan in Jortt als concept en telt niet mee voor je BTW-aangifte. Schakel laat dat op het dashboard zien in plaats van te melden dat alles gelukt is.
- Er wordt nooit een e-mail naar je koper gestuurd. Schakel zet de factuur definitief met de methode die in Jortt "ik verstuur zelf" heet, zodat hij een nummer krijgt en meetelt, zonder dat er post uitgaat.
- Jortt voert alleen boekhouding in euro. Verkoop je op je marktplaats in dollars of ponden, dan slaat Schakel die bestellingen over met een reden in plaats van ze tegen een verzonnen koers te boeken. Er is bij Jortt geen betaalde optie om dat aan te zetten.
- Staat One Stop Shop aan in Jortt, dan rekent Schakel bij een verkoop aan een consument in een ander EU-land het tarief van het land van de koper. Staat het uit, dan je eigen tarief. Schakel leest die instelling uit je administratie, je hoeft hem niet over te typen.
- De applicatie hoort bij de administratie die hem heeft aangemaakt. Heb je meerdere administraties in Jortt, maak dan per administratie een eigen applicatie aan.
Als er iets misgaat
- Schakel zegt dat de client ID en secret niet werken.
- Een half gekopieerde secret is de gewoonste oorzaak, en hij is na het aanmaken niet meer op te vragen. Maak in dat geval een nieuwe applicatie aan en plak beide waarden opnieuw.
- Schakel zegt dat de applicatie rechten mist.
- De gegevens kloppen dan wel, maar er is een recht niet aangevinkt. Jortt geeft daar dezelfde foutcode voor als voor verkeerde gegevens, dus dat is niet aan de melding te zien. Maak een nieuwe applicatie aan met alle gevraagde rechten en plak die gegevens in Schakel.
- Mijn facturen blijven concept in Jortt.
- Bevestig het afzenderadres van je administratie in Jortt, onder Instellingen en Facturen. Jortt zet geen enkele factuur definitief zolang dat niet gebeurd is. Zodra het bevestigd is, maakt Schakel de wachtende concepten bij de volgende synchronisatie alsnog definitief; er wordt niets dubbel aangemaakt.
- Ik zie mijn Etsy-kosten niet in Jortt.
- Het boeken van marktplaatskosten staat standaard uit, zodat je ze niet dubbel krijgt als je boekhouder de maandelijkse factuur al verwerkt. Zet het aan in de instellingen van de koppeling en kies daar de kostenrekening.
Koppelingen die je Jortt-toegang gebruiken
Heb je de sleutels binnen, dan gaan ze hierheen. Elke koppeling hieronder praat met Jortt.
Loop je vast op een stap?
Schermen verschuiven weleens. Ziet het er bij jou anders uit dan op de schermafbeeldingen, stuur ons dan een bericht. Dan kijken we mee en passen we de pagina aan.