Introduction and Overview

A new Tax Rate page has been introduced for Products and Solutions within the Marketplace module. This enhancement enables administrators to configure tax rates based on country and province, ensuring accurate tax calculation during marketplace transactions.

The functionality supports automated tax application depending on buyer and seller location, as well as VAT/HST registration status, providing flexible and compliant tax handling for both domestic and international transactions.

Accessing the Tax Rate Page

When the Marketplace feature is enabled:

• The Tax Rates page becomes available under Setup.

• Access is restricted to Super Admin and Site Admin users.

• The page displays a list of all configured tax entries.

Creating a New Tax Rate

To configure a new tax rate, follow these steps:

1. Navigate to Setup → Tax Rates (#marketplace/taxrates).

2. Click Add Tax Rate.

3. Complete the required fields and save the entry.

Required Fields

The following fields must be configured when creating a tax rate:

• Country – Selected from a dropdown list.

• Province

• Free-text field

• Maximum 50 characters

• Defaults to "Own" if not specified

• Tax Rate (%)

• Accepts values between 1 and 99

Optional Fields

The following fields are optional but help provide additional context for tax handling:

• International B2B Sales Note

• Maximum 200 characters

• Displayed when tax is not applied for international transactions

• Comment – Additional administrative notes

After completing the fields, click Save to create the tax rate entry.

Validation Rules

• The combination of Country + Province must be unique.

• Duplicate combinations are not permitted.

• If a duplicate is entered, the system displays a validation alert.

Once saved successfully, the tax rate appears in the configured tax list.

Organization Page Updates

The enhancement also includes changes to the Organization Info page to support tax determination:

• Country field is now a dropdown selection.

• A new VAT/HST Number field has been introduced under Marketplace settings.

• Organizations can store tax identification numbers for tax determination.

These fields directly impact tax calculation logic during marketplace transactions.

How Tax Calculation Works in the Marketplace

Tax is applied during product purchase based on a set of defined rules that consider buyer and seller location, as well as VAT/HST registration status.

Condition 1: Buyer and Seller in the Same Country

When the buyer country matches the seller country:

• The tax rate configured for that country and province is applied.

• The applicable percentage is added to the product total.

Example: If both buyer and seller are located in India (Punjab), and a 15.88% tax is configured, then 15.88% tax is applied at checkout.

Condition 2: Buyer and Seller in Different Countries (with VAT)

When the buyer country differs from the seller country AND the buyer has a valid VAT number:

• No tax is applied.

• The configured International B2B Sales Note is displayed.

This supports cross-border B2B transactions where tax is not required due to VAT registration.

Condition 3: Buyer Without VAT Number

When the buyer does not have a VAT/HST number AND the buyer and seller are in different countries:

• The buyer's country tax rate is applied.

• If the buyer has no province specified, the applicable country-level tax is used.

This ensures tax compliance for buyers without registered tax identification numbers.

When buyers and sellers are from different countries:

When both buyer and seller are from the same country:

Key Functional Highlights

• Country and province-level tax configuration.

• Unique validation of tax entries to prevent duplicates.

• VAT/HST number support at the organization level.

• Automated tax logic during checkout.

• International B2B exemption handling.

• Informational note display when tax is not applied.

Impact on Marketplace Transactions

The Tax Rate page delivers several operational improvements:

• Accurate tax enforcement based on jurisdiction.

• Improved compliance for domestic and international sales.

• Clear transparency for buyers regarding tax calculations.

• Flexible configuration for multi-country marketplace environments.

Key Benefits

• Enables structured tax configuration at country and province granularity.

• Supports automated tax calculation during checkout, reducing manual effort.

• Provides VAT/HST exemption logic for cross-border B2B transactions.

• Improves compliance and accuracy across domestic and international marketplace sales.

• Validation rules prevent duplicate tax entries, ensuring data integrity.

• Centralizes tax management under Setup for easy administration.

Conclusion

The introduction of the Tax Rate page enhances marketplace functionality by enabling structured tax configuration for products and solutions. With defined validation rules, automated calculation logic, and VAT/HST exemption handling, the system ensures accurate, compliant, and transparent tax handling across domestic and international transactions, supporting organizations operating in multi-country marketplace environments.