Accounting Sync with Wafeq for WooCommerce — invoices and contacts in Wafeq

Accounting Sync with Wafeq records WooCommerce sales in Wafeq, the accounting service for the UAE and Saudi Arabia. An order reaches the status you chose, and an invoice appears in Wafeq with a contact, your VAT rates and the place of supply. We found no ready connector: the Wafeq integrations directory has none, and the request for one has sat in their help center for four years.

This plugin has never worked with real Wafeq. The same author wrote that server, so it may repeat our mistakes. Try the plugin on a trial organization in Wafeq with drafts first.

The plugin makes no promise of legal compliance and is not accounting or tax advice. Check the VAT rates, the place of supply and the way of booking with your accountant.

What the buyer sees

The buyer sees nothing new: there are no checkout fields, and the classic and block checkout work as before. Sending runs in the background, so a Wafeq that does not answer does not hold up a purchase.

What the admin gets

You paste the API key of the organization and the plugin shows its name. Then you choose the statuses, draft or finalize, the language, the payment term and the default place of supply, and on the Mapping tab you match shop VAT rates to Wafeq rates and revenue accounts.

The order shows the document and its state, or the reason for a refusal, and a send button. The queue tab shows each document, and stopped ones can be sent again with one click.

In Pro payments are recorded and a refund becomes a credit note.

How it works, step by step

1. You create an API key in your Wafeq organization and paste it into the plugin.
2. You choose the statuses, draft or finalize, the place of supply.
3. On the Mapping tab you match VAT rates and revenue accounts.
4. An order reaches the status and the document joins the queue.
5. An invoice appears in Wafeq and its state on the order.
6. In Pro the payment and the credit note run by themselves.

Under the hood

• There is no go-between: the shop talks to Wafeq directly with your key.
• The key is kept encrypted and not shown back.
• Each creating request carries an idempotency key, and the plugin looks up the external number before creating.
• WooCommerce has no list of emirates, so the place of supply is read from the address text, then your default applies.
• The module does not cover ZATCA Phase 2 for Saudi Arabia.
• There is no invoice mailing: we found no such path in the Wafeq API.

How to install

1. Plugins → Add New → Upload Plugin: pick the zip and activate.
2. WooCommerce → Accounting Sync: paste the Wafeq API key and save.
3. Choose the statuses, the mode and the default place of supply.
4. On the Mapping tab match VAT rates and revenue accounts.
5. Place a test order in draft mode.
6. For Pro: paste the key or start the 7-day trial.

The module is not on wordpress.org yet: the free version and Pro are one archive from this page. Without a key it works as the free version.