Skip to content

Troubleshooting

The Overview page is the first stop: it shows failing projects with the error in words, the open conflicts and the unmapped users, each with a link to where it is fixed.

The OpenProject token is rejected

Symptom What it means Fix
the connection card is red, Token refused OpenProject refused the token: it is wrong, revoked, or the user was locked create a new token under My account → Access tokens and Replace token; it is tested first
No OpenProject answers at … the address is not the root of an OpenProject instance use the base URL, without /api/v3 or a project path
The address could not be reached the instance is not reachable over https from the internet, or the host is a private network address check the address; an OpenProject on a private network is not supported

An OpenProject version outside the supported range

OpenProject Sync is supported and tested on OpenProject 16.x and 17.x (the tested releases are 16.6.10 and 17.9.7; see Support). An older instance may still sync, but it is not covered by the compatibility suite. If something fails on an older version, upgrade OpenProject to a supported release first.

A project is failing

The status chip on the project's row explains the last error in words; the project's page repeats it under the activity. The common ones:

Error Cause Fix
the API token was rejected the token was revoked or expired replace the token on the connection
the user may not do this the token's user lost its role on the project, or lacks View work packages / Log time give the user the right project role
the project no longer exists the project was deleted or archived in OpenProject, or the user left it restore it or add the user again; otherwise remove the link
Exact Online is not connected the app's Exact connection in the portal was disconnected or needs re-authentication reconnect it in the portal (the gate on the app's pages links there)
the administration is not enabled the division the link points to was removed from the enabled administrations re-enable it on the connection page, or re-point the link
rate limited by OpenProject or Exact a shared budget was busy nothing to fix: the run backs off and retries on the next turn

Hours do not appear in Exact

  1. Is the project's time module on? OpenProject only returns time entries for projects with the Time and costs module enabled (Project settings → Modules). Without it the sync finds nothing to book.
  2. Who logged the time? Check People: an unmapped user's hours are skipped, not booked on someone else. Map the user (or Ignore a service account) and the next run books it. Automatic matching needs the token's project role to have View user email addresses.
  3. Is there an hour type? Without an hour type on the link, no hours are synced; set one in the link.
  4. Which day? A time entry's day is counted in the link's time zone.
  5. When was it logged? The first run takes everything from Sync time logged from; older entries are not imported. Change the date in the link's settings and press Sync now to import them (new lines are created as drafts).
  6. Is the line submitted or approved? The sync only changes lines that are Draft or Rejected. A changed entry for such a line is a conflict, not a silent overwrite.
  7. Was the line deleted in Exact? A deleted line is never re-created.

The comments do not appear in OpenProject

  • the status-comment switch is off on the link (Settings), or
  • the token's user may not comment on work packages (add the permission to the project role), or
  • nothing changed: a comment is posted when a work package's status changes, and draft-only work packages get none.

The sync feels slow

  • a first run imports the whole window in pages; it continues on later turns, the activity table shows it;
  • Sync now waits while a run is active; a project syncs within a minute of the request;
  • the schedule defaults to every 15 minutes, per project in Settings.

Still stuck?

Include in your e-mail: the organization, the project and administration, the exact message under the project's Last run, and the date. See Support.