ZATCA E-Invoice for WooCommerce

Changelog

2.4.1

• The license files of the bundled libraries (mPDF, FPDI, psr/log, php-qrcode and others) are included again. The 2.3.2-2.4.0 builds left them out.

2.4.0

• New (premium): PDF invoice appearance options in the PDF Invoice tab: primary color, font size (9-12 pt), logo and QR code alignment, the product SKU under each product, and the customer’s order note. The fields required by ZATCA and the QR code are always shown.
• Improved: Arabic text in the PDF invoice now uses the Tajawal font (SIL Open Font License, bundled in assets/fonts/tajawal). The invoice already asked for it, but the font was missing, so mPDF fell back to DejaVu Sans.

2.3.3

• Fixed (premium): the “QR Code Size” setting was saved but never used, so the QR code was always 150 pixels. It now applies to the QR code on the order page, in order emails, in the [zeiw_order_qr] shortcode and in the supported PDF invoice plugins. The plugin’s own PDF invoice keeps its 150 pixel layout.
• Fixed: the width attribute of the [zeiw_order_qr] shortcode is now honored. Without it, the size from the settings is used.
• Fixed: the installation steps in the readme pointed to a Settings menu that does not exist. The plugin has its own “Zatca QR Fatora” menu.
• Fixed Arabic translations: “Customer Access”, the PDF invoice section description, the license key description, and a few spelling mistakes.

2.3.2

• Fixed: the bundled libraries required PHP 8.1, so on PHP 7.4 and 8.0 the plugin stopped the site with “Composer detected issues in your platform”, although PHP 7.4 is supported. They are now built for PHP 7.4.
• Improved: the bundled libraries (mPDF, FPDI, psr/log, php-qrcode) now use the plugin’s own ZEIW\Vendor namespace, so another plugin shipping a different version of them can no longer break the PDF invoices or QR codes.
• Updated mPDF to 8.3.1 and FPDI to 2.6.8.

2.3.1

• Security: PDF invoices and credit notes contain customer data but were saved at predictable public paths (uploads/zatca/pdf-invoices/invoice-{order}.pdf). The .htaccess rule only protects them on Apache, so on Nginx anyone could download them by guessing the order number. Each PDF is now stored in its own folder named from a site secret, so its address cannot be guessed on any server. Downloads keep going through the permission checked links.
• Security: existing PDFs are moved to the protected folders automatically after the update, unchanged, in batches of 200 per request.
• Fixed: the .htaccess rules now also work on Apache 2.4 without mod_access_compat, and index.php files prevent directory listings.
• ZEIW_Pdf_Invoice_Generator::get_invoice_file_url() now returns the permission checked download link instead of the file’s public address.

2.3.0

• New: optional integration hooks for ZATCA Phase 2 plugins. When such a plugin is active, the QR code, invoice/credit note number, issue date and embedded XML can come from the invoice it reported to ZATCA. Nothing changes when no Phase 2 plugin is installed.
• New: zeiw_document_data filter for the invoice/credit note data before the PDF is rendered.
• New: zeiw_qr_data receives the refund when the QR code is for a credit note; zeiw_pdf_invoice_xml_filepath also applies to credit notes and receives the refund.
• New: a cached PDF is regenerated when a Phase 2 plugin fires zatca_wc_document_changed.
• New: zeiw_document_available filter. A Phase 2 plugin can hold back the QR code, PDF, downloads and email attachments of an order until it has issued the e-invoice, so customers never receive a document that differs from the one reported to ZATCA. Always available when no Phase 2 plugin is installed.

2.2.0

• Fixed: Invoice PDF and QR code timestamps now consistently use the site’s configured timezone instead of mixing UTC and local time.
• Fixed: VAT percentage on invoices now uses the order’s actual tax rate when available, avoiding rounding artifacts (e.g. 14.94% instead of 15%) on small-value orders.

2.0.1 (2026-06-09)

• Fixed a fatal error that occurred in the free version due to missing license manager files.

2.0.0 (2026-05-20)

• Major licensing update: Transitioned to Freemius for a better user experience and easier premium feature management.
• Enhanced settings page.
• Important: Existing premium users will be seamlessly migrated to the new licensing system.

1.0.1 (2025-12-27)

• Fixed WordPress plugin repository compatibility issue
• Fixed QR code image in account orders page

1.0.0 (2025-12-01)

• Initial release
• QR code generation for ZATCA compliance
• PDF invoice generation
• Email and My Account integration
• HPOS compatibility