E-Invoicing for Saudi Arabia by ZATCA Tools

1. 01Upload the plugin and activate it, or install it from your WordPress dashboard.
2. 02Create an account and an API key at zatcatools.com (Settings > API).
3. 03In WooCommerce > Settings > ZATCA Tools, paste the API key and save.
4. 04A success message confirms the connection. Paid orders are now invoiced automatically.

Full guide: https://zatcatools.com/docs/woocommerce

Do I need an account with an external service?

Yes. This plugin is a connector for the ZATCA Tools e-invoicing service. You create a free account at zatcatools.com and connect it to ZATCA, then paste your API key into the plugin.

Do my customers see anything different at checkout?

Yes, one optional addition: a “Buying for a business” box where a VAT-registered buyer can enter their VAT number to receive a tax invoice in their company name. Consumers can ignore it. Everything else runs in the background.

Why does an order say it was not invoiced?

The most common reason is VAT. If WooCommerce taxes are disabled, or the order carried no VAT (or a rate other than 15%), the plugin refuses to issue a tax invoice rather than adding tax the buyer never paid. Open the ZATCA Tools screen in your admin menu — it names exactly what to fix and links to the right settings page.

How are business (B2B) invoices handled?

Saudi VAT requires a full tax invoice for a supply of SAR 1,000 or more to a VAT-registered buyer. So when an order carries a valid Saudi VAT number (from the checkout field, an existing VAT field, the customer’s profile, or the order note) plus the buyer’s national address, a standard cleared tax invoice is issued. Below SAR 1,000 the invoice stays simplified but still shows the buyer’s VAT number — the regulations permit a simplified invoice there for any buyer.

You can also mark an order (or a customer) as an establishment or an individual in the ZATCA e-invoice panel. Marking it as an establishment means “aim for the tax invoice, and tell me if you could not”: if the total is under SAR 1,000, or a required buyer detail is missing, the simplified invoice is still issued and the panel says exactly why it is not a tax invoice.

What about refunds and cancellations?

Refunding an order automatically issues a credit note against the original invoice, for the refunded amount.

Cancelling an order that was already invoiced issues a credit note for the invoice’s whole open balance. A tax invoice that ZATCA has accepted cannot be deleted — reversing it with a credit note IS the cancellation. If the order is cancelled before it was ever invoiced, nothing is issued and nothing is reported.

Putting that cancelled order back to a paid status issues a debit note for the same amount, so the invoice is due again. The credit note is not removed: every document reported to ZATCA is permanent, and the pair of them is the audit trail.