Acumatica needs the employee's status, hire date, rehire date, and termination date to agree with each other before it will accept a change. All eight messages in this article come from the same write step: the platform is sending an employee from Arcoro out to Acumatica and one of those date or status checks failed. Four of the messages stop the entire employee from syncing. The other four only stop the employee's employment history record, so the rest of the employee's changes still go through. Every fix for this family happens in Arcoro, not in Acumatica, since this is the system the data is written from.
Error Messages
| Message text | Direction | Occurs when | Outcome | Fix |
|---|---|---|---|---|
| Employee hire date is required. | Arcoro to Acumatica (write) | The connector's Occupation scope is enabled, and the platform is trying to record a new hire, rehire, or termination event for the employee, but the employee has no Rehire Date or Termination Date that qualifies, and no Hire Date is present either. | Employment history record skipped. Other employee changes still sync. | Enter a Hire Date on the employee in Arcoro. |
| Termination Date is required for terminated employees. The employee record will not be synced. Please correct this in the source system and try the sync again. | Arcoro to Acumatica (write) | The employee's Employment Status is Terminated, and Termination Date is blank. | Whole employee record skipped. | Enter a Termination Date on the employee in Arcoro. |
| Termination Reason is required for a terminated employee. The employee record will not be synced. Please correct this in the source system and try the sync again. | Arcoro to Acumatica (write) | The employee's Employment Status is Terminated, and Termination Reason is blank. | Whole employee record skipped. | Enter a Termination Reason on the employee in Arcoro. |
| Termination Date must be after both the hire date and rehire date for terminated employees. The employee record will not be synced. Please correct this in the source system and try the sync again. | Arcoro to Acumatica (write) | The employee's Employment Status is Terminated, Termination Date has a value, and that Termination Date is earlier than the employee's Hire Date, or earlier than the employee's Rehire Date. | Whole employee record skipped. | Correct the Termination Date, Hire Date, or Rehire Date on the employee in Arcoro so Termination Date is the latest of the three. |
| The employee is considered inactive due to an effective termination date, but their status is not set to Terminated in the source system. The employee record will not be synced. Please correct this in the source system and try the sync again. | Arcoro to Acumatica (write) | The employee's Employment Status is anything other than Terminated, Termination Date has a value, and neither Rehire Date nor Hire Date falls after that Termination Date. | Whole employee record skipped. | In Arcoro, either set Employment Status to Terminated to match the Termination Date, or clear the Termination Date if the employee is still active, or enter a Rehire Date or Hire Date that is after the Termination Date if the employee was rehired. |
| Employee has a Termination Date greater than the Hire Date but Status is not 'Terminated'. The History record will not be synced, but other changes will be processed. Please change the employee Status to 'Terminated' or remove the Termination Date in the source system, then sync again. | Arcoro to Acumatica (write) | The connector's Occupation scope is enabled. The employee has a Termination Date that falls after their Hire Date and no later Rehire Date applies, but the employee's overall status and dates do not mark them as terminated for Acumatica purposes. | Employment history record skipped. Other employee changes still sync. | In Arcoro, set Employment Status to Terminated to match the Termination Date, or remove the Termination Date if the employee is still active. |
| Termination Date must be equal or greater than currently active employment history in Acumatica in order to end it properly. The History record will not be synced, but other changes will be processed. Please correct the data and run the sync again. | Arcoro to Acumatica (write) | The connector's Occupation scope is enabled and the employee is being terminated in this sync, and the Termination Date being applied (or today's date, if none was available at this point) is earlier than the start date of the employee's currently active employment record already in Acumatica. | Employment history record skipped. Other employee changes still sync. | Enter a Termination Date in Arcoro that falls on or after the start date of the employee's current active employment period in Acumatica. |
| Cannot create new employment history record: the new employment event date ([employment event date]) is earlier than the current active employment start date ([active start date]). The new employment event date was derived from the employee's [Rehire Date, Termination Date, Hire Date, Occupation last-modified date, or Unknown] date. Please review the employee dates for consistency. | Arcoro to Acumatica (write) | The connector's Occupation scope is enabled. The platform is closing out the employee's current active employment record to start a new one, and the calculated end date for that active record falls before the start date already on that active record in Acumatica. | Employment history record skipped. Other employee changes still sync. | Review the employee's Hire Date, Rehire Date, Termination Date, and Occupation change date in Arcoro so the new employment event date falls after the current active record's start date. |
Confirming the Error
- Open the sync execution for your Acumatica connector in Sync History.
- Find the step for the People or Employees entity and confirm the Errors column is greater than zero for the run in question.
- Open the entity row to see the per-employee results, and locate the employee.
- Open the errors list for that employee and match the fixed part of the sentence against the Message text column above. Ignore the specific dates, names, or codes in the message. Those come from quotes or placeholders and will differ per employee.
- Check the Added, Updated, and Unchanged columns for that employee's row alongside Errors. If the employee still shows as Added or Updated for this run, the message came from one of the four employment-history-only rows in the table above: the employee synced, but the status or date change tied to the employment history did not. If the employee shows no Added or Updated result for this run, the message came from one of the four whole-record rows: nothing about the employee synced this run.
- A non-zero Failures count for this entity is a different signal from Errors and is not covered by this article. Escalate a Failures count instead of researching it here.
Resolving the Error
Every fix in this family happens on the employee's record in Arcoro. Nothing is corrected in Acumatica for these eight messages, since this is a write from Arcoro out to Acumatica.
Termination Date Is Required for Terminated Employees
- Open the employee's record in Arcoro and confirm Employment Status is Terminated.
- Enter a Termination Date.
- Re-run the sync and confirm the employee moves out of the errors list for this entity.
Termination Reason Is Required for a Terminated Employee
- Open the employee's record in Arcoro and confirm Employment Status is Terminated.
- Enter a Termination Reason.
- Re-run the sync and confirm the employee moves out of the errors list for this entity.
Termination Date Must Be After Both the Hire Date and Rehire Date
- Open the employee's record in Arcoro and compare Termination Date against Hire Date and Rehire Date.
- Correct whichever date is wrong so Termination Date is the latest of the three.
- Re-run the sync and confirm the employee moves out of the errors list for this entity.
Employee Is Considered Inactive but Is Not Terminated
- Open the employee's record in Arcoro.
- If the employee truly left the company, set Employment Status to Terminated so it matches the existing Termination Date.
- If the employee is still active, clear the Termination Date, or add a Rehire Date or an updated Hire Date that falls after the Termination Date.
- Re-run the sync and confirm the employee moves out of the errors list for this entity.
Employee Hire Date Is Required
- Open the employee's record in Arcoro and check the Hire Date field.
- Enter a Hire Date.
- Re-run the sync and confirm the employee's employment history record is created or updated instead of erroring.
Termination Date Greater Than Hire Date but Status Is Not Terminated
- Open the employee's record in Arcoro.
- Set Employment Status to Terminated to match the existing Termination Date, or remove the Termination Date if the employee should still be active.
- Re-run the sync and confirm the employee's employment history record is created or updated instead of erroring.
Termination Date Must Be Equal or Greater Than the Currently Active Employment History in Acumatica
- Open the employee's record in Arcoro and check the Termination Date.
- Compare it to when the employee's current active period started. If unsure of that start date, escalate so a developer can confirm the active record's start date in Acumatica.
- Update the Termination Date in Arcoro so it falls on or after that start date.
- Re-run the sync and confirm the employee's employment history record is created or updated instead of erroring.
Cannot Create New Employment History Record: New Event Date Earlier Than Active Start Date
- Open the employee's record in Arcoro and review Hire Date, Rehire Date, Termination Date, and any recent change to the employee's occupation or position.
- Identify which of those dates the message points to using the bracketed date description in the message, and correct that date so it falls after the active record's start date.
- Re-run the sync and confirm the employee's employment history record is created or updated instead of erroring.
When to Escalate
If any of the following occur, you may need to reach out to Arcoro support for additional assistance.
- The error persists after the dates and status were corrected in Arcoro.
- The log message text does not match any row in the table above.
- You need to know the exact start date of an active employment record in Acumatica to fix the Termination Date or event date, and that value is not visible from Arcoro or the sync log.
- The Failures column for the entity is non-zero for this run.