Не нашли ответ?Поддержка JustPay на связи в рабочие дни с 7:00 до 18:00 (МСК).

Конфигурации

Конфигурация — это сценарий работы терминала: что он продаёт, какие экраны показывает, сколько ждёт оплату, нужно ли пробивать чек. Одну конфигурацию можно назначить сразу многим точкам обслуживания, и все их терминалы будут работать одинаково. В этой статье — общее устройство раздела, все 13 типов, вкладки «Общие данные» и «Настройки», версии, копирование и доставка изменений на терминал.

  • Где: Точки обслуживания → Конфигурации
  • Кому: администратору, технику
  • Действует на: все терминалы точек, которым назначена конфигурация; чеки

Что такое конфигурация и где её место в схеме

В JustPay настройки разделены на три уровня. Место обслуживания — это адрес. Точка обслуживания — конкретный терминал с его банком, способами оплаты, оборудованием и сетью. Конфигурация — сценарий, по которому этот терминал работает.

  1. Место обслуживания: адрес
  2. Точка обслуживания: способы оплаты, оборудование, ККТ
  3. Конфигурация: тип, товары, экраны, таймауты, чек
  4. Терминал
  • Ссылка идёт от точки к конфигурации. В карточке точки на вкладке «Основное» есть поле Конфигурация — в нём выбирается одна конфигурация. В самой конфигурации список точек не хранится.
  • Одна конфигурация — много точек. Десять одинаковых кофейных автоматов или десять касс в сети работают по одной конфигурации. Изменили её — изменения получат все десять терминалов.
  • У точки ровно одна конфигурация. Без конфигурации терминал не запустится.
  • Что в конфигурацию не входит: способы оплаты, банковское ПО, профиль СБП, время сверки — они задаются в точке (Способы оплаты). Адрес и порт релейной платы для витрины берутся из оборудования точки (Оборудование). Справочник товаров — общий для организации (Номенклатура), а конфигурация лишь указывает, какие товары и по какой цене продавать.
Карточка точки, вкладка «Основное»: поле «Конфигурация» со значком перехода
Конфигурация назначается в карточке точки: поле «Конфигурация». Значок слева от поля открывает выбранную конфигурацию
Список конфигураций
Раздел «Конфигурации»: все сценарии вашей организации
Как это влияет на терминал

При запуске приложение терминала обращается к серверу и получает одним пакетом конфигурацию своей точки, способы оплаты этой точки и справочник номенклатуры. По типу конфигурации терминал решает, какой сценарий запустить и какой экран показать первым. Полученная конфигурация сохраняется в памяти терминала: если связи нет, он работает по последней сохранённой.

Типы конфигурации — все 13 значений

Тип — главный выбор: от него зависят набор вкладок в форме, поля на вкладке «Настройки» и сценарий, который запустит терминал. Тип выбирается в поле Тип конфигурации на вкладке «Общие данные». У новой конфигурации по умолчанию стоит «Вендинг».

Раскрытый список «Тип конфигурации»: Вендинг, POS-терминал (прием платежей), Прием платежей, Курьер, Пожертвования, Автомойки…
Список «Тип конфигурации». Прокрутите его, чтобы увидеть все 13 значений
Тип (как в ЛК)Для какого бизнесаВкладки формыЧто делает терминалПодробно
ВендингКофейные, снековые и другие автоматы, подключённые по шине MDBОбщие данные, Планограмма, Настройки, ИнтерфейсЖдёт выбора товара на автомате, принимает оплату, даёт команду на выдачуВендинг
POS-терминал (прием платежей)Терминал у кассира: сумму вводит кассир или передаёт кассовая программаОбщие данные, Настройки, ИнтерфейсПоказывает экран ожидания суммы; в режиме «Служба» принимает запросы от кассовой программыPOS-терминал и касса
Прием платежейОплата начислений и заказов из вашей учётной системы: МФЦ, управляющая компания, CRMОбщие данные, НастройкиПоказывает список начислений (заказов) для этой точки и обновляет его каждые 10 секунд; покупатель выбирает начисление и оплачивает егоОплата услуг и заказов
КурьерОплата заказов при доставкеОбщие данные, НастройкиВ текущей версии приложения терминала отдельного сценария нет. Не выбирайте без указания поддержкиОплата услуг и заказов
ПожертвованияХрамы, фонды, благотворительные ящикиОбщие данные, Планограмма, Настройки, ИнтерфейсПоказывает кнопки с суммами пожертвования и, при настройке, ввод своей суммыПожертвования
АвтомойкиАвтомоечные комплексы, работающие с системой бронирования АМК-ЭкспрессОбщие данные, Настройки, Интерфейс. На «Общих данных» появляется поле «Интеграция»Киоск записи и оплаты брони: «Забронировать» (телефон, авто, услуга, дата и время) или «Оплатить» существующую бронь. Постами мойки и реле не управляет; данные берёт из АМК-Экспресс через интеграцию из поля «Интеграция»Автомойка
ВитринаХолодильник или шкаф с замком, платный туалет, платный входОбщие данные, Планограмма, Настройки, Интерфейс, Настройка шаговПосле оплаты выполняет сценарий реле — открывает замок или дверьВитрина и платный вход
АЗСТопливные колонки самообслуживанияОбщие данные, Планограмма, Настройки, ИнтерфейсВыбор колонки и топлива, оплата, налив; после налива — возврат разницыАЗС
POS-точкаКофейня, микромаркет, касса самообслуживания: каталог и корзинаОбщие данные, Настройки, Интерфейс, Настройка шаговПроводит покупателя по шагам: ввод данных, каталог, корзина, оплатаPOS-точка
Управление релеШлагбаум, турникет, прачечная, любое устройство, которое включается релеОбщие данные, Планограмма, Настройки, Интерфейс, Настройка шаговПоказывает кнопки услуг; после оплаты выполняет сценарий реле выбранной услугиУправление реле
POS-точка с релеУслуги с физической выдачей: у каждой позиции каталога свой сценарий релеОбщие данные, Настройки, Интерфейс, Настройка шаговКаталог и корзина, после оплаты — сценарий реле каждой купленной позицииУправление реле, POS-точка
Яндекс АвтозаправкаАвтомойки, подключённые к сервису Яндекса (несмотря на название, не для топливных колонок)Общие данные, Боксы, Список цен, НастройкиСерверная интеграция: приложение терминала этот тип не обрабатывает, боксы и цены из конфигурации сервер передаёт в сервис ЯндексаАвтомойка, Интеграции
СКУДПропускной режим без оплаты: школы, офисы, общежитияОбщие данные, СКУД, Планограмма, Настройки, Интерфейс, Настройка шаговРаботает как пункт прохода по картам и пропускамПодключается вместе с поддержкой

Вкладки появляются и исчезают сразу при выборе типа, ещё до сохранения. Если на скриншоте в другой статье вкладок больше или меньше, чем у вас, проверьте тип конфигурации.

Конфигурация «Прием платежей»: только вкладки «Общие данные» и «Настройки»
«Прием платежей» и «Курьер» — только две вкладки
Конфигурация «Яндекс Автозаправка»: вкладки Боксы и Список цен, поля Тип мойки, Шаг платежа, Минимальный и Максимальный платеж, флажок Работает
У «Яндекс Автозаправки» свои вкладки и дополнительные поля на «Общих данных»
Конфигурация «Автомойки»: на вкладке «Общие данные» есть поле «Интеграция»
У «Автомоек» на вкладке «Общие данные» появляется поле «Интеграция» — выберите запись из раздела «Интеграции»

Список конфигураций

Откройте Точки обслуживания → Конфигурации. В списке — все конфигурации вашей организации, новые сверху. Внизу — переключатель «Показывать по» (сколько строк на странице), счётчик вида «1–10 из 186» и стрелки перехода по страницам.

Список конфигураций: поиск, кнопки Фильтры, Добавить, Выгрузить, колонки Просмотр, Действия, Номер конфигурации, Тип конфигурации, Название, Описание, Статус
Список конфигураций

Колонки

КолонкаЧто показываетЗачем
ПросмотрЗначок «открыть в новом окне».Открывает конфигурацию в новой вкладке браузера только для чтения: все вкладки видны, кнопок «Сохранить» и «Применить» нет. Удобно сравнивать две конфигурации рядом или показать настройки коллеге без риска что-то изменить.
ДействияЗначок меню ≡.Открывает меню действий со строкой — см. ниже.
Номер конфигурацииСистемный номер, присваивается автоматически при создании и при копировании.Однозначно определяет конфигурацию: названия могут повторяться, номер — нет. Называйте его поддержке.
Тип конфигурацииОдно из 13 значений.Сразу видно, для какого сценария конфигурация.
НазваниеНазвание, заданное на вкладке «Общие данные».Именно его вы видите в поле «Конфигурация» карточки точки.
ОписаниеСвободный комментарий.Подсказка для себя и коллег.
Статус«Активная» (зелёная плашка) или «Архивная» (жёлтая).См. «Статус: активная и архивная».
Дата изменения, Номер версии
скрыты по умолчанию
Дата последнего сохранения и номер версии.Включаются в окне настройки колонок. Полезны, чтобы быстро найти недавно изменённые конфигурации.

Значок справа от кнопки Выгрузить открывает окно настройки колонок: галочками включаются и выключаются колонки, набор сохраняется за вашим пользователем. Подробно — Сводка и работа с таблицами.

Окно настройки колонок таблицы
Окно настройки колонок (пример из другого раздела, устроено одинаково)

Поиск

Введите текст в поле Поиск и нажмите Enter. Поиск идёт по названию и описанию конфигурации (по части слова). Чтобы найти строки, где встречаются оба слова сразу, соедините их знаком «+»: кофе+вокзал. По номеру конфигурации поиск не работает — используйте фильтр «Номер». Крестик в поле очищает поиск.

Фильтры

Кнопка Фильтры открывает окно с условиями. Заполните нужные и нажмите Применить; Закрыть — выйти без изменений. Применённые фильтры показываются над таблицей плашками, крестик на плашке снимает условие.

Окно фильтров конфигураций: Наименование, Номер, Дата создания, Модель, Тип, Статус
Окно «Фильтры»
ФильтрЧто задаётКак работает
НаименованиеТекст из названия.Отбирает конфигурации, в названии которых есть этот текст.
НомерНомер конфигурации.Быстрый способ найти конфигурацию, номер которой назвала поддержка.
Дата созданияУсловие (в выпадающем списке) и дата в поле «Конкретная дата».Отбирает конфигурации, созданные в указанную дату или в период. Копия считается созданной в день копирования.
Модель—Для конфигураций не используется: у конфигурации нет поля «модель». Оставляйте пустым.
ТипОдин из 13 типов.Показывает конфигурации только этого типа.
СтатусАктивные или архивные.Например, скрыть архивные, чтобы не мешали.

Фильтры запоминаются в браузере и остаются при возврате к списку.

Кнопки «Добавить» и «Выгрузить»

  • Добавить — открывает пустую форму новой конфигурации (см. «Вкладка „Общие данные“»).
  • Выгрузить — скачивает текущий список (с учётом поиска и фильтров, все страницы) в файл CSV с разделителем «;», который открывается в Excel. В файл попадают номер, название, тип, статус и дата; описание и настройки не выгружаются. Это перечень для учёта, а не резервная копия настроек.

Обе кнопки видны только пользователям с правом создавать конфигурации — права настраиваются в ролях (Роли и пользователи).

Меню действий: Открыть, Изменить, Копировать, Удалить

Меню действий в строке конфигурации: Открыть, Изменить, Копировать, Удалить
Меню «≡» в колонке «Действия»
ПунктЧто делаетВажно знать
ОткрытьОткрывает конфигурацию для просмотра в этой же вкладке браузера.Поля недоступны для изменения, кнопок сохранения нет. Возврат — кнопкой «Назад».
ИзменитьОткрывает конфигурацию для редактирования.Каждое сохранение увеличивает номер версии. Изменения получат все точки с этой конфигурацией — при перезапуске их приложения или по заданию. См. «Как изменения доходят до терминала».
КопироватьПосле подтверждения «Вы уверены?» создаёт полную копию конфигурации.Подробно — в следующем разделе.
УдалитьПосле подтверждения «Вы уверены?» удаляет конфигурацию; появляется сообщение «Удаление успешно».Самостоятельно восстановить нельзя. Перед удалением переведите все точки на другую конфигурацию — см. «Удаление конфигурации».

Пункты «Изменить», «Копировать» и «Удалить» видны, если у вашей роли есть право изменять все конфигурации или вы сами создали эту конфигурацию и у вас есть право изменять свои. Иначе в меню остаётся только «Открыть».

Копирование: что делает «Копировать» и зачем

Копировать создаёт новую конфигурацию — точную копию выбранной. Список обновляется, копия появляется первой строкой.

ЧтоУ копии
Название«Копия » + название оригинала. Переименуйте сразу, чтобы не перепутать.
Номер конфигурацииНовый, следующий по порядку.
Тип, статус, описание, клиентКак у оригинала.
Планограмма, настройки, интерфейс (включая картинки и логотипы), шаги, сценарии реле, вкладки СКУД, боксы и ценыКопируются полностью.
Номер версииПереносится с оригинала и дальше растёт с каждым сохранением копии. Ориентируйтесь на номер конфигурации, а не на версию.
Дата версии и дата созданияДата копирования.
СоздательВы.
ТочкиНи одна точка на копию не ссылается. Оригинал и его точки не меняются.

Зачем копировать:

  • Похожая точка. Новый автомат с другим набором напитков: скопируйте рабочую конфигурацию и поменяйте только планограмму — оформление, таймауты и фискализация уже настроены.
  • Безопасная правка. Меняете рабочую конфигурацию десятка терминалов — сначала сделайте копию, внесите изменения в неё, проверьте на одной точке, затем переведите остальные. Если что-то пошло не так, вернуть точку на оригинал — одно действие.
  • Резервная копия. Прежние версии конфигурации не хранятся, кнопки «откатить» нет. Копия перед крупной правкой и есть резервная версия; переведите её в статус «Архивная», чтобы не мешала.
  • Нужен другой тип. Тип у копии тот же, что у оригинала. Если нужен другой тип — создайте новую конфигурацию нужного типа (см. «Смена типа»).

Вкладка «Общие данные»

Вкладка открывается первой при создании и при изменении конфигурации. Внизу формы всегда три кнопки:

  • Назад — закрыть форму без сохранения.
  • Сохранить — сохранить и вернуться к списку.
  • Применить — сохранить и остаться в форме. У новой конфигурации первое «Применить» создаёт её, следующие — сохраняют изменения в ту же запись, дубли не появляются.

Кнопки сохраняют все вкладки сразу. При успехе появляется «Данные успешно сохранены», при ошибке — «Ошибка при сохранении данных» или «Не удалось сохранить конфигурацию. Повторите попытку» (обычно — нет связи с сервером; данные в форме остаются, нажмите кнопку ещё раз).

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

Для типа «Яндекс Автозаправка» на этой вкладке есть дополнительные поля («Тип мойки», «Шаг платежа», «Минимальный платеж», «Максимальный платеж», флажок «Работает») — они описаны в статье Автомойка.

Версии: как они работают

В JustPay версия — это не отдельная копия конфигурации, а счётчик сохранений одной и той же записи.

  • Когда растёт версия. При каждом нажатии «Сохранить» или «Применить» в существующей конфигурации — на 1. При удалении — тоже на 1. Создание даёт версию 0. Копия получает номер версии оригинала.
  • Новая запись не создаётся. Номер конфигурации остаётся прежним, точки продолжают ссылаться на неё же. Перепривязывать точки после правки не нужно.
  • Старые версии не хранятся. Посмотреть, как было в версии 55, или вернуться к ней из ЛК нельзя. Нужна страховка — сделайте копию перед изменением.
  • Терминал версию не сравнивает. Он не следит за номером версии и не проверяет сам, появилась ли новая. Свежую конфигурацию терминал берёт с сервера при каждом запуске приложения и по заданию из ЛК — см. следующий раздел.

Сохранённое изменение может дойти до терминала раньше, чем вы ожидаете. Любой перезапуск приложения — выключение и включение терминала, перезагрузка по заданию или автоматическая перезагрузка сервисным приложением «Сторожок» после долгого отсутствия интернета — загружает текущую версию конфигурации. Поэтому не сохраняйте недоделанные изменения в конфигурации, по которой работают точки: правьте копию.

Статус: активная и архивная

СтатусЧто означаетЧто происходит на практике
АктивнаяКонфигурация используется. Значение для рабочих конфигураций.Зелёная плашка в списке.
АрхивнаяКонфигурация больше не нужна, но вы хотите её сохранить — как образец или резервную копию.Жёлтая плашка; архивные легко скрыть фильтром «Статус». Конфигурация по-прежнему доступна для выбора в карточке точки.

Статус «Архивная» не отключает терминалы. Если архивная конфигурация назначена точке, терминал продолжит по ней работать. Чтобы точка перестала работать по конфигурации, назначьте ей другую в карточке точки. При этом в части сводных показателей на странице «Сводка» учитываются только точки с активной конфигурацией — не архивируйте конфигурацию, пока по ней работают точки.

Вкладка «Настройки»: общие поля для всех типов

Вкладка есть у всех 13 типов. Ниже — поля, которые видны у всех (кроме отмеченных), и что из них реально использует терминал. Поля, которые появляются только у отдельных типов, перечислены в конце раздела и подробно описаны в статьях по типам.

Вкладка «Настройки» конфигурации типа Вендинг с полями по умолчанию
«Настройки» у вендинга: общие поля и флажок «Подключение MDB»
Вкладка «Настройки» конфигурации POS-терминал: Режим запуска, Протокол, Порт для подключения, Тайм-аут
«Настройки» у POS-терминала: добавлены «Режим запуска», «Протокол» и параметры подключения кассы
ПолеЧто задаётКак использует терминал
Сервер, ПортАдрес сервера JustPay. У новой конфигурации заполняются автоматически: адрес личного кабинета и порт 443.Служебные поля, не меняйте их. Приложение терминала их не использует: адрес сервера задаётся на самом терминале при привязке к точке.
Тип цены«Брать из номенклатуры» или «Брать из настроек аппарата». По умолчанию не выбрано, что равно первому значению.Используется только в вендинге. «Брать из номенклатуры» — цену назначает JustPay: берётся стоимость из планограммы конфигурации. «Брать из настроек аппарата» — списывается сумма, которую сообщил сам автомат. Подробно — Вендинг, Планограмма.
Тип первого экранаКакой экран терминал показывает в режиме ожидания. По умолчанию — «Стандартный режим».Действует для «Пожертвований» и «Витрины», частично — для «Управления реле». Значения — в таблице ниже.
Тип экрана оплатыВариант экрана выбора способа оплаты. По умолчанию — «Универсальный экран - Банковская карта + QR».В текущей версии приложения терминала не используется. Как выглядит экран выбора оплаты, определяют включённые способы оплаты точки и вкладка «Интерфейс».
Таймаут главного экрана (сек)Задумано как время, через которое терминал без действий возвращается в режим ожидания.В текущей версии приложения терминала не используется. Заполнять не нужно.
Таймаут выбора товара (сек)Сколько секунд терминал ждёт продолжения после выбора товара.Используется только в вендинге: если покупатель выбрал товар на автомате и не начал оплату, по истечении времени терминал возвращается на главный экран. 0 или пусто — не ограничено. Экран выбора способа оплаты закрывается сам через 15 секунд, этот таймер из ЛК не меняется.
Таймаут показа чека (сек)Сколько секунд держится последний экран после операции.Используется во всех сценариях: управляет и экраном успешной оплаты (с QR-кодом чека), и экраном ошибки. Если оставить пустым, экран сменится практически сразу — задайте 10–20 секунд, чтобы покупатель успел отсканировать QR-код чека.
Таймаут ожидания фискализации (сек)Сколько ждать регистрации чека. По умолчанию — 5.Приложение терминала это поле не читает. Используется сервером и только вместе с флажком «Обязательность фискализации».
Таймаут оплаты по карте (сек)Сколько ждать прикладывания карты. По умолчанию — 150.Используется только с банковским приложением SmartSkyPos (вид банковского ПО «SkyPos» в точке): по истечении времени ожидание оплаты прекращается. 0 или пусто — 150 секунд. Для других банковских приложений время ожидания задаёт само банковское ПО.
Таймаут оплаты по СБП (сек)Сколько секунд QR-код СБП висит на экране в ожидании оплаты. По умолчанию — 150.Используется при оплате по СБП во всех сценариях. По истечении времени терминал перестаёт ждать оплату. Если поле очистить или поставить 0, терминал подставит 65 секунд.
Тип экрана при сканировании Цифрового ID MAX«Отображать QR-код и одновременно сканировать Цифровой ID» (по умолчанию) или «Сканировать Цифровой ID на отдельном шаге».Как терминал проверяет покупателя через MAX: показывает QR-код и одновременно ждёт сканирования или включает камеру отдельным шагом. Действует, только если идентификация MAX настроена — Идентификация MAX.
Обязательность фискализацииФлажок. По умолчанию снят.Если включён: сервер перед ответом терминалу ждёт, пока чек уйдёт на кассу (не дольше «Таймаута ожидания фискализации»). Если чек за это время не пробит, платёж получает статус «Ошибка ККТ» («Отмена по таймауту»), но покупка на терминале завершается — деньги списаны, чек нужно переотправить. Оплату картой терминал отменяет (деньги возвращаются покупателю, товар не выдаётся), только если сервер не ответил (нет связи) или отклонил платёж; в этом случае платёж не откладывается для отправки позже как успешный. Если флажок снят, платёж проходит, а чек досылается позже. Включайте только при стабильной связи и надёжно работающей кассе.
Фискализация наличных операцийФлажок. По умолчанию включён.Сервер формирует чек для оплат наличными (в том числе продаж за наличные в вендинговом автомате).
Фискализация безналичных операцийФлажок. По умолчанию включён.Сервер формирует чек для оплат банковской картой и по СБП. Если снять оба флажка фискализации, платежи проводятся без чека. Чтобы чек формировался, к точке должна быть подключена касса — Фискализация и ККТ.

Поле «Таймаут ожидания остановки налива (сек)» есть только у АЗС — см. АЗС. Тексты на экранах, цвета, логотипы, видео и аудио задаются не здесь, а на вкладке «Интерфейс» — Оформление экранов терминала.

Тип первого экрана — все значения

ЗначениеЧто покажет терминал
Стандартный режимОбычный экран сценария: кнопки сумм (пожертвования), кнопки товаров и услуг (витрина).
Выбор способа оплатыВ текущей версии приложения терминала не обрабатывается: экран не меняется. Не выбирайте.
Универсальный экран - Банковская карта + QRОдин экран, на котором одновременно можно приложить карту и отсканировать QR-код СБП.
Чтение карты доступа режимЭкран «Приложите карту» для прохода по карте сотрудника — Доступ по карте сотрудника.
Чтение карты доступа + ОплатаВ текущей версии приложения терминала не обрабатывается. Не выбирайте.

Для вендинга, POS-терминала, POS-точки, АЗС и автомойки стартовый экран определяется типом конфигурации, это поле на них не влияет. Подробнее о первом экране — Оформление экранов терминала.

Поля «Настроек», которые есть только у отдельных типов

Список полей по типам
ПолеУ каких типовГде описано
Режим запуска («Приложение» / «Служба»)POS-терминал, POS-точкаPOS-терминал и касса
Протокол, Порт для подключения, Тайм-аут, Отправлять операции на сервер; для отдельных протоколов — дополнительные поля (Jetinno, MSB, Inpas)POS-терминал, POS-точка, POS-точка с реле; а также любой тип при режиме запуска «Служба»POS-терминал и касса, POS-точка
Наименование номенклатуры (по умолчанию), Использовать значение по умолчаниюPOS-терминалPOS-терминал и касса
Подключение MDB и его параметры, Подключение USB, Подключение WizarposВендингВендинг
Таймаут ожидания остановки налива (сек), Режим работы с колонкамиАЗСАЗС
Повторить срабатывание реле, для каждой товарной позицииPOS-точка с релеУправление реле
Вводить код ячейкиУправление реле, СКУДУправление реле

Другие вкладки: Планограмма, Интерфейс, Настройка шагов

Эти вкладки зависят от типа и подробно разобраны в отдельных статьях. Здесь — коротко, что в них и зачем.

ВкладкаУ каких типовЧто настраиваетсяСтатья
ПланограммаВендинг, Пожертвования, Витрина, АЗС, Управление реле, СКУДСписок позиций: ячейки автомата и товары в них, суммы пожертвований, топливо на колонках, кнопки услуг. Цены, ставка НДС, тип предмета расчёта.Планограмма
ИнтерфейсВсе, кроме «Прием платежей», «Курьер» и «Яндекс Автозаправка»Внешний вид экранов терминала: первый экран, экраны выбора и выдачи, ошибки, последний экран. Тексты, цвета, логотипы, видео, аудио.Оформление экранов терминала
Настройка шаговPOS-точка, POS-точка с реле, Витрина, Управление реле, СКУДУ POS-точки и POS-точки с реле — последовательность экранов покупки (кнопка «Добавить новую POS страницу»): ввод данных, информация, каталог, корзина; порядок шагов в списке — порядок экранов на терминале. У витрины, управления реле и СКУД — сценарии реле (кнопка «Добавить новый сценарий»): какие реле включить, на сколько и в каком порядке после оплаты.POS-точка, Управление реле
СКУДСКУДПараметры пропускного режима.Настраивается вместе с поддержкой
Боксы, Список ценЯндекс АвтозаправкаПеречень боксов и цен для сервиса Яндекса.Автомойка
Вкладка «Настройка шагов» у POS-точки: кнопка «Добавить новую POS страницу»
«Настройка шагов» у POS-точки — экраны покупки
Вкладка «Настройка шагов» у типа Управление реле: кнопка «Добавить новый сценарий»
«Настройка шагов» у «Управления реле» — сценарии реле

Для витрины, управления реле и POS-точки с реле в планограмме и шагах выбирается реле из оборудования точки. Список реле заполняется по точке, которой эта конфигурация уже назначена. Поэтому порядок такой: создать конфигурацию и сохранить → назначить её точке, у которой добавлено оборудование → вернуться в конфигурацию и выбрать реле. У новой конфигурации без точки и у свежей копии список реле пуст.

Как изменения доходят до терминала

«Сохранить» и «Применить» записывают конфигурацию на сервере. Терминалы узнают об этом в двух случаях:

  1. При запуске приложения — после включения терминала, перезагрузки или перезапуска приложения терминал всегда загружает текущую конфигурацию точки.
  2. По заданию из ЛК — Точки обслуживания → Задания, задание создаётся для каждой точки отдельно (Задания и сверка итогов).
ЗаданиеЧто делает терминалКогда выбирать
Обновление конфигурацииОтмечает задание выполненным («Конфигурация обновленна») и перезапускает приложение. При запуске заново загружает конфигурацию, способы оплаты и номенклатуру, переподключается к банковскому ПО и строит экраны с нуля. Пока приложение перезапускается и заново подключается к банковскому ПО, терминал не принимает оплату — отправляйте задание, когда нет покупателей.Всегда подходит. Обязательно — если сменили тип или конфигурацию точки, «Тип первого экрана», режим запуска, протокол, параметры MDB, а также банковское ПО в точке.
Обновление параметровБез перезапуска запрашивает с сервера конфигурацию и номенклатуру и заменяет их в памяти. Статус задания — «Параметры конфигурации обновлены». Новые значения применяются, когда соответствующий экран откроется в следующий раз.Мелкие правки без перерыва в работе: цены и позиции планограммы, тексты, таймауты, флажки фискализации, изменения номенклатуры. На АЗС во время налива задание не выполняется: статус ошибки «Не возможно обновить параметры! Идет налив топлива.» — повторите после налива.
Форма нового задания: поле «Точка» и «Тип задания» = Обновление конфигурации
Задание «Обновление конфигурации»: выберите точку и тип задания, нажмите «Сохранить»
  • Терминал забирает задание при очередном сеансе связи с сервером: он должен быть включён и в сети. Выключенный терминал получит новую конфигурацию при включении — без всякого задания.
  • Если задание завершилось статусом ошибки «Ошибка при выполнении задачи», терминал не смог получить конфигурацию (обычно нет связи). Он продолжает работать по прежней. Проверьте интернет на терминале и повторите.
  • Изменили номенклатуру (название или цену товара в справочнике)? Это тоже доходит до терминала только при запуске или по одному из этих заданий.
  • Если сомневаетесь, какое задание нужно, — выбирайте «Обновление конфигурации» в тихое время.

Смена типа конфигурации

Поле Тип конфигурации у существующей конфигурации технически доступно для изменения. Делать этого не следует.

Смена типа может сломать логику конфигурации. Были случаи, когда после смены типа терминал работал некорректно. Причины:

  • данные прежнего типа остаются в конфигурации, хотя их вкладки скрыты, и могут мешать новому сценарию;
  • у нового типа другие обязательные настройки, а заполнены они значениями от старого;
  • при сохранении конфигурации, тип которой не «Управление реле», не «POS-точка с реле» и не «СКУД», сценарии реле удаляются безвозвратно;
  • смена типа сразу затрагивает все точки, которым назначена конфигурация, — при их ближайшем перезапуске.

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

Удаление конфигурации

  • Удалённая конфигурация пропадает из списка и из выбора в поле «Конфигурация» карточки точки. Самостоятельно восстановить её нельзя — только через поддержку.
  • ЛК не проверяет, назначена ли конфигурация точкам, и не предупреждает об этом. У точек, которые ссылались на удалённую конфигурацию, в списке точек колонка «Тип конфигурации» станет пустой, а при следующем открытии карточки поле «Конфигурация» окажется незаполненным.
  • Правило: сначала переназначьте все точки на другую конфигурацию и отправьте им «Обновление конфигурации», убедитесь, что терминалы работают, и только потом удаляйте. Если сомневаетесь — не удаляйте, а переведите в «Архивная».

Типовые сценарии

Создать конфигурацию с нуля

  1. Откройте Точки обслуживания → Конфигурации и нажмите Добавить.
  2. На вкладке «Общие данные» выберите Тип конфигурации — сразу, до заполнения остальных вкладок. Статус — «Активная». Впишите название и описание. «Наименование клиента» обычно оставляют пустым.
  3. Нажмите Применить — конфигурация создастся и получит номер, форма останется открытой.
  4. Пройдите вкладки слева направо: «Планограмма» (если есть) → «Настройки» → «Интерфейс» → «Настройка шагов» (если есть). Периодически нажимайте «Применить».
  5. Нажмите Сохранить.
  6. Откройте карточку точки (Точки обслуживания), выберите конфигурацию в поле Конфигурация и сохраните карточку.
  7. Для витрины, управления реле, POS-точки с реле: вернитесь в конфигурацию и выберите реле в планограмме и шагах — теперь список заполнен.
  8. Отправьте точке задание «Обновление конфигурации» и проверьте сценарий на терминале. Для пусконаладки удобно временно выбрать в точке банковское ПО «Эмулятор» — Способы оплаты.

Скопировать и адаптировать под новую точку

  1. В строке подходящей конфигурации нажмите ≡ → Копировать → подтвердите.
  2. В начале списка появится «Копия …». Откройте её через ≡ → Изменить.
  3. Смените название, впишите в описание, для какой точки она.
  4. Внесите отличия: планограмму, тексты, логотип, таймауты.
  5. Сохраните, назначьте копию новой точке в её карточке, отправьте «Обновление конфигурации».

Перевести 10 точек на новую версию настроек

Вариант 1 — правка общей конфигурации. Подходит для мелких и безопасных изменений (цена, текст на экране).

  1. Откройте конфигурацию через «Изменить», внесите изменения, нажмите «Сохранить». Версия увеличится на 1.
  2. Создайте задание «Обновление параметров» (или «Обновление конфигурации») для каждой из 10 точек.
  3. В разделе «Задания» дождитесь, что все 10 заданий выполнены. Выключенные терминалы получат изменения при включении.

Вариант 2 — через копию с проверкой на одной точке. Для крупных изменений (новая планограмма, другой сценарий реле, новые шаги).

  1. Скопируйте рабочую конфигурацию, переименуйте копию, например «… v2», и внесите изменения в неё. Рабочие точки при этом не затрагиваются.
  2. Назначьте копию одной точке, отправьте ей «Обновление конфигурации», проверьте покупку на терминале.
  3. Если всё в порядке — назначьте копию остальным 9 точкам и отправьте каждой «Обновление конфигурации».
  4. Старую конфигурацию переведите в «Архивная» — она останется резервной. Если что-то пошло не так, верните точкам старую конфигурацию и снова отправьте задание.

Списка «какие точки работают по этой конфигурации» в ЛК нет. Ведите его в поле «Описание» конфигурации или сверяйте по колонке «Тип конфигурации» и карточкам точек.

Частые ошибки

Что происходитПричинаЧто сделать
Изменил конфигурацию, а на терминале всё по-старомуТерминал не получил её: не отправлено задание, терминал не в сети, задание завершилось ошибкой.Отправьте «Обновление конфигурации», проверьте статус задания и интернет на терминале.
Изменения появились на точках, которые не собирались трогатьКонфигурация общая для нескольких точек; их терминалы перезапустились и загрузили новую версию.Для отдельной точки сделайте копию и назначьте её только этой точке.
После смены типа терминал работает неправильноСмена типа у существующей конфигурации.Создайте новую конфигурацию нужного типа, назначьте её точке, отправьте «Обновление конфигурации».
Пропали сценарии релеКонфигурацию сохранили с типом, у которого нет сценариев реле.Восстановите сценарии вручную или из копии. Не меняйте тип.
Нет нужных вкладок (планограммы, шагов)Выбран не тот тип; у этого типа такой вкладки нет.Сверьтесь с таблицей типов.
Конфигурации нет в списке «Конфигурация» карточки точкиКонфигурация удалена или принадлежит другой организации.Проверьте «Наименование клиента» в конфигурации; удалённую восстановит только поддержка.
В планограмме или шагах пустой список «Реле»Конфигурация ещё не назначена точке с оборудованием.Назначьте конфигурацию точке, у которой добавлено реле, и откройте конфигурацию снова.
Перевёл конфигурацию в «Архивная», а терминал работаетСтатус не отключает терминалы.Назначьте точке другую конфигурацию или заблокируйте точку.
Экран с QR-кодом чека пропадает мгновенноНе задан «Таймаут показа чека (сек)».Поставьте 10–20 секунд, отправьте «Обновление параметров».
QR-код СБП исчезает раньше, чем покупатель успевает оплатитьМал «Таймаут оплаты по СБП (сек)» или поле пустое (тогда 65 секунд).Задайте 120–150 секунд.
Поменял «Таймаут главного экрана» — ничего не изменилосьПоле в текущей версии приложения не используется.Время показа экранов настраивайте полями «Таймаут показа чека» и «Таймаут выбора товара».
Оплата картой проходит, а потом сразу отменяетсяВключена «Обязательность фискализации», а терминал не получил ответа сервера (нет связи у терминала) или сервер отклонил платёж.Проверьте связь терминала (Сеть терминала) и статус платежа в ЛК. Если связь нестабильна — снимите флажок.
Чеки не формируютсяСняты флажки «Фискализация наличных/безналичных операций» или к точке не подключена касса.Включите флажки, проверьте кассу точки.
«Невозможность запустить терминал, не настроены типы оплаты»Дело не в конфигурации: в точке не включён ни один способ оплаты.См. Способы оплаты.
Удалил конфигурацию по ошибкеСамостоятельное восстановление недоступно.Обратитесь в поддержку и назовите номер конфигурации.

Что дальше