Home / Apps / Harvest Two-Way Sync / FAQ

Harvest Two-Way Sync

Frequently asked questions

Getting started

What does Harvest Two-Way Sync do?

It adds a time tracking panel to every Jira issue and a sync page to the Jira Apps menu. From the panel you start Harvest timers and log time; the entry is created in Harvest and a worklog is written to the Jira issue. On the sync page you transfer entries that were booked directly in Harvest and apply later changes and deletions.

What do I need to use it?

A Jira Cloud site with the app installed, and a Harvest account with at least one active project assignment that has tasks.

Does every team member need their own Harvest account?

Yes. Each Jira user connects their own Harvest login, and the app only ever processes that person's own time entries.

Do I have to create or paste an API token?

No. You connect through Harvest's OAuth sign-in. The app never asks for a password or a token.

Does an administrator have to configure anything after installing?

No. There is no central configuration. Every user who can access the Jira site can open the panel and connect their Harvest account.

Where do I find the app in Jira?

The panel is called "Harvest Two-Way Sync" and sits in the details area of every issue. The sync page is under Apps → Harvest Two-Way Sync.

Which languages are supported?

English and German. The interface follows your Jira language until you choose one in the settings.

Does it work with Jira Data Center or Jira Server?

No. The app is built on Atlassian Forge and runs on Jira Cloud only.

My Harvest login has access to several Harvest accounts. Which one is used?

The first Harvest account that your login returns. Forecast accounts are ignored. If you need a different account, contact support.

Booking time

How do I start a timer?

Open the issue, choose a Harvest project and task in the panel and select "Start Timer". The timer runs in Harvest, so you also see it in the Harvest apps.

Can I run several timers at once?

No. Harvest runs one timer per person. If a timer is already running, the panel tells you whether it belongs to this issue or another one and lets you stop it.

Can I log time for a past day?

Yes, up to three months back. Future dates are not accepted.

In which format do I enter hours?

Either as hours and minutes, such as 0:15 or 1:30, or as a decimal, such as 1.5. A decimal comma works too.

What ends up in the Harvest note?

The first line is the issue key followed by the issue summary. If you typed a note, it follows below. In the settings you can reduce the first line to the issue key alone.

Why was my booking added to an existing entry instead of creating a new one?

If there is already an entry for the same day, project, task and issue with the same note, the app adds the time to it. That keeps your Harvest day readable.

Can I edit an entry from Jira?

Yes. Turn on "Show today's entries" in the settings; the panel then lists today's entries for the issue with an edit option. The change is saved in Harvest first and then appears in the Changes tab of the sync page, where you apply it to the Jira worklog.

Can I delete an entry from Jira?

Not from the panel. Delete the entry in Harvest; the Changes tab then offers to remove the matching Jira worklog.

Can I save my usual project and task?

Yes. Select them once and choose "Save as default".

Synchronisation

What exactly does "two-way" mean?

Time moves in both directions. A booking made on a Jira issue is written to Harvest, and an entry that exists in Harvest becomes a worklog on its Jira issue. Changes and deletions in Harvest are carried over to that worklog. Worklogs created with Jira's own "Log work" dialog are not copied to Harvest.

Does the sync run on its own?

Bookings you make in the Jira panel are written to Harvest and Jira immediately. Entries you book, change or delete directly in Harvest are transferred when you run the sync on the sync page. There is no background job.

How does the app know which Jira issue an entry belongs to?

It looks for a Jira link on the Harvest entry first, then for an issue key in the note, for example `KAN-12`. You can also assign an issue by hand on the sync page.

What happens to entries without an issue key?

They are listed as Unassigned and are never synced. Search for the Jira issue right on the entry; when you synchronize, the app writes the issue key and link into the Harvest entry.

Are running timers synced?

No. An entry is transferred once its timer has been stopped.

How far back can I sync?

Three months, counted from the booking date. Older periods cannot be selected.

What does the Jira worklog look like?

It is written under your own name, on the date of the Harvest entry, with the duration rounded to full minutes. The comment contains the issue key. The remaining estimate of the issue is left as it is.

Do my Harvest notes appear in Jira?

No. The worklog comment contains only the issue key. Your note stays in Harvest.

Can it create duplicate worklogs?

The app is built to prevent that. Every worklog it creates carries a sync marker, and each entry is locked while it is being processed. If a request times out halfway, the next run finds the existing worklog and continues from there.

The result says "recovered". What does that mean?

A previous attempt created the worklog but was interrupted before it could finish. The app found that worklog and reused it instead of creating a second one.

Can I sync my colleagues' time?

No. Everyone syncs their own entries with their own Harvest connection.

We used a different Harvest integration before. Anything to watch out for?

Yes. Worklogs created by another tool are not recognised. Their Harvest entries appear as New, and syncing them would create a second worklog. Start syncing from the day you switch.

What do the states on the sync page mean?

New: ready to sync. Synced: Harvest and Jira match. Changed: edited in Harvest after the sync. Unassigned: no issue detected, or the issue cannot be opened. Running: the timer has not been stopped. Error: Jira could not be checked for this entry.

Changes and conflicts

I changed an entry in Harvest after it was synced. What happens?

The entry is marked as Changed. The Changes tab shows what is in Jira and what is in Harvest now. Select the entry and apply it; the existing worklog is updated and no second one is created.

Which edits count as a change?

A different date, duration, note, project or task.

I deleted an entry in Harvest. Does the worklog disappear?

After you confirm it. The Changes tab lists the deletion, and applying it removes the matching Jira worklog.

Someone edited the worklog directly in Jira. What does the app do?

It reports a conflict and skips the entry. The app does not overwrite a duration that was changed by hand. Set the worklog back to the value shown under "Previously in Jira" and apply the change again.

Why are changes not applied without asking?

Updating and deleting worklogs affects reports and invoices. The app shows you each difference first and applies only what you select.

Data and security

Where is my data stored?

In Atlassian's Forge storage that belongs to your Jira site. Novari Software operates no servers of its own.

What does the app store?

Your personal settings, your default project and task, the ID of the connected Harvest account, a sync record per transferred entry (Harvest entry ID, Jira issue key, worklog ID, booking date, duration, a checksum and timestamps), and a diagnostics log of the last 24 hours. Everything is stored per Jira account.

What is sent to Harvest?

The time entries you create or edit: project, task, date, hours and the note, which includes the Jira issue key and, unless you switch it off, the issue summary. A link to the Jira issue is added to the entry.

Can Novari Software see my time entries?

No. The app has no backend of ours and sends us nothing. We only see a diagnostics file if you download it and send it to us yourself.

Where are my Harvest credentials kept?

The OAuth tokens are managed by Atlassian Forge. They are never sent to your browser and are not stored by the app itself.

Which permissions does the app request?

Read and write access to Jira work data (issues and worklogs), read access to Jira user data, the app's own storage, and Atlassian's personal data reporting. Outside Atlassian it connects only to Harvest's sign-in and API hosts.

How long is data kept?

Sync records for three months from the booking date, the diagnostics log for 24 hours. A cleanup runs every hour, also for people who never open the app again.

What happens when someone's Atlassian account is closed?

The app reports the stored account IDs to Atlassian once a week, as Atlassian requires. Everything stored for an account that has been closed is erased.

How do I disconnect completely?

Settings → "Log out completely". The guide covers both parts: disconnecting in the app and revoking the Harvest authorisation in your Atlassian account under "Connected apps".

What is in the diagnostics file?

The app's actions and errors of the last 24 hours, with credentials and tokens redacted. It is created only when you select "Download logs", and it goes nowhere unless you send it.

Licensing and billing

Who bills me?

Atlassian. The app is licensed through the Atlassian Marketplace and appears on your Atlassian invoice together with your other apps.

What happens when the license expires?

Time tracking and synchronisation pause and the app shows a notice. Your Harvest entries and Jira worklogs stay exactly as they are. A site administrator can renew the subscription on the Marketplace.

Troubleshooting

The panel says "No active Harvest project assignments with tasks were found."

Your Harvest user is not assigned to an active project with tasks. Ask a Harvest administrator to assign you.

"A Harvest timer is already running."

Harvest allows one running timer. Stop the current one in the panel or in Harvest, then start the new one.

An entry has an issue key in its note but is listed as Unassigned.

Jira could not open that issue. The key may be mistyped, the issue may have been deleted or moved, or you may not have permission to see it.

"Harvest is limiting the number of requests right now."

Harvest limits how many requests an account may send in a short time. Wait a moment and try again.

The app keeps asking me to connect.

Open your Atlassian profile under "Connected apps", revoke the Harvest entry there, then connect again from the panel.

The app shows "License not active".

The subscription for your Jira site has ended or has not been started. A site administrator can start or renew it on the Atlassian Marketplace.

How do I report a problem?

Write to support@novarisoftware.com. Add the diagnostics file (Settings → Diagnostics → Download logs) and tell us roughly when the problem occurred.