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

Описание

Столото – это сервис продажи лотерейных билетов, взаимодействующий с внешней товаро-учетной системой, а также с кассовой программой УКМ 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),  Название – название лотереи, как должно быть в чеке.

Например:

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 по адресу: Магазин – Типы касс, где нужно выбрать тип кассы и нажать кнопку Настройки:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвраты

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

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

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

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

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

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

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

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

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

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

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