Module Navigation

Sage Intacct Troubleshooting: Employee Identity and Demographics

Sage Intacct will not accept a new or updated Employee or Contractor unless certain identity fields are present. Arcoro checks these fields before it sends anything to Sage Intacct. If any one of them is missing, that person is not sent at all, and nothing about them is created or updated in Sage Intacct. Every message in this article is the same story: a field the destination requires is empty in the source data.

Error Messages

Message textDirectionOccurs whenOutcomeFix
EmployeeIdentifier is required. This employee can not be saved. Correct the source data and run the sync again.Arcoro to Sage Intacct (write). Fires on an Employee record or a Contractor record; the sentence is identical for both.The person's Employee ID (or Contractor ID for a contractor) is null or an empty string. A value made up only of spaces does not trigger this message; it is caught by a separate format check covered in the field length and format article instead.Whole record skipped. No Contact or Employee object is created or updated in Sage Intacct for this person.Enter an Employee ID or Contractor ID for the person in the source system.
Social Security Number is required. Correct the data in the Source system and execute the Sync again.Arcoro to Sage Intacct (write). Employee records only, not Contractor records.The employee's Social Security Number field is null, empty, or whitespace only. This check runs on every employee write regardless of which sync scopes are enabled; it is not gated by a scope setting.Whole record skipped.Enter the employee's Social Security Number in the source system.
First Name is required. Correct the data in the Source system and execute the Sync again.Arcoro to Sage Intacct (write). Fires on an Employee record or a Contractor record; the sentence is identical for both.The person's First Name field is null, empty, or whitespace only.Whole record skipped.Enter a First Name for the person in the source system.
Last Name is required. Correct the data in the Source system and execute the Sync again.Arcoro to Sage Intacct (write). Fires on an Employee record or a Contractor record; the sentence is identical for both.The person's Last Name field is null, empty, or whitespace only.Whole record skipped.Enter a Last Name for the person in the source system.

Confirming the Error

  1. Open the sync execution in Sync History for the connector.
  2. Confirm the step you are looking at is the Sage Intacct connector step. All four of these messages are short, generic sentences that other Arcoro connectors also emit, so confirming the connector first prevents a false match.
  3. Open the Employees row or the Contractors row for that step. The row's Errors column will show a non-zero count for the affected sync.
  4. Open the errors list for that entity row and match the whole sentence. None of these four messages carry any variable text, so there is no quoted value to ignore and no partial match to worry about.
  5. The Sync History columns for that entity row are labelled Errors, Warnings, Information, Failures, Added, Updated, and Unchanged. All four messages in this article count under Errors. A non-zero Failures count means something else happened; that is out of scope for this article.

Resolving the Error

Employee ID or Contractor ID Missing

  1. In the source system, open the employee or contractor record named in the sync log entry.
  2. Confirm the Employee ID (or Contractor ID) field has a value. A field containing only spaces will not clear this specific error; if the error says the field "looks empty" but this error is not the one showing, check for a stray leading or trailing space instead.
  3. Save the record in the source system.
  4. Re-run the sync and confirm the person no longer appears in the Employees or Contractors entity's Errors list.

Social Security Number Missing

  1. In the source system, open the employee record named in the sync log entry.
  2. Confirm the Social Security Number field has a value. Enter or verify the number directly in their own system.
  3. Save the record in the source system.
  4. Re-run the sync and confirm the employee no longer appears in the Employees entity's Errors list.

First Name or Last Name Missing

  1. In the source system, open the employee or contractor record named in the sync log entry.
  2. Confirm both the First Name and Last Name fields have values. Both checks run independently, so a record can show both messages at once; fix both fields before re-running.
  3. Save the record in the source system.
  4. Re-run the sync and confirm the person no longer appears in the Employees or Contractors entity's Errors list.

When to Escalate

If any of the following occur, you may need to reach out to Arcoro support for additional assistance.

  • The message persists after the field has been confirmed populated and saved in the source system.
  • The log text does not match any message in the table above; it may belong to a different article or be passthrough text from Sage Intacct itself.
  • For the Employee ID or Contractor ID message: the field is visibly populated in the source system but the error still fires on every sync.
Was this article helpful?
0 out of 0 found this helpful