Oogst
Harvest is een eenvoudig hulpmiddel om de tijd bij te houden die uw team aan elk project en elke taak heeft besteed.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Naam | Microsoft |
| URL |
Ondersteuning voor Microsoft LogicApps Ondersteuning voor Microsoft Power Automate Ondersteuning voor Microsoft Power Apps |
| Connector-metagegevens | |
|---|---|
| Uitgever | Microsoft |
| Webpagina | https://www.getharvest.com/ |
| Privacybeleid | https://www.getharvest.com/privacy-policy |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 100 | 60 seconden |
| Frequentie van trigger-polls | 1 | 60 seconden |
Acties
| Alle clients weergeven |
Hiermee haalt u een lijst op van alle clients voor het geverifieerde account. |
| Alle contactpersonen weergeven |
Hiermee haalt u een lijst met alle contactpersonen voor de geverifieerde gebruiker op. |
| Gebruiker toevoegen aan een project |
Voeg een bestaande gebruiker toe aan een project. |
| Gebruikersgegevens ophalen |
Haal de gegevens van een gebruiker op op basis van de gebruikers-id of e-mail. |
| Nieuwe client toevoegen |
Maak een nieuwe client. |
| Nieuwe contactpersoon toevoegen |
Maak een nieuwe contactpersoon. |
| Nieuwe gebruiker toevoegen |
Maak een nieuwe gebruiker. |
| Projecten weergeven |
Een lijst met alle projecten voor de huidige gebruiker. |
| Taken weergeven |
Hiermee haalt u een lijst met alle taken op. |
| Tijdinvoer ophalen op id |
Haal een bestaande tijdvermelding op op id. |
| Tijdvermelding bijwerken |
Een bestaande tijdvermelding bijwerken. |
| Tijdvermelding maken |
Maak een nieuwe tijdvermelding. |
| Tijdvermelding verwijderen |
Een bestaande tijdvermelding verwijderen. |
Alle clients weergeven
Hiermee haalt u een lijst op van alle clients voor het geverifieerde account.
Retouren
- Artikelen
- ListAllClients_Response
Alle contactpersonen weergeven
Hiermee haalt u een lijst met alle contactpersonen voor de geverifieerde gebruiker op.
Retouren
- Artikelen
- ListAllContacts_Response
Gebruiker toevoegen aan een project
Voeg een bestaande gebruiker toe aan een project.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Project-id
|
project_id | True | string |
Project-id |
|
Gebruikersnaam
|
id | True | integer |
User |
Gebruikersgegevens ophalen
Haal de gegevens van een gebruiker op op basis van de gebruikers-id of e-mail.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gebruikers-id of e-mailadres
|
USERID | True | string |
Gebruikers-id of e-mailadres |
Retouren
- Body
- GetUserByID_Response
Nieuwe client toevoegen
Maak een nieuwe client.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Naam
|
name | True | string |
Naam van client |
|
Valuta
|
currency | string |
De valuta die u wilt gebruiken voor de client. |
|
|
Valutasymbool
|
currency_symbol | string |
Symbool dat overeenkomt met de geselecteerde valuta. |
|
|
Bijzonderheden
|
details | string |
Aanvullende gegevens, die normaal gesproken worden gebruikt voor adresgegevens. |
Nieuwe contactpersoon toevoegen
Maak een nieuwe contactpersoon.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Client-id
|
client_id | True | integer |
Unieke id van de client. |
|
Voornaam
|
first_name | True | string |
De voornaam van de contactpersoon. |
|
Achternaam
|
last_name | True | string |
De achternaam van de contactpersoon. |
|
E-mailen
|
string |
E-mailadres van contactpersoon. |
||
|
Telefoon (werk)
|
phone_office | string |
De telefoon van het kantoor van de contactpersoon. |
|
|
Telefoon (mobiel)
|
phone_mobile | string |
De mobiele telefoon van de contactpersoon. |
|
|
Fax
|
fax | string |
Fax van contactpersoon. |
|
|
Title
|
title | string |
De titel van de contactpersoon. |
Nieuwe gebruiker toevoegen
Maak een nieuwe gebruiker.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
E-mailen
|
True | string | ||
|
Is beheerder
|
is_admin | boolean | ||
|
Voornaam
|
first_name | True | string | |
|
Achternaam
|
last_name | True | string | |
|
Is aannemer
|
is_contractor | boolean | ||
|
Telefoon
|
telephone | string | ||
|
Uurtarief
|
default_hourly_rate | float |
Standaardtarief per uur. |
|
|
Afdeling
|
department | string | ||
|
Kostentarief
|
cost_rate | float |
Projecten weergeven
Taken weergeven
Tijdinvoer ophalen op id
Haal een bestaande tijdvermelding op op id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tijdinvoer-id
|
DAY_ENTRY_ID | True | string |
De id van de tijdvermelding |
Retouren
Tijdvermelding bijwerken
Een bestaande tijdvermelding bijwerken.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tijdinvoer-id
|
DAY_ENTRY_ID | True | string |
De id van de tijdvermelding |
|
Project-id
|
project_id | True | string |
Project |
|
Taak-id
|
task_id | True | string |
Opdracht |
|
Opmerkingen
|
notes | string | ||
|
Datum/tijd gestart
|
started_at | string |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
|
Einddatum datum/tijd
|
ended_at | string |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
|
Datum
|
spent_at | string |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
Retouren
Tijdvermelding maken
Maak een nieuwe tijdvermelding.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Notities
|
notes | string | ||
|
uren
|
hours | integer | ||
|
Project-id
|
project_id | True | string |
Project |
|
Taak-id
|
task_id | True | string |
Opdracht |
|
Datum
|
spent_at | string |
Besteed aan |
Retouren
Tijdvermelding verwijderen
Een bestaande tijdvermelding verwijderen.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Tijdinvoer-id
|
DAY_ENTRY_ID | True | string |
De id van de tijdvermelding |
Triggers
| Wanneer een client wordt toegevoegd |
Triggers wanneer een nieuwe client wordt toegevoegd. |
| Wanneer een contactpersoon wordt toegevoegd |
Triggers wanneer een nieuwe contactpersoon wordt toegevoegd. |
| Wanneer een gebruiker wordt toegevoegd |
Triggers wanneer een nieuwe gebruiker wordt toegevoegd. |
| Wanneer een project wordt gemaakt |
Triggers wanneer een nieuw project wordt gemaakt. |
| Wanneer een tijdvermelding wordt gemaakt voor datum |
Triggers wanneer een nieuwe tijdvermelding wordt gemaakt voor een specifieke datum. |
| Wanneer een tijdvermelding wordt gemaakt voor de huidige dag |
Triggers wanneer er een nieuwe tijdvermelding wordt gemaakt voor de huidige dag. |
Wanneer een client wordt toegevoegd
Triggers wanneer een nieuwe client wordt toegevoegd.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Client-id
|
client.id | integer |
Unieke id van de client. |
|
Naam
|
client.name | string |
Naam van client. |
|
Valuta
|
client.currency | string |
Valuta die moet worden gebruikt voor clientfacturering. |
|
Datum/tijd bijgewerkt
|
client.updated_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Datum/tijd gemaakt
|
client.created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Adres
|
client.address | string |
Het adres van de client. |
|
Valutasymbool
|
client.currency_symbol | string |
Symbool dat overeenkomt met de geselecteerde valuta. |
|
Bijzonderheden
|
client.details | string |
Aanvullende gegevens, die normaal gesproken worden gebruikt voor adresgegevens. |
Wanneer een contactpersoon wordt toegevoegd
Triggers wanneer een nieuwe contactpersoon wordt toegevoegd.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Contactpersoon-id
|
contact.id | integer |
Unieke id van de contactpersoon. |
|
Client-id
|
contact.client_id | integer |
Unieke id van de client. |
|
Voornaam
|
contact.first_name | string |
De voornaam van de contactpersoon. |
|
Achternaam
|
contact.last_name | string |
De achternaam van de contactpersoon. |
|
E-mailen
|
contact.email | string |
E-mailadres van contactpersoon. |
|
Telefoon (werk)
|
contact.phone_office | string |
De telefoon van het kantoor van de contactpersoon. |
|
Telefoon (mobiel)
|
contact.phone_mobile | string |
De mobiele telefoon van de contactpersoon. |
|
Fax
|
contact.fax | string |
Fax van contactpersoon. |
|
Title
|
contact.title | string |
De titel van de contactpersoon. |
|
Datum/tijd gemaakt
|
contact.created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Datum/tijd bijgewerkt
|
contact.updated_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
Wanneer een gebruiker wordt toegevoegd
Wanneer een project wordt gemaakt
Triggers wanneer een nieuw project wordt gemaakt.
Retouren
| Name | Pad | Type | Description |
|---|---|---|---|
|
Project-id
|
project.id | integer |
Unieke id van het project. |
|
Client-id
|
project.client_id | integer |
Id van client voor het project. |
|
Naam
|
project.name | string |
Projectnaam. |
|
Code
|
project.code | string |
Projectcode. |
|
Is actief
|
project.active | boolean |
Waar als het project momenteel actief is. |
|
Factureerbare
|
project.billable | boolean |
Waar als het project factureerbaar is. |
|
Factureren op
|
project.bill_by | string |
Methode waarmee het project wordt gefactureerd. |
|
Uurtarief
|
project.hourly_rate | float |
Factureringstarief per uur. |
|
Begroting
|
project.budget | float |
Budgetwaarde voor het project. |
|
Budget per
|
project.budget_by | string |
Budgetteringsmethode voor het project. |
|
Datum/tijd gemaakt
|
project.created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Datum/tijd bijgewerkt
|
project.updated_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Begindatum
|
project.starts_on | string |
JJJJ-MM-DD |
|
Einddatum
|
project.ends_on | string |
JJJJ-MM-DD |
|
Schatten
|
project.estimate | float |
Projectraming. |
|
Geschat op
|
project.estimate_by | string |
Schattingsmethode voor project. |
|
Vroegste recorddatum
|
project.hint_earliest_record_at | string |
JJJJ-MM-DD |
|
Laatste recorddatum
|
project.hint_latest_record_at | string |
JJJJ-MM-DD |
|
Opmerkingen
|
project.notes | string |
Projectnotities. |
|
Kostenbudget
|
project.cost_budget | float |
Budgetwaarde voor projecten met totale projectkosten. |
|
Kostenbudget omvat uitgaven
|
project.cost_budget_include_expenses | boolean |
Optie voor budget van projecten met totale projectkosten om bijgehouden uitgaven op te nemen. |
Wanneer een tijdvermelding wordt gemaakt voor datum
Triggers wanneer een nieuwe tijdvermelding wordt gemaakt voor een specifieke datum.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Datum
|
date | True | string |
JJJJ-MM-DD of ISO-notatie datum/tijd |
|
Andere gebruikers-id
|
of_user | string |
De id van de gebruiker om tijdvermeldingen voor te controleren. |
Retouren
Wanneer een tijdvermelding wordt gemaakt voor de huidige dag
Triggers wanneer er een nieuwe tijdvermelding wordt gemaakt voor de huidige dag.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Andere gebruikers-id
|
of_user | string |
De id van de gebruiker om tijdvermeldingen voor te controleren. Standaard ingesteld op uw id. |
Retouren
Definities
ListAllContacts_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Contactpersoon-id
|
contact.id | integer |
Unieke id van de contactpersoon. |
|
Client-id
|
contact.client_id | integer |
Unieke id van de client. |
|
Voornaam
|
contact.first_name | string |
De voornaam van de contactpersoon. |
|
Achternaam
|
contact.last_name | string |
De achternaam van de contactpersoon. |
|
E-mailen
|
contact.email | string |
E-mailadres van contactpersoon. |
|
Telefoon (werk)
|
contact.phone_office | string |
De telefoon van het kantoor van de contactpersoon. |
|
Telefoon (mobiel)
|
contact.phone_mobile | string |
De mobiele telefoon van de contactpersoon. |
|
Fax
|
contact.fax | string |
Fax van contactpersoon. |
|
Title
|
contact.title | string |
De titel van de contactpersoon. |
|
Datum/tijd gemaakt
|
contact.created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Datum/tijd bijgewerkt
|
contact.updated_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
ListAllClients_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Client-id
|
client.id | integer |
Unieke id van de client. |
|
Naam
|
client.name | string |
Naam van client. |
|
Valuta
|
client.currency | string |
Valuta die moet worden gebruikt voor clientfacturering. |
|
Datum/tijd bijgewerkt
|
client.updated_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Datum/tijd gemaakt
|
client.created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Adres
|
client.address | string |
Het adres van de client. |
|
Valutasymbool
|
client.currency_symbol | string |
Symbool dat overeenkomt met de geselecteerde valuta. |
|
Bijzonderheden
|
client.details | string |
Aanvullende gegevens, die normaal gesproken worden gebruikt voor adresgegevens. |
UpdateTimeEntry_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Tijdinvoer-id
|
id | integer |
De unieke id van de tijdvermelding. |
|
Gebruikers-id
|
user_id | integer |
De unieke id van de gebruiker die de tijdvermelding heeft gemaakt. |
|
Datum
|
spent_at | string |
Datum van tijdvermelding. |
|
Datum/tijd gemaakt
|
created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Datum/tijd bijgewerkt
|
updated_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Project-id
|
project_id | string |
De id van de projecttijdvermelding is gekoppeld. |
|
Taak-id
|
task_id | string |
De id van de taaktijdvermelding is gekoppeld aan. |
|
Project
|
project | string |
De naam van het project waarmee de tijdvermelding is gekoppeld. |
|
Opdracht
|
task | string |
De naam van de taak waarmee de tijdvermelding is gekoppeld. |
|
Client
|
client | string |
De naam van de client waarmee de tijdvermelding is gekoppeld. |
|
Opmerkingen
|
notes | string |
Tijdnotities. |
|
Uren zonder timer
|
hours_without_timer | float |
Huidige tijd die wordt bijgehouden, als de timer niet wordt uitgevoerd. |
|
Hours
|
hours | float |
Het aantal uren (decimale tijd) dat in deze tijdsvermelding wordt bijgehouden. |
ListProjects_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Project-id
|
project.id | integer |
Unieke id van het project. |
|
Client-id
|
project.client_id | integer |
Id van client voor het project. |
|
Naam
|
project.name | string |
Projectnaam. |
|
Code
|
project.code | string |
Projectcode. |
|
Is actief
|
project.active | boolean |
Waar als het project momenteel actief is. |
|
Factureerbare
|
project.billable | boolean |
Waar als het project factureerbaar is. |
|
Factureren op
|
project.bill_by | string |
Methode waarmee het project wordt gefactureerd. |
|
Uurtarief
|
project.hourly_rate | float |
Factureringstarief per uur. |
|
Begroting
|
project.budget | float |
Budgetwaarde voor het project. |
|
Budget per
|
project.budget_by | string |
Budgetteringsmethode voor het project. |
|
Datum/tijd gemaakt
|
project.created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Datum/tijd bijgewerkt
|
project.updated_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Begindatum
|
project.starts_on | string |
JJJJ-MM-DD |
|
Einddatum
|
project.ends_on | string |
JJJJ-MM-DD |
|
Schatten
|
project.estimate | float |
Projectraming. |
|
Geschat op
|
project.estimate_by | string |
Schattingsmethode voor project. |
|
Vroegste recorddatum
|
project.hint_earliest_record_at | string |
JJJJ-MM-DD |
|
Laatste recorddatum
|
project.hint_latest_record_at | string |
JJJJ-MM-DD |
|
Opmerkingen
|
project.notes | string |
Projectnotities. |
|
Kostenbudget
|
project.cost_budget | float |
Budgetwaarde voor projecten met totale projectkosten. |
|
Kostenbudget omvat uitgaven
|
project.cost_budget_include_expenses | boolean |
Optie voor budget van projecten met totale projectkosten om bijgehouden uitgaven op te nemen. |
ListTasks_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Taak-id
|
task.id | integer |
Unieke id van de taak. |
|
Naam
|
task.name | string |
Taaknaam. |
|
intern
|
task.billable_by_default | boolean | |
|
Datum/tijd gemaakt
|
task.created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC). |
|
Datum/tijd bijgewerkt
|
task.updated_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC). |
|
Standaardtarief per uur
|
task.default_hourly_rate | float |
Standaardtarief voor de taak. |
GetUserByID_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gebruikers-id
|
user.id | integer |
De unieke id van de gebruiker. |
|
E-mailen
|
user.email | string |
E-mailadres van gebruiker. |
|
Datum/tijd gemaakt
|
user.created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Is beheerder
|
user.is_admin | boolean |
Waar als de gebruiker een beheerder is. |
|
Voornaam
|
user.first_name | string |
De voornaam van de gebruiker. |
|
Achternaam
|
user.last_name | string |
Achternaam van gebruiker. |
|
Is aannemer
|
user.is_contractor | boolean |
Waar als de gebruiker een aannemer is. |
|
Telefoon
|
user.telephone | string |
Telefoon van gebruiker. |
|
Is actief
|
user.is_active | boolean |
Waar als de gebruiker momenteel actief is. |
|
Uurtarief
|
user.default_hourly_rate | float |
Uurtarief van gebruiker |
|
Afdeling
|
user.department | string |
Afdelingsnaam waarin de gebruiker werkt. |
|
Nieuwsbriefabonnement
|
user.wants_newsletter | boolean |
Is waar als de gebruiker zich wil abonneren op de nieuwsbrief. |
|
Kostentarief
|
user.cost_rate | float |
Het kostentarief van de gebruiker. |
|
Wekelijkse capaciteit
|
user.weekly_capacity | integer |
De wekelijkse capaciteit van de gebruiker. |
GetTimeEntriesForDay_Response
| Name | Pad | Type | Description |
|---|---|---|---|
|
day_entries
|
day_entries | array of object |
day_entries |
|
Project-id
|
day_entries.project_id | string |
Unieke id van het porject. |
|
Projectnaam
|
day_entries.project | string |
Naam van het project. |
|
Gebruikers-id
|
day_entries.user_id | integer |
De unieke id van de gebruiker. |
|
Datum
|
day_entries.spent_at | string |
JJJJ-MM-DD |
|
Taak-id
|
day_entries.task_id | string |
Id van de taak waarmee de tijdvermelding is gekoppeld. |
|
Opdracht
|
day_entries.task | string |
De naam van de taak waarmee de tijdvermelding is gekoppeld. |
|
Client
|
day_entries.client | string |
De naam van de client waarmee de tijdvermelding is gekoppeld. |
|
Tijdinvoer-id
|
day_entries.id | integer |
De unieke id van de tijdvermelding. |
|
Opmerkingen
|
day_entries.notes | string |
Tijdnotities. |
|
Datum/tijd gestart
|
day_entries.started_at | string |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Einddatum datum/tijd
|
day_entries.ended_at | string |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Datum/tijd gemaakt
|
day_entries.created_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Datum/tijd bijgewerkt
|
day_entries.updated_at | date-time |
JJJJ-MM-DDThh:mm:ssZ (UTC-indeling). |
|
Uren zonder timer
|
day_entries.hours_without_timer | float |
Huidige tijd die wordt bijgehouden, als de timer niet wordt uitgevoerd. |
|
Hours
|
day_entries.hours | float |
Het aantal uren (decimale tijd) dat in deze tijdsvermelding wordt bijgehouden. |