Витрина и платный вход
Конфигурация типа «Витрина» превращает терминал в «оплатил — открылось»: покупатель нажимает кнопку услуги, платит картой или по QR-коду СБП, терминал подаёт команду на сетевую релейную плату, и замок двери открывается. Так работают холодильник или шкаф-витрина с товаром одной цены, платный туалет, душ, камера хранения. Датчик двери (геркон) позволяет держать на терминале экран «Занято», пока помещение занято.
Что это и когда выбирать «Витрину»
«Витрина» — один из типов конфигурации. На главном экране терминала — до пяти кнопок (вариантов доступа или ценовых категорий), а после оплаты выполняется один общий сценарий реле: открыть замок, подождать, пока покупатель войдёт или заберёт товар, дождаться закрытия двери.
| Задача | Подходит «Витрина»? | Комментарий |
|---|---|---|
| Холодильник или шкаф с замком, товары одной цены («Всё по 349 ₽») | Да | Покупатель платит за доступ и сам выбирает товар на полке. |
| Платный туалет, душ, комната матери и ребёнка — одна дверь | Да | Несколько кнопок с разной ценой («Туалет», «Душ») открывают одну и ту же дверь. |
| Камера хранения или шкаф с одной дверцей | Да | — |
| Несколько дверей или ячеек, у каждой кнопки — свой замок; больше пяти позиций | Нет | Используйте Управление реле: там у каждой кнопки своя плата и свой сценарий. |
| Микромаркет с каталогом и корзиной, ячейки с выдачей по товару | Нет | Используйте «POS-точку с реле» — POS-точка. |
| Оплата только с телефона по наклейке, без терминала | Частично | См. раздел «QR-стикер». |
Место «Витрины» в общей схеме:
- Место обслуживания
- Точка: способы оплаты, релейная плата на вкладке «Оборудование»
- Конфигурация «Витрина»: кнопки, экраны, сценарий реле
- Терминал
- Релейная плата → замок
В конфигурации «Витрина» нет полей с адресом релейной платы. Терминал получает адрес, порт и пароль платы из оборудования точки, к которой привязан. Поэтому одна конфигурация может работать на нескольких точках, у каждой — своя плата.
Что увидит покупатель
Ниже — сценарий при «Типе первого экрана» = «Стандартный режим» (рекомендуемый вариант).
- Главный экран. Фон, логотип, «Текст 1» и «Текст 2» из блока «Первый экран» и кнопки из планограммы, например «50 руб.» и «100 руб.». Подписи кнопок настраиваются на вкладке «Интерфейс».
- Выбор кнопки. Сумма к оплате = «Стоимость (безналичные)» строки, при надписи «Количество» — умноженная на количество. Кнопка с нулевой ценой открывает клавиатуру для ввода своей суммы.
- Способ оплаты. Если в точке включён один способ (например, только карта), терминал сразу просит приложить карту. Если два и больше — экран «Выберите способ оплаты» с кнопками «Банковская карта», «QR-код (СБП)», «Карта сотрудника» и т. д. (Способы оплаты).
- Оплата. Карта — через банковское приложение терминала; СБП — QR-код на экране, ожидание до «Таймаута оплаты по СБП».
- Сценарий реле. Терминал переходит на экраны шагов сценария («Дверь открыта», «Закройте дверь», «Занято» — тексты задаёте вы) и выполняет действия: команду на открытие замка, ожидание датчика двери, паузы. Звучит сигнал успешной оплаты.
- Экран результата. «ПЛАТЕЖ ЗАВЕРШЕН» и QR-код электронного чека (если включено «Отображать QR» в блоке «Последний экран»). Через «Таймаут показа чека (сек)» или по кнопке «Завершить» терминал возвращается на главный экран.
Пока идёт сценарий, терминал показывает экраны шагов и не принимает новую оплату: главный экран с кнопками вернётся только после завершения сценария. Именно так реализуется «Занято»: шаг сценария ждёт сигнала датчика двери, а на экране в это время надпись «Занято». Задания «Сверка итогов» и «Отмена операции» терминал выполняет только на главном экране; если сценарий длится дольше пары минут, такое задание может завершиться ошибкой — повторите его позже.
Что раньше: реле или экран результата
Порядок задаёт поле Порядковый номер экрана в блоке «Последний экран» вкладки «Интерфейс».
| Значение | Порядок на терминале | Когда платёж появляется в личном кабинете |
|---|---|---|
| 0 (или любое, кроме 2) | Оплата → сценарий реле → экран результата с QR-кодом чека. | После завершения сценария. Если сценарий длинный (покупатель 15 минут в душе), платёж и чек появятся только после его окончания. |
| 2 | Оплата → экран результата с QR-кодом чека → сценарий реле → главный экран. | Сразу после оплаты. |
Значение 2 действует при оплате по СБП и через часть банковских приложений. При оплате через приложение Сбербанка, а также кнопкой «Наличные» терминал всегда сначала выполняет сценарий, а потом регистрирует платёж — как при значении 0.
Для платного туалета и душа удобнее значение 2: покупатель сразу получает чек, платёж сразу виден в ЛК, а экран «Занято» держится, пока идёт сеанс. Для витрины с товаром подходят оба варианта.
Если сценарий не выполнился
Сценарий считается неуспешным, когда условие шага не выполнилось и настроенное действие — «Выход из сценария» (подробно — в разделе «Настройка шагов»).
- «Порядковый номер экрана» не 2: терминал показывает экран ошибки (об ошибке в проведении операции) и записывает в ЛК операцию с пояснением причины, например «Ошибка по таймауту».
- «Порядковый номер экрана» = 2: чек уже показан, терминал возвращается на главный экран.
- Возврат денег. При оплате картой через банковское ПО SmartSkyPos, PayPro или Uniteller терминал сам запускает возврат — при любом значении «Порядкового номера экрана». При другом банковском ПО и при оплате по СБП проверьте операцию в разделе «Платежи» и при необходимости оформите возврат — Возвраты и отмены.
Что понадобится
| Что | Зачем | Где описано |
|---|---|---|
| Терминал с банковским ПО (для улицы — «Салют 3В ПРО») | Приём оплаты, экран, управление платой по сети. | Оборудование |
| Сетевая релейная плата (например, DT-R002 на 2, 4 или 8 каналов) | Включает замок, табло, свет; к её входам подключается геркон. | Оборудование, Управление реле |
| Электромагнитный или электромеханический замок, геркон (датчик открытия двери), кнопка выхода изнутри, блок питания 12 В | Исполнительная часть. Кнопка выхода изнутри подключается к замку напрямую и открывает дверь независимо от терминала — это аварийный выход. | Схема подключения — у поставщика комплекта или в поддержке JustPay |
| Wi-Fi-роутер или Ethernet на объекте | Терминал и плата должны быть в одной локальной сети, оба — со статическими адресами. | Сеть терминала |
| Номенклатура: позиции «Посещение туалета», «Душ 15 минут» и т. п. | Название и ставка НДС в чеке. | Номенклатура |
| Точка обслуживания со способами оплаты и привязанной платой | Связывает терминал, плату и конфигурацию. | Точки обслуживания |
| Касса (если нужен чек) | Фискализация платежей. | Фискализация и ККТ |
Только SIM-карты для «Витрины» недостаточно: по мобильной сети терминал не видит релейную плату. Подключите терминал к сети объекта по Wi-Fi или Ethernet (SIM можно оставить резервным каналом связи с сервером).
Создание конфигурации
- Откройте Точки обслуживания → Конфигурации и нажмите Добавить.
- На вкладке Общие данные выберите Тип конфигурации = «Витрина», заполните название и организацию.
- Заполните Планограмму, проверьте Настройки, оформите Интерфейс.
- Нажмите Сохранить, затем снова откройте конфигурацию: ≡ → Изменить.
- Только теперь на вкладке Настройка шагов появится кнопка Добавить новую страницу, а на вкладке «Интерфейс» — блок Реле. Настройте сценарий и сохраните.
У новой «Витрины» вкладка «Настройка шагов» пустая — это не ошибка. Сценарий реле создаётся при первом сохранении конфигурации.
Не меняйте тип у существующей конфигурации. Технически это возможно, но смена типа может нарушить логику конфигурации (были случаи некорректной работы). Нужна «Витрина» — создайте новую конфигурацию этого типа или скопируйте уже работающую витрину (≡ → Копировать).
Вкладка «Общие данные»
| Поле | Что задаёт | На что влияет |
|---|---|---|
| Дата версии заполняется автоматически | Дата последнего сохранения. | Только информация. |
| Версия заполняется автоматически | Номер версии, растёт при каждом сохранении. | По нему видно, менялась ли конфигурация. |
| Статус | «Активная» или «Архивная». | Архивную конфигурацию не выбирают для новых точек. Подробно — Конфигурации. |
| Тип конфигурации обязательное | «Витрина». | Определяет набор вкладок и сценарий терминала. |
| Название | Имя в списке конфигураций и в карточке точки. | Пишите так, чтобы было понятно назначение и вариант сценария: «Туалет ТЦ — с герконом», «Холодильник — 349 ₽». |
| Описание | Свободный комментарий. | Удобно записать схему подключения: «замок — канал 1, геркон — вход 1». |
| Наименование клиента | Ваша организация. | Без неё в планограмме не будет списка номенклатуры. |
Вкладка «Планограмма»
Каждая строка — кнопка на главном экране терминала. Все кнопки «Витрины» запускают один и тот же сценарий реле, поэтому колонок «Реле» и «Сценарий» здесь нет.
| Колонка | Что задаёт | На что влияет |
|---|---|---|
| Код ячейки обязательное | Номер места кнопки на экране: 1–5. | На экране пять мест под коды 1, 2, 3, 4, 5; строки с другими кодами не показываются. Нумеруйте подряд, без пропусков и повторов, в том же порядке, что и строки таблицы, — от порядка зависит, какое оформление получит кнопка. |
| Тип | Признак предмета расчёта в чеке. Для входа, душа, туалета — «Услуга», для товара из витрины — «Товар». | Попадает в чек. При «Услуге» колонка «Количество» становится неактивной. |
| Товар обязательное | Позиция номенклатуры (поле «Поиск товара»). Подставляет цену и ставку НДС. | Название позиции — строка чека. Строка без товара не даёт отрисоваться этой и следующим кнопкам. |
| Количество | Сколько единиц продаётся одним нажатием. | Учитывается, только если на вкладке «Интерфейс» у кнопки выбран текст «Количество»: тогда на кнопке «2 шт.», а сумма = цена × 2. При надписи «Сумма» терминал всегда продаёт 1 единицу. |
| Ставка НДС | Ставка из справочника; подставляется из номенклатуры. | Попадает в чек. Значения — Номенклатура. |
| Стоимость (наличные) | Цена при оплате наличными. | На терминале «Витрины» не используется: сумма всегда берётся из «Стоимости (безналичные)». |
| Стоимость (безналичные) обязательное | Цена кнопки в рублях. | Сумма к оплате и надпись на кнопке («50 руб.», копейки на кнопке не показываются). 0 — кнопка своей суммы: покупатель вводит сумму сам. |
| Значок корзины | Удаляет строку. | Вместе со строкой исчезает её блок оформления «Номер ячейки N» на вкладке «Интерфейс». |
Новая пустая строка добавляется автоматически, как только вы начинаете заполнять последнюю. Подробнее о планограмме — Планограмма.
Для платного входа кнопку своей суммы (стоимость 0) не делайте: покупатель сможет ввести 1 ₽ и пройти.
Вкладка «Настройки»
| Поле | Что задаёт | Что это значит для «Витрины» |
|---|---|---|
| Сервер, Порт | Адрес сервера JustPay: https://lk.justpay.pro и 443. | Не меняйте. |
| Тип цены | «Брать из номенклатуры» или «Брать из настроек аппарата». | Используется только в вендинге. Можно оставить пустым. |
| Тип первого экрана | Что терминал показывает в режиме ожидания. | Ключевое поле — значения ниже. Для витрины и платного входа — «Стандартный режим». |
| Тип экрана оплаты | Вариант экрана выбора способа оплаты. | Текущая версия приложения терминала его не использует. Экран выбора появляется сам, если в точке включено больше одного способа оплаты. |
| Таймаут главного экрана (сек) | — | Не используется. Заполнять не нужно. |
| Таймаут выбора товара (сек) | — | Используется только в вендинге. Экран выбора способа оплаты закрывается сам через 15 секунд. |
| Таймаут показа чека (сек) | Сколько держится экран результата и экран ошибки. | Поставьте 10–20 секунд, чтобы покупатель успел отсканировать QR-код чека. При пустом поле экран сменится почти сразу. При «Порядковом номере экрана» = 2 сценарий реле начнётся только после этого времени (или кнопки «Завершить») — не ставьте больше 15–20 секунд, иначе покупатель будет ждать у закрытой двери. |
| Таймаут ожидания фискализации (сек) | Сколько сервер ждёт регистрации чека. По умолчанию 5. | Работает только вместе с «Обязательностью фискализации». |
| Таймаут оплаты по карте (сек) | Время ожидания карты. По умолчанию 150. | Используется только с банковским приложением SmartSkyPos; для остальных время задаёт банковское ПО. |
| Таймаут оплаты по СБП (сек) | Сколько QR-код СБП висит на экране. По умолчанию 150. | По истечении терминал перестаёт ждать оплату и возвращается на главный экран. 0 или пусто — 65 секунд. |
| Тип экрана при сканировании Цифрового ID MAX | Как проверять покупателя через MAX. | Действует, только если на точке настроена идентификация MAX. Иначе оставьте как есть. |
| Обязательность фискализации | Флажок; по умолчанию снят. | Если включён и чек не пробит, оплата картой отменяется. Включайте только при надёжной кассе и связи. |
| Фискализация наличных операций | Флажок; по умолчанию включён. | Чек на оплаты наличными. На витрине самообслуживания наличные не включают (см. ниже), флажок ни на что не повлияет. |
| Фискализация безналичных операций | Флажок; по умолчанию включён. | Чек на оплаты картой и по СБП. Нужна касса на точке — Фискализация и ККТ. |
«Тип первого экрана» для «Витрины»
| Значение | Что делает терминал | Когда выбирать |
|---|---|---|
| Стандартный режим | Главный экран с кнопками из планограммы (до пяти). | Почти всегда: витрина, туалет, душ. |
| Универсальный экран - Банковская карта + QR | Без кнопок: на одном экране сразу можно приложить карту и отсканировать QR-код СБП. Сумма — из строки планограммы («Стоимость (безналичные)» × «Количество»). | Одна услуга с одной ценой, нужно минимум касаний. Оставьте в планограмме ровно одну строку и проверьте, что в ней «Количество» = 1, иначе сумма будет неверной. Оформление — блок «Универсальный экран». |
| Чтение карты доступа режим | Экран «Приложите карту» — проход только по картам сотрудников, без оплаты. | Служебная дверь. Для платного входа с проходом персонала используйте «Стандартный режим» и способ «Доступ по карте сотрудника» в точке. |
| Выбор способа оплаты | Текущая версия приложения это значение не обрабатывает. | Не выбирайте. |
| Чтение карты доступа + Оплата | Не обрабатывается. | Не выбирайте. |
Вкладка «Интерфейс»
Блоки раскрываются щелчком по строке. Блок «Реле» появляется только после первого сохранения конфигурации и повторного открытия.
| Блок | Что оформляет | Что важно для «Витрины» |
|---|---|---|
| Первый экран | Главный экран: фон, логотип, «Текст 1», «Текст 2» и подблоки «Номер ячейки N» — по одному на строку планограммы. | В подблоке ячейки поле «Текст на кнопке»: «Сумма» (на кнопке «50 руб.»), «Количество» («1 шт.») или «Описание» (текст из поля «Текст кнопки для свободного ввода», например «Туалет»). Там же цвет, шрифт и скругление кнопки. «Текст 1» — название услуги, «Текст 2» — подсказка («Оплата картой или по QR»). |
| Экран выбора способа оплаты | Экран с кнопками способов оплаты. | Применяется оформление кнопки отмены; логотипы и тексты способов оплаты на терминале пока не показываются. |
| Универсальный экран | Экран «карта + QR» при соответствующем «Типе первого экрана». | Фон, логотип карты, тексты над и под ним. |
| Экран чтение карты доступа | Экран «Приложите карту» для режима чтения карты доступа. | См. Доступ по карте сотрудника. |
| Экран чтение карты доступа + оплата | — | Режим не используется, блок можно не заполнять. |
| Экран ошибки | Экран при отказе банка, истечении времени, неуспешном сценарии. | Держится «Таймаут показа чека». |
| Последний экран | Экран результата с QR-кодом чека. | Поле Порядковый номер экрана задаёт, что раньше — реле или этот экран (см. выше). «Отображать QR» — показывать QR-код чека. |
| Реле | Экраны шагов сценария — подблок «Страница (шаг) N» на каждый шаг. | См. таблицу ниже. |
Все поля общих блоков подробно описаны в статье Оформление экранов терминала.
Блок «Реле»: экран каждого шага
Пока выполняется шаг сценария, терминал показывает его экран. Набор подблоков совпадает с шагами на вкладке «Настройка шагов»: добавили шаг — появился подблок.
| Поле | Что задаёт | Как применяется на терминале |
|---|---|---|
| Цвет фона | Фон экрана шага, по умолчанию #D5D3DA. | Обязательно оставьте цвет заполненным. |
| Цвет тулбара | Цвет верхней полосы. | Пусто — полоса скрывается. |
| Логотип, Ширина изображения, Высота изображения | Картинка на экране шага (например, пиктограмма двери). | Если размер 0 — 100 × 100 пикселей. |
| Изображение - во весь экран | — | На экранах шагов оставьте выключенным, используйте логотип с размерами. |
| Текст 1, Текст 2 (размер шрифта, цвет шрифта, текст) | Надписи экрана: «Дверь открыта», «Входите»; «Занято», «Подождите, пожалуйста». | Показываются весь шаг. Цвет шрифта не оставляйте пустым. |
| Кнопка (радиус, текст, шрифт, цвет фона) | — | На экране шага кнопка не выводится, поля можно не заполнять. |
Не очищайте цвета фона и шрифта у шагов. Без них экран шага не построится, сценарий не запустится, и замок после оплаты не откроется. Новые шаги получают цвета по умолчанию — просто не стирайте их.
Вкладка «Настройка шагов»: сценарий реле
Здесь настраивается единственный сценарий «Витрины» — что делает терминал после оплаты: открыть замок, подождать, дождаться закрытия двери. Вкладка заполняется после первого сохранения конфигурации. Как устроен сценарий, все поля шагов и действий, схемы и примеры — в разделе «Как настроить сценарий реле: шаги и действия» ниже.
Как настроить сценарий реле: шаги и действия
Сценарий реле — это инструкция для терминала на время после оплаты: какой канал релейной платы включить, сколько ждать, что проверить и что показать покупателю. Её удобно представлять как рецепт: сценарий — весь рецепт, шаги — этапы («открыть дверь», «дождаться, пока закроют»), действия — строчки внутри этапа («включить канал 0», «подождать 5 секунд», «проверить датчик двери»). Терминал читает рецепт строго сверху вниз и не пропускает строчки, пока не выполнит их или пока не истечёт отведённое время.
Из чего состоит сценарий
Три правила, на которых держится вся логика:
- Отдельного «условия перехода» у шага нет. Шаг заканчивается, когда терминал прошёл все его действия. Чтобы терминал чего-то ждал (закрытия двери, сигнала датчика), добавьте действие-«сторож»: условие + «Повтор текущего действия» + «Отсутствие команды». Пока условие не выполнено, терминал стоит на этом действии.
- Условие действия — это проверка перед командой. Действие читается так: «если условие выполнено → пауза ДО → команда → пауза ПОСЛЕ → следующее действие; если нет → поступить по полю «Действие при неуспешном условии»». Условие «Не задано» считается выполненным всегда.
- «Таймаут шага» — предохранитель от бесконечного ожидания. Он отсчитывается с начала шага и срабатывает только когда условие не выполнено: вместо обычной реакции терминал применяет «Действие по таймауту». У нового шага таймаут пустой (то есть 0), а действие по таймауту — «Выход из сценария». Пока в шаге нет условий, это не важно; как только появляется ожидание — задайте время.
Где что настраивается
Сценарий не работает сам по себе: терминалу нужно знать, на какую плату отправлять команды, и какая кнопка или товар запускает какой сценарий. Эти данные лежат в четырёх местах личного кабинета.
- Плата в «Оборудовании»
- Плата и конфигурация в точке
- Сценарии на «Настройке шагов»
- Экраны шагов на «Интерфейсе»
- Связь кнопки или товара со сценарием
- «Обновление конфигурации»
Чем отличаются сценарии в трёх типах конфигурации
| Витрина | Управление реле | POS-точка с реле | |
|---|---|---|---|
| Сколько сценариев | Один, без названия. Появляется после первого сохранения конфигурации | Сколько нужно, у каждого название | Сколько нужно, у каждого название |
| Что запускает сценарий | Любая из кнопок (до пяти) | Кнопка — строка планограммы | Оплаченная корзина: каждый разный сценарий её товаров — один раз |
| На какую плату идут команды | Релейная плата точки (держите на точке одну) | Колонка «Реле» строки | «Серийный номер реле» позиции каталога |
| Экраны шагов | Свой экран у каждого шага | Свой экран у каждого шага | Только экран первого шага (первого сценария) |
| Условия по реле и датчикам | Работают | Работают | Не используйте: такое условие не выполнится |
| «Порядковый номер экрана» = 2 | Можно | Можно | Оставьте 0 |
| Ручная команда заданием «Запрос на реле» | На плату точки | На все платы точки | Не выполняется — проверяйте покупкой на «Эмуляторе» |
Что происходит после оплаты
Сценарий запускается только после успешной оплаты (или после прохода по карте сотрудника, если этот способ включён в точке). Что раньше — сценарий или экран с чеком — задаёт поле Порядковый номер экрана в блоке Последний экран вкладки «Интерфейс».
Пока идёт сценарий, покупатель видит экраны шагов, а новую оплату на этом экране начать нельзя. Если сценарий завершился «Выходом из сценария», терминал показывает экран ошибки; при оплате картой через банковское ПО SkyPos, Uniteller или PayPro он сам запускает возврат, в остальных случаях проверьте операцию в разделе Платежи и при необходимости верните деньги — Возвраты и отмены.
Как терминал выполняет одно действие
Это главная схема. По ней проходит каждое действие каждого шага.
- Пауз ДО и ПОСЛЕ достаточно, чтобы сделать «просто подождать». Действие с условием «Не задано», «Отсутствием команды» и «Таймаутом ПОСЛЕ» = 300 держит экран шага 5 минут.
- «Переход к следующему действию» пропускает команду этого действия, а «Считать условие выполненным» — выполняет её. Выбирайте в зависимости от того, нужна ли команда, если ждать не дождались.
- Если ожидание не дождалось, следующее условие в этом же шаге тоже сразу уйдёт в «Действие по таймауту»: время шага уже истекло. Поэтому разные ожидания с разными лимитами разносите по разным шагам.
Справочник полей: сценарий и шаг
| Поле или кнопка | Что задаёт | Типичное значение и советы |
|---|---|---|
| Добавить новый сценарий Управление реле, POS-точка с реле | Новый сценарий: окно «Наименование сценария», затем карточка сценария. | Название — то, что вы увидите в списке «Сценарий» у кнопки или товара: «Шлагбаум въезд», «Ячейка 3». У «Витрины» кнопки нет: её единственный сценарий появляется после первого сохранения конфигурации. |
| Название сценария, корзина рядом | Переименование и удаление сценария. | Переименование привязки не ломает. Перед удалением переназначьте кнопки и товары, которые на него ссылались, иначе после оплаты им будет нечего выполнять. |
| Копировать сценарий | Копия с названием «Копия …». | Для однотипных каналов: настройте и проверьте один сценарий, скопируйте, поменяйте «Номер реле» и название. |
| Добавить новую страницу | Новый шаг в конец сценария. | Шаг создаётся без действий: добавьте их. Шаг без действий терминал проскакивает мгновенно. Новый шаг получает цвета экрана по умолчанию. |
| Страница (шаг) N | Раскрывающаяся панель шага. | Шаги выполняются строго сверху вниз. Переставить шаги нельзя — только удалить и добавить заново. |
| Удалить страницу | Удаляет шаг со всеми действиями. | Без подтверждения. Ошиблись — выйдите кнопкой «Назад» без сохранения. |
| Таймаут шага (сек) | Сколько секунд шаг может ждать выполнения условий. | Нет условий в шаге — оставьте пустым. Есть ожидание — ставьте с запасом: ждать открытия двери 60, сеанс в кабине 900–1800. Пусто или 0 означает «время уже вышло»: первое же невыполненное условие уйдёт в «Действие по таймауту». |
| Действие по таймауту | Что сделать, если время шага вышло, а условие не выполнено. | «Выход из сценария» — аварийное завершение, экран ошибки. «Переход к следующему действию» — пропустить действие вместе с его командой. «Считать условие выполненным» — выполнить команду и идти дальше. «Переход к следующему шагу» работает так же, как «Считать условие выполненным». Не выбрано — как «Выход из сценария». |
| Выполнение шага, Канал | «-» / «И»; «TCP» / «Digital I/O». | Текущей версией приложения терминала не используются: команды всегда уходят на плату по сети. Оставьте пустыми. |
| Добавить новое действие | Новое действие в конец шага. | Действия выполняются сверху вниз. Переставить нельзя — удалите и добавьте заново. |
| Экран шага вкладка «Интерфейс» → «Реле …» → «Страница (шаг) N» | Что видит покупатель, пока идёт шаг: Цвет фона, Цвет тулбара, Логотип и его размеры, Текст 1, Текст 2. | Пишите инструкцию, а не рекламу: «Дверь открыта — входите», «Закройте дверь». Цвета фона и шрифта всегда должны быть заполнены в формате #RRGGBB (например, #D5D3DA): без них экран шага не построится и сценарий не начнётся. Пустой «Цвет тулбара» просто убирает верхнюю полосу. Кнопки на экранах шагов не выводятся. |
Справочник полей: действие и условие
| Поле | Что задаёт | Типичное значение и советы |
|---|---|---|
| Выберите тип условия | Проверка перед командой: «Не задано», «И», «Или», «Значение реле», «Значение датчика». | Для команды без проверки — «Не задано». Для ожидания двери — «Значение датчика». Перед каждой проверкой терминал опрашивает плату. |
| Номер реле, Значение реле при «Значение реле» | Какой канал платы проверить и какое состояние ждать: 1 — включён, 0 — выключен. | Чтобы убедиться, что команда дошла, после включения добавьте проверку «= 1»: «Повтор текущего действия», «Таймаут шага» 5 и «Выход из сценария» по таймауту. Проверка «= 0» как признак успеха ненадёжна: выключенный канал не отличить от платы, которая не ответила. |
| Номер датчика, Значение датчика при «Значение датчика» | Какой вход платы проверить (к нему подключён геркон, концевик, кнопка) и какое значение ждать: 0 или 1. | Какое значение означает «дверь закрыта», зависит от подключения геркона. Откройте веб-интерфейс платы и посмотрите состояние входа при открытой и закрытой двери. |
| Добавить новое условие при «И» и «Или» | Вложенные условия. | «И» — должны выполниться все (дверь закрыта и замок выключен). «Или» — хотя бы одно. |
| Таймаут при неуспешном выполнении условия (сек) | Пауза перед повторной проверкой. | Работает только с «Повтором текущего действия». Ставьте 1. |
| Действие при неуспешном условии | Что делать, если условие не выполнено, а время шага ещё не вышло. | Ждать события — «Повтор текущего действия». Обязательная проверка не прошла — «Выход из сценария». Все значения — ниже. |
| Действие при успешном условии | Команда действия: «Отсутствие команды», «Запрос на реле», «Показ главного экрана». | «Запрос на реле» открывает поля команды. «Отсутствие команды» — для ожидания и пауз. «Показ главного экрана» — см. ниже. |
| Таймаут ДО выполнения команды (сек) | Пауза между проверкой условия и командой. | Обычно 0. Пример: 2 секунды, чтобы покупатель успел подойти к двери. |
| Номер реле (rele) | Канал платы, на который уходит команда. | Номер передаётся плате как есть. Обычно первый канал — 0 (на корпусе платы он может быть подписан «1»). Проверьте заданием «Запрос на реле» до настройки сценария. |
| Тип команды (type) | Режим команды в кодах платы: постоянное включение/выключение, импульс (включить на время и выключить само) и др. | Коды режимов задаёт прошивка платы: возьмите их из документации платы или у поддержки JustPay и подберите заданием «Запрос на реле». |
| Действие (on) | 1 — включить, 0 — выключить. | Для открытия замка, запуска насоса — 1. |
| Время импульса (time) | Сколько канал будет включён при импульсной команде. | Единицы — как у платы: подберите заданием «Запрос на реле», засекая время. Не оставляйте 0 при импульсе: канал может остаться включённым. При постоянном включении обязательно добавьте в конце сценария действие выключения. |
| Количество импульсов, Таймаут между импульсами | — | Текущей версией приложения не используются. Нужно несколько импульсов — сделайте несколько действий подряд с паузой ПОСЛЕ. |
| Таймаут ПОСЛЕ выполнения команды (сек) | Пауза после команды, до следующего действия. | Выполняется всегда, даже при «Отсутствии команды». Обычно равна времени работы механизма: 5 для шлагбаума, время налива для дозатора. |
Все таймауты в сценарии — целые секунды. Импульс короче секунды задаётся «Временем импульса», а не паузами.
Все значения «Действие при неуспешном условии»
| Значение | Что делает терминал | Когда выбирать |
|---|---|---|
| Выход из сценария | Сразу завершает сценарий как неудачный: экран ошибки, при некоторых видах банковского ПО — автоматический возврат. | Обязательная проверка не прошла: реле не включилось. |
| Повтор текущего действия | Ждёт «Таймаут при неуспешном выполнении условия» и проверяет снова — до выполнения условия или до конца «Таймаута шага». | Ожидание события: «ждать, пока закроют дверь». Обязательно задайте «Таймаут шага». |
| Повтор текущего шага | Заново показывает экран шага и продолжает с этого же действия; отсчёт «Таймаута шага» начинается сначала. | Редко. Время шага каждый раз обнуляется, поэтому ожидание может стать бесконечным. Обычно лучше «Повтор текущего действия». |
| Переход к следующему действию | Пропускает команду этого действия, идёт к следующему. | Необязательная команда. |
| Переход к следующему шагу | Работает как выполненное условие: выполняет команду и идёт к следующему действию этого же шага. | Не выбирайте для ожидания: терминал не будет ждать. Чтобы перейти дальше без команды, используйте «Переход к следующему действию». |
«Показ главного экрана»: когда пригодится
Команда возвращает на терминал главный экран, а сценарий продолжает выполняться в фоне. Так покупатель может не ждать окончания долгой услуги. Работает только в действии с условием «Не задано», только в «Витрине» и «Управлении реле» и только вместе с «Порядковым номером экрана» = 2 (иначе платёж регистрируется после конца сценария, а терминал уже ушёл с его экрана). В «POS-точке с реле» команда не действует.
Создать сценарий с нуля
- Опишите сценарий словами на бумаге: что включить, на сколько, чего ждать, что показать. Каждый новый экран для покупателя — отдельный шаг; каждая команда или ожидание — отдельное действие.
- Проверьте канал. Плата заведена в Оборудовании и привязана к точке, конфигурация назначена точке. Отправьте задание Запрос на реле с номером канала и подберите «Тип команды» и «Время импульса», при которых механизм срабатывает как нужно. Эти значения перенесёте в сценарий. Для «POS-точки с реле» задание не выполняется — временно назначьте точке конфигурацию «Управление реле» или проверяйте сразу покупкой.
- Создайте сценарий. Точки обслуживания → Конфигурации → ≡ → Изменить → вкладка Настройка шагов → Добавить новый сценарий и понятное название. В «Витрине» — сохраните конфигурацию, откройте снова и сразу переходите к шагам.
- Добавьте шаги. Добавить новую страницу столько раз, сколько экранов в сценарии. В шагах с ожиданием заполните «Таймаут шага» и «Действие по таймауту».
- Добавьте действия. В каждом шаге Добавить новое действие: для команды — условие «Не задано» и «Запрос на реле» с подобранными значениями; для ожидания — условие, «Повтор текущего действия», таймаут 1 и «Отсутствие команды».
- Оформите экраны шагов. Вкладка Интерфейс → блок Реле … → Страница (шаг) N: «Текст 1», «Текст 2», цвета. Цвета не стирайте.
- Выберите порядок «реле — чек»: «Последний экран» → «Порядковый номер экрана» (0 или 2, см. выше).
- Свяжите сценарий с кнопкой или товаром — по правилам вашего типа конфигурации (см. особенности типа ниже в этой статье).
- Сохраните конфигурацию и отправьте на точку задание Обновление конфигурации — Задания.
Пример: платный туалет с датчиком двери
Работает в «Витрине» и «Управлении реле» (в «POS-точке с реле» условия по датчикам не используются). Замок подключён к первому каналу платы (номер 0), геркон — к первому входу (номер 0). О и З — значения входа при открытой и закрытой двери, определите их по веб-интерфейсу платы.
| Шаг / действие | Условие | При неуспешном условии | При успешном условии |
|---|---|---|---|
| Шаг 1 — Таймаут шага 60, Действие по таймауту «Выход из сценария». Экран: «Дверь открыта» / «Входите» | |||
| 1. Открыть замок | Не задано | — | Запрос на реле: Номер реле 0, Тип команды — импульс*, Действие 1, Время импульса — подобранное* |
| 2. Ждать открытия | Значение датчика: номер 0, значение О | Повтор текущего действия, таймаут 1 | Отсутствие команды |
| Шаг 2 — Таймаут шага 1800, Действие по таймауту «Считать условие выполненным». Экран: «Занято» / «Подождите, пожалуйста» | |||
| 1. Вошёл и закрыл | Значение датчика: номер 0, значение З | Повтор текущего действия, таймаут 1 | Отсутствие команды |
| 2. Открыл, выходит | Значение датчика: номер 0, значение О | Повтор текущего действия, таймаут 1 | Отсутствие команды |
| 3. Закрыл, свободно | Значение датчика: номер 0, значение З | Повтор текущего действия, таймаут 1 | Отсутствие команды |
* Код импульсного режима и единицы времени — по документации платы; подберите заданием «Запрос на реле».
Для такой услуги удобен «Порядковый номер экрана» = 2: покупатель сразу получает чек, а «Занято» держится весь сеанс.
Типовые сценарии
| Задача | Шаги и действия | Таймауты и порядок |
|---|---|---|
| Шлагбаум, турникет — один импульс | 1 шаг, 1 действие: «Не задано» → «Запрос на реле»: канал входа «Открыть» контроллера, импульс*, Действие 1. Экран: «Проезжайте». | Таймаут шага пусто. «Таймаут ПОСЛЕ» 5 — экран держится, пока шлагбаум поднимается. Порядок 0. |
| Шлагбаум с проверкой срабатывания | То же + действие 2: «Значение реле» канал = 1, при неуспехе «Повтор текущего действия» с таймаутом 1, «Отсутствие команды». Импульс должен длиться дольше проверки. | Таймаут шага 5, по таймауту «Выход из сценария». Порядок 0: если реле не включилось, оплата закончится экраном ошибки. |
| Дверь с герконом (холодильник, шкаф) | Шаг 1 «Дверь открыта — заберите товар»: открыть замок (импульс*). Шаг 2 «Закройте дверь»: «Значение датчика» вход = З, «Повтор текущего действия», таймаут 1, «Отсутствие команды». | Шаг 2: Таймаут шага 300, по таймауту «Считать условие выполненным» — через 5 минут терминал вернётся к работе, даже если дверь не закрыли. |
| Дозатор на N каналов (разлив химии, воды) | На каждый продукт свой сценарий: 1 шаг, 1 действие — «Запрос на реле» на канал насоса, импульс* длительностью налива порции. Экран: «Идёт налив, не убирайте тару». Остальные — через «Копировать сценарий» со сменой «Номера реле». | «Таймаут ПОСЛЕ» = время налива (например, 20), чтобы экран держался до конца. Объём 0,5 и 1 л одного продукта — два сценария на один канал с разным временем. |
| Клапан + насос | 1 шаг: действие 1 — включить клапан (постоянно*, Действие 1); действие 2 — импульс насоса*; действие 3 — выключить клапан (Действие 0). | «Таймаут ПОСЛЕ» действия 2 = время работы насоса. Без действия 3 клапан останется открытым. |
| Пружинный автомат | На каждую ячейку свой канал и свой сценарий: 1 шаг, 1 действие — импульс* на мотор спирали, время — на один оборот. Экран: «Заберите товар». | «Таймаут ПОСЛЕ» 3–5. Отладьте время на одной ячейке, затем размножьте копированием. Каналов не хватает — вторая плата на ту же точку. |
| Услуга на время (пылесос, мойка ковриков) | Шаг 1: включить канал (постоянно*, Действие 1). Шаг 2 «Идёт работа»: «Отсутствие команды», «Таймаут ПОСЛЕ» = оплаченное время в секундах. Шаг 3: выключить канал (Действие 0). | Порядок 2: чек сразу. Условий нет — «Таймаут шага» можно не заполнять. |
* «Импульс», «постоянно» — коды режимов «Тип команды» вашей платы; подберите заданием «Запрос на реле».
Проверка перед запуском
- Канал. Задание Запрос на реле с теми же номером, типом, действием и временем, что в сценарии: статус «Завершена», механизм сработал. Значения по умолчанию (все 0) для проверки не подходят.
- Датчики. В веб-интерфейсе платы откройте и закройте дверь: значения входа совпадают с теми, что вписаны в условия.
- Экраны. На вкладке «Интерфейс» у каждого шага заполнены цвета фона и шрифта (#RRGGBB) и тексты.
- Связь. У каждой кнопки или товара выбраны и плата, и сценарий.
- Ожидания. В каждом шаге с условием заполнены «Таймаут шага» и «Действие по таймауту»; в «Действии при неуспешном условии» ожиданий стоит «Повтор текущего действия».
- Тестовая оплата без денег. В точке временно выберите «Вид банковского ПО» = «Эмулятор» (Способы оплаты), отправьте «Обновление конфигурации» и пройдите каждую кнопку или товар. Если включена фискализация безналичных операций, эмулятор тоже сформирует чек — учтите это.
- Неудачный путь. Не открывайте дверь, держите её открытой: сценарий должен закончиться так, как вы задумали, а терминал — вернуться к работе.
- Боевая оплата. Верните настоящее банковское ПО, отправьте «Обновление конфигурации», оплатите минимальную сумму и проверьте платёж в Платежах.
Не работает: почему и что сделать
| Что видно | Почему | Что сделать |
|---|---|---|
| Сразу после оплаты — экран ошибки, механизм не дождался | Условие не выполнилось с первой проверки, а «Таймаут шага» пустой или 0 и «Действие по таймауту» — «Выход из сценария» (так у нового шага) | Задайте «Таймаут шага» с запасом; проверьте номер и значение датчика или реле в условии. |
| Ожидание «проскакивает»: терминал не ждёт двери | В «Действии при неуспешном условии» выбрано «Переход к следующему шагу» (работает как выполненное условие) или «Переход к следующему действию»; время шага израсходовано паузами или предыдущим ожиданием | Для ожидания — «Повтор текущего действия» с таймаутом 1. Разные ожидания — в разные шаги; учтите паузы ДО и ПОСЛЕ в «Таймауте шага». |
| Дверь закрыта, а шаг всё ждёт | Не тот номер входа или ожидаемое значение; плата не отвечает | Сверьте значения в веб-интерфейсе платы; отправьте «Запрос на реле». Всплывающее на терминале сообщение об ошибке соединения — сетевая причина: Сеть терминала. |
| «Занято» висит бесконечно, терминал не принимает оплату | «Повтор текущего шага» обнуляет время шага; очень большой «Таймаут шага»; датчик неисправен | Замените на «Повтор текущего действия», задайте разумный лимит и «Действие по таймауту» = «Считать условие выполненным». Срочно — задание «Перезагрузка». |
| После оплаты терминал вернулся к кнопкам или остался на пустом экране, реле не сработало | Пустой или неверный цвет на экране шага; у кнопки или товара не выбран сценарий (или он удалён) | Заполните цвета в формате #RRGGBB; выберите сценарий; «Обновление конфигурации». Проверьте платёж в Платежах. |
| Срабатывает соседний канал | Нумерация каналов платы начинается с 0 | Измените «Номер реле» на 1, проверьте заданием. |
| Реле включилось и не выключается | Постоянное включение без действия выключения; «Время импульса» 0 | Добавьте действие с «Действием (on)» = 0 или задайте время импульса. Выключить сейчас — «Запрос на реле» со значением 0. |
| Замок щёлкает слишком коротко или долго | Не те единицы или код режима «Тип команды» | Подберите «Тип команды» и «Время импульса» заданием «Запрос на реле». |
| Экран шага мелькает и сразу сменяется | В шаге нет действий или все действия без пауз | Добавьте действие или «Таймаут ПОСЛЕ» нужной длины. |
| Оплата прошла, чек есть, механизм не сработал | Плата недоступна по сети, а проверки срабатывания в сценарии нет — терминал считает сценарий успешным | Добавьте после команды проверку «Значение реле» = 1 (см. «Шлагбаум с проверкой срабатывания» в типовых сценариях); наладьте сеть — статические адреса, Wi-Fi или Ethernet, а не только SIM. |
| Платёж в ЛК появляется только через полчаса | Порядок 0: платёж регистрируется после конца сценария | Для долгих сеансов поставьте «Порядковый номер экрана» = 2 (кроме «POS-точки с реле»). |
| Поменяли сценарий — терминал работает по-старому | Терминал не получил новую конфигурацию | Задание «Обновление конфигурации». |
Не нашли причину — оставьте заявку на странице поддержки или позвоните 8 (800) 33 33 175 (рабочие дни, 7:00–18:00 МСК). Укажите точку, время операции, кнопку или товар и что видел покупатель.
Особенности сценария в «Витрине»
| Что | Как в «Витрине» |
|---|---|
| Сколько сценариев | Один, без названия. Кнопок «Добавить новый сценарий» и «Копировать сценарий» нет. |
| Когда появляется | После первого сохранения конфигурации. Нажмите Сохранить, откройте конфигурацию снова (≡ → Изменить) — на вкладке «Настройка шагов» появится Добавить новую страницу, а на вкладке «Интерфейс» — блок Реле. |
| Что запускает сценарий | Любая кнопка главного экрана (коды ячеек 1–5). Все кнопки открывают одно и то же: разные цены («Туалет 50 ₽», «Душ 150 ₽») — одна дверь. Связывать кнопку со сценарием не нужно, колонок «Реле» и «Сценарий» в планограмме нет. |
| На какую плату идут команды | На релейную плату, привязанную к точке (вкладка «Оборудование» карточки точки). Держите на точке витрины одну плату: если их несколько, используется последняя в списке. Поэтому одна конфигурация «Витрины» подходит для нескольких точек — у каждой своя плата. |
| Экраны шагов | Интерфейс → Реле → Страница (шаг) N. У каждого шага свой экран. |
| Условия по датчикам и реле | Работают: так делаются ожидание закрытия двери и экран «Занято». |
| Карта сотрудника | Если в точке включён «Доступ по карте сотрудника», после проверки карты выполняется тот же сценарий без оплаты. |
| Ручное открытие | Задание «Запрос на реле» выполняется на плате точки сразу — удобно, если посетитель оплатил, а дверь не открылась. |
Нужно, чтобы разные кнопки открывали разные двери или ячейки, — это уже не «Витрина», а «Управление реле»: там у каждой кнопки свой сценарий и своя плата.
Пример: холодильник с замком и датчиком двери
Замок — канал 0, геркон — вход 0. Покупатель платит за доступ, забирает товар, закрывает дверь. «Порядковый номер экрана» = 0: экран с чеком появится после закрытия двери.
| Шаг / действие | Условие | При неуспешном условии | При успешном условии |
|---|---|---|---|
| Шаг 1 — Таймаут шага пусто. Экран: «Дверь открыта» / «Заберите товар» | |||
| 1. Открыть замок | Не задано | — | Запрос на реле: Номер реле 0, Тип команды — импульс*, Действие 1, Время импульса — подобранное*; Таймаут ПОСЛЕ 3 |
| Шаг 2 — Таймаут шага 300, Действие по таймауту «Считать условие выполненным». Экран: «Пожалуйста, закройте дверь» | |||
| 1. Ждать закрытия | Значение датчика: номер 0, значение З | Повтор текущего действия, таймаут 1 | Отсутствие команды |
Если дверь не закроют за 5 минут, терминал всё равно завершит сценарий и снова начнёт принимать оплату.
Пример: душ на 15 минут без датчиков, с табло «Занято»
Замок — канал 0, табло «Занято» — канал 1. «Порядковый номер экрана» = 2: чек сразу, потом сеанс.
| Шаг / действие | Условие | При успешном условии | Паузы |
|---|---|---|---|
| Шаг 1 — экран «Дверь открыта» / «Входите» | |||
| 1. Открыть замок | Не задано | Запрос на реле: Номер реле 0, импульс*, Действие 1 | — |
| 2. Включить табло | Не задано | Запрос на реле: Номер реле 1, постоянно*, Действие 1 | ПОСЛЕ 5 |
| Шаг 2 — экран «Занято» / «Подождите, пожалуйста» | |||
| 1. Сеанс | Не задано | Отсутствие команды | ПОСЛЕ 900 |
| 2. Выключить табло | Не задано | Запрос на реле: Номер реле 1, постоянно*, Действие 0 | — |
Условий нет, поэтому «Таймаут шага» не заполняется. «Занято» снимается по времени, а не по факту выхода; чтобы освобождать по двери, используйте пример с датчиком выше в этой статье.
* «Импульс», «постоянно» — коды режимов «Тип команды» вашей платы, время — в её единицах; подберите заданием «Запрос на реле».
Геркон и «Занято»: три варианта сценария
Терминал не следит за дверью сам: всё, что связано с «занято/свободно», задаётся шагами сценария. Выберите вариант по оборудованию.
| Вариант | Как устроен | Плюсы и минусы |
|---|---|---|
| Без датчиков (по времени) | Шаг 1: команда «открыть замок на N секунд». Шаг 2 «Занято»: действие без условия и без команды с «Таймаутом ПОСЛЕ» = длительность сеанса. | Просто, геркон не нужен. Но «Занято» снимается по времени, а не по факту выхода. |
| Слушает реле | После команды открытия действие с условием «Значение реле»: канал замка = 0 (выключился), «Повтор текущего действия». Сценарий завершается, только когда плата сообщила, что замок снова закрыт. | Защищает от новой оплаты, пока замок открыт. Факт выхода человека не отслеживается. Значение «выключено» не отличить от платы, которая не ответила, поэтому это только пауза на время работы замка, а не подтверждение. |
| С герконом | Условия «Значение датчика»: ждать открытия двери (вошёл), закрытия (внутри — «Занято»), открытия (выходит), закрытия (свободно). | «Занято» точно соответствует помещению. Нужен геркон и правильно выбранные значения входа. |
Дополнительно в любой вариант можно добавить команды на другие каналы платы: включить табло «Занято» или свет в кабине в начале сеанса (постоянное включение, «Действие» 1) и выключить в конце («Действие» 0). Код режима «Тип команды» — по документации платы, подберите заданием «Запрос на реле».
У шага ожидания всегда ставьте ограничение — «Таймаут шага» и «Действие по таймауту». Если датчик сломается или дверь останется приоткрытой, без ограничения терминал будет показывать «Занято» бесконечно и не примет ни одной оплаты.
Оборудование и сеть
- Подключите к релейной плате замок (через выход реле), геркон (ко входу платы) и питание. Кнопку выхода изнутри подключите к замку напрямую — дверь должна открываться изнутри даже при выключенном терминале.
- Подключите плату к роутеру объекта, задайте ей статический IP-адрес и пароль управления — по инструкции к плате. Заводской пароль обязательно смените.
- Подключите терминал к той же сети по Wi-Fi или Ethernet и тоже задайте статический адрес — Сеть терминала. Пример: роутер 192.168.1.1, терминал 192.168.1.50, плата 192.168.1.60.
- Заведите плату в ЛК: Оборудование → Список оборудования → Добавить, тип «Релейная плата», модель, серийный номер; на вкладке «Настройки» — «IP Адрес», «Порт HTTP» (обычно 80), «Пароль». Модель платы и схему подключения лучше заранее согласовать с поддержкой JustPay.
- Привяжите плату к точке: карточка точки → вкладка Оборудование → выберите плату → Добавить → Применить.
При запуске приложения терминал получает вместе с конфигурацией адрес, порт и пароль релейной платы своей точки. Для «Витрины» используется плата, привязанная к точке; если плат несколько — последняя в списке, поэтому держите на точке витрины одну плату. При привязке в точку копируются настройки платы: если позже изменить IP-адрес в карточке оборудования, терминал об этом не узнает — правьте значение карандашом на вкладке «Оборудование» точки. После любой правки отправьте «Обновление конфигурации».
Подробно о карточке платы и привязке — Оборудование.
Точка: способы оплаты и конфигурация
| Способ | Для витрины и платного входа |
|---|---|
| Оплата банковской картой + Включить сверку | Включить. Выбрать банковское ПО, установленное на терминале; задать время сверки. |
| Включить СБП + Профиль СБП | Включить. СБП подключаем для расчётного счёта в любом банке — СБП. |
| Включить наличные | Не включать. Терминал не принимает купюры: кнопка «Наличные» засчитывает оплату без фактического получения денег и сразу запускает сценарий реле. Этот способ — только для точек, где деньги принимает сотрудник. |
| Доступ по карте сотрудника | По желанию — для уборщиков и персонала. На экране выбора способа оплаты появится кнопка «Карта сотрудника»; после проверки карты выполняется тот же сценарий реле без оплаты. В списке платежей появляется запись на 0 ₽ со статусом «Отозван» и пояснением «Вход по карте …». Подробно — Доступ по карте сотрудника. |
| QR-стикер для пожертвований, витрин и POS точки с реле | См. следующий раздел. |
Конфигурация назначается на вкладке «Основное» карточки точки — Точки обслуживания. Терминал привязывается к точке PIN-токеном — Токен и PIN-токен.
Эмулятор — только для проверки. При виде банковского ПО «Эмулятор» замок открывается без списания денег. Перед запуском замените его на реальное банковское ПО и отправьте «Обновление конфигурации».
QR-стикер
QR-стикер — наклейка с постоянным QR-кодом: покупатель платит по СБП со своего телефона на веб-странице точки. Включается в точке флажком Включить QR стикер для пожертвований, витрин и POS точки с реле, поле Использование реле = «С реле»; ссылка и картинка для печати — на вкладке точки QR код для пожертвований и витрин.
- Команду на реле при оплате по стикеру отправляет не терминал, а сервер JustPay через интернет. Поэтому плату дополнительно подключают к облачному сервису JustPay — это настраивает поддержка.
- Страница стикера берёт релейную плату и сценарий из колонок «Реле» и «Сценарий» строки планограммы. У «Витрины» этих колонок нет, поэтому для двери, которая должна открываться по стикеру, используйте конфигурацию «Управление реле».
- Стикер дополняет терминал, а не заменяет его: кнопки на терминале работают как обычно.
Печать, размещение, тексты оферты на странице — QR-стикеры. Согласуйте подключение стикера с открытием двери с поддержкой JustPay до печати наклеек.
Пошагово: платный туалет с герконом
Исходные данные примера: замок — первый канал платы (номер 0), геркон — первый вход (номер 0), цена 50 ₽, оплата картой и СБП. Значения входа обозначены З (дверь закрыта) и О (дверь открыта) — определите их по веб-интерфейсу платы.
- Номенклатура. Создайте позицию «Посещение туалета», цена 50, нужная ставка НДС — Номенклатура.
- Оборудование. Заведите релейную плату с IP-адресом, портом и паролем, привяжите к точке (раздел выше).
- Конфигурация. «Добавить» → тип «Витрина», название «Туалет — с герконом», организация.
- Планограмма. Строка: код 1, тип «Услуга», товар «Посещение туалета», стоимость (безналичные) 50.
- Настройки. «Тип первого экрана» — «Стандартный режим»; «Таймаут показа чека» — 10; остальное по умолчанию.
- Интерфейс → Первый экран. «Текст 1» — «Платный туалет», «Текст 2» — «Оплата картой или по QR». В подблоке «Номер ячейки 1» — «Текст на кнопке» = «Сумма» (на кнопке будет «50 руб.»).
- Интерфейс → Последний экран. «Порядковый номер экрана» — 2, «Отображать QR» — включить.
- Сохранить → снова открыть через «≡ → Изменить».
- Настройка шагов. Добавьте два шага по примеру «Платный туалет».
- Интерфейс → Реле. Шаг 1: «Текст 1» — «Дверь открыта», «Текст 2» — «Входите». Шаг 2: «Текст 1» — «Занято», «Текст 2» — «Подождите, пожалуйста».
- Точка. Способы оплаты: карта и СБП, наличные выключены. Назначьте конфигурацию. «Применить».
- Терминал. Отправьте задание «Обновление конфигурации» — Задания.
- Проверка — см. «Проверка перед запуском».
Значения шагов и действий — в примере «Платный туалет с датчиком двери» выше: после оплаты терминал показывает экран с QR-кодом чека, открывает замок и ждёт, пока посетитель откроет дверь (не открыл за 60 секунд — сценарий завершается); дальше на экране «Занято», пока посетитель не выйдет и дверь не закроется, но не дольше 30 минут. Табло или свет «Занято» добавляются командами на другой канал — как в примере с душем.
Пример: холодильник-витрина
- Планограмма: до пяти ценовых категорий, например код 1 — «Всё по 349 ₽», код 2 — «Всё по 549 ₽», тип «Товар». Если категории в разных отсеках с разными замками, нужен тип «Управление реле».
- Сценарий: как в примере «Холодильник с замком и датчиком двери»: открыть замок, затем ждать закрытия двери не дольше 5 минут.
- Порядок экранов: «Порядковый номер экрана» 0 — экран с QR-кодом чека появится после закрытия двери.
- Учёт: покупатель платит за доступ к категории; что именно он взял, система не знает. Остатки сверяйте при пополнении.
Пошаговая настройка на примере
Ниже — два настоящих примера с реальными экранами личного кабинета и терминала: платный вход (в том числе туалет или душ с экраном «Занято») и витрина продаж (ценовые категории или выбор количества). Цвета, размеры шрифтов и картинок на снимках — пример: подбирайте их под свой объект и экран терминала. Шаги и действия сценария реле здесь не повторяются — они описаны в разделе «Как настроить сценарий реле».
Перед началом заведите в Номенклатуре (раздел «Товароучёт») позиции для кнопок: для входа — с типом «Услуга» («Услуга платный туалет», «Услуга платный душ»), для витрины — с типом «Товар» («Всё по 249», «Напиток безалкогольный»). Без них в планограмме нечего будет выбрать. Во время настройки периодически нажимайте Применить — так введённое не потеряется.
Вариант 1. Платный вход, туалет, душ
Как это работает у покупателя: на главном экране цена и кнопка → оплата → экран «Откройте дверь» (шаг 1 сценария) → для туалета и душа — экран «Занято», пока помещение занято (шаг 2) → экран с QR-кодом чека → снова главный экран.
Шаг 1. Общие данные
- Точки обслуживания → Конфигурации → Добавить.
- Тип конфигурации — «Витрина» (список раскрывается значком ▼ в конце строки); Название — понятное, например «Платный туалет ТЦ»; Описание — «Туалет на 2-м этаже»; Наименование клиента — ваша организация из списка.
- Сохранить, затем найдите конфигурацию в списке (обычно первая) и откройте: ≡ → Изменить.
Шаг 2. Планограмма
По строке на каждую кнопку: «Туалет — 50 ₽», «Душ — 100 ₽», «Комната матери и ребёнка — 50 ₽» (не больше пяти). Все кнопки открывают одну и ту же дверь.
| Колонка | Рекомендуемое значение |
|---|---|
| Код ячейки | 1, 2, 3… подряд, не больше 5. |
| Тип | «Услуга» — колонка «Количество» станет неактивной, один проход = одна оплата. |
| Товар (Поиск товара) | Позиция из номенклатуры, например «Услуга платный туалет». |
| Ставка НДС | Подставляется из номенклатуры. |
| Стоимость (безналичные) | Цена прохода. Не ставьте 0: кнопка со стоимостью 0 позволяет ввести свою сумму. |
Шаг 3. Настройки
| Поле | Значение |
|---|---|
| Сервер, Порт | https://lk.justpay.pro и 443 — не меняйте. |
| Тип цены | «Брать из номенклатуры» (на «Витрину» не влияет). |
| Тип первого экрана | «Стандартный режим». |
| Тип экрана оплаты | Можно не менять: экран выбора между картой и СБП терминал покажет сам, если в точке включено больше одного способа оплаты. |
| Таймаут показа чека (сек) | 10–15: покупатель успеет отсканировать QR-код чека. |
| Таймаут ожидания фискализации (сек) | 5–10. |
| Таймаут оплаты по карте / по СБП (сек) | 100–150, например 150. |
| Фискализация безналичных операций | Оставить включённой — чеки на оплаты картой и по СБП. |
| Фискализация наличных операций | Можно снять: наличные на платном входе не включают. |
| Тип экрана при сканировании Цифрового ID MAX | Не трогать. |
«Таймаут главного экрана» и «Таймаут выбора товара» «Витрина» не использует — их можно не заполнять (подробно — таблица вкладки «Настройки» в разделе «Создание конфигурации» выше).
Шаг 4. Интерфейс: первый экран
На вкладке Интерфейс настраиваются «Первый экран», «Экран ошибки», «Последний экран» и «Реле». Блоки «Экран выбора способа оплаты», «Универсальный экран», «Экран чтение карты доступа» и «Экран чтение карты доступа + оплата» для этого примера оставьте как есть.
Первый экран оформляют одним из двух способов.
| Поле | Способ 1 — логотип и тексты | Способ 2 — готовая картинка |
|---|---|---|
| Порядковый номер экрана | 0 | 0 |
| Цвет фона | Любой, в формате #RRGGBB | Точно как фон картинки |
| Цвет тулбара | Очистить — верхней полосы не будет | Очистить |
| Логотип, ширина и высота | Логотип или значок услуги, например 310×310 или 200×200 | Картинка с текстом, сделанная заранее; размер под экран — для «Салют 3В Лайт» 450×620 |
| Текст 1 | Название: «ВХОД ПЛАТНЫЙ», размер 40, цвет #000000 | Размер шрифта 0 — текст не выводится (он уже на картинке) |
| Текст 2 | Подсказка: «Для оплаты нажмите на кнопку», размер 32 | Размер шрифта 0 |
| Номер ячейки N | «Текст на кнопке» — «Сумма» (на кнопке «100 руб.»); радиус, шрифт и цвета кнопки — по вкусу | |
Результат на терминале:
Флажок Изображение - во весь экран на главный экран «Витрины» не влияет — для «графического» экрана используйте способ 2 с размерами картинки.
Шаг 5. Экран ошибки и последний экран
- Экран ошибки — «Порядковый номер экрана» 0, цвет фона, тулбар очистить, иконка «!» или крестик с размерами, «Текст 1» — «Операция отменена», «Текст 2» (по желанию) — «Попробуйте ещё раз». Цвета шрифтов — #RRGGBB.
- Последний экран — главное: флажок Отображать QR. Логотип обычно не ставят — тогда на экране QR-код чека и тексты: «Текст 1» над кодом («Для получения чека»), «Текст 2» — пояснение, обычно размер 0 (скрыт), «Текст 3» под кодом («Отсканируйте QR-код»).
- «Порядковый номер экрана» последнего экрана: 0 — чек после сценария реле, 2 — чек сразу после оплаты. Для туалета и душа удобнее 2 — почему, см. «Что раньше: реле или экран результата».
Шаг 6. Экраны после оплаты (блок «Реле»)
Сохраните конфигурацию и откройте снова — появятся вкладка «Настройка шагов» со сценарием и блок Реле на «Интерфейсе». Для платного входа достаточно одного шага, для туалета и душа нужны два: «Откройте дверь» и «Занято». Сами действия шагов (открыть замок, ждать датчик двери) настройте по примеру «Платный туалет с датчиком двери».
| Поле | Страница (шаг) 1 — «Доступ разрешён» | Страница (шаг) 2 — «Занято» |
|---|---|---|
| Цвет фона | #FFFFFF | #FFFFFF |
| Цвет тулбара | Очистить | Очистить |
| Логотип | Зелёная галочка, 350×350 | Знак «вход запрещён», 400×400 |
| Изображение - во весь экран | Выключено | Выключено |
| Текст 1 (над картинкой) | «ОТКРОЙТЕ ДВЕРЬ» или «ПРОХОДИТЕ», размер 46, #000000 | «ПОЖАЛУЙСТА ОЖИДАЙТЕ», размер 40, #000000 |
| Текст 2 (под картинкой) | «ОПЛАЧЕНО», размер 44, #000000 | «ЗАНЯТО», размер 60, #000000 |
| Кнопки | На экране шага кнопка не выводится — значения по умолчанию не трогайте. | |
Результат на терминале:
Цвета фона и шрифта у шагов не стирайте: без них экран шага не построится и замок после оплаты не откроется.
Шаг 7. Точка и терминал
Привяжите к точке релейную плату и конфигурацию, включите карту и СБП (наличные — нет) — разделы «Оборудование и сеть» и «Точка». Затем отправьте на терминал задание Обновление конфигурации — без него изменения на терминале не появятся (Задания) — и пройдите проверку перед запуском.
Вариант 2. Витрина продаж
Терминал работает как касса и контроллер замков витрины: покупатель выбирает кнопку, платит, дверь открывается, он забирает товар и закрывает дверь, терминал показывает QR-код чека. Шаги «Общие данные» и «Настройки» — как в варианте 1 (тип «Витрина», название вроде «Вендинг с игрушками», описание «Выбор из 5 ценовых категорий»). Различаются планограмма, кнопки первого экрана и тексты шагов.
Планограмма: ценовые категории
Покупатель платит за доступ к полке одной цены и забирает один товар: «Всё по 249», «Всё по 549»… Тип — «Товар», количество — 1, цена — в «Стоимости (безналичные)».
На главном экране «Витрины» не больше пяти кнопок (коды ячеек 1–5). Нужно больше позиций, пружинная выдача или своя дверца на каждую позицию — используйте «Управление реле».
Планограмма: выбор количества
Для витрины с одним товаром (например, лимонадом), где покупатель берёт столько штук, сколько оплатил:
- Во всех строках — один и тот же товар и одна цена за единицу (в примере 109).
- «Количество» в строках — 1, 2, 3, 4: на кнопках будет «1 шт.», «2 шт.»…, сумма = цена × количество.
- Последняя строка — «Количество» 0 при той же цене: это кнопка ввода количества вручную.
- На «Интерфейсе» в каждом подблоке «Номер ячейки N» — Текст на кнопке = «Количество». В последней ячейке заполните Текст кнопки для свободного ввода, например «ВВЕСТИ КОЛИЧЕСТВО» (пусто — на кнопке будет «Свое значение»).
Если у кнопки оставить «Текст на кнопке» = «Сумма», «Количество» из планограммы не учитывается: терминал продаст 1 штуку. Для ценовых категорий так и нужно — оставьте «Сумма» и пустой «Текст кнопки для свободного ввода».
Первый экран
Оформляется так же, как в варианте 1 (способ 1 или 2). В примере: фон #ffffff, логотип 550×300, «Текст 1» — «Оплата товара» (размер 36, #4B0082), «Текст 2» — подсказка (размер 24). Разделы «Кнопки» и «Кнопки не активные» оставьте по умолчанию — кнопки «Витрины» оформляются в подблоках «Номер ячейки N»: радиус, размер и цвет шрифта, цвет фона, «Текст на кнопке».
Экраны после оплаты
| Поле | Страница (шаг) 1 — «Откройте дверь. Заберите товар» | Страница (шаг) 2 — «Пожалуйста, закройте дверь» |
|---|---|---|
| Цвет фона, тулбар | #ffffff, тулбар очистить | #ffffff, тулбар очистить |
| Логотип | Открытый замок, 300×200 | Закрытый замок, 300×200 |
| Текст 1 | «ОТКРОЙТЕ ДВЕРЬ», размер 36, #4C4E65 | «ПОЖАЛУЙСТА», размер 36, #4C4E65 |
| Текст 2 | «ЗАБЕРИТЕ ТОВАР», размер 24, #4C4E65 | «ЗАКРОЙТЕ ДВЕРЬ», размер 24, #4C4E65 |
Для витрины с напитками текст шага 1 может быть таким: «Оплата прошла. Двери открыты. Заберите ваш напиток». Действия шагов — открыть замок, затем ждать закрытия двери не дольше 5 минут — как в примере «Холодильник с замком и датчиком двери». «Порядковый номер экрана» последнего экрана — 0: QR-код чека появится после закрытия двери.
Результат на терминале:
После настройки — «Обновление конфигурации» на терминал и проверка перед запуском.
Проверка перед запуском
- Плата отвечает. Отправьте задание Запрос на реле с теми же значениями, что в шаге открытия (номер реле, тип команды, действие, время импульса). Статус «Завершена» и щелчок замка — связь есть. «Ошибка» — плата недоступна по сети или неверный адрес. Не отправляйте задание со значениями по умолчанию (все 0).
- Сценарий без денег. Временно выберите в точке банковское ПО «Эмулятор», отправьте «Обновление конфигурации» и пройдите сценарий целиком: оплата → дверь → «Занято» → свободно.
- Реальная оплата. Верните банковское ПО, отправьте «Обновление конфигурации», оплатите минимальную сумму картой и по СБП.
- Проверьте ЛК: платёж в разделе «Платежи», чек, при необходимости — возврат тестовой оплаты.
Тем же заданием можно открыть дверь удалённо — например, если посетитель оплатил, а дверь не открылась. Для «Витрины» команда уходит на релейную плату точки и выполняется сразу. Подробно — Задания.
Когда изменения дойдут до терминала
| Что изменили | Что отправить на терминал |
|---|---|
| Цены, товар, ставку НДС в строке; тексты и цвета экранов | «Обновление параметров». |
| Добавили или удалили строки, поменяли коды ячеек; изменили шаги сценария; поменяли плату или её адрес на точке | «Обновление конфигурации» — приложение перезапустится и перечитает всё. |
| Способы оплаты точки | По таблице в статье Способы оплаты. |
Терминал забирает задания при сеансе связи с сервером. «Сверку итогов» и «Отмену операции» он выполняет только на главном экране — во время сценария («Занято») они ждут около двух с половиной минут, затем завершаются ошибкой. «Обновление конфигурации» перезапускает приложение сразу, даже посреди сценария: не отправляйте его, пока посетитель внутри или идёт оплата.
Платежи, чеки и возвраты
- Платёж за вход или доступ — обычная операция в разделе Платежные операции → Платежи, в строке чека — название позиции из планограммы — Платежи.
- Когда платёж появляется в ЛК — зависит от «Порядкового номера экрана» и банковского ПО (см. выше).
- Проход по карте сотрудника — запись на 0 ₽ со статусом «Отозван» и номером карты в пояснении. Чек на неё не формируется.
- Возврат, если дверь не открылась, — Возвраты и отмены. Статусы операций — Статусы платежей.
Частые проблемы
| Что происходит | Причина | Что сделать |
|---|---|---|
| Оплата прошла, дверь не открылась | Плата не привязана к точке; неверные IP, порт или пароль в точке; терминал и плата в разных сетях или терминал работает только через SIM; у платы сменился адрес; неверный «Номер реле» или «Тип команды»; не отправлено «Обновление конфигурации». | Проверьте вкладку «Оборудование» точки (карандаш), сеть, статические адреса. Отправьте «Запрос на реле» с параметрами шага. Откройте дверь этим же заданием и при необходимости верните деньги. |
| Оплата прошла, сразу вернулся главный экран, сценарий не выполнялся | У шага очищены цвет фона или цвет шрифта. | Заполните цвета в блоке «Интерфейс → Реле», отправьте «Обновление конфигурации». Проверьте операцию в «Платежах» и при необходимости верните деньги. |
| Оплата прошла, экраны шагов не показывались, замок не сработал, платёж зарегистрирован | В сценарии нет ни одного шага или в шагах нет команды «Запрос на реле». | Настройте шаги на вкладке «Настройка шагов», отправьте «Обновление конфигурации». |
| Нет вкладки шагов или блока «Реле» | Конфигурация ещё не сохранялась. | «Сохранить» → открыть снова через «≡ → Изменить». |
| «Занято» не снимается | Геркон не срабатывает или подключён не к тому входу; ожидается не то значение (перепутаны З и О); дверь не доходит до закрытия; плата недоступна по сети; у шага не задан предел времени. | Посмотрите состояние входа в веб-интерфейсе платы при открытой и закрытой двери, исправьте номер и значение датчика. Задайте «Таймаут шага» и «Действие по таймауту» = «Считать условие выполненным». Чтобы освободить терминал сейчас — убедитесь, что помещение свободно, и отправьте «Обновление конфигурации»: приложение перезапустится и вернётся к кнопкам. |
| Сценарий сразу завершается ошибкой | «Таймаут шага» = 0: при первой неудачной проверке срабатывает «Действие по таймауту» («Выход из сценария»). | Задайте «Таймаут шага», например 60. |
| Дверь остаётся открытой | Постоянное включение канала без последующего выключения; «Время импульса» 0. | Используйте импульсный режим с подобранным временем или добавьте действие выключения канала. Коды «Тип команды» и единицы времени — по документации платы, подберите заданием «Запрос на реле». |
| Замок открывается без оплаты | В точке включены наличные или выбран «Эмулятор». | Снимите «Включить наличные», выберите реальное банковское ПО. |
| Кнопок на экране меньше, чем строк планограммы | Коды вне 1–5, пропуски, строка без товара. | Нумеруйте 1–5 подряд, выберите товар в каждой строке. |
| Сумма к оплате больше цены | У кнопки выбран текст «Количество», а «Количество» больше 1. | Поставьте «Сумма» или «Количество» = 1. |
| Платёж появился в ЛК только через полчаса | «Порядковый номер экрана» не 2 (или оплата через приложение Сбербанка): платёж регистрируется после окончания сценария. | Для долгих сеансов поставьте 2. При приложении Сбербанка это нормальное поведение. |
| Исправили IP платы в разделе «Оборудование» — не помогло | Терминал берёт копию настроек из точки. | Исправьте карандашом на вкладке «Оборудование» точки, отправьте «Обновление конфигурации». |
| Оплата по QR-стикеру не открывает дверь | Стикер с реле работает через облачное подключение платы и конфигурацию «Управление реле». | Обратитесь в поддержку для подключения. |
Не нашли свою ситуацию — Диагностика или поддержка: 8 (800) 33 33 175, заявка /zayavka_help, рабочие дни 7:00–18:00 (МСК).