This is the documentation for WC Vendors Tax plugin.
With this extension, your marketplace can calculate sales tax automatically at the checkout by integrating TaxJar or Avalara tax calculation service into your marketplace.
- Calculating sales tax automatically using cloud tax calculation services like TaxJar or Avatax.
- Uploading orders and refunds to cloud tax services for reporting and filing.
- Switching between marketplace and vendor as the seller of record.
- Support both WC Vendors Marketplace and WC Vendors Pro.
- Support TaxJar Nexus addresses.
- Cache calculation result to save API calls.
- WordPress 5.2 or above
- WooCommerce 3.6 or above
- WC Vendors Marketplace 2.1 or above
- WooCommerce configured as per the instructions below
- Remove all predefined tax rules in WooCommerce > Settings > Tax.
- All product prices must be tax-excluded.
- In WordPress, go to Plugins > Add New > Upload
- Click Choose File and find your downloaded ZIP file
- Activate the extension through the ‘Plugins’ menu in WordPress
- Go to WC Vendors > Settings > Tax to configure the plugin
WordPress Admin Configuration
- Enable vendor tax system: Enable/disable this extension.
- Custom tax fields: Show tax field on WooCommerce registration form and Account setting page.
- Seller of record: Set who is responsible for sales tax on the marketplace, default to vendor.
- Active integration: this plugin requires setting up one of the available integrations before it can work for you. For now, TaxJar and Avalara are supported, more integration will be added in the future.
- Enable logging: Log the activities of the plugin for debugging purposes. If enabled, the log can be accessed at WooCommerce > Status > Logs.
When TaxJar is active integration, a subtab for the TaxJar setting will be visible next to the General tab. Note that the tab is only visible after saving the current general setting.
- TaxJar SmartCalcs API token: the API token provided by TaxJar. This is required for the plugin to work.
- TaxJar Referral URL: You can earn commissions if vendors sign up for TaxJar through your referral link.
- Sandbox mode: Whether to use a sandbox environment for testing purposes, only available for TaxJar plus plan. More about this here.
To get Avarala working, you need to set the Account ID and License key. Company Code is required if your company code is other than
Vendor Tax Settings
- Your tax ID: Business Tax ID to show on invoices.
- Upload order: Upload order and refund to cloud tax services for reporting.
- Disable Automatic Tax Calculation: if checked, the calculation will use the marketplace admin API credentials to calculate tax rates.
- TaxJar SmartCalcs API Token: This is required for uploading order and refund to TarJar.
- Nexus Address: This plugin allows vendors to list all nexus addresses right from the dashboard to calculate US Sales tax correctly.
- Account and License Key: Same as TaxJar, if the vendors check Upload order, we need Account ID and License Key set up to enable that feature.
- Company code: Requires if the company code is not
Get API Keys from Cloud Tax Services
Get TaxJar SmartCalc API Token
- Login to your TaxJar Account page.
- Click on SmartCalcs API on the left side of the screen.
- Click the button that says “Generate API Token”.
- Copy the token appeared.
Get Avalara Account ID and License Key
- Go to the Avalara login page.
- Login with your login credentials.
- Click on the “Avalara Avatax” box when the popup appears.
- Find your Account ID
- Hover on your name on the top right corner of the admin page.
- Copy the Account ID appears. (screenshot)
- Find your License key
- Check for your license key in an email from Avalara.
- If you can’t find the existing license key, go to Settings > License and API Keys from the admin page in step 2.
- Click Generate License Key.
A warning displays. If this is your first time setting up AvaTax Update, you can ignore the warning.
- Click Yes, Generate a License Key.
Avalara emails the license key and account information to account administrators. There is one license key for all systems associated with your account.
- Check your email to grab the license key.
Tax codes setting
To calculate tax correctly, you or your vendors need to update tax code for all existing products.
Update tax code for TaxJar
- Go to the product edit page.
- Scroll down and find “Product Tax category” select box.
- Choose a product category that matches with the current product.
- Save changes.
Update tax code for Avalara
- Go to the product edit page.
- Scroll down and find “Product Tax category” setting.
- Click on the “Look up Avalara tax code” link in the description of that setting.
- On the Tax code Look up page, search for the code that matches your product and copies it.
- Paste the code found in step 4 to the input.
- Save changes.
That’s it! You’re done configuring the WC Vendors Tax! From now, your marketplace will calculate tax automatically for you.