Установка плагина StoLoto

ВАЖНО!!!Модуль должен быть установлен на каждый узел топологии сети - на сервера и на кассы. То есть, если в сети магазинов используется сервер ЦО Set Centrum10 и серверы магазинов Set Retail 10, то модуль должен быть на каждом из них.

На сервер/кассу требуется установка модуля СТОЛОТО последней актуальной версии.

     Для установки модуля на сервер, скопируйте файл StolotoPlugin-х.х.jar в папку \\SetRetail10\plugins\ на каждом узле топологии и перезапустите службу SetRetail10.

     Для установки модуля на кассу, скопируйте файл StolotoPlugin-х.х.jar в папку /home/tc/storage/crystal-cash/plugins/ и перезагрузите кассовый модуль.

*Начиная с версии 10.2.60.0 плагин входит в дистрибутив SetRetail10 и установки не требует.

*Начиная с версии 10.2.94.0 доступны выплаты по выигрышным лотерейным билетам на клавиатурных кассах.

*Начиная с версии 10.2.96.0 доступны выплаты по выигрышным лотерейным билетам на touch-кассах.

На кассе для запуска необходимо обеспечить доступность адресов:

• https://activate.csi.russian-lotteries.net:60445/api/ (или https://activate.test-csi.russian-lotteries.net:60445/api/  для тестового контура) - адрес для активации кассы, указывается в Set10

• Порт 60443– порт для совершения транзакций продажи лотерейных билетов на кассе
• адрес сервера СИС

Все порты используют протокол TCP.

Доступа на внешние адреса для серверов Set Centrum10 и SetRetail10 не требуется.

Настройка работы с лотерейными продуктами

Для настройки перейдите в модуль  -  – .

Из списка выберите  и поставить галочку для Плагина Столото.

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

Для дальнейшей настройки необходимо выделить процессинг и двойным шелчком мыши перейти в режим редактирования настроек.

Если настройка производится на сервере Set Centrum, на сервере магазина изменение настроек будет недоступно.

Если необходимо вносить разные настройки для каждого магазина – установите флаг "галку" «Настраивается в магазине».

Вкладка «Общие»

Пример заполненных настроек вкладки «Общие»:

Настройки

• Адрес сервиса активации – адрес сервиса Столото, на который будет обращаться касса в процессе активации.

                  Адрес тестового контура Столото https://activate.test-csi.russian-lotteries.net:60445

                  Адрес продуктивного контура Столото https://activate.csi.russian-lotteries.net:60445

• Адрес сервиса регистрации – адрес сервиса СИС, на котором касса будет получать необходимые для работы параметры.

           адрес сервера СИС в формате http://XXX.XXX.XXX.XXX:9080/RegistrationService/api/registration/

• Адрес сервиса регистрации продаж - адрес сервиса СИС, на который касса будет передавать совершенные продажи.

           адрес сервера СИС в формате http://XXX.XXX.XXX.XXX:9080/PurchaseService/api/purchase/

• Таймаут обращения к серверу (в мс) – таймаут ожидания ответа от сервера Лотерей при выполнении запроса. ВНИМАНИЕ!!! Тайм-аут не может быть меньше чем 15000 мс.
• Печать предчека – флаг "галка" указывает есть ли необходимость печатать предчек перед регистрацией лотереи. Предчек представляет собой нефискальный документ, который необходим для подтверждения ставки и введенного номера телефона покупателем. Обязательным элементом процесса предчек не является, так как в любом случае введенный номер отобразится на дисплее покупателя, а на дисплее кассира будет показано соответствующее подтверждение.
• Отключить кассовый сменный отчет - отключение отчета по сменам на кассе.
• Максимальная сумма выигрыша в рублях (выплата) - максимальная сумма выплаты по одному выигрышному лотерейному билету, доступная на кассе. Значение по умолчанию 14999 руб.
• Количество выигрышей в одном чеке (выплата) - максимальное количество выплат по лотерейным билетам доступным для одного чека. Значение по умолчанию 3 выплаты в одом чеке.
• Запрет других товаров в чеке  (выплата) - данная настройка отвечает за контроль совместимости в рамках одного чека выплат по лотерейным билетам и нелотерейных продуктов.

Вкладка «Товар»

Вкладка содержит настройки, связанные с бизнес-процессами на кассе:

Настройки

• Проверять возраст покупателя – необходимо значение «Да» (не выставлено по умолчанию), так как это требование законодательства.
• Разрешить применение скидок Set10 – необходимо значение «Нет» (выставлено по умолчанию), так как по законодательству лотереи не могут быть понижены в цене.
• Разрешить применение бонусов как скидки или внешних скидок – необходимо значение «Нет» (выставлено по умолчанию), так как по законодательству лотереи не могут быть понижены в цене.
• Разрешить группировку в чеке в одну позицию – необходимо значение «Нет» (выставлено по умолчанию), так как каждый купон – уникален.
• Разрешить возврат товара – необходимо значение «Нет» (выставлено по умолчанию), так как по законодательству лотереи не могут быть возвращены.
• Только один товар в чеке – может быть изменено. По умолчанию – «Нет». Можно добавить контроль при необходимости. Зависит от внутренних процессов сети магазинов.
• Несовместимость в чеке с товарами другого типа – может быть изменено. По умолчанию – «Нет». Данная настройка отвечает за контроль совместимости в рамках одного чека лотерейных и нелотерейных продуктов. При выставлении настройки, на кассе невозможно будет в одном чеке зарегистрировать лотерейный купон и любой другой продукт.
• Данный товар разрешено оплачивать – в рамках этой настройки можно ограничить типы оплат, которыми можно оплатить лотерейные продукты. Настройка будет работать только при выставлении галки настройки «Несовместимость в чеке с товарами другого типа». В противном случае настройка работать не будет. При выборе из списка типов оплат, на кассе будут доступны только те из них, которые разрешены присвоенному шаблону касс.
• Признак способа рассчета в рамках требований ФФД – необходимо значение «4» (выставлено по умолчанию), так как это требование законодательства. 
• Признак предмета рассчета в рамках требований ФФД – необходимо значение «1» (выставлено по умолчанию), так как это требование законодательства. 

Настройка шаблона группы касс

Для настройки перейдите в модуль  -  – далее откройте кассовый шаблон для редактирования и перейдите на вкладку 

В списке товаров необходимо выбрать , как показано ниже.

После чего нажать , для сохранения и применения настроек для данного шаблона группы касс.

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

Выплаты. Добавление в меню кнопки "Чек Расхода"

Для настройки перейдите в модуль  -  – далее откройте кассовый шаблон для редактирования и перейдите на вкладку .

Далее нажимаем и переходим в режим редактирования кассового меню. Выбираем вкладку - .

Добавляем новый пункт в меню, для этого выбираем любую свободную ячейку в меню1, например 5 

Нажимаем  и в открывшемся окне добавляем кнопку "Чек Расхода", для этого выбираем в окне клавиши - 

Далее в открывшемся списке выбираем функцию - Чек Расхода.

Добавляем название кнопки меню - Чек Расхода, и нажимаем .

В кассовое меню добавлена новая кнопка - 

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

Применение настроек на кассе

После установки всех необходимых настроек на кассовом сервере SetRetail10, необходимо:

1. Осуществите активацию договора на сервере СИС. Привяжите магазины к договору.

2. Дождитесь получения настроек на кассе с кассового сервера. При получении настроек индикатор в правом нижнем углу экрана начинает мигать. После окончания загрузки индикатор виден, но не мигает:

3. Перезагрузите кассу:

Первая загрузка кассы после установки модуля может занимать значительное время (до 5 минут).

Это связано с процедурами активации кассы на сервере Столото. При последующих перезагрузках такого эффекта не будет.

Перерегистрация кассы

При необходимости кассу можно перерегистрировать, для получения нового номера ID терминала, для этого необходимо:

 - подключиться к кассе, например через SSH/WinSCP

-  далее на кассе перейти в каталог \storage\crystal-cash\config\plugins\ и удалить файлы stoloto-game-type.json и stoloto-plugin.properties

- далее перейти в каталог на кассе \storage\crystal-cash\config\plugins\ks и удалить ключи.

- перезагрузить кассу

После перезагрузки проверить получила ли касса новые ключи и создала файлы настроек для СТОЛОТО.