Arcoro Payroll can either read federal tax data out of the connected payroll processing system, or write federal and state tax data into it. Each direction checks that the tax data uses the supported 2020 and later Federal W-4 format, that the filing status is one Payroll recognizes, and that the expected tax form actually exists before it tries to save anything.
When a check fails, Payroll records an Error against that one tax section or that one state and moves on. It does not stop the rest of the employee from syncing.
Error Messages
| Message text | Direction | Occurs when | Outcome | Fix |
|---|---|---|---|---|
| The employee's Federal W-4 form is for a tax year prior to 2020. Only the 2020+ format is supported. Federal tax data will not be read. | Read | The employee's federal tax settings in the connected payroll processing system are flagged as the pre-2020 Federal W-4 format. | Federal tax data is skipped for this employee. Compensation, direct deposit, and demographic data still read normally. | Have the employee complete a current-format Federal W-4 in the connected payroll processing system, then re-run the sync. |
| The employee's Federal Tax settings are for a tax year that is not supported by the Sync. Payroll supports the 2020+ Form. Correct the data in the source system and attempt the Sync again. | Write | The incoming Federal Tax Form Year value from the source system is earlier than 2020. | Federal tax data is skipped for this employee. The rest of the employee record, including state taxes, still writes. | Correct the Federal Tax Form Year to 2020 or later in the source system, then re-run the sync. |
| The Federal Filing Status '[filing status]' is not supported and will not be Synced. Update the data in the source system and execute the Sync again. | Write | The incoming Federal Filing Status value from the source system does not map to a supported Payroll filing status. | Federal tax data is skipped for this employee. The rest of the employee record still writes. | Change the Federal Filing Status in the source system to one of the supported values, then re-run the sync. |
| State Taxes for the year [tax year] in [state] are not supported. The minimum year supported is [minimum year]. Please correct the data and attempt to sync again. | Write | The incoming State Tax Form Year for that state is earlier than the minimum year Payroll supports for that state. | Only that state's tax record is skipped. Other states for the same employee, and the rest of the employee record, still write. | Correct the State Tax Form Year for that state in the source system, then re-run the sync. |
| The Sync could not find form '[form name]' in the Master list of Tax Forms from CheckHq. Tax records will be not Synced but other parts of the Employee will still be processed. Attempt the Sync again and if the problem persists contact Support. | Write | The expected tax form (the Federal W-4, or the state's own withholding form) was not present in the master list of tax forms retrieved for this configuration. | If it is the Federal W-4: federal tax data is skipped, rest of the employee still writes. If it is a state form: only that state's tax record is skipped, everything else still writes. | Re-run the sync. If it fails again for the same form, escalate. |
| The Sync could not find the Employee's form '[form name]'. Tax records will be not Synced but other parts of the Employee will still be processed. Attempt the Sync again and if the problem persists contact Support. | Write | The Federal W-4 form exists in the master list, but this specific employee's copy of that form could not be retrieved, or it was retrieved with no fields on it. | Federal tax data is skipped for this employee. The rest of the employee record still writes. | Re-run the sync. If it fails again for the same employee, escalate. |
Confirming the Error
- Open the sync execution in Sync History.
- Find the step for the Arcoro Payroll connector.
- Open the Employees entity row for that step.
- Check the Errors, Warnings, Information, Failures, Added, Updated, and Unchanged columns for that row.
- Open the errors list for that entity row and match on the fixed part of the sentence, not the values in single quotes, since the bracketed values change per employee, form, or state.
For every message in this article, a non-zero Errors count next to a non-zero Updated count is expected and normal. It means the employee record still saved. Only one tax section, or one state's tax record, was left out.
A non-zero Failures count for this entity is a different signal. It means the employee record itself did not save, which none of the six messages in this article cause on their own. If Failures is non-zero alongside one of these messages, look for a separate error on the same employee before assuming these tax messages are the cause.
Resolving the Error
Unsupported Federal Form Year
- Identify the employee named in the sync log entry.
- In the source system, open that employee's Federal Tax Form Year field.
- Confirm the year is 2020 or later. If it is earlier, correct it to reflect a current Federal W-4.
- Save the change in the source system.
- Re-run the sync for that employee and confirm the Federal Taxes Error no longer appears.
Unsupported Federal Filing Status
- Identify the employee and the filing status value quoted in the message.
- In the source system, open that employee's Federal Filing Status field.
- Set it to one of the supported values: Single, Married, Married Filing Jointly, Married Filing Separately, Single or Married Filing Separately, Head of Household, or Non-Resident Alien.
- A blank or unspecified filing status, and Widow(er) with dependent child, are not supported by this sync and must be changed to one of the values above.
- Save the change in the source system.
- Re-run the sync for that employee and confirm the Federal Filing Status Error no longer appears.
Unsupported State Tax Year
- Identify the employee, the state, and the minimum year quoted in the message.
- In the source system, open that employee's State Tax Form Year field for the state named in the message.
- Correct the year to meet or exceed the minimum year quoted in the message. The minimum year is set per state, so two employees in different states can see different minimums.
- Save the change in the source system.
- Re-run the sync for that employee and confirm the State Taxes Error no longer appears for that state.
Tax Form Not Found
These two messages (master list form not found, and employee's form not found) point to a form lookup problem rather than data you entered. There is no source-system field for the agent to correct.
- Re-run the sync.
- If the same message appears again for the same employee or the same form, collect the exact message text, the employee, and the form name from the sync log.
- Escalate per the When to escalate section below.
When to Escalate
If any of the following occur, you may need to reach out to Arcoro support for additional assistance.
- A "form not found" message (either the master list version or the employee's form version) repeats on a second sync attempt for the same employee or form.
- Confirm you are not also seeing a preload failure for the tax form list earlier in the same sync execution; if they are, resolve that first and see Payroll Integration Troubleshooting: Preload or Lookup Data Setup Failure.
- A non-zero Failures count appears on the Employees row alongside any of these messages, meaning the employee record itself did not save.
- The field named in this article does not exist in their source system, or does not match what they see on screen.