This topic provides troubleshooting information for Zuora Tax, including solutions to common problems.
The tax rates are available in the Tax Rates Import file. You can use this to identify which taxes were applied.
If there are multiple taxes and it is not possible to identify which tax was applied, you can enter troubleshooting data in the Tax Rate Description, Location Code, and/or Jurisdiction that is associated with those taxes. When you run billing again, you should be able to identify the specific tax used by reviewing these fields in the Invoice Details Extract file.
The order of the Tax Rate Load file will be preserved when importing the tax rules into Zuora Tax. If multiple tax rate rows in the tax rule import file match, the first row in the file that matches will be applied. Verify that the data is loaded in the correct order by comparing the sequential Tax Order field with the records in the import file. If the order is different, contact Zuora Global Support for help.
Identify which tax rate was applied, then review matching rules with the Sold To address.
If the fields in the tax rate match the corresponding address filed for the Sold To Contact, contact Zuora Global Support for help.
<nomatch>in the Tax Jurisdiction field if Zuora Tax did not match a tax rate.
<nomatch>is found, then the matching process did not match the address to the tax rate.
<nomatch>was not found in the Invoice Details Extract file, contact Zuora Global Support.
Excel might have incorrectly converted the file to a CSV file (comma-separated values). Open the file using a text editor (such as WordPad) and verify that the commas line up with the columns in the Tax Rate Upload file.
This is a known limitation. Taxes on previews of draft amendments in the Zuora application are incorrectly displayed as zero. This issue only occurs when the draft amendment preview is viewed in the Zuora application. Calls to the amend API with the preview option enabled do not have this issue, and taxes are returned correctly.
This is a known limitation. Previews of draft subscriptions in the Zuora application show incorrect tax values when the following conditions are true:
Calls to the subscribe API with the preview option enabled do not have this issue, and taxes are returned correctly.