Skip to main content

Harvest

Connection

Frihet turns Harvest hours into invoices in two ways: one click from the Data tab (current month), or from the Timesheet Billing tab under Invoices, where you pick the client, dates and rate. There is no synchronization with Harvest.

What Frihet does​

  • Stores the Harvest credentials you enter securely:
    • Personal Access Token (stored encrypted)
    • Account ID
  • Test connection — Frihet requests your user from the Harvest API (/users/me), sending the token as Authorization: Bearer and the Account ID in the Harvest-Account-Id header.
  • Import time entries (Data tab) — asks for an hourly rate, fetches the entries of the current month up to today and creates a single draft invoice with one line per project: hours summed and multiplied by the rate you entered, with the entries' tasks (or their notes when there is no task) in the description.
  • The invoice is numbered HRV-YYYY-MM-DD-YYYY-MM-DD (start and end dates of the range), with 0% VAT, a 30-day due date and no client assigned. Assign the client and review the taxes when you edit the draft.
  • If an invoice with that same number already exists, it does not create another one.
  • Timesheet Billing tab under Invoices — pick the client, the connected integration, the hourly rate and the start and end dates. Import & Preview shows the entries and the total hours, and Generate Draft Invoice opens a new invoice for that client with one line per project.
  • Running timers are not imported.

What Frihet does not do​

  • Show an account summary when you connect (company, projects or hours).
  • Import Harvest projects or clients, or create clients in Frihet.
  • Synchronize or import hours automatically or on a schedule: each import is one click on the button.
  • Pick specific projects: every entry in the range is imported. The Data tab button always uses the current month; for other dates, use the Timesheet Billing tab under Invoices.
  • Apply rates per client or per project: there is one rate, the one you type when importing.
  • Send anything to Harvest.

Requirements​

  • A Harvest account with logged hours
  • A Harvest Personal Access Token and Account ID
  • Each connected integration counts toward your plan limit: 2 on Free, 5 on Pro, unlimited on Premium.

Connect​

Step 1: get the credentials in Harvest​

  1. Go to id.getharvest.com/developers and sign in.
  2. Click Create New Personal Access Token and name it (for example, "Frihet ERP").
  3. Copy the Token and the Account ID shown.
Important

The token is shown only once. Copy it before you close the window.

Step 2: save them in Frihet​

  1. In Frihet, go to Integrations.
  2. Open Harvest.
  3. On the Connection tab, paste the Personal Access Token and the Account ID.
  4. Click Test connection to verify.
  5. If the test succeeds, click Save connection.

Import hours​

  1. Open the Data tab of the integration.
  2. Click Import time entries.
  3. Enter the hourly rate in euros.
  4. Review the resulting draft in your invoices, assign the client and adjust the VAT.

The range ends on the day you import: if you import on another day of the same month, another invoice is created that repeats the hours already included in the previous one. Review the drafts before issuing them.

Bill hours to a client​

  1. Go to Invoices and open the Timesheet Billing tab.
  2. Choose Client, Integration, Hourly rate (€/h), Start Date and End Date.
  3. Click Import & Preview.
  4. Click Generate Draft Invoice, review the invoice that opens (taxes included) and save it.

Troubleshooting​

Connection error​

Check that the token is copied correctly, that the Account ID belongs to the same account and that you have not regenerated the token. If you did, save the new one.

The import creates no invoice​

There may be no hours logged in the current month, or an invoice with the same number (same start and end date) may already exist.

Last updated on