Fitness365 MCP API

Сервер аналитики фитнес-клуба по протоколу Model Context Protocol. 86 инструментов по посещениям, клиентам, абонементам, продажам, тренировкам, скидкам и оттоку: 82 — только чтение, и три пишущих (crm_task_create, lead_create, client_create), включаемых опцией Mcp:EnableWrites.

MCP Streamable HTTPJSON-RPC 2.0Только чтение82 инструмента

Обзор

Сервер публикует аналитику клуба как набор MCP-инструментов. Подключить его можно из любого MCP-клиента (Claude, MCP Inspector, собственное приложение на SDK) либо вызывать напрямую по JSON-RPC поверх HTTP. Каждый инструмент выполняет фиксированный запрос с типизированными параметрами: произвольного SQL нет, данные изменить нельзя.

Авторизация

Каждый запрос к /mcp должен содержать токен клуба — его выдаёт администратор клуба (параметр CrmToken в настройках модуля CRM). Токен передаётся одним из способов:

СпособПримерКогда использовать
Заголовок (предпочтительно)X-Crm-Token: <ТОКЕН>Не попадает в URL и журналы прокси
Параметр URLhttps://<host>/mcp/mcp?token=<ТОКЕН>Клиенты, которые не умеют задавать заголовки

Если указаны оба, заголовок приоритетнее. Пустой, неверный или отсутствующий токен даёт 401.

Токен — секрет. Не публикуйте URL с токеном в репозиториях, тикетах и чатах. В production используйте только HTTPS. Один токен даёт доступ ко всем инструментам, ролей и срока действия у него нет. При подозрении на утечку попросите администратора клуба сменить токен.

Подключение

Адрес сервера: https://<host>/mcp/mcp (Streamable HTTP, токен — заголовком X-Crm-Token или параметром ?token=, см. «Авторизация»). Пошаговые инструкции для ChatGPT, Claude, Claude Code, GigaCode Desktop и DeepSeek, подключение из MCP Inspector и C#, проверка подключения и типовые ошибки вынесены в отдельный документ: Подключение AI-агентов к Fitness365 MCP.

Вызов инструментов

Сервер понимает стандартные методы MCP: initialize, tools/list, tools/call. Запрос — POST /mcp с телом JSON-RPC 2.0 и заголовками Content-Type: application/json, Accept: application/json, text/event-stream. Ответ может прийти как JSON или как SSE-поток. Если на initialize сервер вернул заголовок Mcp-Session-Id, передавайте его в следующих запросах.

initialize

curl -s -X POST "https://<host>/mcp/mcp" \
  -H "X-Crm-Token: <ТОКЕН>" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1"}}}'

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_summary",
    "arguments": { "period": "last_week", "branchId": 1084, "compare": true }
  }
}

Результат содержит JSON-объект с метрикой в content. Все параметры, кроме отмеченных «да», необязательны.

Формат ответа и ошибки

Примеры вызова и ответа для конкретных инструментов приведены в справочнике ниже, сразу после описания инструмента (данные демонстрационные, длинные списки сокращены). Здесь показано то, что одинаково для всех инструментов.

Конверт JSON-RPC

Так выглядит конверт, в который сервер упаковывает любой из ответов (тело метрики — строка в text):

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [ { "type": "text", "text": "{\"metric\":\"visits\",\"value\":15,\"unit\":\"visits\", ...}" } ],
    "isError": false
  }
}

Ошибки

Ошибка параметров (например, период длиннее 3 месяцев) приходит как обычный результат с isError: true. Текст сообщения на русском; он зависит от инструмента, ниже иллюстрация формата:

{
  "jsonrpc": "2.0",
  "id": 6,
  "result": {
    "content": [ { "type": "text", "text": "Период не должен превышать 3 календарных месяцев." } ],
    "isError": true
  }
}

Неверный токен — HTTP-ошибка до JSON-RPC:

HTTP/1.1 401 Unauthorized

HTTP/1.1 429 Too Many Requests
Retry-After: 42

Пример текста ошибки и значение Retry-After показательные, точные формулировки смотрите в ответе сервера.

Периоды, фильтры, формат ответа

Периоды

Инструменты с периодом принимают параметры period, days, dateFrom, dateTo:

Значение periodСмысл
today, yesterdayСегодня, вчера
this_week, last_weekТекущая и прошлая неделя (неделя с понедельника)
this_month, last_monthТекущий и прошлый календарный месяц
last_n_daysПоследние N дней включая сегодня, N в days
customСвои границы dateFrom / dateTo, формат yyyy-MM-dd, включительно

Границы считаются как полуоткрытый интервал [start, end) в часовом поясе клуба. Любой период не длиннее 3 календарных месяцев (это касается и предыдущего периода при compare=true); окна «N дней» ограничены примерно 93 днями. Исключения описаны у отдельных инструментов (sales_list, reserves_list, client_purchases_total по клиенту).

Фильтр по филиалу

Параметр branchId. Список филиалов даёт get_branches. Без параметра запрос охватывает весь клуб.

Сравнение с предыдущим периодом

compare=true добавляет блок comparison: current, previous, absoluteChange, percentChange и границы обоих периодов. При previous=0 процент не возвращается. Для незавершённого периода предыдущий берётся за такое же прошедшее время, об этом сообщает warnings.

Постраничный вывод

Списки принимают limit и offset. Максимальный размер страницы 50 (по умолчанию 20 для списков, 10 для рейтингов). В ответе есть page {total, limit, offset, hasMore}. Идите по страницам, увеличивая offset на limit, пока hasMore = true.

Формат ответа

{
  "metric": "deleted_clients",
  "definition": "Что именно измерено (по-русски)",
  "period": { "start": "...", "end": "...", "interval": "...", "kind": "...", "label": "...", "timezone": "..." },
  "asOf": "2026-10-23T13:05:15",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [],
  "value": 335,
  "unit": "clients",
  "page": { "total": 335, "limit": 20, "offset": 0, "hasMore": true },
  "items": [ ... ]
}

Состав полей зависит от инструмента: value/unit, items, byBranch, comparison. Всегда читайте definition и warnings: они уточняют, как посчитана метрика. Валюта в данных не хранится, в денежных ответах указана «валюта учёта клуба».

Ошибки и лимиты

СитуацияОтвет
Нет токена, токен неверный, у клуба токен не настроенHTTP 401
Превышен лимит запросовHTTP 429 с заголовком Retry-After (секунды до повтора)
Ошибка параметров: слишком длинный период, неизвестный филиал, клиент или занятие, неполная пара lastName+firstNameРезультат инструмента с isError=true и понятным русским сообщением
Внутренняя ошибкаAn error occurred invoking '<tool>'. без технических деталей

Персональные данные

Агрегатные инструменты персональных данных не содержат, имена в них выводятся как «Имя Ф.» (имя и первая буква фамилии). Следующие инструменты возвращают ПДн, считайте их ответы персональными данными:

ИнструментЧто возвращает
client_findПолное ФИО, телефон, e-mail, дата рождения клиента
client_detailsФИО, контакты, дата рождения, ИНН, паспортные данные, адрес
staff_listФИО, телефон, e-mail сотрудников
sales_list, returns_list, crm_tasks_list, visits_listПострочные данные с «Фамилия Имя» клиентов (и сотрудников)
reserves_listПолное ФИО клиентов
Не пересылайте такие ответы дальше без необходимости. Если вы подключаете сервер к внешней LLM, решение о передаче данных клуба этому провайдеру принимает владелец клуба.

Справочник инструментов

Ниже все инструменты по группам. Параметры периода (period, days, dateFrom, dateTo) везде одинаковые, см. раздел «Периоды». Поиск в левой панели фильтрует список по названию.

Справочные

get_metric_definitions

Определения метрик и правила работы с периодами (лимит 3 месяца, полуоткрытые интервалы, неделя с понедельника, как считается выручка/отток/активный клиент). Вызывайте, чтобы корректно объяснить пользователю, что именно измерено.

Без параметров.

Пример запроса и ответа

«Какие метрики есть в системе и как считаются периоды?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_metric_definitions",
    "arguments": {}
  }
}
{
  "metric": "metric_definitions",
  "definition": "Справочник определений метрик и правил периодов этого MCP-сервера.",
  "asOf": "2026-10-23T18:20:21",
  "filters": {},
  "warnings": [],
  "timezone": "Europe/Moscow",
  "now": "2026-10-23T18:20:21.9208319",
  "maxPeriodMonths": 3,
  "periods": "Периоды — полуоткрытые интервалы [start, end) в часовом поясе клуба. Неделя начинается с понедельника. last_n_days включает сегодня. dateTo в custom задаётся включительно. Любой период (и предыдущий период при сравнении) не длиннее лимита в месяцах — иначе запрос отклоняется до обращения к БД.",
  "comparison": "Изменение = (текущее − предыдущее) / предыдущее × 100. При предыдущем = 0 процент не возвращается. Для незавершённого периода предыдущий берётся за такое же прошедшее время.",
  "definitions": {
    "visit": "Посещение (Visit) клиента (PersonType = клиент); посещения сотрудников не считаются. «Проходы» и «уникальные посетители» (различные клиенты) — разные числа.",
    "in_club_now": "Открытые визиты (IsOpen = 1), начатые не более 24 часов назад. Более старые открытые визиты считаются незакрытыми и выводятся отдельно.",
    "new_client": "Клиент (не лид), у которого Contragent.Date (дата создания карточки) попадает в период.",
    "active_client": "Клиент с абонементом или клубной картой в статусе «Активна» и сроком окончания не раньше текущего момента. Замороженные учитываются отдельно.",
    "abonement": "Позиция клиента (SaledService), продукт которой — абонемент (Abonement) или клубная карта (ClubCard). Разовые услуги и товары не входят.",
    "expiring_abonement": "Абонемент в статусе «Активна» с датой окончания от сегодняшнего дня до N дней вперёд.",
    "renewed_abonement": "Абонемент, закончившийся в периоде, после которого у клиента есть другой абонемент с более поздней датой окончания. Иначе — не продлён. Считаются абонементы, а не клиенты.",
    "successful_sale": "Продажа (Sale) со статусом «Проведена» (TransactionStatus = 2). Сохранённые, ожидающие оплаты и возвращённые продажи не входят.",
    "sales_amount": "Сумма проведённых продаж ([Transaction].Summ) — стоимость после скидок, независимо от способа оплаты. Именно она называется «выручкой (оборотом) по продажам».",
    "paid_amount": "Фактически полученная оплата: наличные + карта + безнал − сдача. Оплата с депозита и бонусами показывается отдельно и сюда не входит.",
    "item_result_sum": "SaleItem.ResultSumm — сумма позиции после скидки; SaleItem.DiscountSumm — предоставленная скидка. Используются для рейтингов товаров/категорий и «суммы скидок».",
    "average_check": "Сумма проведённых продаж / их количество.",
    "returns": "Возвраты покупателям (BuyReturnTransaction, проведённые) и продажи со статусом «Возврат». Выручка нетто не вычисляется: возвраты показываются отдельно.",
    "training_reserve": "Запись клиента на тренировку (Reserve). Состоявшаяся тренировка — занятие расписания (TrainingEvent) без пометки «Отменено». Посещение тренировки — Visit со ссылкой на занятие. Это три разные метрики.",
    "churn_nonrenewal": "Отток как непродление: не продлённые абонементы / закончившиеся абонементы за период.",
    "churn_inactivity": "Отток как отсутствие посещений: клиенты с действующим абонементом без посещений N дней / все клиенты с действующим абонементом.",
    "churn_active_base": "Отток как изменение активной базы: клиенты с действующим абонементом на начало и конец периода (по датам начала и окончания; заморозки и досрочные закрытия не учитываются — истории статусов в БД нет).",
    "discount": "Правило скидки (DiscountRule). Принадлежность правила активной схеме дисконтирования и остальные условия правила в этом сервере не проверяются."
  },
  "personalData": "Персональные данные ограничены именем и первой буквой фамилии («Иван П.»); телефоны, e-mail, документы и полные фамилии не возвращаются.",
  "currency": "валюта учёта клуба (валюта в БД не хранится)"
}

Организация

get_branches

Список филиалов клуба (собственные организации): branchId и название. branchId используется как фильтр во всех остальных инструментах. Вызывайте, когда пользователь называет филиал по имени (например «Ленина 55»).

Без параметров.

Пример запроса и ответа

Вызывайте первым, когда нужен branchId.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_branches",
    "arguments": {}
  }
}
{
  "metric": "branches",
  "definition": "Собственные организации клуба (филиалы).",
  "asOf": "2026-10-23T16:31:59",
  "filters": {},
  "warnings": [],
  "total": 4,
  "items": [
    { "branchId": 1327, "name": "казань" },
    { "branchId": 1084, "name": "fitness365 Москва" },
    { "branchId": 1048, "name": "fitness365 Санкт-Петербург" },
    { "branchId": 1275, "name": "fitness365 Сочи" }
  ]
}

organization_details

Реквизиты одной организации (филиал клуба или юрлицо) по organizationId (это же branchId, список — get_branches): name, inn, email, description, phone (TelefoneWork), isBranch, address (country, stateProvince, zipPostal, city, street; null, если адреса нет). Не найдена → ошибка.

ПараметрТипОбяз.Описание
organizationIdintegerдаID организации (MyOrganization.OID).

Пример запроса и ответа

«Покажи реквизиты филиала 1084.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "organization_details",
    "arguments": {
      "organizationId": 1084
    }
  }
}
{
  "metric": "organization_details",
  "definition": "Реквизиты организации (MyOrganization): название, ИНН, e-mail, описание, рабочий телефон (TelefoneWork), адрес (Contragent.Address1).",
  "asOf": "2026-10-23T18:20:46",
  "filters": { "branchId": null, "branchName": null, "extra": { "organizationId": 1084 } },
  "warnings": [],
  "organization": {
    "organizationId": 1084,
    "name": "fitness365 Москва",
    "inn": null,
    "email": null,
    "description": "Лучший фитнес клуб на свете!",
    "phone": null,
    "isBranch": true,
    "address": { "country": "Россия", "stateProvince": null, "zipPostal": null, "city": null, "street": null }
  }
}

staff_list

Список сотрудников (Personal, PersonType_ID = 2), по одной строке на сотрудника: staffId (он же ID тренера/менеджера), lastName, firstName, middleName, phone, email, sex (мужской/женский), statusId/status (Работает/Уволен), positionId/position (должность), occupationId/occupation (тип должности: Отсутствует, Тренер, Управляющий, Руководитель, Обслуживающий персонал), филиал. Клиенты не включаются.

ПараметрТипОбяз.Описание
lastName + firstNamestringнетНачало фамилии и имени (именительный падеж). Обе части обязательны (одна → ошибка).
phonestringнетТелефон в любом формате, ≥ 7 цифр (индекс TelefoneCellForSearch).
emailstringнетАдрес целиком, без учёта регистра.
branchIdintegerнетФилиал (Contragent.Organization).
occupationstringнетcoach, manager, chief, service_staff, none (должность без типа / не задана).
statusstringнетworking или dismissed; не указан — все.
limit / offsetintegerнетПостраничный вывод.

Фильтры комбинируются по «И». Телефон и e-mail сотрудников выдаются по требованию заказчика (второе исключение из политики ПДн после client_find).

Пример запроса и ответа

«Покажи сотрудников филиала 1084.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "staff_list",
    "arguments": {
      "branchId": 1084,
      "limit": 2
    }
  }
}
{
  "metric": "staff_list",
  "definition": "Сотрудники (Personal, PersonType_ID = 2). Пол: мужской/женский; статус: Работает/Уволен; тип должности — Position.Occupation. Содержит персональные данные (телефон, e-mail).",
  "asOf": "2026-10-23T18:22:53",
  "filters": {
    "branchId": 1084,
    "branchName": "fitness365 Москва",
    "extra": { "lastName": null, "firstName": null, "phone": null, "email": null, "occupation": null, "status": null }
  },
  "warnings": [],
  "page": { "total": 13, "limit": 2, "offset": 0, "hasMore": true },
  "items": [
    {
      "staffId": 1085,
      "lastName": "",
      "firstName": "Администратор \"филиал2\"",
      "middleName": "",
      "phone": null,
      "email": null,
      "sex": null,
      "statusId": 1,
      "status": "Работает",
      "positionId": null,
      "position": null,
      "occupationId": 1,
      "occupation": "Отсутствует",
      "branchId": 1084,
      "branch": "fitness365 Москва"
    },
    {
      "staffId": 1313,
      "lastName": "Proverka",
      "firstName": "",
      "middleName": "",
      "phone": null,
      "email": "client@example.com",
      "sex": null,
      "statusId": 1,
      "status": "Работает",
      "positionId": null,
      "position": null,
      "occupationId": 1,
      "occupation": "Отсутствует",
      "branchId": 1084,
      "branch": "fitness365 Москва"
    }
  ]
}

Посещения

visits_summary

Посещаемость клуба за период: число посещений (проходов) и число УНИКАЛЬНЫХ посетителей. Отвечает на «сколько посетителей было сегодня/вчера/на неделе/в месяце», «сколько уникальных посетителей», «как изменилась посещаемость к прошлой неделе/месяцу» (compare=true). Посещения сотрудников не считаются.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
comparebooleanнетtrue — добавить сравнение с предыдущим периодом (разница и процент изменения).

Пример запроса и ответа

«Сколько посетителей было на прошлой неделе и как это изменилось к позапрошлой?»

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "visits_summary",
    "arguments": {
      "period": "last_week",
      "compare": true
    }
  }
}
{
  "metric": "visits",
  "definition": "Количество посещений клиентов (проходов) и количество уникальных посетителей за период. Посещения сотрудников не считаются.",
  "period": {
    "start": "2026-10-12T00:00:00", "end": "2026-10-19T00:00:00", "interval": "[start, end)",
    "kind": "last_week", "label": "Прошлая неделя (с понедельника)", "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T16:31:59",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [],
  "value": 15,
  "unit": "visits",
  "uniqueVisitors": 10,
  "comparison": {
    "previousPeriod": { "start": "2026-10-05T00:00:00", "end": "2026-10-12T00:00:00", "label": "Предыдущая неделя" },
    "visits":         { "current": 15, "previous": 7, "absoluteChange": 8, "percentChange": 114.29, "note": null },
    "uniqueVisitors": { "current": 10, "previous": 2, "absoluteChange": 8, "percentChange": 400,    "note": null }
  }
}

visits_current_in_club

Сколько клиентов находится в клубе ПРЯМО СЕЙЧАС: открытые визиты (IsOpen), начатые не более 24 часов назад, по филиалам. Более старые открытые визиты (не закрыты при выходе) выводятся отдельно.

ПараметрТипОбяз.Описание
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Сколько человек сейчас в клубе?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_current_in_club",
    "arguments": {}
  }
}
{
  "metric": "visits_current_in_club",
  "definition": "Число различных клиентов с открытым визитом (IsOpen = 1), начатым не более 24 часов назад.",
  "asOf": "2026-10-23T18:20:24",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [],
  "value": 0,
  "unit": "clients",
  "unclosedOlderThan24h": 1,
  "byBranch": []
}

visits_by_branch

Посещаемость по каждому филиалу за период: посещения и уникальные посетители. Для вопросов «какая посещаемость по филиалам», «сравни филиалы».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.

Пример запроса и ответа

«Как посещаемость распределяется по филиалам за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_by_branch",
    "arguments": {
      "period": "last_n_days",
      "days": 30
    }
  }
}
{
  "metric": "visits_by_branch",
  "definition": "Посещения клиентов и уникальные посетители по филиалам за период.",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:26",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:20." ],
  "total": { "visits": 3, "uniqueVisitors": 1 },
  "items": [ { "branchId": 947, "branch": "Без филиала", "visits": 3, "uniqueVisitors": 1 } ]
}

visits_by_weekday_hour

Распределение посещений по дням недели и по часам начала посещения; пиковый день и час пик. Для вопросов «какая посещаемость по дням недели», «в какие часы наибольшая загрузка».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«В какие дни недели и часы в клубе больше всего народу?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_by_weekday_hour",
    "arguments": {
      "period": "last_n_days",
      "days": 14
    }
  }
}
{
  "metric": "visits_by_weekday_hour",
  "definition": "Распределение посещений клиентов по дню недели и по часу начала посещения.",
  "period": {
    "start": "2026-10-10T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 14 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:28",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:20." ],
  "total": 2,
  "byWeekday": [
    { "weekday": "Понедельник", "visits": 0, "daysInPeriod": 2, "averagePerDay": 0 },
    { "weekday": "Вторник", "visits": 0, "daysInPeriod": 2, "averagePerDay": 0 },
    { "weekday": "Среда", "visits": 2, "daysInPeriod": 2, "averagePerDay": 1 }
  ],
  "byHour": [ { "hour": 0, "visits": 0 }, { "hour": 1, "visits": 0 }, { "hour": 2, "visits": 0 } ],
  "peakWeekday": "Среда",
  "peakHour": 23
}

Для краткости в примере сокращены длинные массивы (byHour, byWeekday): показаны первые 3 элемента.

visits_dynamics

Динамика посещений по дням, неделям или месяцам за период (ряд для графика/сравнения).

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
granularitystringнетШаг ряда: day, week (с понедельника) или month. По умолчанию day для периодов до 31 дня, иначе week.

Пример запроса и ответа

«Покажи динамику посещений по неделям за последние 30 дней.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_dynamics",
    "arguments": {
      "period": "last_n_days",
      "days": 30,
      "granularity": "week"
    }
  }
}
{
  "metric": "visits_dynamics",
  "definition": "Количество посещений клиентов по интервалам ряда.",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:30",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:20." ],
  "granularity": "week",
  "total": 3,
  "items": [
    { "date": "2026-09-21T00:00:00", "visits": 0 },
    { "date": "2026-09-28T00:00:00", "visits": 1 },
    { "date": "2026-10-05T00:00:00", "visits": 0 }
  ]
}

Для краткости в примере сокращены длинные массивы (items): показаны первые 3 элемента.

visits_average_duration

Средняя длительность посещения (в минутах) за период по закрытым визитам с корректным временем выхода (0..24 ч); при необходимости — по филиалам.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Сколько в среднем длится посещение клуба за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_average_duration",
    "arguments": {
      "period": "last_n_days",
      "days": 30
    }
  }
}
{
  "metric": "visits_average_duration",
  "definition": "Средняя длительность посещения в минутах по закрытым визитам (DateTill − Date, 0..24 ч).",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:32",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:20.",
    "Из 2 закрытых визитов длительность определена для 1; остальные без времени выхода или с некорректным временем исключены."
  ],
  "value": 12,
  "unit": "minutes",
  "visitsMeasured": 1,
  "byBranch": [ { "branchId": 947, "branch": "Без филиала", "visits": 1, "averageMinutes": 12 } ]
}

client_visits

Посещения конкретного клиента: сколько раз был за последние N дней и список последних посещений (дата, филиал, длительность). Клиент задаётся clientId; имя — только инициалы.

ПараметрТипОбяз.Описание
clientIdintegerдаID клиента (clientId из других инструментов).
daysintegerнетОкно в днях, включая сегодня (по умолчанию 30, максимум ≈ 92).
limitintegerнетСколько последних посещений вернуть (по умолчанию 10).

Пример запроса и ответа

«Какие посещения были у клиента 1482 за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "client_visits",
    "arguments": {
      "clientId": 1482,
      "days": 30,
      "limit": 3
    }
  }
}
{
  "metric": "client_visits",
  "definition": "Число посещений клиента за последние N дней и последние посещения.",
  "asOf": "2026-10-23T18:20:35",
  "filters": { "clientId": 1482, "days": 30 },
  "warnings": [],
  "client": { "clientId": 1482, "name": "Иван В." },
  "value": 0,
  "unit": "visits",
  "window": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "timezone": "Europe/Moscow"
  },
  "lastVisits": [
    {
      "date": "2026-08-29T10:12:16.9",
      "branchId": 1084,
      "branch": "fitness365 Москва",
      "isOpen": false,
      "minutes": 1
    },
    {
      "date": "2026-08-28T23:06:10.527",
      "branchId": 1084,
      "branch": "fitness365 Москва",
      "isOpen": false,
      "minutes": null
    },
    {
      "date": "2026-08-28T23:04:22.037",
      "branchId": 1084,
      "branch": "fitness365 Москва",
      "isOpen": false,
      "minutes": 1
    }
  ]
}

visits_list

Реестр посещений клиентов за период — по одной строке на посещение (новые сверху): visitId, clientId, клиент («Фамилия Имя» полностью), date (начало визита), dateTill (окончание; у открытого визита null), isOpen, услуга (serviceId, service — Visit.Service: по какой услуге пришёл клиент), basis/basisName/basisItem (основание: по чему прошёл — абонемент, клубная карта, разовая услуга, занятие или без основания; basisItem — название купленной позиции), филиал. Сотрудники исключены. Агрегаты — visits_summary, число визитов одного клиента — client_visits.

phonestringнетМобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); не менее 7 цифр. Альтернатива clientId.
ПараметрТипОбяз.Описание
period/days/dateFrom/dateToнетПериод; по умолчанию последние 30 дней, максимум 3 месяца.
branchIdintegerнетФилиал.
clientIdintegerнетТолько посещения этого клиента.
lastName + firstNamestringнетКлиент по фамилии и имени (начало, именительный падеж). Обе части обязательны (одна → ошибка); игнорируются, если указан clientId. ID можно получить через client_find.
serviceIdintegerнетID услуги (Visit.Service).
serviceNamestringнетЧасть названия услуги (без учёта регистра) — если ID услуги неизвестен.
trainerIdintegerнетID тренера (Visit.Executor, ID сотрудника из staff_list). В строках ответа есть trainerId/trainer.
serviceKindstringнетВид услуги: trial — пробные (услуга с признаком «Пробная»), guest — гостевые (гостевая услуга или посещение по приглашению клиента; в строках есть invitedById/invitedBy). Иное значение → ошибка.
basisstringнетОснование посещения: abonement — абонемент, club_card — клубная карта, one_time — разовая услуга, training — занятие по расписанию (без купленной позиции), none — без основания. Иное значение → ошибка. Сравнение числом — visits_statistics_by_basis.
limit / offsetintegerнетПостраничный вывод.

Фильтры комбинируются по «И». Период ограничен 3 месяцами (исключение «без ограничения» есть только у sales_list по клиенту).

Пример запроса и ответа

«Покажи последние посещения за последние 7 дней.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_list",
    "arguments": {
      "period": "last_n_days",
      "days": 7,
      "limit": 3
    }
  }
}
{
  "metric": "visits_list",
  "definition": "Построчный реестр посещений клиентов (Visit; сотрудники исключены) по дате визита. service — услуга, по которой пришёл клиент (Visit.Service). Имена — полностью («Фамилия Имя»): персональные данные, не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2026-10-17T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 7 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:37",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "clientId": null,
      "phone": null,
      "lastName": null,
      "firstName": null,
      "serviceId": null,
      "serviceName": null,
      "trainerId": null
    }
  },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:20." ],
  "page": { "total": 0, "limit": 3, "offset": 0, "hasMore": false },
  "items": []
}

«Покажи гостевые посещения во II квартале 2022.» (serviceKind=guest; в строках — кто пригласил)

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_list",
    "arguments": {
      "period": "custom",
      "dateFrom": "2022-04-01",
      "dateTo": "2022-06-30",
      "serviceKind": "guest",
      "limit": 3
    }
  }
}
{
  "metric": "visits_list",
  "definition": "Построчный реестр посещений клиентов (Visit; сотрудники исключены) по дате визита. service — услуга, по которой пришёл клиент (Visit.Service). Имена — полностью («Фамилия Имя»): персональные данные, не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2022-04-01T00:00:00",
    "end": "2022-07-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2022-04-01 — 2022-06-30 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T01:48:56.5514292",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "clientId": null,
      "phone": null,
      "lastName": null,
      "firstName": null,
      "serviceId": null,
      "serviceName": null,
      "trainerId": null,
      "serviceKind": "guest"
    }
  },
  "warnings": [],
  "page": {
    "total": 8,
    "limit": 3,
    "offset": 0,
    "hasMore": true
  },
  "items": [
    {
      "visitId": 506,
      "clientId": 591,
      "client": "Смирнов Дмитрий",
      "date": "2022-06-14T19:25:00",
      "dateTill": "2022-06-15T02:00:00",
      "isOpen": false,
      "serviceId": 83,
      "service": "Пробная тренировка",
      "trainerId": 232,
      "trainer": null,
      "invitedById": null,
      "invitedBy": null,
      "branchId": 1,
      "branch": "Без филиала"
    },
    {
      "visitId": 505,
      "clientId": 507,
      "client": "Орлова Елена",
      "date": "2022-06-14T15:36:00",
      "dateTill": "2022-06-15T02:00:00",
      "isOpen": false,
      "serviceId": 27,
      "service": null,
      "trainerId": 232,
      "trainer": null,
      "invitedById": null,
      "invitedBy": null,
      "branchId": 1,
      "branch": "Без филиала"
    },
    {
      "visitId": 485,
      "clientId": 476,
      "client": "Иванов Сергей",
      "date": "2022-05-27T12:08:00",
      "dateTill": "2022-05-28T02:00:00",
      "isOpen": false,
      "serviceId": 21,
      "service": "Стретчинг",
      "trainerId": 232,
      "trainer": null,
      "invitedById": null,
      "invitedBy": null,
      "branchId": 1,
      "branch": "Без филиала"
    }
  ]
}

visits_statistics_by_trainer

Статистика по посещениям (визитам) в разрезе тренеров (Visit.Executor): trainerId, trainer, visits, uniqueClients, shareOfVisits; сверху totalVisits, visitsWithTrainer, visitsWithoutTrainer (посещения без указанного тренера в рейтинг не входят). В ответе есть поле basis — статистика основана на посещениях, а не на записях на занятия (для записей — trainers_popularity).

ПараметрТипОбяз.Описание
period/days/dateFrom/dateToнетПериод (по умолчанию текущий месяц, максимум 3 месяца).
branchIdintegerнетФилиал; не указан — все филиалы.
trainerIdsinteger[]нетID тренеров (staff_list); пусто — все тренеры.
limitintegerнетРазмер рейтинга (по умолчанию 10).

Пример запроса и ответа

«Сколько посещений было у тренеров за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_statistics_by_trainer",
    "arguments": {
      "period": "last_n_days",
      "days": 30,
      "limit": 3
    }
  }
}
{
  "metric": "visits_statistics_by_trainer",
  "definition": "Посещения клиентов по тренерам (Visit.Executor): число визитов и уникальных клиентов. Статистика основана на ПОСЕЩЕНИЯХ клиентов клуба (визиты, Visit), а не на записях на занятия расписания. В ответе пользователю укажите, что данные собраны по посещениям.",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:39",
  "filters": { "branchId": null, "branchName": null, "extra": { "trainerIds": null } },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:20." ],
  "basis": "Статистика основана на ПОСЕЩЕНИЯХ клиентов клуба (визиты, Visit), а не на записях на занятия расписания. В ответе пользователю укажите, что данные собраны по посещениям.",
  "totalVisits": 3,
  "visitsWithTrainer": 0,
  "visitsWithoutTrainer": 3,
  "items": []
}

visits_statistics_by_service

Статистика по посещениям (визитам) в разрезе услуг (Visit.Service): serviceId, service, visits, uniqueClients, shareOfVisits, totalVisits; поле basis — данные собраны по посещениям. Параметры: период (по умолчанию текущий месяц, максимум 3 месяца), branchId (не указан — все филиалы), serviceKind (trial — только пробные услуги, guest — только гостевые), limit.

Пример запроса и ответа

«Какие услуги посещают чаще всего за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_statistics_by_service",
    "arguments": {
      "period": "last_n_days",
      "days": 30,
      "limit": 3
    }
  }
}
{
  "metric": "visits_statistics_by_service",
  "definition": "Посещения клиентов по услугам (Visit.Service): число визитов и уникальных клиентов. Статистика основана на ПОСЕЩЕНИЯХ клиентов клуба (визиты, Visit), а не на записях на занятия расписания. В ответе пользователю укажите, что данные собраны по посещениям.",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:41",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:20." ],
  "basis": "Статистика основана на ПОСЕЩЕНИЯХ клиентов клуба (визиты, Visit), а не на записях на занятия расписания. В ответе пользователю укажите, что данные собраны по посещениям.",
  "totalVisits": 3,
  "items": [
    {
      "serviceId": 132,
      "service": "Плавание (бассейн разовое)",
      "visits": 3,
      "uniqueClients": 1,
      "shareOfVisits": 100
    }
  ]
}

visits_statistics_by_basis

Статистика по посещениям (визитам) в разрезе основания — по чему клиенты проходили в клуб: basis (abonement — абонемент, club_card — клубная карта, one_time — разовая услуга, training — занятие по расписанию без купленной позиции, none — без основания), basisName, visits, uniqueClients, shareOfVisits; сверху totalVisits. Основание определяется по купленной позиции посещения (Visit.SaledService → вид продукта: Abonement, ClubCard, иначе разовая услуга), при её отсутствии — по занятию (Visit.Training_ID). Поле верхнего уровня basis — пояснение, что данные собраны по посещениям. Построчно с основанием — visits_list.

ПараметрТипОбяз.Описание
period/days/dateFrom/dateToнетПериод (по умолчанию текущий месяц, максимум 3 месяца).
branchIdintegerнетФилиал; не указан — все филиалы.
serviceKindstringнетtrial — только пробные услуги, guest — только гостевые.

Пример запроса и ответа

«По чему больше посещений — по абонементам или по разовым услугам?» (тестовая база Fit365Local, сентябрь–ноябрь 2020)

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "visits_statistics_by_basis",
    "arguments": {
      "period": "custom",
      "dateFrom": "2020-09-01",
      "dateTo": "2020-11-30"
    }
  }
}
{
  "metric": "visits_statistics_by_basis",
  "definition": "Посещения клиентов по основанию (абонемент, клубная карта, разовая услуга, занятие, без основания): число визитов и уникальных клиентов. Статистика основана на ПОСЕЩЕНИЯХ клиентов клуба (визиты, Visit), а не на записях на занятия расписания. В ответе пользователю укажите, что данные собраны по посещениям.",
  "period": {
    "start": "2020-09-01T00:00:00",
    "end": "2020-12-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2020-09-01 — 2020-11-30 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "filters": { "branchId": null, "branchName": null, "extra": { "serviceKind": null } },
  "warnings": [],
  "basis": "Статистика основана на ПОСЕЩЕНИЯХ клиентов клуба (визиты, Visit), а не на записях на занятия расписания. В ответе пользователю укажите, что данные собраны по посещениям.",
  "totalVisits": 55,
  "items": [
    {
      "basis": "training",
      "basisName": "Занятие по расписанию",
      "visits": 55,
      "uniqueClients": 13,
      "shareOfVisits": 100
    }
  ]
}

trials_conversion

Конверсия пробных: сколько клиентов были на пробных услугах за период и сколько из них потом купили абонемент или клубную карту. Пробное посещение — посещение по услуге с признаком «Пробная» (ServiceItem.IsTest, Visit.Service). «Купил» — у клиента есть абонемент или клубная карта с датой покупки (SaledService.Date) не раньше первого пробного посещения; позиции из отменённых и возвращённых продаж не считаются. Покупка может быть позже конца периода: берётся состояние на сейчас. По умолчанию срок покупки не ограничен (покупка через годы после пробной тоже считается), convertedWithinDays ограничивает окно (например, 30 дней). Ответ: trialVisits, trialClients, convertedClients, notConvertedClients, conversionPercent, byService (по каждой пробной услуге: visits, clients, convertedClients, conversionPercent), basis.

ПараметрТипОбяз.Описание
period/days/dateFrom/dateToнетПериод по дате пробного посещения (по умолчанию текущий месяц, максимум 3 месяца).
branchIdintegerнетФилиал; не указан — все филиалы.
serviceIdintegerнетID пробной услуги — только она.
convertedWithinDaysintegerнетОкно конверсии, дней (1..365): «купил» только если абонемент/клубная карта куплены не позже чем через N дней после первого пробного посещения. Не указано — без ограничения по сроку.

Пример запроса и ответа

«Сколько человек сходили на пробную в IV квартале 2019 и сколько из них купили абонемент?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "trials_conversion",
    "arguments": {
      "period": "custom",
      "dateFrom": "2019-10-01",
      "dateTo": "2019-12-31"
    }
  }
}
{
  "metric": "trials_conversion",
  "definition": "Конверсия пробных: клиенты, посетившие пробные услуги, и доля купивших после этого абонемент или клубную карту. Пробное посещение — посещение по услуге с признаком «Пробная» (Visit.Service). «Купил после пробной» — у клиента есть абонемент или клубная карта с датой покупки не раньше первого пробного посещения (позиции из отменённых и возвращённых продаж не считаются). Срок покупки после пробной не ограничен.",
  "period": {
    "start": "2019-10-01T00:00:00",
    "end": "2020-01-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2019-10-01 — 2019-12-31 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T02:02:00.9950263",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "serviceId": null,
      "convertedWithinDays": null
    }
  },
  "warnings": [],
  "basis": "Пробное посещение — посещение по услуге с признаком «Пробная» (Visit.Service). «Купил после пробной» — у клиента есть абонемент или клубная карта с датой покупки не раньше первого пробного посещения (позиции из отменённых и возвращённых продаж не считаются). Срок покупки после пробной не ограничен.",
  "trialVisits": 15,
  "trialClients": 15,
  "convertedClients": 1,
  "notConvertedClients": 14,
  "conversionPercent": 6.67,
  "byService": [
    {
      "serviceId": 12,
      "service": "Не указана",
      "visits": 15,
      "clients": 15,
      "convertedClients": 1,
      "conversionPercent": 6.67
    }
  ]
}

«А сколько купили в течение 30 дней после пробной?» (клиент, купивший через три года, в такую конверсию не попадает)

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "trials_conversion",
    "arguments": {
      "period": "custom",
      "dateFrom": "2019-10-01",
      "dateTo": "2019-12-31",
      "convertedWithinDays": 30
    }
  }
}
{
  "metric": "trials_conversion",
  "definition": "Конверсия пробных: клиенты, посетившие пробные услуги, и доля купивших после этого абонемент или клубную карту. Пробное посещение — посещение по услуге с признаком «Пробная» (Visit.Service). «Купил после пробной» — у клиента есть абонемент или клубная карта с датой покупки не раньше первого пробного посещения (позиции из отменённых и возвращённых продаж не считаются). Учитываются только покупки в течение 30 дн. после первого пробного посещения.",
  "period": {
    "start": "2019-10-01T00:00:00",
    "end": "2020-01-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2019-10-01 — 2019-12-31 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T02:01:27.9351942",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "serviceId": null,
      "convertedWithinDays": 30
    }
  },
  "warnings": [],
  "basis": "Пробное посещение — посещение по услуге с признаком «Пробная» (Visit.Service). «Купил после пробной» — у клиента есть абонемент или клубная карта с датой покупки не раньше первого пробного посещения (позиции из отменённых и возвращённых продаж не считаются). Учитываются только покупки в течение 30 дн. после первого пробного посещения.",
  "trialVisits": 15,
  "trialClients": 15,
  "convertedClients": 0,
  "notConvertedClients": 15,
  "conversionPercent": 0,
  "byService": [
    {
      "serviceId": 12,
      "service": "Не указана",
      "visits": 15,
      "clients": 15,
      "convertedClients": 0,
      "conversionPercent": 0
    }
  ]
}

trials_list

Список тех, кто был на пробной: по одной строке на клиента и пробную услугу (новые сверху): clientId, client («Фамилия Имя» полностью), serviceId, service, firstTrialDate, trialVisits, boughtAfter и purchase (name, date — первая покупка абонемента/карты после пробной; иначе null). Контакты — client_find / client_details по clientId. Итоговая конверсия числом — trials_conversion.

ПараметрТипОбяз.Описание
period/days/dateFrom/dateToнетПериод по дате пробного посещения (по умолчанию текущий месяц, максимум 3 месяца).
branchIdintegerнетФилиал.
serviceIdintegerнетID пробной услуги.
convertedbooleanнетfalse — был на пробной, но не купил (для обзвона); true — купил; не указан — все.
convertedWithinDaysintegerнетОкно конверсии, дней (1..365): «купил» только если абонемент/клубная карта куплены не позже чем через N дней после первого пробного посещения. Не указано — без ограничения по сроку.
limit / offsetintegerнетПостраничный вывод.

Пример запроса и ответа

«Кто был на пробной в IV квартале 2019 и не купил абонемент?» (первые 3)

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "trials_list",
    "arguments": {
      "period": "custom",
      "dateFrom": "2019-10-01",
      "dateTo": "2019-12-31",
      "converted": false,
      "limit": 3
    }
  }
}
{
  "metric": "trials_list",
  "definition": "Клиенты, посетившие пробные услуги, по датам первого пробного посещения, с признаком покупки абонемента/клубной карты после него. Пробное посещение — посещение по услуге с признаком «Пробная» (Visit.Service). «Купил после пробной» — у клиента есть абонемент или клубная карта с датой покупки не раньше первого пробного посещения (позиции из отменённых и возвращённых продаж не считаются). Срок покупки после пробной не ограничен. Имена — полностью («Фамилия Имя»): персональные данные, не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2019-10-01T00:00:00",
    "end": "2020-01-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2019-10-01 — 2019-12-31 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T02:02:22.2023449",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "serviceId": null,
      "converted": false,
      "convertedWithinDays": null
    }
  },
  "warnings": [],
  "basis": "Пробное посещение — посещение по услуге с признаком «Пробная» (Visit.Service). «Купил после пробной» — у клиента есть абонемент или клубная карта с датой покупки не раньше первого пробного посещения (позиции из отменённых и возвращённых продаж не считаются). Срок покупки после пробной не ограничен.",
  "page": {
    "total": 14,
    "limit": 3,
    "offset": 0,
    "hasMore": true
  },
  "items": [
    {
      "clientId": 67,
      "client": "Иванов Сергей",
      "serviceId": 12,
      "service": null,
      "firstTrialDate": "2019-12-29T18:06:00",
      "trialVisits": 1,
      "boughtAfter": false,
      "purchase": null
    },
    {
      "clientId": 66,
      "client": "Петрова Анна",
      "serviceId": 12,
      "service": null,
      "firstTrialDate": "2019-12-29T18:05:00",
      "trialVisits": 1,
      "boughtAfter": false,
      "purchase": null
    },
    {
      "clientId": 65,
      "client": "Сидоров Олег",
      "serviceId": 12,
      "service": null,
      "firstTrialDate": "2019-12-29T13:45:00",
      "trialVisits": 1,
      "boughtAfter": false,
      "purchase": null
    }
  ]
}

«А кто купил после пробной?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "trials_list",
    "arguments": {
      "period": "custom",
      "dateFrom": "2019-10-01",
      "dateTo": "2019-12-31",
      "converted": true,
      "limit": 3
    }
  }
}
{
  "metric": "trials_list",
  "definition": "Клиенты, посетившие пробные услуги, по датам первого пробного посещения, с признаком покупки абонемента/клубной карты после него. Пробное посещение — посещение по услуге с признаком «Пробная» (Visit.Service). «Купил после пробной» — у клиента есть абонемент или клубная карта с датой покупки не раньше первого пробного посещения (позиции из отменённых и возвращённых продаж не считаются). Срок покупки после пробной не ограничен. Имена — полностью («Фамилия Имя»): персональные данные, не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2019-10-01T00:00:00",
    "end": "2020-01-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2019-10-01 — 2019-12-31 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T02:02:43.3550418",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "serviceId": null,
      "converted": true,
      "convertedWithinDays": null
    }
  },
  "warnings": [],
  "basis": "Пробное посещение — посещение по услуге с признаком «Пробная» (Visit.Service). «Купил после пробной» — у клиента есть абонемент или клубная карта с датой покупки не раньше первого пробного посещения (позиции из отменённых и возвращённых продаж не считаются). Срок покупки после пробной не ограничен.",
  "page": {
    "total": 1,
    "limit": 3,
    "offset": 0,
    "hasMore": false
  },
  "items": [
    {
      "clientId": 41,
      "client": "Кузнецова Мария",
      "serviceId": 12,
      "service": null,
      "firstTrialDate": "2019-12-02T11:45:00",
      "trialVisits": 1,
      "boughtAfter": true,
      "purchase": {
        "name": "Занятия в группе",
        "date": "2022-11-21T11:48:21.483"
      }
    }
  ]
}

guest_visits

Гостевые посещения за период. Гостевое посещение — посещение по гостевой услуге (Service.IsGuestService) или с указанным пригласившим клиентом (Visit.WhoInvited). Ответ: totalVisits, guestVisits, guestSharePercent, uniqueGuests, byGuestService (посещения по гостевой услуге), byInvitation (посещения по приглашению), services (гостевые услуги: visits, uniqueGuests), topInviters (кто приглашает больше всего: guestVisits, uniqueGuests). Построчный список — visits_list с serviceKind=guest. Посещения сотрудников не учитываются.

ПараметрТипОбяз.Описание
period/days/dateFrom/dateToнетПериод (по умолчанию текущий месяц, максимум 3 месяца).
branchIdintegerнетФилиал; не указан — все филиалы.
limitintegerнетРазмер рейтингов services и topInviters (по умолчанию 10).

Пример запроса и ответа

«Сколько было гостевых посещений во II квартале 2022?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "guest_visits",
    "arguments": {
      "period": "custom",
      "dateFrom": "2022-04-01",
      "dateTo": "2022-06-30",
      "limit": 3
    }
  }
}
{
  "metric": "guest_visits",
  "definition": "Гостевые посещения: по гостевой услуге (Service.IsGuestService) или с указанным пригласившим клиентом (Visit.WhoInvited). Посещения сотрудников не учитываются.",
  "period": {
    "start": "2022-04-01T00:00:00",
    "end": "2022-07-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2022-04-01 — 2022-06-30 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T01:48:35.493005",
  "filters": {
    "branchId": null,
    "branchName": null
  },
  "warnings": [],
  "totalVisits": 41,
  "guestVisits": 8,
  "guestSharePercent": 19.51,
  "uniqueGuests": 5,
  "byGuestService": 8,
  "byInvitation": 0,
  "services": [
    {
      "serviceId": 21,
      "service": "Стретчинг",
      "visits": 6,
      "uniqueGuests": 3
    },
    {
      "serviceId": 27,
      "service": "Не указана",
      "visits": 1,
      "uniqueGuests": 1
    },
    {
      "serviceId": 83,
      "service": "Пробная тренировка",
      "visits": 1,
      "uniqueGuests": 1
    }
  ],
  "topInviters": []
}

Клиенты

client_details

Детальная карточка одного клиента по clientId (ID даёт client_find): type («Клиент» или «Клиент (отмечен как потенциальный, IsLead)»), ФИО (фамилия, имя, отчество middleName), дата рождения, телефон, e-mail, inn (ИНН), паспортные данные passport (series, number, issuedBy, issuedDate), адрес address (country, stateProvince, zipPostal, city, street; null, если адреса нет), филиал; паспорт и адрес нужны, в частности, для справок в органы власти; тренер (Client.Executor: trainerId, trainer), менеджер (Client.Manager: managerId, manager); nearestPaymentDate (ближайший платёж по рассрочке), overdueByCredit, overdueByPayment (задолженности, NULL → 0); активная карта — activeCard (saledServiceId, name, statusId, status: Не активна/Активна/Заморожена/Закончена/Приостановлена, date, dateActivation, dateTill). Карта берётся из поля Client.ClubCardOwn; если оно пусто — hasActiveCard = false, activeCard = null и пояснение в note (коллекция карт не просматривается).

ПараметрТипОбяз.Описание
clientIdintegerдаID клиента. Открывается любая запись типа «клиент», в том числе с флагом «потенциальный» (IsLead): в ответе её тип указан в поле type. Не найден (или это сотрудник/лид) → ошибка с подсказкой про client_find.

Пример запроса и ответа

«Покажи карточку клиента 1482.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "client_details",
    "arguments": {
      "clientId": 1482
    }
  }
}
{
  "metric": "client_details",
  "definition": "Карточка клиента (Client): ФИО, контакты, паспортные данные, адрес, тренер (Executor), менеджер, платежи/долги, активная карта (Client.ClubCardOwn). Содержит персональные данные (полное ФИО, телефон, e-mail, дата рождения, паспорт, адрес).",
  "asOf": "2026-10-23T18:20:43",
  "filters": { "branchId": null, "branchName": null, "extra": { "clientId": 1482 } },
  "warnings": [],
  "client": {
    "clientId": 1482,
    "type": "Клиент",
    "fullName": "Васечкин Иван",
    "lastName": "Васечкин",
    "firstName": "Иван",
    "middleName": "",
    "birthDate": null,
    "inn": null,
    "passport": { "series": null, "number": null, "issuedBy": null, "issuedDate": null },
    "address": { "country": "Россия", "stateProvince": null, "zipPostal": null, "city": null, "street": null },
    "phone": "+79001234567",
    "email": null,
    "branchId": 1084,
    "branch": "fitness365 Москва",
    "trainerId": null,
    "trainer": null,
    "managerId": 132,
    "manager": "Васина Юлия",
    "nearestPaymentDate": null,
    "overdueByCredit": 0.0,
    "overdueByPayment": 0.0,
    "hasActiveCard": true,
    "activeCard": {
      "saledServiceId": 4951,
      "name": "абонемент на мес + 10 ГТ",
      "statusId": 2,
      "status": "Активна",
      "date": "2026-08-28T23:02:04.973",
      "dateActivation": "2026-08-28T23:02:34.513",
      "dateTill": "2026-10-27T23:59:00"
    }
  },
  "note": null
}

client_services

Все услуги клиента по clientId (Client.SaledServices): абонементы, клубные карты и разовые услуги, по одной строке на позицию, новые покупки сверху (SaledService.Date), с пагинацией. Поля строки: saledServiceId, serviceId, name (наименование продукта), category, type (Абонемент / Клубная карта / Услуга), isAbonement, isClubCard, isService, count (доступное количество), statusId/status (Не активна, Активна, Заморожена, Закончена, Приостановлена), description (комментарий), date (покупка), dateActivation, dateTill. Признаки типа считаются по типу продукта (XPObjectType: Abonement / ClubCard / ServiceItem), как IsExactType в XPO. Клиент не найден → ошибка с подсказкой про client_find.

ПараметрТипОбяз.Описание
clientIdintegerдаID клиента (client_find).
onlyCurrentbooleanнетtrue — только действующие: все, кроме закончившихся (статус «Закончена»); не активированные, активные, замороженные и приостановленные остаются. По умолчанию false — вся история.
limit / offsetintegerнетПостраничный вывод.

Пример запроса и ответа

«Какие услуги и абонементы сейчас есть у клиента 1482?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "client_services",
    "arguments": {
      "clientId": 1482,
      "onlyCurrent": true,
      "limit": 3
    }
  }
}
{
  "metric": "client_services",
  "definition": "Услуги клиента (SaledService): абонементы, клубные карты, разовые услуги. count — доступное количество; тип определяется типом продукта (isAbonement / isClubCard / isService).",
  "asOf": "2026-10-23T18:20:48",
  "filters": { "branchId": null, "branchName": null, "extra": { "clientId": 1482, "onlyCurrent": true } },
  "warnings": [],
  "client": { "clientId": 1482, "name": "Васечкин Иван" },
  "page": { "total": 2, "limit": 3, "offset": 0, "hasMore": false },
  "items": [
    {
      "saledServiceId": 4952,
      "serviceId": 212,
      "name": "ПТ-10",
      "category": "Абонементы",
      "type": "Абонемент",
      "isAbonement": true,
      "isClubCard": false,
      "isService": false,
      "count": 10,
      "statusId": 2,
      "status": "Активна",
      "description": null,
      "date": "2026-08-28T23:08:49.99",
      "dateActivation": "2026-08-28T21:09:01.297",
      "dateTill": "2027-06-27T23:59:00"
    },
    {
      "saledServiceId": 4951,
      "serviceId": 210,
      "name": "абонемент на мес + 10 ГТ",
      "category": "Абонементы",
      "type": "Абонемент",
      "isAbonement": true,
      "isClubCard": false,
      "isService": false,
      "count": 5,
      "statusId": 2,
      "status": "Активна",
      "description": null,
      "date": "2026-08-28T23:02:04.973",
      "dateActivation": "2026-08-28T23:02:34.513",
      "dateTill": "2026-10-27T23:59:00"
    }
  ]
}

client_purchases_total

Общая сумма покупок одного клиента за произвольный промежуток дат (год, два года и т. д.): totalAmount (проведённые продажи, Transaction.Summ после скидок), salesCount, averageCheck, firstPurchase, lastPurchase, returned (число и сумма продаж в статусе «Возврат»). Ограничение периода в 3 месяца не действует (исключение владельца, как у sales_list по клиенту). Построчный список — sales_list.

ПараметрТипОбяз.Описание
clientIdintegerдаID клиента (client_find).
yearsintegerнетОкно назад от сегодня: за год — years=1, за два года — years=2.
monthsintegerнетОкно назад от сегодня: за месяц — months=1, полгода — months=6; можно вместе с years.
dateFrom / dateTostringнетЛюбой период yyyy-MM-dd (включительно). Нельзя вместе с years/months.
branchIdintegerнетФилиал.

Без параметров периода — за всё время.

Пример запроса и ответа

«На какую сумму клиент 1482 купил за последний год?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "client_purchases_total",
    "arguments": {
      "clientId": 1482,
      "years": 1
    }
  }
}
{
  "metric": "client_purchases_total",
  "definition": "Итоги покупок клиента за период: сумма проведённых продаж (Transaction.Summ, после скидок), число продаж, средний чек, первая/последняя покупка; returned — продажи в статусе «Возврат».",
  "period": {
    "start": "2025-10-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2025-10-24 — 2026-10-23 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:50",
  "filters": { "branchId": null, "branchName": null, "extra": { "clientId": 1482 } },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:20." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "clientId": 1482,
  "client": "Васечкин Иван",
  "totalAmount": 195000.0,
  "salesCount": 6,
  "averageCheck": 32500.0,
  "firstPurchase": "2026-08-28T22:12:56.387",
  "lastPurchase": "2026-08-28T23:08:49.99",
  "returned": { "count": 0, "amount": 0 }
}

client_find

Найти конкретного клиента (или лида) и получить карточку: clientId, полное ФИО (фамилия, имя, отчество), телефон, e-mail, дата рождения, тип (клиент/лид), филиал. Главное назначение — узнать clientId по имени, телефону или e-mail для инструментов, которым нужен clientId (client_visits, sales_list, crm_tasks_list, returns_list …). Условия объединяются по «И»; сотрудники не ищутся; результат — до limit (по умолчанию 20) совпадений с пагинацией (однофамильцы, общий номер семьи — показывайте список и уточняйте).

ПараметрТипОбяз.Описание
lastNamestringнетНачало фамилии (именительный падеж). Только вместе с firstName.
firstNamestringнетНачало имени (именительный падеж). Только вместе с lastName. Одна из частей без другой → ошибка.
phonestringнетМобильный телефон в любом формате, не менее 7 цифр; точное совпадение по TelefoneCellForSearch (индекс).
emailstringнетАдрес целиком, точное совпадение без учёта регистра (индекса на Contragent.Email нет — поиск полным просмотром таблицы).
clientIdintegerнетКарточка по известному ID.
limit / offsetintegerнетПостраничный вывод.

Нужно указать хотя бы одно из: пара lastName+firstName, phone, email, clientId.

Пример запроса и ответа

«Найди клиента с id 1482.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "client_find",
    "arguments": {
      "clientId": 1482
    }
  }
}
{
  "metric": "client_find",
  "definition": "Поиск клиентов и лидов по ФИО (фамилия+имя), телефону, e-mail или ID. Условия объединяются по «И». Сотрудники не ищутся. Содержит персональные данные (полное ФИО, телефон, e-mail, дата рождения).",
  "asOf": "2026-10-23T18:22:56",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": { "clientId": 1482, "lastName": null, "firstName": null, "phone": null, "email": null }
  },
  "warnings": [],
  "page": { "total": 1, "limit": 20, "offset": 0, "hasMore": false },
  "items": [
    {
      "clientId": 1482,
      "fullName": "Васечкин Иван",
      "lastName": "Васечкин",
      "firstName": "Иван",
      "middleName": "",
      "type": "Клиент",
      "phone": "+79001234567",
      "email": null,
      "birthDate": null,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    }
  ]
}

clients_new

Новые клиенты за период (дата создания карточки Contragent.Date): количество, сравнение с предыдущим периодом (compare=true) и, при includeList=true, список (имя и инициал фамилии, дата регистрации, филиал). Для «сколько новых клиентов за неделю/месяц», «кто зарегистрировался сегодня/вчера».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
comparebooleanнетtrue — добавить сравнение с предыдущим периодом (разница и процент изменения).
includeListbooleanнетtrue — вернуть постраничный список новых клиентов.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Сколько новых клиентов пришло за прошлый месяц?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_new",
    "arguments": {
      "period": "last_month",
      "compare": true
    }
  }
}
{
  "metric": "new_clients",
  "definition": "Количество клиентов (кроме потенциальных), карточка которых создана в указанном периоде.",
  "period": {
    "start": "2026-09-01T00:00:00",
    "end": "2026-10-01T00:00:00",
    "interval": "[start, end)",
    "kind": "last_month",
    "label": "Прошлый календарный месяц",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:57",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [],
  "value": 1,
  "unit": "clients",
  "comparison": {
    "previousPeriod": {
      "start": "2026-08-01T00:00:00",
      "end": "2026-09-01T00:00:00",
      "interval": "[start, end)",
      "kind": "last_month",
      "label": "Предыдущий календарный месяц",
      "timezone": "Europe/Moscow"
    },
    "clients": { "current": 1, "previous": 14, "absoluteChange": -13, "percentChange": -92.86, "note": null }
  }
}

clients_deleted

Список УДАЛЁННЫХ клиентов (карточки с пометкой удаления, GCRecord не пуст; потенциальные клиенты не входят): clientId, имя и инициал фамилии, дата создания карточки, филиал; новые карточки сверху, постранично, плюс общее количество. Дата удаления в системе не хранится, поэтому период отбирает по дате создания карточки и необязателен: без периода возвращаются все удалённые клиенты (с периодом действует лимит 3 месяца).

ПараметрТипОбяз.Описание
period/days/dateFrom/dateToнетПериод по дате создания карточки; без них — все удалённые.
branchIdintegerнетID филиала. Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Какие клиенты удалены за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_deleted",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "limit": 2
    }
  }
}
{
  "metric": "deleted_clients",
  "definition": "Клиенты (кроме потенциальных), карточки которых удалены (мягкое удаление). Дата удаления не хранится: период, если задан, — по дате создания карточки.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:20:59",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:20." ],
  "value": 0,
  "unit": "clients",
  "page": { "total": 0, "limit": 2, "offset": 0, "hasMore": false },
  "items": []
}

clients_registration_dynamics

Динамика регистраций новых клиентов по дням/неделям/месяцам за период (например «сравни количество новых клиентов по неделям за 3 месяца»: period=last_n_days, days=90, granularity=week).

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
granularitystringнетШаг ряда: day, week (с понедельника) или month. По умолчанию day для периодов до 31 дня, иначе week.

Пример запроса и ответа

«Сравни число новых клиентов по неделям за 3 месяца.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_registration_dynamics",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "granularity": "month"
    }
  }
}
{
  "metric": "clients_registration_dynamics",
  "definition": "Количество новых клиентов по интервалам ряда.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:01",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "granularity": "month",
  "total": 15,
  "items": [
    { "date": "2026-07-01T00:00:00", "newClients": 0 },
    { "date": "2026-08-01T00:00:00", "newClients": 14 },
    { "date": "2026-09-01T00:00:00", "newClients": 1 },
    { "date": "2026-10-01T00:00:00", "newClients": 0 }
  ]
}

clients_overview

Состояние клиентской базы на сейчас: всего клиентов, активных (с действующим абонементом/клубной картой), с замороженным абонементом, заблокированных, клиентов с задолженностью и её сумма, активные по филиалам. Для «сколько активных клиентов», «сколько заблокировано», «сколько клиентов с задолженностью».

ПараметрТипОбяз.Описание
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Сколько всего клиентов, активных и неактивных?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_overview",
    "arguments": {}
  }
}
{
  "metric": "clients_overview",
  "definition": "Клиентская база на текущий момент (клиенты без потенциальных).",
  "asOf": "2026-10-23T18:21:04",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [],
  "totalClients": 574,
  "activeClients": 14,
  "frozenClients": 0,
  "blockedClients": 5,
  "clientsWithDebt": {
    "clients": 39,
    "overdueByPayment": 12597.0,
    "overdueByCredit": 204530.5,
    "currency": "валюта учёта клуба (валюта в БД не хранится)"
  },
  "activeByBranch": [
    { "branchId": 1084, "branch": "fitness365 Москва", "clients": 10 },
    { "branchId": 1, "branch": "Без филиала", "clients": 4 }
  ],
  "definitions": {
    "active": "Абонемент/клубная карта в статусе «Активна» со сроком окончания не раньше текущего момента.",
    "debt": "Клиент с признаком просрочки платежа (IsPresentOverdue); суммы — Client.OverdueByPayment и Client.OverdueByCredit."
  }
}

clients_gender_distribution

Распределение клиентов по полу в целом и по филиалам; кого больше — мужчин или женщин (в том числе в конкретном филиале). По умолчанию — только клиенты с действующим абонементом.

ПараметрТипОбяз.Описание
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
onlyActivebooleanнетtrue (по умолчанию) — только клиенты с действующим абонементом; false — все клиенты.

Пример запроса и ответа

«Каково соотношение мужчин и женщин среди активных клиентов?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_gender_distribution",
    "arguments": {
      "onlyActive": true
    }
  }
}
{
  "metric": "clients_gender_distribution",
  "definition": "Распределение клиентов по полу и филиалам (только с действующим абонементом).",
  "asOf": "2026-10-23T18:21:08",
  "filters": { "branchId": null, "branchName": null, "extra": { "onlyActive": true } },
  "warnings": [],
  "overall": { "female": 0, "male": 0, "unknown": 14, "total": 14, "predominant": "equal" },
  "byBranch": [
    {
      "branchId": 1084,
      "branch": "fitness365 Москва",
      "female": 0,
      "male": 0,
      "unknown": 10,
      "total": 10,
      "predominant": "equal"
    },
    {
      "branchId": 1,
      "branch": "Без филиала",
      "female": 0,
      "male": 0,
      "unknown": 4,
      "total": 4,
      "predominant": "equal"
    }
  ]
}

clients_age_distribution

Распределение клиентов по возрастным группам (до 18, 18–24, 25–34, 35–44, 45–54, 55+, не указан). По умолчанию — только клиенты с действующим абонементом.

ПараметрТипОбяз.Описание
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
onlyActivebooleanнетtrue (по умолчанию) — только клиенты с действующим абонементом; false — все клиенты.

Пример запроса и ответа

«Каков возраст активных клиентов?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_age_distribution",
    "arguments": {
      "onlyActive": true
    }
  }
}
{
  "metric": "clients_age_distribution",
  "definition": "Распределение клиентов по возрастным группам на сегодняшнюю дату.",
  "asOf": "2026-10-23T18:21:11",
  "filters": { "branchId": null, "branchName": null, "extra": { "onlyActive": true } },
  "warnings": [],
  "total": 14,
  "items": [
    { "ageGroup": "до 18", "clients": 1, "share": 7.14 },
    { "ageGroup": "18–24", "clients": 0, "share": 0 },
    { "ageGroup": "25–34", "clients": 0, "share": 0 }
  ]
}

Для краткости в примере сокращены длинные массивы (items): показаны первые 3 элемента.

clients_birthdays

Клиенты, у которых день рождения в заданные даты (по умолчанию — сегодня; для «ближайших 7 дней» задайте dateFrom=сегодня, dateTo=+6 дней). Диапазон не более 31 дня. Только имя и инициал фамилии.

ПараметрТипОбяз.Описание
dateFromstringнетПервая дата, yyyy-MM-dd; по умолчанию сегодня.
dateTostringнетПоследняя дата включительно, yyyy-MM-dd; по умолчанию = dateFrom.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«У кого из клиентов день рождения на ближайшей неделе?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_birthdays",
    "arguments": {
      "dateFrom": "2026-10-23",
      "dateTo": "2026-10-30",
      "limit": 3
    }
  }
}
{
  "metric": "client_birthdays",
  "definition": "Клиенты (кроме потенциальных) с днём рождения в указанные даты. Только имя и инициал фамилии.",
  "asOf": "2026-10-23T18:21:13",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": { "dateFrom": "2026-10-23T00:00:00", "dateTo": "2026-10-30T00:00:00" }
  },
  "warnings": [],
  "value": 2,
  "unit": "clients",
  "page": { "total": 2, "limit": 3, "offset": 0, "hasMore": false },
  "items": [
    {
      "clientId": 1304,
      "name": "Мария П.",
      "birthday": "2026-10-23T00:00:00",
      "age": 7,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    },
    {
      "clientId": 153,
      "name": "Анастасия К.",
      "birthday": "2026-10-27T00:00:00",
      "age": 43,
      "branchId": 1,
      "branch": "Без филиала"
    }
  ]
}

clients_by_source

Источники привлечения новых клиентов за период (InformationSource): сколько клиентов пришло из каждого источника.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Откуда приходят новые клиенты за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_by_source",
    "arguments": {
      "period": "last_n_days",
      "days": 90
    }
  }
}
{
  "metric": "clients_by_source",
  "definition": "Новые клиенты периода по источнику привлечения (InformationSource).",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:06",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "total": 15,
  "items": [
    { "source": "Не указан", "clients": 4, "share": 26.67 },
    { "source": "Виджет на сайте", "clients": 3, "share": 20 },
    { "source": "Instagram", "clients": 3, "share": 20 }
  ]
}

Для краткости в примере сокращены длинные массивы (items): показаны первые 3 элемента.

leads_conversion

Лиды (потенциальные клиенты), созданные за период, и конверсия в клиентов (у лида заполнен созданный клиент). Для «сколько лидов и какова конверсия».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Какая конверсия лидов в клиентов за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "leads_conversion",
    "arguments": {
      "period": "last_n_days",
      "days": 90
    }
  }
}
{
  "metric": "leads_conversion",
  "definition": "Лиды, созданные в периоде, и доля конвертированных в клиентов.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:23",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21.",
    "Конверсия — доля лидов периода, у которых к моменту запроса создан клиент; лиды, которые сконвертируются позже, в конверсию пока не входят."
  ],
  "value": 12,
  "unit": "leads",
  "converted": 12,
  "conversionPercent": 100
}

clients_without_active_abonement

Клиенты, у которых когда-либо был абонемент/клубная карта, но сейчас нет действующего, замороженного или ещё не активированного (кандидаты на возврат). Количество и постраничный список.

ПараметрТипОбяз.Описание
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Какие клиенты остались без действующего абонемента?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_without_active_abonement",
    "arguments": {
      "limit": 3
    }
  }
}
{
  "metric": "clients_without_active_abonement",
  "definition": "Клиенты с прошлым абонементом/картой, но без действующего, замороженного или неактивированного сейчас.",
  "asOf": "2026-10-23T18:21:18",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [],
  "value": 149,
  "unit": "clients",
  "page": { "total": 149, "limit": 3, "offset": 0, "hasMore": true },
  "items": [
    { "clientId": 341, "name": "Ольга В.", "lastVisit": null, "branchId": 1, "branch": "Без филиала" },
    { "clientId": 354, "name": "Александр Т.", "lastVisit": null, "branchId": 1, "branch": "Без филиала" },
    { "clientId": 364, "name": "Марина З.", "lastVisit": null, "branchId": 1, "branch": "Без филиала" }
  ]
}

clients_debtors

Список клиентов-должников на сейчас: кто должен клубу, сколько и с какой давности. Два вида долга: credit — долг по кредиту (проведённые продажи в кредит с неоплаченным остатком Sale.RestSumm), installment — просрочка по рассрочке (неоплаченные платежи графика PaymentScheduleItem со сроком в прошлом; будущие платежи не считаются). Порядок: сначала должники по кредитам (по убыванию общей суммы), затем остальные. Поле Client.OverdueByCredit не используется: после разовой миграции его никто не пересчитывает. Имена — полностью («Фамилия Имя»): персональные данные. Поставить задачу обзвона — crm_task_create по каждому clientId.

ПараметрТипОбяз.Описание
debtTypestringнетcredit — только долг по кредиту; installment — только просрочка по рассрочке; any или не указан — оба вида. Иное значение → ошибка.
branchIdintegerнетФилиал, где оформлена продажа в кредит / платёж по графику. Без параметра — весь клуб.
minAmountnumberнетМинимальная общая сумма долга (кредит + просрочка рассрочки).
dateFrom / dateTostringнетНеобязательный диапазон даты возникновения долга (дата продажи в кредит / дата платежа по графику), yyyy-MM-dd, включительно. Без ограничения по умолчанию: инструмент показывает долг на сейчас.
limit / offsetintegerнетПостраничный вывод.

В ответе summary (число должников по видам, суммы) считается по всему отбору, а не по странице. В строке: debtTypes, totalDebt, для кредита — creditDebt, creditSales, creditOldestSaleDate, для рассрочки — installmentOverdue, installmentOverduePayments, installmentOldestDueDate, installmentDaysOverdue.

Пример запроса и ответа

«Покажи должников по кредитам.» (тестовая база Fit365Local)

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_debtors",
    "arguments": {
      "debtType": "credit",
      "limit": 2
    }
  }
}
{
  "metric": "clients_debtors",
  "filters": { "branchId": null, "branchName": null, "extra": { "debtType": "credit", "minAmount": null, "dateFrom": null, "dateTo": null } },
  "summary": {
    "debtors": 12,
    "creditDebtors": 12,
    "installmentDebtors": 0,
    "bothKinds": 0,
    "creditAmount": 3003,
    "installmentOverdueAmount": 0,
    "totalAmount": 3003,
    "currency": "валюта учёта клуба (валюта в БД не хранится)"
  },
  "page": { "total": 12, "limit": 2, "offset": 0, "hasMore": true },
  "items": [
    {
      "clientId": 141,
      "client": "Арен Арсен",
      "branchId": 1,
      "branch": "fitness",
      "debtTypes": [ "credit" ],
      "totalDebt": 1000,
      "creditDebt": 1000,
      "creditSales": 14,
      "creditOldestSaleDate": "2020-08-27T21:30:00",
      "installmentOverdue": null,
      "installmentOverduePayments": null,
      "installmentOldestDueDate": null,
      "installmentDaysOverdue": null
    }
  ]
}

clients_top_by_purchases

Топ клиентов по сумме проведённых покупок за период (сумма продаж после скидок, количество покупок). Имя — только инициал фамилии.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).

Пример запроса и ответа

«Кто купил больше всего за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_top_by_purchases",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "limit": 3
    }
  }
}
{
  "metric": "clients_top_by_purchases",
  "definition": "Клиенты с наибольшей суммой проведённых продаж за период (Transaction.Summ, покупатель — Transaction.Contragent).",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:21",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "items": [
    { "clientId": 1482, "name": "Иван В.", "purchases": 6, "amount": 195000.0 },
    { "clientId": 1096, "name": "O O.", "purchases": 1, "amount": 55000.0 },
    { "clientId": 1483, "name": "Петр П.", "purchases": 1, "amount": 55000.0 }
  ]
}

Абонементы

abonements_expiring

Абонементы и клубные карты (статус «Активна»), которые заканчиваются сегодня и в ближайшие N дней: количество, по филиалам и постраничный список (клиент — имя и инициал, срок окончания). Для «сколько абонементов заканчивается в ближайшие 7 дней», «какие истекают на этой неделе по филиалам».

ПараметрТипОбяз.Описание
daysintegerнетГоризонт в днях от сегодня включительно (по умолчанию 7, максимум ≈ 92).
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Какие абонементы заканчиваются в ближайшие 7 дней?» Инструмент возвращает общее число, разбивку byBranch и страницу items. Имена клиентов в формате «Имя Ф.».

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "abonements_expiring",
    "arguments": {
      "days": 7,
      "limit": 20,
      "offset": 0
    }
  }
}
{
  "metric": "abonements_expiring",
  "definition": "Действующие абонементы и клубные карты (статус «Активна»), срок которых заканчивается с 2026-10-23 по 2026-10-30 включительно.",
  "asOf": "2026-10-23T16:31:59",
  "filters": { "branchId": null, "branchName": null, "extra": { "days": 7 } },
  "warnings": [],
  "value": 2,
  "unit": "abonements",
  "window": { "start": "2026-10-23T00:00:00", "end": "2026-10-31T00:00:00", "interval": "[start, end)", "timezone": "Europe/Moscow" },
  "byBranch": [ { "branchId": 1084, "branch": "fitness365 Москва", "abonements": 2 } ],
  "page": { "total": 2, "limit": 20, "offset": 0, "hasMore": false },
  "items": [
    { "abonementId": 4951, "clientId": 1482, "client": "Иван В.", "service": "абонемент на мес + 10 ГТ",
      "expires": "2026-10-27T23:59:00", "daysLeft": 4, "branchId": 1084, "branch": "fitness365 Москва" },
    { "abonementId": 4953, "clientId": 1484, "client": "Первый П.", "service": "абонемент на мес + 10 ГТ",
      "expires": "2026-10-28T23:59:00", "daysLeft": 5, "branchId": 1084, "branch": "fitness365 Москва" }
  ]
}

Если page.hasMore = true, повторите запрос с "offset": 20 и так далее.

abonements_low_remaining_visits

Абонементы «по количеству посещений» (AccessType = ByCount), у которых осталось не больше N посещений (по умолчанию 3) и срок ещё не истёк. Для «сколько абонементов скоро закончится по количеству посещений».

ПараметрТипОбяз.Описание
thresholdintegerнетПорог остатка посещений включительно (по умолчанию 3).
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«У кого осталось 2 и меньше посещений?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "abonements_low_remaining_visits",
    "arguments": {
      "threshold": 2,
      "limit": 3
    }
  }
}
{
  "metric": "abonements_low_remaining_visits",
  "definition": "Действующие абонементы по количеству посещений с остатком ≤ 2 посещений.",
  "asOf": "2026-10-23T18:21:32",
  "filters": { "branchId": null, "branchName": null, "extra": { "threshold": 2 } },
  "warnings": [],
  "value": 0,
  "unit": "abonements",
  "page": { "total": 0, "limit": 3, "offset": 0, "hasMore": false },
  "items": []
}

abonements_expired

Сколько абонементов/клубных карт истекло (срок окончания уже наступил) за период, всего и по филиалам. Для «сколько абонементов истекло за последний месяц».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Сколько абонементов закончилось за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "abonements_expired",
    "arguments": {
      "period": "last_n_days",
      "days": 30
    }
  }
}
{
  "metric": "abonements_expired",
  "definition": "Абонементы и клубные карты, срок окончания которых приходится на период и уже наступил (неактивированные не считаются).",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:27",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "value": 2,
  "unit": "abonements",
  "byBranch": [
    { "branchId": 1, "branch": "Без филиала", "abonements": 1 },
    { "branchId": 1084, "branch": "fitness365 Москва", "abonements": 1 }
  ]
}

abonements_renewal

Продления абонементов за период: сколько закончилось, сколько продлено и НЕ продлено, доля продлений и непродлений, в разрезе филиалов; сравнение с предыдущим периодом (compare=true). Для «какова доля продлений», «сколько клиентов не продлило абонемент».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
comparebooleanнетtrue — добавить сравнение с предыдущим периодом (разница и процент изменения).

Пример запроса и ответа

«Какая доля клиентов продлила абонемент за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "abonements_renewal",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "compare": true
    }
  }
}
{
  "metric": "abonements_renewal",
  "definition": "Продления и непродления абонементов: абонементы и клубные карты, закончившиеся в периоде, и их продление. Доля непродления = не продлённые / закончившиеся.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:36",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21.",
    "Считаются абонементы, а не клиенты: клиент с несколькими закончившимися абонементами учитывается несколько раз. Абонемент считается продлённым, если у клиента есть другой абонемент с более поздней датой окончания.",
    "Текущий период не завершён: предыдущий взят за такое же прошедшее время (2026-04-27 00:00 — 2026-07-25 18:21), чтобы сравнение было корректным."
  ],
  "value": 8,
  "unit": "abonements",
  "ended": 11,
  "renewed": 3,
  "notRenewed": 8,
  "renewalRatePercent": 27.27,
  "nonRenewalRatePercent": 72.73,
  "byBranch": [
    {
      "branchId": 1084,
      "branch": "fitness365 Москва",
      "ended": 6,
      "notRenewed": 4,
      "nonRenewalRatePercent": 66.67
    },
    { "branchId": null, "branch": null, "ended": 3, "notRenewed": 2, "nonRenewalRatePercent": 66.67 },
    { "branchId": 1, "branch": "Без филиала", "ended": 2, "notRenewed": 2, "nonRenewalRatePercent": 100 }
  ],
  "comparison": {
    "previousPeriod": {
      "start": "2026-04-27T00:00:00",
      "end": "2026-07-25T18:21:36.8101317",
      "interval": "[start, end)",
      "kind": "last_n_days",
      "label": "Предыдущий период такой же длины (за такое же прошедшее время)",
      "timezone": "Europe/Moscow"
    },
    "ended": { "current": 11, "previous": 18, "absoluteChange": -7, "percentChange": -38.89, "note": null },
    "notRenewed": { "current": 8, "previous": 9, "absoluteChange": -1, "percentChange": -11.11, "note": null },
    "nonRenewalRatePercent": { "current": 72.73, "previous": 50, "absoluteChange": 22.73, "percentChange": 45.46, "note": null }
  }
}

abonements_renewal_dynamics

Динамика продлений по календарным месяцам внутри периода (до 3 месяцев): по каждому месяцу — сколько абонементов закончилось, продлено и не продлено. Для «какова динамика продлений по месяцам».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Как менялась доля продлений по месяцам за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "abonements_renewal_dynamics",
    "arguments": {
      "period": "last_n_days",
      "days": 90
    }
  }
}
{
  "metric": "abonements_renewal_dynamics",
  "definition": "Закончившиеся и продлённые абонементы по календарным месяцам периода.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:39",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21.",
    "Крайние месяцы могут быть неполными (границы указаны в from/to). Абонемент считается продлённым, если у клиента есть другой абонемент с более поздней датой окончания."
  ],
  "items": [
    {
      "month": "2026-07",
      "from": "2026-07-26T00:00:00",
      "to": "2026-08-01T00:00:00",
      "ended": 0,
      "renewed": 0,
      "notRenewed": 0,
      "renewalRatePercent": null
    },
    {
      "month": "2026-08",
      "from": "2026-08-01T00:00:00",
      "to": "2026-09-01T00:00:00",
      "ended": 7,
      "renewed": 3,
      "notRenewed": 4,
      "renewalRatePercent": 42.86
    },
    {
      "month": "2026-09",
      "from": "2026-09-01T00:00:00",
      "to": "2026-10-01T00:00:00",
      "ended": 3,
      "renewed": 0,
      "notRenewed": 3,
      "renewalRatePercent": 0
    },
    {
      "month": "2026-10",
      "from": "2026-10-01T00:00:00",
      "to": "2026-10-24T00:00:00",
      "ended": 1,
      "renewed": 0,
      "notRenewed": 1,
      "renewalRatePercent": 0
    }
  ]
}

abonements_popularity

Самые популярные абонементы и клубные карты: сколько продано за период (позиции проведённых продаж без возвратов) и сколько сейчас действующих, с суммой продаж; byBranch=true — в разрезе филиалов (для «сравни популярность абонементов по филиалам»).

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
byBranchbooleanнетtrue — вывести рейтинг отдельно по каждому филиалу.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).

Пример запроса и ответа

«Какие абонементы покупают чаще всего за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "abonements_popularity",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "limit": 3
    }
  }
}
{
  "metric": "abonements_popularity",
  "definition": "Популярность абонементов и клубных карт: проданные позиции (проведённые продажи без возвратов), их сумма после скидок и число сейчас действующих.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:34",
  "filters": { "branchId": null, "branchName": null, "extra": { "byBranch": false } },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "totalSold": 20,
  "items": [
    { "productId": 146, "name": "Безлимит 1 мес", "sold": 6, "amount": 12900.0, "share": 30, "activeNow": 0 },
    {
      "productId": 210,
      "name": "абонемент на мес + 10 ГТ",
      "sold": 5,
      "amount": 75000.0,
      "share": 25,
      "activeNow": 2
    },
    { "productId": 212, "name": "ПТ-10", "sold": 3, "amount": 135000.0, "share": 15, "activeNow": 2 }
  ]
}

abonements_average_duration

Средняя длительность (в днях между датой начала и окончания) абонементов и клубных карт, проданных за период; общая и по типам абонементов.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).

Пример запроса и ответа

«Какова средняя длительность проданных абонементов за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "abonements_average_duration",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "limit": 3
    }
  }
}
{
  "metric": "abonements_average_duration",
  "definition": "Средняя продолжительность абонементов и клубных карт, проданных в периоде (DateTill − DateActivation, дни).",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:41",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21.",
    "Учитываются абонементы с заполненными датами начала и окончания (проданные в периоде по дате продажи)."
  ],
  "value": 130,
  "unit": "days",
  "abonements": 21,
  "byProduct": [
    { "name": "Безлимит 1 мес", "abonements": 6, "averageDays": 29 },
    { "name": "абонемент на мес + 10 ГТ", "abonements": 4, "averageDays": 60 },
    { "name": "ПТ-10", "abonements": 3, "averageDays": 212 }
  ]
}

abonements_frozen

Сколько абонементов/клубных карт сейчас заморожено (статус «Заморожен»), всего и по филиалам, число уникальных клиентов.

ПараметрТипОбяз.Описание
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Какие абонементы сейчас заморожены?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "abonements_frozen",
    "arguments": {}
  }
}
{
  "metric": "abonements_frozen",
  "definition": "Абонементы и клубные карты в статусе «Заморожен» на текущий момент.",
  "asOf": "2026-10-23T18:21:29",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [],
  "value": 0,
  "unit": "abonements",
  "clients": 0,
  "byBranch": []
}

Подписки

subscriptions_summary

Сводка по подпискам на абонементы. Подписка — абонемент, купленный с подпиской: фоновая задача перед его окончанием сама создаёт продажу такой же услуги по цене подписки (Abonement.MonthlySubscriptionPayment). Ответ: currentSubscriptions (активные, в процессе оплаты и с ошибкой оплаты), byStatus (все шесть статусов подписки), awaitingPayment (подписки «Активна» и «Ошибка оплаты» и сумма их следующих платежей), byAbonement, byBranch, abonementsAvailable (сколько абонементов доступно по подписке). Это текущее состояние: даты смены статуса в БД не хранятся, поэтому «сколько отменили за месяц» посчитать нельзя.

ПараметрТипОбяз.Описание
branchIdintegerнетФилиал; не указан — все филиалы.
limitintegerнетРазмер рейтинга по абонементам (по умолчанию 10).

Пример запроса и ответа

«Сколько у нас подписок и на какую сумму ожидаются списания?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "subscriptions_summary",
    "arguments": {}
  }
}
{
  "metric": "subscriptions_summary",
  "definition": "Подписки на абонементы по статусам (SaledService.SubscriptionStatus): действующие, ожидаемые списания, разрезы. Статусы подписки: Активна, Ошибка оплаты, В процессе оплаты — действующие; Отменена (клиент отказался), Аннулирована (не оплачена в срок), Продлена — завершённые. Даты смены статуса в БД не хранятся: инструменты показывают текущее состояние.",
  "asOf": "2026-10-28T02:25:24.9294307",
  "filters": {
    "branchId": null,
    "branchName": null
  },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "currentSubscriptions": 1,
  "byStatus": [
    {
      "statusId": 1,
      "status": "Активна",
      "subscriptions": 1
    },
    {
      "statusId": 2,
      "status": "Отменена",
      "subscriptions": 0
    },
    {
      "statusId": 3,
      "status": "Аннулирована",
      "subscriptions": 1
    },
    {
      "statusId": 4,
      "status": "Продлена",
      "subscriptions": 0
    },
    {
      "statusId": 5,
      "status": "В процессе оплаты",
      "subscriptions": 0
    },
    {
      "statusId": 6,
      "status": "Ошибка оплаты",
      "subscriptions": 0
    }
  ],
  "awaitingPayment": {
    "subscriptions": 1,
    "amount": 25000.0,
    "note": "Подписки в статусах «Активна» и «Ошибка оплаты» (не заморожены) — их оплачивает фоновая задача; сумма — платёж по подписке (Abonement.MonthlySubscriptionPayment) за очередной период."
  },
  "byAbonement": [
    {
      "serviceId": 84,
      "service": "Абонемент 10 йога/стретчинг",
      "subscriptions": 1,
      "nextPaymentsAmount": 25000.0
    }
  ],
  "byBranch": [
    {
      "branchId": 1,
      "branch": "Без филиала",
      "subscriptions": 1
    }
  ],
  "abonementsAvailable": {
    "bySubscription": 3,
    "onlyBySubscription": 1,
    "note": "Абонементы, которые можно купить по подписке («Доступен по подписке» / «Доступен только по подписке»)."
  }
}

subscriptions_list

Реестр подписок — по одной строке на подписку (ближайшее окончание сверху): saledServiceId, clientId, client («Фамилия Имя» полностью), абонемент, subscriptionStatus, abonementStatus, dateTill (конец оплаченного периода: к этой дате создаётся продажа продления), daysLeft, nextPayment (платёж по подписке за следующий период), филиал. В ответе также totalNextPayments. Данные платёжной карты клиента не выдаются.

ПараметрТипОбяз.Описание
statusstringнетcurrent (по умолчанию: активные, в процессе оплаты и с ошибкой оплаты), active, payment_error, in_payment, canceled (отменил клиент), aborted (аннулирована за неоплату), extended, all.
endsInDaysintegerнетТолько подписки, у которых оплаченный период заканчивается в ближайшие N дней (1..92); просроченные тоже входят.
branchIdintegerнетФилиал.
clientIdintegerнетID клиента.
phonestringнетМобильный телефон клиента в любом формате; не менее 7 цифр.
limit / offsetintegerнетПостраничный вывод.

Пример запроса и ответа

«Покажи все подписки.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "subscriptions_list",
    "arguments": {
      "status": "all",
      "limit": 3
    }
  }
}
{
  "metric": "subscriptions_list",
  "definition": "Реестр подписок на абонементы (SaledService со статусом подписки). dateTill — конец оплаченного периода: к этой дате создаётся продажа продления; nextPayment — платёж по подписке за следующий период. Статусы подписки: Активна, Ошибка оплаты, В процессе оплаты — действующие; Отменена (клиент отказался), Аннулирована (не оплачена в срок), Продлена — завершённые. Даты смены статуса в БД не хранятся: инструменты показывают текущее состояние. Имена — полностью («Фамилия Имя»): персональные данные, не пересылайте их дальше без необходимости.",
  "asOf": "2026-10-28T02:25:46.2345843",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "status": "all",
      "endsInDays": null,
      "clientId": null,
      "phone": null
    }
  },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "page": {
    "total": 2,
    "limit": 3,
    "offset": 0,
    "hasMore": false
  },
  "totalNextPayments": 26000.0,
  "items": [
    {
      "saledServiceId": 4565,
      "clientId": 1157,
      "client": "Иванов Сергей",
      "serviceId": 153,
      "service": null,
      "subscriptionStatusId": 3,
      "subscriptionStatus": "Аннулирована",
      "abonementStatus": "Закончена",
      "dateTill": "2025-05-15T13:37:26.353",
      "daysLeft": -531,
      "nextPayment": 1000.0,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    },
    {
      "saledServiceId": 4755,
      "clientId": 587,
      "client": "Петрова Анна",
      "serviceId": 84,
      "service": "Абонемент 10 йога/стретчинг",
      "subscriptionStatusId": 1,
      "subscriptionStatus": "Активна",
      "abonementStatus": "Активна",
      "dateTill": "2026-12-09T23:59:00",
      "daysLeft": 42,
      "nextPayment": 25000.0,
      "branchId": 1,
      "branch": "Без филиала"
    }
  ]
}

subscriptions_upcoming_payments

Предстоящие автосписания на ближайшие N дней: subscriptions и amount (подписки «Активна» и «Ошибка оплаты», оплаченный период которых заканчивается в окне), withPaymentError (из них с ошибкой в прошлый раз), overdue (период закончился, оплата ещё ждётся), byDay. Фоновая задача создаёт продление за несколько дней до окончания периода (настройка задачи «Обработка подписок»), поэтому реальное списание происходит чуть раньше указанной даты.

ПараметрТипОбяз.Описание
daysintegerнетГоризонт в днях от сегодня включительно (по умолчанию 7, максимум ≈ 92).
branchIdintegerнетФилиал.

Пример запроса и ответа

«Сколько денег придёт по подпискам за ближайшие 60 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "subscriptions_upcoming_payments",
    "arguments": {
      "days": 60
    }
  }
}
{
  "metric": "subscriptions_upcoming_payments",
  "definition": "Подписки («Активна» и «Ошибка оплаты»), у которых оплаченный период заканчивается с 2026-10-28 по 2026-12-27 включительно: количество и сумма продлений по подписке. Статусы подписки: Активна, Ошибка оплаты, В процессе оплаты — действующие; Отменена (клиент отказался), Аннулирована (не оплачена в срок), Продлена — завершённые. Даты смены статуса в БД не хранятся: инструменты показывают текущее состояние.",
  "asOf": "2026-10-28T02:26:53.2113241",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "days": 60
    }
  },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "window": {
    "start": "2026-10-28T00:00:00",
    "end": "2026-12-28T00:00:00",
    "interval": "[start, end)",
    "timezone": "Europe/Moscow"
  },
  "subscriptions": 1,
  "amount": 25000.0,
  "withPaymentError": {
    "subscriptions": 0,
    "amount": 0.0,
    "note": "Прошлая попытка оплаты завершилась ошибкой — они входят в общие итоги."
  },
  "overdue": {
    "subscriptions": 0,
    "amount": 0.0,
    "note": "Оплаченный период уже закончился, подписка не оплачена и ещё не аннулирована."
  },
  "byDay": [
    {
      "date": "2026-12-09T00:00:00",
      "subscriptions": 1,
      "amount": 25000.0
    }
  ]
}

subscriptions_job_settings

Настройки фоновой задачи «Автоматическая обработка подписок»: payment (за сколько дней до окончания подписки проводится списание, через сколько дней после окончания неоплаченная подписка аннулируется, при каком остатке посещений идёт оплата абонементов по количеству), notifications (за сколько дней и при каком остатке посещений клиенту уходит уведомление о скором списании), schedule.runAt (время суток запуска) и lastRun (последний запуск: когда, статус, длительность в мс). Задача общая для клуба и одна на систему, поэтому фильтра по филиалу нет. Если задача не создана, configured = false: подписки автоматически не оплачиваются и не аннулируются. Состояние задачи в планировщике (пауза, следующий запуск) в БД приложения не хранится и не показывается. Сотрудник, указанный в задаче, не выдаётся.

Параметров нет.

Пример запроса и ответа

«Когда списываются деньги по подпискам и через сколько дней аннулируется неоплаченная подписка?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "subscriptions_job_settings",
    "arguments": {}
  }
}
{
  "metric": "subscriptions_job_settings",
  "definition": "Настройки фоновой задачи обработки подписок (ProcessingSubscriptionsJobXp): сроки списания и аннулирования, параметры уведомлений, время запуска и последний запуск. Задача одна на клуб. Текущее состояние задачи в планировщике (пауза, следующий запуск) в БД приложения не хранится и здесь не показывается.",
  "asOf": "2026-10-28T09:50:32.4820658",
  "filters": {},
  "warnings": [],
  "configured": true,
  "payment": {
    "paymentPeriodDays": 10,
    "paymentPeriodNote": "За сколько дней до окончания оплаченного периода проводится списание по подписке.",
    "abortAfterDays": 0,
    "abortAfterNote": "Через сколько дней после окончания оплаченного периода неоплаченная подписка аннулируется (до этого оплату пытаются провести повторно).",
    "serviceUseRest": 1,
    "serviceUseRestNote": "Для абонементов, ограниченных по количеству посещений: при каком остатке посещений проводится списание."
  },
  "notifications": {
    "beforeDays": 5,
    "beforeDaysNote": "За сколько дней до списания клиенту отправляется push-уведомление.",
    "beforeRestQty": 2,
    "beforeRestQtyNote": "Для абонементов по количеству посещений: при каком остатке посещений клиенту отправляется уведомление о скором списании."
  },
  "schedule": {
    "runAt": ["14:00"],
    "note": "Время суток ежедневного запуска (по умолчанию 14:00); пусто — расписание не задано."
  },
  "lastRun": {
    "scheduledAt": "2026-08-31T11:00:00",
    "startedAt": "2026-08-31T11:04:17.767",
    "statusId": 2,
    "status": "Завершена",
    "durationMs": 359.3745
  }
}

subscriptions_payments

Оплаты по подпискам за период (проведённые продажи без возвратов, позиции абонементов, доступных по подписке): renewals — продления (продажа с IsPurchaseSubscription: автоматические и ручные оплаты очередного периода), firstPurchasesWithSubscription — первые покупки с подпиской (IsPurchaseWithSubscription), по абонементам и филиалам. Суммы — после скидок (SaleItem.ResultSumm). Построчно — sales_list с subscription=renewal / with_subscription.

ПараметрТипОбяз.Описание
period/days/dateFrom/dateToнетПериод по дате продажи (по умолчанию текущий месяц, максимум 3 месяца).
branchIdintegerнетФилиал; не указан — все филиалы.
limitintegerнетРазмер рейтинга по абонементам (по умолчанию 10).

Пример запроса и ответа

«Сколько продлений по подписке и первых покупок с подпиской за последние 90 дней?» (в тестовом клубе подписочных продаж нет — ответ нулевой)

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "subscriptions_payments",
    "arguments": {
      "period": "last_n_days",
      "days": 90
    }
  }
}
{
  "metric": "subscriptions_payments",
  "definition": "Проведённые продажи по подпискам (позиции без возвратов) абонементов, доступных по подписке: продления (Sale.IsPurchaseSubscription) и первые покупки с подпиской (Sale.IsPurchaseWithSubscription). Суммы — SaleItem.ResultSumm, после скидок.",
  "period": {
    "start": "2026-07-31T00:00:00",
    "end": "2026-10-29T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T02:38:01.2769834",
  "filters": {
    "branchId": null,
    "branchName": null
  },
  "warnings": [
    "Период не завершён (до 2026-10-29 00:00); учтены данные на 2026-10-28 02:38."
  ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "renewals": {
    "items": 0,
    "amount": 0.0,
    "uniqueClients": 0,
    "averageAmount": null
  },
  "firstPurchasesWithSubscription": {
    "items": 0,
    "amount": 0.0,
    "uniqueClients": 0,
    "averageAmount": null
  },
  "byAbonement": [],
  "byBranch": []
}

subscriptions_price_comparison

Цена с подпиской и без для абонементов, доступных по подписке: basePrice (обычная цена, Product.Price), subscriptionPayment (платёж по подписке за вторую и последующие оплаты), difference и differencePercent, onlyBySubscription, и фактические продажи за период — число и средняя сумма позиции: без подписки (withoutSubscription), первая покупка с подпиской (firstPurchaseWithSubscription), продление (renewal). Если у абонемента цена своя по филиалам (isBranchPrice), показана базовая цена; цены филиалов не учитываются.

ПараметрТипОбяз.Описание
period/days/dateFrom/dateToнетПериод по дате продажи (по умолчанию текущий месяц, максимум 3 месяца).
branchIdintegerнетФилиал; не указан — все филиалы.

Пример запроса и ответа

«Насколько подписка дешевле обычной цены?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "subscriptions_price_comparison",
    "arguments": {
      "period": "last_n_days",
      "days": 90
    }
  }
}
{
  "metric": "subscriptions_price_comparison",
  "definition": "Абонементы, доступные по подписке: обычная цена (Product.Price) и платёж по подписке (Abonement.MonthlySubscriptionPayment — за вторую и последующие оплаты), плюс средняя фактическая сумма позиций (после скидок) за период: без подписки, первая покупка с подпиской, продление.",
  "period": {
    "start": "2026-07-31T00:00:00",
    "end": "2026-10-29T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T02:32:07.5331556",
  "filters": {
    "branchId": null,
    "branchName": null
  },
  "warnings": [
    "Период не завершён (до 2026-10-29 00:00); учтены данные на 2026-10-28 02:32."
  ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "items": [
    {
      "productId": 142,
      "abonement": "10 групповых занятий на 1 мес.",
      "availability": "Доступен по подписке",
      "onlyBySubscription": false,
      "basePrice": 10000.0,
      "isBranchPrice": false,
      "subscriptionPayment": 6000.0,
      "difference": 4000.0,
      "differencePercent": 40,
      "sold": {
        "withoutSubscription": {
          "items": 0,
          "averageAmount": null
        },
        "firstPurchaseWithSubscription": {
          "items": 0,
          "averageAmount": null
        },
        "renewal": {
          "items": 0,
          "averageAmount": null
        }
      }
    },
    {
      "productId": 206,
      "abonement": "3 мес КК",
      "availability": "Доступен по подписке",
      "onlyBySubscription": false,
      "basePrice": 10.0,
      "isBranchPrice": false,
      "subscriptionPayment": 10.0,
      "difference": 0.0,
      "differencePercent": 0,
      "sold": {
        "withoutSubscription": {
          "items": 1,
          "averageAmount": 0.0
        },
        "firstPurchaseWithSubscription": {
          "items": 0,
          "averageAmount": null
        },
        "renewal": {
          "items": 0,
          "averageAmount": null
        }
      }
    },
    {
      "productId": 84,
      "abonement": "Абонемент 10 йога/стретчинг",
      "availability": "Доступен только по подписке",
      "onlyBySubscription": true,
      "basePrice": 25000.0,
      "isBranchPrice": true,
      "subscriptionPayment": 25000.0,
      "difference": 0.0,
      "differencePercent": 0,
      "sold": {
        "withoutSubscription": {
          "items": 1,
          "averageAmount": 25000.0
        },
        "firstPurchaseWithSubscription": {
          "items": 0,
          "averageAmount": null
        },
        "renewal": {
          "items": 0,
          "averageAmount": null
        }
      }
    },
    {
      "productId": 85,
      "abonement": "Занятия в группе",
      "availability": "Доступен по подписке",
      "onlyBySubscription": false,
      "basePrice": 1000.0,
      "isBranchPrice": false,
      "subscriptionPayment": 900.0,
      "difference": 100.0,
      "differencePercent": 10,
      "sold": {
        "withoutSubscription": {
          "items": 0,
          "averageAmount": null
        },
        "firstPurchaseWithSubscription": {
          "items": 0,
          "averageAmount": null
        },
        "renewal": {
          "items": 0,
          "averageAmount": null
        }
      }
    }
  ]
}

Зарплата

Инструменты читают готовые расчётные листы: суммы считает система при создании листа (Администрирование → Заработная плата → Расчётные листы). Нет листа за период — зарплата не посчитана, в ответе будет предупреждение. Листы разных периодов могут пересекаться (например, лист за три месяца и лист за один из них): инструменты суммируют все найденные листы. Данные чувствительные: зарплата по ФИО сотрудника. В примерах ФИО заменено условным.

payroll_sheets_list

Реестр расчётных листов — по строке на лист: staffId, staff («Фамилия Имя»), должность, период листа, salary (оклад), piecework (сдельные начисления за тренировки, продажи, смены), hourlyPart, awards, penalties, timeTrackingAdjustments (премии и штрафы по учёту времени), total, paid, remainder, филиал. В totals — итоги по всем найденным листам.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week, last_week, this_month, last_month (по умолчанию), last_n_days или custom. Не длиннее 3 календарных месяцев.
daysintegerнетДля period=last_n_days: число последних дней.
dateFromstringнетНачало произвольного периода, yyyy-MM-dd (period=custom).
dateTostringнетКонец произвольного периода, yyyy-MM-dd включительно.
personalIdintegerнетID сотрудника (staffId из staff_list).
branchIdintegerнетФилиал.
limit / offsetintegerнетПостраничный вывод.

Пример запроса и ответа

«Покажи расчётные листы за последние три месяца»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "payroll_sheets_list",
    "arguments": {
      "period": "last_n_days",
      "days": 92,
      "limit": 3
    }
  }
}
{
  "metric": "payroll_sheets_list",
  "definition": "Расчётный лист (PaymentList): итого = оклад + сдельные начисления + почасовая часть + премии − штрафы ± премии и штрафы по учёту времени (опоздания, ранние уходы, недоработка, переработка, работа в праздники). Суммы посчитаны системой при создании листа. Остаток к выплате = итого − выплачено. Листы с периодом, пересекающимся с запрошенным. Зарплата по ФИО сотрудника — чувствительные персональные данные: не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2026-07-29T00:00:00",
    "end": "2026-10-29T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 92 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T11:04:46.7967373",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "personalId": null
    }
  },
  "warnings": [
    "Период не завершён (до 2026-10-29 00:00); учтены данные на 2026-10-28 11:04."
  ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "page": {
    "total": 2,
    "limit": 3,
    "offset": 0,
    "hasMore": false
  },
  "totals": {
    "sheets": 2,
    "total": 41572.5,
    "paid": 0.0,
    "remainder": 41572.5
  },
  "items": [
    {
      "sheetId": 54,
      "staffId": 132,
      "staff": "Иванова Мария",
      "position": "Администратор",
      "dateStart": "2026-06-01T00:00:00",
      "dateEnd": "2026-08-31T23:59:59",
      "salary": 18000.0,
      "piecework": 4886.25,
      "hourlyPart": 0.0,
      "awards": 0.0,
      "penalties": 0.0,
      "timeTrackingAdjustments": 0.0,
      "total": 22886.25,
      "paid": 0.0,
      "remainder": 22886.25,
      "trainings": 0,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    },
    {
      "sheetId": 53,
      "staffId": 132,
      "staff": "Иванова Мария",
      "position": "Администратор",
      "dateStart": "2026-07-01T00:00:00",
      "dateEnd": "2026-07-31T23:59:59",
      "salary": 18000.0,
      "piecework": 686.25,
      "hourlyPart": 0.0,
      "awards": 0.0,
      "penalties": 0.0,
      "timeTrackingAdjustments": 0.0,
      "total": 18686.25,
      "paid": 0.0,
      "remainder": 18686.25,
      "trainings": 0,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    }
  ]
}

payroll_sheet_details

Расшифровка расчётного листа — из чего сложилась сдельная часть. accruals — начисления листа (calculation — название начисления схемы, amount, base — база расчёта, например сумма продаж, description — текст расчёта, items и itemsAmount — число и сумма позиций), items — позиции постранично (продажа, посещение, тренировка или списание услуги). ФИО клиентов в text заменено на «Имя Ф.», имена сотрудников не меняются. dateFrom/dateTo оставляют позиции за интервал (например, один месяц многомесячного листа); amount начисления при этом остаётся за весь лист.

ПараметрТипОбяз.Описание
sheetIdintegerдаID расчётного листа (sheetId из payroll_sheets_list).
dateFromstringнетТолько позиции начиная с этой даты, yyyy-MM-dd, включительно.
dateTostringнетТолько позиции до этой даты, yyyy-MM-dd, включительно.
limit / offsetintegerнетПостраничный вывод позиций (от ранних к поздним).

Пример запроса и ответа

«Из чего состоит зарплата сотрудника за июнь?» (лист охватывает июнь–август, берём июнь; ФИО сотрудника и клиентов в примере условные.)

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "payroll_sheet_details",
    "arguments": {
      "sheetId": 54,
      "dateFrom": "2026-06-01",
      "dateTo": "2026-06-30",
      "limit": 50
    }
  }
}
{
  "metric": "payroll_sheet_details",
  "definition": "Расчётный лист (PaymentList): итого = оклад + сдельные начисления + почасовая часть + премии − штрафы ± премии и штрафы по учёту времени (опоздания, ранние уходы, недоработка, переработка, работа в праздники). Суммы посчитаны системой при создании листа. Остаток к выплате = итого − выплачено. Расшифровка: начисления листа (CalculationDetail) и позиции, из-за которых они начислены (CalculationDetailItem). ФИО клиентов заменено на «Имя Ф.». Зарплата по ФИО сотрудника — чувствительные персональные данные: не пересылайте их дальше без необходимости.",
  "asOf": "2026-10-28T11:22:00.9668233",
  "filters": {
    "sheetId": 54,
    "dateFrom": "2026-06-01",
    "dateTo": "2026-06-30"
  },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "sheet": {
    "sheetId": 54,
    "staffId": 132,
    "staff": "Иванова Мария",
    "position": "Администратор",
    "dateStart": "2026-06-01T00:00:00",
    "dateEnd": "2026-08-31T23:59:59",
    "salary": 18000.0,
    "piecework": 4886.25,
    "awards": 0.0,
    "penalties": 0.0,
    "total": 22886.25,
    "paid": 0.0,
    "branchId": 1084,
    "branch": "fitness365 Москва"
  },
  "accruals": [
    {
      "accrualId": 336,
      "calculation": "от продаж йоги",
      "amount": 4886.25,
      "base": 97725.0,
      "description": "Начисление 5 % от продаж на суммму 97 725,00 ₽ в размере 4 886,25 ₽",
      "items": 2,
      "itemsAmount": 2500.0
    }
  ],
  "page": {
    "total": 2,
    "limit": 50,
    "offset": 0,
    "hasMore": false
  },
  "items": [
    {
      "itemId": 308,
      "accrualId": 336,
      "calculation": "от продаж йоги",
      "date": "2026-06-02T23:14:30.723",
      "amount": 1250.0,
      "text": "Клиент: Иван П. Продажа Абонемент 10 йога/стретчинг, сумма 25 000,00 ₽"
    },
    {
      "itemId": 309,
      "accrualId": 336,
      "calculation": "от продаж йоги",
      "date": "2026-06-29T21:17:25.76",
      "amount": 1250.0,
      "text": "Клиент: Пётр С. Продажа Абонемент 10 йога/стретчинг, сумма 25 000,00 ₽"
    }
  ]
}

payroll_schemes

Схемы расчёта зарплаты (раздел «Схемы расчёта») — как в клубе считается зарплата; это настройки, а не расчёт. Для каждой схемы: salaryPerMonth (оклад в месяц), почасовая ставка, ставки и штрафы по учёту времени, assignedTo (должности; сколько работающих сотрудников получили схему лично или через должность; схема сотрудника приоритетнее схемы должности) и accruals — начисления схемы: kind (вид по справке), calculation (как считается словами) и conditions — условия словами с логикой («все условия должны выполняться», «достаточно любого»). Если в начислении отключена проверка условий, они перечислены, но не применяются (conditionsApplied: false). Виды условий: интервал базы, свободные фильтры (критерий выводится как есть), время, дни недели, категория, класс тренировки, число клиентов, основание посещения, услуги и продукты; инвертированные начинаются с «кроме:». Схемы общие для клуба: фильтров по филиалу и периоду нет.

ПараметрТипОбяз.Описание
schemeIdintegerнетОдна схема; тогда в assignedTo.staff ещё и список назначенных работающих сотрудников. Не указан — все схемы. Не сочетается со staffId.
staffIdintegerнетСхема конкретного сотрудника (staffId из staff_list): в staff — личная схема, схема должности, действующая схема (effectiveSchemeId, source: personal / position / none), в schemes — она же с начислениями и условиями. Личная схема приоритетнее схемы должности; удалённая схема не применяется. Личная схема может быть записана автоматически при сохранении карточки сотрудника (карточка показывает в поле «Схема расчета» схему должности), поэтому source: personal не всегда означает ручной выбор. Не сочетается со schemeId.
limitintegerнетСколько схем вернуть (по умолчанию 20).

Пример запроса и ответа

«Как считается зарплата тренера высшей категории?» (ФИО сотрудника в примере условное.)

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "payroll_schemes",
    "arguments": {
      "schemeId": 5
    }
  }
}
{
  "metric": "payroll_schemes",
  "definition": "Схемы расчёта зарплаты (PaymentScheme): ставка в месяц, ставки и штрафы по учёту времени, начисления схемы (CalculationBase и его виды) и условия начислений (CalculationCondition). Настройки, а не расчёт. Назначение: схема сотрудника приоритетнее схемы должности; считаются работающие сотрудники.",
  "asOf": "2026-10-28T12:08:06.3512596",
  "filters": {
    "schemeId": 5
  },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "schemes": [
    {
      "schemeId": 5,
      "name": "Тренер высшей категории",
      "salaryPerMonth": 0.0,
      "hourlyRate": 0.0,
      "overtimeHourRate": 0.0,
      "holidayHourRate": 0.0,
      "timeTrackingPenalties": {
        "earlyLeaving": 0.0,
        "delay": 0.0,
        "defect": 0.0
      },
      "timeTrackingAwards": {
        "overtime": 0.0,
        "holidayWork": 0.0
      },
      "assignedTo": {
        "positions": [
          {
            "positionId": 4,
            "position": "Педагог"
          }
        ],
        "staffAssignedPersonally": 0,
        "staffViaPosition": 1,
        "staff": [
          {
            "staffId": 258,
            "staff": "Сидоров Пётр",
            "via": "position"
          }
        ]
      },
      "accruals": [
        {
          "accrualId": 10,
          "name": "Начисление от продаж до 50000",
          "kind": "Начисление от продаж сотрудника",
          "calculation": "50 % от продаж сотрудника",
          "conditions": {
            "logic": "проверка условий отключена: перечисленные условия не применяются",
            "conditionsApplied": false,
            "items": [
              {
                "conditionId": 7,
                "name": "Продажи до 50000",
                "kind": "Интервал базы начисления",
                "inverted": false,
                "description": "база начисления от 1 до 50000"
              },
              {
                "conditionId": 16,
                "name": "По типу услуги",
                "kind": "Фильтр по услугам/продуктам",
                "inverted": false,
                "description": "услуги и продукты: не выбраны"
              }
            ]
          }
        },
        {
          "accrualId": 26,
          "name": "Первая ПТ (педагог)",
          "kind": "Начисления от количества тренировок",
          "calculation": "250 за каждую проведённую тренировку",
          "conditions": {
            "logic": "все условия должны выполняться",
            "conditionsApplied": true,
            "items": [
              {
                "conditionId": 26,
                "name": "Первая ПТ",
                "kind": "Фильтр по услугам/продуктам",
                "inverted": false,
                "description": "услуги и продукты: не выбраны"
              }
            ]
          }
        }
      ]
    }
  ]
}

payroll_summary

Сводка по зарплате за период: sheets, staff, total (фонд оплаты), paid, remainder, components (оклады, сдельные начисления, почасовая часть, премии, штрафы, поправки по учёту времени), byBranch, byPosition, topStaff.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week, last_week, this_month, last_month (по умолчанию), last_n_days или custom. Не длиннее 3 календарных месяцев.
daysintegerнетДля period=last_n_days: число последних дней.
dateFromstringнетНачало произвольного периода, yyyy-MM-dd (period=custom).
dateTostringнетКонец произвольного периода, yyyy-MM-dd включительно.
branchIdintegerнетФилиал.
limitintegerнетРазмер рейтингов по должностям и сотрудникам (по умолчанию 10).

Пример запроса и ответа

«Сколько мы платим зарплату и сколько осталось выплатить?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "payroll_summary",
    "arguments": {
      "period": "last_n_days",
      "days": 92
    }
  }
}
{
  "metric": "payroll_summary",
  "definition": "Расчётный лист (PaymentList): итого = оклад + сдельные начисления + почасовая часть + премии − штрафы ± премии и штрафы по учёту времени (опоздания, ранние уходы, недоработка, переработка, работа в праздники). Суммы посчитаны системой при создании листа. Остаток к выплате = итого − выплачено. Листы с периодом, пересекающимся с запрошенным. Зарплата по ФИО сотрудника — чувствительные персональные данные: не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2026-07-29T00:00:00",
    "end": "2026-10-29T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 92 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T11:04:47.2098383",
  "filters": {
    "branchId": null,
    "branchName": null
  },
  "warnings": [
    "Период не завершён (до 2026-10-29 00:00); учтены данные на 2026-10-28 11:04."
  ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "sheets": 2,
  "staff": 1,
  "total": 41572.5,
  "paid": 0.0,
  "remainder": 41572.5,
  "components": {
    "salary": 36000.0,
    "piecework": 5572.5,
    "hourlyPart": 0.0,
    "awards": 0.0,
    "penalties": 0.0,
    "timeTrackingAwards": 0.0,
    "timeTrackingPenalties": 0.0,
    "note": "total = salary + piecework + hourlyPart + awards − penalties + timeTrackingAwards − timeTrackingPenalties (по формуле системы; итог листа можно поправить вручную, тогда он может отличаться)."
  },
  "byBranch": [
    {
      "branchId": 1084,
      "branch": "fitness365 Москва",
      "sheets": 2,
      "total": 41572.5,
      "paid": 0.0,
      "remainder": 41572.5
    }
  ],
  "byPosition": [
    {
      "position": "Администратор",
      "sheets": 2,
      "total": 41572.5,
      "paid": 0.0,
      "remainder": 41572.5
    }
  ],
  "topStaff": [
    {
      "staffId": 132,
      "staff": "Иванова Мария",
      "sheets": 2,
      "total": 41572.5,
      "paid": 0.0,
      "remainder": 41572.5
    }
  ]
}

awards_penalties_list

Штрафы и премии сотрудников за период (по дате): дата, сотрудник, kind (award / penalty), размер по модулю, reason (произвольный текст клуба). Знак суммы в БД определяет вид: больше 0 — премия, меньше 0 — штраф. В totals — количество и сумма премий и штрафов и разница. Эти суммы входят в расчётный лист того периода, куда попадает дата.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week, last_week, this_month, last_month (по умолчанию), last_n_days или custom. Не длиннее 3 календарных месяцев.
daysintegerнетДля period=last_n_days: число последних дней.
dateFromstringнетНачало произвольного периода, yyyy-MM-dd (period=custom).
dateTostringнетКонец произвольного периода, yyyy-MM-dd включительно.
kindstringнетaward (премии) или penalty (штрафы); не указан — все.
personalIdintegerнетID сотрудника.
branchIdintegerнетФилиал (по организации сотрудника).
limit / offsetintegerнетПостраничный вывод.

Пример запроса и ответа

«Кого оштрафовали или премировали за последние три месяца?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "awards_penalties_list",
    "arguments": {
      "period": "last_n_days",
      "days": 92,
      "limit": 3
    }
  }
}
{
  "metric": "awards_penalties_list",
  "definition": "Штрафы и премии сотрудников (AwardAndPenalty): знак размера определяет вид (больше 0 — премия, меньше 0 — штраф). Входят в расчётный лист по дате. Филиал — по сотруднику. Зарплата по ФИО сотрудника — чувствительные персональные данные: не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2026-07-29T00:00:00",
    "end": "2026-10-29T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 92 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T11:04:46.7857497",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "kind": null,
      "personalId": null
    }
  },
  "warnings": [
    "Период не завершён (до 2026-10-29 00:00); учтены данные на 2026-10-28 11:04."
  ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "page": {
    "total": 0,
    "limit": 3,
    "offset": 0,
    "hasMore": false
  },
  "totals": {
    "awards": {
      "count": 0,
      "amount": 0
    },
    "penalties": {
      "count": 0,
      "amount": 0
    },
    "net": 0
  },
  "items": []
}

В тестовой базе штрафов и премий за период нет, поэтому список пуст; формат строки описан выше.

Данные для расчёта зарплаты сотрудников

Три инструмента для самостоятельного расчёта зарплаты внешним ИИ по алгоритму владельца клуба, без схем и начислений системы. Тренеры считаются по проведённым тренировкам и посещениям клиентов («за каждое посещение 5 % от стоимости услуги», «500 за тренировку») — staff_attendances, staff_trainings; менеджеры и администраторы — по продажам и рекомендациям («5 % с продаж», «процент за рекомендацию») — staff_sales. Основа — списания услуг (ServiceUse) и позиции продаж, как в расчёте зарплаты самой системы. Цена посещения: price.bySale — цена продажи (с учётом скидок; для абонемента на N занятий — делённая на N; по умолчанию для «стоимости услуги»), price.byService — до скидки, price.servicePriceList — текущий прайс услуги; price.source: stored / calculated / missing (цену определить нельзя). Отмены, возвраты и отмены продаж не скрываются, а помечаются (billable: false, excludeReason). summary считается по всей выборке, а не по странице; prices.missing > 0 значит, что зарплата неполная. Блок unassigned — посещения без указанного тренера (система за них не платит; делятся на «по занятию» и «без занятия»), блок systemPayroll — расчётные листы системы по тренеру для сверки. Данные чувствительные: клиенты показаны как «Имя Ф.», ФИО сотрудника в примерах условное.

staff_attendances

Посещения клиентов у сотрудника-исполнителя — по строке на посещение клиента: дата, тренер, клиент, списанная услуга, занятие (с основным тренером занятия), основание (abonement, club_card, single, none), цена, billable и причина исключения (event_cancelled, sale_returned, sale_cancelled). Блок systemPayroll (при staffId) — листы системы за период.

ПараметрТипОбяз.Описание
staffIdintegerнетID сотрудника (staffId из staff_list). Не указан — все сотрудники.
period / days / dateFrom / dateTostring / integerнетПериод (по умолчанию last_month, максимум 3 месяца).
branchIdintegerнетФилиал.
limit / offsetintegerнетСтраница до 200 строк (по умолчанию 20).

Пример запроса и ответа

«Посчитай зарплату сотруднику за июль: за каждое посещение 5 % от стоимости услуги» — 5 % от summary.prices.bySale (1 800) даёт 90; в systemPayroll видно, что система насчитала по своей схеме.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "staff_attendances",
    "arguments": {
      "staffId": 132,
      "period": "custom",
      "dateFrom": "2026-07-01",
      "dateTo": "2026-07-31",
      "limit": 1
    }
  }
}
{
  "metric": "staff_attendances",
  "definition": "Данные для расчёта зарплаты сотрудника (тренера и других исполнителей услуг) по алгоритму владельца клуба. Основа — списания услуг (ServiceUse): клиент пришёл на тренировку или за услугой, исполнитель — сотрудник. Цена посещения — по правилам ядра: сохранённые суммы списания, а если их нет, пересчёт по основанию (цена продажи позиции; для абонемента на N занятий делится на N; для безлимитного абонемента и клубной карты — прайс списанной услуги). Зарплата по ФИО сотрудника — чувствительные персональные данные, клиенты показаны как «Имя Ф.»: не пересылайте данные дальше без необходимости.",
  "period": {
    "start": "2026-07-01T00:00:00",
    "end": "2026-08-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2026-07-01 — 2026-07-31 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T15:03:21.4407432",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "staffId": 132
    }
  },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "summary": {
    "attendances": 1,
    "billable": 1,
    "excluded": {},
    "prices": {
      "bySale": 1800.0,
      "byService": 1800.0,
      "stored": 1,
      "calculated": 0,
      "missing": 0,
      "note": "Суммы — по учитываемым (billable) посещениям; missing — посещения без цены, в суммы не входят."
    },
    "byService": [
      {
        "serviceId": 10,
        "service": "ПТ Разовая",
        "attendances": 1,
        "bySale": 1800.0,
        "byService": 1800.0
      }
    ],
    "byStaff": null
  },
  "completeness": {
    "complete": true,
    "attendancesInSelection": 1,
    "maxRows": 20000,
    "pageSize": 1,
    "note": "Выборка загружена целиком: summary и page.total описывают все посещения периода, не только текущую страницу. Если page.hasMore = true, для построчной проверки запросите следующие страницы (offset)."
  },
  "unassigned": {
    "attendances": 0,
    "billable": 0,
    "prices": {
      "bySale": 0,
      "byService": 0,
      "stored": 0,
      "calculated": 0,
      "missing": 0,
      "note": "Суммы — по учитываемым (billable) посещениям; missing — посещения без цены, в суммы не входят."
    },
    "rule": "Посещения без исполнителя, связанные с этим сотрудником косвенно: занятие, где он основной тренер, или визит, где он исполнитель. В расчёте зарплаты системы они не участвуют и в обычный summary не входят: платить ли за них, решает владелец клуба.",
    "withEvent": 0,
    "withEventTrainer": 0,
    "withoutEvent": 0,
    "hint": "С занятием (withEvent) — вероятно, тренировки без назначенного исполнителя; withEventTrainer — из них те, у занятия которых основной тренер указан (event.staffId). Без занятия (withoutEvent) — чаще обычные визиты клиентов в клуб (членство, солярий, разовые посещения), а не тренировки: на зарплату они обычно не влияют.",
    "byService": [],
    "itemsShown": 0,
    "items": []
  },
  "systemPayroll": {
    "sheets": [
      {
        "sheetId": 54,
        "dateStart": "2026-06-01T00:00:00",
        "dateEnd": "2026-08-31T23:59:59",
        "coversPeriod": true,
        "salary": 18000.0,
        "piecework": 4886.25,
        "total": 22886.25,
        "accruals": [
          {
            "accrual": "от продаж йоги",
            "amount": 4886.25,
            "base": 97725.0,
            "description": "Начисление 5 % от продаж на суммму 97 725,00 ₽ в размере 4 886,25 ₽"
          }
        ]
      },
      {
        "sheetId": 53,
        "dateStart": "2026-07-01T00:00:00",
        "dateEnd": "2026-07-31T23:59:59",
        "coversPeriod": true,
        "salary": 18000.0,
        "piecework": 686.25,
        "total": 18686.25,
        "accruals": [
          {
            "accrual": "от продаж йоги",
            "amount": 686.25,
            "base": 13725.0,
            "description": "Начисление 5 % от продаж на суммму 13 725,00 ₽ в размере 686,25 ₽"
          }
        ]
      }
    ],
    "note": "Это расчёт самой системы по схеме сотрудника (payroll_schemes со staffId), а не вашего правила: расхождение с расчётом ИИ ожидаемо. coversPeriod = false значит, что период листа не совпадает с запрошенным, и сравнивать суммы напрямую нельзя."
  },
  "page": {
    "total": 1,
    "limit": 1,
    "offset": 0,
    "hasMore": false
  },
  "items": [
    {
      "attendanceId": 7654,
      "date": "2026-07-08T20:00:00",
      "staffId": 132,
      "staff": "Иванова Мария",
      "client": {
        "clientId": 1419,
        "name": "U."
      },
      "service": {
        "serviceId": 10,
        "name": "ПТ Разовая"
      },
      "event": {
        "eventId": 24597,
        "name": "ПТ Разовая",
        "start": "2026-07-08T20:00:00",
        "status": "Завершено",
        "staffId": 132
      },
      "visitId": 7511,
      "basis": {
        "basisId": 4905,
        "kind": "single",
        "service": "ПТ Разовая"
      },
      "price": {
        "byService": 1800.0,
        "bySale": 1800.0,
        "source": "stored",
        "note": "сумма сохранена при списании услуги",
        "servicePriceList": 1800.0
      },
      "billable": true,
      "excludeReason": null,
      "excludeReasonName": null,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    }
  ]
}

Пример: посещения без тренера

Без staffId в unassigned видны посещения, не закреплённые ни за кем: два по занятию (у занятия тоже нет тренера) и три без занятия (обычные визиты клиентов).

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "staff_attendances",
    "arguments": {
      "period": "custom",
      "dateFrom": "2026-08-18",
      "dateTo": "2026-08-20",
      "limit": 1
    }
  }
}
{
  "metric": "staff_attendances",
  "definition": "...",
  "period": {
    "start": "2026-08-18T00:00:00",
    "end": "2026-08-21T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2026-08-18 — 2026-08-20 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "staffId": null
    }
  },
  "warnings": [
    "5 посещений без указанного исполнителя (из них по занятиям: 2): в summary они не входят, см. блок unassigned. Если среди них есть тренировки, зарплата может быть занижена."
  ],
  "summary": {
    "attendances": 1,
    "billable": 1,
    "prices": {
      "bySale": 760.0,
      "byService": 800.0,
      "stored": 1,
      "calculated": 0,
      "missing": 0
    },
    "byStaff": [
      {
        "staffId": 7,
        "staff": "Иванов Пётр",
        "attendances": 1,
        "bySale": 760.0,
        "byService": 800.0
      }
    ],
    "...": ...
  },
  "unassigned": {
    "attendances": 5,
    "billable": 5,
    "prices": {
      "bySale": 7020.0,
      "byService": 7100.0,
      "stored": 5,
      "calculated": 0,
      "missing": 0
    },
    "rule": "Посещения, у которых не указан исполнитель: в расчёте зарплаты системы не участвуют и в обычный summary не входят.",
    "withEvent": 2,
    "withEventTrainer": 0,
    "withoutEvent": 3,
    "hint": "С занятием (withEvent) — вероятно, тренировки без назначенного исполнителя; withEventTrainer — из них те, у занятия которых основной тренер указан (event.staffId). Без занятия (withoutEvent) — чаще обычные визиты клиентов в клуб (членство, солярий, разовые посещения), а не тренировки: на зарплату они обычно не влияют.",
    "byService": [
      {
        "serviceId": 9,
        "service": "Йога",
        "attendances": 2,
        "withEvent": 0,
        "bySale": 1520.0
      },
      {
        "serviceId": 14,
        "service": "Членство в клубе",
        "attendances": 1,
        "withEvent": 0,
        "bySale": 1000.0
      },
      {
        "serviceId": 101,
        "service": "Фитбол",
        "attendances": 1,
        "withEvent": 1,
        "bySale": 500.0
      },
      {
        "serviceId": 204,
        "service": "Персональная тренировка",
        "attendances": 1,
        "withEvent": 1,
        "bySale": 4000.0
      }
    ],
    "itemsShown": 5,
    "items": [
      {
        "attendanceId": 7707,
        "date": "2026-08-19T09:15:00",
        "staffId": null,
        "staff": null,
        "client": {
          "clientId": 1462,
          "name": "Кристина В."
        },
        "service": {
          "serviceId": 204,
          "name": "Персональная тренировка"
        },
        "event": {
          "eventId": 24645,
          "name": "Персональная тренировка",
          "start": "2026-08-19T09:15:00",
          "status": "Завершено",
          "staffId": null
        },
        "visitId": 7563,
        "basis": {
          "basisId": 4929,
          "kind": "abonement",
          "service": "3 мес КК"
        },
        "price": {
          "byService": 4000.0,
          "bySale": 4000.0,
          "source": "stored",
          "note": "сумма сохранена при списании услуги",
          "servicePriceList": 3999.0
        },
        "billable": true,
        "excludeReason": null,
        "excludeReasonName": null,
        "branchId": 1084,
        "branch": "fitness365 Москва"
      },
      ...
    ]
  },
  "systemPayroll": null,
  "page": {
    "total": 1,
    "limit": 1,
    "offset": 0,
    "hasMore": false
  },
  "items": [
    ...
  ]
}

Пример: расчёт только от реальных денег

«Посчитай тренеру 5 % от стоимости посещений, только от реальных денег» — берётся разложение оплаты: paymentShare у посещения и summary.byPayment по всей выборке. Тип оплаты, считающийся деньгами, выбирает ИИ по словам владельца: «только деньги» — money, «с погашенным кредитом» — moneyWithRepaidCredit, «без бонусов, но с кредитами» — цена bySale минус bonus. Ниже — тренер 7 (staffId = 7), 92 дня: все 15 посещений идут по абонементу, проданному в кредит, поэтому money = 0, а moneyWithRepaidCredit = 10 650 из 11 400 (5 % — 0 или 532,50).

"summary": {
  "attendances": 15,
  "prices": { "bySale": 11400.00, "byService": 12000.00 },
  "byPayment": {
    "total": {
      "cash": 0.00, "card": 0.00, "beznal": 0, "deposit": 0.00, "bonus": 0.00,
      "credit": 11400.00, "creditRepaid": 10650.00, "other": 0,
      "money": 0.00, "moneyWithRepaidCredit": 10650.00,
      "approximate": false
    },
    "known": 15,
    "unknown": 0
  }
}
...
"price": { "byService": 800.0000, "bySale": 760.0000, "source": "stored" },
"paymentShare": {
  "cash": 0.00, "card": 0.00, "beznal": 0, "deposit": 0.00, "bonus": 0.00,
  "credit": 760.00, "creditRepaid": 710.00, "other": 0,
  "money": 0.00, "moneyWithRepaidCredit": 710.00,
  "approximate": false
}

В staff_sales то же разложение лежит в payment у позиции и в summary.byPayment: за 92 дня по продавцам — наличные 433 300, карта 171 275, безнал 3 600, кредит 6 300; money = 608 175 из 614 475.

staff_trainings

Проведённые тренировки сотрудника — по строке на тренировку: занятие расписания (source = event: время, длительность, группа/индивидуальная, услуга, класс, основной и дополнительные тренеры, статус), визит без занятия (visit) или списание без визита (writeoff); сколько клиентов пришло и суммы цен. В summary — тренировки по источникам, hours, emptyTrainings (занятия без посещений — система их тоже считает), посещения, цены, разрез по услугам.

ПараметрТипОбяз.Описание
staffIdintegerнетID сотрудника (staffId из staff_list). Не указан — все сотрудники.
period / days / dateFrom / dateTostring / integerнетПериод (по умолчанию last_month, максимум 3 месяца).
branchIdintegerнетФилиал.
limit / offsetintegerнетСтраница до 200 строк (по умолчанию 20).

Пример запроса и ответа

«Сколько тренировок и часов у сотрудника за июль?» — 20 занятий, 15 часов, на одном из них был клиент.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "staff_trainings",
    "arguments": {
      "staffId": 132,
      "period": "custom",
      "dateFrom": "2026-07-01",
      "dateTo": "2026-07-31",
      "limit": 2
    }
  }
}
{
  "metric": "staff_trainings",
  "definition": "Данные для расчёта зарплаты сотрудника (тренера и других исполнителей услуг) по алгоритму владельца клуба. Основа — списания услуг (ServiceUse): клиент пришёл на тренировку или за услугой, исполнитель — сотрудник. Цена посещения — по правилам ядра: сохранённые суммы списания, а если их нет, пересчёт по основанию (цена продажи позиции; для абонемента на N занятий делится на N; для безлимитного абонемента и клубной карты — прайс списанной услуги). Тренировка: занятие расписания, визит без занятия или списание без визита. Зарплата по ФИО сотрудника — чувствительные персональные данные, клиенты показаны как «Имя Ф.»: не пересылайте данные дальше без необходимости.",
  "period": {
    "start": "2026-07-01T00:00:00",
    "end": "2026-08-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2026-07-01 — 2026-07-31 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T15:03:29.6498792",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "staffId": 132
    }
  },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "summary": {
    "trainings": 20,
    "billable": 20,
    "excluded": {},
    "bySource": {
      "event": 20,
      "visit": 0,
      "writeoff": 0
    },
    "hours": 15,
    "trainingsWithoutDuration": 0,
    "emptyTrainings": 19,
    "attendances": 1,
    "prices": {
      "bySale": 1800.0,
      "byService": 1800.0,
      "stored": 1,
      "calculated": 0,
      "missing": 0,
      "note": "Суммы — по учитываемым (billable) посещениям; missing — посещения без цены, в суммы не входят."
    },
    "byService": [
      {
        "serviceId": 103,
        "service": "Гимнастика дети",
        "trainings": 10,
        "attendances": 0,
        "bySale": 0,
        "byService": 0
      },
      {
        "serviceId": 134,
        "service": "Персональная тренировка 2",
        "trainings": 9,
        "attendances": 0,
        "bySale": 0,
        "byService": 0
      },
      {
        "serviceId": 10,
        "service": "ПТ Разовая",
        "trainings": 1,
        "attendances": 1,
        "bySale": 1800.0,
        "byService": 1800.0
      }
    ]
  },
  "completeness": {
    "complete": true,
    "attendancesInSelection": 1,
    "maxRows": 20000,
    "pageSize": 2,
    "note": "Выборка загружена целиком: summary и page.total описывают все посещения периода, не только текущую страницу. Если page.hasMore = true, для построчной проверки запросите следующие страницы (offset)."
  },
  "unassigned": {
    "attendances": 0,
    "billable": 0,
    "prices": {
      "bySale": 0,
      "byService": 0,
      "stored": 0,
      "calculated": 0,
      "missing": 0,
      "note": "Суммы — по учитываемым (billable) посещениям; missing — посещения без цены, в суммы не входят."
    },
    "rule": "Посещения без исполнителя, связанные с этим сотрудником косвенно: визит, где он исполнитель. В расчёте зарплаты системы они не участвуют и в обычный summary не входят: платить ли за них, решает владелец клуба.",
    "withEvent": 0,
    "withEventTrainer": 0,
    "withoutEvent": 0,
    "hint": "С занятием (withEvent) — вероятно, тренировки без назначенного исполнителя; withEventTrainer — из них те, у занятия которых основной тренер указан (event.staffId). Без занятия (withoutEvent) — чаще обычные визиты клиентов в клуб (членство, солярий, разовые посещения), а не тренировки: на зарплату они обычно не влияют.",
    "byService": [],
    "itemsShown": 0,
    "items": []
  },
  "systemPayroll": {
    "sheets": [
      {
        "sheetId": 54,
        "dateStart": "2026-06-01T00:00:00",
        "dateEnd": "2026-08-31T23:59:59",
        "coversPeriod": true,
        "salary": 18000.0,
        "piecework": 4886.25,
        "total": 22886.25,
        "accruals": [
          {
            "accrual": "от продаж йоги",
            "amount": 4886.25,
            "base": 97725.0,
            "description": "Начисление 5 % от продаж на суммму 97 725,00 ₽ в размере 4 886,25 ₽"
          }
        ]
      },
      {
        "sheetId": 53,
        "dateStart": "2026-07-01T00:00:00",
        "dateEnd": "2026-07-31T23:59:59",
        "coversPeriod": true,
        "salary": 18000.0,
        "piecework": 686.25,
        "total": 18686.25,
        "accruals": [
          {
            "accrual": "от продаж йоги",
            "amount": 686.25,
            "base": 13725.0,
            "description": "Начисление 5 % от продаж на суммму 13 725,00 ₽ в размере 686,25 ₽"
          }
        ]
      }
    ],
    "note": "Это расчёт самой системы по схеме сотрудника (payroll_schemes со staffId), а не вашего правила: расхождение с расчётом ИИ ожидаемо. coversPeriod = false значит, что период листа не совпадает с запрошенным, и сравнивать суммы напрямую нельзя."
  },
  "page": {
    "total": 20,
    "limit": 2,
    "offset": 0,
    "hasMore": true
  },
  "items": [
    {
      "trainingId": 24239,
      "source": "event",
      "start": "2026-07-03T21:00:00",
      "end": "2026-07-03T22:00:00",
      "durationMinutes": 60,
      "name": "Персональная тренировка 2",
      "kind": "individual",
      "service": {
        "serviceId": 134,
        "name": "Персональная тренировка 2"
      },
      "class": null,
      "staffId": 132,
      "staff": "Иванова Мария",
      "coTrainers": [],
      "status": "Завершено",
      "billable": true,
      "excludeReason": null,
      "excludeReasonName": null,
      "attendances": {
        "total": 0,
        "billable": 0,
        "excluded": 0,
        "byStaff": 0
      },
      "prices": {
        "bySale": 0,
        "byService": 0,
        "priceMissing": 0
      },
      "branchId": 947,
      "branch": "Без филиала"
    },
    ...
  ]
}

staff_sales

Продажи сотрудника — по строке на позицию продажи: дата подтверждения, продукт (вид: abonement, club_card, service, goods, other; категория), amount (после скидок), gross, discount, клиент, роли сотрудника в продаже (seller — продавец, executor — исполнитель позиции, recommender — рекомендатель). Отбор как в расчёте зарплаты системы: проведённые продажи с суммой больше нуля. Возвращённые целиком (sale_returned), отменённые (sale_cancelled) и частично возвращённые позиции (item_returned) помечаются, не скрываются. Итоги по ролям не складываются: одна позиция может быть сразу в нескольких.

ПараметрТипОбяз.Описание
staffIdintegerнетID сотрудника (staffId из staff_list). Не указан — все сотрудники с заполненной выбранной ролью.
rolestringнетseller (продавец), executor (исполнитель позиции), recommender (рекомендатель) или any (по умолчанию).
period / days / dateFrom / dateTostring / integerнетПериод (по умолчанию last_month, максимум 3 месяца).
branchIdintegerнетФилиал.
limit / offsetintegerнетСтраница до 200 строк (по умолчанию 20).

Пример запроса и ответа

«Посчитай сотруднику 10 % с её продаж за июль» — 10 % от summary.amount (77 125) даёт 7 712,50; по видам: абонементы 67 025, услуги 10 100.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "staff_sales",
    "arguments": {
      "staffId": 132,
      "period": "custom",
      "dateFrom": "2026-07-01",
      "dateTo": "2026-07-31",
      "limit": 2
    }
  }
}
{
  "metric": "staff_sales",
  "definition": "Позиции проведённых продаж, в которых сотрудник — продавец (Sale.Personal), исполнитель позиции (SaleItem.Executor) или рекомендатель (Sale.Recomended); сумма — SaleItem.ResultSumm после скидок; период — по дате подтверждения продажи. Зарплата по ФИО сотрудника — чувствительные персональные данные, клиенты показаны как «Имя Ф.»: не пересылайте данные дальше без необходимости.",
  "period": {
    "start": "2026-07-01T00:00:00",
    "end": "2026-08-01T00:00:00",
    "interval": "[start, end)",
    "kind": "custom",
    "label": "2026-07-01 — 2026-07-31 (включительно)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-28T15:03:21.2946319",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "staffId": 132,
      "role": "any"
    }
  },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "summary": {
    "items": 15,
    "billable": 15,
    "amount": 77125.0,
    "gross": 77800.0,
    "discount": 675.0,
    "excluded": {},
    "byRole": {
      "seller": {
        "items": 15,
        "amount": 77125.0
      },
      "executor": {
        "items": 0,
        "amount": 0
      },
      "recommender": {
        "items": 0,
        "amount": 0
      }
    },
    "byKind": [
      {
        "kind": "abonement",
        "items": 8,
        "amount": 67025.0
      },
      {
        "kind": "service",
        "items": 7,
        "amount": 10100.0
      }
    ],
    "byProduct": [
      {
        "productId": 84,
        "product": "Абонемент 10 йога/стретчинг",
        "kind": "abonement",
        "items": 1,
        "amount": 25000.0
      },
      {
        "productId": 142,
        "product": "10 групповых занятий на 1 мес.",
        "kind": "abonement",
        "items": 2,
        "amount": 20000.0
      },
      ...
    ],
    "byCategory": [
      {
        "category": "Абонементы",
        "items": 8,
        "amount": 67025.0
      },
      ...
    ]
  },
  "completeness": {
    "complete": true,
    "itemsInSelection": 15,
    "maxRows": 20000,
    "pageSize": 2,
    "note": "Выборка загружена целиком: summary и page.total описывают все позиции периода, не только текущую страницу. Если page.hasMore = true, для построчной проверки запросите следующие страницы (offset)."
  },
  "page": {
    "total": 15,
    "limit": 2,
    "offset": 0,
    "hasMore": true
  },
  "items": [
    {
      "saleItemId": 7452,
      "saleId": 7749,
      "date": "2026-07-01T15:13:19.297",
      "product": {
        "productId": 142,
        "name": "10 групповых занятий на 1 мес.",
        "kind": "abonement",
        "category": "Абонементы"
      },
      "quantity": 1,
      "amount": 10000.0,
      "gross": 10000.0,
      "discount": 0.0,
      "client": {
        "clientId": 913,
        "name": "K."
      },
      "roles": [
        "seller"
      ],
      "seller": {
        "staffId": 132,
        "name": "Иванова Мария"
      },
      "executor": {
        "staffId": null,
        "name": null
      },
      "recommender": {
        "staffId": null,
        "name": null
      },
      "billable": true,
      "excludeReason": null,
      "excludeReasonName": null,
      "branchId": 1048,
      "branch": "fitness365 Санкт-Петербург"
    },
    ...
  ]
}

Продажи и платежи

sales_summary

Итоги продаж за период: число покупок, сумма продаж (выручка по продажам после скидок), фактическая оплата, оплата с депозита и бонусами, средний чек, возвраты отдельно; сравнение с предыдущим периодом (compare=true). Для «сколько покупок в этом месяце», «какая выручка», «рост продаж к прошлому месяцу», «средний чек».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
comparebooleanнетtrue — добавить сравнение с предыдущим периодом (разница и процент изменения).

Пример запроса и ответа

«Какая выручка за прошлый месяц и как она изменилась?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sales_summary",
    "arguments": {
      "period": "last_month",
      "compare": true
    }
  }
}
{
  "metric": "sales_summary",
  "definition": "Итоги проведённых продаж: количество, сумма (после скидок), фактическая оплата, оплата с депозита и бонусами, средний чек. «Выручка (оборот) по продажам» здесь = сумма проведённых продаж после скидок ([Transaction].Summ); фактически полученные деньги — paidAmount (наличные+карта+безнал−сдача). Возвраты показываются отдельно; выручка нетто не вычисляется.",
  "period": {
    "start": "2026-09-01T00:00:00",
    "end": "2026-10-01T00:00:00",
    "interval": "[start, end)",
    "kind": "last_month",
    "label": "Прошлый календарный месяц",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:43",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [],
  "value": 1,
  "unit": "sales",
  "salesAmount": 4000.0,
  "paidAmount": 4000.0,
  "paidFromDeposit": 0.0,
  "paidByBonus": 0.0,
  "averageCheck": 4000.0,
  "returns": { "count": 0, "amount": 0.0, "cancelledSalesCount": 0, "cancelledSalesAmount": 0.0 },
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "comparison": {
    "previousPeriod": {
      "start": "2026-08-01T00:00:00",
      "end": "2026-09-01T00:00:00",
      "interval": "[start, end)",
      "kind": "last_month",
      "label": "Предыдущий календарный месяц",
      "timezone": "Europe/Moscow"
    },
    "salesCount": { "current": 1, "previous": 29, "absoluteChange": -28, "percentChange": -96.55, "note": null },
    "salesAmount": {
      "current": 4000.0,
      "previous": 564975.0,
      "absoluteChange": -560975.0,
      "percentChange": -99.29,
      "note": null
    },
    "paidAmount": {
      "current": 4000.0,
      "previous": 564975.0,
      "absoluteChange": -560975.0,
      "percentChange": -99.29,
      "note": null
    },
    "averageCheck": {
      "current": 4000.0,
      "previous": 19481.9,
      "absoluteChange": -15481.9,
      "percentChange": -79.47,
      "note": null
    }
  }
}

sales_dynamics

Динамика продаж (количество и сумма проведённых продаж) по дням, неделям или месяцам за период. Для «какова выручка по дням за последний месяц».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
granularitystringнетШаг ряда: day, week (с понедельника) или month. По умолчанию day для периодов до 31 дня, иначе week.

Пример запроса и ответа

«Покажи динамику выручки по неделям за 30 дней.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sales_dynamics",
    "arguments": {
      "period": "last_n_days",
      "days": 30,
      "granularity": "week"
    }
  }
}
{
  "metric": "sales_dynamics",
  "definition": "Количество и сумма проведённых продаж по интервалам ряда. «Выручка (оборот) по продажам» здесь = сумма проведённых продаж после скидок ([Transaction].Summ); фактически полученные деньги — paidAmount (наличные+карта+безнал−сдача).",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:57",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "granularity": "week",
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "totalCount": 8,
  "totalAmount": 21400.0,
  "items": [
    { "date": "2026-09-21T00:00:00", "sales": 0, "amount": 0 },
    { "date": "2026-09-28T00:00:00", "sales": 1, "amount": 4000.0 },
    { "date": "2026-10-05T00:00:00", "sales": 0, "amount": 0 }
  ]
}

Для краткости в примере сокращены длинные массивы (items): показаны первые 3 элемента.

sales_by_branch

Продажи по каждому филиалу за период: количество, сумма, фактическая оплата, средний чек. Для «какая выручка по каждому филиалу», «сравни выручку двух филиалов».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.

Пример запроса и ответа

«Какая выручка по филиалам за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sales_by_branch",
    "arguments": {
      "period": "last_n_days",
      "days": 30
    }
  }
}
{
  "metric": "sales_by_branch",
  "definition": "Рейтинг филиалов по сумме проведённых продаж. «Выручка (оборот) по продажам» здесь = сумма проведённых продаж после скидок ([Transaction].Summ); фактически полученные деньги — paidAmount (наличные+карта+безнал−сдача).",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:46",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "items": [
    {
      "branchId": 1048,
      "branch": "fitness365 Санкт-Петербург",
      "sales": 8,
      "salesAmount": 21400.0,
      "paidAmount": 15100.0,
      "averageCheck": 2675.0
    }
  ]
}

sales_by_employee

Рейтинг сотрудников-продавцов по сумме проведённых продаж за период (количество, сумма, средний чек). Имена — только инициал фамилии.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).

Пример запроса и ответа

«Кто из сотрудников продал больше всего за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sales_by_employee",
    "arguments": {
      "period": "last_n_days",
      "days": 30,
      "limit": 3
    }
  }
}
{
  "metric": "sales_by_employee",
  "definition": "Рейтинг сотрудников (продавцов) по сумме проведённых продаж.",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:50",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "items": [ { "employeeId": 132, "employee": "Юлия В.", "sales": 8, "salesAmount": 21400.0, "averageCheck": 2675.0 } ]
}

sales_top_products

Самые популярные товары/услуги/абонементы за период по сумме (проданные позиции проведённых продаж без возвратов): число продаж, количество единиц, сумма после скидок. kind: all, abonement, service, goods.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
kindstringнетТип позиций: all (по умолчанию), abonement (абонементы и клубные карты), service (разовые услуги), goods (товары).
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).

Пример запроса и ответа

«Какие абонементы лучше всего продавались в прошлом месяце?» Для рейтингов по умолчанию 10 строк, максимум 50 (limit).

{
  "jsonrpc": "2.0", "id": 4, "method": "tools/call",
  "params": {
    "name": "sales_top_products",
    "arguments": { "period": "last_month", "limit": 2 }
  }
}

Чтобы сузить выборку, добавьте "kind": "abonement" или "branchId": 1084. Блок filters в ответе отражает фактически применённые фильтры:

{
  "metric": "sales_top_products",
  "definition": "Позиции проведённых продаж (без возвратов) с наибольшей суммой после скидок; sold — число проданных позиций, quantity — единиц.",
  "period": { "start": "2026-09-01T00:00:00", "end": "2026-10-01T00:00:00", "kind": "last_month", "timezone": "Europe/Moscow" },
  "asOf": "2026-10-23T16:31:59",
  "filters": { "branchId": null, "branchName": null, "extra": { "kind": "all" } },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "items": [
    { "productId": 121, "name": "10 занятий +2 гостевых",         "sold": 1, "quantity": 1, "amount": 35000.00 },
    { "productId": 142, "name": "10 групповых занятий на 1 мес.", "sold": 3, "quantity": 3, "amount": 30000.00 }
  ]
}

sales_by_category

Структура продаж по категориям продуктов за период: сумма позиций после скидок и доля от общей суммы.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).

Пример запроса и ответа

«Какая выручка по категориям товаров и услуг за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sales_by_category",
    "arguments": {
      "period": "last_n_days",
      "days": 30,
      "limit": 3
    }
  }
}
{
  "metric": "sales_by_category",
  "definition": "Структура проведённых продаж (без возвратов) по категориям продуктов: сумма позиций и доля.",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:48",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "totalAmount": 16900.0,
  "items": [ { "category": "Абонементы", "items": 7, "amount": 16900.0, "share": 100 } ]
}

sales_by_type

Проданные позиции по типу продажи (первичная, продление, пробная, услуга, товар, депозит и т.д.): число позиций и сумма после скидок.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
subscriptionstringнетПродажи по подписке: with_subscription — первая покупка абонемента с подпиской; renewal — оплата очередного периода подписки; any — любая подписочная; none — без подписки. Не указано — все продажи.

Пример запроса и ответа

«Какая выручка по типам продаж за последние 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sales_by_type",
    "arguments": {
      "period": "last_n_days",
      "days": 30
    }
  }
}
{
  "metric": "sales_by_type",
  "definition": "Позиции проведённых продаж (без возвратов) по типу продажи.",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:54",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "items": [
    { "type": "Продление", "items": 5, "amount": 11400.0 },
    { "type": "Первичная", "items": 2, "amount": 5500.0 }
  ]
}

sales_returns

Возвраты за период: возвраты покупателям (BuyReturnTransaction) — количество и сумма — и продажи, отменённые со статусом «Возврат»; по филиалам; сравнение (compare=true). Для «сколько было возвратов и на какую сумму».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
comparebooleanнетtrue — добавить сравнение с предыдущим периодом (разница и процент изменения).

Пример запроса и ответа

«Сколько возвратов было за прошлый месяц?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sales_returns",
    "arguments": {
      "period": "last_month",
      "compare": true
    }
  }
}
{
  "metric": "sales_returns",
  "definition": "Возвраты покупателям (BuyReturnTransaction, проведённые) и продажи, отменённые со статусом «Возврат», за период.",
  "period": {
    "start": "2026-09-01T00:00:00",
    "end": "2026-10-01T00:00:00",
    "interval": "[start, end)",
    "kind": "last_month",
    "label": "Прошлый календарный месяц",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:01",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "returns": { "count": 0, "amount": 0.0 },
  "cancelledSales": { "count": 0, "amount": 0.0 },
  "byBranch": [],
  "comparison": {
    "previousPeriod": {
      "start": "2026-08-01T00:00:00",
      "end": "2026-09-01T00:00:00",
      "interval": "[start, end)",
      "kind": "last_month",
      "label": "Предыдущий календарный месяц",
      "timezone": "Europe/Moscow"
    },
    "returnsCount": {
      "current": 0,
      "previous": 0,
      "absoluteChange": 0,
      "percentChange": null,
      "note": "Предыдущее значение равно 0 — процент изменения не определён."
    },
    "returnsAmount": {
      "current": 0.0,
      "previous": 0.0,
      "absoluteChange": 0.0,
      "percentChange": null,
      "note": "Предыдущее значение равно 0 — процент изменения не определён."
    },
    "cancelledSalesCount": {
      "current": 0,
      "previous": 0,
      "absoluteChange": 0,
      "percentChange": null,
      "note": "Предыдущее значение равно 0 — процент изменения не определён."
    }
  }
}

sales_list

Реестр продаж за период (по одной строке на продажу, новые сверху): дата, клиент (Фамилия Имя полностью), ID продажи, товары/услуги (название, количество, сумма до скидки, скидка, сумма), сумма продажи (после скидок), общая скидка, способ оплаты и разбивка оплаты (наличные/карта/безнал/депозит/бонусы/кредит/сдача), ответственный сотрудник, филиал, статус, признак отмены (cancelled) и данные отмены (cancellation: дата, кто отменил — из журнала TransactionCancel). По умолчанию период last_n_days.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
statusstringнетcompleted — проведена (по умолчанию); saved — сохранена (не проведена); waiting_payment — ожидает оплаты; cancelled — отменена (статус «Возврат» или есть запись об отмене); all — все независимо от статуса.
clientIdintegerнетID клиента — только его продажи.
phonestringнетМобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); точное совпадение по TelefoneCellForSearch (индекс), не менее 7 цифр. Телефон в ответ не выводится.
lastNamestringнетНачало фамилии клиента (именительный падеж). Учитывается, только если clientId не указан (иначе предупреждение). Поиск по имени требует обе части — lastName и firstName; одна из них без clientId/phone → ошибка.
firstNamestringнетНачало имени клиента (именительный падеж), можно вместе с lastName («Иванова Сергея» → lastName=Иванов, firstName=Сергей). Учитывается, только если clientId не указан. Требуется вместе с lastName (см. выше).
employeeIdintegerнетID сотрудника, оформившего продажу (см. sales_by_employee).
subscriptionstringнетПродажи по подписке: with_subscription — первая покупка абонемента с подпиской; renewal — оплата очередного периода подписки (автопродление или ручная оплата); any — любая подписочная; none — без подписки. Не указано — все продажи. В строках есть поле subscription.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Период: при фильтре по конкретному клиенту (clientId, phone или пара lastName+firstName) ограничение в 3 месяца снято: без period/dateFrom возвращается вся история клиента (period.kind = all_time). Без такого фильтра действует обычное правило (по умолчанию 30 дней, максимум 3 месяца). Размер ответа ограничен limit ≤ 50 с постраничным выводом.

Пример запроса и ответа

«Покажи последние продажи за 7 дней.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sales_list",
    "arguments": {
      "period": "last_n_days",
      "days": 7,
      "limit": 2
    }
  }
}
{
  "metric": "sales_list",
  "definition": "Построчный реестр продаж. amount — сумма продажи после скидок (Transaction.Summ); discount — сумма скидок по позициям; amountBeforeDiscount — до скидок; cancelled = статус «Возврат» или есть запись в журнале отмен. Имена выдаются полностью («Фамилия Имя») — это персональные данные, не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2026-10-17T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 7 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:59",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "status": "completed",
      "clientId": null,
      "phone": null,
      "lastName": null,
      "firstName": null,
      "employeeId": null
    }
  },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "page": { "total": 6, "limit": 2, "offset": 0, "hasMore": true },
  "totalAmount": 12900.0,
  "items": [
    {
      "saleId": 7953,
      "date": "2026-10-22T00:42:13.62",
      "clientId": 1466,
      "client": "333",
      "products": [
        {
          "productId": 146,
          "name": "Безлимит 1 мес",
          "quantity": 1,
          "amountBeforeDiscount": 3000.0,
          "discount": 0.0,
          "amount": 3000.0
        }
      ],
      "amountBeforeDiscount": 3000.0,
      "discount": 0.0,
      "amount": 3000.0,
      "paymentType": "Наличные",
      "payments": {
        "cash": 3000.0,
        "card": 0.0,
        "beznal": 0.0,
        "deposit": 0.0,
        "bonus": 0.0,
        "credit": 0.0,
        "change": 0.0
      },
      "employeeId": 132,
      "employee": "Васина Юлия",
      "branchId": 1048,
      "branch": "fitness365 Санкт-Петербург",
      "status": "Проведена",
      "cancelled": false,
      "cancellation": null
    },
    {
      "saleId": 7952,
      "date": "2026-10-22T00:41:27.457",
      "clientId": 1466,
      "client": "333",
      "products": [
        {
          "productId": 146,
          "name": "Безлимит 1 мес",
          "quantity": 1,
          "amountBeforeDiscount": 3000.0,
          "discount": 900.0,
          "amount": 2100.0
        }
      ],
      "amountBeforeDiscount": 3000.0,
      "discount": 900.0,
      "amount": 2100.0,
      "paymentType": "Кредит",
      "payments": {
        "cash": 0.0,
        "card": 0.0,
        "beznal": 0.0,
        "deposit": 0.0,
        "bonus": 0.0,
        "credit": 2100.0,
        "change": 0.0
      },
      "employeeId": 132,
      "employee": "Васина Юлия",
      "branchId": 1048,
      "branch": "fitness365 Санкт-Петербург",
      "status": "Проведена",
      "cancelled": false,
      "cancellation": null
    }
  ]
}

returns_list

Реестр возвратов покупателям за период (проведённые BuyReturnTransaction, новые сверху): дата операции, сумма, способ оплаты, ID клиента и клиент (Фамилия Имя полностью), ID продажи (колонка Sale, а если пуста — продажа возвращаемой позиции), товар/услуга, филиал. Отменённые продажи — в sales_list со status=cancelled.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
clientIdintegerнетID клиента — только его возвраты.
phonestringнетМобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); не менее 7 цифр. Только возвраты этого клиента.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Покажи возвраты за последние 90 дней.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "returns_list",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "limit": 2
    }
  }
}
{
  "metric": "returns_list",
  "definition": "Построчный реестр возвратов покупателям (BuyReturnTransaction, проведённые): amount — сумма возврата (Transaction.Summ). Имена выдаются полностью («Фамилия Имя») — это персональные данные, не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:04",
  "filters": { "branchId": null, "branchName": null, "extra": { "clientId": null, "phone": null } },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "page": { "total": 0, "limit": 2, "offset": 0, "hasMore": false },
  "totalAmount": 0.0,
  "items": []
}

crm_tasks_list

Реестр CRM-задач, созданных за период (новые сверху): клиент/лид (Фамилия Имя полностью) и его тип, ответственный менеджер, дата создания, старт, срок (dueDate = EndDate; у выполненной задачи — время выполнения), статус, тип задачи, название, результат (справочник CRMTaskResult: «Продажа», «Отказ», «Позвонить позже» и т.д.), комментарий (Description), комментарий к результату (ResultDescription), дата следующего контакта. Два поля заданы с оговорками: nextContactDate вычисляется (ближайший старт другой незавершённой задачи того же клиента позже старта этой; отдельного поля в БД нет), promisedPurchaseDate в БД не хранится — всегда null. По умолчанию период last_n_days.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
statusstringнетall (по умолчанию), open (открыта), in_progress (в процессе), done (выполнена), deferred (отложена).
managerIdintegerнетID ответственного сотрудника (менеджера) задачи.
clientIdintegerнетID клиента или потенциального клиента (лида), к которому относится задача.
phonestringнетМобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); не менее 7 цифр. Задачи клиента или лида с этим телефоном.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Какие CRM-задачи были за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "crm_tasks_list",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "limit": 2
    }
  }
}
{
  "metric": "crm_tasks_list",
  "definition": "Построчный реестр CRM-задач по дате создания. dueDate — срок (EndDate; у выполненной задачи — время выполнения). nextContactDate — вычисляется: ближайший старт другой незавершённой задачи того же клиента позже старта этой (отдельного поля в БД нет). promisedPurchaseDate — в БД не хранится, всегда null. Имена — полностью («Фамилия Имя»): персональные данные.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:25",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": { "status": "all", "managerId": null, "clientId": null, "phone": null }
  },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "page": { "total": 9, "limit": 2, "offset": 0, "hasMore": true },
  "items": [
    {
      "taskId": 5636,
      "clientId": 1482,
      "client": "Васечкин Иван",
      "clientType": "Клиент",
      "managerId": 132,
      "manager": "Васина Юлия",
      "createdAt": "2026-08-28T20:59:21.87",
      "startDate": "2026-11-03T00:00:00",
      "dueDate": "2026-11-05T23:59:59",
      "status": "Открыта",
      "taskType": "Исходящий звонок",
      "title": "Сервисный звонок. Позвонить Васечкин Иван через 7 дней после завершения карты",
      "result": null,
      "comment": "Довольны ли Вы своими результатами. Готовы ли продлить. Как меняются цели клиента, основные отзывы заносить в карточку Клиента.",
      "resultComment": null,
      "promisedPurchaseDate": null,
      "nextContactDate": null,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    },
    {
      "taskId": 5635,
      "clientId": 1482,
      "client": "Васечкин Иван",
      "clientType": "Клиент",
      "managerId": 132,
      "manager": "Васина Юлия",
      "createdAt": "2026-08-28T20:44:05.08",
      "startDate": "2026-11-03T00:00:00",
      "dueDate": "2026-11-05T23:59:59",
      "status": "Открыта",
      "taskType": "Исходящий звонок",
      "title": "Сервисный звонок. Позвонить Васечкин Иван через 7 дней после завершения карты",
      "result": null,
      "comment": "Довольны ли Вы своими результатами. Готовы ли продлить. Как меняются цели клиента, основные отзывы заносить в карточку Клиента.",
      "resultComment": null,
      "promisedPurchaseDate": null,
      "nextContactDate": null,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    }
  ]
}

crm_task_create

Пишущий инструмент (readOnlyHint=false, включается опцией Mcp:EnableWrites; если опция выключена — сервер отклоняет вызов с объяснением). Создаёт CRM-задачу по клиенту или лиду: «запиши/создай задачу по клиенту Иванову Сергею, позвонить ему 31 декабря, поздравить с Новым годом». clientId берите из client_find. Поведение как при создании задачи в интерфейсе клуба: статус «Открыта», филиал = филиал клиента/лида, ответственный = менеджер клиента/лида (если managerId не указан), «последняя активная задача» (LastTask) клиента/лида обновляется. Отличия от интерфейса: журнал аудита (AuditEvent) не пишется, поля телефонии (PhoneNumber, Call_ID, Entry_ID, Record_ID) пустые — их заполняет только SIP-телефония. Ответ — объект task с тем же набором полей, что строка crm_tasks_list (кроме result/resultComment/nextContactDate, у новой задачи их нет), плюс uid и comment.

ПараметрТипОбяз.Описание
clientIdintegerдаID клиента или потенциального клиента (лида). Тип цели («Клиент»/«Потенциальный клиент») определяется автоматически.
titlestringдаСуть (название) задачи, до 500 символов (при превышении обрезается с предупреждением).
taskTypestringнетТип — название справочника CRMTaskType: Задача (по умолчанию), Исходящий звонок, Входящий звонок, SMS, Продление, Напоминание. Незнакомое название → ошибка с перечнем допустимых типов.
startDatestringнетДата начала YYYY-MM-DD; по умолчанию — сегодня (дата клуба). В БД хранится с временем 00:00:00.
endDatestringнетДата окончания (срок) YYYY-MM-DD; по умолчанию равна startDate, хранится 23:59:59. Дата раньше startDate → ошибка.
descriptionstringнетКомментарий (поле «Описание» в CRM), до 2000 символов (при превышении обрезается с предупреждением).
managerIdintegerнетID ответственного сотрудника. По умолчанию — менеджер клиента/лида (Client.Manager/Lead.Manager); если и его нет — исполнитель не назначен (предупреждение в ответе).

Пример запроса и ответа

«Создай задачу по клиенту Иванову Сергею, позвонить ему 31 декабря, поздравить с Новым годом» (после client_find вернул clientId = 143).

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "crm_task_create",
    "arguments": {
      "clientId": 143,
      "title": "Позвонить 31 декабря — поздравить с Новым годом",
      "taskType": "Исходящий звонок",
      "startDate": "2026-12-31",
      "description": "Позвонить 31 декабря, поздравить с Новым годом."
    }
  }
}
{
  "metric": "crm_task_create",
  "definition": "Создана одна CRM-задача: статус «Открыта», тип из запроса (по умолчанию «Задача»), срок endDate, ответственный managerId или менеджер клиента/лида. Задача сразу видна в crm_tasks_list (дата создания — «сейчас» по дате клуба). Отличия от создания в интерфейсе клуба: журнал аудита (AuditEvent) не пишется, поля телефонии (PhoneNumber, Call_ID, Record_ID) пустые.",
  "asOf": "2026-10-29T21:49:19",
  "filters": {
    "clientId": 143,
    "clientType": "Клиент",
    "taskType": "Исходящий звонок",
    "startDate": "2026-12-31T00:00:00",
    "endDate": "2026-12-31T23:59:59",
    "managerId": 124
  },
  "warnings": [ "Задача стала «последней активной» (LastTask) клиента/лида — как при создании из интерфейса клуба." ],
  "task": {
    "taskId": 5637,
    "uid": "5130c982-f699-4fca-8aed-ce915ee1fddc",
    "clientId": 143,
    "client": "Иванов Сергей",
    "clientType": "Клиент",
    "managerId": 124,
    "manager": "Мобильное Приложение",
    "createdAt": "2026-10-29T21:49:19",
    "startDate": "2026-12-31T00:00:00",
    "dueDate": "2026-12-31T23:59:59",
    "status": "Открыта",
    "taskType": "Исходящий звонок",
    "title": "Позвонить 31 декабря — поздравить с Новым годом",
    "comment": "Позвонить 31 декабря, поздравить с Новым годом.",
    "branchId": 1,
    "branch": "Без филиала"
  }
}

lead_create

Пишущий инструмент (readOnlyHint=false, включается опцией Mcp:EnableWrites; если опция выключена — сервер отклоняет вызов с объяснением). Создаёт лида (потенциального клиента): «заведи лида Иванова Сергея, телефон …». Как в интерфейсе клуба, вместе с лидом создаётся парный клиент (признак «потенциальный», IsLead = 1) со скидочным счётом; лид получает начальный статус и запись в истории статусов. Перед созданием проверяются дубликаты по правилу клуба (SystemConfiguration.CheckingClientDuplicatesByFields, по умолчанию — телефон): если такой клиент или лид уже есть, лид не создаётся, а ошибка называет найденные записи. Всё пишется в одной транзакции. Не воспроизводится: журнал аудита, интеграции (AmoCRM, Битрикс), события. Для задачи по новому лиду вызывайте crm_task_create с leadId.

ПараметрТипОбяз.Описание
lastName / firstNamestringодно из двухФамилия, имя (до 100 символов; ФИО целиком — до 100). Нужна хотя бы фамилия или имя.
middleNamestringнетОтчество, до 100 символов.
phonestringнетМобильный телефон в любом формате, 7–25 цифр. Участвует в проверке дубликатов (нормализация как в ядре: 8… → 7…, скобки, «+», «-» убираются).
emailstringнетE-mail, до 50 символов.
sexstringнетmale или female; не указан — не определён.
dateOfBirthstringнетYYYY-MM-DD, не позже сегодня.
sourcestringнетНазвание источника привлечения из справочника клуба (без учёта регистра); неизвестное → ошибка со списком допустимых.
branchIdintegerнетID филиала (get_branches). Если у клуба один филиал — подставляется он, если несколько — обязателен.
managerIdintegerнетID ответственного сотрудника (staff_list); не указан — лид без менеджера (предупреждение в ответе).
notestringнетКомментарий к лиду, до 2000 символов (у парного клиента в описание попадают первые 500).

Пример ответа

Тестовый вызов (запись затем удалена). Телефон и e-mail в ответ не возвращаются.

{
  "metric": "lead_create",
  "filters": { "branchId": 1084, "branchName": "fitness365 Москва", "source": null, "managerId": 124 },
  "warnings": [],
  "lead": {
    "leadId": 2492,
    "uid": "fc42be71-2f99-44c1-be22-1e194f80fba1",
    "pairedClientId": 2491,
    "name": "Тестовый Лид Проверкович",
    "branchId": 1084,
    "branch": "fitness365 Москва",
    "managerId": 124,
    "manager": "Мобильное Приложение",
    "source": null,
    "createdAt": "2026-10-30T00:41:30.462"
  }
}

Дубликат

Повторный вызов с тем же телефоном (в другом формате) отклоняется: «Лид не создан: найдены дубликаты по правилу клуба (поля: TelefoneCellForSearch): ID 2491 … (лид). Используйте существующую запись (client_find) или уточните данные.»

client_create

Пишущий инструмент (readOnlyHint=false, включается опцией Mcp:EnableWrites; если опция выключена — сервер отклоняет вызов с объяснением). Создаёт клиента (не лида): «заведи клиента Иванова Сергея, телефон …». Для потенциального клиента, который ещё ничего не купил, используйте lead_create. Как в интерфейсе клуба, клиенту создаётся скидочный счёт, включены согласия на рассылки; «доступен всем филиалам» берётся из настройки клуба (IsClientAllowToAllByDefault). Перед созданием проверяются дубликаты по правилу клуба (по умолчанию — телефон): если такой клиент или лид уже есть, клиент не создаётся, а ошибка называет найденные записи. Всё пишется в одной транзакции. Не воспроизводится: журнал аудита, интеграции (AmoCRM, Битрикс), события; карта клиента и бонусный счёт не создаются. Для задачи по клиенту вызывайте crm_task_create с clientId.

ПараметрТипОбяз.Описание
lastName / firstNamestringодно из двухФамилия, имя (до 100 символов; ФИО целиком — до 100). Нужна хотя бы фамилия или имя.
middleNamestringнетОтчество, до 100 символов.
phonestringнетМобильный телефон в любом формате, 7–25 цифр. Участвует в проверке дубликатов.
emailstringнетE-mail, до 50 символов.
sexstringнетmale или female; не указан — не определён.
dateOfBirthstringнетYYYY-MM-DD, не позже сегодня.
sourcestringнетНазвание источника привлечения из справочника клуба (без учёта регистра); неизвестное → ошибка со списком допустимых.
branchIdintegerнетID филиала (get_branches). Если у клуба один филиал — подставляется он, если несколько — обязателен.
managerIdintegerнетID ответственного сотрудника (staff_list); не указан — клиент без менеджера (предупреждение в ответе).
notestringнетКомментарий к клиенту (поле «Описание»), до 2000 символов.

Пример ответа

Тестовый вызов (запись затем удалена). Телефон и e-mail в ответ не возвращаются.

{
  "metric": "client_create",
  "filters": { "branchId": 1084, "branchName": "fitness365 Москва", "source": null, "managerId": 124 },
  "warnings": [],
  "client": {
    "clientId": 2493,
    "uid": "6693848a-fa9b-48ae-b98a-925a43248706",
    "name": "Тестовый Клиент Проверкович",
    "branchId": 1084,
    "branch": "fitness365 Москва",
    "availableToAllBranches": true,
    "managerId": 124,
    "manager": "Мобильное Приложение",
    "source": null,
    "createdAt": "2026-10-30T01:04:26.518"
  }
}

Дубликат

Повторный вызов с тем же телефоном (и вызов lead_create с ним) отклоняется: «Клиент не создан: найдены дубликаты по правилу клуба (поля: TelefoneCellForSearch): ID 2493 … (клиент). Используйте существующую запись (client_find) или уточните данные.»

sales_by_payment_type

Способы оплаты проведённых продаж за период (наличные, карта, безнал, депозит, бонусы, кредит, комбинированная): количество, сумма, доля; отдельно — продажи в кредит и их непогашенный остаток.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Как клиенты платят: наличные, карта, онлайн? За последние 30 дней.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "sales_by_payment_type",
    "arguments": {
      "period": "last_n_days",
      "days": 30
    }
  }
}
{
  "metric": "sales_by_payment_type",
  "definition": "Проведённые продажи по основному способу оплаты (Sale.PayType).",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:21:52",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:21." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "totalSales": 8,
  "items": [
    { "payType": "Наличные", "sales": 3, "amount": 11500.0, "share": 37.5 },
    { "payType": "Кредит", "sales": 3, "amount": 6300.0, "share": 37.5 },
    { "payType": "Безнал", "sales": 2, "amount": 3600.0, "share": 25 }
  ],
  "credit": { "sales": 3, "amount": 6300.0, "outstandingRest": 6300.0 }
}

Тренировки и тренеры

trainings_summary

Сводка по тренировкам за период: записи (Reserve) по статусам — ожидают, посетили, пропустили, отменены, лист ожидания; занятия расписания (проведённые/отменённые, персональные/групповые); посещения тренировок; доля неявок. Три метрики (записи, занятия, посещения) не смешиваются. Для «сколько записей было за период», «сколько отменено», «групповых и персональных», «доля неявок». compare=true — сравнение с предыдущим периодом.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
comparebooleanнетtrue — добавить сравнение с предыдущим периодом (разница и процент изменения).

Пример запроса и ответа

«Сколько тренировок было за прошлый месяц и как заполнены места?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "trainings_summary",
    "arguments": {
      "period": "last_month",
      "compare": true
    }
  }
}
{
  "metric": "trainings_summary",
  "definition": "Записи на тренировки по статусам (по дате занятия), занятия расписания и посещения, привязанные к занятиям. Это три разные метрики.",
  "period": {
    "start": "2026-09-01T00:00:00",
    "end": "2026-10-01T00:00:00",
    "interval": "[start, end)",
    "kind": "last_month",
    "label": "Прошлый календарный месяц",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:17",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "noShowPercent = пропустили / (посетили + пропустили) среди записей со статусом «Посетил» или «Пропустил»; ожидающие записи не учитываются."
  ],
  "reserves": { "total": 65, "waiting": 65, "visited": 0, "missed": 0, "cancelled": 0, "waitList": 0, "active": 65 },
  "noShowPercent": null,
  "events": { "scheduled": 87, "cancelled": 0, "held": 87, "individual": 39, "group": 48 },
  "visitsToTrainings": 0,
  "comparison": {
    "previousPeriod": {
      "start": "2026-08-01T00:00:00",
      "end": "2026-09-01T00:00:00",
      "interval": "[start, end)",
      "kind": "last_month",
      "label": "Предыдущий календарный месяц",
      "timezone": "Europe/Moscow"
    },
    "activeReserves": { "current": 65, "previous": 412, "absoluteChange": -347, "percentChange": -84.22, "note": null },
    "cancelledReserves": {
      "current": 0,
      "previous": 0,
      "absoluteChange": 0,
      "percentChange": null,
      "note": "Предыдущее значение равно 0 — процент изменения не определён."
    },
    "visitsToTrainings": { "current": 0, "previous": 21, "absoluteChange": -21, "percentChange": -100, "note": null }
  }
}

trainers_popularity

Рейтинг тренеров по числу записей на их занятия за период (без отменённых и листа ожидания) и числу состоявшихся посещений. Для «к какому тренеру чаще всего записываются». Учитывается основной тренер занятия.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).

Пример запроса и ответа

«Какие тренеры самые востребованные за 30 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "trainers_popularity",
    "arguments": {
      "period": "last_n_days",
      "days": 30,
      "limit": 3
    }
  }
}
{
  "metric": "trainers_popularity",
  "definition": "Тренеры по количеству записей на их занятия (без отменённых и листа ожидания); visited — записи со статусом «Посетил».",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:22",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Учитывается основной тренер занятия (Executor); дополнительные тренеры не учитываются.",
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22."
  ],
  "basis": "Статистика основана на ЗАПИСЯХ на занятия расписания (Reserve), а не на посещениях клуба (Visit). Посещения по тренерам — visits_statistics_by_trainer.",
  "items": [
    { "trainerId": null, "trainer": "Не указан", "reserves": 30, "visited": 0 },
    { "trainerId": 7, "trainer": "Не указан", "reserves": 26, "visited": 0 },
    { "trainerId": 257, "trainer": "Иван С.", "reserves": 2, "visited": 0 }
  ]
}

schedule_load

Загрузка расписания за период: вместимость и занятость мест по занятиям без пометки «Отменено», свободные места, загрузка в % — общая, по дням и по тренерам. Свободные места считаются только для занятий с заданной вместимостью.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).

Пример запроса и ответа

«Насколько загружено расписание за последние 14 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "schedule_load",
    "arguments": {
      "period": "last_n_days",
      "days": 14,
      "limit": 3
    }
  }
}
{
  "metric": "schedule_load",
  "definition": "Загрузка расписания: занятия без пометки «Отменено» с заданной вместимостью; загрузка = записанные места / вместимость.",
  "period": {
    "start": "2026-10-10T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 14 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:11",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Вместимость и занятость берутся из счётчиков занятия (CountOfFeMaleMaxInternal / CountOfFeMaleReservedInternal); занятия без заданной вместимости в загрузку не входят.",
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22."
  ],
  "events": 36,
  "capacity": 720,
  "reservedPlaces": 26,
  "freePlaces": 694,
  "loadPercent": 3.61,
  "byDay": [
    {
      "date": "2026-10-10T00:00:00",
      "weekday": "Суббота",
      "events": 1,
      "capacity": 20,
      "reserved": 1,
      "loadPercent": 5
    },
    {
      "date": "2026-10-11T00:00:00",
      "weekday": "Воскресенье",
      "events": 1,
      "capacity": 20,
      "reserved": 1,
      "loadPercent": 5
    },
    {
      "date": "2026-10-12T00:00:00",
      "weekday": "Понедельник",
      "events": 3,
      "capacity": 60,
      "reserved": 3,
      "loadPercent": 5
    }
  ],
  "byTrainer": [
    {
      "trainerId": null,
      "trainer": "Не указан",
      "events": 18,
      "capacity": 360,
      "reserved": 14,
      "loadPercent": 3.89
    },
    {
      "trainerId": 3,
      "trainer": "Валентин П.",
      "events": 6,
      "capacity": 120,
      "reserved": 0,
      "loadPercent": 0
    },
    {
      "trainerId": 7,
      "trainer": "Не указан",
      "events": 6,
      "capacity": 120,
      "reserved": 12,
      "loadPercent": 10
    }
  ]
}

Для краткости в примере сокращены длинные массивы (byDay): показаны первые 3 элемента.

training_events_list

Расписание тренировок (TrainingEvent) — групповых и индивидуальных, по одной строке на занятие, по дате от ближайших к поздним (по умолчанию сегодня; период не более 3 месяцев). В строке: eventId, название, направление, услуга, тип события (eventType), групповая/индивидуальная, тренер и дополнительные тренеры (additionalTrainers), начало, окончание, длительность, место, филиал, вместимость, записано и свободно мест, отмена, описание, allowOnline. Записи клиентов — reserves_list; участники занятия — training_event_participants.

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo).
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня.
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
trainerIdintegerнетID тренера (основной тренер занятия).
trainerIdsinteger[]нетНесколько тренеров — занятия любого из них; объединяется с trainerId.
typestringнетgroup — групповые, individual — индивидуальные, all — все (по умолчанию).
serviceIdintegerнетID услуги занятия.
serviceNamestringнетЧасть названия услуги (без учёта регистра).
limitintegerнетМаксимум строк в ответе (1..MaxPageSize).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Покажи тренировки за последние 7 дней.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "training_events_list",
    "arguments": {
      "period": "last_n_days",
      "days": 7,
      "limit": 2
    }
  }
}
{
  "metric": "training_events_list",
  "definition": "Занятия расписания (групповые и индивидуальные) за период, от ближайших к поздним. reserved — записано мест (без отменённых), freePlaces — свободно (только при заданной вместимости).",
  "period": {
    "start": "2026-10-17T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 7 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:13",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": { "trainerIds": null, "type": "all", "serviceId": null, "serviceName": null }
  },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22." ],
  "page": { "total": 18, "limit": 2, "offset": 0, "hasMore": true },
  "items": [
    {
      "eventId": 24700,
      "name": "Гимнастика дети",
      "class": null,
      "serviceId": 103,
      "service": "Гимнастика дети",
      "eventTypeId": 1,
      "eventType": "Тренировка",
      "isIndividual": true,
      "type": "Индивидуальная",
      "trainerId": null,
      "trainer": null,
      "additionalTrainers": [],
      "start": "2026-10-17T08:00:00",
      "end": "2026-10-17T08:30:00",
      "durationMinutes": 30,
      "place": "Зал йоги",
      "branchId": 1,
      "branch": "Без филиала",
      "capacity": 20,
      "reserved": 1,
      "freePlaces": 19,
      "allowOnline": false,
      "cancelled": false,
      "description": null
    },
    {
      "eventId": 24701,
      "name": "Гимнастика дети",
      "class": null,
      "serviceId": 103,
      "service": "Гимнастика дети",
      "eventTypeId": 1,
      "eventType": "Тренировка",
      "isIndividual": true,
      "type": "Индивидуальная",
      "trainerId": null,
      "trainer": null,
      "additionalTrainers": [],
      "start": "2026-10-18T08:00:00",
      "end": "2026-10-18T08:30:00",
      "durationMinutes": 30,
      "place": "Зал йоги",
      "branchId": 1,
      "branch": "Без филиала",
      "capacity": 20,
      "reserved": 1,
      "freePlaces": 19,
      "allowOnline": false,
      "cancelled": false,
      "description": null
    }
  ]
}

reserves_list

Реестр записей на тренировки (Reserve) — по одной строке на запись, по дате начала занятия от ранних к поздним. В строке: reserveId, eventId, start/end занятия, статус записи (status: Ожидает, Посетил, Пропустил, Заморожена, Отменена, Лист ожидания), клиент (client — «Фамилия Имя Отчество», ПДн), услуга, название занятия, тип события, групповая/индивидуальная, тренер, филиал, eventCancelled. Любая комбинация фильтров, с пейджингом. Чтобы посмотреть все записи клиента — передавайте clientId; чтобы посмотреть все предстоящие и прошедшие тренировки тренера — trainerId. При clientId/trainerId без периода период не ограничен (исключение, как у sales_list); без них период по умолчанию «сегодня», не более 3 месяцев.

phonestringнетМобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); не менее 7 цифр. Как и clientId, снимает ограничение периода.
ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo).
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня.
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня.
branchIdintegerнетID филиала.
clientIdintegerнетID клиента (client_find) — только его записи.
trainerIdintegerнетID тренера (staff_list) — записи на его занятия (основной тренер).
serviceIdintegerнетID услуги занятия.
serviceNamestringнетЧасть названия услуги (без учёта регистра).
statusstringнетwaiting, visited, missed, freezed, canceled, wait_list (можно несколько через запятую) или all (по умолчанию).
limitintegerнетМаксимум строк в ответе.
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Покажи записи на тренировки за последние 7 дней.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "reserves_list",
    "arguments": {
      "period": "last_n_days",
      "days": 7,
      "limit": 2
    }
  }
}
{
  "metric": "reserves_list",
  "definition": "Построчный реестр записей на тренировки (Reserve) по дате начала занятия (Event.StartOn), от ранних к поздним. status — статус записи; eventCancelled — занятие отменено. Имена клиентов выдаются полностью (Фамилия Имя Отчество) — это персональные данные, не пересылайте их дальше без необходимости.",
  "period": {
    "start": "2026-10-17T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 7 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:06",
  "filters": {
    "branchId": null,
    "branchName": null,
    "extra": {
      "clientId": null,
      "phone": null,
      "trainerId": null,
      "serviceId": null,
      "serviceName": null,
      "status": "all"
    }
  },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22." ],
  "page": { "total": 13, "limit": 2, "offset": 0, "hasMore": true },
  "items": [
    {
      "reserveId": 45061,
      "eventId": 24700,
      "start": "2026-10-17T08:00:00",
      "end": "2026-10-17T08:30:00",
      "statusId": 0,
      "status": "Ожидает",
      "clientId": 738,
      "client": "",
      "serviceId": 103,
      "service": "Гимнастика дети",
      "eventName": "Гимнастика дети",
      "eventTypeId": 1,
      "eventType": "Тренировка",
      "isIndividual": true,
      "trainerId": null,
      "trainer": null,
      "branchId": 1,
      "branch": "Без филиала",
      "eventCancelled": false
    },
    {
      "reserveId": 45062,
      "eventId": 24701,
      "start": "2026-10-18T08:00:00",
      "end": "2026-10-18T08:30:00",
      "statusId": 0,
      "status": "Ожидает",
      "clientId": 738,
      "client": "",
      "serviceId": 103,
      "service": "Гимнастика дети",
      "eventName": "Гимнастика дети",
      "eventTypeId": 1,
      "eventType": "Тренировка",
      "isIndividual": true,
      "trainerId": null,
      "trainer": null,
      "branchId": 1,
      "branch": "Без филиала",
      "eventCancelled": false
    }
  ]
}

training_event_participants

Кто записан на конкретное занятие (eventId из training_events_list): имя и инициал фамилии, статус записи; счётчики по статусам. Для «кто из клиентов записан на тренировку/группу».

ПараметрТипОбяз.Описание
eventIdintegerдаID занятия (eventId).
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Кто записан на тренировку 23672?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "training_event_participants",
    "arguments": {
      "eventId": 23672,
      "limit": 3
    }
  }
}
{
  "metric": "training_event_participants",
  "definition": "Записи на занятие (Reserve) со статусами.",
  "asOf": "2026-10-23T18:22:15",
  "filters": { "eventId": 23672 },
  "warnings": [],
  "event": {
    "eventId": 23672,
    "name": "Гимнастика дети",
    "class": null,
    "start": "2026-08-25T08:00:00",
    "branchId": 1,
    "branch": "Без филиала"
  },
  "countsByStatus": [ { "status": "Ожидает", "count": 1 } ],
  "page": { "total": 1, "limit": 3, "offset": 0, "hasMore": false },
  "items": [ { "reserveId": 43788, "clientId": 738, "name": "Без имени", "status": "Ожидает" } ]
}

Скидки и акции

discounts_overview

Скидки в системе: схемы дисконтирования (название, активна ли) и постраничный список правил скидок — тип (процент/сумма), размер, приоритет, ручная/автоматическая, филиал, даты бонуса. Для «какие есть скидки», «каковы размеры скидок». Действие правила зависит от условий, которые здесь не проверяются (см. warnings).

ПараметрТипОбяз.Описание
branchIdintegerнетФильтр по филиалу: правила этого филиала и правила «для всех филиалов».
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Какие скидки настроены в системе?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "discounts_overview",
    "arguments": {
      "limit": 3
    }
  }
}
{
  "metric": "discounts_overview",
  "definition": "Схемы дисконтирования и правила скидок (DiscountScheme / DiscountRule).",
  "asOf": "2026-10-23T18:22:24",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Связь «правило ↔ схема дисконтирования» (таблица many-to-many XPO) в этом сервере не читается: наличие правила в списке не означает, что оно входит в активную схему. Условия правила (дни недели, группы клиентов, продукты, промокоды и др.) не проверяются — скидка применяется только при выполнении всех условий."
  ],
  "schemes": [ { "schemeId": 1, "name": "Дисконтная схема по умолчанию", "isActive": true } ],
  "value": 24,
  "unit": "discount_rules",
  "page": { "total": 24, "limit": 3, "offset": 0, "hasMore": true },
  "items": [
    {
      "ruleId": 62,
      "name": "Сто проц 111",
      "type": "Процент",
      "size": 90.0,
      "priority": -1,
      "isManual": false,
      "isPricing": false,
      "notForSubscriptions": true,
      "branchId": null,
      "branch": "Все филиалы",
      "bonusFrom": null,
      "bonusTo": null
    },
    {
      "ruleId": 61,
      "name": "10% на бонусный счёт",
      "type": "Тип 6",
      "size": 10.0,
      "priority": 0,
      "isManual": false,
      "isPricing": false,
      "notForSubscriptions": true,
      "branchId": null,
      "branch": "Все филиалы",
      "bonusFrom": null,
      "bonusTo": null
    },
    {
      "ruleId": 36,
      "name": "Silver статус скидка 10%",
      "type": "Сумма",
      "size": 10.0,
      "priority": 0,
      "isManual": false,
      "isPricing": true,
      "notForSubscriptions": true,
      "branchId": null,
      "branch": "Все филиалы",
      "bonusFrom": null,
      "bonusTo": null
    }
  ]
}

discounts_date_conditions

Условия скидок «интервал дат», которые заканчиваются или начинаются в ближайшие N дней (по умолчанию 14): название условия, даты, сколько дней осталось/до начала. Для «какие скидки скоро закончатся или начнутся».

ПараметрТипОбяз.Описание
daysintegerнетГоризонт в днях от сегодня (по умолчанию 14, максимум ≈ 92).

Пример запроса и ответа

«Какие скидки с датами действия сейчас активны или скоро закончатся?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "discounts_date_conditions",
    "arguments": {
      "days": 30
    }
  }
}
{
  "metric": "discounts_date_conditions",
  "definition": "Условия «интервал дат» скидок, заканчивающиеся или начинающиеся с 2026-10-23 по 2026-11-22.",
  "asOf": "2026-10-23T18:22:29",
  "filters": { "days": 30 },
  "warnings": [
    "Условия показаны сами по себе, без привязки к правилам скидок (связь many-to-many не читается). Инвертированные условия («кроме периода») пропущены.",
    "Выводится не более MaxPageSize условий каждого вида."
  ],
  "ending": [],
  "starting": []
}

discounts_given

Сколько скидок предоставлено за период: общая сумма скидок (SaleItem.DiscountSumm) по позициям проведённых продаж, доля от суммы до скидок и топ применённых правил скидок. Для «какая сумма скидок была предоставлена за период».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).

Пример запроса и ответа

«Какие скидки чаще всего давали за 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "discounts_given",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "limit": 3
    }
  }
}
{
  "metric": "discounts_given",
  "definition": "Предоставленные скидки по позициям проведённых продаж (без возвратов): сумма SaleItem.DiscountSumm.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:27",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22." ],
  "currency": "валюта учёта клуба (валюта в БД не хранится)",
  "totalDiscount": 5280.0,
  "amountBeforeDiscount": 538100.0,
  "discountSharePercent": 0.98,
  "itemsWithDiscount": 6,
  "byRule": [
    { "ruleId": 56, "rule": "Продление карт на год", "items": 4, "discount": 3600.0 },
    { "ruleId": 57, "rule": "Скидка 50% на Безлимит 1 мес", "items": 1, "discount": 1500.0 },
    { "ruleId": 53, "rule": "скидка 15%", "items": 1, "discount": 180.0 }
  ]
}

Удержание и отток

churn_nonrenewal

ОТТОК КАК НЕПРОДЛЕНИЕ: абонементы/клубные карты, закончившиеся в периоде и не продлённые (у клиента нет абонемента с более поздней датой окончания); доля непродления, по филиалам, сравнение (compare=true). Для «какой отток за 3 месяца среди тех, кто не купил новый абонемент» (period=last_n_days, days=90 либо custom до 3 месяцев).

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
comparebooleanнетtrue — добавить сравнение с предыдущим периодом (разница и процент изменения).

Пример запроса и ответа

«Сколько клиентов не продлили абонемент за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "churn_nonrenewal",
    "arguments": {
      "period": "last_n_days",
      "days": 90,
      "compare": true
    }
  }
}
{
  "metric": "churn_nonrenewal",
  "definition": "Отток как непродление: абонементы и клубные карты, закончившиеся в периоде, и их продление. Доля непродления = не продлённые / закончившиеся.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:34",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22.",
    "Считаются абонементы, а не клиенты: клиент с несколькими закончившимися абонементами учитывается несколько раз. Абонемент считается продлённым, если у клиента есть другой абонемент с более поздней датой окончания.",
    "Текущий период не завершён: предыдущий взят за такое же прошедшее время (2026-04-27 00:00 — 2026-07-25 18:22), чтобы сравнение было корректным."
  ],
  "value": 8,
  "unit": "abonements",
  "ended": 11,
  "renewed": 3,
  "notRenewed": 8,
  "renewalRatePercent": 27.27,
  "nonRenewalRatePercent": 72.73,
  "byBranch": [
    {
      "branchId": 1084,
      "branch": "fitness365 Москва",
      "ended": 6,
      "notRenewed": 4,
      "nonRenewalRatePercent": 66.67
    },
    { "branchId": null, "branch": null, "ended": 3, "notRenewed": 2, "nonRenewalRatePercent": 66.67 },
    { "branchId": 1, "branch": "Без филиала", "ended": 2, "notRenewed": 2, "nonRenewalRatePercent": 100 }
  ],
  "comparison": {
    "previousPeriod": {
      "start": "2026-04-27T00:00:00",
      "end": "2026-07-25T18:22:34.3153088",
      "interval": "[start, end)",
      "kind": "last_n_days",
      "label": "Предыдущий период такой же длины (за такое же прошедшее время)",
      "timezone": "Europe/Moscow"
    },
    "ended": { "current": 11, "previous": 18, "absoluteChange": -7, "percentChange": -38.89, "note": null },
    "notRenewed": { "current": 8, "previous": 9, "absoluteChange": -1, "percentChange": -11.11, "note": null },
    "nonRenewalRatePercent": { "current": 72.73, "previous": 50, "absoluteChange": 22.73, "percentChange": 45.46, "note": null }
  }
}

churn_inactivity

ОТТОК КАК ОТСУТСТВИЕ ПОСЕЩЕНИЙ: сколько клиентов с действующим абонементом не были в клубе дольше N дней (или не были вовсе) и какая это доля от всех клиентов с действующим абонементом — риск ухода. Список таких клиентов — clients_inactive.

ПараметрТипОбяз.Описание
inactiveDaysintegerнетПорог бездействия в днях (по умолчанию 30, максимум ≈ 92).
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Сколько клиентов не приходило 60 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "churn_inactivity",
    "arguments": {
      "inactiveDays": 60
    }
  }
}
{
  "metric": "churn_inactivity",
  "definition": "Отток как отсутствие посещений: клиенты с действующим абонементом без посещений более 60 дн. (последнее посещение раньше 2026-08-24 или посещений нет) / все клиенты с действующим абонементом.",
  "asOf": "2026-10-23T18:22:32",
  "filters": { "branchId": null, "branchName": null, "extra": { "inactiveDays": 60 } },
  "warnings": [ "Дата последнего посещения берётся из карточки клиента (MyPerson.LastVisitDateTime), которую ведёт CRM." ],
  "activeBase": 14,
  "value": 10,
  "unit": "clients",
  "ratePercent": 71.43,
  "byBranch": [
    { "branchId": 1084, "branch": "fitness365 Москва", "clients": 7 },
    { "branchId": 1, "branch": "Без филиала", "clients": 3 }
  ]
}

clients_inactive

Клиенты, которые не посещали клуб дольше N дней (риск ухода): по умолчанию только с действующим абонементом; постранично, самые «давние» первыми. Имя — инициал фамилии. Для «какие клиенты не посещают клуб уже N дней».

ПараметрТипОбяз.Описание
inactiveDaysintegerнетПорог бездействия в днях (по умолчанию 14, максимум ≈ 92).
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
onlyWithActiveAbonementbooleanнетtrue (по умолчанию) — только клиенты с действующим абонементом; false — все клиенты.
limitintegerнетМаксимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов).
offsetintegerнетСмещение для постраничного вывода (по умолчанию 0).

Пример запроса и ответа

«Кто из клиентов не приходил 30 дней, но имеет действующий абонемент?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "clients_inactive",
    "arguments": {
      "inactiveDays": 30,
      "onlyWithActiveAbonement": true,
      "limit": 3
    }
  }
}
{
  "metric": "clients_inactive",
  "definition": "Клиенты с действующим абонементом, у которых последнее посещение раньше 2026-09-23 или посещений не было.",
  "asOf": "2026-10-23T18:21:16",
  "filters": { "branchId": null, "branchName": null, "extra": { "inactiveDays": 30, "onlyWithActiveAbonement": true } },
  "warnings": [ "Дата последнего посещения берётся из карточки клиента (MyPerson.LastVisitDateTime)." ],
  "value": 13,
  "unit": "clients",
  "page": { "total": 13, "limit": 3, "offset": 0, "hasMore": true },
  "items": [
    {
      "clientId": 1306,
      "name": "Марина У.",
      "lastVisit": null,
      "daysSinceVisit": null,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    },
    {
      "clientId": 1484,
      "name": "Первый П.",
      "lastVisit": null,
      "daysSinceVisit": null,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    },
    {
      "clientId": 1298,
      "name": "Роман С.",
      "lastVisit": "2025-10-23T14:15:00",
      "daysSinceVisit": 365,
      "branchId": 1084,
      "branch": "fitness365 Москва"
    }
  ]
}

churn_active_base_change

ОТТОК КАК ИЗМЕНЕНИЕ АКТИВНОЙ БАЗЫ: сколько клиентов имели действующий абонемент на начало и на конец периода, разница и процент. Для «как изменилось число активных клиентов за период».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.

Пример запроса и ответа

«Как изменилась активная база за последние 90 дней?»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "churn_active_base_change",
    "arguments": {
      "period": "last_n_days",
      "days": 90
    }
  }
}
{
  "metric": "churn_active_base_change",
  "definition": "Клиенты с абонементом, действующим на начало и на конец периода.",
  "period": {
    "start": "2026-07-26T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 90 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:37",
  "filters": { "branchId": null, "branchName": null },
  "warnings": [
    "Активная база на дату определяется по датам начала и окончания абонементов; заморозки, возвраты и досрочные закрытия не учитываются — истории статусов абонементов в БД нет.",
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22."
  ],
  "activeAtStart": { "at": "2026-07-26T00:00:00", "clients": 11 },
  "activeAtEnd": { "at": "2026-10-23T18:22:36.6036045", "clients": 14 },
  "change": { "current": 14, "previous": 11, "absoluteChange": 3, "percentChange": 27.27, "note": null }
}

active_base_dynamics

Динамика активной базы клиентов по неделям или месяцам внутри периода (до 3 месяцев), в разрезе филиалов: число клиентов с действующим абонементом на начало каждого интервала. Для «какова динамика активной базы по филиалам».

ПараметрТипОбяз.Описание
periodstringнетПериод: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев.
daysintegerнетТолько для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев).
dateFromstringнетНачало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom).
dateTostringнетКонец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев.
branchIdintegerнетID филиала (список — инструмент get_branches). Без параметра — весь клуб.
granularitystringнетШаг: week (по умолчанию) или month.

Пример запроса и ответа

«Покажи динамику активной базы по неделям за 30 дней.»

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "active_base_dynamics",
    "arguments": {
      "period": "last_n_days",
      "days": 30,
      "granularity": "week"
    }
  }
}
{
  "metric": "active_base_dynamics",
  "definition": "Клиенты с действующим абонементом на начало каждого интервала периода (и на конец периода) по филиалам.",
  "period": {
    "start": "2026-09-24T00:00:00",
    "end": "2026-10-24T00:00:00",
    "interval": "[start, end)",
    "kind": "last_n_days",
    "label": "Последние 30 дн. (включая сегодня)",
    "timezone": "Europe/Moscow"
  },
  "asOf": "2026-10-23T18:22:40",
  "filters": { "branchId": null, "branchName": null, "extra": { "granularity": "week" } },
  "warnings": [
    "Активная база на дату определяется по датам начала и окончания абонементов (без учёта заморозок и досрочных закрытий). Филиал — филиал продажи абонемента.",
    "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22."
  ],
  "items": [
    {
      "at": "2026-09-24T00:00:00",
      "activeClients": 15,
      "byBranch": [
        { "branchId": 1084, "branch": "fitness365 Москва", "clients": 10 },
        { "branchId": 1, "branch": "Без филиала", "clients": 5 }
      ]
    },
    {
      "at": "2026-09-28T00:00:00",
      "activeClients": 15,
      "byBranch": [
        { "branchId": 1084, "branch": "fitness365 Москва", "clients": 10 },
        { "branchId": 1, "branch": "Без филиала", "clients": 5 }
      ]
    },
    {
      "at": "2026-10-05T00:00:00",
      "activeClients": 14,
      "byBranch": [
        { "branchId": 1084, "branch": "fitness365 Москва", "clients": 10 },
        { "branchId": 1, "branch": "Без филиала", "clients": 4 }
      ]
    }
  ]
}

Для краткости в примере сокращены длинные массивы (items): показаны первые 3 элемента.