العربية
JOFOTARA · JORDAN E-INVOICING

JoFotara integration for Jordan e-invoicing, built into your ERP

Aspirations is Jordan e-invoicing software with JoFotara integration built into the invoice engine. Enter the credentials you generate on the JoFotara portal, test the connection, and every sales invoice, credit note and POS sale is sent to the national e-invoicing system in UBL 2.1, with the returned QR code printed on it. The integration is ready and needs your own JoFotara credentials.

  • Client ID and Secret Key from your portal, stored encrypted
  • UBL 2.1 invoices with the QR code returned by JoFotara
  • Credit notes linked to the original invoice and a reason
  • Invoices, POS and the ledger in one system
JoFotara integration for Jordan e-invoicing, built into your ERP

Why e-invoicing in Jordan feels harder than it should

The rule is simple: invoices go through the national system. The daily work around it is where time is lost.

The challenge

Typing invoices twice

Sales are entered in the accounting program, then re-typed on the JoFotara portal.

With Aspirations

The invoice you issue in Aspirations is the one sent to JoFotara. No second entry.

The challenge

Rejections found too late

An invoice is rejected for a missing buyer name, and nobody notices until the customer calls.

With Aspirations

Known rejection causes are checked before the invoice takes a number, and rejections raise a notification.

The challenge

Corrections that break the books

An invoice is edited after it was sent, and the ledger, stock and portal no longer agree.

With Aspirations

Issued invoices are locked. Corrections are credit notes linked to the original.

JOFOTARA INTEGRATION

JoFotara integration from the same invoice engine

Sales invoices, credit notes and POS sales pass through one engine that handles numbering, tax and the national system's requirements.

  • UBL 2.1 as the system expects — Each invoice is built as UBL 2.1 XML and sent with your credentials in the request header, as ISTD's linking manual describes.
  • Cash and receivables invoices — The invoice type follows the payment method, for sales-tax registered and income-only companies.
  • QR code on every accepted invoice — The QR code JoFotara returns is stored and printed on the invoice and POS receipt.
  • Tamper-evident numbering — Gap-free numbering and a hash chain expose deleted or changed invoices.
JoFotara integration from the same invoice engine
SETTINGS AND CREDENTIALS

Connect your JoFotara account in a few minutes

Integration settings sit in your e-invoicing settings, and only the owner or an admin can change them.

  • Client ID, Secret Key and income source sequence — Paste the values from the JoFotara portal. The secret is encrypted and never shown again.
  • Test the connection — One click checks that JoFotara accepts your credentials, without creating an invoice.
  • Branches with their own tax number — A separately registered branch has its own credentials and issues invoices under its own identity.
Connect your JoFotara account in a few minutes
POINT OF SALE

POS sales that go through the national e-invoicing system

In Jordan, a sale at the register is a cash invoice issued by the same engine, under the same JoFotara rules.

  • Submitted after the sale is saved — The invoice goes to JoFotara only after the sale, stock and journal entry are committed, never for a sale that was rolled back.
  • QR on the receipt — The receipt shows the QR code JoFotara returned for that sale.
  • Returns as credit notes — A return at the counter becomes a credit note against the original sale.
POS sales that go through the national e-invoicing system

What JoFotara requires from companies in Jordan

JoFotara is the national electronic invoicing system run by the Income and Sales Tax Department (ISTD), launched in December 2022 for companies and establishments bound by the invoicing rules. The legal basis is Article 23(f) of the Income Tax Law, which requires an original invoice for every sale of goods or services in the Kingdom, with the Regulation for Organizing and Controlling Invoicing Affairs No. 34 of 2019 and its instructions.

Invoices can be issued on the JoFotara portal, in its mobile app, or through integration (API), where your accounting or ERP system links to JoFotara and you keep working in it. Aspirations uses integration.

What a valid e-invoice needs

  • Your tax number and the income source sequence linked on the portal.
  • A cash or receivables invoice. According to ISTD's manual, buyer details are not required below 10,000 dinars; receivables invoices carry the buyer's name.
  • Lines with quantity, price and tax category.
  • UBL 2.1 XML, sent with your integration credentials.

An accepted invoice carries a QR code that buyers can scan in the government Sanad app to verify it.

Who is covered, and enforcement

ISTD has published turnover thresholds that keep some small activities, such as small licensed shops and crafts, outside the obligation. They can change, so confirm your position with ISTD or your tax adviser. The Income Tax Law treats failing to issue a proper invoice as a violation, and ISTD runs field visits: in February 2026 it notified 379 non-compliant businesses and gave them one week to correct their status. We don't quote fine amounts because they depend on the case.

HOW IT WORKS

How the JoFotara integration works, step by step

From the portal to an accepted invoice with a QR code.

  1. Generate credentials on the JoFotara portal

    Log in to the national invoicing system with your company's tax number, username and password. Open Connect Devices, choose New link, enter a username and pick the income source sequence. Copy the user number (Client ID) and Secret Key the portal generates.

  2. Enter them in Aspirations

    Paste the Client ID, Secret Key and income source sequence in e-invoicing settings. Tick income invoices only if you are not registered for sales tax.

  3. Test the connection

    Aspirations checks that JoFotara accepts your credentials, without creating an invoice.

  4. Issue an invoice as usual

    Before it takes a number, the invoice is checked for what JoFotara would reject: dinars only, tax number, quantities and prices above zero, buyer name where required.

  5. Submission and QR code

    The invoice is sent as UBL 2.1. Once accepted, the returned QR code is saved and printed, with any JoFotara warnings.

  6. Handle rejections and outages

    A rejected invoice shows JoFotara's error and notifies your accountants and the invoice owner. If JoFotara is unreachable, the invoice stays pending and you resubmit it with one click.

  7. Correct with a credit note

    To change an accepted invoice, issue a credit note with a reason. It references the original and is sent the same way.

Invoices, credit notes and corrections in JoFotara

An invoice accepted by JoFotara is final and cannot be edited. The correct path is a credit note (a return invoice).

How credit notes work in Aspirations

  • It is created from the original invoice, in full or for selected lines.
  • A reason is required, and the original must already be accepted.
  • It references the original invoice number, unique identifier and total.
  • Revenue, tax and stock are reversed in the ledger automatically.

Common corrections

SituationWhat to do
Customer returned some itemsCredit note for the returned lines
Wrong price or quantityFull credit note, then a new correct invoice
Wrong customerFull credit note, then a new invoice to the right customer
Invoice rejected by JoFotaraFix the data named in the error, then resubmit
JoFotara was unreachableThe invoice is pending; resubmit when the service is back

Jordan sales tax categories in your e-invoices

Every JoFotara invoice line carries a tax category. Aspirations stores three, each with an editable rate:

  • Standard: the general sales tax rate of 16%.
  • Zero-rated: taxable at 0%, for items in the law's schedules.
  • Exempt: outside sales tax, per the exemption schedule.

You set the category on each item once, and invoices, credit notes and POS sales use it. JoFotara codes zero-rated and exempt lines differently from Saudi Arabia's ZATCA; Aspirations maps them for you. Companies not registered for sales tax switch on income invoices, and lines are sent without tax. Rates are editable, so a change in the law is a settings update. Confirm each item's category with your accountant.

Current scope: domestic invoices in Jordanian dinars. Export invoices and development-zone invoices are not supported yet.

Before you go live with JoFotara: a checklist

  1. Your company has joined the national invoicing system and you can log in to the portal.
  2. You generated a Client ID and Secret Key under Connect Devices, on the correct income source sequence.
  3. The tax number and address are filled in; separately registered branches have their own credentials.
  4. Every item has the right tax category.
  5. Credit customers have a name and, where available, a tax or national number.
  6. The connection test passed.
  7. Your first real invoice was accepted, its QR code scans in Sanad, and it appears on the portal. We review it with you during onboarding.
  8. Rejection notifications are on for the right users.
BUILT FOR JORDAN

What else comes with your e-invoicing

JoFotara is one part of an ERP that keeps sales, stock and accounts together.

Automatic journal entries

Invoices, credit notes and POS sales post to the double-entry ledger as they are issued.

Branches

Per-branch numbering, users limited to their branches, and per-branch statements.

Arabic and English

Full Arabic interface and right-to-left invoices.

Move from your current system

Import customers, items and opening balances from Excel templates.

FAQ

Questions about JoFotara and e-invoicing in Jordan

What finance teams ask before connecting.

Is JoFotara integration mandatory in Jordan?

Businesses bound by the invoicing rules must issue invoices through the national e-invoicing system, either on the JoFotara portal or app, or by integrating their own system. Integration is one of those routes, and if you invoice from an accounting or ERP system it saves typing every invoice twice. Some small activities fall below ISTD thresholds, so confirm your position with ISTD or your tax adviser.

How do I get my JoFotara integration credentials from the portal?

Log in to the national invoicing system with your company's tax number, username and password. Open Connect Devices, choose New link, enter a username, select the income source sequence and press Add. Copy the user number (Client ID) and Secret Key shown, and paste them with the income source sequence into Aspirations e-invoicing settings.

How do I correct an invoice that was already sent to JoFotara?

An accepted invoice cannot be edited. Issue a credit note from the original with a reason, for the whole invoice or some lines; Aspirations links it to the original and sends it to JoFotara. If the whole invoice was wrong, issue a new one after the credit note.

What happens if JoFotara rejects an invoice?

The invoice is marked rejected with JoFotara's error message, and your accountants and the invoice owner are notified. Fix the cause, such as a missing buyer name or wrong credentials, and resubmit.

Can I connect the POS to JoFotara?

Yes. In Jordan each POS sale is a cash invoice from the same engine, sent to JoFotara after the sale is saved. The receipt shows the returned QR code, and returns become credit notes.

Is Aspirations approved by ISTD?

We don't claim any approval or certification. JoFotara integration is ready (UBL 2.1), follows ISTD's published linking manual and needs your own credentials. During onboarding we send your first real invoices with you and check them on the portal.

Issue your next invoice through JoFotara without typing it twice

Book a demo and we will walk through the settings, an invoice, a credit note and a POS sale with your data.

Request a JoFotara e-invoicing demo

Tell us your company size, branches and how you invoice today, and we will schedule a live walkthrough.