Deskripsi
Tax‑Proof Coupons for WooCommerce lets you define an eligible fixed-cart coupon as a gross amount: the amount your customer should actually see deducted after tax.
What does it do?
The plugin adds an Apply coupon after tax checkbox to the coupon editor. It can be enabled only for fixed-cart coupons. When the option is enabled, each part of the coupon is converted using the tax rate of the product line it discounts.
For example, a 35.00 EUR coupon reduces eligible products by 35.00 EUR including tax, within the configured currency precision. WooCommerce still stores the required net discount and tax portion internally.
This is useful when a fixed promotional value should not become larger or smaller merely because eligible products use different VAT rates or the customer’s tax location changes.
What are the limits?
- Only fixed-cart coupons with Apply coupon after tax enabled are changed. For other coupon types, the option is disabled and explains why it is unavailable; those coupons keep WooCommerce’s native behavior.
- The effective discount cannot exceed the value of the eligible product lines. Shipping, fees, excluded products, and other non-discountable amounts do not increase that limit.
- Displayed and stored amounts follow WooCommerce’s configured currency precision and rounding.
- The plugin does not choose tax rates, change product prices, replace a tax engine, or provide tax or legal advice.
Compatibility
Version 1.0.9 is tested with WordPress 7.0, WooCommerce 10.9.4, Checkout Block, High-Performance Order Storage (HPOS), Germanized 4.0.10, and Germanized Pro/StoreaBill 4.3.4. The 1.0.9 admin change does not alter the invoice or coupon calculation paths verified with finalized StoreaBill PDFs in 1.0.8. Dedicated compatibility paths exist for WPML/WooCommerce Multilingual and Germanized Pro/StoreaBill. Compatibility still depends on the versions and configuration used by the store; report reproducible conflicts through the GitHub issue tracker or WordPress.org support forum.
Instalasi
- Upload the
taxproof-coupons-for-woocommercefolder to/wp-content/plugins/. - Activate the plugin from the Plugins screen in WordPress.
- In WooCommerce Coupons, edit a fixed-cart coupon and check Apply coupon after tax.
Tanya Jawab
-
Why is this needed?
-
WooCommerce calculates fixed-cart discounts as net values before tax. If the amount entered by a shop owner is intended as a gross promotional value, its visible effect can otherwise vary with the applicable tax rate. This plugin performs the gross-to-net conversion for enabled coupons while leaving WooCommerce responsible for tax calculation.
-
Do I need to recreate existing coupons after updating?
-
No. Valid fixed-cart settings remain unchanged. If a coupon was changed to an unsupported type while an old after-tax flag remained stored, version 1.0.9 shows the option as disabled and removes that inactive flag the next time the coupon is saved.
-
The after-tax conversion currently supports fixed-cart coupons only. Percentage and fixed-product coupons keep WooCommerce’s native behavior. Support for fixed-product coupons requires separate per-item calculations and is tracked in GitHub issue #18 for the 1.1.0 roadmap.
-
What happens if the coupon is larger than the eligible products?
-
The discount is capped at the discountable gross value of the eligible product lines. It does not create a negative payable amount or consume shipping and fees merely to reach the configured coupon value.
-
Does it work with products that have different tax rates?
-
Yes. The plugin allocates the coupon across eligible product lines and converts each share using that line’s tax rate. The final displayed value is subject to WooCommerce currency precision and rounding.
-
Does the plugin change my tax rates or guarantee tax compliance?
-
No. WooCommerce and the store’s tax configuration determine the rates. The plugin only changes how an enabled fixed-cart coupon is converted into WooCommerce’s net discount values. Store owners remain responsible for validating their tax and invoice setup.
Ulasan
Kontributor & Pengembang
“Tax‑Proof Coupons for WooCommerce” adalah perangkat lunak open source. Berikut ini mereka yang sudah berkontribusi pada plugin ini.
Kontributor
Terjemahkan “Tax‑Proof Coupons for WooCommerce” dalam bahasa Anda.
Tertarik mengembangkan?
Lihat kode, periksa repositori SVN , atau mendaftar ke log pengembangan melalui RSS.
Log Perubahan
1.0.9
Release date: July 22, 2026
- For store owners: The after-tax checkbox is now available only for fixed-cart coupons. Selecting another coupon type immediately disables and clears it and shows a plain-language explanation.
- For developers: Enforce the fixed-cart restriction again during persistence, remove stale metadata for unsupported types, and reject malformed checkbox input.
- Added admin-state regressions plus real LocalWP coupon-editor, Cart Block, Checkout Block, tax-matrix, and release-content smoke coverage.
1.0.8
Release date: July 22, 2026
- For store owners: Fixed a possible one-cent difference in StoreaBill’s aggregate invoice discount for small gross coupons in mixed-tax orders. Invoice totals, taxes, and coupon settings remain unchanged.
- For developers: Resolve StoreaBill’s nested invoice/order wrappers before reading persisted WooCommerce coupon metadata.
- Added a StoreaBill wrapper-contract regression and verified synchronized, finalized PDFs with Germanized Pro/StoreaBill 4.3.4.
1.0.7
Release date: July 22, 2026
- For store owners: Added a plain-language explanation, a gross-discount example, clearer limits, and upgrade guidance. No coupon calculation or setting changed in this release.
- For developers: Documented the exact WooCommerce calculation boundary and qualified compatibility claims.
- Corrected the installation folder name and historical release dates.
1.0.6
Release date: July 22, 2026
- For store owners: Fixed negative saved order totals in the WPML/WCML path, mixed-tax carts, oversized coupons, and unstable results during repeated cart calculations.
- For developers: Added per-line gross allocation, reset state for every WooCommerce coupon distribution, corrected the checkout coupon-item hook, and made persistence HPOS-safe.
- Preserved native WooCommerce behavior when catalog prices include tax.
- Added automated unit, cart, Checkout Block, HPOS, Advanced Dynamic Pricing, and WPML-contract regression tests.
1.0.5
Release date: March 7, 2026
- Refactored the plugin into a cleaner core service plus isolated WPML and StoreaBill compatibility layers.
- Fixed fixed-cart coupons whose configured gross amount is larger than the discountable cart total.
- Removed release-time debug logging and broad total-manipulation hooks that caused rounding drift in edge cases.
- Persist the gross, net, and tax components on order coupon items so Germanized Pro / StoreaBill can invoice consistently.
- Keep the displayed coupon amount capped to the effective gross discount that can actually be applied.
1.0.4
Release date: October 20, 2025
- Verbesserte Präzision: Neue präzise Berechnungsmethode für exakte Steuerumrechnungen
- Erweiterte Anzeige-Funktionen: Verbesserte Coupon-Anzeige im Warenkorb und Checkout
- StoreaBill/Germanized Pro Integration: Vollständige Kompatibilität mit Germanized Pro für Rechnungsgenerierung
- Admin-Verbesserungen: Detaillierte Anzeige von Netto- und Bruttobeträgen in der WooCommerce Admin-Oberfläche
- Erweiterte Metadaten-Speicherung: Präzise Speicherung von Coupon-Beträgen mit hoher Genauigkeit
- Debug-Funktionen: Erweiterte Logging-Funktionen für bessere Entwicklung und Fehlerbehebung
- Hook-Integration: Neue Hooks für bessere Integration mit WooCommerce und Drittanbieter-Plugins
- Performance-Optimierungen: Verbesserte Berechnungslogik für komplexe Steuerszenarien
1.0.3
Release date: August 11, 2025
- Ensuring unique namespace
- Added Requires plugins plugin header
1.0.2
Release date: July 25th 2025
- Fixed class and method visibility issues.
- Ensured coupon only applies once per order.
- Initial implementation of gross-to-net conversion for fixed-cart coupons.