Welcome to Zuora Product Documentation

Explore our rich library of product information

Step 2: Configure Sales Tax Plugin in Zephr

Learn how to configure sales tax in Zephr by setting up extensions, mapping user attributes, and activating the plugin for your sites.

To configure a sales tax in Zephr, complete the following steps:

  1. Log on to your Zephr Admin Console.
  2. Navigate to Settings > Extensions > Sales Tax (under the Internal section).
  3. Click Configuration and enter the following details:
    1. Braintree Add-On ID: Enter the Add-On ID you created in Braintree.
    2. Tax Label: Enter a label, for example, Sales Tax, that appears next to the tax amount.
    3. User Attribute Field: Enter the attribute used to determine tax eligibility. For example, you can select State, to charge tax to users in particular US states.
  4. Click Done to save the configuration.
  5. Click User Attribute Mapping.
  6. In the JSON input box, map user attribute values to tax percentages.
    {
      "NY": "10",
      "CA": "8.25",
      "TX": "6.75"
    }
    
    Note:
    • Percentages can be integers (10) or decimals (8.25).

    • Attribute keys are case-sensitive.

    • JSON must be valid. Ensure that all keys or values are wrapped in quotes and formatted correctly.

    US State Tax Rates:

    {
      "NY": "8.25",
      "CA": "7.25",
      "TX": "6.25",
      "WA": "6.5",
      "FL": "6.0"
    }
    

    Country-based Tax (VAT):

    {
      "GB": "20",
      "DE": "19",
      "FR": "20",
      "ES": "21"
    }
    

    Regional Zones:

    {
      "ZONE_1": "5.0",
      "ZONE_2": "7.5",
      "ZONE_3": "10.0"
    }
    
    Screen-Shot-2020-10-14-at-4.30.31-PM.png
  7. Click Done to save the mapping.
  8. In the Activate Plugin section, use the toggle to enable the plugin per site. Alternatively, click Select All Sites to activate on all.
  9. Select the toggles beside each site for which you want to activate the plugin, as illustrated below. Alternatively, select the Select All Sites toggle to activate the plugin on all your sites
  10. Click Save .