This family covers two different problems that both show up under the label "configuration." The first group fires before a sync can even start: a required connector setting is blank, or the connector cannot be matched to a Payroll company at all. Some of those show up in the sync log as a stopped sync, and some show up only when someone tests or saves the connector, never in a sync log. The second group fires during a sync run because a value that has to be entered in the Run Sync dialog for that specific run, such as a Pay Date or a date range, was left blank or does not match anything in Payroll. Telling these two groups apart is the fastest way to close the ticket.
Error Messages
| Message text | Direction | Occurs when | Outcome | Fix |
|---|---|---|---|---|
| Payroll Provider could not read the required configuration setting for the Base URL. Try the Sync again and if this problem persists contact Arcoro support. | Setup, both directions (before any records are read or written) | An internal application setting that supplies the Payroll service URL is missing or blank. This is not a field on the connector setup screen; it is checked when the provider is constructed at the start of every sync step. | Sync stopped | Escalate immediately. There is no end-user-facing field for you to adjust. |
| Payroll Provider could not read the configuration setting '[configuration setting name]'. | Setup, both directions (before any records are read or written) | For this provider this message always names the CompanyId field: the CompanyId value on the connector's Configuration Properties is blank when the provider is constructed at the start of a sync step. | Sync stopped | Enter a value in the CompanyId field on the connector's Configuration Properties, then run the sync again. |
| Payroll Provider could not find the Arcoro Company ID for the company. Contact Arcoro Support for assistance in resolving this issue. | Setup, both directions (during authentication, before any records are read or written) | Payroll returned the company record for the configured CompanyId, but that company's metadata in Payroll has no Arcoro Company ID recorded against it. | Sync stopped | Escalate. The link between the Payroll company and its Arcoro company must be corrected on the Payroll side. |
| The company was not found in Payroll. Verify if the Id is correct and if the company was added to Payroll. Contact Arcoro Support for assistance in resolving this issue. | Connection test only, not a sync run | Someone runs Test Connection (or saves the connector, which re-runs the test) and the CompanyId entered on Configuration Properties does not resolve to any company known to Payroll. | Connection test fails; no sync entities are processed | Escalate. Confirm the CompanyId is correct and that the company exists in Payroll before retrying the test. |
| The Company Id value is required. | Connection test only, not a sync run | Someone runs Test Connection and the CompanyId field on Configuration Properties is blank. This check runs before Payroll is even contacted. | Connection test fails; no sync entities are processed | Enter a value in the CompanyId field on the connector's Configuration Properties, then retest. |
| The Payroll Company Id in Configuration Properties does not match the select company '[company name]'. | Connection test only, not a sync run | Test Connection resolves the CompanyId to a Payroll company, but that company's linked Arcoro company does not match the Arcoro company the connector itself is configured for. | Connection test fails; no sync entities are processed | Escalate. The CompanyId on Configuration Properties must point to a Payroll company linked to the same Arcoro company as the connector. |
| Arcoro Hub has not been enabled for the company. Contact Arcoro Support to correct this issue. | Connection test only, not a sync run | Test Connection passes the CompanyId and company-match checks, then finds that Arcoro Hub is not enabled for the tenant. | Connection test fails; no sync entities are processed | Escalate to have Arcoro Hub enabled for the company. |
| The Sync execution includes General Ledger but does not specify the Pay Date. This value is required for the Provider to read data. Update the Sync to specify the Pay Date and execute the Sync again. | Read (Payroll to Arcoro), General Ledger | The sync run includes the General Ledger entity and no Pay Date value was supplied for that run. | Record skipped (the General Ledger read for this run returns nothing) | Add a Pay Date value when running the sync and run it again. |
| The Pay Schedule filter provided does not exist in Payroll and is invalid. Correct or remove the filter value and execute the Sync again. | Read (Payroll to Arcoro), General Ledger and Pay Schedules | A Pay Schedule filter value was supplied for the run and it does not match, case-insensitively, the name of any pay schedule in Payroll. For a General Ledger run this is checked after the Pay Date check above. For a Pay Schedules run this is checked against the full list of pay schedules before any pay schedule is read. | Varies: General Ledger read has that record skipped; Pay Schedules read stops the sync | Correct or remove the Pay Schedule filter value when running the sync, then run it again. |
| The 'Pay Schedule' parameter is required when syncing Time Records. Please provide a value for the Pay Schedule when executing the sync again. | Read (Payroll to Arcoro), Time Records | The sync run includes Time Records and no Pay Schedule value was supplied for that run. Checked before any Time Record is read. | Sync stopped | Add a Pay Schedule value when running the sync and run it again. |
| The 'Pay Date' parameter is required when syncing Time Records. Please provide a value for the Pay Date when executing the sync again. | Read (Payroll to Arcoro), Time Records | The sync run includes Time Records and no Pay Date value was supplied for that run. Checked immediately after the Pay Schedule check above. | Sync stopped | Add a Pay Date value when running the sync and run it again. |
| The Sync execution includes Expenses but does not specify the Start Date and End Date. These values are required for the Provider to Sync Expenses. Update the Sync to specify these values and execute the Sync again. | Write (Arcoro to Payroll), Expenses | The sync run includes Expenses and either the Start Date or the End Date value was not supplied for that run. This is checked for every expense record in the run, before that record's employee or amount data is looked at. | Whole record skipped, repeated for every expense record in the run | Add both a Start Date and an End Date when running the sync and run it again. |
| The Sync execution includes Time Records but does not specify the Start Date and End Date. These values are required for the Provider to Sync Time Records. Update the Sync to specify these values and execute the Sync again. | Write (Arcoro to Payroll), Time Records | The sync run includes Time Records and either the Start Date or the End Date value was not supplied for that run. This is checked for every time record in the run, before that record's employee data is looked at. | Whole record skipped, repeated for every time record in the run | Add both a Start Date and an End Date when running the sync and run it again. |
| The Sync execution includes Time Off Balance but does not specify the Start Date and End Date. These values are required for the Provider to Sync Time Off Balance. Update the Sync to specify these values and execute the Sync again. | Write (Arcoro to Payroll), Time Off Balance | The sync run includes Time Off Balance and either the Start Date or the End Date value was not supplied for that run. This is checked for every employee's time off balance record in the run, before the employee identifier is checked. | Whole record skipped, repeated for every time off balance record in the run | Add both a Start Date and an End Date when running the sync and run it again. |
| When syncing benefits both the deductions and fringes scopes must be selected. Update the sync settings to include both scopes and execute the sync again. | Write (Arcoro to Payroll), Employees (benefit deductions and fringe benefits) | Exactly one of the two scopes, Deduction Benefits or Fringe Benefits, is selected for the sync step and the other is not. Both must be off, or both must be on; one on and one off triggers this on every employee processed while the sync stays in that state. | Collection item skipped: benefit deductions and fringe benefits are not written for that employee, the rest of the employee record still writes | In the sync step's scope settings, enable both the Deduction Benefits and Fringe Benefits scopes (or disable both), then run the sync again. |
Confirming the Error
- Open the sync execution for this connector in Sync History.
- Find the step for the Payroll connector, then the row for the entity named in the ticket (Employees, Time Records, Expenses, Time Off Balance, General Ledger, or Pay Schedules).
- Open the Errors column for that entity row and match the fixed part of the sentence against the table above. Ignore the values inside quotes or braces; those vary per company or setting name.
- If the message repeats once per employee (for example the benefits scope message), the Errors count for Employees will be close to the number of employees processed in that run.
- A non-zero Failures count on the run or step, rather than an entity's Errors count, means the sync stopped before entity rows were populated. This applies to the Base URL, CompanyId, Arcoro Company ID, Pay Schedules, and Time Records Pay Schedule and Pay Date messages in the table above. Read the run-level or step-level message for those instead of opening an entity row.
- The four Test Connection messages, company not found, Company Id required, Company Id mismatch, and Hub not enabled, do not appear inside a sync execution at all. They appear as the result text returned when Test Connection is run on the connector, or when the connector configuration is saved and re-validated. Check that result instead of the sync log for those four.
Resolving the Error
Base URL Setting Is Missing
- Confirm the sync stopped with the Base URL message as described above.
- There is no connector field to correct; this is an internal Arcoro application setting.
- Escalate.
CompanyId Field Is Blank on the Connector
- Open the connector in Arcoro and go to its Configuration Properties.
- Enter a value in the CompanyId field.
- Save the connector and run the sync again.
- Confirm the fix by checking that the entity no longer appears in the Errors list, or that the run no longer shows a Failures count for this reason.
Arcoro Company ID Missing on the Payroll Company
- Confirm the sync stopped with the Arcoro Company ID message as described above.
- This is a data problem on the Payroll side linking the Payroll company to its Arcoro company; it is not a connector field a support agent can edit.
- Escalate.
Connection Test Cannot Find or Match the Payroll Company
- Open the connector's Configuration Properties and confirm the CompanyId field has a value.
- If it is blank, enter the correct CompanyId, save, and retest.
- If it has a value but the test still reports the company was not found, or that the Company Id does not match the selected company, escalate. Both require checking or correcting data on the Payroll side.
Arcoro Hub Not Enabled
- Confirm the connection test failed with the Arcoro Hub message.
- Escalate to have Arcoro Hub enabled for the company.
Pay Date Missing for a General Ledger Sync
- Open the Run Sync dialog for this connector.
- Enter a Pay Date value.
- Run the sync again.
- Confirm the fix by checking that the General Ledger entity no longer shows this error.
Pay Schedule Filter Does Not Match Anything in Payroll
- Open the Run Sync dialog for this connector.
- Correct the Pay Schedule value to match an existing pay schedule name in Payroll, or clear the field to remove the filter.
- Run the sync again.
- Confirm the fix by checking that the affected entity (General Ledger record, or the Pay Schedules step) no longer errors and, for Pay Schedules, that the run no longer shows a Failures count for this reason.
Pay Schedule or Pay Date Missing for a Time Records Sync
- Open the Run Sync dialog for this connector.
- Enter a value for Pay Schedule and for Pay Date.
- Run the sync again.
- Confirm the fix by checking that the run no longer shows a Failures count for this reason.
Start Date and End Date Missing for Expenses, Time Records, or Time off Balance
- Open the Run Sync dialog for this connector.
- Enter both a Start Date and an End Date.
- Run the sync again.
- Confirm the fix by checking that the affected entity's Errors count has dropped and records now show as Added, Updated, or Unchanged.
Only One Benefit Scope Selected
- Open the sync step's scope settings for Employees.
- Enable both the Deduction Benefits and Fringe Benefits scopes together, or disable both together.
- Run the sync again.
- Confirm the fix by checking that the Employees entity's Errors count for this message has dropped to zero.
When to Escalate
If any of the following occur, you may need to reach out to Arcoro support for additional assistance.
- The Base URL, Arcoro Company ID, company-not-found, Company ID mismatch, or Arcoro Hub messages appear at all.
- A CompanyId value is entered and correct, but the connection test or sync still reports the company cannot be found or matched.
- The error persists after the Run Sync dialog values (Pay Date, Pay Schedule, Start Date, End Date) or the benefit scopes have been corrected and the sync run again.
- The message text in the log does not match any row in the table above.
- The outcome is a stopped sync (a Failures count) and the run-level message does not match the wording in this article.