Before Payroll writes an employee's bank accounts and pay splits, it checks the whole set of direct deposits coming from the source system against a list of rules Arcoro Payroll requires: every deposit needs a start date, an account type, bank details, an amount or percentage, and a priority, and the set as a whole has to add up correctly with at most one Full Amount (Net) deposit in the right position. If any rule fails, none of the employee's direct deposits are written this cycle. The employee record itself, and every other scope on that employee, still syncs normally.
Error Messages
| Message text | Direction | Occurs when | Outcome | Fix |
|---|---|---|---|---|
| Direct deposits must have a start date. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | Any direct deposit on the employee is missing a start date. This check runs on every direct deposit on the record, including inactive or expired ones, before the active/current filter is applied. | Entire direct deposit collection skipped for this employee this cycle. No bank accounts or pay splits are added, updated, or removed. Other scopes still sync. | In the source system, set a start date on every direct deposit for this employee, including inactive or expired ones. |
| Direct deposits must have an account type. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | Among the deposits that are active, currently effective, not expired, and kept after the 6-deposit-per-employee cap, at least one has no account type set. | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, set an account type on every active, current direct deposit for this employee. |
| Direct deposits must have an account number and routing number. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | Among that same active/current/kept set, at least one deposit is missing its account number or its routing number (or both). | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, add both the account number and routing number to every active, current direct deposit for this employee. |
| Direct deposits must have an amount or percentage. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | Among that same active/current/kept set, at least one deposit has both its dollar amount and its percentage equal to zero or blank. | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, set a dollar amount or a percentage on every active, current direct deposit for this employee. |
| Direct deposits must have a priority. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | Among that same active/current/kept set, at least one deposit has no priority value. | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, set a priority value on every active, current direct deposit for this employee. |
| Direct deposit priorities must be sequential starting at 1. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | Once account type, account/routing number, amount/percentage, and priority are all present on every deposit, the priority values (sorted) are not exactly 1, 2, 3, and so on with no gaps or duplicates, for however many deposits remain after filtering and the 6-per-employee cap. | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, renumber the priorities on this employee's active, current deposits so they run 1, 2, 3, and so on with no gaps or duplicates. |
| All direct deposits must have the same deposit type, either all percentages or all flat amounts with a Full Amount (Net) account. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | Only checked once the priority sequence passes. The active/current set contains at least one deposit using a dollar amount and at least one deposit using a percentage that is greater than 0 but not exactly 100. | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, make all of this employee's deposits either percentages (one may be 100 percent as the Full Amount/Net deposit) or flat amounts (one must be the 100 percent Full Amount/Net deposit); do not mix flat amounts with a partial percentage. |
| The employee has multiple Full Amount (Net) direct deposits but only one is allowed. Correct the direct deposits in the source system and try again. | Write (source to Payroll) | More than one deposit in the active/current set has a percentage of exactly 100 (a Full Amount/Net deposit). | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, reduce this employee to only one Full Amount (Net) (100 percent) direct deposit. |
| Direct deposits for a Full Amount (Net) must have the lowest priority. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | A deposit in the active/current set has a percentage of exactly 100 (Full Amount/Net) but its priority number is less than the total number of deposits being processed, meaning it is not the last (lowest-priority) deposit. | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, give the Full Amount (Net) deposit the lowest priority (the last position in priority order). |
| Direct deposit percentages must sum to 100%. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | None of the active/current deposits use a dollar amount, at least one uses a percentage, none of them is exactly 100 (no Full Amount/Net deposit present), and the percentages across all of them do not add up to exactly 100. | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, adjust this employee's deposit percentages so they add up to exactly 100 percent. |
| Direct deposit percentages must sum to less than 100% when there is a Full Amount (Net) deposit. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | None of the active/current deposits use a dollar amount, at least one uses a percentage, one of them is exactly 100 (a Full Amount/Net deposit is present), and the combined percentages of all of them, including that 100, add up to 200 or more. See the Open questions section: the code's actual threshold does not match this message's wording. | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, lower this employee's percentage-based deposits so the combined total, including the Full Amount (Net) deposit, stays under 200 percent. |
| When using amounts for direct deposits a Full Amount (Net) is required. Correct the direct deposits in the source system and execute the sync again. | Write (source to Payroll) | At least one active/current deposit uses a dollar amount, and none of the active/current deposits has a percentage of exactly 100 (no Full Amount/Net deposit present). | Entire direct deposit collection skipped for this employee this cycle. Other scopes still sync. | In the source system, add a Full Amount (Net) (100 percent) deposit alongside this employee's flat-amount deposits. |
Confirming the Error
- Open the sync execution for the run in question.
- Find the step for the Payroll connector in that execution.
- Open the Employees entity row for that step.
- Check the Errors, Warnings, Information, Failures, Added, Updated, and Unchanged counts for that row. For this family, the affected employee will normally still show under Added or Updated (the employee record itself still writes) while also contributing to the Errors count, because these checks only stop the direct deposit collection, not the whole employee. A non-zero Failures count on the employee row is a different problem and is not caused by this family; escalate it rather than treating it as a direct deposit issue.
- Open the errors list for that entity row and match the reported text word for word against the Message text column above (none of these messages include the employee's name or any inserted values).
- Use the employee identifier or name shown on the entity row or error line in the Sync History screen to determine which employee the error belongs to, since the message text itself does not name the employee.
Resolving the Error
A valid set of direct deposits for one employee must satisfy all of the following, checked in this order by the sync:
- Every direct deposit on the employee, including inactive or expired ones, has a start date.
- Every deposit that is active, currently effective, and not expired (and kept after the 6-deposit-per-employee cap) has an account type, an account number, a routing number, and either a dollar amount or a percentage.
- Those same deposits have priorities numbered 1, 2, 3, and so on with no gaps or duplicates.
- Those deposits are all percentages, or all flat amounts plus one 100 percent Full Amount (Net) deposit; flat amounts cannot be mixed with a partial percentage.
- At most one deposit is a Full Amount (Net) deposit (percentage of exactly 100).
- If a Full Amount (Net) deposit exists, it has the lowest priority (the last position).
- If using percentages only: with no Full Amount (Net) deposit, all percentages add up to exactly 100; with a Full Amount (Net) deposit present, all percentages combined add up to under 200.
- If any deposit uses a dollar amount, exactly one deposit must be the Full Amount (Net) deposit.
To resolve any message in this family:
- Identify the employee from the entity row in Sync History.
- Open that employee's direct deposit records in the source system feeding this Payroll connector.
- Correct the specific rule named in the Fix column for the message reported.
- Because several of these rules interact, re-check the full checklist above before re-running the sync, not just the one rule that was reported (the sync only reports the first rule or group of rules it finds broken).
- Re-run the sync for this connector and confirm the employee's direct deposit entity no longer appears in the Errors list.
When to Escalate
If any of the following occur, you may need to reach out to Arcoro support for additional assistance.
- The same message keeps appearing after the direct deposits have been corrected in the source system and the sync has been re-run.
- The reported text does not match any Message text in the table above word for word.
- The employee's Failures count is non-zero rather than (or in addition to) the Errors count; this family only produces Errors, not Failures.
- The error text looks like a raw message passed through from the source system or from Arcoro Payroll's backend rather than one of the fixed messages listed above.