When a bill, receipt, draw, purchase order, timesheet, vendor, or job fails to sync between Adaptive and Procore, we record a sync error and show it on the Sync errors tab.
For setup and what syncs, see Procore.
1. Open the Sync errors tab
Go to Settings and click Procore.
On the Procore integration page, select the Sync errors tab.
The tab appears once Procore is connected. If your account has more than one Procore company, choose your default company first.
2. Read the list
Each row shows:
Column | What it tells you |
Error message | Why the sync failed and, in most cases, what to change |
Type | The kind of record: bill, receipt, draw, purchase order, timesheet, vendor, or job |
Ref # | The reference number on the record, so you can find it |
Date | When we last hit the error |
Two sub-tabs split the list:
Active — errors still waiting on you. This is what you see by default.
Ignored — errors you've set aside.
To narrow the list, search with Search by error message, or use Filter by error type to show one kind of record.
3. Fix an error and push the record again
Fix the underlying problem first, then push the record:
Click the resync icon on the row (Resync this object to Procore) to send that record to Procore again.
To push several at once, select the rows, open Actions, and choose Resync objects.
An error also clears on its own the next time that record syncs successfully — for example, after you edit and save the bill.
4. Set an error aside
If an error isn't worth acting on right now, click the ignore icon (Ignore this sync error). The row moves to the Ignored sub-tab.
Ignoring is not permanent. If the same record fails the same way again, we move the error back to Active so it stays in front of you. To move it back yourself, open the Ignored sub-tab and click Restore this sync error.
5. Common errors and how to clear them
"Cost code '[name]' is not mapped to a Procore cost code"
That cost code isn't mapped to Procore yet. Open the Mapping tab, map it, then resync. On a bill, you'll also see a banner reading "This bill did not sync with Procore due to missing cost code mappings." with a Resolve unmapped cost codes button that takes you straight there.
"Bill must be linked to a Purchase Order"
This bill goes to Procore as a subcontractor invoice, which needs a Procore commitment behind it. You'll see this when the bill has been linked to a purchase order with a commitment before, but isn't now. Link the bill to that purchase order again, then resync.
"The Procore commitment has no open billing period. Please create a billing period in the Procore project before syncing this bill."
Create the billing period in the Procore project, then resync.
"The Procore commitment schedule of values is not approved. Approve the SOV in Procore before syncing this bill."
Approve the SOV on that commitment in Procore, then resync.
"The Invoice Number is already in use on another invoice for this commitment in Procore. Please edit the Ref # in Adaptive or remove the conflicting invoice in Procore, then try again."
Change the Ref # on the bill in Adaptive, or remove the duplicate invoice in Procore, then resync.
FAQ
1. An error mentions retainage on a chart-of-accounts account. What do I do?
Move the retainage to a cost code. Procore tracks retainage against cost codes, so the push waits until it's coded that way.
2. I fixed the problem in Procore but the error is still listed.
Click the resync icon on the row. That pushes the record again and clears the error once it lands.
3. The tab opens but no errors load.
You need a role that can view all jobs to see the errors. Ask your Adaptive admin to check your role.
---
If you have any additional questions please reach out to us directly at [email protected].