Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Потоки данных

Комментарий

1

Типовой обмен данными между внешней системой товародвижения и кассовым решением СуперМаг УКМ 5. Используется стандартный конвертер обмена Импорт/Экспорт XML (версия 1.0), реализованный в кассовом решении.

2

Внутренний протокол обмена данными решения СуперМаг УКМ 5.

3

Протокол обмена данными с сервисом Столото.

Настройки

Регистрация кассы на лотерейном сервере

Каждую кассу, на которой предполагается продавать лотерейные билеты Столото, необходимо зарегистрировать на лотерейном сервере. Делается это следующим образом:

  1. Ретейлер сообщает сервису Столото количество касс, которое необходимо подключить к лотерейному серверу, и одновременно получает от него инструкцию для генерации сертификатов.
  2. Сервис Столото присваивает каждой кассе уникальный номер.
  3. Сервис Столото сообщает ретейлеру уникальные номера, присвоенные кассам.
  4. С помощью утилиты генерации, ретейлер формирует файлы с сертификатами для каждой кассы, либо один сертификат для всех касс.
  5. Ретейлер выполняет действия по настройке касс, описанные ниже.

Настройки касс

1. Взаимодействие УКМ 5 с системой Столото происходит через защищённый протокол. В этой связи, необходимо сгенерировать клиентский сертификат и ключ от него, руководствуясь инструкциями и требованиями*.

* Актуальную информацию по требованиям и инструкцию по генерации клиентских сертификатов необходимо уточнять у представителей сервиса Столото.

Попробуйте на тестовой кассе выполнить следующую команду из папки, где лежат присланные сервисом Столото crt- и key-файлы (после выполнения удалите их с тестовой кассы):

openssl pkcs12 -export -in <name.crt> -inkey <name.key> -name 'name' -out keystore.p12

Замените, соответственно, на имена файлов <name.crt>, <name.key> и 'name' (имя можно указать любое, например, номер терминала).

...

Пароль от хранилища необходимо прописать в параметре keyStorePassword, который был указан на этапе создания хранилища.

...

Формат параметра: ХХХХ: Название; YYYY: Название, где ХХХХ, YYYY – Код лотереи (GAME_ID),  Название – название лотереи, как должно быть в чеке.

Например:

5101: Лото – Спортлото 6 из 45;

5536: Лото – Спортлото 5 из 36 (+1);

4420: Лото – Спортлото 4 из 20;

5150: Лото – Спортлото 7 из 49;

7105: Бинго – Жилищная лотерея;

7115: Бинго – Золотая подкова;

7103: Бинго – Русское лото.

Числовые лотереи:

(4420) «Спортлото «4 из 20»

(5536) «Спортлото «5х36»

(5101) «Спортлото «6х45»

(5150) «Спортлото «7х49»

Бинго-лотереи:

(7103) «Русское лото»

(7105) «Жилищная лотерея»

(7115) «Золотая подкова»

4. В справочник товаров необходимо загрузить из внешней товароучетой системы единую универсальную товарную позицию, идентифицирующую продажу лотерейного билета. Розничная цена для такой позиции всегда составляет 1 руб. Минимальная цена также равна 1 руб. Код товара – goodsId – идентифицирует продажу лотерейного билета.

5. Настройки кассы происходят на кассовом сервере УКМ 5 по адресу: Магазин – Типы касс, где нужно выбрать тип кассы и нажать кнопку Настройки:

Image Removed

В появившемся иерархическом древе в файле sale.conf (applications/sale/sale.conf) необходимо добавить в раздел plugins следующий параметр:

{ include file("conf/applications/sale/loto.conf") }

6. Затем нужно отредактировать файл loto.conf (applications/sale/loto.conf), указав в нем следующее:

  • baseUrl – адрес шлюза (высылается сервисом Столото);
  • responseTimeout – тайм-аут ожидания ответа от лотерейной системы;
  • keyStorePath – путь до хранилища ключей;
  • keyStorePassword – пароль к хранилищу ключей;
  • gamesNames – названия тиражей.

7. Все изменения нужно сохранить.

8. Далее, нужно пройти на кассовом сервере по адресу: Оборудование – Шаблоны нужно выбрать шаблон оборудования и нажать кнопку Оборудование:

Image Removed

В иерархическом древе появится файл loto.conf (misc/loto.conf), в котором необходимо указать параметр terminalNumber (terminal_id). Он высылается представителями Столото, которые распределяются по кассам самим ретейлером. С технической точки зрения, не имеет значения, какой кассе будет присвоен определенный terminal_id. Главное правило – присваивать по одному terminal_id каждой кассе. Ретейлеру в будущем рекомендуется отслеживать данный момент при изменении настроек, перезаливке касс и т. д.

...

Настройка кнопки, вызывающей меню продажи лотерейного билета на клавиатурной кассе, происходит на кассовом сервере по адресу: Оборудование – Шаблоны. В столбце Шаблоны оборудования необходимо выбрать название кассы и нажать кнопку Оборудование:

Image Removed

В появившемся иерархическом древе нужно открыть для просмотра файл keyboardLaoyout.conf (/hardware/keyboard_layout/keyboardLaoyout.conf) и выяснить, какой конфигурационный файл используется на данной кассе (он должен быть раскомментирован):

Image Removed

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

- необходимо подключить клавиатуру к компьютеру и убедиться, что драйверы установлены и клавиатура работоспособна;

- затем нужно перейти на любой сайт, где можно определить скан-коды (можно найти в google, например: https://keycode.info/;

- будучи на главной странице сайта, необходимо нажать нужную клавишу на клавиатуре и запомнить сгенерированный код:

Image Removed

В конфигурационном файле нужно найти указанную цифру или добавить указанный ниже новый блок (если блок располагается последним, то следует обратить внимание на запятую перед закрывающими скобками предыдущего блока) и изменить значение параметра params: вместо None нужно указать AddLoto, в итоге чего блок будет выглядеть примерно так:

{

              code : 115, // F4

              type : "UIAction",

              params : "AddLoto" # F4 – Вызов кассовой функции "Продажа лотерейного билета"

}

Внесенные изменения необходимо сохранить. Также можно изменить функционал одной из неиспользуемых кнопок, заменив значение параметра params на AddLoto.

Настройки для touch-кассы

Чтобы в интерфейсе touch-кассы появилась кнопка вызова функции Продажа лотерейного билета, необходимо на кассовом сервере УКМ 5 по адресу: Магазин – Типы касс выбрать тип кассы и нажать кнопку Настройки:

Image Removed

В появившемся иерархическом древе нужно найти файл sale.conf (conf/applications/sale/sale.conf) и добавить в раздел ui параметр useLoto = true, после чего сохранить изменения.

Требования к ККТ

1. Для продажи лотерей требуется перерегистрация ККТ с установкой признаков в разделе дополнительных реквизитов отчета о регистрации и отчета об изменении параметров регистрации:

   - ФФД 1.05: тег 1126 – признак проведения лотереи;

   - ФФД 1.2: тег 1205, бит 20 – перевод ККТ из режима, не позволяющего применять ККТ при приеме денежных средств в процессе реализации лотерейных билетов, в режим, позволяющий применять ККТ при приеме денежных средств в процессе реализации лотерейных билетов.

2. В чеках продажи лотерейный билет регистрируется как обычный товар с предварительно заданным SKU.

В электронной форме чека для товара должен быть установлен тег 1212 = 7.

Ввод товарных позиций

  • Лотерейные билеты продаются только в отдельных чеках (т.е. в один и тот же чек не могут быть добавлены обычные товары и лотерейный билет).
  • В один чек можно одновременно добавить несколько лотерейных билетов.

Применение скидок

  • На лотерейные билеты не действуют никакие скидки.
  • Оплата лотерейного билета бонусами невозможна.
  • Предполагается, что пользователи систем лояльности (к примеру, LOYA) не будут использовать позиции лотерейных билетов в качестве вознаграждений, выдаваемых вне кассовой операции продажи (т.е. просто раздавать на кассе, не добавляя в чек продажи, например). Программный запрет на это не реализован.

Возрастные ограничения

  • В случае, если в кассовом решении УКМ 5 необходимо использовать возможности по контролю возрастных ограничений, то для товарных позиций, являющихся лотерейными билетами, устанавливается атрибут Табак. Таким образом, касса будет требовать произвести проверку возраста покупателя сразу после считывания штрихкода лотерейного билета:

Image Removed

Регистрация телефонного номера покупателя

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

Возвраты

  • Возврат лотерейных билетов запрещен.

Печать уведомлений

  • Уведомления о продаже лотерейных билетов печатаются всегда – слипом после окончания чека.

  • В случае печати копии чека, уведомления печатаются повторно – вместе с копией чека. 

Image Removed

Продажа лотерейных билетов на КСО

  • Продажа лотерейных билетов запрещена на КСО.

Кассовые операции с лотерейными билетами

...

ОТСУТСТВИЕ СВЯЗИ С СЕРВЕРОМ СТОЛОТО
Клавиатурная кассаTouch-касса

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

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

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

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

Настройки

Настройки интеграции с системой Столото описаны здесь.