Sovos Docs

Troubleshooting

Find solutions to errors you might encounter when uploading data in Batch Determination.

File upload errors

Unable to upload file. Unsupported file type: Supported file types: .csv

This error occurs when you try to upload a file in a format other than CSV UTF-8 (Comma delimited), such as XLSX. Save your file in CSV UTF-8 (Comma delimited) format and try to upload it again.

File content does not match template. Please update template or file and try again.

The following can cause this error:

  • You tried to upload a file in a CSV format other than CSV UTF-8 (Comma delimited). Save your file in CSV UTF-8 (Comma delimited) format and try to upload it again.

  • You tried to upload a file that has blank columns in between columns that contain data. Remove any empty columns, including hidden columns, from the file and try to upload it again.

    Note:

    Blank columns do not always result in an error message. If you are unable to upload your file but no error message is displayed, check the file for blank columns.

Error reports

If Batch Determination identifies errors while processing the file, it returns two error reports. Fix the errors listed in the reports and then upload the corrected file.

Configuration error report

This report shows errors in file structure, field mapping, or formatting that prevent Batch Determination from reading the data correctly or determining taxability. The data in this error report is not sent to Tax Determination.

Unparseable date / Could not parse date

This error occurs when the date format in the uploaded file does not match the template's date format. For example, the template uses YYYY-MM-DD format but the dates in the file are in MM/DD/YYYY format.

Make sure the dates in the file match the template's date format. If you are using a custom template, you can change the template's date format in Advanced Options when mapping columns.

Invalid Ship To State/Province. Only letters and spaces are allowed

This error occurs when there are unsupported characters or symbols in the Ship To State/Province column.

Invalid organization code

This error occurs when the values in the Organization Code column do not match the organization code in Tax Determination.

Required field missing or not mapped

This error occurs when Batch Determination can't process a transaction because required fields are missing or are incorrectly mapped. Some common missing fields are:

  • Invoice date

  • Transaction date

  • Address fields

  • Tax amount (for back-calculation scenarios)

Calculation error report

This report shows errors that occur after Batch Determination has validated the file and sent the data to Tax Determination but Tax Determination is not able to calculate tax.

Could not perform tax calculation as there is no tax rate in this jurisdiction or the jurisdiction was not found.

This error occurs when Tax Determination can't determine the jurisdiction where the transaction should be taxed. This can happen for the following reasons:

  • Nexus is not set up correctly in Tax Determination

  • Invalid or missing state, postal code, or address fields

  • Incorrect Ship To or Ship From data

Could not perform the Tax Calculation. To perform a Tax Amount Based Back Calculation at least either Tax Amount or Exempt Amount should be passed and not equal to zero.

This error occurs when Tax Determination attempts to back-calculate tax but the required amounts are missing.

Make sure that the Tax Amount and Exempt Amount columns are correctly mapped and contain data.

If you continue to have issues uploading your data, create a support case.