• Ready for review

    • Scan-Box. Подключение и настройка

    Owned by Динара Биктимирова
    Dec 05, 2024
    3 min read

    Это многофункциональное устройство с эквайринговым терминалом Vendista и сканером QR-кодов.
    Может использоваться как дополнительный инструмент системы лояльности: выдача бесплатного кофе по QR-коду для привлечения трафика на точку или для увеличения среднего чека.

    Комплект оборудования

    • Модем «Оптима» версии 2.11

    • Кабель «Cable U-001-MDB»

    • Терминал «Вендиста» версии 2.5 на подставке

    • Кабель «Scan-Box 2.0» 

    • Сканнер QR

    image-20241205-130202.png
    Модем «Оптима» версии 2.11
    image-20241205-130216.png
    Кабель «Cable U-001-MDB»

    Подключение

    Кабель U-001 подключается в модем:

    Ниже указано назначение разъемов для подключения кабеля «Scan-Box 2.0»:

    Готовый к подключению комплект выглядит так:

    Настройка

    1. Подключить Сканбокс к торговому автомату.

    2. Настроить торговый автомат:

      1. Включен режим оплаты — MDB.

      2. Товарам присвоены номера (в большинстве автоматов номер товару присваивается автоматически) и цены.
        В зависимости от модели автомата способ настройки может отличаться. Настройки следует выполнять по инструкции к модели вашего автомата.

    3. Провести интеграцию кассы по API Телеметрон.

    Интеграция кассы по API Телеметрон

    Получение токена

    Для получения персонального токена, по которому происходит авторизация на сервере, обратитесь в техническую поддержку Телеметрон: https://telemetron.ru/contacts/contact
    support@telemetron.ru
    8 (800) 555-26-32 (доб. 2),
    8 (812) 313-29-83 (доб. 2)
    Режим работы: ежедневно с 8:00 до 20:00 (звонок на номер 8-800 по России бесплатный).

    Генерация Qr кода

    Кассовый аппарат или приложение партнера отправляют необходимые поля на сервер. Генерация QR кодов происходит произвольно от “00000000001“ до “99999999999“, за счет этого обеспечивается защита от перебора. 

    REQUEST BODY SCHEMA: application/json

    token
    required

    string </[a-zA-Z0-9]{32}/>

    Токен партнера (соотв. регулярке /^[a-zA-Z0-9]{32}$/)

    qr_type
    required

    number <3>

    Тип QR-кода (1, 2).

    1. Система лояльности — qr коды, которые выдаются по системе лояльности. Данный тип нужен для отсеивания продаж и подарков.

    2. Обычный — любой qr код за оплату

    amount
    required

    number <11>

    Цена напитка. (Передавать умножая на 100).
    Не может быть меньше 1 руб.

    id_product
    required

    number <11>

    Номер продукта. Номера должны соответствовать номерам на торговом автомате.

    qr_lifetime
    required

    string

    Время жизни (timestamp в формате ISO 8614). Не может быть меньше времени запроса

    imei

    Array of strings </^\d{15,16}$/>

    Список IMEI (напечатан на лицевой стороне модема Оптима)

    param

    Array of objects

    Массив произвольных параметров. В настоящее время не используется

    Responses

    200 Успешная генерация/Ответ с ошибкой

    result

    integer

    Значения:

    • 0 - Всё ок

    qr_id

    integer <11>

    Конвертация уникального номера qr_id в Qr код

    Реализуется Вами самостоятельно в приложении или кассе.

    Проверка

    После выполнения всех предыдущих этапов можно приступать к проверке работы комплекта. Для этого: 

    1. Сгенерируем QR код существующего товара/напитка.

    2. Выберем данный напиток в автомате.
      При корректном подключении изображение на терминале примет вид «оплатите картой или отсканируйте QR».

    3. Отсканируйте QR код.

    При успешном сценарии сканер моргнет зеленым светом и модем издаст характерный звуковой сигнал, после чего последует выдача напитка.