Сервер аналитики фитнес-клуба по протоколу Model Context Protocol. 86 инструментов по посещениям, клиентам, абонементам, продажам, тренировкам, скидкам и оттоку: 82 — только чтение, и три пишущих (crm_task_create, lead_create, client_create), включаемых опцией Mcp:EnableWrites.
Сервер публикует аналитику клуба как набор MCP-инструментов. Подключить его можно из любого MCP-клиента (Claude, MCP Inspector, собственное приложение на SDK) либо вызывать напрямую по JSON-RPC поверх HTTP. Каждый инструмент выполняет фиксированный запрос с типизированными параметрами: произвольного SQL нет, данные изменить нельзя.
Если указаны оба, заголовок приоритетнее. Пустой, неверный или отсутствующий токен даёт 401.
Примеры вызова и ответа для конкретных инструментов приведены в справочнике ниже, сразу после описания инструмента (данные демонстрационные, длинные списки сокращены). Здесь показано то, что одинаково для всех инструментов.
Так выглядит конверт, в который сервер упаковывает любой из ответов (тело метрики — строка в text):
Ошибка параметров (например, период длиннее 3 месяцев) приходит как обычный результат с isError: true. Текст сообщения на русском; он зависит от инструмента, ниже иллюстрация формата:
Агрегатные инструменты персональных данных не содержат, имена в них выводятся как «Имя Ф.» (имя и первая буква фамилии). Следующие инструменты возвращают ПДн, считайте их ответы персональными данными:
Не пересылайте такие ответы дальше без необходимости. Если вы подключаете сервер к внешней LLM, решение о передаче данных клуба этому провайдеру принимает владелец клуба.
Ниже все инструменты по группам. Параметры периода (period, days, dateFrom, dateTo) везде одинаковые, см. раздел «Периоды». Поиск в левой панели фильтрует список по названию.
Посещения
visits_summary
Посещаемость клуба за период: число посещений (проходов) и число УНИКАЛЬНЫХ посетителей. Отвечает на «сколько посетителей было сегодня/вчера/на неделе/в месяце», «сколько уникальных посетителей», «как изменилась посещаемость к прошлой неделе/месяцу» (compare=true). Посещения сотрудников не считаются.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
compare | boolean | нет | 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 часов назад, по филиалам. Более старые открытые визиты (не закрыты при выходе) выводятся отдельно.
| Параметр | Тип | Обяз. | Описание |
branchId | integer | нет | 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
Посещаемость по каждому филиалу за период: посещения и уникальные посетители. Для вопросов «какая посещаемость по филиалам», «сравни филиалы».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат 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
Распределение посещений по дням недели и по часам начала посещения; пиковый день и час пик. Для вопросов «какая посещаемость по дням недели», «в какие часы наибольшая загрузка».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | 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
Динамика посещений по дням, неделям или месяцам за период (ряд для графика/сравнения).
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
granularity | string | нет | Шаг ряда: 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 ч); при необходимости — по филиалам.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | 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; имя — только инициалы.
| Параметр | Тип | Обяз. | Описание |
clientId | integer | да | ID клиента (clientId из других инструментов). |
days | integer | нет | Окно в днях, включая сегодня (по умолчанию 30, максимум ≈ 92). |
limit | integer | нет | Сколько последних посещений вернуть (по умолчанию 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.
phone | string | нет | Мобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); не менее 7 цифр. Альтернатива clientId. |
| Параметр | Тип | Обяз. | Описание |
period/days/dateFrom/dateTo | | нет | Период; по умолчанию последние 30 дней, максимум 3 месяца. |
branchId | integer | нет | Филиал. |
clientId | integer | нет | Только посещения этого клиента. |
lastName + firstName | string | нет | Клиент по фамилии и имени (начало, именительный падеж). Обе части обязательны (одна → ошибка); игнорируются, если указан clientId. ID можно получить через client_find. |
serviceId | integer | нет | ID услуги (Visit.Service). |
serviceName | string | нет | Часть названия услуги (без учёта регистра) — если ID услуги неизвестен. |
trainerId | integer | нет | ID тренера (Visit.Executor, ID сотрудника из staff_list). В строках ответа есть trainerId/trainer. |
serviceKind | string | нет | Вид услуги: trial — пробные (услуга с признаком «Пробная»), guest — гостевые (гостевая услуга или посещение по приглашению клиента; в строках есть invitedById/invitedBy). Иное значение → ошибка. |
basis | string | нет | Основание посещения: abonement — абонемент, club_card — клубная карта, one_time — разовая услуга, training — занятие по расписанию (без купленной позиции), none — без основания. Иное значение → ошибка. Сравнение числом — visits_statistics_by_basis. |
limit / offset | integer | нет | Постраничный вывод. |
Фильтры комбинируются по «И». Период ограничен 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 месяца). |
branchId | integer | нет | Филиал; не указан — все филиалы. |
trainerIds | integer[] | нет | ID тренеров (staff_list); пусто — все тренеры. |
limit | integer | нет | Размер рейтинга (по умолчанию 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 месяца). |
branchId | integer | нет | Филиал; не указан — все филиалы. |
serviceKind | string | нет | 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 месяца). |
branchId | integer | нет | Филиал; не указан — все филиалы. |
serviceId | integer | нет | ID пробной услуги — только она. |
convertedWithinDays | integer | нет | Окно конверсии, дней (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 месяца). |
branchId | integer | нет | Филиал. |
serviceId | integer | нет | ID пробной услуги. |
converted | boolean | нет | false — был на пробной, но не купил (для обзвона); true — купил; не указан — все. |
convertedWithinDays | integer | нет | Окно конверсии, дней (1..365): «купил» только если абонемент/клубная карта куплены не позже чем через N дней после первого пробного посещения. Не указано — без ограничения по сроку. |
limit / offset | integer | нет | Постраничный вывод. |
Пример запроса и ответа
«Кто был на пробной в 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 месяца). |
branchId | integer | нет | Филиал; не указан — все филиалы. |
limit | integer | нет | Размер рейтингов 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 (коллекция карт не просматривается).
| Параметр | Тип | Обяз. | Описание |
clientId | integer | да | 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.
| Параметр | Тип | Обяз. | Описание |
clientId | integer | да | ID клиента (client_find). |
onlyCurrent | boolean | нет | true — только действующие: все, кроме закончившихся (статус «Закончена»); не активированные, активные, замороженные и приостановленные остаются. По умолчанию false — вся история. |
limit / offset | integer | нет | Постраничный вывод. |
Пример запроса и ответа
«Какие услуги и абонементы сейчас есть у клиента 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.
| Параметр | Тип | Обяз. | Описание |
clientId | integer | да | ID клиента (client_find). |
years | integer | нет | Окно назад от сегодня: за год — years=1, за два года — years=2. |
months | integer | нет | Окно назад от сегодня: за месяц — months=1, полгода — months=6; можно вместе с years. |
dateFrom / dateTo | string | нет | Любой период yyyy-MM-dd (включительно). Нельзя вместе с years/months. |
branchId | integer | нет | Филиал. |
Без параметров периода — за всё время.
Пример запроса и ответа
«На какую сумму клиент 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) совпадений с пагинацией (однофамильцы, общий номер семьи — показывайте список и уточняйте).
| Параметр | Тип | Обяз. | Описание |
lastName | string | нет | Начало фамилии (именительный падеж). Только вместе с firstName. |
firstName | string | нет | Начало имени (именительный падеж). Только вместе с lastName. Одна из частей без другой → ошибка. |
phone | string | нет | Мобильный телефон в любом формате, не менее 7 цифр; точное совпадение по TelefoneCellForSearch (индекс). |
email | string | нет | Адрес целиком, точное совпадение без учёта регистра (индекса на Contragent.Email нет — поиск полным просмотром таблицы). |
clientId | integer | нет | Карточка по известному ID. |
limit / offset | integer | нет | Постраничный вывод. |
Нужно указать хотя бы одно из: пара 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, список (имя и инициал фамилии, дата регистрации, филиал). Для «сколько новых клиентов за неделю/месяц», «кто зарегистрировался сегодня/вчера».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
compare | boolean | нет | true — добавить сравнение с предыдущим периодом (разница и процент изменения). |
includeList | boolean | нет | true — вернуть постраничный список новых клиентов. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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 | | нет | Период по дате создания карточки; без них — все удалённые. |
branchId | integer | нет | ID филиала. Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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).
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
granularity | string | нет | Шаг ряда: 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
Состояние клиентской базы на сейчас: всего клиентов, активных (с действующим абонементом/клубной картой), с замороженным абонементом, заблокированных, клиентов с задолженностью и её сумма, активные по филиалам. Для «сколько активных клиентов», «сколько заблокировано», «сколько клиентов с задолженностью».
| Параметр | Тип | Обяз. | Описание |
branchId | integer | нет | 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
Распределение клиентов по полу в целом и по филиалам; кого больше — мужчин или женщин (в том числе в конкретном филиале). По умолчанию — только клиенты с действующим абонементом.
| Параметр | Тип | Обяз. | Описание |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
onlyActive | boolean | нет | 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+, не указан). По умолчанию — только клиенты с действующим абонементом.
| Параметр | Тип | Обяз. | Описание |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
onlyActive | boolean | нет | 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 дня. Только имя и инициал фамилии.
| Параметр | Тип | Обяз. | Описание |
dateFrom | string | нет | Первая дата, yyyy-MM-dd; по умолчанию сегодня. |
dateTo | string | нет | Последняя дата включительно, yyyy-MM-dd; по умолчанию = dateFrom. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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): сколько клиентов пришло из каждого источника.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | 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
Лиды (потенциальные клиенты), созданные за период, и конверсия в клиентов (у лида заполнен созданный клиент). Для «сколько лидов и какова конверсия».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | 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
Клиенты, у которых когда-либо был абонемент/клубная карта, но сейчас нет действующего, замороженного или ещё не активированного (кандидаты на возврат). Количество и постраничный список.
| Параметр | Тип | Обяз. | Описание |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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.
| Параметр | Тип | Обяз. | Описание |
debtType | string | нет | credit — только долг по кредиту; installment — только просрочка по рассрочке; any или не указан — оба вида. Иное значение → ошибка. |
branchId | integer | нет | Филиал, где оформлена продажа в кредит / платёж по графику. Без параметра — весь клуб. |
minAmount | number | нет | Минимальная общая сумма долга (кредит + просрочка рассрочки). |
dateFrom / dateTo | string | нет | Необязательный диапазон даты возникновения долга (дата продажи в кредит / дата платежа по графику), yyyy-MM-dd, включительно. Без ограничения по умолчанию: инструмент показывает долг на сейчас. |
limit / offset | integer | нет | Постраничный вывод. |
В ответе 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
Топ клиентов по сумме проведённых покупок за период (сумма продаж после скидок, количество покупок). Имя — только инициал фамилии.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (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 дней», «какие истекают на этой неделе по филиалам».
| Параметр | Тип | Обяз. | Описание |
days | integer | нет | Горизонт в днях от сегодня включительно (по умолчанию 7, максимум ≈ 92). |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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) и срок ещё не истёк. Для «сколько абонементов скоро закончится по количеству посещений».
| Параметр | Тип | Обяз. | Описание |
threshold | integer | нет | Порог остатка посещений включительно (по умолчанию 3). |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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
Сколько абонементов/клубных карт истекло (срок окончания уже наступил) за период, всего и по филиалам. Для «сколько абонементов истекло за последний месяц».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | 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). Для «какова доля продлений», «сколько клиентов не продлило абонемент».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
compare | boolean | нет | 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 месяцев): по каждому месяцу — сколько абонементов закончилось, продлено и не продлено. Для «какова динамика продлений по месяцам».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | 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 — в разрезе филиалов (для «сравни популярность абонементов по филиалам»).
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
byBranch | boolean | нет | true — вывести рейтинг отдельно по каждому филиалу. |
limit | integer | нет | Максимум строк в ответе (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
Средняя длительность (в днях между датой начала и окончания) абонементов и клубных карт, проданных за период; общая и по типам абонементов.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (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
Сколько абонементов/клубных карт сейчас заморожено (статус «Заморожен»), всего и по филиалам, число уникальных клиентов.
| Параметр | Тип | Обяз. | Описание |
branchId | integer | нет | 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 (сколько абонементов доступно по подписке). Это текущее состояние: даты смены статуса в БД не хранятся, поэтому «сколько отменили за месяц» посчитать нельзя.
| Параметр | Тип | Обяз. | Описание |
branchId | integer | нет | Филиал; не указан — все филиалы. |
limit | integer | нет | Размер рейтинга по абонементам (по умолчанию 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. Данные платёжной карты клиента не выдаются.
| Параметр | Тип | Обяз. | Описание |
status | string | нет | current (по умолчанию: активные, в процессе оплаты и с ошибкой оплаты), active, payment_error, in_payment, canceled (отменил клиент), aborted (аннулирована за неоплату), extended, all. |
endsInDays | integer | нет | Только подписки, у которых оплаченный период заканчивается в ближайшие N дней (1..92); просроченные тоже входят. |
branchId | integer | нет | Филиал. |
clientId | integer | нет | ID клиента. |
phone | string | нет | Мобильный телефон клиента в любом формате; не менее 7 цифр. |
limit / offset | integer | нет | Постраничный вывод. |
Пример запроса и ответа
«Покажи все подписки.»
{
"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. Фоновая задача создаёт продление за несколько дней до окончания периода (настройка задачи «Обработка подписок»), поэтому реальное списание происходит чуть раньше указанной даты.
| Параметр | Тип | Обяз. | Описание |
days | integer | нет | Горизонт в днях от сегодня включительно (по умолчанию 7, максимум ≈ 92). |
branchId | integer | нет | Филиал. |
Пример запроса и ответа
«Сколько денег придёт по подпискам за ближайшие 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 месяца). |
branchId | integer | нет | Филиал; не указан — все филиалы. |
limit | integer | нет | Размер рейтинга по абонементам (по умолчанию 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 месяца). |
branchId | integer | нет | Филиал; не указан — все филиалы. |
Пример запроса и ответа
«Насколько подписка дешевле обычной цены?»
{
"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 — итоги по всем найденным листам.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week, last_week, this_month, last_month (по умолчанию), last_n_days или custom. Не длиннее 3 календарных месяцев. |
days | integer | нет | Для period=last_n_days: число последних дней. |
dateFrom | string | нет | Начало произвольного периода, yyyy-MM-dd (period=custom). |
dateTo | string | нет | Конец произвольного периода, yyyy-MM-dd включительно. |
personalId | integer | нет | ID сотрудника (staffId из staff_list). |
branchId | integer | нет | Филиал. |
limit / offset | integer | нет | Постраничный вывод. |
Пример запроса и ответа
«Покажи расчётные листы за последние три месяца»
{
"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 начисления при этом остаётся за весь лист.
| Параметр | Тип | Обяз. | Описание |
sheetId | integer | да | ID расчётного листа (sheetId из payroll_sheets_list). |
dateFrom | string | нет | Только позиции начиная с этой даты, yyyy-MM-dd, включительно. |
dateTo | string | нет | Только позиции до этой даты, yyyy-MM-dd, включительно. |
limit / offset | integer | нет | Постраничный вывод позиций (от ранних к поздним). |
Пример запроса и ответа
«Из чего состоит зарплата сотрудника за июнь?» (лист охватывает июнь–август, берём июнь; ФИО сотрудника и клиентов в примере условные.)
{
"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). Виды условий: интервал базы, свободные фильтры (критерий выводится как есть), время, дни недели, категория, класс тренировки, число клиентов, основание посещения, услуги и продукты; инвертированные начинаются с «кроме:». Схемы общие для клуба: фильтров по филиалу и периоду нет.
| Параметр | Тип | Обяз. | Описание |
schemeId | integer | нет | Одна схема; тогда в assignedTo.staff ещё и список назначенных работающих сотрудников. Не указан — все схемы. Не сочетается со staffId. |
staffId | integer | нет | Схема конкретного сотрудника (staffId из staff_list): в staff — личная схема, схема должности, действующая схема (effectiveSchemeId, source: personal / position / none), в schemes — она же с начислениями и условиями. Личная схема приоритетнее схемы должности; удалённая схема не применяется. Личная схема может быть записана автоматически при сохранении карточки сотрудника (карточка показывает в поле «Схема расчета» схему должности), поэтому source: personal не всегда означает ручной выбор. Не сочетается со schemeId. |
limit | integer | нет | Сколько схем вернуть (по умолчанию 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.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week, last_week, this_month, last_month (по умолчанию), last_n_days или custom. Не длиннее 3 календарных месяцев. |
days | integer | нет | Для period=last_n_days: число последних дней. |
dateFrom | string | нет | Начало произвольного периода, yyyy-MM-dd (period=custom). |
dateTo | string | нет | Конец произвольного периода, yyyy-MM-dd включительно. |
branchId | integer | нет | Филиал. |
limit | integer | нет | Размер рейтингов по должностям и сотрудникам (по умолчанию 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 — количество и сумма премий и штрафов и разница. Эти суммы входят в расчётный лист того периода, куда попадает дата.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week, last_week, this_month, last_month (по умолчанию), last_n_days или custom. Не длиннее 3 календарных месяцев. |
days | integer | нет | Для period=last_n_days: число последних дней. |
dateFrom | string | нет | Начало произвольного периода, yyyy-MM-dd (period=custom). |
dateTo | string | нет | Конец произвольного периода, yyyy-MM-dd включительно. |
kind | string | нет | award (премии) или penalty (штрафы); не указан — все. |
personalId | integer | нет | ID сотрудника. |
branchId | integer | нет | Филиал (по организации сотрудника). |
limit / offset | integer | нет | Постраничный вывод. |
Пример запроса и ответа
«Кого оштрафовали или премировали за последние три месяца?»
{
"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) — листы системы за период.
| Параметр | Тип | Обяз. | Описание |
staffId | integer | нет | ID сотрудника (staffId из staff_list). Не указан — все сотрудники. |
period / days / dateFrom / dateTo | string / integer | нет | Период (по умолчанию last_month, максимум 3 месяца). |
branchId | integer | нет | Филиал. |
limit / offset | integer | нет | Страница до 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 (занятия без посещений — система их тоже считает), посещения, цены, разрез по услугам.
| Параметр | Тип | Обяз. | Описание |
staffId | integer | нет | ID сотрудника (staffId из staff_list). Не указан — все сотрудники. |
period / days / dateFrom / dateTo | string / integer | нет | Период (по умолчанию last_month, максимум 3 месяца). |
branchId | integer | нет | Филиал. |
limit / offset | integer | нет | Страница до 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) помечаются, не скрываются. Итоги по ролям не складываются: одна позиция может быть сразу в нескольких.
| Параметр | Тип | Обяз. | Описание |
staffId | integer | нет | ID сотрудника (staffId из staff_list). Не указан — все сотрудники с заполненной выбранной ролью. |
role | string | нет | seller (продавец), executor (исполнитель позиции), recommender (рекомендатель) или any (по умолчанию). |
period / days / dateFrom / dateTo | string / integer | нет | Период (по умолчанию last_month, максимум 3 месяца). |
branchId | integer | нет | Филиал. |
limit / offset | integer | нет | Страница до 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). Для «сколько покупок в этом месяце», «какая выручка», «рост продаж к прошлому месяцу», «средний чек».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
compare | boolean | нет | 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
Динамика продаж (количество и сумма проведённых продаж) по дням, неделям или месяцам за период. Для «какова выручка по дням за последний месяц».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
granularity | string | нет | Шаг ряда: 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
Продажи по каждому филиалу за период: количество, сумма, фактическая оплата, средний чек. Для «какая выручка по каждому филиалу», «сравни выручку двух филиалов».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат 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
Рейтинг сотрудников-продавцов по сумме проведённых продаж за период (количество, сумма, средний чек). Имена — только инициал фамилии.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (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.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
kind | string | нет | Тип позиций: all (по умолчанию), abonement (абонементы и клубные карты), service (разовые услуги), goods (товары). |
limit | integer | нет | Максимум строк в ответе (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
Структура продаж по категориям продуктов за период: сумма позиций после скидок и доля от общей суммы.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (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
Проданные позиции по типу продажи (первичная, продление, пробная, услуга, товар, депозит и т.д.): число позиций и сумма после скидок.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
subscription | string | нет | Продажи по подписке: 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). Для «сколько было возвратов и на какую сумму».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
compare | boolean | нет | 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.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
status | string | нет | completed — проведена (по умолчанию); saved — сохранена (не проведена); waiting_payment — ожидает оплаты; cancelled — отменена (статус «Возврат» или есть запись об отмене); all — все независимо от статуса. |
clientId | integer | нет | ID клиента — только его продажи. |
phone | string | нет | Мобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); точное совпадение по TelefoneCellForSearch (индекс), не менее 7 цифр. Телефон в ответ не выводится. |
lastName | string | нет | Начало фамилии клиента (именительный падеж). Учитывается, только если clientId не указан (иначе предупреждение). Поиск по имени требует обе части — lastName и firstName; одна из них без clientId/phone → ошибка. |
firstName | string | нет | Начало имени клиента (именительный падеж), можно вместе с lastName («Иванова Сергея» → lastName=Иванов, firstName=Сергей). Учитывается, только если clientId не указан. Требуется вместе с lastName (см. выше). |
employeeId | integer | нет | ID сотрудника, оформившего продажу (см. sales_by_employee). |
subscription | string | нет | Продажи по подписке: with_subscription — первая покупка абонемента с подпиской; renewal — оплата очередного периода подписки (автопродление или ручная оплата); any — любая подписочная; none — без подписки. Не указано — все продажи. В строках есть поле subscription. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
clientId | integer | нет | ID клиента — только его возвраты. |
phone | string | нет | Мобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); не менее 7 цифр. Только возвраты этого клиента. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
status | string | нет | all (по умолчанию), open (открыта), in_progress (в процессе), done (выполнена), deferred (отложена). |
managerId | integer | нет | ID ответственного сотрудника (менеджера) задачи. |
clientId | integer | нет | ID клиента или потенциального клиента (лида), к которому относится задача. |
phone | string | нет | Мобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); не менее 7 цифр. Задачи клиента или лида с этим телефоном. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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.
| Параметр | Тип | Обяз. | Описание |
clientId | integer | да | ID клиента или потенциального клиента (лида). Тип цели («Клиент»/«Потенциальный клиент») определяется автоматически. |
title | string | да | Суть (название) задачи, до 500 символов (при превышении обрезается с предупреждением). |
taskType | string | нет | Тип — название справочника CRMTaskType: Задача (по умолчанию), Исходящий звонок, Входящий звонок, SMS, Продление, Напоминание. Незнакомое название → ошибка с перечнем допустимых типов. |
startDate | string | нет | Дата начала YYYY-MM-DD; по умолчанию — сегодня (дата клуба). В БД хранится с временем 00:00:00. |
endDate | string | нет | Дата окончания (срок) YYYY-MM-DD; по умолчанию равна startDate, хранится 23:59:59. Дата раньше startDate → ошибка. |
description | string | нет | Комментарий (поле «Описание» в CRM), до 2000 символов (при превышении обрезается с предупреждением). |
managerId | integer | нет | 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 / firstName | string | одно из двух | Фамилия, имя (до 100 символов; ФИО целиком — до 100). Нужна хотя бы фамилия или имя. |
middleName | string | нет | Отчество, до 100 символов. |
phone | string | нет | Мобильный телефон в любом формате, 7–25 цифр. Участвует в проверке дубликатов (нормализация как в ядре: 8… → 7…, скобки, «+», «-» убираются). |
email | string | нет | E-mail, до 50 символов. |
sex | string | нет | male или female; не указан — не определён. |
dateOfBirth | string | нет | YYYY-MM-DD, не позже сегодня. |
source | string | нет | Название источника привлечения из справочника клуба (без учёта регистра); неизвестное → ошибка со списком допустимых. |
branchId | integer | нет | ID филиала (get_branches). Если у клуба один филиал — подставляется он, если несколько — обязателен. |
managerId | integer | нет | ID ответственного сотрудника (staff_list); не указан — лид без менеджера (предупреждение в ответе). |
note | string | нет | Комментарий к лиду, до 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 / firstName | string | одно из двух | Фамилия, имя (до 100 символов; ФИО целиком — до 100). Нужна хотя бы фамилия или имя. |
middleName | string | нет | Отчество, до 100 символов. |
phone | string | нет | Мобильный телефон в любом формате, 7–25 цифр. Участвует в проверке дубликатов. |
email | string | нет | E-mail, до 50 символов. |
sex | string | нет | male или female; не указан — не определён. |
dateOfBirth | string | нет | YYYY-MM-DD, не позже сегодня. |
source | string | нет | Название источника привлечения из справочника клуба (без учёта регистра); неизвестное → ошибка со списком допустимых. |
branchId | integer | нет | ID филиала (get_branches). Если у клуба один филиал — подставляется он, если несколько — обязателен. |
managerId | integer | нет | ID ответственного сотрудника (staff_list); не указан — клиент без менеджера (предупреждение в ответе). |
note | string | нет | Комментарий к клиенту (поле «Описание»), до 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
Способы оплаты проведённых продаж за период (наличные, карта, безнал, депозит, бонусы, кредит, комбинированная): количество, сумма, доля; отдельно — продажи в кредит и их непогашенный остаток.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | 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 — сравнение с предыдущим периодом.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
compare | boolean | нет | 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
Рейтинг тренеров по числу записей на их занятия за период (без отменённых и листа ожидания) и числу состоявшихся посещений. Для «к какому тренеру чаще всего записываются». Учитывается основной тренер занятия.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (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 }
]
}
trainings_popular_classes
Самые популярные направления тренировок (виды занятий) по числу записей за период (без отменённых и листа ожидания).
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
Пример запроса и ответа
«Какие групповые занятия самые популярные за 30 дней?»
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "trainings_popular_classes",
"arguments": {
"period": "last_n_days",
"days": 30,
"limit": 3
}
}
}
{
"metric": "trainings_popular_classes",
"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:20",
"filters": { "branchId": null, "branchName": null },
"warnings": [ "Период не завершён (до 2026-10-24 00:00); учтены данные на 2026-10-23 18:22." ],
"items": [ { "class": "Без направления", "reserves": 32 }, { "class": "ABT", "reserves": 26 } ]
}
schedule_load
Загрузка расписания за период: вместимость и занятость мест по занятиям без пометки «Отменено», свободные места, загрузка в % — общая, по дням и по тренерам. Свободные места считаются только для занятий с заданной вместимостью.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
limit | integer | нет | Максимум строк в ответе (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.
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня. |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
trainerId | integer | нет | ID тренера (основной тренер занятия). |
trainerIds | integer[] | нет | Несколько тренеров — занятия любого из них; объединяется с trainerId. |
type | string | нет | group — групповые, individual — индивидуальные, all — все (по умолчанию). |
serviceId | integer | нет | ID услуги занятия. |
serviceName | string | нет | Часть названия услуги (без учёта регистра). |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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 месяцев.
phone | string | нет | Мобильный телефон клиента в любом формате (+7 911 310-11-39, 89113101139, 9113101139); не менее 7 цифр. Как и clientId, снимает ограничение периода. |
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня. |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. |
branchId | integer | нет | ID филиала. |
clientId | integer | нет | ID клиента (client_find) — только его записи. |
trainerId | integer | нет | ID тренера (staff_list) — записи на его занятия (основной тренер). |
serviceId | integer | нет | ID услуги занятия. |
serviceName | string | нет | Часть названия услуги (без учёта регистра). |
status | string | нет | waiting, visited, missed, freezed, canceled, wait_list (можно несколько через запятую) или all (по умолчанию). |
limit | integer | нет | Максимум строк в ответе. |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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): имя и инициал фамилии, статус записи; счётчики по статусам. Для «кто из клиентов записан на тренировку/группу».
| Параметр | Тип | Обяз. | Описание |
eventId | integer | да | ID занятия (eventId). |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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": "Ожидает" } ]
}
Удержание и отток
churn_nonrenewal
ОТТОК КАК НЕПРОДЛЕНИЕ: абонементы/клубные карты, закончившиеся в периоде и не продлённые (у клиента нет абонемента с более поздней датой окончания); доля непродления, по филиалам, сравнение (compare=true). Для «какой отток за 3 месяца среди тех, кто не купил новый абонемент» (period=last_n_days, days=90 либо custom до 3 месяцев).
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
compare | boolean | нет | 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.
| Параметр | Тип | Обяз. | Описание |
inactiveDays | integer | нет | Порог бездействия в днях (по умолчанию 30, максимум ≈ 92). |
branchId | integer | нет | 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 дней».
| Параметр | Тип | Обяз. | Описание |
inactiveDays | integer | нет | Порог бездействия в днях (по умолчанию 14, максимум ≈ 92). |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
onlyWithActiveAbonement | boolean | нет | true (по умолчанию) — только клиенты с действующим абонементом; false — все клиенты. |
limit | integer | нет | Максимум строк в ответе (1..MaxPageSize, по умолчанию 20 для списков и 10 для рейтингов). |
offset | integer | нет | Смещение для постраничного вывода (по умолчанию 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
ОТТОК КАК ИЗМЕНЕНИЕ АКТИВНОЙ БАЗЫ: сколько клиентов имели действующий абонемент на начало и на конец периода, разница и процент. Для «как изменилось число активных клиентов за период».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | 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 месяцев), в разрезе филиалов: число клиентов с действующим абонементом на начало каждого интервала. Для «какова динамика активной базы по филиалам».
| Параметр | Тип | Обяз. | Описание |
period | string | нет | Период: today, yesterday, this_week (неделя с понедельника), last_week, this_month, last_month, last_n_days (число дней — в days) или custom (границы — dateFrom/dateTo). Любой период не длиннее 3 календарных месяцев. |
days | integer | нет | Только для period=last_n_days: число последних дней, включая сегодня (максимум ≈ 92–93: период не длиннее 3 календарных месяцев). |
dateFrom | string | нет | Начало произвольного периода, формат yyyy-MM-dd, включительно (задаёт period=custom). |
dateTo | string | нет | Конец произвольного периода, формат yyyy-MM-dd, включительно; по умолчанию сегодня. Длина периода не более 3 месяцев. |
branchId | integer | нет | ID филиала (список — инструмент get_branches). Без параметра — весь клуб. |
granularity | string | нет | Шаг: 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 элемента.