Hasat

Hasat, ekibinizin her proje ve görevde harcadığı zamanı izlemeye yardımcı olan basit bir araçtır.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Bölgeler
Copilot Studio	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - ABD Kamu (GCC)      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri :      - Azure Kamu bölgeleri      - Azure Çin bölgeleri      - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Aşağıdakiler dışında tüm Power Apps bölgeleri :      - ABD Kamu (GCC)      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)
Power Automate	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - ABD Kamu (GCC)      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)

İletişim
İsim	Microsoft
URL	Microsoft LogicApps Desteği Microsoft Power Automate Desteği Microsoft Power Apps Desteği

Bağlayıcı Meta Verileri
Publisher	Microsoft
Web sitesi	https://www.getharvest.com/
Gizlilik ilkesi	https://www.getharvest.com/privacy-policy

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	100	60 saniye
Tetikleyici yoklamalarının sıklığı	1	60 saniye

Eylemler

Görevleri listeleme	Tüm görevlerin listesini alır.
Güncelleştirme zamanı girdisi	Var olan bir zaman girdisini güncelleştirin.
Kimliğine göre saat girdisi alma	Kimliğine göre var olan bir zaman girdisi alın.
Kullanıcı bilgilerini alma	Kullanıcının ayrıntılarını kullanıcı kimliğine veya e-postaya göre alın.
Projeleri listeleme	Geçerli kullanıcı için tüm projeleri listeler.
Projeye kullanıcı ekleme	Var olan bir kullanıcıyı projeye ekleme.
Saat girdisi oluşturma	Yeni bir saat girişi oluşturun.
Silme zamanı girdisi	Var olan bir zaman girdisi silin.
Tüm istemcileri listeleme	Kimliği doğrulanmış hesap için tüm istemcilerin listesini alır.
Tüm kişileri listeleme	Kimliği doğrulanmış kullanıcının tüm kişilerinin listesini alır.
Yeni istemci ekleme	Yeni bir istemci oluşturun.
Yeni kişi ekleme	Yeni bir kişi oluşturun.
Yeni kullanıcı ekle	Yeni bir kullanıcı oluşturun.

Görevleri listeleme

İşlem Kimliği:

ListTasks

Tüm görevlerin listesini alır.

Döndürülenler

Eşya

ListTasks_Response

Güncelleştirme zamanı girdisi

İşlem Kimliği:

UpdateTimeEntry

Var olan bir zaman girdisini güncelleştirin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Saat Girişi Kimliği	DAY_ENTRY_ID	True	string	Zaman girişinin kimliği
Proje Kimliği	project_id	True	string	Project
Görev Kimliği	task_id	True	string	Görev
Notes	notes		string
Başlangıç tarihi-saati	started_at		string	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Bitiş tarihi-saati	ended_at		string	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Date	spent_at		string	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).

Döndürülenler

Body

UpdateTimeEntry_Response

Kimliğine göre saat girdisi alma

İşlem Kimliği:

GetTimeEntry

Kimliğine göre var olan bir zaman girdisi alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Saat Girişi Kimliği	DAY_ENTRY_ID	True	string	Zaman girişinin kimliği

Döndürülenler

Body

UpdateTimeEntry_Response

Kullanıcı bilgilerini alma

İşlem Kimliği:

GetUser

Kullanıcının ayrıntılarını kullanıcı kimliğine veya e-postaya göre alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kullanıcı kimliği veya e-posta	USERID	True	string	Kullanıcı kimliği veya e-posta

Döndürülenler

Body

GetUserByID_Response

Projeleri listeleme

İşlem Kimliği:

ListProjects

Geçerli kullanıcı için tüm projeleri listeler.

Döndürülenler

Eşya

ListProjects_Response

Projeye kullanıcı ekleme

İşlem Kimliği:

AddUserToProject

Var olan bir kullanıcıyı projeye ekleme.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Proje Kimliği	project_id	True	string	Proje Kimliği
Kullanıcı Kimliği	id	True	integer	User

Saat girdisi oluşturma

İşlem Kimliği:

CreateTimeEntry

Yeni bir saat girişi oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Notlar	notes		string
hours	hours		integer
Proje Kimliği	project_id	True	string	Project
Görev Kimliği	task_id	True	string	Görev
Date	spent_at		string	Harcanan yer

Döndürülenler

Body

UpdateTimeEntry_Response

Silme zamanı girdisi

İşlem Kimliği:

DeleteTimeEntry

Var olan bir zaman girdisi silin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Saat Girişi Kimliği	DAY_ENTRY_ID	True	string	Zaman girişinin kimliği

Tüm istemcileri listeleme

İşlem Kimliği:

ListAllClients

Kimliği doğrulanmış hesap için tüm istemcilerin listesini alır.

Döndürülenler

Eşya

ListAllClients_Response

Tüm kişileri listeleme

İşlem Kimliği:

ListAllContacts

Kimliği doğrulanmış kullanıcının tüm kişilerinin listesini alır.

Döndürülenler

Eşya

ListAllContacts_Response

Yeni istemci ekleme

İşlem Kimliği:

AddNewClient

Yeni bir istemci oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İsim	name	True	string	İstemcinin adı
Para birimi	currency		string	İstemci için kullanmak istediğiniz para birimi.
Para birimi simgesi	currency_symbol		string	Seçili para birimiyle bağıntılı olan simge.
Ayrıntılar	details		string	Normalde adres bilgileri için kullanılan ek ayrıntılar.

Yeni kişi ekleme

İşlem Kimliği:

AddNewContact

Yeni bir kişi oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
İstemci kimliği	client_id	True	integer	İstemcinin benzersiz tanımlayıcısı.
İsim	first_name	True	string	Kişinin adı.
Soyadı	last_name	True	string	Kişinin soyadı.
E-posta	email		string	Kişinin e-posta adresi.
Ofis telefonu	phone_office		string	Kişinin ofis telefonu.
Cep telefonu	phone_mobile		string	Kişinin cep telefonu.
Faks	fax		string	Kişinin faksı.
Başlık	title		string	Kişinin başlığı.

Yeni kullanıcı ekle

İşlem Kimliği:

CreateUser

Yeni bir kullanıcı oluşturun.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
E-posta	email	True	string
Yöneticidir	is_admin		boolean
İsim	first_name	True	string
Soyadı	last_name	True	string
Yüklenicidir	is_contractor		boolean
Telefon	telephone		string
Saatlik fiyat	default_hourly_rate		float	Varsayılan saatlik fiyat.
Departman	department		string
Maliyet oranı	cost_rate		float

Tetikleyiciler

Geçerli gün için bir saat girişi oluşturulduğunda	Geçerli gün için yeni bir saat girişi oluşturulduğunda tetikler.
İstemci eklendiğinde	Yeni bir istemci eklendiğinde tetikler.
Kişi eklendiğinde	Yeni bir kişi eklendiğinde tetikler.
Kullanıcı eklendiğinde	Yeni kullanıcı eklendiğinde tetikler.
Proje oluşturulduğunda	Yeni bir proje oluşturulduğunda tetikler.
Tarih için bir saat girişi oluşturulduğunda	Belirli bir tarih için yeni bir saat girişi oluşturulduğunda tetikler.

Geçerli gün için bir saat girişi oluşturulduğunda

İşlem Kimliği:

TrigNewTimeEntryToday

Geçerli gün için yeni bir saat girişi oluşturulduğunda tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Diğer Kullanıcı Kimliği	of_user		string	Zaman girdilerinin denetlenecek kullanıcı kimliği. Varsayılan olarak kimliğinizi kullanır.

Döndürülenler

Body

GetTimeEntriesForDay_Response

İstemci eklendiğinde

İşlem Kimliği:

TrigNewClient

Yeni bir istemci eklendiğinde tetikler.

Döndürülenler

Name	Yol	Tür	Description
İstemci kimliği	client.id	integer	İstemcinin benzersiz tanımlayıcısı.
İsim	client.name	string	İstemcinin adı.
Para birimi	client.currency	string	İstemci faturalaması için kullanılacak para birimi.
Güncelleştirilmiş tarih-saat	client.updated_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Tarih-saat oluşturuldu	client.created_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Adres	client.address	string	İstemcinin adresi.
Para birimi simgesi	client.currency_symbol	string	Seçili para birimiyle bağıntılı olan simge.
Ayrıntılar	client.details	string	Normalde adres bilgileri için kullanılan ek ayrıntılar.

Kişi eklendiğinde

İşlem Kimliği:

TrigNewContact

Yeni bir kişi eklendiğinde tetikler.

Döndürülenler

Name	Yol	Tür	Description
Kişi kimliği	contact.id	integer	Kişinin benzersiz tanımlayıcısı.
İstemci kimliği	contact.client_id	integer	İstemcinin benzersiz tanımlayıcısı.
İsim	contact.first_name	string	Kişinin adı.
Soyadı	contact.last_name	string	Kişinin soyadı.
E-posta	contact.email	string	Kişinin e-posta adresi.
Ofis telefonu	contact.phone_office	string	Kişinin ofis telefonu.
Cep telefonu	contact.phone_mobile	string	Kişinin cep telefonu.
Faks	contact.fax	string	Kişinin faksı.
Başlık	contact.title	string	Kişinin başlığı.
Tarih-saat oluşturuldu	contact.created_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Güncelleştirilmiş tarih-saat	contact.updated_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).

Kullanıcı eklendiğinde

İşlem Kimliği:

TrigNewUser

Yeni kullanıcı eklendiğinde tetikler.

Döndürülenler

Body

GetUserByID_Response

Proje oluşturulduğunda

İşlem Kimliği:

TrigNewProject

Yeni bir proje oluşturulduğunda tetikler.

Döndürülenler

Name	Yol	Tür	Description
Proje kimliği	project.id	integer	Projenin benzersiz tanımlayıcısı.
İstemci kimliği	project.client_id	integer	Proje için istemci kimliği.
İsim	project.name	string	Proje adı.
Kod	project.code	string	Proje kodu.
Etkin	project.active	boolean	Proje şu anda etkinse True.
Faturalanabilir	project.billable	boolean	Proje faturalanabilirse true.
Fatura ölçütü	project.bill_by	string	Projenin faturalandığı yöntem.
Saatlik fiyat	project.hourly_rate	float	Saate göre faturalama ücreti.
Bütçe	project.budget	float	Proje için bütçe değeri.
Bütçe ölçütü	project.budget_by	string	Proje için bütçeleme yöntemi.
Tarih-saat oluşturuldu	project.created_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Güncelleştirilmiş tarih-saat	project.updated_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Başlangıç tarihi	project.starts_on	string	YYYY-MM-DD
Bitiş tarihi	project.ends_on	string	YYYY-MM-DD
Tahmin	project.estimate	float	Proje tahmini.
Tahmini	project.estimate_by	string	Proje için tahmin yöntemi.
En erken kayıt tarihi	project.hint_earliest_record_at	string	YYYY-MM-DD
En son kayıt tarihi	project.hint_latest_record_at	string	YYYY-MM-DD
Notes	project.notes	string	Proje notları.
Maliyet bütçesi	project.cost_budget	float	Toplam Proje Ücretleri projeleri için bütçe değeri.
Maliyet bütçesi giderleri içerir	project.cost_budget_include_expenses	boolean	İzlenen giderleri dahil etmek için Toplam Proje Ücretleri projelerinin bütçe seçeneği.

Tarih için bir saat girişi oluşturulduğunda

İşlem Kimliği:

TrigNewTimeEntry

Belirli bir tarih için yeni bir saat girişi oluşturulduğunda tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Date	date	True	string	YYYY-MM-DD veya ISO biçimi datetime
Diğer Kullanıcı Kimliği	of_user		string	Zaman girdilerinin denetlenecek kullanıcı kimliği.

Döndürülenler

Body

GetTimeEntriesForDay_Response

Tanımlar

ListAllContacts_Response

Name	Yol	Tür	Description
Kişi kimliği	contact.id	integer	Kişinin benzersiz tanımlayıcısı.
İstemci kimliği	contact.client_id	integer	İstemcinin benzersiz tanımlayıcısı.
İsim	contact.first_name	string	Kişinin adı.
Soyadı	contact.last_name	string	Kişinin soyadı.
E-posta	contact.email	string	Kişinin e-posta adresi.
Ofis telefonu	contact.phone_office	string	Kişinin ofis telefonu.
Cep telefonu	contact.phone_mobile	string	Kişinin cep telefonu.
Faks	contact.fax	string	Kişinin faksı.
Başlık	contact.title	string	Kişinin başlığı.
Tarih-saat oluşturuldu	contact.created_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Güncelleştirilmiş tarih-saat	contact.updated_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).

ListAllClients_Response

Name	Yol	Tür	Description
İstemci kimliği	client.id	integer	İstemcinin benzersiz tanımlayıcısı.
İsim	client.name	string	İstemcinin adı.
Para birimi	client.currency	string	İstemci faturalaması için kullanılacak para birimi.
Güncelleştirilmiş tarih-saat	client.updated_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Tarih-saat oluşturuldu	client.created_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Adres	client.address	string	İstemcinin adresi.
Para birimi simgesi	client.currency_symbol	string	Seçili para birimiyle bağıntılı olan simge.
Ayrıntılar	client.details	string	Normalde adres bilgileri için kullanılan ek ayrıntılar.

UpdateTimeEntry_Response

Name	Yol	Tür	Description
Saat girişi kimliği	id	integer	Zaman girişinin benzersiz tanımlayıcısı.
Kullanıcı kimliği	user_id	integer	Zaman girdisini oluşturan kullanıcının benzersiz tanımlayıcısı.
Date	spent_at	string	Saat girişi tarihi.
Tarih-saat oluşturuldu	created_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Güncelleştirilmiş tarih-saat	updated_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Proje kimliği	project_id	string	Proje zamanı girdisinin ilişkili olduğu kimlik.
Görev kimliği	task_id	string	Görev zamanı girdisinin ilişkili olduğu kimlik.
Project	project	string	Zaman girdisinin ilişkili olduğu projenin adı.
Görev	task	string	Zaman girdisinin ilişkilendirildiğinde görevin adı.
Müşteri	client	string	Zaman girdisinin ilişkilendirildiğinde istemcinin adı.
Notes	notes	string	Saat giriş notları.
Zamanlayıcı olmadan saatler	hours_without_timer	float	Süreölçer çalışmıyorsa, izlenen geçerli süre miktarı.
Hours	hours	float	Bu zaman girdisinde izlenen saat sayısı (ondalık saat).

ListProjects_Response

Name	Yol	Tür	Description
Proje kimliği	project.id	integer	Projenin benzersiz tanımlayıcısı.
İstemci kimliği	project.client_id	integer	Proje için istemci kimliği.
İsim	project.name	string	Proje adı.
Kod	project.code	string	Proje kodu.
Etkin	project.active	boolean	Proje şu anda etkinse True.
Faturalanabilir	project.billable	boolean	Proje faturalanabilirse true.
Fatura ölçütü	project.bill_by	string	Projenin faturalandığı yöntem.
Saatlik fiyat	project.hourly_rate	float	Saate göre faturalama ücreti.
Bütçe	project.budget	float	Proje için bütçe değeri.
Bütçe ölçütü	project.budget_by	string	Proje için bütçeleme yöntemi.
Tarih-saat oluşturuldu	project.created_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Güncelleştirilmiş tarih-saat	project.updated_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Başlangıç tarihi	project.starts_on	string	YYYY-MM-DD
Bitiş tarihi	project.ends_on	string	YYYY-MM-DD
Tahmin	project.estimate	float	Proje tahmini.
Tahmini	project.estimate_by	string	Proje için tahmin yöntemi.
En erken kayıt tarihi	project.hint_earliest_record_at	string	YYYY-MM-DD
En son kayıt tarihi	project.hint_latest_record_at	string	YYYY-MM-DD
Notes	project.notes	string	Proje notları.
Maliyet bütçesi	project.cost_budget	float	Toplam Proje Ücretleri projeleri için bütçe değeri.
Maliyet bütçesi giderleri içerir	project.cost_budget_include_expenses	boolean	İzlenen giderleri dahil etmek için Toplam Proje Ücretleri projelerinin bütçe seçeneği.

ListTasks_Response

Name	Yol	Tür	Description
Görev kimliği	task.id	integer	Görevin benzersiz tanımlayıcısı.
İsim	task.name	string	Görev adı.
dahili	task.billable_by_default	boolean
Tarih-saat oluşturuldu	task.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC).
Güncelleştirilmiş tarih-saat	task.updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC).
Varsayılan saatlik fiyat	task.default_hourly_rate	float	Görev için varsayılan oran.

GetUserByID_Response

Name	Yol	Tür	Description
Kullanıcı kimliği	user.id	integer	Kullanıcının benzersiz tanımlayıcısı.
E-posta	user.email	string	Kullanıcının e-posta adresi.
Tarih-saat oluşturuldu	user.created_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Yöneticidir	user.is_admin	boolean	Kullanıcı bir yöneticiyse true.
İsim	user.first_name	string	Kullanıcının adı.
Soyadı	user.last_name	string	Kullanıcının soyadı.
Yüklenicidir	user.is_contractor	boolean	Kullanıcı bir yükleniciyse true.
Telefon	user.telephone	string	Kullanıcının telefonu.
Etkin	user.is_active	boolean	Kullanıcı şu anda etkinse true.
Saatlik fiyat	user.default_hourly_rate	float	Kullanıcının saatlik ücreti
Departman	user.department	string	Kullanıcının çalıştığı bölüm adı.
Bülten aboneliği	user.wants_newsletter	boolean	Kullanıcı bültene abone olmak istiyorsa true.
Maliyet oranı	user.cost_rate	float	Kullanıcının maliyet fiyatı.
Haftalık kapasite	user.weekly_capacity	integer	Kullanıcının haftalık kapasitesi.

GetTimeEntriesForDay_Response

Name	Yol	Tür	Description
day_entries	day_entries	array of object	day_entries
Proje kimliği	day_entries.project_id	string	Porject'in benzersiz tanımlayıcısı.
Proje adı	day_entries.project	string	Projenin adı.
Kullanıcı kimliği	day_entries.user_id	integer	Kullanıcının benzersiz tanımlayıcısı.
Date	day_entries.spent_at	string	YYYY-MM-DD
Görev kimliği	day_entries.task_id	string	Zaman girdisinin ilişkili olduğu görevin kimliği.
Görev	day_entries.task	string	Zaman girdisinin ilişkilendirildiğinde görevin adı.
Müşteri	day_entries.client	string	Zaman girdisinin ilişkilendirildiğinde istemcinin adı.
Saat girişi kimliği	day_entries.id	integer	Zaman girişinin benzersiz tanımlayıcısı.
Notes	day_entries.notes	string	Saat giriş notları.
Başlangıç tarihi-saati	day_entries.started_at	string	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Bitiş tarihi-saati	day_entries.ended_at	string	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Tarih-saat oluşturuldu	day_entries.created_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Güncelleştirilmiş tarih-saat	day_entries.updated_at	date-time	YYYY-AA-GGThh:mm:ssZ (UTC biçimi).
Zamanlayıcı olmadan saatler	day_entries.hours_without_timer	float	Süreölçer çalışmıyorsa, izlenen geçerli süre miktarı.
Hours	day_entries.hours	float	Bu zaman girdisinde izlenen saat sayısı (ondalık saat).