FreshBooks (プレビュー)
FreshBooks は、クラウドベースの中小企業会計ソフトウェアです。 請求書の送信、時間の追跡、領収書と経費の管理を行います。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL |
Microsoft LogicApps のサポート Microsoft Power Automate のサポート Microsoft Power Apps のサポート |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://www.freshbooks.com/ |
| プライバシー ポリシー | https://www.freshbooks.com/policies/privacy |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
| トリガーポーリングの頻度 | 1 | 60 秒 |
アクション
| 新しいクライアントの追加 |
この操作により、アカウントに新しいクライアントが作成されます。 クライアントの少なくとも 1 つのフィールド (名、姓、組織、電子メールなど) を指定する必要があります。そうしないと、操作は失敗します。 |
| 新しい経費を作成する |
この操作により、アカウントに新しい経費が作成されます。 |
| 経費の一覧表示 |
すべての経費の一覧を取得します。 |
| 経費の削除 |
この操作は、アカウントから既存の経費を削除するために使用されます。 |
| 経費の更新 |
この操作は、アカウント内の既存の経費を更新するために使用されます。 |
新しいクライアントの追加
この操作により、アカウントに新しいクライアントが作成されます。 クライアントの少なくとも 1 つのフィールド (名、姓、組織、電子メールなど) を指定する必要があります。そうしないと、操作は失敗します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Account
|
accountid | True | string |
経費口座の ID。 |
|
名前
|
fname | string | ||
|
姓
|
lname | string | ||
|
組織
|
organization | string | ||
|
メール アドレス
|
string | |||
|
電話番号
|
bus_phone | string | ||
|
通貨
|
currency_code | string |
3 文字の通貨コード。 |
|
|
番地 1
|
p_street | string | ||
|
番地 2
|
p_street2 | string | ||
|
市区町村
|
p_city | string | ||
|
郵便番号
|
p_code | string | ||
|
Country
|
p_country | string | ||
|
州
|
p_province | string |
戻り値
- Body
- Client
新しい経費を作成する
この操作により、アカウントに新しい経費が作成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Account
|
accountid | True | string |
経費口座の ID。 |
|
金額
|
amount | True | string | |
|
通貨
|
code | string |
3 文字の通貨コード。 |
|
|
カテゴリ
|
categoryid | True | integer |
経費カテゴリを選択します。 |
|
スタッフ
|
staffid | True | integer |
経費のスタッフ メンバーを選択します。 |
|
日付
|
date | True | string |
YYYY-MM-DD または ISO 形式の datetime。 |
|
売り手
|
vendor | string |
経費を出す仕入先を選択します。 |
|
|
注記
|
notes | string |
戻り値
- Body
- Expense
経費の一覧表示
すべての経費の一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Account
|
accountid | True | string |
経費口座の ID。 |
戻り値
経費の配列。
- アイテム
- ExpenseList
経費の削除
この操作は、アカウントから既存の経費を削除するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Account
|
accountid | True | string |
経費口座の ID。 |
|
Expense Id
|
expenseid | True | string |
経費の一意の ID。 |
経費の更新
この操作は、アカウント内の既存の経費を更新するために使用されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Account
|
accountid | True | string |
経費口座の ID。 |
|
Expense Id
|
expenseid | True | string |
経費の一意の ID。 |
|
金額
|
amount | string | ||
|
通貨
|
code | string |
3 文字の通貨コード。 |
|
|
カテゴリ
|
categoryid | integer |
経費カテゴリを選択します。 |
|
|
スタッフ
|
staffid | integer |
経費のスタッフ メンバーを選択します。 |
|
|
日付
|
date | string |
YYYY-MM-DD または ISO 形式の datetime。 |
|
|
売り手
|
vendor | string |
経費を出す仕入先を選択します。 |
|
|
注記
|
notes | string |
トリガー
| 支払いが記録または更新されたとき |
新しい支払いが記録されるか、既存の支払いが更新されたときにトリガーされます。 |
| 経費が作成または更新されたとき |
新しい経費が作成されたとき、または既存の経費が更新されたときにトリガーされます。 |
| 請求書が作成または更新されたとき |
新しい請求書が作成されたとき、または既存の請求書が更新されたときにトリガーされます。 |
支払いが記録または更新されたとき
新しい支払いが記録されるか、既存の支払いが更新されたときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Account
|
accountid | True | string |
経費口座の ID。 |
戻り値
- Body
- Payment
経費が作成または更新されたとき
新しい経費が作成されたとき、または既存の経費が更新されたときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Account
|
accountid | True | string |
経費口座の ID。 |
戻り値
- Body
- Expense
請求書が作成または更新されたとき
新しい請求書が作成されたとき、または既存の請求書が更新されたときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Account
|
accountid | True | string |
経費口座の ID。 |
戻り値
- Body
- Invoice
定義
ExpenseList
経費の配列。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アイテム
|
Expense |
経費
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
経費 ID
|
id | integer |
経費のこのビジネス ID に固有です。 |
|
マークアップの割合
|
markup_percent | string |
経費をマークする 10 進数、パーセント。 |
|
プロジェクト ID
|
projectid | integer |
関連するプロジェクトの ID (該当する場合)。 |
|
クライアント ID
|
clientid | integer |
関連するクライアントの ID (該当する場合)。 |
|
税率 1
|
taxPercent1 | string |
10 進数、最初の税率。 |
|
税名 1
|
taxName1 | string |
最初の税金の名前。 |
|
最初のタスク量
|
taxAmount1.amount | string |
最初の税金の金額。 |
|
最初の税通貨コード
|
taxAmount1.code | string |
3 文字の通貨コード。 |
|
税率 2
|
taxPercent2 | string |
10 進数、2 番目の税率。 |
|
税名 2
|
taxName2 | string |
2 番目の税の名前。 |
|
2 番目の税額
|
taxAmount2.amount | string |
2 番目の税額。 |
|
2 番目の税通貨コード
|
taxAmount2.code | string |
3 文字の通貨コード。 |
|
請求書 ID
|
invoiceid | integer |
関連する請求書の ID (該当する場合)。 |
|
ステータス
|
status | integer |
経費ステータス テーブルの値。 |
|
銀行名
|
bank_name | string |
該当する場合は、銀行経費の名前がインポートされました。 |
|
売り手
|
vendor | string |
ベンダーの名前。 |
|
受信確認済み
|
has_receipt | boolean |
True の 場合は、レシートが添付されています。 |
|
外部システム ID
|
ext_systemid | integer |
関連する請負業者システムの ID (該当する場合)。 |
|
日付
|
date | string |
経費の日付。 |
|
トランザクション ID
|
transactionid | string |
関連するトランザクションの ID (該当する場合)。 |
|
注記
|
notes | string |
経費明細書。 |
|
アカウント名
|
account_name | string |
関連するアカウントの名前 (該当する場合)。 |
|
金額
|
amount.amount | string |
10 進値。 |
|
通貨コード
|
amount.code | string |
3 文字の通貨コード。 |
|
複合税
|
compounded_tax | boolean |
True の 場合は、税 2 が複合税でした。 |
|
アカウント ID
|
accountid | string |
経費勘定の ID (該当する場合)。 |
請求書
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
請求書 ID
|
id | integer |
このシステムに固有の請求書 ID。 |
|
請求書番号
|
invoice_number | string |
ユーザー指定の表示される請求書 ID。 |
|
アカウント ID
|
accountid | string |
システムの一意の ID。 |
|
3 文字の通貨コード
|
currency_code | string |
請求書の 3 文字の通貨コード。 |
|
請求書の状況
|
v3_status | string |
請求書の状態。 |
|
Description
|
description | string |
請求書の最初の行の説明。 |
|
注記
|
notes | string |
請求書に記載されているメモ。 |
|
2 文字の言語コード
|
language | string |
請求書の 2 文字の言語コード。 |
|
顧客ID
|
customerid | integer |
このシステムに対して一意のクライアント ID。 |
|
請求された組織
|
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 |
支払い状態の説明。 'unpaid'、'partial'、'paid'、および 'auto-paid' のいずれか。 |
|
請求書の金額
|
amount.amount | string |
小数点以下 2 桁までの請求書の合計金額。 |
|
支払額
|
paid.amount | string |
請求書で支払われた金額 (小数点以下 2 桁)。 |
|
未払い金額
|
outstanding.amount | string |
請求書の未払い額 (小数点以下 2 桁)。 |
|
割引額
|
discount.amount | string |
小数点以下 2 桁の割引額。 |
|
Email
|
client.email | string |
クライアントの電子メール。 |
支払い
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
決済識別子
|
id | integer |
このシステムに固有の支払い ID。 |
|
支払いの種類
|
type | string |
支払いの種類 - 現金、小切手、クレジット |
|
注
|
note | string |
支払いに記載されているメモ。 |
|
支払日
|
date | string |
支払いが行われた日付、YYYY-MM-DD 形式。 |
|
顧客ID
|
clientid | integer |
このシステムに対して一意のクライアント ID。 |
|
請求書の金額
|
amount.amount | string |
支払いの合計金額 (小数点以下 2 桁)。 |
|
3 文字の通貨コード
|
amount.code | string |
3 文字の通貨コード。 |
|
アカウント ID
|
accounting_systemid | string |
ビジネス向けの一意の ID。 |
|
請求書 ID
|
invoiceid | integer |
関連する請求書の ID。 |
|
名前
|
client.fname | string |
クライアントの名。 |
|
姓
|
client.lname | string |
クライアントの姓。 |
|
Email
|
client.email | string |
クライアントの電子メール。 |
|
ユーザー名
|
client.username | string |
ログインにクライアントによって使用されるユーザー名。 |
|
組織
|
client.organization | string |
クライアントのビジネスの名前。 |
Client
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
名前
|
response.result.client.fname | string |
クライアントの名。 |
|
姓
|
response.result.client.lname | string |
クライアントの姓。 |
|
Fa 番号
|
response.result.client.fax | string |
クライアントの FAX 番号。 |
|
VAT 番号
|
response.result.client.vat_number | string |
付加価値税番号。 |
|
VAT 名
|
response.result.client.vat_name | string |
付加価値税名。 |
|
クライアント ID
|
response.result.client.id | integer |
クライアントのこのビジネス ID に固有です。 |
|
州
|
response.result.client.s_province | string |
配送先住所。 |
|
Country
|
response.result.client.s_country | string |
配送先住所。 |
|
市区町村
|
response.result.client.s_city | string |
配送先住所。 |
|
Street
|
response.result.client.s_street | string |
配送先住所。 |
|
建物名
|
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 |
請求先住所。 |
|
Country
|
response.result.client.p_country | string |
請求先住所。 |
|
市区町村
|
response.result.client.p_city | string |
請求先住所。 |
|
Street
|
response.result.client.p_street | string |
請求先住所。 |
|
郵便番号
|
response.result.client.p_code | string |
請求先住所。 |
|
建物名
|
response.result.client.p_street2 | string |
請求先住所。 |
|
電話
|
response.result.client.bus_phone | string |
請求先住所。 |
|
サイズ
|
response.result.client.company_size | string |
請求先住所。 |
|
システム ID
|
response.result.client.accounting_systemid | string |
ビジネス クライアントの一意識別子が存在します。 |
|
Language
|
response.result.client.language | string |
ユーザー言語を示すショートコード。 |
|
組織
|
response.result.client.organization | string |
クライアントのビジネスの名前。 |
|
通貨コード
|
response.result.client.currency_code | string |
優先通貨の 3 文字のショートコード。 |