Интеграция с системой продажи лотерейных билетов Столото (₽)

Описание

Столото – это сервис продажи лотерейных билетов, взаимодействующий с внешней товаро-учетной системой, а также с кассовой программой УКМ 5 согласно следующей схеме:

Пояснения к схеме:

Настройки

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

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

1. Ретейлер сообщает сервису Столото количество касс, которое необходимо подключить к лотерейному серверу, и одновременно получает от него

   инструкцию для генерации сертификатов.

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

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

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

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

2. Скачанный архив необходимо открыть и добавить файл loto.conf в папку applications/sale/ и файл loto.js в папку applications/sale/scripts/.

3. После добавления файлов нужно сделать импорт конфигурации типа кассы при помощи кнопки Импорт:

4. Далее, в файле conf/applications/sale/sale.conf необходимо добавить в раздел plugins следующий параметр:

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

5. Затем нужно отредактировать файл loto.conf, указав в нем следующее:

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

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

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

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

Посредством OpenSSL, необходимо создать файл пары "ключ-сертификат" и поместить в хранилище с помощью утилиты KeyStoreExplorer (open-source).

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

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

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

Формат параметра: ХХХХ: Название; 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) «Золотая подкова»

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

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

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

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

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

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

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

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

В конфигурационном файле нужно найти указанную цифру или добавить указанный ниже новый блок (если блок располагается последним, то следует обратить внимание на запятую перед закрывающими скобками предыдущего блока) и изменить значение параметра 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, после чего сохранить изменения.

Настройки на каждой кассе

Разместить соответствующий терминалу-кассе файл с хранилищем сертификата по пути, указанному в конфигурационном файле loto.conf (applications/sale/loto.conf).

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

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

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

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

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

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

3. Продажа лотерейных билетов поддержана для следующих типов ККТ:

• СП 402;
• СП 802;
• Чеквей 77-Ф;
• Пирит.

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

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

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

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

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

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

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

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

Возвраты

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

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

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

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

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

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

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

Продажа лотерейного билета

Отмена покупки лотерейного билета

Отмена чека с лотерейными билетами

Ошибки: отсутствие связи с сервером