Sage Intacct with Arcoro Time Troubleshooting: Org Structure (Department, Location, Cost Code, Cost Type, Equipment)

David N

September 11, 2026 22:10

This article covers the "org structure" building blocks that other Arcoro Time records depend on: Departments, Locations, Cost Codes, Cost Types, Equipment Types, and Equipment. Some of these flow out of Arcoro Time into Arcoro (Locations, Cost Codes), and some flow the other direction, from the source system into Arcoro Time (Departments, Cost Types, Equipment Types, Equipment).

Every message below causes only the one flagged record to be skipped. The record is not partially written and not retried automatically. Once the underlying data is corrected, the very next sync picks the record back up and processes it normally, there is no need to do anything beyond running the sync again.

Error Messages

Message text	Direction	Occurs when	Outcome	Fix
The Location's Address property 'Address Line 1' is missing but required by the Arcoro Time provider. This location will not be Synced. Correct the Location's data in Arcoro Time and run the Sync again.	Read (from Arcoro Time)	Only on a connector using the "Time for Payroll Configuration" configuration, and the Location's Address Line 1 is blank.	Whole Location record skipped.	Enter an Address Line 1 value on the Location in Arcoro Time.
The Location's Address property 'Address City' is missing but required by the Arcoro Time provider. This location will not be Synced. Correct the Location's data in Arcoro Time and run the Sync again.	Read (from Arcoro Time)	Only on a connector using the "Time for Payroll Configuration" configuration, and the Location's Address City is blank.	Whole Location record skipped.	Enter an Address City value on the Location in Arcoro Time.
The Location's Address property 'Address State' is missing but required by the Arcoro Time provider. This location will not be Synced. Correct the Location's data in Arcoro Time and run the Sync again.	Read (from Arcoro Time)	Only on a connector using the "Time for Payroll Configuration" configuration, and the Location's Address State is blank.	Whole Location record skipped.	Enter an Address State value on the Location in Arcoro Time.
The Location property 'Address State' could not be parsed to a valid 2 character State or Province code. A valid value is required by the Arcoro Time provider. This location will not be Synced. Correct the Location's data in Arcoro Time and run the Sync again.	Read (from Arcoro Time)	Only on a connector using the "Time for Payroll Configuration" configuration, an Address exists on the Location, and the Address State value does not parse to a valid 2 character state or province code. This includes a blank state, so it can appear alongside the missing-state message above for the same record.	Whole Location record skipped.	Enter a valid 2 character state or province code on the Location's Address State in Arcoro Time.
The Location's Address property 'Address Zip' is missing but required by the Arcoro Time provider. This location will not be Synced. Correct the Location's data in Arcoro Time and run the Sync again.	Read (from Arcoro Time)	Only on a connector using the "Time for Payroll Configuration" configuration, and the Location's Address Zip is blank.	Whole Location record skipped.	Enter an Address Zip value on the Location in Arcoro Time.
A Location with Name: '[Location Name]' has already been read. This field must be unique and the record will not be Synced. Modify the data in Arcoro Time to make each record have a unique Name and execute the Sync again.	Read (from Arcoro Time)	On every connector, when another Location with the same Name (matched without regard to upper or lower case) was already read earlier in the same sync run. This is a check against other Locations in the same run, not against anything already in Arcoro.	Whole Location record skipped. Whichever copy of the Location was read first in the run is kept; later copies with the same Name are the ones skipped.	Rename one of the duplicate Locations in Arcoro Time so each Location Name is unique.
An Equipment with Name: '[Equipment Name]' has already been read. This field must be unique and the record will not be Synced. Modify the data in Arcoro Time to make each record have a unique Name and execute the Sync again.	Read (from Arcoro Time)	On every connector, when another Equipment record with the same Name (matched without regard to upper or lower case) was already read earlier in the same sync run.	Whole Equipment record skipped. Whichever copy was read first in the run is kept.	Rename one of the duplicate Equipment records in Arcoro Time so each Equipment Name is unique.
A Cost Code with ID: '[Cost Code Id]' does not have a Name. This field is required and the record will not be Synced. Modify the data in Arcoro Time to make each record have a unique Name and execute the Sync again.	Read (from Arcoro Time)	On every connector, when a Cost Code's Name is blank. A Cost Code of the punch-clock "Time Stamp" type never reaches this check at all, it is left out of the read silently and does not count toward the sync's totals. Note: despite the wording, there is no duplicate-name check for Cost Codes, only this required-Name check.	Whole Cost Code record skipped.	Enter a Name on the Cost Code in Arcoro Time.
A Department was sent from the source system without the required Code property. This record will not be processed. Correct the data in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the source system sent no Department Code and no internal record ID to fall back on.	Whole Department record skipped.	Enter a Code on the Department in the source system.
The Department Code '[Department Code]' exceeds the maximum length of [50] characters supported by Arcoro Time. This record will not be processed. Correct the data in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the Department Code is longer than 50 characters.	Whole Department record skipped.	Shorten the Department Code in the source system to 50 characters or fewer.
A Department was sent from the source system without the required Description property. This record will not be processed. Correct the data in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the Department's Description is blank.	Whole Department record skipped.	Enter a Description on the Department in the source system.
The Department Description '[Department Description]' exceeds the maximum length of [50] characters supported by Arcoro Time. This record will not be processed. Shorten the Description in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the Department Description is longer than 50 characters.	Whole Department record skipped.	Shorten the Department Description in the source system to 50 characters or fewer.
A Cost Type was sent from the source system without an Identifier or a Name. Arcoro Time requires a Name, so this record will not be processed. Correct the data in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the source sent neither a code (Identifier) nor a description (Name) for the Cost Type.	Whole Cost Type record skipped.	Enter a code or a description for the Cost Type in the source system.
The Cost Type Name '[combined code and description]' exceeds the maximum length of [100] characters supported by Arcoro Time. This record will not be processed. Shorten the Identifier or the Name in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates. Arcoro Time stores one text field for a Cost Type, built by joining the source's code and description together as "code - description". This message fires when that combined value is longer than 100 characters, not when either part alone is too long.	Whole Cost Type record skipped.	Shorten the Cost Type's code, its description, or both in the source system so the combined "code - description" value is 100 characters or fewer.
An Equipment was sent from the source system without the required Code property. This record will not be processed. Correct the data in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the source sent no Equipment Code and no internal record ID to fall back on.	Whole Equipment record skipped.	Enter a Code on the Equipment in the source system.
The Equipment Code '[Equipment Code]' exceeds the maximum length of [50] characters supported by Arcoro Time. This record will not be processed. Shorten the Code in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the Equipment Code is longer than 50 characters.	Whole Equipment record skipped.	Shorten the Equipment Code in the source system to 50 characters or fewer.
The Equipment with Code '[Equipment Code]' was sent from the source system without the required Name property. This record will not be processed. Correct the data in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the Equipment's Name is blank once invisible characters are stripped out.	Whole Equipment record skipped.	Enter a Name on the Equipment in the source system.
The Equipment Name '[Equipment Name]' exceeds the maximum length of [100] characters supported by Arcoro Time. This record will not be processed. Shorten the Name in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the Equipment Name is longer than 100 characters.	Whole Equipment record skipped.	Shorten the Equipment Name in the source system to 100 characters or fewer.
The Equipment Type '[combined code and description]' assigned to Equipment '[Equipment Name]' was not found as an active Equipment Type in Arcoro Time. This record will not be processed so that it is not assigned to the wrong Equipment Type. Sync Equipment Types first, or activate the Equipment Type in Arcoro Time, and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, only when the source supplied an Equipment Type for this Equipment. The combined "code - description" value for that Equipment Type must match an active Equipment Type already in Arcoro Time at the moment this sync's Equipment step runs. Equipment written with no Equipment Type at all never triggers this message.	Whole Equipment record skipped. The Equipment Type assignment is left alone rather than risk attaching the wrong one.	Make sure Equipment Types sync before Equipment in the same run, and that the matching Equipment Type is Active in Arcoro Time, then run the sync again.
An Equipment Type was sent from the source system without a Value or a Label, so it has nothing to be identified by in Arcoro Time. This record will not be processed. Correct the data in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates, when the source sent neither a code (Value) nor a description (Label) for the Equipment Type.	Whole Equipment Type record skipped.	Enter a code or a description for the Equipment Type in the source system.
The Equipment Type '[combined code and description]' exceeds the maximum length of [200] characters supported by Arcoro Time. This record will not be processed. Shorten the value in the source system and execute the Sync again.	Write (to Arcoro Time)	On every sync, both creates and updates. Arcoro Time stores one text field for an Equipment Type, built by joining the source's code and description together as "code - description". This message fires when that combined value is longer than 200 characters.	Whole Equipment Type record skipped.	Shorten the Equipment Type's code, its description, or both in the source system so the combined "code - description" value is 200 characters or fewer.

Confirming the Error

Open the Sync History screen for the run in question.
For a Location address or duplicate-name message, open the Locations entity row and check its Errors column.
For an Equipment duplicate-name, required-field, length, or Equipment Type message, open the Equipment entity row.
For a Cost Code required-Name message, open the Cost Codes entity row.
For a Department required-field or length message, open the Departments entity row.
For a Cost Type required-field or length message, open the Cost Types entity row.
For an Equipment Type required-field or length message, open the Equipment Types entity row.
Match the message in the log against the fixed part of the sentence in this article, ignoring the quoted values in single quotes, since those hold your own data.
Confirm the affected record shows under that entity's Errors count, and that Added, Updated, and Unchanged do not include it, since a record that fails one of these checks is never added, updated, or left unchanged; it is skipped outright.

Resolving the Error

Locations

These five address messages only appear on a connector using the "Time for Payroll Configuration" configuration. If your connector uses a different configuration, these messages cannot occur, look elsewhere for the reported issue.
In Arcoro Time, open the flagged Location and check its Address fields: Address Line 1, City, State, and Zip.
Fill in any blank address field the message calls out.
If the message names the State field as invalid rather than missing, enter a valid 2 character state or province code, for example CA or ON.
A single Location can show more than one of these five messages at once if it is missing more than one address field, that is expected and each one should be corrected.
For the duplicate-name message, open Arcoro Time and rename one of the Locations sharing that Name so the Name is unique across all Locations.
Run the sync again and confirm the Location no longer appears under the Locations entity's Errors count.

Cost Codes

In Arcoro Time, open the Cost Code identified by its ID in the message and enter a Name.
A Cost Code of the punch-clock "Time Stamp" type is never read at all and cannot produce this message; it is excluded by design rather than in error.
Run the sync again and confirm the Cost Code no longer appears under the Cost Codes entity's Errors count.

Departments

In the source system, open the flagged Department and enter or shorten its Code as the message directs. The Code cannot exceed 50 characters.
Enter or shorten the Department's Description as the message directs. The Description cannot exceed 50 characters either.
Run the sync again and confirm the Department no longer appears under the Departments entity's Errors count.

Cost Types

Arcoro Time stores a Cost Type as a single field that combines the source's code and description, joined as "code - description". Whichever part the source is missing should be added; at least one of the two must be present.
If the length message appears, shorten the code, the description, or both in the source system. It is the combined "code - description" value that must fit in 100 characters, not each part on its own.
Run the sync again and confirm the Cost Type no longer appears under the Cost Types entity's Errors count.

Equipment and Equipment Types

In the source system, open the flagged Equipment and enter or shorten its Code (limit 50 characters).
Enter or shorten the Equipment's Name (limit 100 characters).
For an Equipment Type required-field or length message, the same "code - description" combined value applies as with Cost Types, but the limit for Equipment Type is 200 characters, not 100.
For the "not found as an active Equipment Type" message, first confirm the Equipment Type has synced to Arcoro Time in this run or an earlier one, Equipment Types must sync before Equipment in the same run. If it has not, run the sync again after Equipment Types complete, or run Equipment Types on its own first.
If the Equipment Type exists in Arcoro Time but is Inactive, activate it, an inactive Equipment Type cannot be assigned to Equipment.
If you renamed an Equipment Type or a Cost Type at the source, be aware that Arcoro Time will create a brand new Cost Type or Equipment Type record for the new name rather than renaming the existing one, the old record is left behind, still Active, under its old name. This is expected behavior and if you want the old record cleaned up, that has to be done manually in Arcoro Time.
Run the sync again and confirm the Equipment and Equipment Type no longer appear under their entities' Errors counts.

When to Escalate

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

The message text in the sync log does not match any row in this article's table.
You have corrected the data as directed, run the sync again, and the same message still appears for the same record.
A record shows as Added or Updated in the sync log, but the value never appeared in Arcoro Time.
The Equipment Type or Cost Type appears duplicated for reasons other than a rename at the source, or you need the orphaned old record removed from Arcoro Time.
More than a handful of records across multiple entities are failing at once, which can point to a source system data problem broader than this article covers.

Module Navigation