Use this workflow to import quarterly sales tax rates from an approved .xlsx rate file.
When to use this workflow
Use this workflow when a new quarterly rate file is available and PAX needs updated sales tax lookup data.
Before you start
You need:
adminaccess for the import.- The official state rate
.xlsxfile. - The effective date for the new rate period.
- An optional end date if the imported rates should have a defined end date.
The current import UI supports WA.
Screen path
Dashboard > System Settings > Accounting > Tax Rates
Steps
- Open
System Settings. - In
Accounting, selectTax Rates. - In
Import Quarterly Rates, confirmStateis correct. - Enter
Effective Date. - Enter
End Dateonly if the imported rate period should end on a specific date. - Select the official
.xlsxfile inRate File (.xlsx). - Select
Import Rates. - Wait for the import result message.
- Use search to spot-check expected county, location, code, and combined rate values.
What happens behind the scenes
PAX parses the first worksheet of the uploaded file. For WA files, PAX expects the title block, column headers, then data rows beginning after the header rows.
PAX imports county, location name, location code, local rate, state rate, combined rate, effective date, and end date. Location codes are padded to four digits.
Before inserting the new rows, PAX ends prior open-ended rates for the same state that started before the new effective date. The previous end date is set to the day before the new effective date.
If the same state, location code, and effective date already exists, PAX updates the existing row instead of creating a duplicate.
Troubleshooting
No file uploaded
Likely cause: No file was selected before import.
Safe fix: Select the .xlsx file and import again.
Contact support if: A selected file is not being sent.
Effective date is required
Likely cause: Effective Date is blank.
Safe fix: Enter the effective date for the rate file.
Contact support if: A valid date is rejected.
Import failed after uploading an official file
Likely cause: The format may have changed, the wrong worksheet is first, or the file content cannot be parsed.
Safe fix: Confirm the file is the official quarterly .xlsx file and has not been manually rearranged.
Contact support if: The file is official and unmodified but PAX cannot import it.