Intégration Harvest n8nAutomatiser Harvest avec n8n.

La fiche client est créée dans Harvest et l'opération renvoie son identifiant, que la suite du workflow réutilise pour y rattacher des contacts, des projets ou des factures.

• Account Name or ID : le compte Harvest qui héberge le client, choisi dans la liste chargée par le credential.
• Name : le nom du client, seule information vraiment obligatoire.
• Currency : fixe la devise du client, que les devis créés ensuite reprennent quand ils laissent le champ vide.
• Address : l'adresse en texte, avec retours à la ligne autorisés pour le bloc imprimé sur les documents.

Supprimer, c'est retirer la fiche du compte : le nœud envoie l'ordre pour l'identifiant que tu lui passes, et le client disparaît.

• Client ID : l'identifiant du client à supprimer, souvent {{ $json.id }} repris du nœud qui vient de le lister ou de le créer.
• Account Name or ID : le compte concerné, un identifiant n'ayant de sens que dans un compte donné.

Un identifiant en entrée, la fiche complète en sortie : nom, adresse, devise et statut actif, lisibles par les nœuds suivants.

• Client ID : l'identifiant du client à récupérer, et pas son nom, que l'API n'accepte pas ici.
• Account Name or ID : le compte Harvest interrogé.

C'est l'opération qui lit tout le carnet de clients, et Return All change complètement son comportement : activé, n8n enchaîne les pages de l'API et ramène tout ; désactivé, il s'arrête au nombre fixé par Limit.

• Return All : coché pour un export complet, décoché quand un aperçu suffit.
• Limit : le nombre maximal de clients renvoyés quand Return All reste décoché.
• Is Active : true ne remonte que les clients actifs, false les archivés.
• Updated Since : ne garde que les fiches modifiées après une date et une heure, ce qui transforme l'export complet en synchronisation incrémentale.

Rien ne bouge en dehors de ce que tu places dans Update Fields : les champs laissés vides gardent leur valeur actuelle.

• Client ID : l'identifiant du client à modifier, pivot de l'opération.
• Is Active : false archive le client au lieu de le supprimer, true le réactive.
• Name : le nom du client, pour un changement de marque ou de raison sociale.
• Address : l'adresse postale, retours à la ligne compris.

Aucun identifiant à chercher. L'opération renvoie la société Harvest derrière le credential, ce qui en fait le moyen le plus rapide de vérifier que la connexion fonctionne et qu'elle vise le bon compte.

• Account Name or ID : le seul champ à remplir, et celui qui décide de la société lue quand l'identifiant couvre plusieurs comptes.

Chez Harvest, un contact appartient toujours à un client : l'opération rattache donc la personne à une fiche société déjà existante.

• First Name : obligatoire, même si le reste de l'identité arrive plus tard.
• Client ID : l'identifiant du client auquel ce contact appartient, en général {{ $json.id }} repris du client créé juste avant.
• Email : l'adresse du contact, le champ qui compte dès qu'un document doit lui être envoyé.
• Title : la fonction de la personne, utile quand plusieurs interlocuteurs partagent un même client.

Quand une personne quitte l'entreprise du client, cette opération la retire du compte sans toucher à la fiche client elle-même.

• Contact ID : l'identifiant du contact à supprimer, que fournit en général une étape de liste.
• Account Name or ID : le compte où vit ce contact.

Lire un seul contact coûte un appel et évite de charger toute la liste pour récupérer une adresse et une fonction.

• Contact ID : l'identifiant du contact à récupérer.
• Account Name or ID : le compte Harvest interrogé.

La liste revient page par page, et les deux filtres décident de la quantité que le workflow devra lire.

• Return All : activé, toutes les pages sont récupérées ; désactivé, l'exécution s'arrête à Limit.
• Limit : le plafond de contacts renvoyés quand Return All est décoché.
• Updated Since : limite la réponse aux fiches modifiées après une date et une heure.
• Is Active : garde les fiches actives, ou renvoie les inactives quand il est à false.

Les coordonnées bougent plus vite que la personne elle-même, et Update Fields ne transporte que ce qui a changé.

• Contact ID : désigne la fiche à modifier.
• Client ID : déplace le contact vers un autre client, pour quelqu'un qui a changé d'entreprise.
• Email : la nouvelle adresse, dans la forme name@email.com attendue par le champ.
• Phone Office et Phone Mobile : deux numéros stockés séparément, modifier l'un laisse l'autre intact.

Le devis naît rattaché à un client, et Harvest le numérote tout seul tant que le workflow ne lui impose pas de numéro.

• Client ID : l'identifiant du client auquel ce devis appartient, seul contenu obligatoire en plus du compte.
• Subject : l'objet du devis, la ligne que le client lit en premier.
• Number : laissé vide, le numéro est généré automatiquement ; rempli, il suit ta propre numérotation.
• Tax : un pourcentage appliqué au sous-total, écrit 10.0 pour dix pour cent.
• Issue Date : la date du jour par défaut si le workflow ne la précise pas.

Le ménage dans les brouillons est la raison la plus courante d'appeler celle-ci : le devis correspondant à l'identifiant quitte le compte.

• Estimate ID : l'identifiant du devis à supprimer, issu d'une étape de liste ou de la création qui l'a produit.
• Account Name or ID : le compte auquel appartient le devis.

Avant d'envoyer quoi que ce soit au client, relire le devis donne son état, ses montants et son objet tels que Harvest les stocke.

• Estimate ID : l'identifiant du devis à récupérer.
• Account Name or ID : le compte Harvest qui le contient.

Le filtre State fait tout le travail ici : la requête ne vise que les devis dans la situation qui t'intéresse.

• State : draft, sent, accepted ou declined, une valeur par requête.
• From et To : bornent la période lue.
• Client ID : restreint la réponse à un seul client.
• Return All : activé pour parcourir toutes les pages, désactivé pour s'arrêter à Limit.
• Page : le numéro de page dans la pagination, qui commence à 1, pour avancer manuellement dans une longue liste.

Entre le premier chiffrage et la signature, les montants bougent ; l'opération ne réécrit que ce que le workflow lui fournit.

• Invoice ID : c'est le libellé utilisé par le nœud pour l'identifiant du document à mettre à jour, la valeur à passer reste donc l'identifiant du devis renvoyé par la création ou la liste.
• Discount : un pourcentage retranché du sous-total, 10.0 pour dix pour cent.
• Notes : les notes complémentaires imprimées sur le devis.
• Purchase Order : le numéro de bon de commande que le client veut voir apparaître.

Quatre champs sont obligatoires, parce que Harvest impute toujours une dépense à un projet, à une catégorie et à une date.

• Project ID : le projet sur lequel la dépense est imputée.
• Expense Category ID : la catégorie de rattachement, un identifiant et non un libellé.
• Spent Date : la date à laquelle la dépense a eu lieu, pas celle où le workflow tourne.
• Total Cost : le montant total, ou Units quand le coût se calcule à partir d'une quantité.
• Billable : true par défaut, une dépense interne doit donc le passer explicitement à false.

Les doublons de reçus sont le cas typique : deux imports du même relevé, une ligne en trop, et cette opération la retire.

• Expense ID : l'identifiant de la dépense à supprimer.
• Account Name or ID : le compte dans lequel elle a été enregistrée.

Relire une dépense renvoie son montant, son projet, sa catégorie et son caractère facturable, soit exactement ce qu'une étape de validation a besoin de savoir.

• Expense ID : l'identifiant de la dépense à récupérer.
• Account Name or ID : le compte Harvest à lire.

Huit filtres, c'est la requête la plus large de la ressource, et les combiner est ce qui garde l'exécution courte.

• Is Billed : false liste ce qui n'a pas encore été facturé, true ce qui l'a déjà été.
• Project ID et Client ID : limitent la réponse à un projet ou à un client.
• From et To : la période couverte.
• User ID : la personne qui a saisi les dépenses.
• Return All : activé pour collecter toutes les pages, désactivé pour plafonner avec Limit.

La correction arrive presque toujours après coup, le jour où quelqu'un s'aperçoit que le projet n'était pas le bon.

• Invoice ID : le libellé donné par le nœud à l'identifiant de la fiche à modifier, c'est donc l'identifiant de la dépense qui se place ici.
• Project ID : réimpute la dépense sur un autre projet.
• Expense Category ID : change la catégorie de rattachement.
• Billable : bascule un coût entre facturable et interne.
• Spent Date : rectifie une date saisie de travers.

L'opération crée une facture dans Harvest pour un client donné et renvoie la fiche créée, identifiant compris, que les nœuds suivants réutilisent.

• Account Name or ID : le compte Harvest à facturer, choisi dans la liste ou passé par une expression, la syntaxe n8n qui va chercher un champ de l'élément entrant.
• Client ID : le client auquel la facture est rattachée.
• Number : laissé vide dans Additional Fields, Harvest attribue lui-même le numéro.
• Payment Term : upon receipt, net 15, net 30, net 45 ou net 60.

La suppression est définitive côté Harvest. Cette opération se place donc en bout de branche, derrière une condition qui vérifie que la facture est bien celle qu'on veut perdre.

• Invoice ID : la facture à supprimer, le plus souvent {{ $json.id }} récupéré par un Get Many placé avant.
• Account Name or ID : le compte qui héberge la facture, un identifiant d'un autre compte ne sera pas reconnu.

Une facture, un appel. Le nœud lit une seule facture et transmet sa fiche complète au reste du workflow.

• Invoice ID : la facture à lire, généralement stockée dans le CRM ou portée par l'élément qui a démarré l'exécution.
• Account Name or ID : le compte Harvest interrogé.

C'est l'opération qui alimente tous les reportings de facturation : elle liste les factures et sort un élément par facture.

• Return All : coché, n8n enchaîne les pages de l'API Harvest jusqu'à la dernière facture ; décoché, Limit fixe le nombre d'items renvoyés.
• State : le filtre qui ne garde que les factures draft, open, paid ou closed.
• From et To : bornent la période ; Updated Since limite l'exécution à ce qui a bougé depuis la dernière.

Une facture déjà émise reste modifiable. Le nœud applique les changements et renvoie la version à jour.

• Invoice ID : la facture concernée. Tout le reste passe par Update Fields, donc seuls les champs remplis sont touchés.
• Due Date : repousse l'échéance ; non renseignée, Harvest conserve la date calculée depuis la date d'émission.
• Subject et Notes : le texte que le client lit sur le document.
• Tax et Tax2 : des pourcentages appliqués au sous-total, écrits 10.0 pour dix pour cent.

Les temps saisis se rattachent à un projet. Créer le projet est donc la première étape de presque tous les workflows d'ouverture de mission.

• Name et Client ID : le nom du projet et le client auquel il appartient.
• Is Billable : indique si les heures pointées dessus peuvent finir sur une facture.
• Bill By : none, People, Project ou Tasks, la méthode de facturation retenue par Harvest.
• Budget By : l'email de l'utilisateur, ou la valeur none.

Supprimer un projet, c'est la version radicale de l'archivage. À réserver aux projets qui n'ont rien à faire dans Harvest.

• Project ID : le projet à supprimer.
• Account Name or ID : le compte qui le contient.

Lire un projet donne au workflow ses réglages, du client rattaché jusqu'aux champs de budget, avant toute autre action.

• Project ID : le projet à lire, souvent {{ $json.projectId }} issu d'un temps traité plus haut.
• Account Name or ID : le compte Harvest interrogé.

Récupère la liste des projets d'un coup, chaque projet ressortant comme un élément distinct à parcourir en boucle.

• Return All : coché, tous les projets remontent page après page ; décoché, Limit décide du volume.
• Is Active : vrai pour les projets en cours, faux pour les archivés.
• Client ID : restreint la liste à un seul client.
• Updated Since : ne garde que les projets modifiés après la date fournie.

Un budget se renégocie, un taux horaire évolue. Cette opération applique ces changements à un projet existant.

• Project ID : le projet à modifier ; les champs laissés vides dans Update Fields restent en l'état.
• Budget et Budget Is Monthly : l'enveloppe en heures, et le fait qu'elle reparte à zéro chaque mois.
• Hourly Rate : le taux utilisé quand le projet est facturé au taux horaire projet.
• Is Active : à faux, le projet est archivé au lieu d'être supprimé.

Dans Harvest, une tâche est le libellé d'activité qu'on choisit en pointant son temps, du type conception ou support. Le nœud en ajoute une au compte.

• Name : le seul champ requis en plus du compte, la configuration tient en deux lignes.
• Default Hourly Rate : le taux appliqué quand la tâche est ajoutée à un projet, 0 tant qu'on ne le fixe pas.
• Is Default : activé, la tâche est ajoutée automatiquement aux futurs projets.
• Billable By Default : détermine si les heures pointées dessus sont facturables.

Harvest retire la tâche du compte, donc aussi de la liste déroulante que les équipes voient au moment de pointer.

• Task ID : la tâche à supprimer.
• Account Name or ID : le compte concerné.

Sert à vérifier ce que recouvre vraiment un identifiant de tâche avant qu'un autre nœud n'écrive quoi que ce soit.

• Task ID : la tâche à lire.
• Account Name or ID : le compte interrogé.

La liste des tâches reste courte dans la plupart des comptes, ce qui en fait une bonne source pour les listes déroulantes construites ailleurs.

• Return All : coché, le nœud ramène la liste entière ; décoché, Limit l'arrête plus tôt.
• Is Active : vrai pour les tâches encore proposées, faux pour les archivées.
• Page : permet d'avancer page par page quand Return All reste décoché.

Renommer une tâche ou changer son tarif laisse intacts tous les temps déjà pointés dessus, contrairement à une suppression.

• Task ID : la tâche à modifier.
• Name : le nouveau libellé, visible immédiatement par les personnes qui pointent.
• Default Hourly Rate : le taux dont hériteront les prochains projets.
• Is Active : à faux, la tâche est archivée sans perdre son historique.

Quand le workflow connaît déjà la durée d'une intervention, c'est cette opération qui l'inscrit dans Harvest.

• Project ID et Task ID : ce sur quoi les heures sont imputées. Les deux sont requis, prévois donc une recherche juste avant ce nœud.
• Spent Date : la date du temps passé, au format ISO 8601.
• Hours : la durée suivie.
• User ID : par défaut l'utilisateur authentifié, à renseigner quand le temps appartient à quelqu'un d'autre.

Même résultat, autre entrée : ici Harvest reçoit deux heures d'horloge et calcule lui-même la durée.

• Started Time et Ended Time : des heures du type 8:00am et 3:00pm. Laissée vide, l'heure de début prend l'heure courante.
• Spent Date : la date ISO 8601 à laquelle le temps est rattaché, qui peut différer du jour d'exécution du workflow.
• Notes : le texte libre qui explique la ligne à celui qui la relira.

Des heures pointées sur le mauvais projet coûtent plus cher qu'une absence de pointage. Le nœud retire la ligne de Harvest.

• Time Entry ID : le temps à supprimer.
• Account Name or ID : le compte où il a été saisi.

Plus étroit qu'il n'y paraît : la ligne de temps reste dans Harvest avec ses heures et ses notes, seul le lien vers la fiche externe d'origine saute.

• Time Entry ID : le temps dont on retire la référence externe.
• Account Name or ID : le compte qui contient la ligne.

Lire une ligne seule donne au workflow le détail qui se cache derrière une case d'un tableau.

• Time Entry ID : la ligne à lire.
• Account Name or ID : le compte interrogé.

Tout ce dont la facturation et le reporting ont besoin sort d'ici. Les filtres décident de la quantité d'historique embarquée.

• Return All : coché, n8n parcourt tout l'historique, ce qui peut être long sur un compte ancien ; décoché, Limit garde l'exécution courte.
• From et To : la période de temps passé.
• Is Billed : à faux, isole les heures pas encore facturées.
• Is Running : à vrai, ne remonte que les chronos en cours.
• User ID et Client ID : réduisent la liste à une personne ou à un client.

Harvest relance le chrono sur une ligne arrêtée plus tôt, au lieu d'en ouvrir une seconde pour le même travail.

• Time Entry ID : la ligne arrêtée à relancer. Harvest refuse l'appel si elle tourne déjà, teste donc son état avant d'envoyer.
• Account Name or ID : le compte où vit le chrono.

Le mouvement inverse, et celui qui sauve le plus d'heures en fin de mois : il ferme un chrono encore en train de tourner.

• Time Entry ID : le chrono à arrêter. L'appel ne fonctionne que s'il tourne, associe-le à un Get Many filtré sur Is Running.
• Account Name or ID : le compte Harvest concerné.

Les corrections passent par là plutôt que par une suppression suivie d'une nouvelle saisie : la ligne garde sa place dans la chronologie.

• Time Entry ID : la ligne à corriger.
• Hours : la durée rectifiée.
• Started Time et Ended Time : les heures d'horloge, quand la ligne a été créée depuis un début et une fin.
• Notes : l'endroit où consigner la raison de la correction.

L'opération inscrit une personne dans le compte Harvest et renvoie la fiche créée avec son identifiant, que les nœuds suivants réutilisent tel quel.

• Account Name or ID : le compte Harvest concerné, choisi dans la liste déroulante ou fourni par une expression n8n, c'est-à-dire une valeur reprise du nœud précédent, du type {{ $json.accountId }}.
• First Name, Last Name et Email : les trois champs d'identité obligatoires, l'email affichant name@email.com comme format d'exemple.
• Additional Fields : 13 options en plus, dont Is Admin, Default Hourly Rate et Weekly Capacity, comptée en secondes et calée par défaut sur 126000, soit 35 heures par semaine.

Supprimer ici veut dire supprimer pour de bon. Cette opération se place donc en toute fin de parcours de sortie, une fois la dernière facture partie.

• Account Name or ID : indique au nœud dans quel compte Harvest se trouve la personne, par la liste ou par expression.
• User ID : l'identifiant de l'utilisateur à supprimer. Harvest attend ce numéro, pas une adresse email ni un nom affiché : récupère-le à l'étape précédente avec {{ $json.id }}.

Une fiche, un identifiant : le nœud va chercher l'utilisateur demandé et transmet son profil complet à la suite du workflow, sans passer par une recherche manuelle.

• Account Name or ID : le compte Harvest interrogé, sélectionné dans le nœud ou résolu par expression.
• User ID : l'identifiant de l'utilisateur à récupérer, le plus souvent {{ $json.id }} quand la valeur vient d'une étape de liste placée plus haut.

Voilà l'étape qui donne la liste des personnes rattachées à un compte, un item par utilisateur, point de départ de tout traitement qui boucle sur l'équipe.

• Account Name or ID : le compte dont l'effectif est listé.
• Return All : coché, n8n enchaîne toutes les pages de l'API Harvest jusqu'au dernier utilisateur ; décoché, Limit fixe le nombre de fiches renvoyées.
• Filters : 3 options, Is Active pour distinguer les personnes actives des archivées, Updated Since pour ne garder que les fiches modifiées après une date, Page pour viser une page précise.

Le nœud relit le profil associé au credential lui-même, autrement dit la connexion enregistrée une fois dans n8n. C'est le test le plus rapide pour vérifier qu'un jeton d'accès ou une connexion OAuth2 atteint bien Harvest.

• Account Name or ID : le seul champ à remplir, et il sert au passage à confirmer que la connexion voit bien ce compte.

Modifier plutôt que recréer : cette opération ajuste ce que Harvest garde sur une personne déjà présente, sans produire une deuxième fiche pour le même collaborateur.

• Account Name or ID : le compte qui héberge la fiche à corriger.
• Time Entry ID : c'est le libellé que le nœud donne à l'identifiant obligatoire de cette opération, sa description indiquant « The ID of the time entry to update ».
• Update Fields : 16 champs modifiables, dont Email, First Name, Last Name, Is Active, Is Project Manager et Cost Rate.