Клуб уже использует своё приложение, но расписание, абонементы и записи живут отдельно от учётной системы. Интегрируем мобильный клиент с 1С:Фитнес клуб так, чтобы место на занятии, основание посещения и результат покупки подтверждались данными клуба, а администратор видел ту же операцию, что и посетитель.
Когда нужен собственный обмен
У 1С:Фитнес клуб есть готовое клиентское приложение. Сначала сравниваем его возможности с задачей заказчика: иногда достаточно настроить штатный продукт. Собственная интеграция оправдана, когда уже есть отдельный клиент, особый путь записи, объединённый кабинет сети или функции, выходящие за выбранное готовое решение.
Начинаем с версии 1С:Фитнес клуб, схемы размещения и доступных интерфейсов. В опубликованном API v3 описаны клиентская авторизация, членства, занятия, записи и платежные операции, но доступность конкретного метода проверяется на установленной системе. Наличие метода в общей документации не подтверждает его подключение и права в вашей базе.
Если мобильный продукт ещё предстоит спроектировать, интеграция становится частью разработки приложения для фитнес-клуба. Здесь основной результат — подключение существующего клиента к конкретной клубной системе.
Если нужно создать приложение клуба
Проектирование клиентского продукта объединяет запись, членства, покупки и связь с фактической работой клуба.
Подробнее об услугеКакие данные получает и меняет приложение
| Объект | Источник подтверждения | Что видит клиент |
| Расписание и свободное место | Клубная система и её правила записи | Доступное занятие и результат бронирования |
| Членство или пакет | Учёт членств, активаций, заморозок и списаний | Применимые условия и актуальный остаток |
| Покупка | Заказ и подтверждённое состояние оплаты | Ожидание, успех либо причина незавершённой покупки |
| Посещение | Принятый в клубе источник факта визита | История фактических посещений, отдельная от записей |
В карте обмена фиксируем филиал, клиента, услугу, тренера, помещение и конкретное занятие. Сопоставляем идентификаторы, а не только названия: два одноимённых занятия или две карты одного человека не должны объединяться автоматически. Для сети определяем, где действует членство и какие сведения доступны между клубами.
Служебный доступ к API остаётся на сервере. Мобильный пользователь получает только разрешённые ему операции; общий ключ базы не встраиваем в приложение. Отдельно разбираем семейный доступ и представителей: подтверждённый телефон не означает право управлять любым родственником из карточки.
Расписание и подтверждённая запись
Показываем занятия с датой, временем, филиалом, тренером и доступными условиями. Перед записью сервер повторно проверяет возможность участия: свободное место, применимое членство, ограничения клуба и состояние клиента. Изображённое в кеше место не является бронью, пока система не вернула подтверждение.
Для групповых тренировок, персональных занятий и аренды ресурса могут потребоваться разные операции. Выбираем методы под реальную модель клуба; лист ожидания не выдаём за подтверждённую запись. При смене тренера, отмене занятия или изменении времени приложение получает новое состояние, а не создаёт собственную независимую версию расписания.
Членства, отмена и фактическое посещение
Клиенту показываем доступные пакеты и условия их применения: период действия, остаток, активацию и заморозку, если эти действия входят в проект и поддерживаются настройками. Не рассчитываем право посещения только по дате, сохранённой на телефоне: членство могло быть приостановлено или использовано в другом канале.
Для отмены связываем запрос с исходной записью. Правила клуба определяют крайний срок и возврат посещения; успешный ответ на отмену и восстановление остатка проверяем как связанные, но отдельные результаты. Факт визита приходит из согласованного источника — администратора, пропускной системы или другого предусмотренного процесса. Бронь занятия сама по себе не доказывает приход клиента.
Если требуется проход по мобильному пропуску, отдельно подключаем систему контроля и управления доступом — СКУД. Сопоставляем клиента, действующее основание входа, контроллер и событие прохода. Возможность показать код в приложении не подтверждает, что конкретное оборудование умеет его принять; интерфейсы проверяем вместе с поставщиком СКУД.
Покупка и оплата без двойного учёта
Если требуется продажа членства или пополнение счёта, определяем состав заказа, источник цены, создание платёжной ссылки и способ получения подтверждения. Открытие платёжной страницы не означает оплату; приложение показывает ожидающий статус до подтверждения сервером и клубной системой.
Покупку связываем с клиентом и документом, а повторный ответ платёжного сервиса — с прежней операцией. Возвраты и задолженности требуют согласованных правил учёта. Автоплатежи и управление регулярным договором оцениваем отдельно: они не следуют автоматически из возможности разовой покупки.
Обрыв связи не должен создавать вторую запись
Для изменяющих запросов сохраняем идентификатор операции и результат. Если API вашей версии не предоставляет готового механизма защиты от повторов, реализуем его в серверной части и проверяем фактическое состояние до повторного изменения. При неизвестном результате приложение сообщает о проверке, а не предлагает бесконтрольно нажать «Записаться» ещё раз.
Настраиваем журнал обмена с доступным сотруднику статусом и причиной ошибки: нет места, истекло членство, неверное сопоставление или недоступна база. Технический журнал не превращаем в хранилище лишних персональных данных. Расхождения можно повторно обработать после устранения причины с сохранением исходной операции.
Приёмка и оценка интеграции
Проверяем запись одновременно из приложения и с рабочего места администратора, последнее свободное место, отмену по обе стороны допустимого срока, замороженное членство, повтор после тайм-аута и оплату с задержанным подтверждением. По каждому сценарию сверяем мобильный экран, запись в 1С и остатки, которые должны измениться по правилам клуба.
Заказчик получает карту данных и прав, серверный адаптер в согласованном составе, описание API для клиента, журнал ошибок и результаты контрольных операций. Для оценки нужны версия и доступы к тестовой базе, описание приложения, филиальная структура, виды занятий и членств, правила отмены и существующая оплата. Доработка экранов, СКУД и дополнительные модули выделяются отдельно.
Можно подключить приложение, которое работает не на 1С?
Да, мобильный клиент может использовать собственный сервер. Между ним и 1С:Фитнес клуб проектируем доступный интерфейс и сопоставление данных. Совместимость зависит от вашей версии, разрешённых операций и состояния существующей серверной части.
Обновится ли всё мгновенно?
Для записи и оплаты требуется подтверждение операции, а справочники могут обновляться по согласованному расписанию. Частоту выбираем по возможностям базы и цене устаревших данных. Обещание мгновенной синхронизации всех объектов без проверки инфраструктуры не даём.