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

Вендинг

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

  • Где: Точки обслуживания → Конфигурации → тип «Вендинг»
  • Кому: администратору, технику, владельцу автоматов
  • Действует на: терминал в автомате, обмен с автоматом по MDB, платежи, чеки

Как это устроено

Терминал (обычно WizarPOS Q3V — «Салют 3В ПРО») ставится в автомат и подключается кабелем к его контроллеру по шине MDB — стандартному протоколу торговых автоматов. Для автомата терминал выглядит как обычный кэшлесс-модуль (устройство безналичной оплаты, режим MDB Slave): продажей управляет контроллер автомата, а терминал только отвечает «оплачено — выдавай» или «отказ».

  1. Место обслуживания
  2. Точка: способы оплаты, банк, касса
  3. Конфигурация «Вендинг»: MDB, планограмма, экраны
  4. Терминал
  5. Автомат (MDB)

Что делает каждая сторона:

КтоЗа что отвечает
Автомат (контроллер)Кнопки и меню выбора, свои цены, приготовление и выдача товара, купюроприёмник и монетоприёмник (если есть).
Терминал JustPayЭкран с подсказками покупателю, приём карты или показ QR-кода СБП, разрешение или запрет выдачи, регистрация продажи на сервере.
Сервер JustPayКонфигурация (настройки MDB, планограмма, экраны), учёт платежей, чеки через кассу точки, СБП, телеметрия.

Как проходит одна продажа

  1. Ожидание. Терминал показывает экран режима ожидания (какой именно — зависит от режима Always IDLE, см. ниже).
  2. Выбор товара на автомате. Покупатель нажимает кнопку напитка или вводит номер ячейки. Автомат отправляет терминалу запрос на продажу: номер товара и цену.
  3. Поиск в планограмме. Терминал ищет в планограмме конфигурации строку с таким же Кодом ячейки и берёт из неё название, ставку НДС, тип позиции, а при «Типе цены» = «Брать из номенклатуры» — и цену.
  4. Оплата. Терминал запускает оплату выбранным способом: банковское ПО просит приложить карту либо на экране появляется QR-код СБП.
  5. Разрешение выдачи. Оплата прошла — терминал отправляет автомату «выдача разрешена», на экране «ДОЖДИТЕСЬ ВЫДАЧИ и ЗАБЕРИТЕ ТОВАР» с номером ячейки и названием товара.
  6. Итог выдачи. Автомат сообщает: товар выдан. Терминал подтверждает и отправляет платёж на сервер; сервер формирует чек, если к точке подключена касса. На экране — результат с QR-кодом чека.
  7. Возврат в ожидание через время «Таймаут показа чека (сек)» или по нажатию кнопки на экране результата.

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

Продажи за наличные (купюроприёмник автомата) автомат тоже сообщает терминалу, и терминал регистрирует их в личном кабинете как оплату наличными — см. «Наличные в вендинге».

Что нужно для запуска

ЧтоТребованиеГде настраивается
АвтоматПоддерживает безналичный модуль по MDB (cashless device). В меню автомата безналичная оплата должна быть включена.Сервисное меню автомата (по его инструкции)
ТерминалМодель с портом MDB Slave — WizarPOS Q3V («Салют 3В ПРО»). В ваш кабинет его добавляет техподдержка JustPay по заявке; вы привязываете его к точке PIN-токеном.Оборудование, Токен и PIN-токен
НоменклатураПозиция на каждый товар автомата.Номенклатура
Конфигурация «Вендинг»Настройки MDB, планограмма со всеми кодами ячеек, оформление экранов.Эта статья
Точка обслуживанияНазначена конфигурация, включены способы оплаты, выбрано банковское ПО.Точки обслуживания, Способы оплаты
Касса (по желанию)Облачная или своя ККТ для чеков. Подключается через JustPay по заявке.Фискализация и ККТ

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

Конфигурация создаётся в разделе Точки обслуживания → Конфигурации кнопкой Добавить. У новой конфигурации тип по умолчанию уже «Вендинг». У вендинга четыре вкладки:

ВкладкаЧто на нейПодробно
Общие данныеСтатус, тип, название, описание, организация; дата и номер версии заполняются сами.Конфигурации
ПланограммаКоды ячеек (кнопок) автомата и товары в них, цены, ставка НДС.ниже, Планограмма
НастройкиПодключение MDB, кредит, десятичная точка, коэффициент, режим Always IDLE, тип устройства, тип цены, таймауты, фискализация.ниже — основная часть статьи
ИнтерфейсТексты, картинки, видео и звук экранов вендинга.ниже, Оформление экранов терминала
Новая конфигурация, вкладка «Общие данные»: тип «Вендинг» выбран по умолчанию
Новая конфигурация: тип «Вендинг» стоит по умолчанию
Рабочая конфигурация вендинга, вкладка «Общие данные»: дата версии, номер версии, статус «Активная»
Рабочая конфигурация: дата и номер версии меняются при каждом сохранении

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

Вкладка «Настройки»

Блок параметров MDB появляется только после установки флажка Подключение MDB. Остальные поля — общие для всех типов конфигураций; здесь они описаны с точки зрения вендинга.

Вкладка «Настройки» новой конфигурации вендинга: флажок «Подключение MDB» снят, параметры MDB скрыты
Новая конфигурация: пока флажок «Подключение MDB» снят, параметров MDB не видно
Вкладка «Настройки» с включённым MDB: способ подключения, максимальная сумма кредита, десятичная точка, коэффициент масштабирования, режим Always IDLE, тип устройства, подключение USB и Wizarpos, тип цены, таймауты
Флажок установлен: появились «Способ подключения», «Максимальная сумма кредита», «Десятичная точка», «Коэффициент масштабирования», «Режим Always IDLE», «Тип устройства»

Все поля вкладки

ПолеЧто задаётНа что влияет
Сервер, ПортАдрес сервера JustPay, заполняются сами (адрес личного кабинета и 443).Служебные, не меняйте. Терминал берёт адрес сервера из своей привязки к точке.
Подключение MDB
обязательно включить
Открывает блок параметров MDB.Без флажка параметры не видны и остаются пустыми (нулевыми) — сумма от автомата и параметры, которые терминал сообщает автомату, будут неверными. Подробно.
Способ подключения
при включённом MDB
Единственное значение — «MDB Slave».Терминал работает как кэшлесс-модуль автомата. Выберите его, чтобы поле не было пустым.
Максимальная сумма кредита
при включённом MDB
Сумму, которую терминал «открывает» автомату в начале сессии. Целое число в единицах автомата.Только при выключенном «Режиме Always IDLE». Подробно.
Десятичная точка
при включённом MDB
0, 1, 2 или 3 — сколько знаков после запятой в ценах автомата.Пересчёт цены автомата в рубли. Ошибка — сумма в 10, 100 или 1000 раз больше/меньше. Подробно.
Коэффициент масштабирования
при включённом MDB
Множитель цены автомата, целое число от 1 до 255.Тот же пересчёт. Терминал сообщает это значение автомату при подключении.
Режим Always IDLE
при включённом MDB
Порядок действий покупателя: сначала выбор товара на автомате или сначала способ оплаты на терминале.Весь сценарий экранов. Подробно.
Тип устройства
при включённом MDB
«Нестле», «Уникум» или «Сахарная вата».Как терминал запускает связь с автоматом и сбрасывает сессию. Подробно.
Подключение USB, USB порт
видны не у всех конфигураций
Задуманы для подключения автомата через USB.В текущей версии приложения терминала не используются: связь идёт только через порт MDB. Оставьте выключенным.
Подключение Wizarpos
видно не у всех конфигураций
Служебный флажок.В текущей версии приложения терминала не используется. Оставьте выключенным.
Тип цены«Брать из номенклатуры» или «Брать из настроек аппарата». Пусто = первое значение.Какую сумму списывает терминал. Подробно.
Тип первого экрана, Тип экрана оплатыОбщие поля.На вендинг не влияют: экраны вендинга задаются режимом Always IDLE и способами оплаты точки.
Таймаут главного экрана (сек)Общее поле.Приложение терминала его не использует. Заполнять не нужно.
Таймаут выбора товара (сек)Сколько ждать следующего шага покупателя.По истечении — отказ автомату и возврат в ожидание. 0 или пусто — без ограничения. Подробно.
Таймаут показа чека (сек)Сколько держится экран результата и экран ошибки.После — возврат в ожидание. Пусто или 0 — экран сменится сразу.
Таймаут ожидания фискализации (сек)Сколько сервер ждёт чек.Работает только вместе с «Обязательностью фискализации». Терминал поле не читает.
Таймаут оплаты по карте (сек)Время ожидания карты.Используется только с банковским ПО «SkyPos»; у остальных время задаёт само банковское приложение.
Таймаут оплаты по СБП (сек)Сколько QR-код висит на экране.По истечении оплата отменяется, автомат получает отказ. 0 или пусто — 65 секунд.
Тип экрана при сканировании Цифрового ID MAXОбщее поле.Только если для точки настроена идентификация MAX.
Обязательность фискализации, Фискализация наличных операций, Фискализация безналичных операцийФормировать ли чек и ждать ли его.«Фискализация наличных» включает чеки и для продаж через купюроприёмник автомата. Подробно — Конфигурации, Фискализация и ККТ.

Подключение MDB и Способ подключения

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

Способ подключения — всегда «MDB Slave»: терминал подчиняется контроллеру автомата. Режим, в котором терминал сам управлял бы продажей (MDB Master), в приложении не реализован.

Как это влияет на терминал

Через 3 секунды после запуска приложения терминал отправляет автомату команду сброса и ждёт, пока автомат его «опросит». В ответ на опрос терминал сообщает автомату свои параметры: уровень поддержки протокола, коэффициент масштабирования, десятичную точку и признак режима Always IDLE. Поэтому после изменения параметров MDB терминал нужно перезапустить — задание «Обновление конфигурации».

Десятичная точка и Коэффициент масштабирования

Автомат передаёт цену целым числом в своих единицах. Терминал переводит его в рубли по формуле:

Сумма, ₽ = число от автомата × Коэффициент масштабирования ÷ 10Десятичная точка

Значения берутся из настроек безналичной оплаты (cashless, MDB) самого автомата — посмотрите их в сервисном меню или инструкции автомата. Оба поля должны соответствовать тому, как автомат хранит цены.

Как автомат хранит цену 90 ₽ПередаётДесятичная точкаКоэффициентРасчёт
В рублях без копеек900190 × 1 ÷ 1 = 90 ₽
В копейках9000219000 × 1 ÷ 100 = 90 ₽
В десятках копеек90011900 × 1 ÷ 10 = 90 ₽
Шагами по 10 ₽ (крупный шаг цены)90109 × 10 ÷ 1 = 90 ₽

Что будет при неверном значении. Десятичная точка на единицу меньше, чем нужно, — покупатель заплатит в 10 раз больше (900 ₽ вместо 90 ₽); на единицу больше — в 10 раз меньше (9 ₽). Разница в два знака — в 100 раз. Коэффициент 0 или пусто — сумма 0. Перед запуском обязательно сделайте тестовую покупку на «Эмуляторе» (Способы оплаты) и сравните сумму на экране терминала с ценой на автомате.

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

Максимальная сумма кредита

Используется только при выключенном «Режиме Always IDLE». Когда покупатель выбрал на терминале способ оплаты, терминал открывает на автомате сессию и сообщает доступную сумму — это и есть кредит. Автомат позволяет выбрать товары не дороже этой суммы.

  • Единицы — те же, в которых автомат передаёт цену (до пересчёта десятичной точкой и коэффициентом). Для автомата «в копейках» кредит 50000 — это 500 ₽.
  • Значение — не меньше цены самого дорогого товара в автомате; деньги при этом не блокируются, списывается только цена выбранного товара.
  • Ограничение — только целое число, не больше 65535: в протоколе MDB на сумму отводится два байта, большее значение будет передано автомату искажённым. Для автомата «в копейках» это до 655,35 ₽; если товары дороже, настройте автомат на рубли (десятичная точка 0).
  • Слишком маленький кредит — автомат не даст выбрать дорогие позиции или покажет «недостаточно средств».

Режим Always IDLE: что сначала — автомат или терминал

Флажок определяет порядок действий покупателя. Это главная настройка сценария, выбирайте её по тому, как устроен ваш автомат.

Флажок снят (стандартный режим)Флажок установлен (Always IDLE)
Экран ожидания терминала«ВЫБЕРИТЕ СПОСОБ ОПЛАТЫ» с кнопками способов. Если способ один — «НАЖМИТЕ НА ЭКРАН ДЛЯ ПРОДОЛЖЕНИЯ».«ВЫБЕРИТЕ ТОВАР, СЛЕДУЯ ИНСТРУКЦИЯМ НА АППАРАТЕ».
Шаг 1 покупателяНажимает способ оплаты (или касается экрана). Терминал открывает на автомате сессию с «Максимальной суммой кредита».Выбирает товар на автомате — сразу, без касания терминала.
Шаг 2Экран «ВЫБЕРИТЕ ТОВАР, СЛЕДУЯ ИНСТРУКЦИЯМ НА АППАРАТЕ» и кнопка «Отмена». Покупатель выбирает товар на автомате.Экран «ВЫБЕРИТЕ СПОСОБ ОПЛАТЫ» с кнопкой «Отмена». Если способ один — оплата начинается сразу.
Шаг 3Терминал проводит оплату на сумму выбранного товара и разрешает выдачу.
«Максимальная сумма кредита»Используется.Не используется.
Требование к автоматуОбычный кэшлесс-режим MDB — поддерживают практически все автоматы.Автомат должен поддерживать функцию Always Idle протокола MDB (уровень 3) и уметь присылать запрос на продажу без открытой сессии. Проверьте в документации автомата.
Когда выбиратьПо умолчанию, если не уверены.Когда покупателю удобнее начинать с автомата: кофейные автоматы с большим меню, автоматы, где выбор занимает время.
Как это влияет на терминал

При подключении терминал сообщает автомату, работает ли он в режиме Always IDLE. Если автомат эту функцию не поддерживает, а флажок установлен, автомат не пришлёт запрос на продажу — покупатель выберет товар, а оплата на терминале не начнётся. В таком случае снимите флажок и перезапустите приложение заданием «Обновление конфигурации».

Тип устройства

Подстраивает поведение терминала под особенности контроллера автомата. Значение выбирайте по модели автомата; если автомат не из перечисленных групп — «Нестле».

ЗначениеДля каких автоматовЧем отличается поведение терминала
НестлеБольшинство автоматов со стандартным MDB.При запуске — команда сброса. Отмена сессии (кнопка «Отмена», истёк таймаут, оплата не прошла) — штатной командой MDB «отмена сессии».
УникумАвтоматы Unicum.При запуске — сброс. После каждого отказа в выдаче и после закрытия экрана результата терминал дополнительно сбрасывает связь с автоматом, чтобы автомат гарантированно вернулся в исходное состояние.
Сахарная ватаАппараты сахарной ваты.При запуске терминал не отправляет сброс, а сразу переходит на экран вендинга и готов к продаже. Отмена сессии — через сброс.

Признак неверного типа: после отмены или неудачной оплаты автомат «зависает» в выбранном товаре или не возвращается к выбору. Попробуйте другой тип; временно помогает пункт «Сброс сессии» в сервисном меню терминала.

Тип цены

ЗначениеКакую сумму списывает терминалКогда выбирать
Брать из номенклатуры
по умолчанию (пусто = это значение)
«Стоимость (наличные)» из строки планограммы с этим кодом ячейки. Цена, которую прислал автомат, для безналичной оплаты не используется.Цены хотите менять из личного кабинета, не заходя в меню автомата.
Брать из настроек аппаратаЦену, которую прислал автомат, пересчитанную по десятичной точке и коэффициенту.Цены ведутся в самом автомате (или в его телеметрии). Планограмма нужна для названия, НДС и типа позиции в чеке.

Важно для «Брать из номенклатуры». В вендинге для оплаты картой и по СБП терминал берёт цену из колонки Стоимость (наличные); колонка «Стоимость (безналичные)» не применяется. Заполняйте обе колонки одинаково. Держите цены в планограмме и в автомате одинаковыми: автомат показывает покупателю свою цену, а списывается цена из планограммы.

Продажи за наличные при любом типе цены регистрируются на сумму, которую сообщил автомат; цена из планограммы подставляется, только если автомат прислал 0.

Таймауты: какие работают в вендинге

ПолеРаботает в вендингеЧто происходитРекомендуемое значение
Таймаут выбора товара (сек)ДаСтандартный режим: время на выбор товара на автомате после выбора способа оплаты. Always IDLE: время на выбор способа оплаты после выбора товара. По истечении терминал отправляет автомату отказ, отменяет сессию (в стандартном режиме) и возвращается в ожидание. 0 или пусто — ждать без ограничения: сессия останется открытой, пока покупатель не нажмёт «Отмена».30–60
Таймаут показа чека (сек)ДаСколько показывается экран результата с QR-кодом чека и экран ошибки. Затем — возврат в ожидание.5–15
Таймаут оплаты по СБП (сек)ДаСколько ждать оплаты по QR-коду. По истечении — отказ автомату. 0 или пусто — 65 секунд.60–150
Таймаут оплаты по карте (сек)Только с ПО «SkyPos»Время ожидания карты. Для других банковских приложений задаётся самим банковским ПО.Как есть (150)
Таймаут главного экрана (сек)НетНе используется приложением терминала.Пусто
Таймаут ожидания фискализации (сек)Только на сервереОжидание чека при включённой «Обязательности фискализации».5

Учитывайте и таймаут самого автомата: многие автоматы сами отменяют выбор, если оплата не пришла за отведённое время. Таймаут автомата должен быть больше времени оплаты на терминале (особенно для СБП, где покупателю нужно открыть приложение банка), иначе автомат отменит продажу, пока покупатель ещё платит.

Планограмма для вендинга

Планограмма связывает номер товара, который присылает автомат, с позицией номенклатуры. Подробно о вкладке — Планограмма; здесь — что важно именно для вендинга.

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

Внесите в планограмму все товары автомата. Если для присланного кода нет строки или в строке не выбран товар (или позиция удалена из номенклатуры), оплата этого товара на терминале не начнётся, а продажа за наличные по этой ячейке не попадёт в личный кабинет. Автомат через некоторое время сам отменит выбор.

Как узнать коды: сделайте на «Эмуляторе» выбор каждого товара — номер и сумма мелькают внизу экрана терминала в момент запроса; или откройте журнал «MDB логи» точки в разделе Мониторинг.

Экраны терминала и медиа

Экран вендинга один, на нём сменяются шаги. Надписи по умолчанию:

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

Поля блоков (картинка, «во весь экран», видео до 30 МБ, аудио MP3/OGG, тексты, размеры шрифта и цвета) и какие из них реально применяются, описаны в статье Оформление экранов терминала. Для вендинга главное:

  • Экраны вендинга оформляются блоками «Выбор товара на аппарате» и «Выдача товара»; поля блока «Первый экран» на экран вендинга не влияют.
  • Если в блоке «Выбор товара на аппарате» загружено видео, оно показывается вместо картинки — удобно для рекламы и подсказки «как выбрать напиток».
  • Звук для экранов ошибки и результата загружается в их блоках и проигрывается один раз; на время показа QR-кода СБП звук выключается.

Если товар не выдан, оплата не прошла или покупатель отменил

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

Продажа регистрируется в личном кабинете после того, как автомат подтвердил выдачу. Если связи с сервером в этот момент нет, терминал сохранит платёж и отправит его позже.

Покупатель жалуется, что деньги списаны, а товар не выдан:

  1. Найдите операцию в Платежные операции → Платежи по точке и времени; для СБП — в QR-платежи → Операции.
  2. Проверьте, нет ли уже операции возврата (статус «Отозван»).
  3. Если возврата нет — оформите отмену или возврат: Возвраты и отмены. Удалённой команды «выдать товар» для вендингового автомата нет.
  4. Если операции в списке нет, а покупатель предъявляет списание — обратитесь в поддержку JustPay с номером точки, временем и суммой.

Наличные в вендинге

Купюры и монеты принимает автомат своими приёмниками, подключёнными к его контроллеру (или к той же шине MDB). Когда автомат продаёт товар за наличные, он сообщает терминалу номер товара и сумму, и терминал регистрирует продажу в личном кабинете со способом оплаты «Наличные». Чек по ней формируется, если в конфигурации установлен флажок Фискализация наличных операций и к точке подключена касса.

  • Флажок «Включить наличные» в точке для этого не нужен.
  • Сумма — та, что сообщил автомат, пересчитанная по десятичной точке и коэффициенту. Неверные значения этих полей исказят суммы наличных продаж в ЛК.
  • Не все автоматы сообщают кэшлесс-модулю о продажах за наличные — это функция контроллера автомата. Если наличные продажи не появляются в ЛК, проверьте настройку автомата и наличие кода ячейки в планограмме.

Не включайте «Включить наличные» в способах оплаты вендинговой точки. Терминал не принимает купюры: кнопка «Наличные» на его экране сразу разрешает автомату выдачу и регистрирует оплату наличными — покупатель получит товар бесплатно. Подробно — Способы оплаты.

Способы оплаты в вендинге

Способ (точка → «Способы оплаты»)В вендинге
Оплата банковской картойДа — основной способ. Эквайринг подключается через JustPay: мы подаём заявку в банк, а затем устанавливаем и активируем банковское ПО на терминале.
Включить сверкуДа, рекомендуется — автоматическая сверка итогов по картам.
Включить СБПДа — QR-код на экране терминала. Проверьте, что таймаут автомата больше времени оплаты по СБП.
Включить наличныеНет — см. выше.
Включить цифровой рубльТолько по согласованию с поддержкой.
Доступ по карте сотрудникаНет: на экране вендинга нет кнопки карты сотрудника. Не включайте — иначе при одном банковском способе терминал будет показывать экран выбора из одной кнопки.

Телеметрия

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

  • TeWo — в номенклатуре у напитков выбирается «Обработчик» (интеграция TeWo) и «Внешний идентификатор» — номер напитка в TeWo; после оплаты продажа уходит в TeWo. См. Номенклатура.
  • VendoScope — интеграция с передачей платежей и состояния точек.

Собственная телеметрия автомата (модем производителя) работает независимо от JustPay. Состояние самого терминала — связь, заряд, обмен с автоматом по MDB — видно в разделе Мониторинг точки.

Кофемашины Jetinno и другие подключения

Конфигурация «Вендинг» работает только по MDB. Другие варианты подключения устроены иначе:

АвтоматКак подключаетсяКакая конфигурация
Любой автомат с кэшлесс-MDB (кофе, снеки, вода, мороженое, вата)Кабель MDB от контроллера автомата к порту MDB Slave терминала.«Вендинг» (эта статья).
Кофемашины Jetinno с Android-экраномПо сети, без MDB: приложение JustPay связывается с программой кофемашины по TCP (в программе кофемашины в списке серверов указывается адрес 127.0.0.1 и порт 14200). Оплата — QR-кодом СБП на экране кофемашины и/или картой на отдельном терминале.Не «Вендинг»: конфигурация с протоколом Jetinno (POS-точка или POS-точка с реле), кофемашину добавляет в Оборудование вашего кабинета техподдержка JustPay по заявке, к товарам каталога привязываются устройство и номер рецепта. Подключение выполняется вместе с поддержкой JustPay.
Автоматы, управляемые по RS-232/USB, MDB Master, импульсный входОтдельные схемы подключения.В текущей версии приложения для вендинга не поддерживаются — уточните у поддержки.

Подключение терминала к автомату

Общий порядок для WizarPOS Q3V («Салют 3В ПРО»). Схемы подключения для конкретных моделей автоматов выдаёт поддержка JustPay.

  1. Выключите автомат. Все подключения к шине MDB делайте только при выключенном питании.
  2. Закрепите терминал в штатном месте под кэшлесс-модуль (обычно на двери автомата).
  3. Подключите MDB-кабель: один конец — в MDB-разъём контроллера автомата (или в свободное гнездо шины MDB, если на ней уже есть купюроприёмник), другой — в порт MDB Slave интерфейсной платы терминала. Порт MDB Master не используйте.
  4. Питание терминал получает от автомата по тому же MDB-кабелю (24 В). Отдельный блок питания при подключении по MDB не нужен.
  5. Убедитесь, что у терминала есть связь: SIM-карта или Wi-Fi — Сеть терминала. Какую SIM-карту поставить, лучше согласовать с поддержкой JustPay.
  6. Включите автомат. Терминал загрузится, приложение JustPay запустится само. В меню автомата включите безналичный модуль (cashless), если он выключен.
  7. Если терминал ещё не привязан к точке — введите PIN-токен: Токен и PIN-токен. После привязки перезагрузите терминал вместе с автоматом.
СхемаЧто подключеноОсобенности
MDB SlaveТерминал — единственное платёжное устройство на шине.Чеки через JustPAY только по безналичным оплатам.
MDB Slave + наличныеНа той же шине купюроприёмник/монетоприёмник.Продажи за наличные автомат сообщает терминалу; чеки через JustPAY по всем операциям.
MDB Slave + модем телеметрииНа шине есть модем телеметрии, который сам фискализирует продажи.Фискализацию ведёт модем: выключите в конфигурации флажки фискализации, чтобы не было двойных чеков.

Настройка точки вендинга с нуля

  1. Оставьте заявку в JustPay (8 (800) 33 33 175, /zayavka_help): эквайринг, при необходимости СБП и облачная касса. Мы подадим заявки в банк и партнёрам, а техподдержка добавит терминал в ваш кабинет. Пока заявка в работе, выполняйте следующие шаги.
  2. Узнайте параметры автомата. В сервисном меню автомата: как хранятся цены (десятичная точка, коэффициент/шаг цены), коды товаров, поддерживается ли Always Idle, сообщает ли автомат о продажах за наличные.
  3. Заведите номенклатуру — позицию на каждый напиток или товар: название как на кнопке автомата, тип «Товар», цена, ставка НДС. Номенклатура.
  4. Создайте конфигурацию: Точки обслуживания → Конфигурации → Добавить, тип «Вендинг», понятное название («Кофейный автомат, 12 напитков»), статус «Активная».
  5. Планограмма: строка на каждый код товара автомата, товар из номенклатуры, одинаковые цены в обеих колонках.
  6. Настройки: установите «Подключение MDB», «Способ подключения» — «MDB Slave», «Десятичная точка» и «Коэффициент масштабирования» — как в автомате, «Максимальная сумма кредита» — не меньше самой дорогой цены (в единицах автомата), «Режим Always IDLE» — по сценарию, «Тип устройства», «Тип цены». Таймауты: выбора товара 30–60, показа чека 5–15, СБП 60–150.
  7. Интерфейс (по желанию): картинки, видео и звук для «Выбор товара на аппарате» и «Выдача товара».
  8. Нажмите Сохранить.
  9. Точка обслуживания: создайте точку или откройте существующую, выберите эту конфигурацию, на вкладке «Способы оплаты» включите карту (для начала — вид ПО «Эмулятор»), сверку, при необходимости СБП; «Включить наличные» не включайте. На вкладке «Оборудование» выберите терминал и кассу (если нужны чеки) — их добавляет в кабинет JustPay. Точки обслуживания.
  10. Подключите терминал к автомату и привяжите к точке (раздел выше).
  11. Проверьте каждую позицию на «Эмуляторе»: выберите товар на автомате, сверьте сумму на терминале с ценой автомата, нажмите «Подвердить» в окне эмулятора — автомат должен выдать товар, а платёж появиться в ЛК с правильным названием. Проверьте кнопку «Отмена» и отказ («Отменить» в окне эмулятора).
  12. Переключите на банковское ПО (его устанавливает и активирует JustPay при подключении эквайринга): в точке смените «Вид банковского ПО» на реальное, отправьте задание «Обновление конфигурации», сделайте одну покупку реальной картой.
  13. Проверьте в Мониторинге, что точка на связи и в «MDB логах» идёт обмен с автоматом.

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

Когда изменения дойдут до терминала

Что изменилиЗадание
Цены и товары в планограмме, номенклатуру«Обновление параметров» — без перезапуска.
Параметры MDB: десятичная точка, коэффициент, кредит, Always IDLE, тип устройства«Обновление конфигурации» — приложение перезапустится и заново подключится к автомату с новыми параметрами.
Таймауты, тип цены, оформление экранов«Обновление конфигурации» (надёжный вариант).
Способы оплаты точки, банковское ПОПо таблице в статье Способы оплаты.

Как отправить задание — Задания и сверка итогов. Если конфигурация назначена нескольким точкам, задание нужно каждой.

Частые проблемы

Что происходитПричинаЧто сделать
Сумма на терминале в 10 или 100 раз больше или меньше цены автомата«Десятичная точка» или «Коэффициент масштабирования» не совпадают с автоматом.Сверьте с настройками кэшлесс автомата, исправьте, отправьте «Обновление конфигурации».
Сумма отличается от цены на автомате, но не в 10 раз«Тип цены» = «Брать из номенклатуры», а цена в планограмме другая.Выровняйте цены в планограмме («Стоимость (наличные)») и в автомате или выберите «Брать из настроек аппарата».
Товар выбран, на терминале ничего не происходитКод товара не внесён в планограмму или в строке нет товара; при Always IDLE — автомат не поддерживает этот режим; таймаут автомата слишком короткий.Проверьте код в «MDB логах», заполните планограмму, снимите Always IDLE; отправьте задание.
Автомат не видит терминал, пишет об ошибке кэшлесс-устройстваКабель в порту MDB Master или плохой контакт; кэшлесс выключен в меню автомата; «Подключение MDB» не установлено, коэффициент 0.Проверьте кабель и порт MDB Slave, включите кэшлесс в автомате, заполните параметры MDB, перезагрузите автомат.
Автомат «завис» в выбранном товаре после отменыНеподходящий «Тип устройства».Сервисное меню терминала → «Сброс сессии»; смените «Тип устройства».
Не выбираются дорогие напитки, автомат пишет «недостаточно средств»Мала «Максимальная сумма кредита» (стандартный режим) или задана больше 65535.Укажите кредит не меньше максимальной цены, но не больше 65535.
Терминал долго висит на «ВЫБЕРИТЕ ТОВАР…» после ухода покупателя«Таймаут выбора товара» пустой или 0.Задайте 30–60 секунд.
Деньги списаны, товар не выданОшибка выдачи в автомате; автоматическая отмена не поддерживается банковским ПО или оплата была по СБП.Оформите возврат — Возвраты и отмены; устраните причину в автомате.
Товар выдаётся без оплатыВ точке включены «Наличные» или выбран «Эмулятор».Снимите «Включить наличные», смените вид банковского ПО.
Продажи за наличные не видны в ЛКАвтомат не передаёт кэшлесс-модулю продажи за наличные; кода ячейки нет в планограмме.Включите функцию в автомате, если она есть; заполните планограмму.
Наличные продажи в ЛК с неверной суммойНеверные десятичная точка или коэффициент.Исправьте параметры MDB.
Оплата по СБП проходит, но автомат уже отменил выборТаймаут автомата меньше времени, нужного покупателю на оплату QR-кода.Увеличьте таймаут в автомате или уменьшите «Таймаут оплаты по СБП».
Изменения не применилисьНе отправлено задание или точка не на связи.Отправьте задание по таблице выше, проверьте Мониторинг.

Что дальше