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¶
- 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.
- 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.
- Is there an hour type? Without an hour type on the link, no hours are synced; set one in the link.
- Which day? A time entry's day is counted in the link's time zone.
- 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).
- 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.
- 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.