=== CatCode Sales Tax Nexus Monitor for WooCommerce ===
Contributors: catcodestudio
Tags: sales tax, economic nexus, wayfair, us tax, woocommerce
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

See how close your WooCommerce sales are to the economic nexus threshold of every US state. No API keys, no outside service.

== Description ==

Since South Dakota v. Wayfair (2018), a US state can ask an out-of-state seller to collect its sales tax once the seller's sales into that state pass a set level. The level, the period and what counts differ from state to state, and they keep changing: Illinois dropped its 200-transaction test on 1 January 2026, Kentucky on 1 August 2026.

This plugin holds your orders against those thresholds and shows where you stand. It runs entirely inside your site: nothing is sent anywhere and no account is needed.

**This is information, not tax or legal advice.** The table summarizes each state's published rule on the date shown next to it, and the state's own text decides. Talk to a tax professional before you register or stop collecting.

= What it shows =

* All 50 states, Washington DC and Puerto Rico, with the threshold, the period it is measured over and your sales and transactions in that period.
* A status for each one: below, approaching (you choose the share, 80% by default), threshold reached, no sales, no sales tax.
* For each state: the figures of every period tested, what the state counts, how marketplace sales are treated, since when the rule is in force, and a link to the state source with the date it was checked.
* A notice in the admin when a state reaches its threshold.

= How it counts =

* Reads WooCommerce orders by shipping state, or billing state when there is no shipping address. Works with High-Performance Order Storage and with classic order storage.
* Follows each state's own window: previous or current calendar year, previous calendar year, the last 12 months, 12 months to the last finished quarter, Connecticut's year to 30 September, New York's four sales tax quarters.
* Refunds lower the sales of the month they were made in. You choose which order statuses count and whether shipping and tax go into sales.
* Orders in other currencies count at the rate you enter; without a rate they are left out and the screen says so.
* Orders are read once a day, or when you press the button.

= What it cannot know =

* Sales outside this store (marketplaces, in person, another site) are not in WooCommerce.
* Whether each sale is taxable, exempt or for resale. The monitor counts all your sales, so in a state that counts only taxable or retail sales your real figure may be lower. Each state's line tells you what the state counts.
* Whether you already have a physical or other tie to a state. Thresholds are about economic nexus only; a warehouse, staff or inventory in a state can create nexus with no sales threshold at all.
* Local tax rules, which the table does not cover. Alaska has no statewide sales tax, and its line applies to municipalities in the Alaska Remote Seller Sales Tax Commission.

= Where the thresholds come from =

The table ships with the plugin as data, one row per state, each with its source and the date checked. The sources are the states' own pages, statutes and rulings. Where a state site could not be read directly, the row says it was read on an archived copy and gives that copy's date. The plugin warns you when the table has gone 120 days without a review. Updates of the table arrive as plugin updates.

// @pro-begin
= Pro =

Sold on [catcode.com.ua](https://catcode.com.ua/modules/sales-tax-nexus-monitor-woocommerce/) with a 7-day trial:

* **E-mail alerts** when a state approaches or reaches its threshold.
* **Registration tracker**: mark the states where you hold a permit, with the date and account number. Those states stop asking for attention.
* **Other sales**: add marketplace, in-person and other-site sales by state and month, so they count in the monitor.
* **CSV exports** for your accountant: the state summary and the month-by-month figures.

// @pro-end
== Installation ==

1. Install and activate the plugin. WooCommerce must be active.
2. Open WooCommerce → Sales Tax Nexus.
3. If you sell in another currency, enter its rate to US dollars under Settings.

== Frequently Asked Questions ==

= Does this calculate or collect tax? =

No. It only compares your sales with published thresholds. It does not change tax at checkout.

= Is this tax advice? =

No. It is information to help you ask the right questions. The state's own text decides, and a tax professional can apply it to your business.

= Does it send my orders anywhere? =

No. Everything is worked out on your own site. The state links open only when you click them.

= I reached a threshold. What now? =

Open the state's line, read its source and talk to a tax professional. The plugin does not register you anywhere.

= My store does not use US dollars. =

Enter a rate under Settings. Orders without a rate are left out and the monitor says which currencies are missing.

== Screenshots ==

1. The monitor: every state with its threshold, your sales and the status.
2. A state opened: the periods tested, what the state counts and the source.
3. Settings.

== Changelog ==

= 1.0.0 =
* First release. Thresholds reviewed on 31 October 2026.
