01

Open the API screen in Jortt

Log in to Jortt and go to Instellingen, API. If you cannot find it, open app.jortt.nl/new_profile/api/jortt/oauth_applications/list directly. You now see the list of applications that already exist, usually empty.
02

Create a new application

Click Nieuwe applicatie and use Schakel as the name, so you can later tell from the list what it belongs to. Tick every permission asked for: read and write on customers, invoices and expenses, plus read on the organisation. If one is missing, Jortt refuses that call with an error that looks as though your credentials are wrong.
03

Copy both values into Schakel

Jortt now shows the client ID and the client secret. The secret is stored encrypted and cannot be retrieved once you close that screen, so paste it into Schakel on the Connections page straight away. Schakel tries the credentials right away and shows which administration they reach.

Worth knowing

Confirm the sender address of your administration in Jortt, under Instellingen and Facturen. Until that is confirmed Jortt creates every invoice but never finalises it: your revenue then sits in Jortt as a draft and does not count towards your VAT return. Schakel shows that on the dashboard rather than reporting success.
Your buyer is never emailed. Schakel finalises the invoice with the method Jortt calls "I will send it myself", so it gets a number and counts, without anything going out.
Jortt keeps books in euro only. If you sell on your marketplace in dollars or pounds, Schakel skips those orders with a reason rather than booking them at an invented rate. There is no paid option at Jortt to switch that on.
If One Stop Shop is switched on in Jortt, Schakel charges the buyer country rate on a sale to a consumer in another EU country. If it is off, your own rate. Schakel reads that setting from your administration; you do not have to copy it across.
The application belongs to the administration that created it. If you have several administrations in Jortt, create a separate application for each one.

If something goes wrong

Schakel says the client ID and secret do not work.: A half-copied secret is the usual cause, and it cannot be retrieved after creation. In that case create a new application and paste both values again.
Schakel says the application is missing permissions.: The credentials are right but a permission is not ticked. Jortt returns the same error code for that as for wrong credentials, so the message cannot tell them apart. Create a new application with every requested permission and paste those credentials into Schakel.
My invoices stay drafts in Jortt.: Confirm the sender address of your administration in Jortt, under Instellingen and Facturen. Jortt finalises no invoice at all until that is done. Once it is confirmed, Schakel finalises the waiting drafts on the next sync; nothing is created twice.
I do not see my Etsy costs in Jortt.: Booking marketplace costs is off by default, so you do not get them twice if your accountant already processes the monthly invoice. Switch it on in the connector settings and pick the cost account there.

Once you hold the keys, this is where they go. Every connector below talks to Jortt.

Screens move around. If what you see does not match the screenshots, message us and we will look at it with you, and fix the page.