About the Tax APIs

Tax functionality enables businesses to implement accurate, compliant tax calculations that adapt to complex regional requirements, business rules, and integration with external tax services. The tax system supports built-in tax calculations, integration with specialized tax providers, custom tax rates, and tax exemptions for specific customers, so businesses can handle tax correctly across different jurisdictions and scenarios.

This section covers:

• Tax Groups API: Create and manage tax groups to categorize products by distinct tax treatments.
• Tax Groups Service Plugin: Provide default tax groups for your app's catalog products based on distinct tax treatments.
• Tax Regions API: Define and manage tax regions to apply different tax treatment based on location.
• Manual Tax Mappings API: Define custom tax rates for specific tax group and region combinations when using Wix's manual tax calculator.
• Tax Calculation API: Retrieve the available tax calculators for a site and calculate tax for a cart or checkout.
• Tax Calculation Integration Service Plugin: Integrate a custom tax calculation service with the eCommerce platform for specialized tax logic and external tax provider connectivity.
• Tax Exempt Groups API: Create and manage reusable groups of tax exemption rules for categories of customers, such as resellers or non-profit organizations.
• Tax Exempt Groups Service Plugin: Provide tax exempt groups from your app for use in a site's tax calculation.
• Contact Tax Details API: Manage a site's contacts' tax-related information, including their tax exempt group association.

Tax calculation approaches

Choose the approach that best meets your tax compliance and calculation requirements:

• Built-in tax calculations: Use Wix's standard tax calculation functionality for basic tax scenarios with straightforward regional tax rates and rules.

• External tax service integration: Connect with specialized tax services through the Tax Calculation Integration Service Plugin for complex multi-jurisdictional compliance, real-time rate updates, and automated tax filing support.

• Custom tax rates: Use the Manual Tax Mappings API to define custom rates for specific tax group and region combinations when using Wix's manual tax calculator.

• Tax exemptions: Use the Tax Exempt Groups API and the Contact Tax Details API to exempt qualifying customers from some or all tax.

Tax system integration

Tax calculation integrates throughout the eCommerce flow:

• Real-time calculation: Tax amounts update in real time as customers modify their carts, change shipping addresses, or update checkout information.

• Multi-jurisdictional support: Tax calculations can account for different tax rates and rules based on customer location, business location, product types, and applicable tax jurisdictions.

• Tax group management: Tax groups categorize products by specific tax treatment based on business requirements or regulatory compliance.

• Tax exemption: Customers associated with a tax exempt group through their contact tax details pay a reduced rate or no tax at all in that group's regions.

• Compliance automation: Integration with external tax services can provide automated compliance features including tax filing, reporting, and regulatory updates.

See also

• About Extensions
• About Purchase Flow
• Extend the eCommerce Platform with Service Plugins