Before an employee is written to Viewpoint Spectrum, the sync checks the employee's Employee Type and Hire Date, and, only for employees who are terminated or deceased, the Termination Reason and Termination Date. If any of these checks fail, that employee is not sent to Spectrum for this run. No field on that employee is written, not just the field that failed.
The Employee Type and Hire Date checks run for every employee, every time. The two termination checks only run when the employee's Employee Type resolves to one of the codes Spectrum uses for Terminated or Deceased. An active employee, or any employee whose Employee Type resolves to something other than those two codes, will never see either termination message. None of these checks stop the others from running, so one employee can show more than one of these messages in the same run.
Error Messages
| Message text | Direction | Occurs when | Outcome | Fix |
|---|---|---|---|---|
| Employee Type is missing or in an invalid format. The Employee will not be Synced. The supported formats are either "Code-Description" or "Code". Correct the data in the source system and execute the Sync again. | Write (Arcoro to Spectrum) | The Employee Type field on the Arcoro employee record is blank, or, once anything after the first dash is dropped, nothing usable is left (for example the value is only whitespace, or it starts with a dash). | Record skipped | In Arcoro, set Employee Type to a valid code, either by itself or as Code-Description, then run the sync again. |
| Termination Reason is required when employee status is: [the Employee Type codes for Terminated (T) and Deceased (D)]. | Write (Arcoro to Spectrum) | The employee's Employee Type resolves to the Terminated (T) or Deceased (D) code, and the Termination Reason value for that employee is blank. | Record skipped | In Arcoro, enter a Termination Reason on the employee's termination information, then run the sync again. |
| Termination Date is required when employee status is: [the Employee Type codes for Terminated (T) and Deceased (D)]. | Write (Arcoro to Spectrum) | The employee's Employee Type resolves to the Terminated (T) or Deceased (D) code, and the Termination Date field for that employee has no value. | Record skipped | In Arcoro, enter a Termination Date on the employee's termination information, then run the sync again. |
| Hire Date is required. | Write (Arcoro to Spectrum) | The Hire Date field on the Arcoro employee record has no value. This check runs regardless of Employee Type or status. | Record skipped | In Arcoro, enter a Hire Date on the employee record, then run the sync again. |
Employee Type accepts two formats: a plain code by itself (for example T), or a code followed by a dash and a description (for example T-Terminated). Only the part before the first dash is used as the code. This matches what the message text says, and it is why a value that is only a description with no code, or a value that starts with a dash, is treated as missing.
The two termination messages are gated entirely by Employee Type. If Employee Type is blank or does not resolve to a usable code, only the Employee Type message can fire for that reason; the termination checks are skipped for that employee in that run because there is no resolved code to compare against Terminated or Deceased. Once Employee Type does resolve to Terminated or Deceased, Termination Reason and Termination Date are checked independently of each other, so both can fire together on the same employee. Hire Date is checked independently of Employee Type and status entirely, so it can appear on its own, alongside the Employee Type message, or alongside either termination message, all on the same employee in the same run.
Confirming the Error
- Open the sync history for the connector and find the sync execution for the run in question.
- Open the step for the Viewpoint Spectrum connector.
- Find the affected employee row. A non-zero count in the Errors column for that employee row means one or more of these checks failed. Check the Warnings, Information, and Failures columns too, since those are separate counts and do not indicate this family of issues by themselves. The Added, Updated, and Unchanged columns will show no change for that employee, since the record was skipped.
- Open the employee row and review the errors list. Match on the fixed part of each sentence (for example, Hire Date is required or is missing or in an invalid format), not on any quoted or substituted value, since the substituted part is always the same fixed code list and never employee-specific data.
- Read the full errors list for that employee before fixing anything. It is common to see more than one of these messages on the same employee in the same run, for example, a missing Hire Date together with a missing Termination Reason.
Resolving the Error
Employee Type Is Missing or in an Invalid Format
- Open the employee's record in Arcoro and locate the Employee Type field.
- Have them enter a valid code, either alone or as Code-Description (for example, T-Terminated).
- Save the record.
Missing Hire Date
- Open the employee's record in Arcoro and locate the Hire Date field.
- Have them enter the employee's hire date.
- Save the record.
Missing Termination Reason or Termination Date
- Confirm the employee's Employee Type is set to Terminated or Deceased. If it is not, and you still expect these fields to be required, escalate rather than continuing here.
- Open the employee's termination information in Arcoro.
- Have them enter a Termination Reason, a Termination Date, or both, depending on which message appeared.
- Save the record.
After the correction is saved in Arcoro, run the sync again. Confirm the fix by reopening the sync history for the new run and checking that the employee row now shows the record processed (an entry in Added or Updated) with no entry in Errors for that employee.
When to Escalate
If any of the following occur, you may need to reach out to Arcoro support for additional assistance.
- Employee Type, Hire Date, Termination Reason, and Termination Date all look correct on the employee record in Arcoro, but the same message still appears after a fresh sync run.
- The errors list shows a message with this same wording but referencing a field not covered in this article.
- You cannot find or edit the Termination Reason field on the employee's termination information in Arcoro.
- The employee's Employee Type looks correct, but the sync still treats it as Terminated or Deceased when you expect an active status, or the opposite.