Freigeben über


Ernte

Harvest ist ein einfaches Tool, mit dem Sie die von Ihrem Team für jedes Projekt und jede Aufgabe aufgewendete Zeit nachverfolgen können.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Microsoft
URL Microsoft LogicApps-Unterstützung
Microsoft Power Automate-Support
Microsoft Power Apps-Unterstützung
Connectormetadaten
Herausgeber Microsoft
Webseite https://www.getharvest.com/
Datenschutzrichtlinie https://www.getharvest.com/privacy-policy

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden
Häufigkeit der Triggerumfragen 1 60 Sekunden

Aktionen

Abrufen des Zeiteintrags nach ID

Abrufen eines vorhandenen Zeiteintrags nach ID.

Abrufen von Benutzerinformationen

Rufen Sie die Details eines Benutzers anhand der Benutzer-ID oder E-Mail ab.

Alle Clients auflisten

Ruft eine Liste aller Clients für das authentifizierte Konto ab.

Alle Kontakte auflisten

Ruft eine Liste aller Kontakte für den authentifizierten Benutzer ab.

Aufgaben auflisten

Ruft eine Liste aller Aufgaben ab.

Hinzufügen eines Benutzers zu einem Projekt

Fügen Sie einem Projekt einen vorhandenen Benutzer hinzu.

Neuen Benutzer hinzufügen

Erstellen Sie einen neuen Benutzer.

Neuen Client hinzufügen

Erstellen Sie einen neuen Client.

Neuen Kontakt hinzufügen

Erstellen Sie einen neuen Kontakt.

Projekte auflisten

Listet alle Projekte für den aktuellen Benutzer auf.

Zeiteintrag aktualisieren

Aktualisieren sie einen vorhandenen Zeiteintrag.

Zeiteintrag erstellen

Erstellen Sie einen neuen Zeiteintrag.

Zeiteintrag löschen

Löschen sie einen vorhandenen Zeiteintrag.

Abrufen des Zeiteintrags nach ID

Abrufen eines vorhandenen Zeiteintrags nach ID.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Zeiteintrags-ID
DAY_ENTRY_ID True string

Die ID des Zeiteintrags

Gibt zurück

Abrufen von Benutzerinformationen

Rufen Sie die Details eines Benutzers anhand der Benutzer-ID oder E-Mail ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer-ID oder E-Mail
USERID True string

Benutzer-ID oder E-Mail

Gibt zurück

Alle Clients auflisten

Ruft eine Liste aller Clients für das authentifizierte Konto ab.

Gibt zurück

Alle Kontakte auflisten

Ruft eine Liste aller Kontakte für den authentifizierten Benutzer ab.

Gibt zurück

Aufgaben auflisten

Ruft eine Liste aller Aufgaben ab.

Gibt zurück

Gegenstände
ListTasks_Response

Hinzufügen eines Benutzers zu einem Projekt

Fügen Sie einem Projekt einen vorhandenen Benutzer hinzu.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Projekt-ID
project_id True string

Projekt-ID

Benutzer-ID
id True integer

Benutzer

Neuen Benutzer hinzufügen

Erstellen Sie einen neuen Benutzer.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Email
email True string
Ist Administrator
is_admin boolean
Vorname
first_name True string
Nachname
last_name True string
Ist Auftragnehmer
is_contractor boolean
Telefonnummer
telephone string
Stundensatz
default_hourly_rate float

Standardstundensatz.

Abteilung
department string
Kostenrate
cost_rate float

Neuen Client hinzufügen

Erstellen Sie einen neuen Client.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Name
name True string

Name des Clients

Währung
currency string

Die Währung, die Sie für den Client verwenden möchten.

Währungssymbol
currency_symbol string

Symbol, das mit der ausgewählten Währung korreliert.

Einzelheiten
details string

Zusätzliche Details, die normalerweise für Adressinformationen verwendet werden.

Neuen Kontakt hinzufügen

Erstellen Sie einen neuen Kontakt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Client-ID
client_id True integer

Eindeutiger Bezeichner des Clients.

Vorname
first_name True string

Vorname des Kontakts.

Nachname
last_name True string

Nachname des Kontakts.

Email
email string

E-Mail-Adresse des Kontakts.

Telefon (Büro)
phone_office string

Das Bürotelefon des Kontakts.

Mobiltelefonnummer
phone_mobile string

Mobiltelefon des Kontakts.

Faxnummer
fax string

Fax des Kontakts.

Title
title string

Der Titel des Kontakts.

Projekte auflisten

Listet alle Projekte für den aktuellen Benutzer auf.

Gibt zurück

Gegenstände
ListProjects_Response

Zeiteintrag aktualisieren

Aktualisieren sie einen vorhandenen Zeiteintrag.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Zeiteintrags-ID
DAY_ENTRY_ID True string

Die ID des Zeiteintrags

Projekt-ID
project_id True string

Project

Vorgangs-ID
task_id True string

Aufgabe

Hinweise
notes string
Startdatum
started_at string

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Enddatum-Uhrzeit
ended_at string

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Datum
spent_at string

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Gibt zurück

Zeiteintrag erstellen

Erstellen Sie einen neuen Zeiteintrag.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Notizen
notes string
Stunden
hours integer
Projekt-ID
project_id True string

Project

Vorgangs-ID
task_id True string

Aufgabe

Datum
spent_at string

Aufgewendet am

Gibt zurück

Zeiteintrag löschen

Löschen sie einen vorhandenen Zeiteintrag.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Zeiteintrags-ID
DAY_ENTRY_ID True string

Die ID des Zeiteintrags

Auslöser

Beim Erstellen eines Projekts

Wird ausgelöst, wenn ein neues Projekt erstellt wird.

Wann ein Zeiteintrag für Datum erstellt wird

Wird ausgelöst, wenn ein neuer Zeiteintrag für ein bestimmtes Datum erstellt wird.

Wann ein Zeiteintrag für den aktuellen Tag erstellt wird

Wird ausgelöst, wenn für den aktuellen Tag ein neuer Zeiteintrag erstellt wird.

Wenn ein Benutzer hinzugefügt wird

Wird ausgelöst, wenn ein neuer Benutzer hinzugefügt wird.

Wenn ein Client hinzugefügt wird

Wird ausgelöst, wenn ein neuer Client hinzugefügt wird.

Wenn ein Kontakt hinzugefügt wird

Wird ausgelöst, wenn ein neuer Kontakt hinzugefügt wird.

Beim Erstellen eines Projekts

Wird ausgelöst, wenn ein neues Projekt erstellt wird.

Gibt zurück

Name Pfad Typ Beschreibung
Projekt-ID
project.id integer

Eindeutiger Bezeichner des Projekts.

Client-ID
project.client_id integer

ID des Clients für das Projekt.

Name
project.name string

Projektname.

Code
project.code string

Projektcode.

Ist aktiv
project.active boolean

True, wenn das Projekt derzeit aktiv ist.

Ist abrechnend
project.billable boolean

True, wenn das Projekt in Rechnung gestellt werden kann.

Rechnung nach
project.bill_by string

Methode, nach der das Projekt in Rechnung gestellt wird.

Stundensatz
project.hourly_rate float

Abrechnungssatz nach Stunde.

Budget
project.budget float

Budgetwert für das Projekt.

Budget nach
project.budget_by string

Budgetierungsmethode für das Projekt.

Erstellungsdatum
project.created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Datum-Uhrzeit aktualisiert
project.updated_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Startdatum
project.starts_on string

JJJJ-MM-TT

Enddatum
project.ends_on string

JJJJ-MM-TT

Schätzen
project.estimate float

Projektschätzung.

Geschätzt nach
project.estimate_by string

Methode der Schätzung für Das Projekt.

Frühestes Datensatzdatum
project.hint_earliest_record_at string

JJJJ-MM-TT

Neuestes Datensatzdatum
project.hint_latest_record_at string

JJJJ-MM-TT

Hinweise
project.notes string

Projektnotizen.

Kostenbudget
project.cost_budget float

Budgetwert für Projektgebühren insgesamt.

Kostenbudget umfasst Ausgaben
project.cost_budget_include_expenses boolean

Option für das Budget der Projekte gesamter Projektgebühren, um nachverfolgte Ausgaben einzuschließen.

Wann ein Zeiteintrag für Datum erstellt wird

Wird ausgelöst, wenn ein neuer Zeiteintrag für ein bestimmtes Datum erstellt wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datum
date True string

YYYY-MM-DD oder ISO-Format datetime

Andere Benutzer-ID
of_user string

Die ID des Benutzers, auf den Zeiteinträge überprüft werden sollen.

Gibt zurück

Wann ein Zeiteintrag für den aktuellen Tag erstellt wird

Wird ausgelöst, wenn für den aktuellen Tag ein neuer Zeiteintrag erstellt wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Andere Benutzer-ID
of_user string

Die ID des Benutzers, auf den Zeiteinträge überprüft werden sollen. Standardmäßig wird Ihre ID verwendet.

Gibt zurück

Wenn ein Benutzer hinzugefügt wird

Wird ausgelöst, wenn ein neuer Benutzer hinzugefügt wird.

Gibt zurück

Wenn ein Client hinzugefügt wird

Wird ausgelöst, wenn ein neuer Client hinzugefügt wird.

Gibt zurück

Name Pfad Typ Beschreibung
Client-ID
client.id integer

Eindeutiger Bezeichner des Clients.

Name
client.name string

Der Name des Clients.

Währung
client.currency string

Währung, die für die Kundenabrechnung verwendet werden soll.

Datum-Uhrzeit aktualisiert
client.updated_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Erstellungsdatum
client.created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Adresse
client.address string

Adresse des Clients.

Währungssymbol
client.currency_symbol string

Symbol, das mit der ausgewählten Währung korreliert.

Einzelheiten
client.details string

Zusätzliche Details, die normalerweise für Adressinformationen verwendet werden.

Wenn ein Kontakt hinzugefügt wird

Wird ausgelöst, wenn ein neuer Kontakt hinzugefügt wird.

Gibt zurück

Name Pfad Typ Beschreibung
Kontakt-ID
contact.id integer

Eindeutiger Bezeichner des Kontakts.

Client-ID
contact.client_id integer

Eindeutiger Bezeichner des Clients.

Vorname
contact.first_name string

Vorname des Kontakts.

Nachname
contact.last_name string

Nachname des Kontakts.

Email
contact.email string

E-Mail-Adresse des Kontakts.

Telefon (Büro)
contact.phone_office string

Das Bürotelefon des Kontakts.

Mobiltelefonnummer
contact.phone_mobile string

Mobiltelefon des Kontakts.

Faxnummer
contact.fax string

Fax des Kontakts.

Title
contact.title string

Der Titel des Kontakts.

Erstellungsdatum
contact.created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Datum-Uhrzeit aktualisiert
contact.updated_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Definitionen

ListAllContacts_Response

Name Pfad Typ Beschreibung
Kontakt-ID
contact.id integer

Eindeutiger Bezeichner des Kontakts.

Client-ID
contact.client_id integer

Eindeutiger Bezeichner des Clients.

Vorname
contact.first_name string

Vorname des Kontakts.

Nachname
contact.last_name string

Nachname des Kontakts.

Email
contact.email string

E-Mail-Adresse des Kontakts.

Telefon (Büro)
contact.phone_office string

Das Bürotelefon des Kontakts.

Mobiltelefonnummer
contact.phone_mobile string

Mobiltelefon des Kontakts.

Faxnummer
contact.fax string

Fax des Kontakts.

Title
contact.title string

Der Titel des Kontakts.

Erstellungsdatum
contact.created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Datum-Uhrzeit aktualisiert
contact.updated_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

ListAllClients_Response

Name Pfad Typ Beschreibung
Client-ID
client.id integer

Eindeutiger Bezeichner des Clients.

Name
client.name string

Der Name des Clients.

Währung
client.currency string

Währung, die für die Kundenabrechnung verwendet werden soll.

Datum-Uhrzeit aktualisiert
client.updated_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Erstellungsdatum
client.created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Adresse
client.address string

Adresse des Clients.

Währungssymbol
client.currency_symbol string

Symbol, das mit der ausgewählten Währung korreliert.

Einzelheiten
client.details string

Zusätzliche Details, die normalerweise für Adressinformationen verwendet werden.

UpdateTimeEntry_Response

Name Pfad Typ Beschreibung
Zeiteintrags-ID
id integer

Eindeutiger Bezeichner des Zeiteintrags.

Benutzer-ID
user_id integer

Eindeutiger Bezeichner des Benutzers, der den Zeiteintrag erstellt hat.

Datum
spent_at string

Datum der Uhrzeiteingabe.

Erstellungsdatum
created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Datum-Uhrzeit aktualisiert
updated_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Projekt-ID
project_id string

Die ID des Projektzeiteintrags ist zugeordnet.

Vorgangs-ID
task_id string

Die ID des Vorgangszeiteintrags ist zugeordnet.

Project
project string

Der Name des Projekts, dem der Zeiteintrag zugeordnet ist.

Aufgabe
task string

Der Name des Vorgangs, dem der Zeiteintrag zugeordnet ist.

Kunde
client string

Der Name des Clients, dem der Zeiteintrag zugeordnet ist.

Hinweise
notes string

Zeiteintragsnotizen.

Stunden ohne Timer
hours_without_timer float

Aktueller Zeitaufwand, der nachverfolgt wird, wenn der Timer nicht ausgeführt wird.

Stunden
hours float

Die Anzahl der (Dezimalzeit) Stunden, die in diesem Zeiteintrag nachverfolgt werden.

ListProjects_Response

Name Pfad Typ Beschreibung
Projekt-ID
project.id integer

Eindeutiger Bezeichner des Projekts.

Client-ID
project.client_id integer

ID des Clients für das Projekt.

Name
project.name string

Projektname.

Code
project.code string

Projektcode.

Ist aktiv
project.active boolean

True, wenn das Projekt derzeit aktiv ist.

Ist abrechnend
project.billable boolean

True, wenn das Projekt in Rechnung gestellt werden kann.

Rechnung nach
project.bill_by string

Methode, nach der das Projekt in Rechnung gestellt wird.

Stundensatz
project.hourly_rate float

Abrechnungssatz nach Stunde.

Budget
project.budget float

Budgetwert für das Projekt.

Budget nach
project.budget_by string

Budgetierungsmethode für das Projekt.

Erstellungsdatum
project.created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Datum-Uhrzeit aktualisiert
project.updated_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Startdatum
project.starts_on string

JJJJ-MM-TT

Enddatum
project.ends_on string

JJJJ-MM-TT

Schätzen
project.estimate float

Projektschätzung.

Geschätzt nach
project.estimate_by string

Methode der Schätzung für Das Projekt.

Frühestes Datensatzdatum
project.hint_earliest_record_at string

JJJJ-MM-TT

Neuestes Datensatzdatum
project.hint_latest_record_at string

JJJJ-MM-TT

Hinweise
project.notes string

Projektnotizen.

Kostenbudget
project.cost_budget float

Budgetwert für Projektgebühren insgesamt.

Kostenbudget umfasst Ausgaben
project.cost_budget_include_expenses boolean

Option für das Budget der Projekte gesamter Projektgebühren, um nachverfolgte Ausgaben einzuschließen.

ListTasks_Response

Name Pfad Typ Beschreibung
Vorgangs-ID
task.id integer

Eindeutiger Bezeichner der Aufgabe.

Name
task.name string

Vorgangsname.

intern
task.billable_by_default boolean
Erstellungsdatum
task.created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC).

Datum-Uhrzeit aktualisiert
task.updated_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC).

Standardstundensatz
task.default_hourly_rate float

Standardsatz für den Vorgang.

GetUserByID_Response

Name Pfad Typ Beschreibung
Benutzer-ID
user.id integer

Eindeutiger Bezeichner des Benutzers

Email
user.email string

E-Mail-Adresse des Benutzers.

Erstellungsdatum
user.created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Ist Administrator
user.is_admin boolean

True, wenn der Benutzer ein Administrator ist.

Vorname
user.first_name string

Vorname des Benutzers.

Nachname
user.last_name string

Nachname des Benutzers.

Ist Auftragnehmer
user.is_contractor boolean

True, wenn der Benutzer ein Auftragnehmer ist.

Telefonnummer
user.telephone string

Telefon des Benutzers.

Ist aktiv
user.is_active boolean

True, wenn der Benutzer derzeit aktiv ist.

Stundensatz
user.default_hourly_rate float

Stundensatz des Benutzers

Abteilung
user.department string

Der Abteilungsname, in dem der Benutzer arbeitet.

Newsletterabonnement
user.wants_newsletter boolean

True, wenn der Benutzer den Newsletter abonnieren möchte.

Kostenrate
user.cost_rate float

Kostensatz des Benutzers.

Wöchentliche Kapazität
user.weekly_capacity integer

Wöchentliche Kapazität des Benutzers.

GetTimeEntriesForDay_Response

Name Pfad Typ Beschreibung
day_entries
day_entries array of object

day_entries

Projekt-ID
day_entries.project_id string

Eindeutiger Bezeichner des Porjekts.

Projektname
day_entries.project string

Name des Projekts.

Benutzer-ID
day_entries.user_id integer

Eindeutiger Bezeichner des Benutzers

Datum
day_entries.spent_at string

JJJJ-MM-TT

Vorgangs-ID
day_entries.task_id string

Die ID des Vorgangs, dem der Zeiteintrag zugeordnet ist.

Aufgabe
day_entries.task string

Der Name des Vorgangs, dem der Zeiteintrag zugeordnet ist.

Kunde
day_entries.client string

Der Name des Clients, dem der Zeiteintrag zugeordnet ist.

Zeiteintrags-ID
day_entries.id integer

Eindeutiger Bezeichner des Zeiteintrags.

Hinweise
day_entries.notes string

Zeiteintragsnotizen.

Startdatum
day_entries.started_at string

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Enddatum-Uhrzeit
day_entries.ended_at string

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Erstellungsdatum
day_entries.created_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Datum-Uhrzeit aktualisiert
day_entries.updated_at date-time

JJJJ-MM-DDThh:mm:ssZ (UTC-Format).

Stunden ohne Timer
day_entries.hours_without_timer float

Aktueller Zeitaufwand, der nachverfolgt wird, wenn der Timer nicht ausgeführt wird.

Stunden
day_entries.hours float

Die Anzahl der (Dezimalzeit) Stunden, die in diesem Zeiteintrag nachverfolgt werden.