Raccolto

Harvest è uno strumento semplice per tenere traccia del tempo dedicato al team in ogni progetto e attività.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Di alta qualità	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Microsoft
URL	Supporto di Microsoft LogicApps Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps

Metadati del connettore
Editore	Microsoft
Sito web	https://www.getharvest.com/
Informativa sulla privacy	https://www.getharvest.com/privacy-policy

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi
Frequenza dei polling dei trigger	1	60 secondi

Azioni

Aggiornare la voce di ora	Aggiornare una voce di ora esistente.
Aggiungere un nuovo client	Creare un nuovo client.
Aggiungere un nuovo utente	Creare un nuovo utente.
Aggiungere un utente a un progetto	Aggiungere un utente esistente a un progetto.
Aggiungi nuovo contatto	Creare un nuovo contatto.
Creare una voce di ora	Creare una nuova voce temporale.
Elencare i progetti	Elenca tutti i progetti per l'utente corrente.
Elencare le attività	Recupera un elenco di tutte le attività.
Elencare tutti i client	Recupera un elenco di tutti i client per l'account autenticato.
Elencare tutti i contatti	Recupera un elenco di tutti i contatti per l'utente autenticato.
Elimina voce di ora	Eliminare una voce di ora esistente.
Ottenere informazioni sull'utente	Recuperare i dettagli di un utente in base all'ID utente o al messaggio di posta elettronica.
Ottenere l'immissione dell'ora in base all'ID	Ottiene una voce di ora esistente in base all'ID.

Aggiornare la voce di ora

ID operazione:

UpdateTimeEntry

Aggiornare una voce di ora esistente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID voce ora	DAY_ENTRY_ID	True	string	ID della voce dell'ora
ID progetto	project_id	True	string	Progetto
ID attività	task_id	True	string	Task
Note	notes		string
Data e ora di inizio	started_at		string	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data/ora di fine	ended_at		string	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Date	spent_at		string	AAAA-MM-GGThh:mm:ssZ (formato UTC).

Restituisce

Corpo

UpdateTimeEntry_Response

Aggiungere un nuovo client

ID operazione:

AddNewClient

Creare un nuovo client.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome	name	True	string	Nome del client
Valuta	currency		string	Valuta che si vuole usare per il client.
Simbolo valuta	currency_symbol		string	Simbolo correlato alla valuta selezionata.
Dettagli	details		string	Dettagli aggiuntivi, normalmente usati per le informazioni sull'indirizzo.

Aggiungere un nuovo utente

ID operazione:

CreateUser

Creare un nuovo utente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Email	email	True	string
Amministratore	is_admin		boolean
Nome di battesimo	first_name	True	string
Cognome	last_name	True	string
Terzista	is_contractor		boolean
Telefono	telephone		string
Tariffa oraria	default_hourly_rate		float	Tariffa oraria predefinita.
Reparto	department		string
Tasso di costo	cost_rate		float

Aggiungere un utente a un progetto

ID operazione:

AddUserToProject

Aggiungere un utente esistente a un progetto.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID progetto	project_id	True	string	ID progetto
ID utente	id	True	integer	User

Aggiungi nuovo contatto

ID operazione:

AddNewContact

Creare un nuovo contatto.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID client	client_id	True	integer	Identificatore univoco del client.
Nome di battesimo	first_name	True	string	Nome del contatto.
Cognome	last_name	True	string	Cognome del contatto.
Email	email		string	Messaggio di posta elettronica del contatto.
Telefono ufficio	phone_office		string	Telefono dell'ufficio del contatto.
Telefono cellulare	phone_mobile		string	Telefono cellulare del contatto.
Fax	fax		string	Fax del contatto.
Titolo	title		string	Titolo del contatto.

Creare una voce di ora

ID operazione:

CreateTimeEntry

Creare una nuova voce temporale.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
note	notes		string
orario	hours		integer
ID progetto	project_id	True	string	Progetto
ID attività	task_id	True	string	Task
Date	spent_at		string	Trascorso a

Restituisce

Corpo

UpdateTimeEntry_Response

Elencare i progetti

ID operazione:

ListProjects

Elenca tutti i progetti per l'utente corrente.

Restituisce

Elementi

ListProjects_Response

Elencare le attività

ID operazione:

ListTasks

Recupera un elenco di tutte le attività.

Restituisce

Elementi

ListTasks_Response

Elencare tutti i client

ID operazione:

ListAllClients

Recupera un elenco di tutti i client per l'account autenticato.

Restituisce

Elementi

ListAllClients_Response

Elencare tutti i contatti

ID operazione:

ListAllContacts

Recupera un elenco di tutti i contatti per l'utente autenticato.

Restituisce

Elementi

ListAllContacts_Response

Elimina voce di ora

ID operazione:

DeleteTimeEntry

Eliminare una voce di ora esistente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID voce ora	DAY_ENTRY_ID	True	string	ID della voce dell'ora

Ottenere informazioni sull'utente

ID operazione:

GetUser

Recuperare i dettagli di un utente in base all'ID utente o al messaggio di posta elettronica.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID utente o posta elettronica	USERID	True	string	ID utente o posta elettronica

Restituisce

Corpo

GetUserByID_Response

Ottenere l'immissione dell'ora in base all'ID

ID operazione:

GetTimeEntry

Ottiene una voce di ora esistente in base all'ID.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID voce ora	DAY_ENTRY_ID	True	string	ID della voce dell'ora

Restituisce

Corpo

UpdateTimeEntry_Response

Trigger

Quando viene aggiunto un client	Attiva quando viene aggiunto un nuovo client.
Quando viene aggiunto un contatto	Attiva quando viene aggiunto un nuovo contatto.
Quando viene aggiunto un utente	Attiva quando viene aggiunto un nuovo utente.
Quando viene creata una voce di ora per il giorno corrente	Attiva quando viene creata una nuova voce di ora per il giorno corrente.
Quando viene creata una voce di ora per la data	Attiva quando viene creata una nuova voce di ora per una data specifica.
Quando viene creato un progetto	Attiva quando viene creato un nuovo progetto.

Quando viene aggiunto un client

ID operazione:

TrigNewClient

Attiva quando viene aggiunto un nuovo client.

Restituisce

Nome	Percorso	Tipo	Descrizione
ID client	client.id	integer	Identificatore univoco del client.
Nome	client.name	string	Nome del client.
Valuta	client.currency	string	Valuta da usare per la fatturazione client.
Data aggiornata	client.updated_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data e ora create	client.created_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Address	client.address	string	Indirizzo del client.
Simbolo valuta	client.currency_symbol	string	Simbolo correlato alla valuta selezionata.
Dettagli	client.details	string	Dettagli aggiuntivi, normalmente usati per le informazioni sull'indirizzo.

Quando viene aggiunto un contatto

ID operazione:

TrigNewContact

Attiva quando viene aggiunto un nuovo contatto.

Restituisce

Nome	Percorso	Tipo	Descrizione
ID contatto	contact.id	integer	Identificatore univoco del contatto.
ID client	contact.client_id	integer	Identificatore univoco del client.
Nome di battesimo	contact.first_name	string	Nome del contatto.
Cognome	contact.last_name	string	Cognome del contatto.
Email	contact.email	string	Messaggio di posta elettronica del contatto.
Telefono ufficio	contact.phone_office	string	Telefono dell'ufficio del contatto.
Telefono cellulare	contact.phone_mobile	string	Telefono cellulare del contatto.
Fax	contact.fax	string	Fax del contatto.
Titolo	contact.title	string	Titolo del contatto.
Data e ora create	contact.created_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data aggiornata	contact.updated_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).

Quando viene aggiunto un utente

ID operazione:

TrigNewUser

Attiva quando viene aggiunto un nuovo utente.

Restituisce

Corpo

GetUserByID_Response

Quando viene creata una voce di ora per il giorno corrente

ID operazione:

TrigNewTimeEntryToday

Attiva quando viene creata una nuova voce di ora per il giorno corrente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Altro ID utente	of_user		string	ID dell'utente per cui controllare le voci relative all'ora. Il valore predefinito è l'ID.

Restituisce

Corpo

GetTimeEntriesForDay_Response

Quando viene creata una voce di ora per la data

ID operazione:

TrigNewTimeEntry

Attiva quando viene creata una nuova voce di ora per una data specifica.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Date	date	True	string	AAAA-MM-DD o formato ISO datetime
Altro ID utente	of_user		string	ID dell'utente per cui controllare le voci relative all'ora.

Restituisce

Corpo

GetTimeEntriesForDay_Response

Quando viene creato un progetto

ID operazione:

TrigNewProject

Attiva quando viene creato un nuovo progetto.

Restituisce

Nome	Percorso	Tipo	Descrizione
ID progetto	project.id	integer	Identificatore univoco del progetto.
ID client	project.client_id	integer	ID del client per il progetto.
Nome	project.name	string	Nome progetto.
Codice	project.code	string	Codice del progetto.
È attivo	project.active	boolean	True se il progetto è attualmente attivo.
Fatturabile	project.billable	boolean	True se il progetto è fatturabile.
Fattura per	project.bill_by	string	Metodo in base al quale viene fatturato il progetto.
Tariffa oraria	project.hourly_rate	float	Tariffa di fatturazione per ora.
Bilancio	project.budget	float	Valore preventivato per il progetto.
Budget per	project.budget_by	string	Metodo di budget per il progetto.
Data e ora create	project.created_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data aggiornata	project.updated_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data di inizio	project.starts_on	string	AAAA-MM-DD
Data di fine	project.ends_on	string	AAAA-MM-DD
Stima	project.estimate	float	Stima del progetto.
Stimato da	project.estimate_by	string	Metodo di stima per il progetto.
Data del record meno recente	project.hint_earliest_record_at	string	AAAA-MM-DD
Data record più recente	project.hint_latest_record_at	string	AAAA-MM-DD
Note	project.notes	string	Note del progetto.
Budget costi	project.cost_budget	float	Valore preventivato per i progetti Total Project Fee.
Il budget dei costi include le spese	project.cost_budget_include_expenses	boolean	Opzione per il budget dei progetti Total Project Fee per includere le spese rilevate.

Definizioni

ListAllContacts_Response

Nome	Percorso	Tipo	Descrizione
ID contatto	contact.id	integer	Identificatore univoco del contatto.
ID client	contact.client_id	integer	Identificatore univoco del client.
Nome di battesimo	contact.first_name	string	Nome del contatto.
Cognome	contact.last_name	string	Cognome del contatto.
Email	contact.email	string	Messaggio di posta elettronica del contatto.
Telefono ufficio	contact.phone_office	string	Telefono dell'ufficio del contatto.
Telefono cellulare	contact.phone_mobile	string	Telefono cellulare del contatto.
Fax	contact.fax	string	Fax del contatto.
Titolo	contact.title	string	Titolo del contatto.
Data e ora create	contact.created_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data aggiornata	contact.updated_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).

ListAllClients_Response

Nome	Percorso	Tipo	Descrizione
ID client	client.id	integer	Identificatore univoco del client.
Nome	client.name	string	Nome del client.
Valuta	client.currency	string	Valuta da usare per la fatturazione client.
Data aggiornata	client.updated_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data e ora create	client.created_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Address	client.address	string	Indirizzo del client.
Simbolo valuta	client.currency_symbol	string	Simbolo correlato alla valuta selezionata.
Dettagli	client.details	string	Dettagli aggiuntivi, normalmente usati per le informazioni sull'indirizzo.

UpdateTimeEntry_Response

Nome	Percorso	Tipo	Descrizione
ID voce ora	id	integer	Identificatore univoco della voce di ora.
ID utente	user_id	integer	Identificatore univoco dell'utente che ha creato la voce di ora.
Date	spent_at	string	Data di immissione dell'ora.
Data e ora create	created_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data aggiornata	updated_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
ID progetto	project_id	string	L'ID della voce dell'ora del progetto è associato.
ID attività	task_id	string	L'ID della voce dell'ora dell'attività è associato.
Progetto	project	string	Nome del progetto a cui è associata la voce temporale.
Task	task	string	Nome dell'attività a cui è associata la voce dell'ora.
Cliente	client	string	Nome del client a cui è associata la voce temporale.
Note	notes	string	Note relative alle voci temporali.
Ore senza timer	hours_without_timer	float	Intervallo di tempo corrente rilevato, se il timer non è in esecuzione.
Orario	hours	float	Numero di ore (decimali) rilevate in questa voce di tempo.

ListProjects_Response

Nome	Percorso	Tipo	Descrizione
ID progetto	project.id	integer	Identificatore univoco del progetto.
ID client	project.client_id	integer	ID del client per il progetto.
Nome	project.name	string	Nome progetto.
Codice	project.code	string	Codice del progetto.
È attivo	project.active	boolean	True se il progetto è attualmente attivo.
Fatturabile	project.billable	boolean	True se il progetto è fatturabile.
Fattura per	project.bill_by	string	Metodo in base al quale viene fatturato il progetto.
Tariffa oraria	project.hourly_rate	float	Tariffa di fatturazione per ora.
Bilancio	project.budget	float	Valore preventivato per il progetto.
Budget per	project.budget_by	string	Metodo di budget per il progetto.
Data e ora create	project.created_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data aggiornata	project.updated_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data di inizio	project.starts_on	string	AAAA-MM-DD
Data di fine	project.ends_on	string	AAAA-MM-DD
Stima	project.estimate	float	Stima del progetto.
Stimato da	project.estimate_by	string	Metodo di stima per il progetto.
Data del record meno recente	project.hint_earliest_record_at	string	AAAA-MM-DD
Data record più recente	project.hint_latest_record_at	string	AAAA-MM-DD
Note	project.notes	string	Note del progetto.
Budget costi	project.cost_budget	float	Valore preventivato per i progetti Total Project Fee.
Il budget dei costi include le spese	project.cost_budget_include_expenses	boolean	Opzione per il budget dei progetti Total Project Fee per includere le spese rilevate.

ListTasks_Response

Nome	Percorso	Tipo	Descrizione
ID attività	task.id	integer	Identificatore univoco dell'attività.
Nome	task.name	string	Nome attività.
interno	task.billable_by_default	boolean
Data e ora create	task.created_at	date-time	AAAA-MM-GGThh:mm:ssZ (UTC).
Data aggiornata	task.updated_at	date-time	AAAA-MM-GGThh:mm:ssZ (UTC).
Tariffa oraria predefinita	task.default_hourly_rate	float	Frequenza predefinita per l'attività.

GetUserByID_Response

Nome	Percorso	Tipo	Descrizione
ID utente	user.id	integer	Identificatore univoco dell'utente.
Email	user.email	string	Posta elettronica dell'utente.
Data e ora create	user.created_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Amministratore	user.is_admin	boolean	True se l'utente è un amministratore.
Nome di battesimo	user.first_name	string	Nome dell'utente.
Cognome	user.last_name	string	Cognome dell'utente.
Terzista	user.is_contractor	boolean	True se l'utente è un terzista.
Telefono	user.telephone	string	Telefono dell'utente.
È attivo	user.is_active	boolean	True se l'utente è attualmente attivo.
Tariffa oraria	user.default_hourly_rate	float	Tariffa oraria dell'utente
Reparto	user.department	string	Nome del reparto in cui lavora l'utente.
Newsletter	user.wants_newsletter	boolean	True se l'utente vuole iscriversi alla newsletter.
Tasso di costo	user.cost_rate	float	Tariffa dei costi dell'utente.
Capacità settimanale	user.weekly_capacity	integer	Capacità settimanale dell'utente.

GetTimeEntriesForDay_Response

Nome	Percorso	Tipo	Descrizione
day_entries	day_entries	array of object	day_entries
ID progetto	day_entries.project_id	string	Identificatore univoco del porject.
Nome progetto	day_entries.project	string	Nome del progetto.
ID utente	day_entries.user_id	integer	Identificatore univoco dell'utente.
Date	day_entries.spent_at	string	AAAA-MM-DD
ID attività	day_entries.task_id	string	ID dell'attività a cui è associata la voce dell'ora.
Task	day_entries.task	string	Nome dell'attività a cui è associata la voce dell'ora.
Cliente	day_entries.client	string	Nome del client a cui è associata la voce temporale.
ID voce ora	day_entries.id	integer	Identificatore univoco della voce di ora.
Note	day_entries.notes	string	Note relative alle voci temporali.
Data e ora di inizio	day_entries.started_at	string	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data/ora di fine	day_entries.ended_at	string	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data e ora create	day_entries.created_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Data aggiornata	day_entries.updated_at	date-time	AAAA-MM-GGThh:mm:ssZ (formato UTC).
Ore senza timer	day_entries.hours_without_timer	float	Intervallo di tempo corrente rilevato, se il timer non è in esecuzione.
Orario	day_entries.hours	float	Numero di ore (decimali) rilevate in questa voce di tempo.