История страницы

Описание

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

...

Настройки

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

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

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

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

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

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

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

Image Removed

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

Image Removed

...

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

Image Removed

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. Согласно инструкциям и требованиям*, необходимо сгенерировать клиентский сертификат и ключ от него.

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

Посредством 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 – идентифицирует продажу лотерейного билета.

...

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

Image Removed

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

Image Removed

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

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

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

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

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, после чего сохранить изменения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвраты

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

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

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

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

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

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

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

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

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

ОТМЕНА

ПОКУПКИ

ПОЗИЦИИ
Клавиатурная касса	Touch-касса
1. Если лотерейный билет, который требуется удалить, не отмечен (не выделен) в составе чека, то необходимо вызвать кассовое меню с помощью запрограммированной кнопки: Image Modified 2. В меню нужно воспользоваться опцией Изменение чека: Image Modified 3. Если же лотерейный билет, который требуется удалить, отмечен (выделен) в составе чека, то также необходимо вызвать кассовое меню:  Image Modified 4. Для выделенного билета в кассовом меню сразу будет доступна опция Удалить позицию: Image Modified 5. Запись об удаленном лотерейном билете отображается в зачеркнутом виде в начале состава чека: Image Modified

Image Removed

1. Удаление лотерейного билета из состава чека происходит штатным образом: достаточно просто отметить его в списке и воспользоваться кнопкой отмены товарной позиции:  Image Added 2. Запись об удаленном лотерейном билете отображается в зачеркнутом виде в начале состава чека: Image Modified

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

Image Removed

ОТМЕНА ЧЕКА
Клавиатурная касса	Touch-касса
1. Полностью отменить чек можно не зависимо от того, сколько в нем лотерейных билетов и какие из них уже удалены. Для этого необходимо вызвать кассовое меню с помощью специальной кнопки: Image Modified 2. В кассовом меню сразу будет доступна искомая операция: Image Modified Image Modified

Image Removed

Полностью отменить чек можно не зависимо от того, сколько в нем лотерейных билетов и какие из них уже удалены. Отмена чека с лотерейными билетами производится с помощью штатной кнопки: Image Added Image Added

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

ОТСУТСТВИЕ СВЯЗИ С СЕРВЕРОМ СТОЛОТО
Клавиатурная касса	Touch-касса
1. При отсутствии интернет-соединения или в силу иных причин, связь с лотерейным сервером периодически может прерываться. В случае отсутствия связи с сервером Столото, невозможно полноценно произвести отмену лотерейного билета в чеке. Касса обязательно сообщит об этом и запросит разрешение повторить попытку связаться с сервером Столото: Image Added 2. Если, в итоге всех предпринятых попыток, связь с сервером так и не восстановится, то касса

Image Removed

Image Removed

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

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

Настройки

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