Module Navigation

Troubleshooting CMiC Integration Error: Employee Identity and Demographics

Before an employee record is sent to CMiC, the write service checks a set of required identity fields: employee id, first name, last name, marital status, and home address. It also checks that certain fields do not exceed the maximum length CMiC allows, and that the employee's home address is a US address, since CMiC does not accept non-US home addresses through this sync. If any of these checks fail, the affected data is not sent to CMiC and the sync log records exactly which field caused the problem. Most of these problems are fixed by correcting a value on the employee record in Arcoro, not in CMiC.

Error Messages

Message textDirectionOccurs whenOutcomeFix
Employee Id is required. Employee will not be sent to CMiC.Write (Arcoro to CMiC)The employee's Employee Id field is blank.Whole employee record is skipped.Enter an Employee Id on the employee record in Arcoro.
Employee's ID exceeds the maximum length of 16 characters supported by the provider and will not be synced.Write (Arcoro to CMiC)The Employee Id is present but longer than 16 characters.Whole employee record is skipped.Shorten the Employee Id in Arcoro to 16 characters or fewer.
Employee First Name is required. Employee will not be sent to CMiC.Write (Arcoro to CMiC)The employee's First Name field is blank.Whole employee record is skipped.Enter a First Name on the employee record in Arcoro.
Employee's first name exceeds the maximum length of 60 characters supported by the provider and will not be synced.Write (Arcoro to CMiC)The First Name is present but longer than 60 characters.Whole employee record is skipped.Shorten the First Name in Arcoro to 60 characters or fewer.
Employee Last Name is required. Employee will not be sent to CMiC.Write (Arcoro to CMiC)The employee's Last Name field is blank.Whole employee record is skipped.Enter a Last Name on the employee record in Arcoro.
Employee's last name exceeds the maximum length of 60 characters supported by the provider and will not be synced.Write (Arcoro to CMiC)The Last Name is present but longer than 60 characters.Whole employee record is skipped.Shorten the Last Name in Arcoro to 60 characters or fewer.
Employee Marital status is missing. Employee will not be sent to CMiC.Write (Arcoro to CMiC)The employee's Marital Status field has no value set.Whole employee record is skipped.Set a Marital Status on the employee's demographic information in Arcoro.
Employee Home Address is missing. Employee will not be sent to CMiC.Write (Arcoro to CMiC)The employee has no address marked as a preferred home address (primary or secondary) in Arcoro.Whole employee record is skipped.Add a home address to the employee in Arcoro and mark it as the preferred home address.
Employee Home Address Postal Code is missing. Employee will not be sent to CMiC.Write (Arcoro to CMiC)A home address exists, but its Postal Code field is blank. This check only runs when a home address was found, so it will not occur on the same employee as the missing home address message above.Whole employee record is skipped.Enter a Postal Code on the employee's home address in Arcoro.
Country could not be mapped to a valid value. Non-US addresses are not supported by CMiC. The address data will not be synced. Value: [country value]Write (Arcoro to CMiC)The employee's home address (already confirmed to exist and have a postal code) has a country that is not the United States, or has no country set and a Canadian province, or has no country and no state set at all.For a new employee not yet in CMiC, the whole employee record is skipped, together with the summary message below. For an employee that already exists in CMiC, only the address fields are skipped; the rest of the employee record still writes normally for any other enabled scopes.Correct the country, and state or province if applicable, on the employee's home address in Arcoro so it is a valid US address. CMiC does not support non-US home addresses through this sync.
One or more address data is invalid, please review log errors. The employee will not be created in CMiC. Correct the data in source system and run the sync again.Write (Arcoro to CMiC)This is a summary message. It only appears alongside the country message above, and only when the employee is being created in CMiC for the first time (it does not appear on an update to an existing employee). It can also appear on the same employee alongside an unrelated missing compensation error, which belongs to a different family.Whole employee record is skipped (not created in CMiC).Fix the home address country issue described above, then run the sync again.

Confirming the Error

  1. Open Sync History and find the sync execution for the CMiC connector and the date and time of occurrence.
  2. Open the step for the CMiC connector in that execution.
  3. Find the Employees entity row for that step. Check the Errors column for a non-zero count. Failures is a step-level count and tab, not a per-entity column; a non-zero Failures count on the step is a separate, more severe problem and does not indicate one of the messages in this article.
  4. Open the entity row to see its list of errors, and find the row for the employee in question.
  5. Match the message in the log against the fixed part of the sentence in the table above, not against any bracketed value, since values like the country code will vary per employee.

Resolving the Error

Employee ID

  1. In Arcoro, open the employee record and check the Employee Id field.
  2. If it is blank, enter an Employee Id.
  3. If it is longer than 16 characters, shorten it to 16 characters or fewer.

First Name

  1. In Arcoro, open the employee record and check the First Name field.
  2. If it is blank, enter a First Name.
  3. If it is longer than 60 characters, shorten it to 60 characters or fewer.

Last Name

  1. In Arcoro, open the employee record and check the Last Name field.
  2. If it is blank, enter a Last Name.
  3. If it is longer than 60 characters, shorten it to 60 characters or fewer.

Marital Status

  1. In Arcoro, open the employee's demographic information.
  2. Set a value for Marital Status.

Home Address and Postal Code

  1. In Arcoro, open the employee's Addresses section.
  2. Confirm the employee has an address marked as the preferred home address. If not, add one.
  3. Confirm the home address has a Postal Code entered. If not, enter one.

Home Address Country

  1. In Arcoro, open the employee's home address.
  2. Confirm the Country field is set to the United States. CMiC does not support non-US home addresses through this sync.
  3. If the address is in Canada or has no country set, correct the Country field and the State or Province field to a valid US address.

To confirm any of the fixes above, run the sync again for the CMiC connector and the Employees entity, then check the Employees row in Sync History. The Errors count for that employee should be gone, and the employee should now appear under Added or Updated.

When to Escalate

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

  • The employee's data in Arcoro looks correct and within the length limits described above, but the same error keeps appearing after a re-run.
  • The home address country message appears for an address you confirm is a valid US address.
  • You need a non-US employee synced to CMiC. This sync does not support that.
Was this article helpful?
0 out of 0 found this helpful