=== Bizuno RESTful Sales Tax for WooCommerce ===
Contributors: phreesoft
Donate link: https://www.bizuno.com/donate/
Tags: sales-tax, tax, woocommerce, tax-rate, rest-api
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 7.4.2
License: AGPL-3.0-or-later
License URI: https://www.gnu.org/licenses/agpl-3.0.html

Calculate WooCommerce sales tax in real time at cart and checkout via a secure REST call to your Bizuno ERP, based on the shipping address.

== Description ==

**Bizuno RESTful Sales Tax for WooCommerce** calculates sales tax in real time during cart and checkout by sending the order address to your Bizuno ERP and applying the rate it returns.

Tax is only calculated for the states (nexus) you configure, so you stay in control of where tax applies. The plugin caches rates per request to keep checkout fast.

= Features =

* Real-time sales-tax rates from your Bizuno ERP at cart and checkout.
* Nexus control — only calculate tax for the states you select.
* Works with self-hosted Bizuno or PhreeSoft Cloud.
* WooCommerce High-Performance Order Storage (HPOS) compatible.
* No tax tables to maintain in WooCommerce — rates come from Bizuno.

== Installation ==

1. Install and activate **Bizuno RESTful Sales Tax for WooCommerce** from the WordPress Plugins screen. WooCommerce must be installed and active.
2. Go to **Settings → Bizuno → General** and enter your connection details: Server URL, REST user name, password and API token (from your Bizuno instance).
3. Open the **Sales Tax** settings tab, enable tax calculation, and select the nexus states where tax should apply.
4. Save. Sales tax is now calculated at cart and checkout for customers in your nexus states.

== Frequently Asked Questions ==

= How is the tax rate determined? =
At cart/checkout the plugin sends the order total, shipping amount, and the customer's city, state, ZIP and country to your Bizuno ERP, which returns the applicable rate.

= Do I still need WooCommerce tax tables? =
No. Rates come from Bizuno, so you do not maintain tax tables in WooCommerce.

= Which locations are supported? =
Tax is calculated for the nexus states you configure. United States ZIP-based rates are supported today.

= Do I need a Bizuno account or server? =
Yes. You need a reachable Bizuno instance (self-hosted or PhreeSoft Cloud) and its connection credentials.

== External services ==

To calculate tax, this plugin connects to the **Bizuno ERP server that you configure** under Settings → Bizuno → General (your own self-hosted Bizuno instance or PhreeSoft Cloud). No data is sent until you enable tax calculation and a customer reaches a taxable cart/checkout in one of your nexus states.

For each calculation it sends, to your configured server's `?bizRt=portal/api/getSalesTax` endpoint, the data needed to determine the rate: the cart total, the shipping/freight amount, and the customer's city, state, ZIP/postal code and country. The server returns the sales-tax amount and rate.

If you use PhreeSoft Cloud as your Bizuno server, that service is operated by PhreeSoft, Inc.:

* https://www.phreesoft.com
* https://www.bizuno.com

If you self-host Bizuno, requests go only to the server URL you enter; no PhreeSoft service is contacted.

== Screenshots ==

1. Settings → Bizuno → General tab: connection details (Server URL, REST user name, password, API token).
2. Sales Tax settings tab: enable calculation and select nexus states.
3. WooCommerce cart showing the real-time sales-tax line.
4. WooCommerce checkout showing the calculated sales tax for the shipping address.

== Changelog ==

= 7.4.2 =
* Renamed to "Bizuno RESTful Sales Tax for WooCommerce" for the WordPress.org Plugin Directory; text domain set to match the slug.
* Localized tax calculation to your own Bizuno ERP server (self-hosted or PhreeSoft Cloud) using shared connection settings.
* Now a standalone WordPress plugin (no Bizuno core library dependency) using native WordPress messaging.
* Declares WooCommerce HPOS (custom order tables) compatibility.
* Declares WooCommerce as a required plugin and adds WooCommerce version compatibility headers.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 7.4.2 =
Plugin renamed and now standalone. After upgrading, confirm your connection details under Settings → Bizuno → General and your nexus states under the Sales Tax tab.

== About PhreeSoft ==

PhreeSoft has built open-source accounting and ERP tools since creating PhreeBooks in 2007. **Bizuno** is our modern flagship; this plugin brings its real-time sales-tax engine to your WooCommerce store.

* https://www.phreesoft.com
* https://www.bizuno.com
* https://github.com/phreesoft/bizuno-restful-sales-tax-for-woocommerce
