Troubleshoot Address and Tax Issues for the US

How to check address and tax hygiene

Run the Payroll Data Validation Report to generate a list of workers with missing or noncompliant payroll data. Use this report to verify if the required data setup for all workers for the payroll run or process is complete.

How to troubleshoot address issues

Here are some issues you may encounter with your addresses.

What happened	How you can resolve it
Invalid address data	To identify potentially invalid address data: Run the Address Validation Process. For any address identified by this process, check its Delivery Point Validation (DPV) on the US Postal Service's website. If the address is valid, contact Oracle Support. Note: You can configure your addresses such that when you enter the ZIP Code, the other fields automatically populate appropriately.
Address is valid but doesn't report full geospatial roof-top accuracy	In the unlikely event this occurs: If the state doesn't impose local taxes, you can disregard the partial geospatial accuracy. It won't affect payroll tax calculations. If the state imposes local taxes: Review the derived jurisdictions, and set any necessary overrides. Contact Oracle Support, and provide details of the address record for investigation.
Geography upload problems	If you receive errors when you run the Load Geographies tasks, you can use these diagnostic tests from the Diagnostic Dashboard to help identify what went wrong. US HR and Payroll Geography Loader Details Test US HR and Payroll Geography Diagnostics Details US HR and Payroll Geography Setup and Health Check Report US HR and Payroll Geography Type Validity Note: You can configure your addresses such that when you enter the ZIP Code, the other fields automatically populate appropriately

What happened

How you can resolve it

Invalid address data

To identify potentially invalid address data:

Run the Address Validation Process.
For any address identified by this process, check its Delivery Point Validation (DPV) on the US Postal Service's website.
If the address is valid, contact Oracle Support.

Note:

You can configure your addresses such that when you enter the ZIP Code, the other fields automatically populate appropriately.

Address is valid but doesn't report full geospatial roof-top accuracy

In the unlikely event this occurs:

If the state doesn't impose local taxes, you can disregard the partial geospatial accuracy. It won't affect payroll tax calculations.
If the state imposes local taxes:
1. Review the derived jurisdictions, and set any necessary overrides.
2. Contact Oracle Support, and provide details of the address record for investigation.

Geography upload problems

If you receive errors when you run the Load Geographies tasks, you can use these diagnostic tests from the Diagnostic Dashboard to help identify what went wrong.

US HR and Payroll Geography Loader Details Test
US HR and Payroll Geography Diagnostics Details
US HR and Payroll Geography Setup and Health Check Report
US HR and Payroll Geography Type Validity

Note:

You can configure your addresses such that when you enter the ZIP Code, the other fields automatically populate appropriately

Contact Oracle Support with any issues not resolved using the troubleshooting tips.

How to troubleshoot tax issues

There are a variety of issues you may encounter when uploading and using the tax info.

What happened	How you can fix it
Errors during payroll calculation	Confirm you have properly associated a tax reporting unit (TRU) with the person's Tax Withholding card. For workers in Pennsylvania, confirm they have Residency Certificate components on their tax cards. To help identify the cause of the errors, run the payroll diagnostic tests from the Diagnostic Dashboard.
Error during payroll calculation that a geography code is missing or primary work address is missing	To help identify the cause of the error, run the geography and payroll person diagnostic tests from the Diagnostic Dashboard. Check the Regional Tax Info component on the person's Tax Jurisdictions card. Ensure the unemployment insurance (SUI) state, disability insurance (SDI) state, and primary work address are populated correctly. These fields are predefined when you create the tax card association. If the work location is missing for the employee's assignment, these fields aren't predefined. You must manually define them.
Updated work Pennsylvania subdivision (PSD) code not reflected on the worker's PSD Component	The likely cause is a change to a location's PSD code in Work Tax Jurisdiction through the Locations task. Run the Sync Calculation Cards process.
Periodic Archive isn't archiving US balances	To help identify the cause of the problem, run the US Federal Tax Registration Check for TRUs test from the Diagnostic Dashboard. This identifies all TRUs that don't have the United States Federal Tax registration.
Payroll run produces inaccurate tax calculations	To help identify the cause of the problem: Run the Tax Calculation Report. This shows detailed steps of the process's tax calculations. Compare its results against your expected results. Run the Payroll Validation Report. Its results can help identify issues. Verify the employee has a Tax Jurisdictions Card defined with the expected resident and work tax addresses. Verify the derived tax jurisdictions, and confirm any overrides. Verify the following for the affected employee. They have a Tax Withholding card. The tax card is associated with a TRU. Their filing status and number of exceptions are correct. Confirm that the appropriate state or local taxes have been applied, based on the employee's resident and work address. Verify your federal and state wage basis rules.