共用方式為

FreshBooks （預覽版）

FreshBooks 是一款基於雲的小型企業會計軟件。 發送發票、跟踪時間、管理收據和費用。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 Microsoft
URL Microsoft LogicApps 支援
Microsoft Power Automate 支援
Microsoft Power Apps 支援
連接器中繼資料
Publisher Microsoft
網站 https://www.freshbooks.com/
隱私策略 https://www.freshbooks.com/policies/privacy

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒
觸發輪詢的頻率 1 60 秒

動作

列出費用

檢索您所有費用的清單。
刪除費用

此作業可用來從您的帳戶中刪除現有費用。
建立新費用

此作業會在您的帳戶中建立新的費用。
新增客戶端

此作業會在您的帳戶中建立新用戶端。 必須指定用戶端的至少一個欄位（即名字、姓氏、組織、電子郵件等），否則操作將失敗。
更新費用

此作業用於更新您帳戶中的現有費用。

列出費用

作業識別碼：
ListExpenses

檢索您所有費用的清單。

參數

名稱 機碼 必要 類型 Description
Account
 accountid True string

費用帳戶的 ID。

傳回

一系列費用。

物品
ExpenseList

刪除費用

作業識別碼：
DeleteExpense

此作業可用來從您的帳戶中刪除現有費用。

參數

名稱 機碼 必要 類型 Description
Account
 accountid True string

費用帳戶的 ID。
費用識別碼
 expenseid True string

費用的唯一 ID。

建立新費用

作業識別碼：
AddExpense

此作業會在您的帳戶中建立新的費用。

參數

名稱 機碼 必要 類型 Description
Account
 accountid True string

費用帳戶的 ID。
總數
 amount True string
貨幣
 code string

3 個字母的貨幣代碼。
類別
 categoryid True integer

選擇費用類別。
員工
 staffid True integer

選擇要花費的員工。
Date
 date True string

YYYY-MM-DD 或 ISO 格式的日期時間。
供應商
 vendor string

選擇要支付費用的供應商。
註釋
 notes string

傳回

身體
Expense

新增客戶端

作業識別碼：
AddClient

此作業會在您的帳戶中建立新用戶端。 必須指定用戶端的至少一個欄位（即名字、姓氏、組織、電子郵件等），否則操作將失敗。

參數

名稱 機碼 必要 類型 Description
Account
 accountid True string

費用帳戶的 ID。
名字
 fname string
姓氏
 lname string
組織
 organization string
電子郵件地址
 email string
電話號碼
 bus_phone string
貨幣
 currency_code string

3 個字母的貨幣代碼。
街道地址1
 p_street string
街道地址 2
 p_street2 string
城市
 p_city string
郵遞區號
 p_code string
國家
 p_country string
省
 p_province string

傳回

身體
Client

更新費用

作業識別碼：
UpdateExpense

此作業用於更新您帳戶中的現有費用。

參數

名稱 機碼 必要 類型 Description
Account
 accountid True string

費用帳戶的 ID。
費用識別碼
 expenseid True string

費用的唯一 ID。
總數
 amount string
貨幣
 code string

3 個字母的貨幣代碼。
類別
 categoryid integer

選擇費用類別。
員工
 staffid integer

選擇要花費的員工。
Date
 date string

YYYY-MM-DD 或 ISO 格式的日期時間。
供應商
 vendor string

選擇要支付費用的供應商。
註釋
 notes string

觸發程序

建立或更新發票時

建立新發票或更新現有發票時觸發。
建立或更新費用時

在建立新費用或更新現有費用時觸發。
記錄或更新付款時

記錄新付款或更新現有付款時觸發。

建立或更新發票時

作業識別碼：
TrigUpdatedInvoice

建立新發票或更新現有發票時觸發。

參數

名稱 機碼 必要 類型 Description
Account
 accountid True string

費用帳戶的 ID。

傳回

身體
Invoice

建立或更新費用時

作業識別碼：
TrigUpdatedExpense

在建立新費用或更新現有費用時觸發。

參數

名稱 機碼 必要 類型 Description
Account
 accountid True string

費用帳戶的 ID。

傳回

身體
Expense

記錄或更新付款時

作業識別碼：
TrigUpdatedPayment

記錄新付款或更新現有付款時觸發。

參數

名稱 機碼 必要 類型 Description
Account
 accountid True string

費用帳戶的 ID。

傳回

身體
Payment

定義

費用清單

一系列費用。

名稱 路徑 類型 Description
物品
 Expense

費用

名稱 路徑 類型 Description
費用識別碼
 id integer

此企業 ID 的費用是唯一的。
加價百分比
 markup_percent string

小數，標記費用的百分比。
專案編號
 projectid integer

相關專案的 ID （如果適用）。
用戶端識別碼
 clientid integer

相關用戶端的識別碼 （如果適用）。
稅率 1
 taxPercent1 string

小數，第一個稅率。
稅名 1
 taxName1 string

第一稅的名稱。
第一個任務金額
 taxAmount1.amount string

首稅金額。
第一個稅幣代碼
 taxAmount1.code string

3 個字母的貨幣代碼。
稅率 2
 taxPercent2 string

小數，第二稅率。
稅名 2
 taxName2 string

第二稅的名稱。
第二稅額
 taxAmount2.amount string

第二稅額。
第二稅幣代碼
 taxAmount2.code string

3 個字母的貨幣代碼。
發票識別碼
 invoiceid integer

相關發票的 ID （如果適用）。
地位
 status integer

費用狀態表格中的值。
銀行名稱
 bank_name string

銀行費用的名稱是從中匯入的（如果適用）。
供應商
 vendor string

供應商名稱。
有收據
 has_receipt boolean

如果已附加收據，則為 True。
外部系統識別碼
 ext_systemid integer

相關承包商系統的 ID（如果適用）。
Date
 date string

費用日期。
交易識別碼
 transactionid string

相關交易的 ID （如果適用）。
註釋
 notes string

費用單。
客戶名稱
 account_name string

相關帳戶的名稱（如適用）。
總數
 amount.amount string

十進位值。
貨幣代碼
 amount.code string

3 個字母的貨幣代碼。
複合稅
 compounded_tax boolean

如果稅 2 是複合稅，則為 true。
帳戶 ID
 accountid string

費用帳戶的 ID （如果適用）。

Invoice

名稱 路徑 類型 Description
發票識別碼
 id integer

此系統唯一的發票識別碼。
發票號碼
 invoice_number string

使用者指定且可見的發票識別碼。
帳戶識別碼
 accountid string

系統的唯一 ID。
3 個字母的貨幣代碼
 currency_code string

發票的三個字母貨幣代碼。
發票狀態
 v3_status string

發票狀態。
Description
 description string

發票第一行的描述。
註釋
 notes string

發票上列出的註釋。
兩個字母的語言代碼
 language string

發票的兩個字母語言代碼。
客戶識別碼
 customerid integer

此系統唯一的用戶端識別碼。
組織已開立發票
 organization string

要開立發票的組織名稱。
客戶名字
 fname string

發票上的客戶名字。
客戶姓氏
 lname string

發票上客戶的姓氏。
發票建立日期
 create_date string

發票的建立日期，YYYY-MM-DD 格式。
發票到期日
 due_date string

發票標記為到期日期，YYYY-MM-DD 格式。
上次更新
 updated string

上次更新發票的時間，YYYY-MM-DD HH：MM：SS 格式。
建立日期
 created_at string

建立發票的時間，YYYY-MM-DD HH：MM：SS 格式。
發票付款日期
 date_paid string

發票全額支付日期，YYYY-MM-DD 格式。
付款狀態
 payment_status string

付款狀態說明。 「未付款」、「部分」、「付費」和「自動付款」之一。
發票金額
 amount.amount string

發票總額，到小數點後兩位。
支付金額
 paid.amount string

發票上支付的金額，小數點後兩位。
未償還金額
 outstanding.amount string

發票上的未付金額，小數點後兩位。
折扣金額
 discount.amount string

折扣金額，到小數點後兩位。
Email
 client.email string

客戶的電子郵件。

付款

名稱 路徑 類型 Description
付款標識碼
 id integer

此系統唯一的付款 ID。
付款類型
 type string

付款方式 - 現金、支票、信用卡
備註
 note string

付款上列出的註釋。
付款日期
 date string

付款日期，YYYY-MM-DD 格式。
客戶識別碼
 clientid integer

此系統唯一的用戶端識別碼。
發票金額
 amount.amount string

付款總額，小數點後兩位。
3 個字母的貨幣代碼
 amount.code string

三個字母的貨幣代碼。
帳戶識別碼
 accounting_systemid string

企業的唯一 ID。
發票識別碼
 invoiceid integer

相關發票的 ID。
名字
 client.fname string

客戶的名字。
姓氏
 client.lname string

客戶的姓氏。
Email
 client.email string

客戶的電子郵件。
用戶名稱
 client.username string

用戶端用來登入的使用者名稱。
組織
 client.organization string

客戶企業名稱。

客戶

名稱 路徑 類型 Description
名字
 response.result.client.fname string

客戶的名字。
姓氏
 response.result.client.lname string

客戶的姓氏。
法數
 response.result.client.fax string

客戶的傳真號碼。
增值稅號碼
 response.result.client.vat_number string

增值稅號。
增值稅名稱
 response.result.client.vat_name string

增值稅名稱。
用戶端識別碼
 response.result.client.id integer

客戶的此企業 ID 獨有。
省
 response.result.client.s_province string

送貨地址。
國家
 response.result.client.s_country string

送貨地址。
城市
 response.result.client.s_city string

送貨地址。
街道
 response.result.client.s_street string

送貨地址。
街道 2
 response.result.client.s_street2 string

送貨地址。
郵遞區號
 response.result.client.s_code string

送貨地址。
備註
 response.result.client.note string

管理員保留的關於客戶的筆記。
行動電話
 response.result.client.mob_phone string

手機號碼。
住家電話
 response.result.client.home_phone string

家庭電話號碼。
公司產業
 response.result.client.company_industry string

行業客戶描述在。
Email
 response.result.client.email string

客戶的電子郵件。
用戶名稱
 response.result.client.username string

用戶端用來登入的使用者名稱。
省
 response.result.client.p_province string

帳單位址。
國家
 response.result.client.p_country string

帳單位址。
城市
 response.result.client.p_city string

帳單位址。
街道
 response.result.client.p_street string

帳單位址。
郵遞區號
 response.result.client.p_code string

帳單位址。
街道 2
 response.result.client.p_street2 string

帳單位址。
電話
 response.result.client.bus_phone string

帳單位址。
大小
 response.result.client.company_size string

帳單位址。
系統識別碼
 response.result.client.accounting_systemid string

商務用戶端的唯一識別碼存在。
語言
 response.result.client.language string

表示使用者語言的簡碼。
組織
 response.result.client.organization string

客戶企業的名稱。
貨幣代碼
 response.result.client.currency_code string

首選貨幣的 3 個字母的短代碼。