Zum Hauptinhalt springen

Harvest

Verfügbar

Diese Integration ist in Frihet aktiv und einsatzbereit.

Verbinden Sie Harvest mit Frihet. Importieren Sie Zeiterfassungen und wandeln Sie Arbeitsstunden automatisch in Rechnungszeilen um. Definieren Sie Tarife pro Kunde oder Projekt und stellen Sie direkt von Ihrem ERP aus Rechnungen.

Wofür ist es gut?​

Mit integriertem Harvest:

  • Zeiterfassungen importieren — Bringen Sie Ihre in Harvest erfassten Stunden nach Frihet
  • Rechnungen aus Stunden erstellen — Wandeln Sie Zeit in Rechnungen mit konfigurierbaren Tarifen um
  • Projekte und Kunden — Gruppieren Sie Stunden pro Projekt für detaillierte Rechnungen
  • Benutzerdefinierte Tarife — Definieren Sie Preis/Stunde pro Kunde oder Projekt
  • Keine Duplikate — Bereits importierte Stunden werden nicht erneut importiert

Voraussetzungen​

  • Aktives Harvest-Konto — getharvest.com
  • Personal Access Token — Wird in den Harvest-Einstellungen generiert
  • Account ID — Wird zusammen mit dem Token abgerufen
  • Frihet Pro oder höher

Harvest mit Frihet verbinden​

Schritt 1: Persönlichen Zugriffstoken abrufen​

  1. Gehen Sie zu id.getharvest.com/developers
  2. Melden Sie sich mit Ihrem Harvest-Konto an
  3. Klicken Sie auf Create New Personal Access Token
  4. Geben Sie einen Namen ein (z.B. "Frihet ERP")
  5. Klicken Sie auf Create Personal Access Token
  6. Sie sehen zwei Datenpunkte:
    • Token — Ihr Zugriffsschlüssel (z.B. 123456.pt.abcdefg...)
    • Account ID — Die numerische Kennung Ihres Kontos (z.B. 987654)
  7. Kopieren Sie beide Werte
Beide Werte speichern

Der Token wird nur einmal angezeigt. Die Account ID können Sie später einsehen, aber kopieren Sie jetzt beide.

Schritt 2: In Frihet konfigurieren​

  1. Gehen Sie zu Einstellungen → Integrationen
  2. Suchen Sie nach Harvest
  3. Klicken Sie auf Verbinden
  4. Geben Sie Ihren Personal Access Token ein
  5. Geben Sie Ihre Account ID ein
  6. Klicken Sie auf Verbindung überprüfen
  7. Wenn alles korrekt ist, sehen Sie den Namen Ihres Unternehmens in Harvest

Schritt 3: Verbindung überprüfen​

  1. Frihet zeigt eine Zusammenfassung an:
    • Name des Unternehmens in Harvest
    • Anzahl der aktiven Projekte
    • Zuletzt erfasste Stunden
  2. Sie können einen Testimport durchführen

So funktioniert's​

Frihet verwendet die Harvest API v2 mit zwei Authentifizierungsheadern:

Authorization: Bearer <token>
Harvest-Account-Id: <account-id>
  1. Sie geben Ihren Personal Access Token und Ihre Account ID an
  2. Frihet sendet beide in den Headern jeder Anfrage
  3. Zeiterfassungen werden bei Bedarf oder regelmäßig importiert
  4. Jeder Eintrag enthält Projekt, Aufgabe, Kunde und Stunden
  5. Die Zugangsdaten werden verschlüsselt (AES-256-GCM) in Frihet gespeichert

Synchronisierte Daten​

DatenpunktRichtungHäufigkeit
ZeiterfassungenHarvest → FrihetBei Bedarf / regelmäßig
ProjekteHarvest → FrihetBei Bedarf
Harvest-KundenHarvest → FrihetBei Bedarf
AufgabenHarvest → FrihetMit jeder Erfassung

Beispiel: Stunden in Rechnung umwandeln​

In Harvest​

Projekt: Web-Redesign - KundeXYZ
  Mo 3 Feb: 4h — Wireframe-Design
  Di 4 Feb: 3h — Responsive Layout-Gestaltung
  Do 6 Feb: 5h — Frontend-Entwicklung
  Gesamt: 12 Stunden

In Frihet (nach dem Import)​

Rechnung #1047 - KundeXYZ
Konzept: Web-Redesign

  Wireframe-Design:           4h × 75 EUR = 300,00 EUR
  Responsive Layout-Gestaltung:   3h × 75 EUR = 225,00 EUR
  Frontend-Entwicklung:           5h × 75 EUR = 375,00 EUR

Gesamt: 900,00 EUR

Benutzerdefinierte Tarife​

Standardtarif​

Bei der Konfiguration der Integration definieren Sie einen Basistarif (z.B. 60 EUR/h). Alle Importe verwenden diesen Standardtarif.

Tarif pro Kunde​

  1. Gehen Sie zu Kunden → öffnen Sie den Kunden
  2. Geben Sie unter "Harvest-Tarif" den spezifischen Tarif ein (z.B. 80 EUR/h)
  3. Die nächsten Importe für diesen Kunden verwenden diesen Tarif

In der Rechnung bearbeiten​

Nach dem Import befindet sich die Rechnung im Status Entwurf. Sie können:

  • Den Stundentarif jeder Zeile ändern
  • Zeilen hinzufügen oder entfernen
  • Das Konzept anpassen
  • Bestätigen, wenn bereit

Zeiterfassungen importieren​

Frihet kann Ihre Zeiterfassungen automatisch in Rechnungszeilen umwandeln:

  1. Verbinden Sie Ihr Harvest-Konto
  2. Gehen Sie zum Reiter Daten der Integration
  3. Klicken Sie auf Zeiterfassungen importieren
  4. Geben Sie Ihren Stundentarif ein
  5. Frihet gruppiert die Einträge nach Projekt und erstellt einen Rechnungsentwurf

Harvest-Einträge enthalten direkt den Projektnamen und die Aufgabe, sodass jede Rechnungszeile die erledigte Aufgabe widerspiegelt.

Anwendungsfälle​

Entwicklungsagentur​

Ihr Team erfasst Stunden in Harvest pro Projekt und Aufgabe. Am Monatsende importieren Sie die Stunden in Frihet und erstellen detaillierte Rechnungen für jeden Kunden mit Aufgabenaufschlüsselung.

Unabhängiger Berater​

Sie erfassen Ihre Beratungsstunden in Harvest. Wöchentlich oder monatlich importieren Sie nach Frihet und erstellen Rechnungen pro Kunde. Jede Rechnung zeigt die genaue Aufschlüsselung dessen, was Sie getan haben und wie viel Zeit Sie dafür aufgewendet haben.

Projektbasierte Abrechnung​

Sie haben ein großes Projekt mit einem festen Budget. Sie verwenden Harvest, um die tatsächlichen Stunden zu verfolgen, und Frihet, um Projektmeilensteine abzurechnen. Die importierten Stunden geben Ihnen Einblick in die Rentabilität.

Fehlerbehebung​

"Authentifizierungsfehler"​

  • Überprüfen Sie, ob der Personal Access Token korrekt ist
  • Stellen Sie sicher, dass die Account ID Ihrem aktiven Konto entspricht
  • Wenn Sie den Token neu generiert haben, aktualisieren Sie ihn in Frihet

"Ich sehe meine Zeiterfassungen nicht"​

  • Überprüfen Sie, ob Sie Stunden in Harvest erfasst haben (keine Entwürfe)
  • Stellen Sie sicher, dass Sie den richtigen Datumsbereich auswählen
  • Die Zeiteinträge müssen einem Projekt zugewiesen sein

"Die Tarife sind nicht korrekt"​

  • Überprüfen Sie den Standardtarif unter Einstellungen → Harvest
  • Prüfen Sie, ob der Kunde einen benutzerdefinierten Tarif konfiguriert hat
  • Sie können den Tarif direkt im Rechnungsentwurf bearbeiten, bevor Sie ihn bestätigen

"Ich möchte die Account ID ändern"​

  1. Gehen Sie zu Einstellungen → Integrationen → Harvest
  2. Klicken Sie auf Trennen
  3. Verbinden Sie sich erneut mit der neuen Account ID und dem Token

Nächste Schritte​