В этой статье будет рассмотрен вариант продажи порционного алкоголя через r_keeper 7 и ЕГАИС без использования StoreHouse 5.

Описанные настройки предполагают работу только с чистым алкоголем без продажи коктейлей.

Контроль марок происходит на стороне ЕГАИС.

Интеграция с ЕГАИС

Интеграция r_keeper 7 c системой ЕГАИС позволяет выполнить проверку и печать отдельным документом информации о подлинности покупаемого клиентом алкоголя при оформлении чека продажи.

Имея на руках документ с QR-кодом, клиент может самостоятельно считать код на мобильном устройстве, перейти на сайт ФСРАР и проверить подлинность приобретаемой алкогольной продукции.

Технология работы

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

  • штрих-код с этикетки алкогольной продукции EAN13
  • акцизная марка — будет выполнена попытка верификации товара через Универсальный транспортный модуль (далее УТМ).

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

Если проверка по каким-либо причинам не прошла (нет связи с УТМ, не оформленный алкоголь и прочее), закрыть заказ с оплатой, пока в нем находится непроверенный алкоголь, система не даст.

Вскрытые до 01.07.2024 бутылки считаются полностью списанными, их не нужно передавать в УТМ. Если при продаже алкоголя используется бутылка, вскрытая до 01.07.2024, то сканировать реальную марку с бутылки не надо. Необходимо использовать техническую марку.

Последовательность: {EAA0ECBE-CB14-443F-9676-EE3336CF79B4}

Если QR будет генерироваться в специальных сервисах генерации QR-кодов, то необходимо использовать всю последовательность, включая {}

Схема взаимодействия модулей

  • Запрос: Касса > Кассовый сервер > ПДС интерфейс(логический) > ПДС-интерфейс > FARCARDS > ExtdllEGAIS.dll > УТМ > ФСРАР.
  • Ответ: по обратной цепочке.

Farcards  должен быть запущен раньше Кассового сервера.


Системные требования

  • r_keeper 7.07.00.322 и выше
  • Сканер штрих кодов, основное требование к сканеру — поддержка штрих-кодов в формате PDF417, а также поддержка в r_k 7 
  • Farcards 604
  • Интерфейсная библиотека для Farcards ExtdllEGAIS.dll. 2.4.0.10.

Установка и настройка

УТМ

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

Если на предприятии уже установлен модуль УТМ (например, для системы StoreHouse), его можно задействовать для интеграции с r_keeper 7.

Farcards

Подробно процесс установки модуля Farcards описан в статье Установка и настройка системы ПДС.

После установки и базовой настройки Farcards необходимо подключить и настроить интерфейсную библитоеку ExtdllEGAIS.dll — актуальную версию можно скачать на FTP ftp://ftp.ucs.ru/rk7/other/fc_egais/

Для подключения библиотеки в файле FARCARDS.INI прописываем параметры

[FarServer]
Type = 1
DLL = ExtdllEGAIS.dll
...
CODE

Остальные секции и параметры настраиваются стандартным образом — более подробно в документе Настройка связи с ПДС

Далее настраиваем конфигурационный файл ExtdllEGAIS.ini для библиотеки ExtdllEGAIS.dll:

Настройки для версии 2.4.0.6:

[EGAIS]
INN=7701723018
KPP=770101001
Address=Москва г, ул. Большая почтовая д. 18 стр. 6
RestaurantName=Шоурум
KassaMachineNum=435345342
UTM=http://172.22.3.62:8081/xml/
 
[Main]
LogLevel=1
MaxChars=40
 
[RK]
InterfaceId=1000097
CODE

где:

  • INN, KPP, Address, RestaurantName — параметры организации. Используются при печати QR-кода (можно взять из настроек УТМ)
  • KassaMachineNum — номер ККМ. Параметр устарел, в версии 2.4.0.6 заполнение не требуется.
  • UTM — URL для обмена данными через УТМ
  • MaxChars — количество символов в строке при печати информации от ЕГАИС в купоне
  • InterfaceId — идентификатор интерфейса (необязательный параметр):
    а. Заполнен — обрабатываются запросы только для этого интерфейса
    б. Не заполнен — обрабатываются запросы для всех интерфейсов.

При добавлении на кассовый сервер нескольких интерфейсов, параметр InterfaceId обязателен к заполнению, иначе ЕГАИС-farcards корректно работать не будет.

Параметры Address, KassaMachineNum, LogLevel устарели, и с версии 2.4.0.7 исключены из конфигурационного файла ExtdllEGAIS.ini.

[EGAIS]
; параметры для печати
INN=7709750359
KPP=770901001
RestaurantName=Тестовый ресторан

UTM=http://172.22.4.154:8080/xml/
[Main]
MaxChars=40


[Rk]
;Если задан, то обрабатывать запросы только от этого интерфейса
InterfaceId=0
CODE

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

  1. В справочнике Настройки > Параметры в параметре Режим работы заведения выберите значение Режим HoReCa — для реализации порционного алкоголя.

    В версии 7.07.00.323 этот параметр называется Режим продажи пива.

  2. В справочнике Настройки > Параметры в параметре Ввод марок для крепкого алкоголя установите значение Вручную.

    Параметр добавлен с версии 7.07.00.326.

  3. Проверьте наличие предустановленных условий:

    • В справочнике Меню > Модификаторы по умолчанию добавлена группа модификаторов ЕГАИС EAN13 и PDF417

      Также убедитесь, что модификаторы включены в используемые торговые группы.
    • В справочнике Меню > Схемы модификаторов по умолчанию добавлена схема РОССИЯ: ЕГАИС, в которую входит группы модификаторов ЕГАИС EAN13 и PDF417
    • В справочник Меню >Классификации блюд по умолчанию добавлена классификация Маркировка/Россия с предустановленными категориями. Если классификация не активирована, активируйте ее.
      Если меню было заведено до активации классификации, чтобы активировать классификацию Маркировка/Россия, снимите флаг Обяз. группировка. Активируйте классификацию, распределите все блюда по категориям, а потом снова выставьте флаг, если обязательность группировки нужна.
      Для продажи алкоголя будет использоваться категория Алкогольные напитки. Для неё выбрана схема модификаторов РОССИЯ: ЕГАИС.
      Также убедитесь, что категория включена в используемую торговую группу.
    • В справочнике Сервис > Обработка сигналов устройств > MCR алгоритмы активированы предустановленные MCR-алгоритмы ЕГАИС EAN13 и ЕГАИС PDF417.
  4. Для каждого блюда, которое должно учитываться при порционной продаже алкоголя:
    • В классификации Маркировка/Россия выберите категорию Алкогольные напитки
    • Выберите Литр в свойстве Тип единицы измерения. Выбранное значение передаётся в атрибут фискального чека Мера количества предмета расчета (Тег 2108). Если значение не заполнено, передаются штуки.
    • Укажите объем напитка в свойстве Объем (мл)
    • В свойстве Тип товара выберите значение Подакцизный товар без кода маркировки
    • Если на остатках есть марки старого образца – PDF417, то для таких позиций заполните Алк.коды — код товара в системе ЕГАИС, нужно взять из учетной системы, с которой работает ЕГАИС.
    • Для возможности добавлять алкоголь без сканирования марки в момент добавления блюда в заказ выставьте флаг Ввод маркировки при оплате. Данная настройка необходима при работе с официантского терминала или мобильного официанта.

  5. В справочнике Настройки > Печать > Документы и макеты в разделе Документы CRM > Купон создайте новый макет печати ЕГАИС: Инфо. Для этого:
    1. откройте дизайнер макета и импортируйте готовой макет EGAIS_kupon.mak (находится на FTP ftp://ftp.ucs.ru/rk7/other/fc_egais/EGAIS_kupon.mak)
    2. в печатный макет кроме команды QRCode можно добавлять параметр QRProperties <высота>;<Уровень коррекции QR-кода>, например: <QRProperties 100;15%><QRCode "[QRCodeField]">.
  6. В справочнике Настройки > Печать > Схемы печати выберите требуемую схему печати и добавьте в представления документов созданный макет печати ЕГАИС: Инфо. В свойствах представления выберите Класс основного принтера, который будет печатать QR-код (как правило это чековый принтер).
  7. В справочнике Параметры > Установочные > Связь с другими системами в свойствах параметра Классификация для ЕГАИС выберите классификацию Маркировка/Россия
  8. В справочнике Сервис > Станции и устройства выберите кассовый сервер и на закладке Устройства добавьте PDS interface
  9. В свойствах PDS-интерфейса настройте базовые параметры и для параметра Pass ALL Receipts XML data установите значение Yes, always (fail if impossible)

  10. В справочнике Сервис > Интерфейсы выберите интерфейс Персональная Дисконтная Система (ПДС) и свяжите его с PDS-интерфейсом, созданным в предыдущем пункте. Если интерфейс Персональная Дисконтная Система (ПДС) уже задействован, скопируйте и переименуйте предустановленный вариант (например, в интерфейс ЕГАИС). Перезагрузите кассовый сервер.
  11. В справочнике Сервис > Станции и устройства выберите кассовую станцию и на закладке Устройства добавьте порт и драйвер для подключения сканера штрих-кодов. Настройте параметры драйвера.

Работа на кассовой станции

Добавление блюда в заказ

Блюдо может добавляться в заказ:

  • на кассовой станции, где есть сканер штрих-кодов. В этом случае:
    1. Добавьте блюдо в заказ обычным способом
    2. Отсканируйте штрих-код и марку бутылки
    3. Оплатите заказ
  • на r_k Waiter или отдельной официантской станции без возможности сканировать марку. В этом случае:
    1. Добавьте блюдо в заказ обычным способом. У блюда должен стоять флаг Ввод маркировки при оплате
    2. Сохраните заказ. Блюдо до сканирования марки будет отмечено знаком вопроса
    3. На терминале, где есть сканер штрих-кодов, при выдаче блюда отсканируйте штрих-код и марку бутылки
    4. Оплатите заказ.

Вскрытые до 01.07.2024 бутылки считаются полностью списанными, их не нужно передавать в УТМ. Если при продаже алкоголя используется бутылка, вскрытая до 01.07.2024, то сканировать реальную марку с бутылки не надо. Необходимо использовать техническую марку.
Последовательность: {EAA0ECBE-CB14-443F-9676-EE3336CF79B4}
Если QR будет генерироваться в специальных сервисах генерации QR-кодов, то необходимо использовать всю последовательность, включая {}

Оплата

При попытке оплаты заказа без добавления марки выйдет ошибка.

Перед печатью фискального чека данные передаются в УТМ в формате ChequeV4.

После получения положительного ответа от ЕГАИС печатается фискальный чек + QRкод ЕГАИС.

Если на момент оплаты ЕГАИС будет недоступен выйдет ошибка. Чек закрыт не будет.

Удаление чека

При удалении чека в УТМ отправляется “возврат” в формате ChequeV4.