Sales by State Report for FluentCart

Sales by State Report for FluentCart adds a report showing net and gross sales grouped by state, county, or province, for a chosen year and a chosen set of order statuses. It appears under FluentCart → Sales by State. Use it when you need to know how much each state bought in a given year, counting only the order statuses that matter for sales tax or territory planning. This plugin requires FluentCart. There are no settings screens to configure. After you activate the plugin, open the report and choose a country, year, and order statuses. Documentation: salesbystate.com How to use

1. Install and activate FluentCart, then install and activate this plugin.
2. Go to FluentCart → Sales by State.
3. Choose a country, a year, and the order statuses that should count.
4. The table lists Net Sales and Gross Sales for every state in that country.

If the store already has orders, the plugin copies them into its report table in the background. A progress bar appears until that finishes. You can leave the page; the copy continues on its own. What the report shows

• Net Sales and Gross Sales for every state in the selected country
• A summary of both figures across all states
• Sortable columns and paginated results
• States with no sales, shown as zero instead of being hidden

Filters

• Country — any country FluentCart defines states or provinces for. Defaults to the store's base country.
• Year — starts ten years before the current year. Each January a new year is added; earlier years stay on the list. Defaults to the current year.
• Order status — a checkbox list of FluentCart order statuses. Defaults to Completed.

How the figures are calculated Gross Sales is the order total. Net Sales is the order total minus tax and shipping. Both use the values FluentCart stores on the order (converted from cents). Refunds are not modeled as separate records. Whether a fully refunded order counts depends on the status filter. A partial refund is not deducted from the order total. Performance A full year of sales is loaded with one indexed query that returns one row per state. The response size does not grow with the number of orders. Data and privacy The plugin creates one custom database table holding, per order: the order ID, order status, creation and payment dates, billing and shipping country and state codes, currency, and the order, tax, shipping and net totals. It stores no names, addresses, email addresses or any other personal data. Nothing is sent anywhere. The plugin makes no external HTTP requests, includes no third-party services, and collects no analytics or telemetry. Deleting the plugin removes the table and its options.

1. Upload the plugin to /wp-content/plugins/sales-by-state-report-for-fluentcart, or install it through the Plugins screen.
2. Activate the plugin. FluentCart must already be installed and active.
3. Go to FluentCart → Sales by State.

On a store that already has orders, those orders are read into the report table once. This starts on its own. If it has not finished when you open the report, a progress bar shows how far along it is.

1.0.0

• Initial release.