Any software that sends your invoices to Jordan's national e-invoicing system (JoFotara) needs three values from you: a client ID, a secret key and an income source sequence. You generate them yourself from your business's account on the portal. Here is how, as published integrator guides describe it.
Before you start
- Sign in as the business's main user (tax number, username, password). A sub-user cannot create the link.
- You need an active income source sequence. If you have none, it is requested from the Department, not created on the linking page.
- Have a safe place to store the values, such as a password manager, not a chat.
The steps
- 1. Sign in to the JoFotara portal as the main user.
- 2. On the home screen choose device linking (ربط الأجهزة).
- 3. Press new link (ربط جديد); the add user window opens.
- 4. Type a name for the link, pick the income source sequence, and press add (إضافة).
- 5. The portal generates the client ID and secret key. Copy each with its copy button rather than retyping.
- 6. Paste the three values into your software's JoFotara settings and send a test invoice.
Menu names can change with portal updates; the Income and Sales Tax Department's technical guide is the final reference.
Common mistakes
- Sending the secret key by chat or email. Whoever has it can issue invoices in your name. Do not share it, not even with your software vendor.
- Picking the wrong income source sequence or tax number: guides say this usually returns error 500.
- Error 403 usually means a wrong or replaced client ID or secret key.
- Lost secret key: create a new link on the portal and use the new pair.
- Guides note that linking a user removes its manual invoice option on the portal, and unlinking needs a request to the Department.
Want us to do it with you?
JoFawtara Connect connects to JoFotara for you, sends every invoice automatically and prints the QR code. Free setup for the first 50 businesses.
Book free setup