Module Navigation

Troubleshooting Acumatica Integration Error: Employee Identity and Demographics

When Arcoro syncs an employee out to Acumatica, it checks a handful of core identity fields before it will send anything: Employee ID, First Name, Last Name, Birth Date, Social Security Number, and a home address with a Country. These checks run against the employee record inside Arcoro, not against anything in Acumatica. If any one of them fails, the employee is held back and nothing is written for that employee on that run. Everyone else in the sync still processes normally.

Error Messages

Message textDirectionOccurs whenOutcomeFix
Social Security Number is required.Write: Arcoro to AcumaticaThe employee's Social Security Number field is blank (empty or whitespace only).Whole record skippedEnter a Social Security Number for the employee in Arcoro, then resync.
Employee Id is required.Write: Arcoro to AcumaticaThe employee's Employee ID field is blank (empty or whitespace only).Whole record skippedEnter an Employee ID for the employee in Arcoro, then resync.
EmployeeIdentifier can not be greater than 10 characters.Write: Arcoro to AcumaticaThe Employee ID is not blank, and its length is greater than 10 characters.Whole record skippedShorten the Employee ID to 10 characters or fewer in Arcoro, then resync.
First Name is required.Write: Arcoro to AcumaticaThe employee's First Name field is blank (empty or whitespace only).Whole record skippedEnter a First Name for the employee in Arcoro, then resync.
Last Name is required.Write: Arcoro to AcumaticaThe employee's Last Name field is blank (empty or whitespace only).Whole record skippedEnter a Last Name for the employee in Arcoro, then resync.
Birth Date is required.Write: Arcoro to AcumaticaThe employee has no Birth Date value at all.Whole record skippedEnter a Birth Date for the employee in Arcoro, then resync.
Employee Address is required. The employee record will not be synced. Please correct this in the source system and try the sync again.Write: Arcoro to AcumaticaThe employee has no address record of type Home (Primary) or Home (Secondary).Whole record skippedAdd a Home (Primary) or Home (Secondary) address for the employee in Arcoro, then resync.
Country is required. The employee record will not be synced. Please correct this in the source system and try the sync again.Write: Arcoro to AcumaticaA Home (Primary) or Home (Secondary) address was found, but that address has no Country value.Whole record skippedSet the Country on the employee's home address to United States in Arcoro, then resync.
Employee [employee ID] possesses a non-U.S. address, which is currently not supported. If this address is accurate, please manually input the information into your provider.Write: Arcoro to AcumaticaA Home (Primary) or Home (Secondary) address was found with a Country value, and that value is anything other than United States.Whole record skippedConfirm the address is correct, then manually enter this employee in Acumatica; non-U.S. addresses are not synced.

Note: the EmployeeIdentifier can not be greater than 10 characters message is logged as an error in the sync log, even though its internal name suggests a warning. Treat it exactly like the other rows in this table: it blocks the write for that employee.

These nine checks all run independently for the same employee in the same write attempt, except for the three address related checks (address missing, country missing, non-U.S. address), which are mutually exclusive with each other but not with the other six. This means a single sync run can log several of these messages together for one employee, for example Employee Id is required. together with Birth Date is required. if both fields are blank at the same time.

Confirming the Error

  1. Open Sync History and locate the sync execution in question.
  2. Confirm the step is the Acumatica connector before doing anything else. Several of these sentences, such as First Name is required. and Employee Id is required., are short enough that other connectors log nearly identical text; matching the wrong connector will send you down the wrong troubleshooting path.
  3. Find the row for the Employees entity and check its Errors and Warnings columns. A non-zero Errors count for this entity is consistent with one of these messages.
  4. Open the entity row's errors list and locate the message for the affected employee.
  5. Match on the fixed part of the sentence, not the bracketed or quoted values. For example, match on possesses a non-U.S. address, which is currently not supported rather than the employee ID that appears in that sentence.
  6. Check whether more than one of the messages in this article appears for the same employee in the same run. If so, all of them need to be corrected before that employee will sync.

Resolving the Error

Employee ID, First Name, Last Name, Birth Date, or Social Security Number Missing

  1. In Arcoro, open the employee's record and find the field named in the message (Employee ID, First Name, Last Name, Birth Date, or Social Security Number).
  2. Enter the missing value and save the record.
  3. Run the sync again for this connector.
  4. Confirm the fix worked by checking that the employee no longer appears in the entity's errors list, and that the employee's Added or Updated count increased for this run.

Employee ID Longer Than 10 Characters

  1. In Arcoro, open the employee's record and locate the Employee ID field.
  2. Shorten the value to 10 characters or fewer. Acumatica does not accept a longer identifier.
  3. Save the record and run the sync again.
  4. Confirm the fix worked by checking that the employee no longer appears in the entity's errors list.

Employee Address is Required

  1. In Arcoro, open the employee's record and check the Addresses section.
  2. Add an address and mark its type as Home (Primary), or Home (Secondary) if the employee does not use a primary home address.
  3. Save the record and run the sync again.
  4. Confirm the fix worked by checking that the employee no longer appears in the entity's errors list.

Country is Required

  1. In Arcoro, open the employee's record and find the Home (Primary) or Home (Secondary) address already on file.
  2. Set the Country field on that address.
  3. Save the record and run the sync again.
  4. Confirm the fix worked by checking that the employee no longer appears in the entity's errors list.

Non-U.S. Address Not Supported

  1. In Arcoro, confirm the Country value on the employee's Home (Primary) or Home (Secondary) address.
  2. If the address is accurate and is genuinely outside the United States, this employee cannot be synced to Acumatica for this field. The message directs you to manually enter the employee's information directly in Acumatica instead.
  3. If the address is not accurate, correct the Country value in Arcoro to United States and run the sync again.
  4. Confirm the fix worked by checking that the employee no longer appears in the entity's errors list, or by confirming that you have manually entered the employee in Acumatica.

When to Escalate

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

  • You confirm the employee's Employee ID, First Name, Last Name, Birth Date, Social Security Number, and home address with Country are all filled in correctly in Arcoro, but the same message keeps appearing after a resync.
  • The employee has a non-U.S. address that is accurate, and you want to know whether non-U.S. address support is planned. Escalate this as a product question rather than promising a workaround.
  • The same employee logs a different, unexplained error alongside one of these nine messages that is not covered in this article.
Was this article helpful?
0 out of 0 found this helpful