Récolter
La récolte est un outil simple pour vous aider à suivre le temps passé par votre équipe sur chaque projet et tâche.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL |
Microsoft LogicApps Support Prise en charge de Microsoft Power Automate Prise en charge de Microsoft Power Apps |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Site internet | https://www.getharvest.com/ |
| Politique de confidentialité | https://www.getharvest.com/privacy-policy |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
| Fréquence des sondages déclencheurs | 1 | 60 secondes |
Actions
| Ajouter un nouveau client |
Créez un client. |
| Ajouter un nouveau contact |
Créez un contact. |
| Ajouter un nouvel utilisateur |
Créez un utilisateur. |
| Ajouter un utilisateur à un projet |
Ajoutez un utilisateur existant à un projet. |
| Créer une entrée de temps |
Créez une entrée de temps. |
| Entrée de l’heure de mise à jour |
Mettez à jour une entrée de temps existante. |
| Obtenir des informations utilisateur |
Récupérez les détails d’un utilisateur par ID d’utilisateur ou par e-mail. |
| Obtenir l’entrée d’heure par ID |
Obtenez une entrée de temps existante par ID. |
| Répertorier les projets |
Répertorie tous les projets de l’utilisateur actuel. |
| Répertorier les tâches |
Récupère une liste de toutes les tâches. |
| Répertorier tous les clients |
Récupère une liste de tous les clients pour le compte authentifié. |
| Répertorier tous les contacts |
Récupère une liste de tous les contacts pour l’utilisateur authentifié. |
| Supprimer l’entrée de temps |
Supprimez une entrée de temps existante. |
Ajouter un nouveau client
Créez un client.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom
|
name | True | string |
Nom du client |
|
Monnaie
|
currency | string |
Devise que vous souhaitez utiliser pour le client. |
|
|
Symbole monétaire
|
currency_symbol | string |
Symbole qui correspond à la devise sélectionnée. |
|
|
Détails
|
details | string |
Détails supplémentaires, normalement utilisés pour les informations d’adresse. |
Ajouter un nouveau contact
Créez un contact.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID client
|
client_id | True | integer |
Identificateur unique du client. |
|
Prénom
|
first_name | True | string |
Prénom du contact. |
|
Nom
|
last_name | True | string |
Nom du contact. |
|
Messagerie électronique
|
string |
E-mail du contact. |
||
|
Téléphone de bureau
|
phone_office | string |
Téléphone du bureau du contact. |
|
|
Téléphone portable
|
phone_mobile | string |
Téléphone mobile du contact. |
|
|
Télécopie
|
fax | string |
Télécopie du contact. |
|
|
Titre
|
title | string |
Titre du contact. |
Ajouter un nouvel utilisateur
Créez un utilisateur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Messagerie électronique
|
True | string | ||
|
Est administrateur
|
is_admin | boolean | ||
|
Prénom
|
first_name | True | string | |
|
Nom
|
last_name | True | string | |
|
Est-ce que l’entrepreneur
|
is_contractor | boolean | ||
|
Téléphone
|
telephone | string | ||
|
Taux horaire
|
default_hourly_rate | float |
Taux horaire par défaut. |
|
|
Département
|
department | string | ||
|
Taux de coût
|
cost_rate | float |
Ajouter un utilisateur à un projet
Ajoutez un utilisateur existant à un projet.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de projet
|
project_id | True | string |
ID de projet |
|
Identifiant
|
id | True | integer |
Utilisateur |
Créer une entrée de temps
Créez une entrée de temps.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Remarques
|
notes | string | ||
|
Heures
|
hours | integer | ||
|
ID de projet
|
project_id | True | string |
Projet |
|
ID de tâche
|
task_id | True | string |
Tâche |
|
Date
|
spent_at | string |
Passé à |
Retours
- Corps
- UpdateTimeEntry_Response
Entrée de l’heure de mise à jour
Mettez à jour une entrée de temps existante.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’entrée de temps
|
DAY_ENTRY_ID | True | string |
ID de l’entrée de temps |
|
ID de projet
|
project_id | True | string |
Projet |
|
ID de tâche
|
task_id | True | string |
Tâche |
|
Remarques
|
notes | string | ||
|
Date de début
|
started_at | string |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
|
Date et heure de fin
|
ended_at | string |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
|
Date
|
spent_at | string |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
Retours
- Corps
- UpdateTimeEntry_Response
Obtenir des informations utilisateur
Récupérez les détails d’un utilisateur par ID d’utilisateur ou par e-mail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’utilisateur ou e-mail
|
USERID | True | string |
ID d’utilisateur ou e-mail |
Retours
- Corps
- GetUserByID_Response
Obtenir l’entrée d’heure par ID
Obtenez une entrée de temps existante par ID.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’entrée de temps
|
DAY_ENTRY_ID | True | string |
ID de l’entrée de temps |
Retours
- Corps
- UpdateTimeEntry_Response
Répertorier les projets
Répertorier les tâches
Répertorier tous les clients
Récupère une liste de tous les clients pour le compte authentifié.
Retours
- Objets
- ListAllClients_Response
Répertorier tous les contacts
Récupère une liste de tous les contacts pour l’utilisateur authentifié.
Retours
- Objets
- ListAllContacts_Response
Supprimer l’entrée de temps
Supprimez une entrée de temps existante.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’entrée de temps
|
DAY_ENTRY_ID | True | string |
ID de l’entrée de temps |
Déclencheurs
| Lorsqu’un client est ajouté |
Se déclenche lorsqu’un nouveau client est ajouté. |
| Lorsqu’un contact est ajouté |
Se déclenche lorsqu’un nouveau contact est ajouté. |
| Lorsqu’un projet est créé |
Se déclenche lorsqu’un projet est créé. |
| Lorsqu’un utilisateur est ajouté |
Se déclenche lorsqu’un nouvel utilisateur est ajouté. |
| Lorsqu’une entrée de temps est créée pour le jour actuel |
Se déclenche lorsqu’une nouvelle entrée d’heure est créée pour le jour actuel. |
| Lorsqu’une entrée d’heure est créée pour la date |
Se déclenche lorsqu’une nouvelle entrée d’heure est créée pour une date spécifique. |
Lorsqu’un client est ajouté
Se déclenche lorsqu’un nouveau client est ajouté.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID client
|
client.id | integer |
Identificateur unique du client. |
|
Nom
|
client.name | string |
Nom du client. |
|
Monnaie
|
client.currency | string |
Devise à utiliser pour la facturation du client. |
|
Date-heure mise à jour
|
client.updated_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date de création
|
client.created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Adresse
|
client.address | string |
Adresse du client. |
|
Symbole monétaire
|
client.currency_symbol | string |
Symbole qui correspond à la devise sélectionnée. |
|
Détails
|
client.details | string |
Détails supplémentaires, normalement utilisés pour les informations d’adresse. |
Lorsqu’un contact est ajouté
Se déclenche lorsqu’un nouveau contact est ajouté.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de contact
|
contact.id | integer |
Identificateur unique du contact. |
|
ID client
|
contact.client_id | integer |
Identificateur unique du client. |
|
Prénom
|
contact.first_name | string |
Prénom du contact. |
|
Nom
|
contact.last_name | string |
Nom du contact. |
|
Messagerie électronique
|
contact.email | string |
E-mail du contact. |
|
Téléphone de bureau
|
contact.phone_office | string |
Téléphone du bureau du contact. |
|
Téléphone portable
|
contact.phone_mobile | string |
Téléphone mobile du contact. |
|
Télécopie
|
contact.fax | string |
Télécopie du contact. |
|
Titre
|
contact.title | string |
Titre du contact. |
|
Date de création
|
contact.created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date-heure mise à jour
|
contact.updated_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
Lorsqu’un projet est créé
Se déclenche lorsqu’un projet est créé.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID du projet
|
project.id | integer |
Identificateur unique du projet. |
|
ID client
|
project.client_id | integer |
ID du client pour le projet. |
|
Nom
|
project.name | string |
Nom du projet. |
|
Code
|
project.code | string |
Code du projet. |
|
Est actif
|
project.active | boolean |
True si le projet est actuellement actif. |
|
Est facturable
|
project.billable | boolean |
True si le projet est facturable. |
|
Facture par
|
project.bill_by | string |
Méthode par laquelle le projet est facturé. |
|
Taux horaire
|
project.hourly_rate | float |
Taux de facturation par heure. |
|
Budget
|
project.budget | float |
Valeur budgétaire du projet. |
|
Budget par
|
project.budget_by | string |
Méthode de budget pour le projet. |
|
Date de création
|
project.created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date-heure mise à jour
|
project.updated_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date de début
|
project.starts_on | string |
YYYY-MM-DD |
|
Date de fin
|
project.ends_on | string |
YYYY-MM-DD |
|
Estimation
|
project.estimate | float |
Estimation du projet. |
|
Estimé par
|
project.estimate_by | string |
Méthode d’estimation pour le projet. |
|
Date d’enregistrement la plus ancienne
|
project.hint_earliest_record_at | string |
YYYY-MM-DD |
|
Date de l’enregistrement la plus récente
|
project.hint_latest_record_at | string |
YYYY-MM-DD |
|
Remarques
|
project.notes | string |
Notes du projet. |
|
Budget des coûts
|
project.cost_budget | float |
Valeur budgétaire pour le total des projets de frais de projet. |
|
Le budget des coûts comprend les dépenses
|
project.cost_budget_include_expenses | boolean |
Option pour le budget des projets de frais de projet totaux afin d’inclure les dépenses suivies. |
Lorsqu’un utilisateur est ajouté
Lorsqu’une entrée de temps est créée pour le jour actuel
Se déclenche lorsqu’une nouvelle entrée d’heure est créée pour le jour actuel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Autre ID d’utilisateur
|
of_user | string |
ID de l’utilisateur pour lequel vérifier les entrées d’heure. La valeur par défaut est votre ID. |
Retours
Lorsqu’une entrée d’heure est créée pour la date
Se déclenche lorsqu’une nouvelle entrée d’heure est créée pour une date spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Date
|
date | True | string |
AAAA -MM-DD ou format ISO datetime |
|
Autre ID d’utilisateur
|
of_user | string |
ID de l’utilisateur pour lequel vérifier les entrées d’heure. |
Retours
Définitions
ListAllContacts_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de contact
|
contact.id | integer |
Identificateur unique du contact. |
|
ID client
|
contact.client_id | integer |
Identificateur unique du client. |
|
Prénom
|
contact.first_name | string |
Prénom du contact. |
|
Nom
|
contact.last_name | string |
Nom du contact. |
|
Messagerie électronique
|
contact.email | string |
E-mail du contact. |
|
Téléphone de bureau
|
contact.phone_office | string |
Téléphone du bureau du contact. |
|
Téléphone portable
|
contact.phone_mobile | string |
Téléphone mobile du contact. |
|
Télécopie
|
contact.fax | string |
Télécopie du contact. |
|
Titre
|
contact.title | string |
Titre du contact. |
|
Date de création
|
contact.created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date-heure mise à jour
|
contact.updated_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
ListAllClients_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID client
|
client.id | integer |
Identificateur unique du client. |
|
Nom
|
client.name | string |
Nom du client. |
|
Monnaie
|
client.currency | string |
Devise à utiliser pour la facturation du client. |
|
Date-heure mise à jour
|
client.updated_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date de création
|
client.created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Adresse
|
client.address | string |
Adresse du client. |
|
Symbole monétaire
|
client.currency_symbol | string |
Symbole qui correspond à la devise sélectionnée. |
|
Détails
|
client.details | string |
Détails supplémentaires, normalement utilisés pour les informations d’adresse. |
UpdateTimeEntry_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID d’entrée de temps
|
id | integer |
Identificateur unique de l’entrée de temps. |
|
Identifiant utilisateur
|
user_id | integer |
Identificateur unique de l’utilisateur qui a créé l’entrée de temps. |
|
Date
|
spent_at | string |
Date de l’entrée d’heure. |
|
Date de création
|
created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date-heure mise à jour
|
updated_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
ID du projet
|
project_id | string |
L’ID de l’entrée d’heure du projet est associé. |
|
ID de tâche
|
task_id | string |
L’ID de l’entrée de temps de tâche est associé. |
|
Projet
|
project | string |
Nom du projet à laquelle l’entrée de temps est associée. |
|
Tâche
|
task | string |
Nom de la tâche à laquelle l’entrée de temps est associée. |
|
Client
|
client | string |
Nom du client à laquelle l’entrée de temps est associée. |
|
Remarques
|
notes | string |
Notes d’entrée de temps. |
|
Heures sans minuteur
|
hours_without_timer | float |
Durée actuelle suivie, si le minuteur n’est pas en cours d’exécution. |
|
Heures
|
hours | float |
Nombre d’heures (décimales) suivies dans cette entrée de temps. |
ListProjects_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID du projet
|
project.id | integer |
Identificateur unique du projet. |
|
ID client
|
project.client_id | integer |
ID du client pour le projet. |
|
Nom
|
project.name | string |
Nom du projet. |
|
Code
|
project.code | string |
Code du projet. |
|
Est actif
|
project.active | boolean |
True si le projet est actuellement actif. |
|
Est facturable
|
project.billable | boolean |
True si le projet est facturable. |
|
Facture par
|
project.bill_by | string |
Méthode par laquelle le projet est facturé. |
|
Taux horaire
|
project.hourly_rate | float |
Taux de facturation par heure. |
|
Budget
|
project.budget | float |
Valeur budgétaire du projet. |
|
Budget par
|
project.budget_by | string |
Méthode de budget pour le projet. |
|
Date de création
|
project.created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date-heure mise à jour
|
project.updated_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date de début
|
project.starts_on | string |
YYYY-MM-DD |
|
Date de fin
|
project.ends_on | string |
YYYY-MM-DD |
|
Estimation
|
project.estimate | float |
Estimation du projet. |
|
Estimé par
|
project.estimate_by | string |
Méthode d’estimation pour le projet. |
|
Date d’enregistrement la plus ancienne
|
project.hint_earliest_record_at | string |
YYYY-MM-DD |
|
Date de l’enregistrement la plus récente
|
project.hint_latest_record_at | string |
YYYY-MM-DD |
|
Remarques
|
project.notes | string |
Notes du projet. |
|
Budget des coûts
|
project.cost_budget | float |
Valeur budgétaire pour le total des projets de frais de projet. |
|
Le budget des coûts comprend les dépenses
|
project.cost_budget_include_expenses | boolean |
Option pour le budget des projets de frais de projet totaux afin d’inclure les dépenses suivies. |
ListTasks_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de tâche
|
task.id | integer |
Identificateur unique de la tâche. |
|
Nom
|
task.name | string |
Nom de la tâche. |
|
interne
|
task.billable_by_default | boolean | |
|
Date de création
|
task.created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (UTC). |
|
Date-heure mise à jour
|
task.updated_at | date-time |
AAAA-MM-DDThh :mm :ssZ (UTC). |
|
Taux horaire par défaut
|
task.default_hourly_rate | float |
Taux par défaut pour la tâche. |
GetUserByID_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Identifiant utilisateur
|
user.id | integer |
Identificateur unique de l’utilisateur. |
|
Messagerie électronique
|
user.email | string |
E-mail de l’utilisateur. |
|
Date de création
|
user.created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Est administrateur
|
user.is_admin | boolean |
True si l’utilisateur est un administrateur. |
|
Prénom
|
user.first_name | string |
Prénom de l’utilisateur. |
|
Nom
|
user.last_name | string |
Nom de l’utilisateur. |
|
Est-ce que l’entrepreneur
|
user.is_contractor | boolean |
True si l’utilisateur est un entrepreneur. |
|
Téléphone
|
user.telephone | string |
Téléphone de l’utilisateur. |
|
Est actif
|
user.is_active | boolean |
True si l’utilisateur est actuellement actif. |
|
Taux horaire
|
user.default_hourly_rate | float |
Taux horaire de l’utilisateur |
|
Département
|
user.department | string |
Nom du service dans lequel l’utilisateur travaille. |
|
Abonnement au bulletin d’informations
|
user.wants_newsletter | boolean |
True si l’utilisateur souhaite s’abonner au bulletin d’informations. |
|
Taux de coût
|
user.cost_rate | float |
Taux de coût de l’utilisateur. |
|
Capacité hebdomadaire
|
user.weekly_capacity | integer |
Capacité hebdomadaire de l’utilisateur. |
GetTimeEntriesForDay_Response
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
day_entries
|
day_entries | array of object |
day_entries |
|
ID du projet
|
day_entries.project_id | string |
Identificateur unique du porject. |
|
Nom du projet
|
day_entries.project | string |
Nom du projet. |
|
Identifiant utilisateur
|
day_entries.user_id | integer |
Identificateur unique de l’utilisateur. |
|
Date
|
day_entries.spent_at | string |
YYYY-MM-DD |
|
ID de tâche
|
day_entries.task_id | string |
ID de la tâche à laquelle l’entrée de temps est associée. |
|
Tâche
|
day_entries.task | string |
Nom de la tâche à laquelle l’entrée de temps est associée. |
|
Client
|
day_entries.client | string |
Nom du client à laquelle l’entrée de temps est associée. |
|
ID d’entrée de temps
|
day_entries.id | integer |
Identificateur unique de l’entrée de temps. |
|
Remarques
|
day_entries.notes | string |
Notes d’entrée de temps. |
|
Date de début
|
day_entries.started_at | string |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date et heure de fin
|
day_entries.ended_at | string |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date de création
|
day_entries.created_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Date-heure mise à jour
|
day_entries.updated_at | date-time |
AAAA-MM-DDThh :mm :ssZ (format UTC). |
|
Heures sans minuteur
|
day_entries.hours_without_timer | float |
Durée actuelle suivie, si le minuteur n’est pas en cours d’exécution. |
|
Heures
|
day_entries.hours | float |
Nombre d’heures (décimales) suivies dans cette entrée de temps. |