Aller au contenu principal

Harvest

Disponible

Cette intégration est active et prête à l'emploi dans Frihet.

Connecte Harvest à Frihet. Importe les enregistrements de temps et convertit automatiquement les heures travaillées en lignes de facture. Définis des tarifs par client ou par projet et facture directement depuis ton ERP.

À quoi ça sert ?​

Avec Harvest intégré :

  • Importer des enregistrements de temps — Ramène tes heures enregistrées dans Harvest vers Frihet
  • Créer des factures à partir des heures — Convertit le temps en factures avec des tarifs configurables
  • Projets et clients — Regroupe les heures par projet pour des factures détaillées
  • Tarifs personnalisés — Définit le prix/heure par client ou par projet
  • Sans doublons — Les heures déjà importées ne sont pas ré-importées

Prérequis​

  • Compte Harvest actif — getharvest.com
  • Personal Access Token — Est généré depuis la configuration de Harvest
  • Account ID — S'obtient avec le token
  • Frihet Pro ou supérieur

Connecter Harvest avec Frihet​

Étape 1 : Obtenir ton Personal Access Token​

  1. Rends-toi sur id.getharvest.com/developers
  2. Connecte-toi avec ton compte Harvest
  3. Clique sur Create New Personal Access Token
  4. Donne-lui un nom (ex: "Frihet ERP")
  5. Clique sur Create Personal Access Token
  6. Tu verras deux données :
    • Token — Ta clé d'accès (ex: 123456.pt.abcdefg...)
    • Account ID — L'identifiant numérique de ton compte (ex: 987654)
  7. Copie les deux valeurs
Garde les deux valeurs

Le Token n'est affiché qu'une seule fois. L'Account ID peut être consulté plus tard, mais copie les deux maintenant.

Étape 2 : Configurer dans Frihet​

  1. Rends-toi sur Paramètres → Intégrations
  2. Cherche Harvest
  3. Clique sur Connecter
  4. Introduis ton Personal Access Token
  5. Introduis ton Account ID
  6. Clique sur Vérifier la connexion
  7. Si c'est correct, tu verras le nom de ton entreprise dans Harvest

Étape 3 : Vérifier la connexion​

  1. Frihet affichera un résumé :
    • Nom de l'entreprise dans Harvest
    • Nombre de projets actifs
    • Heures enregistrées récentes
  2. Tu peux faire une importation de test

Comment ça fonctionne​

Frihet utilise l'API v2 de Harvest avec deux en-têtes d'authentification :

Authorization: Bearer <token>
Harvest-Account-Id: <account-id>
  1. Tu fournis ton Personal Access Token et ton Account ID
  2. Frihet envoie les deux dans les en-têtes de chaque requête
  3. Les enregistrements de temps sont importés à la demande ou périodiquement
  4. Chaque enregistrement inclut le projet, la tâche, le client et les heures
  5. Les identifiants sont stockés chiffrés (AES-256-GCM) dans Frihet

Données synchronisées​

DonnéeDirectionFréquence
Enregistrements de tempsHarvest → FrihetÀ la demande / périodique
ProjetsHarvest → FrihetÀ la demande
Clients de HarvestHarvest → FrihetÀ la demande
TâchesHarvest → FrihetAvec chaque enregistrement

Exemple : Convertir les heures en facture​

Dans Harvest​

Projet : Refonte Web - ClientXYZ
  Lun 3 fév : 4h — Conception de wireframes
  Mar 4 fév : 3h — Maquettage responsive
  Jeu 6 fév : 5h — Développement frontend
  Total : 12 heures

Dans Frihet (après importation)​

Facture #1047 - ClientXYZ
Concept : Refonte Web

  Conception de wireframes :     4h × 75 EUR = 300,00 EUR
  Maquettage responsive :        3h × 75 EUR = 225,00 EUR
  Développement frontend :       5h × 75 EUR = 375,00 EUR

Total : 900,00 EUR

Tarifs personnalisés​

Tarif par défaut​

Lors de la configuration de l'intégration, tu définis un tarif de base (ex: 60 EUR/h). Toutes les importations utilisent ce tarif par défaut.

Tarif par client​

  1. Rends-toi sur Clients → ouvre le client
  2. Dans "Tarif Harvest", introduis le tarif spécifique (ex: 80 EUR/h)
  3. Les prochaines importations de ce client utiliseront ce tarif

Modifier sur la facture​

Après importation, la facture est en état Brouillon. Tu peux :

  • Changer le tarif horaire de n'importe quelle ligne
  • Ajouter ou supprimer des lignes
  • Ajuster le concept
  • Confirmer quand c'est prêt

Importer des enregistrements de temps​

Frihet peut convertir tes enregistrements de temps en lignes de facture automatiquement :

  1. Connecte ton compte Harvest
  2. Rends-toi sur l'onglet Données de l'intégration
  3. Clique sur Importer les enregistrements de temps
  4. Introduis ton tarif horaire
  5. Frihet regroupe les entrées par projet et crée un brouillon de facture

Les entrées de Harvest incluent directement le nom du projet et de la tâche, de sorte que chaque ligne de facture reflète la tâche réalisée.

Cas d'utilisation​

Agence de développement​

Ton équipe enregistre les heures dans Harvest par projet et par tâche. En fin de mois, tu importes les heures dans Frihet et génères des factures détaillées pour chaque client avec le récapitulatif des tâches.

Consultant indépendant​

Tu enregistres tes heures de conseil dans Harvest. Chaque semaine ou chaque mois, tu importes vers Frihet et crées des factures par client. Chaque facture montre le détail exact de ce que tu as fait et du temps que tu y as consacré.

Facturation par projet​

Tu as un grand projet avec un budget fixe. Tu utilises Harvest pour suivre les heures réelles et Frihet pour facturer les étapes du projet. Les heures importées te donnent une visibilité sur la rentabilité.

Dépannage​

"Erreur d'authentification"​

  • Vérifie que le Personal Access Token est correct
  • Vérifie que l'Account ID correspond à ton compte actif
  • Si tu as régénéré le token, mets-le à jour dans Frihet

"Je ne vois pas mes enregistrements de temps"​

  • Vérifie que tu as enregistré des heures dans Harvest (pas des brouillons)
  • Vérifie que tu sélectionnes la bonne plage de dates
  • Les entrées de temps doivent avoir un projet attribué

"Les tarifs ne sont pas corrects"​

  • Vérifie le tarif par défaut dans Paramètres → Harvest
  • Vérifie si le client a un tarif personnalisé configuré
  • Tu peux modifier le tarif directement dans le brouillon de facture avant de confirmer

"Je veux changer l'Account ID"​

  1. Rends-toi sur Paramètres → Intégrations → Harvest
  2. Clique sur Déconnecter
  3. Reconnecte-toi avec le nouvel Account ID et le nouveau token

Prochaines étapes​