tax-compliance-automation

What this skill does

# Tax Compliance Automation

## Overview

Tax compliance for ecommerce is one of the most complex operational challenges at scale. In the United States alone, there are over 13,000 taxing jurisdictions with different rates, product taxability rules, filing frequencies, and economic nexus thresholds. Internationally, VAT (Europe, UK, Australia) and GST (Canada, India, New Zealand) add additional compliance layers with their own registration thresholds, invoice requirements, and reporting obligations.

This skill covers the full tax compliance lifecycle: nexus threshold tracking to know when you must register in a new jurisdiction, real-time tax calculation at checkout, exemption certificate management for B2B customers, automated filing, and audit-ready reporting. All major platforms have direct integrations with TaxJar and Avalara that handle this without custom code.

## When to Use This Skill

- When your store ships to customers in multiple US states and you are unsure of nexus obligations
- When you need to collect EU VAT under OSS/IOSS for European customers
- When building B2B ecommerce that requires exemption certificate management
- When current tax rates are hardcoded and have not been updated in 12+ months
- When preparing for an audit and you need documented, reconcilable tax records
- When launching in a new country and you need to understand VAT/GST registration requirements

## Core Instructions

### Step 1: Determine your platform and choose the right tax compliance tool

| Platform | Recommended Tool | Notes |
|----------|-----------------|-------|
| **Shopify** | **Shopify Tax** (built-in) + **TaxJar** or **Avalara AvaTax** (Shopify App Store) | Shopify Tax covers basic US nexus; TaxJar and Avalara add filing automation, exemption certificate management, and international VAT |
| **WooCommerce** | **TaxJar for WooCommerce** (free plugin) or **Avalara AvaTax for WooCommerce** | TaxJar is the most popular WooCommerce tax plugin; Avalara's plugin is available from the Avalara website |
| **BigCommerce** | **Avalara AvaTax** (native integration) or **TaxJar** (via BigCommerce App Marketplace) | BigCommerce has a native Avalara connector; TaxJar is also available in the App Marketplace |
| **Custom / Headless** | **TaxJar API** or **Avalara AvaTax API** | Call the API at checkout for real-time rates; commit transactions after payment for filing records |

For filing automation specifically:
- **TaxJar AutoFile**: available with TaxJar Plus and Professional plans; files returns automatically in registered states
- **Avalara Returns**: built into Avalara's subscription; handles US and international returns
- **Vertex**: enterprise-grade for large retailers with complex product taxability rules; significantly higher cost than TaxJar or Avalara

---

### Step 2: Set up nexus registration and real-time tax calculation

---

#### Shopify

**Step 1: Register nexus states in Shopify**

1. Go to **Settings → Taxes and duties → United States**
2. Click **Collect sales tax** and select the state where you have nexus
3. Enter your **sales tax permit number** for that state — Shopify uses this in your tax remittance records
4. Repeat for each state where you have nexus (physical or economic)
5. For the EU: click **European Union** under Tax regions and configure your **VAT registration number** (OSS or per-country)

**Step 2: Install TaxJar for full compliance automation**

1. Install **TaxJar** from the Shopify App Store (search "TaxJar")
2. Sign up at **taxjar.com** and get your API token from **Account → TaxJar API**
3. In the TaxJar Shopify app, enter your API token and click **Connect**
4. Configure your **nexus states** in TaxJar: go to **TaxJar Dashboard → Account → States with Nexus** and add each state where you are registered
5. Enable **Transaction Sync** in the TaxJar app — completed Shopify orders are automatically sent to TaxJar for filing records
6. Enable **AutoFile** in **TaxJar → Account → AutoFile** if you want TaxJar to file returns on your behalf (requires TaxJar Plus or Professional plan)

**Exemption certificates on Shopify:**
1. Install **Avalara CertCapture** from the Shopify App Store, or use TaxJar's certificate management feature under **TaxJar → Exemptions**
2. B2B customers can upload their exemption certificates through a hosted portal; once approved, they are automatically applied to future orders

**EU VAT on Shopify:**
- Go to **Settings → Taxes and duties → European Union**
- Add your OSS registration number (format: `EU` + your country's VAT number)
- Shopify automatically applies the correct VAT rate per EU country based on the customer's shipping address
- For IOSS (import OSS for orders under €150 from outside the EU): enter your IOSS number in **Settings → Taxes → Duties and import taxes**

---

#### WooCommerce

**Step 1: Install and configure TaxJar**

1. Sign up at **taxjar.com** and get your API token
2. Install the **TaxJar for WooCommerce** plugin (free, from WordPress.org — search "TaxJar")
3. Go to **WooCommerce → TaxJar** and enter your API token
4. Enable **Automatic Tax Calculation** — TaxJar calculates the correct rate at checkout in real-time
5. Enable **Transaction Sync** — completed orders are automatically sent to TaxJar for filing records
6. Enter your **from address** (warehouse address) — this is used as the origin for nexus determination

**Step 2: Configure nexus states in TaxJar**

1. Log in to **taxjar.com → Account → States with Nexus**
2. Add each US state where you have a sales tax permit
3. For each nexus state, enter your sales tax registration number
4. TaxJar will only calculate and record tax for orders shipped to nexus states

**Step 3: Enable filing automation**

1. Upgrade to **TaxJar Plus** or **Professional** for AutoFile access
2. Go to **TaxJar → Account → AutoFile** and enable AutoFile for each state
3. TaxJar automatically files and remits on your behalf by the due date

**Exemption certificates on WooCommerce:**
- Install **WooCommerce B2B** plugin or use TaxJar's certificate management: go to **TaxJar → Exemptions** and add exempt customers by email address or customer type
- Customers with "wholesale" or "reseller" roles can be automatically flagged as exempt

**EU VAT on WooCommerce:**
- Install **WooCommerce EU VAT Assistant** or **WooCommerce Germanized** (for German-specific compliance)
- Go to **WooCommerce → Settings → Tax → EU VAT** and enter your OSS registration number
- The plugin automatically applies the correct VAT rate per EU country and generates compliant invoices

---

#### BigCommerce

**Step 1: Connect Avalara AvaTax (recommended)**

1. Go to **Settings → Tax → Tax Provider**
2. Select **Avalara AvaTax** — BigCommerce has a native Avalara connector
3. Click **Connect** and log in to your Avalara account (sign up at **avalara.com** if needed)
4. Avalara automatically replaces BigCommerce's built-in tax engine with real-time compliant rates

**Step 2: Configure nexus in Avalara**

1. Log in to **Avalara Dashboard → Settings → Company → Nexus**
2. Add each US state or country where you are registered
3. Enter your registration number for each jurisdiction
4. Avalara will calculate and record tax only for jurisdictions where you have nexus

**Step 3: Enable Avalara Returns**

1. In the **Avalara Dashboard → Returns**, enable **Managed Returns** for each nexus state
2. Avalara prepares and files returns automatically; for states where you want to review before filing, use **Unmanaged Returns** (Avalara prepares the return for you to submit)

**Exemption certificate management on BigCommerce:**
- Use **Avalara CertCapture** — go to **Avalara Dashboard → CertCapture** and configure the certificate collection portal
- Customers receive a link to upload their exemption certificate; once approved in CertCapture, future orders are automatically exempted

**EU VAT on BigCommerce:**
- Go to **Store Setup → Tax → VAT** and enable **VAT by country**
- Enter your