How do I resolve the "Stale Object" error?

Sometimes QBO and Rutter will go out of sync, causing API requests to fail with this error:

Stale Object Error. Stale Object Error : You and XYZ were working on this at the same time. XYZ finished before you did, so your work was not saved.

This error occurs when you're trying to update an outdated version of an entity. It’s likely that someone made changes to the object directly in the QuickBooks dashboard, and you attempted to update it via Rutter before those changes were picked up in our next incremental sync.

How do I fix this issue?

To resolve this, trigger an incremental sync to pull in the latest version of the entity, then retry your update. You can trigger a full incremental sync by clicking the button on the upper right hand side of the connection dashboard (https://dashboard.rutterapi.com/connections/<connection_id>/progress), or using the Trigger Incremental Sync endpoint.

Additional Considerations

An incremental sync will initiate a full sync across all entities, not just one. We don’t recommend triggering this repeatedly, as it may lead to rate limiting.