FreshBooks (предварительная версия)
FreshBooks — это облачное программное обеспечение для учета малого бизнеса. Отправка счетов, отслеживание времени, управление квитанциями и расходами.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 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 секунд |
Действия
| Добавление нового клиента |
Эта операция создает в учетной записи новый клиент. По крайней мере одно поле клиента (т. е. имя, фамилия, организация, электронная почта и т. д.) должно быть указано в противном случае операция завершится ошибкой. |
| Обновление расходов |
Эта операция используется для обновления существующих расходов в вашей учетной записи. |
| Перечисление расходов |
Извлекает список всех ваших расходов. |
| Создание новых расходов |
Эта операция создает новые расходы в вашей учетной записи. |
| Удаление расходов |
Эта операция используется для удаления существующих расходов из учетной записи. |
Добавление нового клиента
Эта операция создает в учетной записи новый клиент. По крайней мере одно поле клиента (т. е. имя, фамилия, организация, электронная почта и т. д.) должно быть указано в противном случае операция завершится ошибкой.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Счет
|
accountid | True | string |
Идентификатор счета расходов. |
|
Имя (Первое имя)
|
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 | ||
|
Страна
|
p_country | string | ||
|
Провинция
|
p_province | string |
Возвращаемое значение
- Тело
- Client
Обновление расходов
Эта операция используется для обновления существующих расходов в вашей учетной записи.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Счет
|
accountid | True | string |
Идентификатор счета расходов. |
|
Идентификатор затрат
|
expenseid | True | string |
Уникальный идентификатор расходов. |
|
Сумма
|
amount | string | ||
|
Валюта
|
code | string |
3-буквенный код валюты. |
|
|
Категория
|
categoryid | integer |
Выберите категорию расходов. |
|
|
Персонал
|
staffid | integer |
Выберите сотрудника для расходов. |
|
|
Date
|
date | string |
YYY-MM-DD или формат ISO datetime. |
|
|
Поставщик
|
vendor | string |
Выберите поставщика для расходов. |
|
|
Примечания.
|
notes | string |
Перечисление расходов
Извлекает список всех ваших расходов.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Счет
|
accountid | True | string |
Идентификатор счета расходов. |
Возвращаемое значение
Массив расходов.
- Товары
- ExpenseList
Создание новых расходов
Эта операция создает новые расходы в вашей учетной записи.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Счет
|
accountid | True | string |
Идентификатор счета расходов. |
|
Сумма
|
amount | True | string | |
|
Валюта
|
code | string |
3-буквенный код валюты. |
|
|
Категория
|
categoryid | True | integer |
Выберите категорию расходов. |
|
Персонал
|
staffid | True | integer |
Выберите сотрудника для расходов. |
|
Date
|
date | True | string |
YYY-MM-DD или формат ISO datetime. |
|
Поставщик
|
vendor | string |
Выберите поставщика для расходов. |
|
|
Примечания.
|
notes | string |
Возвращаемое значение
- Тело
- Expense
Удаление расходов
Эта операция используется для удаления существующих расходов из учетной записи.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Счет
|
accountid | True | string |
Идентификатор счета расходов. |
|
Идентификатор затрат
|
expenseid | True | string |
Уникальный идентификатор расходов. |
Триггеры
| Когда платеж записывается или обновляется |
Активирует при записи нового платежа или обновлении существующего. |
| При создании или обновлении расходов |
Активирует при создании нового расхода или обновлении существующего. |
| При создании или обновлении счета |
Активирует при создании нового счета или обновлении существующего. |
Когда платеж записывается или обновляется
Активирует при записи нового платежа или обновлении существующего.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Счет
|
accountid | True | string |
Идентификатор счета расходов. |
Возвращаемое значение
- Тело
- Payment
При создании или обновлении расходов
Активирует при создании нового расхода или обновлении существующего.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Счет
|
accountid | True | string |
Идентификатор счета расходов. |
Возвращаемое значение
- Тело
- Expense
При создании или обновлении счета
Активирует при создании нового счета или обновлении существующего.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Счет
|
accountid | True | string |
Идентификатор счета расходов. |
Возвращаемое значение
- Тело
- Invoice
Определения
ExpenseList
Массив расходов.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Товары
|
Expense |
Expense
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор затрат
|
id | integer |
Уникальный для этого бизнес-идентификатора для расходов. |
|
Процент разметки
|
markup_percent | string |
Десятичная, процент, чтобы пометить расходы вверх. |
|
Идентификатор проекта
|
projectid | integer |
Идентификатор связанного проекта, если применимо. |
|
Идентификатор клиента
|
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 |
Идентификатор связанного счета, если применимо. |
|
Состояние
|
status | integer |
Значение из таблицы состояния расходов. |
|
Имя банка
|
bank_name | string |
Имя банковских расходов было импортировано из, если применимо. |
|
Поставщик
|
vendor | string |
Имя поставщика. |
|
Имеет квитанцию
|
has_receipt | boolean |
Значение true, если квитанция присоединена. |
|
Идентификатор внешней системы
|
ext_systemid | integer |
Идентификатор связанной системы подрядчика, если применимо. |
|
Date
|
date | string |
Дата расходов. |
|
ИД транзакции
|
transactionid | string |
Идентификатор связанной транзакции, если применимо. |
|
Примечания.
|
notes | string |
Заметки о расходах. |
|
Имя учетной записи
|
account_name | string |
Имя связанной учетной записи, если применимо. |
|
Сумма
|
amount.amount | string |
Десятичное значение. |
|
Код Валюты
|
amount.code | string |
3-буквенный код валюты. |
|
Составной налог
|
compounded_tax | boolean |
Верно, если налог 2 был составным налогом. |
|
Идентификатор учетной записи
|
accountid | string |
Идентификатор учетной записи расходов, если применимо. |
Invoice
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Номер счета
|
id | integer |
Уникальный идентификатор счета-фактуры для этой системы. |
|
Номер счета
|
invoice_number | string |
Указанный пользователем и видимый идентификатор счета. |
|
ID счета
|
accountid | string |
Уникальный идентификатор для системы. |
|
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 |
Счет даты помечается как должное в формате YYY-MM-DD. |
|
Последнее обновление
|
updated | string |
Время последнего обновления счета-MM-DD формате HH:MM:SS. |
|
Дата создания
|
created_at | string |
Создан счет времени, ггГГ-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 |
Сумма скидки, до двух десятичных разрядов. |
|
Адрес электронной почты
|
client.email | string |
Электронная почта клиента. |
Уплата
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор оплаты
|
id | integer |
Уникальный идентификатор оплаты для этой системы. |
|
Тип оплаты
|
type | string |
Тип оплаты — наличные деньги, чек, кредит |
|
Замечание
|
note | string |
Заметки, перечисленные в платеже. |
|
Дата оплаты
|
date | string |
Дата оплаты, формат YYY-MM-DD. |
|
Идентификатор клиента
|
clientid | integer |
Уникальный идентификатор клиента для этой системы. |
|
Сумма счета
|
amount.amount | string |
Общая сумма платежа до двух десятичных разрядов. |
|
3-буквенный код валюты
|
amount.code | string |
Трехбуквенный код валюты. |
|
ID счета
|
accounting_systemid | string |
Уникальный идентификатор для бизнеса. |
|
Номер счета
|
invoiceid | integer |
Идентификатор связанного счета. |
|
Имя (Первое имя)
|
client.fname | string |
Имя клиента. |
|
Фамилия
|
client.lname | string |
Фамилия клиента. |
|
Адрес электронной почты
|
client.email | string |
Электронная почта клиента. |
|
Имя пользователя
|
client.username | string |
Имя пользователя, используемое клиентом для входа. |
|
Организация
|
client.organization | string |
Имя бизнеса клиента. |
Клиент
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Имя (Первое имя)
|
response.result.client.fname | string |
Имя клиента. |
|
Фамилия
|
response.result.client.lname | string |
Фамилия клиента. |
|
Номер fa
|
response.result.client.fax | string |
Номер факса клиента. |
|
Номер НДС
|
response.result.client.vat_number | string |
Добавленный налоговый номер. |
|
Имя НДС
|
response.result.client.vat_name | string |
Имя налога на добавленную стоимость. |
|
Идентификатор клиента
|
response.result.client.id | integer |
Уникальный для этого бизнес-идентификатора для клиента. |
|
Провинция
|
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 |
Описание отраслевого клиента находится в. |
|
Адрес электронной почты
|
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 |
Адрес выставления счетов. |
|
Size
|
response.result.client.company_size | string |
Адрес выставления счетов. |
|
Идентификатор системы
|
response.result.client.accounting_systemid | string |
Уникальный идентификатор бизнес-клиента существует. |
|
Language
|
response.result.client.language | string |
Короткий код, указывающий язык пользователя. |
|
Организация
|
response.result.client.organization | string |
Имя для бизнеса клиента. |
|
Код Валюты
|
response.result.client.currency_code | string |
3-буквенный короткий код для предпочтительной валюты. |