FreshBooks (Önizleme)

FreshBooks, bulut tabanlı bir küçük işletme muhasebe yazılımıdır. Faturaları gönderin, zamanı izleyin, makbuzları ve giderleri yönetin.

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.freshbooks.com/
Gizlilik ilkesi https://www.freshbooks.com/policies/privacy

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

Giderleri güncelleştirme

Bu işlem, hesabınızdaki mevcut bir gideri güncelleştirmek için kullanılır.

Giderleri listeleme

Tüm giderlerinizin listesini alır.

Giderleri sil

Bu işlem, mevcut bir gideri hesabınızdan silmek için kullanılır.

Yeni gider oluştur

Bu işlem hesabınızda yeni bir gider oluşturur.

Yeni istemci ekleme

Bu işlem hesabınızda yeni bir istemci oluşturur. İstemcinin en az bir alanı (ad, soyadı, kuruluş, e-posta vb.) belirtilmelidir, aksi takdirde işlem başarısız olur.

Giderleri güncelleştirme

Bu işlem, hesabınızdaki mevcut bir gideri güncelleştirmek için kullanılır.

Parametreler

Name Anahtar Gerekli Tür Description
Firma
accountid True string

Gider hesabının kimliği.

Gider Kimliği
expenseid True string

Giderin benzersiz kimliği.

Miktar
amount string
Para birimi
code string

3 harfli para birimi kodu.

Kategori
categoryid integer

Bir gider kategorisi seçin.

Personel
staffid integer

Gider için personel üyesini seçin.

Date
date string

YYYY-MM-DD veya ISO biçiminde datetime.

Satıcı
vendor string

Gider için bir satıcı seçin.

Notes
notes string

Giderleri listeleme

Tüm giderlerinizin listesini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Firma
accountid True string

Gider hesabının kimliği.

Döndürülenler

Gider dizisi.

Eşya
ExpenseList

Giderleri sil

Bu işlem, mevcut bir gideri hesabınızdan silmek için kullanılır.

Parametreler

Name Anahtar Gerekli Tür Description
Firma
accountid True string

Gider hesabının kimliği.

Gider Kimliği
expenseid True string

Giderin benzersiz kimliği.

Yeni gider oluştur

Bu işlem hesabınızda yeni bir gider oluşturur.

Parametreler

Name Anahtar Gerekli Tür Description
Firma
accountid True string

Gider hesabının kimliği.

Miktar
amount True string
Para birimi
code string

3 harfli para birimi kodu.

Kategori
categoryid True integer

Bir gider kategorisi seçin.

Personel
staffid True integer

Gider için personel üyesini seçin.

Date
date True string

YYYY-MM-DD veya ISO biçiminde datetime.

Satıcı
vendor string

Gider için bir satıcı seçin.

Notes
notes string

Döndürülenler

Body
Expense

Yeni istemci ekleme

Bu işlem hesabınızda yeni bir istemci oluşturur. İstemcinin en az bir alanı (ad, soyadı, kuruluş, e-posta vb.) belirtilmelidir, aksi takdirde işlem başarısız olur.

Parametreler

Name Anahtar Gerekli Tür Description
Firma
accountid True string

Gider hesabının kimliği.

İlk İsim
fname string
Soyadı
lname string
Organizasyon
organization string
E-posta Adresi
email string
Telefon Numarası
bus_phone string
Para birimi
currency_code string

3 harfli para birimi kodu.

Sokak Adresi 1
p_street string
Sokak Adresi 2
p_street2 string
City
p_city string
Posta Kodu
p_code string
Country
p_country string
İl
p_province string

Döndürülenler

Body
Client

Tetikleyiciler

Fatura oluşturulduğunda veya güncelleştirildiğinde

Yeni bir fatura oluşturulduğunda veya mevcut bir fatura güncelleştirildiğinde tetikler.

Gider oluşturulduğunda veya güncelleştirildiğinde

Yeni bir gider oluşturulduğunda veya mevcut bir gider güncelleştirildiğinde tetikler.

Ödeme kaydedildiğinde veya güncelleştirildiğinde

Yeni bir ödeme kaydedildiğinde veya mevcut bir ödeme güncelleştirildiğinde tetikler.

Fatura oluşturulduğunda veya güncelleştirildiğinde

Yeni bir fatura oluşturulduğunda veya mevcut bir fatura güncelleştirildiğinde tetikler.

Parametreler

Name Anahtar Gerekli Tür Description
Firma
accountid True string

Gider hesabının kimliği.

Döndürülenler

Body
Invoice

Gider oluşturulduğunda veya güncelleştirildiğinde

Yeni bir gider oluşturulduğunda veya mevcut bir gider güncelleştirildiğinde tetikler.

Parametreler

Name Anahtar Gerekli Tür Description
Firma
accountid True string

Gider hesabının kimliği.

Döndürülenler

Body
Expense

Ödeme kaydedildiğinde veya güncelleştirildiğinde

Yeni bir ödeme kaydedildiğinde veya mevcut bir ödeme güncelleştirildiğinde tetikler.

Parametreler

Name Anahtar Gerekli Tür Description
Firma
accountid True string

Gider hesabının kimliği.

Döndürülenler

Body
Payment

Tanımlar

ExpenseList

Gider dizisi.

Name Yol Tür Description
Eşya
Expense

Gider

Name Yol Tür Description
Gider Kimliği
id integer

Gider için bu iş kimliğine özgü.

kar payı yüzdesi
markup_percent string

Ondalık, giderleri işaretlemek için yüzde.

Proje Kimliği
projectid integer

Varsa ilgili projenin kimliği.

İstemci Kimliği
clientid integer

Varsa, ilgili istemcinin kimliği.

Vergi Yüzdesi 1
taxPercent1 string

Ondalık, ilk vergi yüzdesi.

Vergi Adı 1
taxName1 string

İlk verginin adı.

İlk görev tutarı
taxAmount1.amount string

İlk vergi tutarı.

İlk vergi para birimi kodu
taxAmount1.code string

3 harfli para birimi kodu.

Vergi Yüzdesi 2
taxPercent2 string

Ondalık, ikinci vergi yüzdesi.

Vergi Adı 2
taxName2 string

İkinci verginin adı.

İkinci vergi tutarı
taxAmount2.amount string

İkinci vergi tutarı.

İkinci vergi para birimi kodu
taxAmount2.code string

3 harfli para birimi kodu.

Fatura Kimliği
invoiceid integer

Varsa ilgili faturanın kimliği.

Statü
status integer

Gider durumu tablosundaki değer.

Banka Adı
bank_name string

Varsa, banka giderinin adı kaynağından içeri aktarıldı.

Satıcı
vendor string

Satıcının adı.

Alındı Bilgisi Var
has_receipt boolean

Makbuz ekliyse true.

Dış Sistem Kimliği
ext_systemid integer

Varsa ilgili yüklenici sisteminin kimliği.

Date
date string

Giderin tarihi.

İşlem Kimliği
transactionid string

Varsa ilgili işlemin kimliği.

Notes
notes string

Gider notları.

Hesap Adı
account_name string

Varsa ilgili hesabın adı.

Miktar
amount.amount string

Ondalık değer.

Para Birimi Kodu
amount.code string

3 harfli para birimi kodu.

Bileşik Vergi
compounded_tax boolean

2. vergi bileşik bir vergiyse doğrudur.

Hesap Kimliği
accountid string

Varsa gider hesabının kimliği.

Invoice

Name Yol Tür Description
Fatura kimliği
id integer

Bu sisteme benzersiz fatura kimliği.

Fatura Numarası
invoice_number string

Kullanıcı tarafından belirtilen ve görünür fatura kimliği.

Hesap Kimliği
accountid string

Sistem için benzersiz kimlik.

3 harfli para birimi kodu
currency_code string

Fatura için üç harfli para birimi kodu.

Fatura durumu
v3_status string

Fatura durumu.

Description
description string

Faturanın ilk satırının açıklaması.

Notes
notes string

Faturada listelenen notlar.

İki harfli dil kodu
language string

Faturanın iki harfli dil kodu.

Müşteri Kimliği
customerid integer

Bu sisteme benzersiz istemci kimliği.

Faturalanan kuruluş
organization string

Faturalanan kuruluşun adı.

Müşteri Adı
fname string

Faturadaki istemcinin adı.

Müşteri Soyadı
lname string

Faturadaki istemcinin soyadı.

Fatura oluşturma tarihi
create_date string

Faturanın oluşturulduğu tarih, YYYY-MM-DD biçimi.

Fatura son tarihi
due_date string

Faturanın son tarihi, YYYY-MM-DD biçimi olarak işaretlenir.

Son Güncelleştirme
updated string

Zaman faturası son güncelleştirildi, YYYY-MM-DD SS:AA:SS biçimi.

Tarih Oluştur
created_at string

Saat faturası oluşturuldu, YYYY-MM-DD SS:AA:SS biçimi.

Fatura ödeme tarihi
date_paid string

Faturanın tam olarak ödendiği tarih, YYYY-MM-DD biçimi.

Ödeme Durumu
payment_status string

Ödeme durumunun açıklaması. 'ödenmemiş', 'kısmi', 'ücretli' ve 'otomatik ödemeli'lerden biri.

Fatura Tutarı
amount.amount string

İki ondalık basamak olan toplam fatura tutarı.

Ödenen Tutar
paid.amount string

Faturada iki ondalık basamak için ödenen tutar.

Kalan Tutar
outstanding.amount string

Faturada kalan tutar, iki ondalık basamaktır.

İndirim Tutarı
discount.amount string

İki ondalık basameğe kadar olan indirim miktarı.

E-posta
client.email string

İstemcinin e-posta adresi.

Ödeme

Name Yol Tür Description
Ödeme Kimliği
id integer

Bu sisteme benzersiz ödeme kimliği.

Ödeme Türü
type string

Ödeme türü - Nakit, çek, kredi

Uyarı
note string

Ödemede listelenen notlar.

Ödeme tarihi
date string

Ödemenin yapıldığı tarih, YYYY-MM-DD biçimi.

Müşteri Kimliği
clientid integer

Bu sisteme benzersiz istemci kimliği.

Fatura Tutarı
amount.amount string

İki ondalık basameğe kadar ödemenin toplam tutarı.

3 harfli para birimi kodu
amount.code string

Üç harfli para birimi kodu.

Hesap Kimliği
accounting_systemid string

İş için benzersiz kimlik.

Fatura kimliği
invoiceid integer

İlgili faturanın kimliği.

İlk İsim
client.fname string

İstemcinin adı.

Soyadı
client.lname string

İstemcinin soyadı.

E-posta
client.email string

İstemcinin e-posta adresi.

Kullanıcı adı
client.username string

İstemci tarafından oturum açmak için kullanılan kullanıcı adı.

Organizasyon
client.organization string

Müşterinin işinin adı.

Müşteri

Name Yol Tür Description
İlk İsim
response.result.client.fname string

İstemcinin adı.

Soyadı
response.result.client.lname string

İstemcinin soyadı.

Sk Numarası
response.result.client.fax string

İstemcinin faks numarası.

KDV Numarası
response.result.client.vat_number string

Katma değer vergi numarası.

KDV Adı
response.result.client.vat_name string

Katma değer vergisi adı.

İstemci Kimliği
response.result.client.id integer

İstemci için bu iş kimliğine özgü.

İl
response.result.client.s_province string

Sevkiyat adresi.

Country
response.result.client.s_country string

Sevkiyat adresi.

City
response.result.client.s_city string

Sevkiyat adresi.

Sokak
response.result.client.s_street string

Sevkiyat adresi.

Cadde 2
response.result.client.s_street2 string

Sevkiyat adresi.

Posta Kodu
response.result.client.s_code string

Sevkiyat adresi.

Uyarı
response.result.client.note string

Yönetici tarafından istemci hakkında tutulan notlar.

Cep Telefonu
response.result.client.mob_phone string

Cep telefonu numarası.

Ev Telefonu
response.result.client.home_phone string

Ev telefon numarası.

Şirket Sektörü
response.result.client.company_industry string

Sektör istemcisinin açıklaması içindedir.

E-posta
response.result.client.email string

İstemcinin e-posta adresi.

Kullanıcı adı
response.result.client.username string

İstemci tarafından oturum açmak için kullanılan kullanıcı adı.

İl
response.result.client.p_province string

Fatura adresi.

Country
response.result.client.p_country string

Fatura adresi.

City
response.result.client.p_city string

Fatura adresi.

Sokak
response.result.client.p_street string

Fatura adresi.

Posta Kodu
response.result.client.p_code string

Fatura adresi.

Cadde 2
response.result.client.p_street2 string

Fatura adresi.

Telefon
response.result.client.bus_phone string

Fatura adresi.

Boyut
response.result.client.company_size string

Fatura adresi.

Sistem Kimliği
response.result.client.accounting_systemid string

İş istemcisinin benzersiz tanımlayıcısı üzerinde var.

Language
response.result.client.language string

Kullanıcı dilini gösteren kısa kod.

Organizasyon
response.result.client.organization string

müşterinin işinin adı.

Para Birimi Kodu
response.result.client.currency_code string

Tercih edilen para birimi için 3 harfli kısa kod.