Search for an article
3 min read

How to integrate and push e-invoice with Fatoora

Summary

E-invoicing in Saudi Arabia is regulated by ZATCA through two implementation phases. Phase 1, effective from December 2021, required businesses to generate and store electronic invoices using compliant systems. Phase 2, the Integration Phase, mandates direct integration of invoicing systems with the FATOORA portal to transmit invoices to ZATCA at the time of issuance. Under this phase, all tax invoices and credit notes must be cryptographically stamped and either cleared (for B2B transactions) or reported (for B2C transactions). Cleared invoices receive a cryptographic stamp and QR code issued by ZATCA, while reported invoices include a seller-generated stamp and QR code for later validation. Compliance is based on annual revenue thresholds, and businesses notified by ZATCA must adhere to these requirements to avoid penalties. Zoho POS supports compliance by automatically generating the required XML structure, applying cryptographic stamps, embedding QR codes, and enabling secure communication with the FATOORA portal. A one-time setup is needed to link the Zoho POS account with FATOORA credentials and ensure all mandatory fields are correctly populated. Required fields include seller and buyer details (including VAT registration numbers), invoice date and sequence number, line-item descriptions, VAT rates and amounts, total values inclusive and exclusive of VAT, QR code, and cryptographic stamp. Zoho POS auto-populates most data from the organization profile and inventory, but all information must be available in Arabic. To integrate, businesses must generate an OTP in the FATOORA portal and use it in Zoho POS under Settings > Taxes & Compliance > e-Invoicing to generate a Cryptographic Stamp Identifier (CSID). The CSID is temporary and must be renewed periodically. Once linked, invoices can be pushed to FATOORA manually or in bulk via Sales > Invoices. Statuses include Yet-to-be Pushed, Push Initiated, Pushed, or Failed. Failed invoices can be resubmitted after resolving the issue, identified through error messages in the ZATCA Status field. Zoho POS allows submission even with minor warnings, which are resolved once corrections are made. This ensures accurate and efficient compliance with ZATCA’s e-invoicing requirements.
This content is generated by

Overview

E-invoicing in Saudi Arabia is enforced in two phases. Phase 1, which came into effect in December 2021, required businesses to generate and store electronic invoices using compliant software. Phase 2, known as the Integration Phase, goes further: it requires taxpayers to integrate their invoicing systems directly with ZATCA's FATOORA portal so that invoices are shared with the authority at the time of issuance.

Under Phase 2, every tax invoice and credit note generated at your point of sale must be cryptographically stamped, transmitted to ZATCA, and either cleared (for B2B transactions) or reported (for B2C transactions) before or immediately after being issued to your customer.

  • A cleared invoice carries a ZATCA-issued cryptographic stamp and a QR code.

  • A reported invoice carries a seller-generated cryptographic stamp and a QR code that ZATCA validates after the fact.

Phase 2 targets different groups of taxpayers based on their annual revenue. If your business has been notified by ZATCA that you fall within a particular revenue, you are required to comply with ZATCA. Failure to comply can result in financial penalties.

How does Zoho POS help you comply?

Zoho POS handles the technical requirements of Phase 2 on your behalf. It generates the mandatory XML structure for each invoice, applies the cryptographic stamp, embeds the QR code, and helps you communicate them with the FATOORA portal. Your responsibility is to complete the one-time configuration that links your Zoho POS account to your FATOORA portal credentials, and to ensure that every invoice includes the mandatory fields ZATCA requires.

Invoice types and their treatment under Phase 2

  • Standard tax invoices (B2B): These are cleared invoices. These invoices need to be submitted to ZATCA before they are issued to the buyer. ZATCA validates and returns a cleared stamp, which is then embedded in the invoice.

  • Simplified tax invoices (B2C): These are reported invoices. These invoices can be generated and issued to customers with a QR code, but should be reported to ZATCA within 24 hours.

Mandatory fields required by ZATCA

Every invoice submitted through Zoho POS under Phase 2 must include the following:

  • Seller's name, address and VAT registration number

  • Buyer's name, address and VAT registration number (for B2B invoices)

  • Invoice date and time

  • Invoice sequence number

  • Line-item descriptions, quantities, and unit prices

  • Applicable VAT rate and VAT amount per line

  • Total amount inclusive and exclusive of VAT

  • QR code

  • Cryptographic stamp

Notes

Zoho POS auto-populates all the mandatory fields from your organization profile and inventory. Item Name, Customer details and Billing address should be available in Arabic language.

Integrate Zoho POS with FATOORA

ZATCA requires each point-of-sale application to be individually integrated with the FATOORA portal before it can submit invoices. This process generates a Cryptographic Stamp Identifier (CSID) for each device. The CSID is what authorizes that specific device to clear or report invoices with ZATCA.

You have to generate OTP in the Fatoora portal first to generate CSID in Zoho Invoice.

Notes

Before you link the FATOORA portal, make sure your Zoho POS organization profile contains your VAT registration number and a valid commercial registration number. These values are embedded in every invoice you generate.

Generate OTP in Fatoora portal

Log in to the Fatoora portal.

Click Onboard New Solution Unit/Device.

Enter the number of devices for which you want to generate OTP. If you're using only Zoho POS, enter 1.

Your OTP will be generated in the portal and you can copy or export it as a file.

Notes

The OTP generated from the Fatoora portal will be valid only for one hour.

Link Zoho POS with Fatoora portal

Navigate to Settings → Taxes & Compliance and select e-Invoicing.

Click Generate CSID.

Enter the OTP and click Generate CSID.

Notes

CSID is temporary, it will expire eventually. Once expired you have to renew it in the Fatoora portal by selecting the Renew Existing Cryptographic Stamp Identifier option. Then, go to Settings → Taxes & Compliance → e-Invoicing and click Renew CSID.

Push invoice to FATOORA

Once your account is linked with Fatoora portal, invoice/credit note will have the following statuses:

StatusDescription
Yet-to-be PushedThe transaction is not yet pushed to the Fatoora portal.
Push InitiatedThe push has been initiated to the Fatoora portal.
PushedThe transaction has been pushed to the Fatoora portal successfully.
FailedThe transaction has not been pushed to the Fatoora portal.

If the status of your invoice is Yet-to-be Pushed, you need to push the invoice to the Fatoora portal manually.

Navigate to Sales → Invoices and select the invoice that you want to push to the Fatoora portal.

Click Push to Fatoora.

Click Push again in the pop-up screen.

Bulk Push Invoices

Navigate to Sales → Invoices.

Select the invoices that you want to push to the Fatoora portal and select Push to Fatoora.

Notes

Invoices can be pushed to Fatoora even if they contain minor errors. These errors are displayed as warnings in the invoice and do not prevent the invoice from being submitted. The warnings will disappear once you resolve the reported issues.

Resubmit failed invoices

If the status of your invoice is failed, check the error message displayed under the ZATCA Status field to identify the reason for failure and rectify it before pushing it again to the Fatoora portal.

To resubmit failed invoices,

Navigate to Sales → Invoices.

Select the invoice with a Failed status and click Push to Fatoora.

Zoho POS will push the invoice again and the status will update once ZATCA responds.

Last modified

Related Articles

Did you find this article helpful?

Not able to find what you are looking for? Let us Know
×Zoomed Image