Connecting Raqame to JoFotara, Jordan’s national e-invoicing system

What is JoFotara?

JoFotara is Jordan’s national e-invoicing system, run by the Income and Sales Tax Department (ISTD). A business sends it the sales invoices it issues; the system validates and records each one and returns a QR code that the buyer can scan to verify the invoice.

Invoices can be issued in the system’s portal itself, or from software connected to it, like Raqame — so each invoice reaches the system from the software instead of being typed into the portal a second time.

What you need before you start

• A business registered in the national invoicing system, and its main user account on the JoFotara portal.
• Raqame on an Android device, with an active base license and the E-invoicing add-on (or the free trial).
• Your business name and tax number in the company profile in Raqame — they’re sent with every invoice as the seller details.
• Your business’s registration type in the system: income, sales tax or special sales.

Step 1: Get your connection details from the JoFotara portal

1. Sign in to the JoFotara portal with your business’s main user account.
2. Open the device linking screen (ربط الأجهزة) and choose new link (ربط جديد).
3. Enter a user name for this link (for example “Raqame – main branch”), pick the income source sequence these invoices will be issued under, then press Add.
4. The link appears in the list of linked devices with its Client-Id, Secret-Key and income source sequence. Copy each value exactly, using the copy button next to it.

Step 2: Set up e-invoicing in Raqame

1. Open Sales → Tools → E-Invoicing and choose the provider Jordan — JoFotara. Note: once you confirm the provider it can’t be changed.
2. Enter the three values exactly as copied: Client-Id, Secret-Key and income source sequence. They’re stored encrypted in Android’s secure key store on your device.
3. Choose the invoice type that matches your registration: Income, Sales tax or Special sales. Every business starts on Income; switching to sales tax is a one-time change that can’t be undone — just like the tax registration itself.
4. In E-invoicing options, set Tax submission: Automatic on post (each invoice is sent as soon as it’s saved) or Manual (the invoice is held until you press “Submit to tax” on the document).
5. If you sell in more than one currency, set the Currencies approved for e-invoicing: invoices in an unapproved currency keep working locally and aren’t sent to the tax department.
6. In your invoice print template, make sure Show fiscal QR is on, and size the code to suit thermal paper or A4.

What happens to each invoice?

1. Sell and print at once. The invoice is saved and the receipt prints immediately — the cashier never waits for the network or the system’s reply.
2. Into the send queue. The invoice is recorded in a queue on your device, or held until you press “Submit to tax” if you chose manual submission.
3. Sent in order. Raqame sends invoices to the national system in strict sequence (ICV), with no gaps or duplicates: when the app opens, when you return to it, when the connection comes back, or whenever you press “Sync now”.
4. Accepted, with a QR code. On acceptance Raqame stores the official QR code the system returned and prints it on the invoice from then on. Before acceptance the invoice prints with “Pending authentication” where the code would be.
5. Rejected. If the system rejects an invoice for a data error, it shows on the E-invoice status screen with the server’s reply and the reason. Fix the cause (for example the customer’s details or the company profile), then press “Resubmit”.

And when the internet drops?

This is where Raqame differs from cloud software: the database lives on your device, so selling, printing and accounting carry on without a connection. Invoices wait in the queue and go out on their own, in the same order, as soon as the internet is back — with nothing to re-enter.

• An invoice doesn’t take a sequence number (ICV) until its first send attempt, and every retry reuses the same number — so the numbering never has gaps.
• If sending fails because of the network or the system’s server, Raqame retries automatically at growing intervals (from a minute up to an hour), and never sends a later invoice ahead of an earlier one.
• If it keeps failing, the invoice is marked Needs attention on the status screen, so you know something needs you — such as connection details that changed in the portal.

Returns and corrections

• A return isn’t sent as a negative invoice but as a separate credit note that references the original invoice, with positive quantities and the reason for the return.
• An invoice that has been sent to the tax department can’t be edited or voided; you correct it with an opposite document (a return).
• Purchases, stock vouchers and stock counts are internal documents and aren’t sent to JoFotara — the system records what you sell, not what you buy.

What is sent to JoFotara?

Invoice statuses on the E-invoice status screen

What Raqame checks before sending

• Your business name and tax number in the company profile.
• The customer’s name on credit (receivable) invoices, and on cash invoices over 10,000 JOD.
• The customer’s tax or national ID when you have it, sent as the buyer’s identifier.
• The sale type (local, export or development area) and payment (cash or credit) — together with your business type, they set the invoice type code in the system automatically.

E-invoicing FAQ