Integrations & e-invoicing

Connect government tax e-invoicing for your country.

By ArabyCRM

• 3 articles

Connect government e-invoicing (JoFotara, ZATCA, ETA, UAE FTA)

On Business and Pro plans you can connect your country's government tax e-invoicing system in Settings → Integrations, then report invoices to the authority with a compliant QR code. Jordan (JoFotara), Saudi Arabia (ZATCA, test mode), Egypt (ETA, test mode), and the UAE (FTA / PINT AE, test mode) are all available today. 1. In JoFotara, sign in at portal.jofotara.gov.jo with your tax number, username, and password. Connect government e-invoicing (JoFotara, ZATCA, ETA, UAE FTA) 2. Open Integrate Device (ربط الأجهزة) → Create New Integration. JoFotara generates your Client ID, Client secret, and income source — copy all three. Connect government e-invoicing (JoFotara, ZATCA, ETA, UAE FTA) 3. In ArabyCRM, open Settings → Integrations (workspace owners and admins only). 4. Find the JoFotara (Jordan) card and click Connect. 5. Paste the Client ID, Client secret, and income source, plus your registered business name and tax number (TIN). 6. Leave Test mode on while you try things out — invoices are built and validated but NOT sent to the authority. 7. Click Save. The card shows Connected with an on/off switch you can pause any time. Your credentials are encrypted and never shown again — leave a secret field blank when editing to keep the stored value. After you link devices in JoFotara, that income source is invoiced through ArabyCRM (not the JoFotara portal). Saudi Arabia (ZATCA) only asks for your registered business name and 15-digit VAT number, Egypt (ETA) only asks for your business name, tax registration number, taxpayer activity code, and branch ID, and the UAE (FTA) only asks for your registered business name and Tax Registration Number (TRN) — none of the three needs a portal login, and all currently run in Test mode only (invoices are built and validated, not sent to the authority). Free and Starter plans see an upgrade prompt instead. Tip: Turn Test mode off only once you're ready to send real invoices to the tax authority (live ZATCA/ETA/UAE FTA submission is not available yet).

Last updated on Aug 07, 2026

Report an invoice to the tax authority

Once a tax e-invoicing provider (JoFotara or ZATCA) is connected and turned on, you can report any sent invoice to the authority. The returned QR code and identifiers are stored and printed on the invoice PDF — in Arabic or English. Report an invoice to the tax authority 1. Open an invoice that is no longer a draft (sent, paid, or overdue). 2. In the Tax e-invoicing panel, click Report to tax authority. 3. The status updates to Reported (or Test submission in Test mode) and a QR code appears with the authority UUID. 4. Download or print the invoice — the QR code and identifiers appear on the document automatically. An invoice already accepted by the authority is never reported twice. If the authority is temporarily unreachable, your invoice is unaffected — just try again later. Tip: The e-invoice block only appears on invoices you've reported, so your other invoices stay clean.

Last updated on Aug 07, 2026

Report a credit note (return) to the tax authority

When a customer returns goods or you cancel a reported invoice, you can report a credit note (tax document type 381) that reverses the original with the authority. The credit note references the reported invoice and gets its own QR code and identifiers. Report a credit note (return) to the tax authority 1. Open an invoice you have already reported to the tax authority (status Reported or Test submission). 2. In the Tax e-invoicing panel, find the Credit note (return) section below the invoice status. 3. Enter a short reason for the return (for example, “Customer returned the goods”). 4. Optionally click Preview credit note XML to review the exact document before sending. 5. Click Report credit note. The status updates to Reported (or Test submission) with its own QR code and authority UUID. A credit note can only be reported after the invoice itself is reported, and is never reported twice once accepted. The exact XML sent to the authority is stored for your audit trail — download it any time with Download reported XML. Tip: Keep the return reason clear and specific — the authority stores it with the credit note.

Last updated on Aug 07, 2026