HCSS utilizes a write-only connector where Arcoro sends employee data out to HCSS and HCSS never sends data back into Arcoro. Before Arcoro sends an employee record to HCSS, it checks that the record has the minimum required information for HCSS to identify the employee: an employee ID, a first name, and a last name.
If any of these three fields is blank on the Arcoro side, Arcoro will not send that employee to HCSS, and the sync log will show an error for that employee.
Error Messages
If any one of these three conditions is true, it will block the employee from syncing to HCSS. If more than one condition is true at the same time, all matching messages appear together for that employee, and the employee is skipped only once.
| Message text | Direction | Occurs When | Outcome | Fix |
|---|---|---|---|---|
| Employee ID is required. | Arcoro to HCSS | The employee's Employee Identifier field is blank in Arcoro. | Whole record skipped | Add an Employee ID to the employee record in Arcoro. |
| First Name is required. | Arcoro to HCSS | The employee's First Name field is blank in Arcoro. | Whole record skipped | Add a First Name to the employee record in Arcoro. |
| Last Name is required. | Arcoro to HCSS | The employee's Last Name field is blank in Arcoro. | Whole record skipped | Add a Last Name to the employee record in Arcoro. |
Confirming the Error
- Click "Sync History" and open the sync record with the sync error from the Arcoro sync history screen.
- Find the step for the HCSS connector.
- Locate the Employees entity row for that step. Check the "Errors" column. A non-zero Errors count indicates that at least one employee had a problem during this run.
- Open the Employees entity row to see the per-employee error list.
- Find the affected employee and what is needed to resolve the issue: "Employee Id is required.", "First Name is required.", or "Last Name is required."
- Also note whether the entity row has an accompanying message that the employee has one or more validation errors and will not be synced. This confirms the record was skipped rather than partially written.
- A non-zero Failures count on the Employees row is a different signal than Errors. Failures on this row indicate the sync itself could not complete for that entity, not that an individual employee failed validation. Treat Failures and Errors as separate facts when reading this row.
Resolving the Error
Filling In Field
- In Core HR, search for and open the affected employee's profile.
- Go to the employee's Demographic Information and confirm that the relevant Employee ID, First Name, and/or Last Name field has a value.
- Double-check that there is no whitespace or phantom characters. These characters are not visible and may affect data syncing.
- Save your changes.
- Re-run the sync and confirm the employee no longer appears in the Employees entity error list.
When to Escalate
If any of the following occur, you should reach out to Arcoro support for additional assistance.
- The employee record in Arcoro already has a value in the field named in the message, but the error still appears after a re-run.