Local Rates

If you need to include additional taxes for a county or a municipal government tax that is added to the base rate, you can click the Add Local Rates button to enable supplemental local tax jurisdictions.

Remember to use a meaningful local tax rate name, so that it can be easily identified by the customer.

Local rates can be specified by formatting a file in a XML, CSV or Tab-delimited format. The file format is simple and straightforward only requiring the name of the local tax jurisdiction and the additional tax rate. Simply create a file with the names and rates. Rates should be provided using the same numbering system as used in the Shopp tax settings screen where a whole number represents a whole percentage amount and decimal numbers are fractional percentages.

Below are example local tax jurisdiction file formats for the counties of the state of Nevada, USA (although Nevada does not use local tax rates).

XML Format
<localtaxrates>
<taxrate name="Humboldt">0</taxrate>
<taxrate name="Washoe">0.875</taxrate>
<taxrate name="Lyon">0.25</taxrate>
<taxrate name="Storey">0.75</taxrate>
<taxrate name="Carson">0.625</taxrate>
<taxrate name="Douglas">0.25</taxrate>
<taxrate name="Pershing">0.25</taxrate>
<taxrate name="Churchill">0.75</taxrate>
<taxrate name="Mineral">0</taxrate>
<taxrate name="Lander">0.25</taxrate>
<taxrate name="Eureka">0</taxrate>
<taxrate name="Nye">0.25</taxrate>
<taxrate name="Elko">0</taxrate>
<taxrate name="White Pine">0.725</taxrate>
<taxrate name="Lincoln">0.25</taxrate>
<taxrate name="Clark">1.25</taxrate>
</localtaxrates>
CSV Format
Humboldt,0
Washoe,0.875
Lyon,0.25
Storey,0.75
Carson,0.625
Douglas,0.25
Pershing,0.25
Churchill,0.75
Mineral,0
Lander,0.25
Eureka,0
Nye,0.25
Elko,0
“White Pine”,0.725
Lincoln,0.25
Clark,1.25
Tab-delimited Format
Humboldt    0
Washoe  0.875
Lyon    0.25
Storey  0.75
Carson  0.625
Douglas 0.25
Pershing    0.25
Churchill   0.75
Mineral 0
Lander  0.25
Eureka  0
Nye 0.25
Elko    0
White Pine  0.725
Lincoln 0.25
Clark   1.25

When you are finished creating the file, save it to your computer (somewhere you can easily locate).

To upload a formatted local rates file:
  1. Create a formatted local rates file.
  2. Login to your WordPress admin and navigate to the ShoppSetupTaxes screen.
  3. Choose a tax rate and click the Edit link, or add a new tax rate by clicking the Add Tax Rate button to open the tax rate editor.
  4. Click the Add Local Rates button.
  5. Click the Upload button.
  6. Select the formatted local rates file from your computer.
  7. Click the Save Changes button to save the local rates.

During the checkout process, when a customer enters an address that matches a tax jurisdiction with local rates, a menu will be displayed for the customer to choose their specific tax jurisdiction from the labels you set.

  1. Avatar of Andrew

    You have to make sure the CSV you upload is saved in UTF8 format and DOS line breaks. Mac files don’t work. Good luck.

    March 7th   #

You must be logged in to post a comment.

© Ingenesis Limited. Shopp™ is a registered trademark of Ingenesis Limited.

Skip to toolbar