Taxvoice – Tax Invoices for WooCommerce
| 开发者 | agencepixelweb |
|---|---|
| 更新时间 | 2026年11月3日 03:55 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Saudi Arabia – ZATCA Phase 1: Arabic “Simplified Tax Invoice” for consumers, full “Tax Invoice” when the buyer gives a VAT number, seller VAT number and CR, supply date and time, and the ZATCA QR code (seller name, VAT number, time stamp, total with VAT, VAT total, TLV + Base64).
- United Arab Emirates – FTA: “Tax Invoice” with the supplier TRN, the buyer TRN when registered, VAT per line and VAT also shown in AED with the exchange rate when you sell in another currency.
- Morocco – article 145 of the tax code: ICE, IF, RC, TP and CNSS of the seller, ICE of business buyers, VAT broken down per rate, payment method; French and Arabic on the same document.
- France: SIRET, SIREN, RCS, VAT number, legal form and capital, nature of the operation (goods, services or both), delivery address when it differs, client SIREN, late-payment penalties and the 40 € recovery fee for business buyers, “TVA non applicable, art. 293 B du CGI” and the VAT-on-debits option (mentions required from September 2026).
- International: a clean invoice for any other country, with optional VAT numbers.
- Sequential numbers without gaps or duplicates, even when two orders are paid at the same second.
- Invoices are frozen when issued: changing your settings later never alters an invoice already sent.
- Issue automatically when the order is paid or completed, or only by hand.
- PDF attached to the WooCommerce e-mails you choose.
- Download from the order screen, the orders list, My Account and the order page (guests use their private order link).
- Buyer VAT number / TRN / ICE / SIREN field in the classic checkout and the checkout block, checked against the country format.
- VAT summary per rate, discounts, shipping and fees.
- Logo, footer note, VAT exemption mention.
- Documents in English, Arabic and French whatever the language of your site.
- Compatible with High-Performance Order Storage (HPOS) and the checkout block.
- Layout can be changed by copying the template into your theme.
- No external service: invoices are created on your own server.
安装:
- Install and activate WooCommerce, then Taxvoice.
- Go to WooCommerce → Taxvoice.
- Choose your country profile and fill in your business details.
- Click Preview on my latest order to check the result.
屏幕截图:
常见问题:
Does Arabic really display correctly?
Yes. Taxvoice ships with a PDF engine that joins Arabic letters and lays out right-to-left text, and with the Tajawal font. Choose Arabic as first language for a right-to-left invoice, or as second language for a bilingual one.
Is the ZATCA QR code valid?
It holds the five fields required for Phase 1 (seller name, VAT number, time stamp, invoice total with VAT and VAT total), encoded as Tag-Length-Value and Base64, as ZATCA specifies. It can be read with the ZATCA “VAT” mobile application.
My shop does not sell in SAR or AED.
Enter the exchange rate in the settings: the VAT and the total are also printed in the local currency, and the QR code uses the local amounts. Developers can supply a live rate with the taxvoice_exchange_rate filter.
Can I change an invoice after it was issued?
No, and that is on purpose: tax rules require an issued invoice to stay as it is. Refund the order and issue a credit note (Pro), then a new invoice if needed.
Where are the PDF files stored?
Nowhere permanently. A PDF is built from the order each time it is opened. Copies attached to e-mails are written to wp-content/uploads/taxvoice/mail/ and deleted after one hour.
What happens to my invoices if I delete the plugin?
Settings and temporary files are removed. Invoice numbers stay on the orders, because they are accounting records, and the number counters are kept so that reinstalling Taxvoice continues the sequence without duplicates.
Can I change the layout?
Copy templates/document.php to yourtheme/taxvoice/document.php and edit the copy. Colors, styles, fonts and paper size can also be changed with filters (taxvoice_colors, taxvoice_document_css, taxvoice_pdf_config).
更新日志:
- The bundled PDF library no longer contains code that prints to the browser: Taxvoice reads the PDF as a string and sends it itself.
- The document styles are passed to the PDF engine separately from the template (new filter
taxvoice_document_css). - Every value printed by the template is escaped with
wp_kses(). - The setup reminder only shows on the Plugins screen and can be dismissed.
- Fix: product names that contain HTML (for example "" added by a theme or a variation plugin) are now printed as plain text. Names, addresses, shipping methods and notes are cleaned the same way.
- Fix: when another plugin changes the order total without adding an order line (store credit, gift card, currency or rounding tools), an "Adjustment" line now makes the lines, the VAT summary and the totals agree with the amount charged.
- Fix: negative fees (discounts added as fees) keep their minus sign.
- New: the setup check warns when the seller VAT number, TRN, ICE or SIRET does not have the expected number of digits.
- First release.