Дерево страниц
Перейти к концу метаданных
Переход к началу метаданных

Настройки взаимодействия с системой продажи лотерейных билетов Столото производятся в несколько этапов, подробно описанных в данной статье.

В рамках интеграции с кассовым ПО УКМ 5, реализована поддержка определенной части функционала Столото, а именно: продажи билетов лотерей типа "Лото" и "Бинго" (точный список лотерей приведен ниже) с указанием комбинации через сканирование купона/бланка.

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

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

  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' (имя можно указать любое, например, номер терминала).

При создании файла, система запросит ввод пароля, придумайте и введите пароль.

2. Созданное хранилище ключей keyStore.p12 нужно поместить на кассу в домашний каталог пользователя ~/.config/keys/keyStore.p12 и прописать полный путь до файла хранилища в значении параметра keyStorePath.

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

3. Названия лотерей задаются параметром gamesNames.

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

На текущий момент, гарантированно поддержана продажа билетов следующих лотерей:

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

- «Спортлото «4 из 20»

- «Спортлото «5х36»

- «Спортлото «6х45»

- «Спортлото «7х49»

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

- «Русское лото»

- «Жилищная лотерея»

- «Золотая подкова».

Указанный список типов лотерей может бы расширен, при условии согласования со Столото и представителем нашей компании. 

4. В справочник товаров необходимо загрузить из внешней товаро-учетной системы уникальную товарную позицию, идентифицирующую продажу лотерейного билета определенного типа лотереи. Для каждого типа лотереи потребуется создать отдельную товарную позицию. Для такой позиции должна быть всегда назначена какая-то розничная цена (на кассе, в любом случае, каждый лотерейный билет будет продан по актуальной цене на него) и равная розничной цене минимальная цена. Параметр goodsIds содержит перечисление кодов лотерей и соответствующих им артикулов. Таким образом, по статистике продаж определенного артикула можно судить о продажах билетов того или иного типа лотереи.

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

В появившемся иерархическом древе в файле 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. Далее, нужно на кассовом сервере по адресу: Магазин – Кассы выбрать необходимую кассу и нажать кнопку Оборудование:

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

Настройка кнопки для клавиатурной кассы

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

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

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

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

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

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

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

{

              code : 115, // F4

              type : "UIAction",

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

}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвраты

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

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

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

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

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

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