How to activate JoFotara in Qoyod (Jordan)

To activate JoFotara in Qoyod, generate a Client ID and Secret Key on the Income and Sales Tax Department (ISTD) portal, then enter them in Qoyod once, together with your income-source sequence. From then on, Qoyod sends your invoices to the National Invoicing System with no manual step.

Path in Qoyod

You enter the link details in Qoyod’s JoFotara integration settings.

Steps

1. On the ISTD portal

1. Go to istd.gov.jo, choose «الدخول للخدمات الإلكترونية» (e-services login) and sign in.
2. Allow pop-ups in your browser, then pick «الفوترة الوطني» (National Invoicing) from the services bar.
3. Enter the CAPTCHA, then click «نظام الفوترة الوطني».
4. First time only: create an account. Your tax number fills in automatically. The password needs at least 8 characters, with letters, numbers and special symbols, and at least two letters, one of them a capital.
5. On the main screen, choose Device Linking («ربط الأجهزة»). This is the path for businesses that invoice from accounting software. Do not choose «إضافة مستخدم فرعي» (add a sub-user): that path is for issuing invoices by hand on the portal.
6. Enter a username and pick the income-source sequence for your activity.
7. The system generates your Client ID and Secret Key. Keep both safe: ISTD holds the taxpayer fully responsible for any unauthorised use.

For every portal screen in detail, see the full portal walkthrough.

2. In Qoyod

1. Open the JoFotara integration settings in Qoyod.
2. Enter your Client ID, Secret Key and income-source sequence (activity number). You do this once.
3. Issue invoices as usual and pick the document type: income invoice, General Sales Tax (16%) invoice or special tax invoice, cash or on credit. For returns, issue a credit note.
4. As you create each invoice, Qoyod checks the tax number, the document type and payment method, the General Sales Tax rate and line completeness, and alerts you to any error before sending, to reduce rejections.
5. Qoyod builds the invoice as UBL 2.1 XML with a UUID and sends it with no manual step. ISTD clears it in real time, before it reaches your buyer. You need no certificate or signature of your own.
6. Once the invoice is approved, ISTD returns the QR code and Qoyod prints it on the invoice.

Fields

• Client ID: generated by the National Invoicing System when you choose Device Linking.
• Secret Key: generated in the same step. Copy it exactly, character by character.
• Income-source sequence (activity number): the sequence you picked on the portal when you generated the link details.

Special cases

Checking that the link works

Your first real invoice after linking is the confirmation. Follow it in Qoyod’s status panel: sent, previously sent, or not sent with the error message. An approved invoice carries the ISTD QR code. You or your buyer can check it in the Sanad app under «التحقق من المستندات الرقمية» (verify digital documents), which shows the basic invoice data held inside the code.

Invoices that were not sent are listed in the status panel. You resend them yourself, with the same UUID.

Common error codes

• 500: usually a wrong tax number or income-source sequence, less often a wrong Client ID or Secret Key. Check both values character by character.
• 403: wrong Client ID or Secret Key. Copy them again from Device Linking.
• 504: JoFotara cannot be reached, because of your firewall or the ISTD site. See what causes error 504 and how to fix it.
• 400: an invoice value error, explained in the message. Typical causes: wrong totals, an invoice type that does not match your tax registration, a missing buyer name, or a duplicate invoice number.

«الفوترة الوطني» is missing from your e-services

Your taxpayer file type is «مستخدمين». Ask ISTD to change it to «أفراد».

Registration sends you back to the home page

Your file has no income-source sequence. Add one, then try again.

You clicked Device Linking by mistake

If a sub-user then loses «تنظيم فاتورة» (issue invoice), follow ISTD’s reset steps in unlinking devices in JoFotara.

Notes

• Qoyod is integrated with the National Invoicing System (JoFotara). For who must comply, see the JoFotara overview. For how the system works, see Jordan’s national e-invoicing system explained.