Работа с очередью

Предварительная запись

Модуль позволяет внешним системам — сайту, 1С, колл-центру — записывать клиентов на конкретные дату и время. Записанный клиент появляется в общей очереди с бейджем «Запись ЧЧ:ММ», но не мешает обслуживать тех, кто пришёл без записи.

/admin/settings/booking По умолчанию выключено

Как это работает

  • Клиент без записи (walk-in) берёт талон в терминале и ждёт в живой очереди.
  • Клиент с записью заранее выбирает дату и время; в очереди он виден с пометкой времени.
  • Окно защиты — последние несколько минут перед записью. В этот момент запись поднимается в начало, и обогнать её нельзя.
  • Окно вызова — с какого момента сотрудник может нажать «Вызвать». По умолчанию ровно в назначенное время.
  • Неявка — если клиент не появился за отведённое время, запись отменяется автоматически.

Пример: запись на 15:00, окно защиты 5 минут. До 14:55 специалист обслуживает живую очередь. В 14:55 запись становится первой. В 15:00 её можно вызвать, а в 15:15 — если клиент не пришёл — она отменяется.

Включить запись

  1. Откройте Настройки → Предварительная запись.
  2. Включите мастер-переключатель. Пока он выключен, все методы API отвечают 503 booking_disabled.
  3. Проверьте рабочие часы и календарь. Слоты строятся по часам организации и, если включено, по производственному календарю РФ.
  4. Настройте горизонт, шаг и запас. На сколько дней вперёд можно записаться, шаг сетки и минимальное время до слота.
  5. Задайте окно защиты, окно вызова и время неявки. Окно вызова не может быть больше окна защиты.
  6. Выпустите API-ключ в разделе Система → API-ключи для боевой интеграции.
  7. Проверьте на песочнице, затем переключите интеграцию на live-ключ.

Параметры

НастройкаКлючПо умолчаниюСмысл
Предварительная записьbooking_enabled0Главный выключатель модуля.
Горизонтbooking_max_days_ahead30На сколько дней вперёд можно записаться (1–365).
Шаг сеткиbooking_slot_step_minutes15Интервал между слотами от начала рабочего дня (5–120).
Минимальный запасbooking_min_lead_minutes15Сколько минут должно остаться до слота от «сейчас».
Окно защитыbooking_lock_before_minutes5За сколько минут до записи её нельзя обогнать.
Окно вызоваbooking_call_before_minutes0С какого момента запись можно вызвать (0 — в назначенное время).
Неявкаbooking_no_show_grace_minutes15Через сколько после времени записи она отменяется (1–240).
Ёмкость слотаbooking_capacity_per_slot00 — автоматически по активным рабочим местам очереди.
Рабочие часы и календарьbooking_use_work_hours1Учитывать рабочие часы и праздники/выходные.
Требовать контактbooking_require_contact1Телефон или e-mail обязателен при записи через внешний API. На рабочем месте сотрудника контакт не обязателен.
Тестовый режимbooking_test_enabled1Разрешает публичный тестовый ключ песочницы.

Песочница и боевые ключи

  • Тестовый ключ публикуется в документации API и создаёт только брони с is_test=true.
  • Тестовые брони не попадают в живую очередь, на табло, в отчёты, дашборд и push-уведомления; удаляются через сутки.
  • Live-ключ выпускается в API-ключах и показывается один раз. Храните его в секретах интеграции, не в браузере и не в Git.
  • У ключа есть права (scopes) и ограничения по очередям и услугам. Пустой список ограничений означает «ничего не разрешено», null — «все».
  • Перевыпуск ключа сразу отключает старый секрет.

Запись с рабочего места

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

  • Откройте раздел «Запись» в меню рабочего места /employee2 или нажмите кнопку с календарём в шапке /employee. Раздел виден, только если роли выдано право просмотра предварительной записи.
  • Экран разделён на три части. Слева — панель «Новая запись», в центре — календарь и свободное время, справа — записи выбранного дня. На обычном ноутбуке всё помещается на одном экране, прокручивать страницу не нужно.
  • Выберите очередь и услугу в первом шаге панели «Новая запись». Список услуг показывает только то, что относится к выбранной очереди.
  • Ориентируйтесь по цвету дней: зелёный — есть свободные места, жёлтый — мест мало, красный — всё занято, серый — выходной. У дня подписано количество свободных мест, а расшифровка цветов находится под календарём.
  • Нажмите на день в календаре — под календарём появится список «Свободное время» с часами этого дня, а справа — уже созданные записи с временем, клиентом и статусом.
  • Проверьте дату и время. Второй шаг панели связан с календарём: в нём выбран тот же день, а смена даты переключает календарь. В списке времени только будущие слоты; свободное время подставляется автоматически, при необходимости выберите другое.
  • Создайте запись. Третий шаг кратко показывает, что будет создано, и сколько мест осталось. Кнопка «Создать запись» всегда находится внизу панели — найдите её взглядом один раз, и она не будет переезжать. Остальные данные клиента пока не заполняются.
  • Быстрый способ: нажмите на свободное время в блоке «Свободное время» — оно само подставится в панель записи, а выбранный слот подсветится.
  • Подсказка после выбора. Когда вы нажимаете день в календаре или время в списке слотов, нужное поле в панели записи на мгновение подсвечивается, а кнопка «Создать запись» становится активной — значит, запись можно создавать.
  • Изменение и удаление — кнопки с карандашом и корзиной у записи в правой колонке «Записи на день». Они появляются только при соответствующих правах роли.

Внешний вид раздела подчиняется настройкам рабочего места: тема, прозрачность блоков и фон рабочей области. На прозрачном фоне страница записи выглядит так же, как заметки и доски задач.

Если у роли нет права создавать записи, панель слева показывает только выбор очереди и услуги, а календарь и записи остаются доступными для просмотра.

Настройка «Требовать телефон или e-mail» относится к внешнему API. С рабочего места сотрудника запись можно создать и изменить без контакта клиента — эти поля остаются необязательными.

Управление записями

  • Справочники → Талоны — записи видны со статусом «Запись»; администратор может отменить бронь.
  • Отмена и перенос через API сразу обновляют экраны по WebSocket.
  • В отчётах записи не входят в «создано/обслужено»; число записей за период показывается отдельной метрикой.
  • История записей сохраняется для разбора обращений; удаляются только тестовые старше суток.
  • Персональные данные клиента (имя, телефон, e-mail) не выводятся на публичные табло.
Не меняйте правила на ходу без предупреждения интегратора. Уменьшение горизонта или шага делает часть уже опубликованных слотов недействительными для новых записей. Уже созданные брони при этом сохраняются.

Документация для интегратора

Полное описание API — в отдельном разделе. Смысл методов, параметров и кодов ошибок не менялся: