Samir Sabri

<p><strong>TaxDebug for WooCommerce</strong> helps store owners debug, understand, trust, and report their taxes – especially when using WooCommerce Tax (automated taxes) or other tax calculation services.</p>
<h4>Key Features</h4>
<p><strong>Deep Tax Visibility</strong><br />
* See exactly how taxes were calculated for every order<br />
* View applied tax rates, line-item breakdowns, and calculation formulas<br />
* Understand which service/plugin produced each tax amount (WooCommerce Core, WooCommerce Tax, TaxJar, Avalara)</p>
<p><strong>Issue Detection Engine</strong><br />
* Automatically detect common tax problems:<br />
  * No tax collected where expected<br />
  * Tax charged in non-taxable regions<br />
  * Rate mismatches vs reference rates<br />
  * Missing local (county/city) taxes<br />
  * Tax changes between cart and checkout<br />
  * Suspected API errors</p>
<p><strong>Beautiful Dashboard & Reports</strong><br />
* Modern, responsive admin interface<br />
* Interactive charts showing tax by state, country, and over time<br />
* KPI cards for total tax, taxable sales, and effective rates<br />
* Powerful filtering by date, country, state, tax source, and more</p>
<p><strong>Order Explorer</strong><br />
* Search and filter all orders with tax data<br />
* View detailed tax debug information for any order<br />
* Identify orders with detected issues quickly</p>
<p><strong>Accountant-Friendly Exports</strong><br />
* Export summary reports by country/state<br />
* Export detailed order-level tax breakdowns<br />
* Export detected issues for review<br />
* CSV format compatible with Excel and accounting software</p>
<p><strong>Safe & Non-Intrusive</strong><br />
* Does NOT modify how taxes are calculated<br />
* Only observes, logs, and analyzes tax data<br />
* Works with any tax calculation method</p>
<p><strong>Feedback & Analytics</strong><br />
* In-app feedback widget to report false positives/negatives<br />
* Feature request and success story submissions<br />
* Privacy-first usage analytics (all data stored locally)<br />
* Deactivation survey to help improve TaxDebug<br />
* All feedback stored locally – no external tracking</p>
<h4>Compatibility</h4>
<p>TaxDebug works with:<br />
* WooCommerce Core tax rates<br />
* WooCommerce Tax (automated taxes via TaxJar)<br />
* TaxJar plugin<br />
* Avalara AvaTax<br />
* Other tax plugins</p>
<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>
<p>TaxDebug stores order tax data locally in your WordPress database. This includes:<br />
* Order IDs and dates<br />
* Customer billing/shipping addresses (country, state, city, postcode only)<br />
* Order totals and tax amounts<br />
* Tax calculation details</p>
<p>TaxDebug does NOT:<br />
* Store payment information<br />
* Store full customer names or personal details beyond address location</p>
<p>Data retention can be configured in Settings. You can also manually clear all logs at any time.</p>
<h4>Feedback Collection</h4>
<p>TaxDebug collects optional feedback to improve the plugin:</p>
<ul>
<li><strong>In-app feedback</strong>: Report false positives, false negatives, feature requests, or success stories</li>
<li><strong>Usage analytics</strong>: Anonymous local tracking of which features are used</li>
<li><strong>Deactivation survey</strong>: Optional one-question survey when deactivating</li>
</ul>
<p><strong>Local Storage</strong>: All feedback is always stored locally in your WordPress database.</p>
<p><strong>Optional Remote Sending</strong>: You can opt-in to send anonymous feedback to the developer to help improve TaxDebug. This is <strong>disabled by default</strong> and must be explicitly enabled in Settings.</p>
<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>
<p>Go to <strong>WooCommerce <span aria-hidden="true" class="wp-exclude-emoji">→</span> TaxDebug <span aria-hidden="true" class="wp-exclude-emoji">→</span> Settings</strong> and turn off “Send Anonymous Feedback”. You can do this at any time. Local feedback storage will continue to work.</p>
<h3>Developer Notes</h3>
<h4>Hooks & Filters</h4>
<p>TaxDebug provides several hooks for extensibility:</p>
<p><strong>Actions:</strong><br />
* <code>taxdebug_loaded</code> – Fired when TaxDebug is fully loaded<br />
* <code>taxdebug_order_logged</code> – Fired when an order is logged (params: log_id, order_id, payload)<br />
* <code>taxdebug_installed</code> – Fired on plugin installation<br />
* <code>taxdebug_logs_cleaned_up</code> – Fired when old logs are cleaned up</p>
<p><strong>Filters:</strong><br />
* <code>taxdebug_order_payload</code> – Filter the order payload before logging<br />
* <code>taxdebug_detected_issues</code> – Add custom issue detection rules</p>
<h4>REST API Endpoints</h4>
<p>TaxDebug provides a REST API under the <code>taxdebug/v1</code> namespace:</p>
<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>
<p>All endpoints require <code>manage_woocommerce</code> capability.</p>
<h4>Database Tables</h4>
<p>TaxDebug creates two custom tables:</p>
<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>
<p>(Coming in future versions)</p>


TaxDebug for WooCommerce

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

bowenac

<p>Upload Tax Rates is a tax plugin for woocommerce that imports tax rates to woocommerce based on State Zip Codes from free csv files that you can get at taxrates.com.</p>
<h4>Features include:</h4>
<ul>
<li>Upload tax rates by zip code</li>
<li>Rename woocommerce cart/checkout tax rate name “Wa Sales Tax, Tax, Sales Tax, What ever you want displayed for the tax tag”</li>
<li>View how many tax rates are currently installed and per state.</li>
<li>Enable/Disable tax on shipping</li>
</ul>


Tax Rate Upload

Tax Rate Upload makes importing tax rates to WooCommerce a one click process.

TaxDebug for WooCommerce vs Tax Rate Upload