Samir Sabri

TaxDebug for WooCommerce helps store owners debug, understand, trust, and report their taxes – especially when using WooCommerce Tax (automated taxes) or other tax calculation services.
<h4>Key Features</h4>
Deep Tax Visibility 
* See exactly how taxes were calculated for every order 
* View applied tax rates, line-item breakdowns, and calculation formulas 
* Understand which service/plugin produced each tax amount (WooCommerce Core, WooCommerce Tax, TaxJar, Avalara)
Issue Detection Engine 
* Automatically detect common tax problems: 
 * No tax collected where expected 
 * Tax charged in non-taxable regions 
 * Rate mismatches vs reference rates 
 * Missing local (county/city) taxes 
 * Tax changes between cart and checkout 
 * Suspected API errors
Beautiful Dashboard & Reports 
* Modern, responsive admin interface 
* Interactive charts showing tax by state, country, and over time 
* KPI cards for total tax, taxable sales, and effective rates 
* Powerful filtering by date, country, state, tax source, and more
Order Explorer 
* Search and filter all orders with tax data 
* View detailed tax debug information for any order 
* Identify orders with detected issues quickly
Accountant-Friendly Exports 
* Export summary reports by country/state 
* Export detailed order-level tax breakdowns 
* Export detected issues for review 
* CSV format compatible with Excel and accounting software
Safe & Non-Intrusive 
* Does NOT modify how taxes are calculated 
* Only observes, logs, and analyzes tax data 
* Works with any tax calculation method
Feedback & Analytics 
* In-app feedback widget to report false positives/negatives 
* Feature request and success story submissions 
* Privacy-first usage analytics (all data stored locally) 
* Deactivation survey to help improve TaxDebug 
* All feedback stored locally – no external tracking
<h4>Compatibility</h4>
TaxDebug works with: 
* WooCommerce Core tax rates 
* WooCommerce Tax (automated taxes via TaxJar) 
* TaxJar plugin 
* Avalara AvaTax 
* Other tax plugins
<h4>Requirements</h4>
<ul>
<li>WordPress 5.8 or higher</li>
<li>WooCommerce 5.0 or higher</li>
<li>PHP 7.4 or higher</li>
</ul>
<h3>Privacy</h3>
TaxDebug stores order tax data locally in your WordPress database. This includes: 
* Order IDs and dates 
* Customer billing/shipping addresses (country, state, city, postcode only) 
* Order totals and tax amounts 
* Tax calculation details
TaxDebug does NOT: 
* Store payment information 
* Store full customer names or personal details beyond address location
Data retention can be configured in Settings. You can also manually clear all logs at any time.
<h4>Feedback Collection</h4>
TaxDebug collects optional feedback to improve the plugin:
<ul>
<li>In-app feedback: Report false positives, false negatives, feature requests, or success stories</li>
<li>Usage analytics: Anonymous local tracking of which features are used</li>
<li>Deactivation survey: Optional one-question survey when deactivating</li>
</ul>
Local Storage: All feedback is always stored locally in your WordPress database.
Optional Remote Sending: You can opt-in to send anonymous feedback to the developer to help improve TaxDebug. This is disabled by default and must be explicitly enabled in Settings.
<h4>What IS Sent (When Opted-In)</h4>
<ul>
<li>Anonymous store UUID (random identifier, NOT your domain)</li>
<li>Feedback type and message</li>
<li>Your email (only if you voluntarily provide it)</li>
<li>Store country and currency</li>
<li>Active tax plugin (e.g., TaxJar, Avalara)</li>
<li>Plugin, WordPress, and WooCommerce versions</li>
<li>Daily aggregated counts: orders logged, issues detected, features used</li>
</ul>
<h4>What is NEVER Sent</h4>
<ul>
<li>Your site URL or domain name</li>
<li>Customer names, emails, or addresses</li>
<li>Order details, totals, or line items</li>
<li>Tax amounts or financial data</li>
<li>Any personally identifiable information (PII)</li>
</ul>
<h4>How to Disable Remote Sending</h4>
Go to WooCommerce → TaxDebug → Settings and turn off “Send Anonymous Feedback”. You can do this at any time. Local feedback storage will continue to work.
<h3>Developer Notes</h3>
<h4>Hooks & Filters</h4>
TaxDebug provides several hooks for extensibility:
Actions: 
* <code>taxdebug_loaded</code> – Fired when TaxDebug is fully loaded 
* <code>taxdebug_order_logged</code> – Fired when an order is logged (params: log_id, order_id, payload) 
* <code>taxdebug_installed</code> – Fired on plugin installation 
* <code>taxdebug_logs_cleaned_up</code> – Fired when old logs are cleaned up
Filters: 
* <code>taxdebug_order_payload</code> – Filter the order payload before logging 
* <code>taxdebug_detected_issues</code> – Add custom issue detection rules
<h4>REST API Endpoints</h4>
TaxDebug provides a REST API under the <code>taxdebug/v1</code> namespace:
<ul>
<li><code>GET /logs</code> – Get tax logs with filtering</li>
<li><code>GET /logs/{id}</code> – Get single log</li>
<li><code>GET /logs/order/{order_id}</code> – Get log by order ID</li>
<li><code>POST /logs/reanalyze/{order_id}</code> – Re-analyze an order</li>
<li><code>GET /issues</code> – Get detected issues</li>
<li><code>GET /stats/dashboard</code> – Get dashboard statistics</li>
<li><code>GET /stats/chart/time</code> – Get time series chart data</li>
<li><code>GET /stats/chart/state</code> – Get tax by state data</li>
<li><code>GET /stats/chart/country</code> – Get tax by country data</li>
<li><code>GET /export/summary</code> – Export summary CSV</li>
<li><code>GET /export/detailed</code> – Export detailed CSV</li>
<li><code>GET /export/issues</code> – Export issues CSV</li>
</ul>
All endpoints require <code>manage_woocommerce</code> capability.
<h4>Database Tables</h4>
TaxDebug creates two custom tables:
<ul>
<li><code>{prefix}taxdebug_logs</code> – Stores order tax log data</li>
<li><code>{prefix}taxdebug_issues</code> – Stores detected issues</li>
<li><code>{prefix}taxdebug_feedback</code> – Stores user feedback submissions</li>
<li><code>{prefix}taxdebug_analytics</code> – Stores usage analytics</li>
<li><code>{prefix}taxdebug_error_logs</code> – Stores internal error logs</li>
</ul>
<h4>WP-CLI Commands</h4>
(Coming in future versions)

TaxDebug for WooCommerce

A tax debugging and reporting tool for WooCommerce. Debug tax issues, understand calculations, and generate audit-ready reports.

TaxDebug for WooCommerce vs EU/UK VAT Validation Manager for WooCommerce