Допустимые значения, которых ждёт панель: ресурсы и действия прав, роли в деле, виды операций, счетов, контрагентов и позиций склада, измерения бюджета, частоты повторения. Смотрите сюда, прежде чем угадывать значение поля: панель принимает ровно эти строки и ровно в таком написании.

Открывает окно для адреса панели и токена доступа. Токен выпускается в самой панели: профиль → Интеграции → «Выпустить токен», и показывается там один раз. Вводит его человек, в переписку он не попадает. Вызывайте, когда другие инструменты сообщают, что доступ не настроен или токен больше не действует.

Стирает сохранённый токен с этой машины. Сам токен при этом продолжает действовать — чтобы он перестал работать везде, отзовите его в панели: профиль → Интеграции.

С какой учётной записью работает сервер, к какой панели подключён и какие дела доступны. Полезно вызвать первым: дальше можно обращаться к делам по названию. Если токен выпущен на отдельные дела, здесь видно ровно их — остальные панель не покажет.

Профиль владельца токена: имя, почта, телефон, часовой пояс.

Меняет имя, телефон, дату рождения, описание и часовой пояс учётной записи. Передавайте только те поля, которые нужно изменить: остальные останутся как есть. Пароль и двухфакторную аутентификацию отсюда менять нельзя — только из панели.

Дела, доступные владельцу токена. Если токен выпущен на отдельные дела, здесь ровно они — остальные панель не отдаёт вовсе.

Карточка дела: реквизиты, ваша роль и права в нём, счета с текущими остатками. Разделы, на которые не хватает прав, помечаются как недоступные — остальное всё равно показывается.

Без указания дела создаёт новое (вы становитесь владельцем). С указанием — меняет название, описание, реквизиты или убирает дело в архив. Передавайте только те поля, которые нужно изменить.

Удаляет дело целиком: счета, операции, контрагентов, склад, бюджеты и документы. Восстановить нельзя. Чтобы просто убрать дело из списка, используйте businesses_save с archived=true.

Кто состоит в деле и с какой ролью. Требует права members.view.

Счета дела с текущими остатками. Остаток = начальный плюс движение по фактическим операциям; плановые в него не входят. Каждый счёт живёт в своей валюте — не складывайте остатки разных валют.

Без указания счёта создаёт новый, с указанием — меняет его. Валюта задаётся кодом из трёх букв (RUB, USD, EUR) и определяет валюту всех операций по этому счёту. Текущий остаток менять нельзя: он считается из операций. Меняют начальный остаток.

Удаляет счёт. Если по нему есть операции, панель откажет — такой счёт архивируют через accounts_save с archived=true, иначе история движения денег потеряет опору.

Операции дела с отбором по датам, виду, счёту, проекту, контрагенту и состоянию. Ответ страничный: если показано не всё, в конце написано, какую страницу просить дальше. Состояние: actual — фактические, planned — плановые, overdue — плановые с прошедшей датой.

Карточка операции целиком: суммы, счета, связи, позиции склада, памятка.

Без operation_id создаёт операцию, с ним — меняет. Валюта операции следует за валютой счёта: своё значение передавать не нужно. Для перевода (TRANSFER) обязателен target_account_id, а если валюты счетов разные — ещё и target_amount, иначе остатки соврут. Плановая операция (is_planned=true) в балансы и статистику не входит, в прогноз входит; подтверждают её через operations_confirm.

Удаляет операцию. Отменить нельзя, и остатки счетов пересчитаются сразу. Если операция входит в серию повторений, удалится только она одна.

Переводит плановую операцию в фактическую: она начинает влиять на остатки и статистику, а связанные позиции склада списываются. Будущие планы подтверждать не следует — сначала дождитесь их даты.

Оплата по плановой операции. Полная сумма = подтверждение операции. Частичная — заводит отдельную фактическую операцию-платёж и уменьшает плановый остаток. Операцию с позициями склада можно погасить только полностью, иначе остаток на складе зависнет. Счёт оплаты должен совпадать по валюте с операцией.

Доходы и расходы по дням за период. Только фактические операции; переводы исключены — они не меняют общую сумму денег. Все суммы приведены к рублям по курсу ЦБ.

Как изменится общий остаток с учётом плановых операций: начальный остаток плюс движение по дням. В отличие от статистики, план сюда входит. Суммы в рублях.

Суммы за период в разрезе проектов и контрагентов — куда уходят и откуда приходят деньги. Только фактические операции, суммы в рублях.

Читает переписку по операции или добавляет к ней комментарий. Системные записи о изменениях панель пишет сама — их можно только читать.

Кто сколько должен нам и кому должны мы, с разбивкой по срокам: не наступил срок, 1–30, 31–60, 61–90 и больше 90 дней просрочки. Считается от даты операции. Все суммы приведены к рублям.

Детализация долга по одному контрагенту: из каких плановых операций он сложился, с суммами и сроками. Погасить конкретную строку — operations_settle.

Контрагенты дела: покупатели, поставщики, сотрудники, госорганы.

Без указания контрагента создаёт нового, с указанием — меняет. Передавайте только те поля, которые нужно изменить.

Удаляет контрагента. Если на него ссылаются операции или документы, панель откажет — тогда его архивируют через counterparties_save с archived=true.

Группы, по которым разложены контрагенты дела.

Проекты дела — в API они называются categories. Иерархия ровно одноуровневая: у подпроекта своих подпроектов не бывает.

Без указания проекта создаёт новый, с указанием — меняет. Родителем может быть только проект верхнего уровня: панель отвергнет попытку сделать подпроект у подпроекта. Направление (kind): INCOME, EXPENSE или BOTH.

Удаляет проект. Операции, которые на него ссылались, остаются — просто теряют проект. Подпроекты удаляются вместе с ним.

Карточки склада с текущими остатками. Остаток = начальный плюс приход по расходным операциям минус списание по доходным, только по фактическим операциям. У услуг остатка нет.

Карточка товара или услуги целиком, с текущим остатком.

Без указания карточки создаёт новую, с указанием — меняет. Текущий остаток задать нельзя: он считается из операций. Меняют начальный остаток (initial_stock). НДС указывается процентом; пропустить поле — значит «без НДС».

Удаляет товар или услугу. Карточку, использованную хоть в одной операции, панель удалить не даст: история остатков потеряла бы опору. Такую архивируют через warehouse_save с archived=true.

Группы склада. Общие для товаров и услуг.

Бюджеты дела с прогрессом. Направление EXPENSE — лимит «не превышать», INCOME — цель «достичь». Факт и план считаются раздельно; прогноз = факт плюс будущий план. Все суммы в рублях.

Карточка бюджета с прогрессом и порогами уведомлений.

Без указания бюджета создаёт новый, с указанием — меняет. Под выбранное измерение (scope_type) заполняется ровно один идентификатор: CATEGORY → category_id, COUNTERPARTY → counterparty_id, ACCOUNT → account_id, OVERALL → ни одного. Лимит задаётся в рублях.

Удаляет бюджет вместе с его обсуждением. Операции при этом не трогаются.

Шаблоны .docx дела, по которым собираются документы контрагентов.

Какие поля ждёт шаблон и какого они вида. Смотрите сюда перед documents_generate: обязательные поля без значений панель не пропустит.

Собранные документы одного контрагента с их состоянием подписания.

Подставляет значения в шаблон и сохраняет готовый .docx для контрагента. Значения передаются объектом «ключ поля → значение»; ключи берите из templates_get. Обязательные поля без значений панель отвергнет.

Отправляет документ на подписание через Подпислон. Действие необратимо: письмо уходит получателю, и отозвать его одним вызовом нельзя. Требует настроенной интеграции в деле.

Уведомления учётной записи: приглашения, смены ролей, пройденные пороги бюджетов, банковские платежи.

Помечает одно уведомление прочитанным.