Connecting Your Online Store to the National Invoicing System in Jordan: The Full Path from Order to Invoice

Your store platform knows you made a sale. It does not know that the tax authority knows.

That gap is where most Jordanian online sellers get caught. The “your order is confirmed” email your platform sends is not an invoice, and no setting inside the platform will turn it into one. Article 4(a) of the Regulation for Organizing and Controlling Invoicing Affairs No. 34 of 2019 recognises only an invoice issued by the national e-invoicing programme, or by a system that has been linked to it.

Since 1 April 2025 that obligation covers every invoice in Jordan, whether business-to-business, business-to-consumer, or business-to-government. So a store shipping 300 orders a month with none of them passing through the National Invoicing System is producing 300 documents that will not be accepted as tax records.

And no global e-commerce platform sends your invoices to the Income and Sales Tax Department (ISTD) on its own, because linking to the National Invoicing System is a local Jordanian obligation, not a feature built into an international platform. This is what it takes to connect your online store to the National Invoicing System: the order moves from the platform into an accounting system that is linked to ISTD, which then issues the invoice and receives its QR code back.

This guide covers the correct path, what your platform does and does not do, the popular platforms in Jordan and how each one connects, and the mistakes that keep recurring.

Why the store platform alone is not enough in Jordan

A store platform is built to run selling: the product page, the cart, the payment gateway, shipping. It does that well. The general ledger, cost of goods sold, the general sales tax return, and a compliant invoice issued by a system linked to ISTD are not its job and were never designed into it.

Three things in Jordan have moved from administrative detail to compliance requirement.

The invoice is an event, not a monthly report line

The National Invoicing System works on real-time clearance: the invoice is submitted to ISTD and the QR code comes back from the department once it is accepted, before you share it with the buyer. So knowing at month end that you sold 300 orders is not enough. Note the distinction that trips people up: the QR is returned by ISTD and is not generated by your software, and no taxpayer-side digital signature or encryption certificate is required of you. The mechanics are covered in how the National Invoicing System works and how to connect your business to it.

Invoice type is not a single choice

The system recognises three types: an income invoice for businesses not registered for general sales tax, a general sales tax invoice at 16%, and a special tax invoice. Each has a cash and a receivable variant.

This matters specifically to a store. An order paid by card at checkout is not classified the same as a cash-on-delivery order, and a sale to a customer outside Jordan is not taxed like a domestic one. A system that issues one flavour of invoice does not cover a store with more than one way of selling. The fields and types are detailed in e-invoicing requirements in Jordan.

Corrections are not made with a replacement invoice

Returns are part of running any store, and here the rule is strict: an invoice cannot be edited once issued. The only correction is a return invoice, that is a credit note, referencing the original by its ID, UUID and total, carrying a mandatory free-text reason, and adjusting quantities only without exceeding the original quantity.

And note what does not exist: version 1.5 of the technical integration manual has no debit note. Anyone offering you “a debit note in the National Invoicing System” is offering something the specification does not define.

The correct path: store, accounting system, then ISTD

This is the most important idea in the guide, and the one most often misread. Connecting is not one step but two loops, and neither substitutes for the other.

Loop one: store to your accounting system. It carries the order, the customer, the line items, shipping and payment fees across, so they become an invoice and a journal entry in your books.

Loop two: your accounting system to the Income and Sales Tax Department. The invoice is submitted to the National Invoicing System and the QR code comes back on it, which is what makes it an accepted tax document.

Connect only the first loop and you are half done: tidy books, invalid invoices. Connect only the second and you are retyping every order by hand. Both loops together are the requirement.

The popular store platforms in Jordan and how each connects

Before talking about connecting, know where your store sits. A survey covering 9,100 verified Jordanian stores that ship physical goods (June 2026) paints a different picture from what most people expect.

The number worth pausing on is the first: roughly two-thirds of Jordanian stores are custom-built, not running on an off-the-shelf platform. That inverts the usual priority order. For most store owners in Jordan the answer is not a ready-made connector but the API. Worth knowing before you go hunting for a plug that does not exist.

WooCommerce: the leading off-the-shelf platform in Jordan

WooCommerce is the most used ready-made platform in Jordan, and it integrates with Qoyod, so its orders arrive as invoices with no manual entry, and Qoyod then submits them to the National Invoicing System and receives the QR back.

Because it runs on WordPress, the setting worth your attention is the stock keeping unit: make sure every product carries an SKU matching its serial number in Qoyod before you switch the connection on.

Shopify: second among off-the-shelf platforms

Shopify integrates with Qoyod as well, so a new order arrives as an invoice and brings the customer and payment data with it.

Watch one Jordan-specific point: a refund in Shopify has to translate into a credit note in Qoyod, not an edit to the original invoice, because the system does not accept editing an issued invoice.

Wix, Squarespace, Big Cartel, BigCommerce and Ecwid

These platforms integrate with Qoyod too. Their share in Jordan is smaller but not zero, and the path is the same: the order reaches Qoyod, then the invoice goes to ISTD.

Magento

Magento (Adobe Commerce) integrates with Qoyod, carrying the new order with its line items and its return notices. It is usually the platform of larger stores, which is why many of its users prefer connecting through the API for wider control.

OpenCart and custom-built stores: the API

Here it pays to be clear: OpenCart has no ready-made connector yet, and neither do custom-built stores, which are the majority in Jordan, nor local platforms.

These cases have one supported path: the API. You generate the integration key in Qoyod, hand it and the API documentation to your technical team, and they connect the store directly. This is in fact better for a custom-built store, because whoever built it knows its data structures and can map the fields more precisely than any ready-made template.

And note that none of this changes the second loop: whatever your platform, the invoice is submitted to the National Invoicing System by Qoyod, not by the store.

What your system needs to know about your store’s orders

Not every order in an online store is the same case. These are the situations your store handles daily and your system has to classify correctly.

1. Card payment at checkout. A cash invoice, because the amount was collected at the moment of sale.
2. Cash on delivery. The money is in transit until the courier collects it. Treating it as a cash invoice from the first moment shows cash you do not hold yet.
3. Deferred B2B sales. A receivable invoice posted to the customer’s account, and Article 5(b) requires the buyer’s name to be stated clearly on deferred, instalment or staged sales.
4. Sales outside Jordan. Exports at zero tax, a completely different classification from a domestic sale in the invoice type code.
5. Returns. A credit note on quantities, never a new invoice and never an edit to the original.
6. Orders cancelled before shipping. If the invoice was already submitted and accepted, cancelling needs a credit note. If it was never submitted, there is no document to cancel.
7. Selling to an unregistered customer while you are unregistered. An income invoice with no tax, which is a document type in its own right, not an incomplete invoice.

One floor that many miss: Article 5(a) requires an invoice for every good or service worth one dinar or more. Small orders in your store are not outside scope.

What syncs once your store is connected to your books

Once the order reaches your accounting system, four groups of data travel with it, each solving something that used to be done by hand.

1. Customer and line items. The customer is recorded and linked to their invoices, and items are posted at their prices.
2. Inventory. The item is deducted at the point of sale, so cost of goods sold is calculated and you know your real margin, not just your revenue figure.
3. Payment fees and shipping costs. Posted as separate lines, so they do not disappear inside the sales figure and quietly eat the margin.
4. Collection status. Cash invoices settle, receivable invoices sit on the customer’s account until collected, so you read your ageing instead of guessing it.

One condition governs correct syncing: the serial number in your system must match the SKU in the store. A product with no SKU will not map correctly, and that is behind most “the order transferred but items are missing” cases.

Six recurring mistakes connecting stores to the National Invoicing System

1. Waiting for month end. The system runs on real-time clearance, so the invoice is submitted at the point of sale, not in a monthly reconciliation. Batching a month of orders fights the system’s logic and surfaces its errors too late.
2. Treating the order confirmation as a document. The platform’s email to the customer is not an invoice. A business buyer who accepts it loses the input tax deduction and the expense is not recognised, which is exactly why corporate customers start refusing to deal with you.
3. Editing an invoice after issuing it. Not possible. Returns and cancellations run through a credit note, on quantities only, never exceeding the original quantity.
4. Judging success by the order arriving. An invoice’s success is read from the submission status ISTD returns, not from the order having reached your system. Watch the invoices not yet submitted, and never assume silence means success.
5. Mismatched stock keeping units. A mismatch between store and system produces invoices missing line items, and those were actually submitted to ISTD with the wrong contents. Fixing that needs a credit note, not an edit.
6. Overlooking retention. Article 8(a) requires invoices to be kept for four years, and Article 8(b) accepts the national programme’s own records in place of paper. Invoices that passed through the system archive themselves; those that did not stay your burden.

And one rule that precedes all of the above: after every change to your settings, test with one real order and follow it until its QR comes back from ISTD. An error caught the same day is fixed with a credit note; an error caught after the tax period closes is a different matter.

What if your store also buys from suppliers?

The other side of the equation is usually forgotten. Your store buys in order to sell, and every purchase invoice you receive carries the same rule: an invoice not issued through the National Invoicing System is not an accepted tax document, so you lose the input tax deduction and the expense is not recognised.

Article 10 makes matching the invoice to reality the responsibility of seller and buyer alike. So verifying your supplier’s compliance is not extra caution, it is part of your own obligation. And it has become possible: ISTD has published the names of compliant businesses on its website and runs a lookup service that answers on a single tax number.

A worked example of what connecting does to your numbers

An online store in Amman ships 300 orders a month at an average of 35 dinars per order. That is 10,500 dinars in sales, with general sales tax at 16% on top.

Follow that on the platform’s own report and what you see is the revenue figure. What you do not see is three items: the cost of the goods sold, the payment gateway fees, and the shipping you absorbed without fully passing it on. Together they can be enough to turn a month you think is profitable into a break-even one.

And there is a fourth item specific to Jordan: 300 invoices that must have passed through the system. If they did not, you face a fine of between 200 and 500 dinars per violation, doubling on repetition, plus exclusion from government tenders. Failing to issue a proper invoice is also listed in Article 66 of Income Tax Law No. 34 of 2014 among acts of tax evasion.

With the path connected end to end, the first three are posted automatically the moment the order transfers, and the fourth is submitted to ISTD in its own time. Your margin becomes a figure you read, and compliance becomes a standing state rather than a monthly scramble. This is the practical difference between tracking sales and tracking retail accounting properly.

The right order of work

1. Register and link your devices on the system portal. Generate the Client ID, Secret Key and income source sequence using the main user.
2. Set up your chart of accounts. Sales, inventory, payment gateway and shipping accounts, before imported accounts join it. Background in chart of accounts: definition and examples.
3. Unify stock keeping units between store and system. This single step prevents most transfer errors.
4. Set your inventory starting point on a correct opening balance, since it is the zero your cost is calculated from.
5. Connect loop one between the store and the system, ready-made or through the API.
6. Connect loop two between the system and ISTD, then test with one real low-value order and cancel it with a credit note. There is no announced government test environment, so testing runs on an actual invoice.

If you are still running your store’s orders on a spreadsheet, the problem is wider than compliance. See when to stop managing your invoices in Excel, and if your bookkeeping is still single-entry, the single-entry system guide explains what it cannot give you.

How Qoyod helps you connect your store to the National Invoicing System

Qoyod covers both loops in one system: it receives your store’s orders, keeps your books, and submits the invoice to the Income and Sales Tax Department. These are the places that serves:

• National Invoicing System integration. Qoyod is integrated with the National Invoicing System (JoFotara). You enter the Client ID, Secret Key and income source sequence in the integration settings, and your invoices are submitted with the QR code coming back from ISTD. No developer and no middleman between you and the department.
• Receiving your store’s orders. WooCommerce, Shopify, Wix, Squarespace, Magento, BigCommerce, Big Cartel and Ecwid integrate with Qoyod without code, so their orders arrive as invoices. Custom-built stores and OpenCart connect through the API.
• The document types the Jordanian system recognises. Income invoice, general sales tax invoice and special tax invoice, in both cash and receivable variants, with the credit note linked to its original invoice.
• Jordanian dinar and 16% general sales tax. Invoices are issued in dinars with the rate and its reduced rates applied, and the Jordanian invoice template carries the tax number and the mandatory Article 5 fields, not a tax logic imported from another market.
• Inventory, branches and multiple warehouses with stock transfer between them and cost reports, so the item is deducted at the point of sale instead of at a month-end count.
• Receivable invoices and customer ageing. Deferred sales post to the customer’s account with credit limits, which is what your store needs when selling to businesses or on cash on delivery.
• Permissions and the activity report. Separating whoever enters the invoice from whoever approves it, with a documented trail for every change and every import attempt.
• Excel import. Templates for sales and purchase invoices, customers, products, chart of accounts and opening balances, holding up to 5,000 rows with protected headers and dropdowns built from your own account values, plus a per-row error report by email. The practical route for preparing your data before connecting.
• Financial and custom reports to read profit at item level rather than month level, and to prepare your general sales tax return figures from the books themselves.
• A natively Arabic interface in Arabic and English with Arabic accounting logic, which genuinely shortens training time for your team.

Qoyod is used by more than 25,000 businesses in a market operating under a comparable e-invoicing mandate, so the experience it brings to Jordan is not theoretical. Integration and field details are on the National Invoicing System (JoFotara) page, and an overview of the full Jordan offering is on Qoyod Jordan.

Frequently asked questions

How do I connect my online store to the National Invoicing System in Jordan?

Through two loops. First, your store’s orders move into an accounting system, either through a ready-made integration or the API. Second, that system submits the invoice to ISTD using the Client ID, Secret Key and income source sequence you generate from the “device linking” service in the system portal. No store platform submits to the department on its own.

Does my store platform send my invoices to ISTD automatically?

No. Linking to the National Invoicing System is a local Jordanian obligation, not a feature built into international store platforms. The order confirmation your customer receives is not an invoice and is not accepted as a tax document.

How do I connect WooCommerce to the National Invoicing System?

In two stages. WooCommerce integrates with Qoyod, so every new order arrives as an invoice with no manual entry. Then Qoyod submits the invoice to the National Invoicing System and the QR code comes back on it. WooCommerce does not contact the department itself. Before switching on, make sure every product carries an SKU matching its serial number in Qoyod.

How do I connect Shopify to the National Invoicing System?

The same path: Shopify integrates with Qoyod so the order arrives as an invoice, then Qoyod submits it to ISTD. The Jordan-specific point is that a refund in Shopify has to translate into a credit note in Qoyod, not an edit to the original invoice, because the system does not accept editing an issued invoice.

My store is custom-built, not on a ready-made platform. What now?

That is the majority case in Jordan, since survey data indicates roughly two-thirds of Jordanian stores are custom-built. The supported path is the API: you generate the integration key in Qoyod and hand it with the API documentation to your technical team. The same applies to OpenCart, which has no ready-made connector yet.

Is the order confirmation from my store enough as an invoice?

No. Article 4(a) of the 2019 regulation recognises only an invoice issued by the national e-invoicing programme or by a system linked to it. Anything outside that is not a tax document, so the buyer loses the input tax deduction and the expense is not recognised.

How do I handle returns in my store?

With a credit note, a return invoice referencing the original by ID, UUID and total with a mandatory free-text reason, adjusting quantities only and never exceeding the original quantity. An invoice cannot be edited after issuing, and there is no debit note in version 1.5 of the technical manual.

What is the difference between a cash and a receivable invoice for my store’s orders?

An order paid electronically at checkout is a cash invoice. A deferred B2B sale is a receivable invoice posted to the customer’s account, and Article 5(b) requires the buyer’s name stated clearly on deferred, instalment or staged sales. Cash on delivery is money in transit until the courier collects it, and treating it as cash from the first moment shows cash you do not hold.

Does my software generate the QR code on the invoice?

No. The QR comes back from the Income and Sales Tax Department once the invoice is accepted, and the software’s job is to submit the invoice, receive the code and print it. No taxpayer-side digital signature or encryption certificate is required. Verifying the code is done through the Sanad app, not any general QR reader.

Is there a minimum order value that needs an invoice?

Article 5(a) requires an invoice for every good or service worth one dinar or more. Small orders in your store are within scope, and batching them without documents is a known gap.

What if my store is not registered for general sales tax?

The obligation covers every seller of goods or provider of services, not only those registered for sales tax. An unregistered business issues an income invoice with no tax, a document type in its own right that your system has to recognise.

What is the penalty for selling with invoices outside the system?

The invoice is not accepted as a tax document, and the fine runs between 200 and 500 dinars per violation, doubling on repetition, plus exclusion from government tenders. Failing to issue a proper invoice is also listed in Article 66 of Income Tax Law No. 34 of 2014 among acts of tax evasion.

Do I need a test environment before going live?

There is no announced government test environment in the official manuals. The practical test is to issue one real low-value invoice, confirm the QR came back from ISTD, then cancel it with a credit note. That exercises the two paths you will need most.

Conclusion

A store platform and an accounting system are not substitutes for one another. The platform runs selling; the system runs the consequences of selling and carries the invoice to the department. In Jordan specifically, that second loop is not an administrative improvement but the condition on which every invoice you issue is valid.

Start with three steps this week: generate your integration data from the National Invoicing System portal using the main user, unify stock keeping units between your store and your system, then connect and test with one real order followed until its QR comes back.

To go further: how the National Invoicing System works if you are still mapping the mechanics, e-invoicing requirements in Jordan for the mandatory fields, and the tax invoice definition for the underlying concept.

This content is general guidance and does not replace advice from a licensed tax adviser. The final reference is the texts and manuals in force published on the Income and Sales Tax Department website.