Skip to content

Bring your data from Harvest or from any app with CSV

By Fred Wu, maker of Hourbun · Checked · Report a mistake

The short answer

Hourbun imports a Harvest account with a Personal Access Token, or the CSV files of any app. Each import checks the whole import first and shows a preview: the verdict, what comes over, the money check, what does not come over and what needs you. Nothing is added before you press Import, the import itself is all or nothing, and what the workspace has already is used or left out.

Two sources#

Settings, Import has two sources under "Import from":

  • Harvest reads a Harvest account with a Personal Access Token of a Harvest Administrator: the teammates, the clients, the projects with their budgets, the time, the expenses with their receipts, the invoices with their payments, and the estimates.
  • Another app (CSV) reads a file of time entries in the column names of any app, with files of clients, projects, expenses, invoices, invoice lines and payments beside it if you have them. A mapping step proposes a column for each field, and a people step matches each person of the file to a teammate.

The guides have the steps of each: the Harvest import, the CSV import, and a guide for each app whose own pages give a CSV export.

The check and the preview#

Before it adds anything, Hourbun runs the whole import and rolls it back. The preview then shows:

  • the verdict, ready to import or what to fix first;
  • what comes over, for each kind of record, and what is already in the workspace;
  • the money check, by currency;
  • what does not come over, and what needs you, with a CSV of the full report.

An error stops the import until you correct the record at its source and check again. A warning says what the import changes or leaves out.

What you choose#

  • An Import from date leaves the older records out; of Harvest, open and draft invoices come anyway. A later CSV import proposes the day after the newest entry of the last one.
  • Import past invoices, on by default, brings the invoices with their payments. With it off, time that the source billed comes over as billed elsewhere, so it is not billed again.

What an import never does#

  • It uses or leaves out what the workspace has already. A client of the same name and currency is used. A project of the same name takes the new entries of a CSV file, and a Harvest import leaves it out with its time. An entry of a CSV file with the teammate, the project, the task, the date, the hours and the note of an entry of the workspace is left out; an entry that you changed in Hourbun after an import no longer matches, so the Import from date keeps the old rows out.
  • It is not a sync: each import is a new read or a new upload, and Hourbun writes nothing to Harvest.
  • It invites nobody: an imported teammate is Not invited and gets no email until you invite them from Team, and an invitation then needs a free seat.
  • The import itself is all or nothing: an import that fails leaves the workspace as it was. A Harvest import then adds the estimates, the receipt files and the email history of the invoices in steps of their own, after the import. A step that fails leaves the import in place, and the page of the import says what is missing.

While an import runs, the page of the import shows its stages and its progress, also after you leave and come back, and an admin can cancel it.

Questions

Questions and answers

Can I import my Harvest data into Hourbun?

Yes. An owner or an admin pastes a Harvest Personal Access Token in Settings, Import. Hourbun brings the team, clients, projects, time, expenses, invoices with payments, and estimates, after a check and a preview.

Can Hourbun import time from Toggl, Clockify or another app?

Yes, from a CSV export of the time entries of any app. A mapping step proposes a column for each field, a people step matches each person to a teammate, and a preview shows the result before anything is added.

Does a Hourbun import add duplicates if I run it twice?

Not of what it can match. An entry of a CSV file that has the teammate, the project, the task, the date, the hours and the note of an entry of the workspace is left out, and a later CSV import proposes the day after the newest entry of the last one as its Import from date, which keeps the rows of the last import out, also an entry that you changed since.

Try Hourbun for free.

14 days, no card. Add a client, track your first hour, and send the invoice.