1029
правок
Изменения
Новая страница: «<center><FONT SIZE=7>Порционное списание в ЕГАИС с 01.07.2024</FONT></center> 150px||right|link= С 01.07.2024...»
<center><FONT SIZE=7>Порционное списание в ЕГАИС с 01.07.2024</FONT></center> [[Файл:Bllogo4.png|150px||right|link=]]
С 01.07.2024 в работе предприятий общественного питания (HoReCa) вступили новые требования по фиксации "порционной" реализации "крепкого" (маркируемого) алкоголя.
'''ВАЖНО''': Пива данные нововведения НЕ КАСАЮТСЯ!!!
https://fsrar.gov.ru/news/view/?id=6005
Ранее реализация в ЕГАИС для HoReCa фиксировалась следующим образом:
Бармен вскрывает бутылку, сканирует её штрих-код - по этим данным формируется акт списания с причиной "Реализация" и т.о. списывается сразу вся бутылка целиком.
С 01.07:
1 - Бармен пробивает чек с "чистым" алкоголем, и в ЕГАИС должен уйти чек с указанием реализованной порции (в миллилитрах) и штрих-кодом бутылки.
2 - Бармен пробивает чек с "коктейлем", и в ЕГАИС должен уйти новый акт списания с причиной "Приготовление", с указанием порции (в миллилитрах) и штрих-кодом бутылки.
Определение "коктейля":
"Коктейль" - это «блюдо», приготовленное в соответствии с технологической картой организации, путем смешения закупленной алкогольной продукции, содержащейся в потребительской упаковке и маркированной в соответствии со статьей 12 Закона № 171-ФЗ с иной пищевой продукцией (пункт 15 статьи 2 Закона № 171-ФЗ).
==Варианты работы с "порционкой" в БАРЛАЙВ==
Для удобства пользователей в БАРЛАЙВ реализовано 2 варианта работы с "порционкой":
1 - В интеграции с кассовым ПО (R-keeper, IIKO)
2 - Работа только с коктейлями (для концертных площадок и ночных клубов)
Во всех вариантах главное - с точки зрения пользователя процесс не поменяется.
----
<FONT SIZE=5>'''ВАЖНО''' - Бармену так же как и раньше - надо будет просто сканировать вскрытые бутылки в приложение БАРЛАЙВ, всё, дополнительных действий не появится.</FONT>
----
Основное изменение коснётся автоматической работы с отсканированными марками - если сейчас автоматика работает одним образом, то с "порционкой" будет работать по-новому (в т.ч. в интеграции с кассовым ПО).
==Требуемые обновления и настройки модулей БАРЛАЙВ==
Позже здесь будет написано о релизе новых версий.
Все требуемые обновления и настройки со стороны БАРЛАЙВ - сделает тех.поддержка.
Однако, заранее стоит проверить свои ПК на возможную необходимость в обновлении операционной системы.
Последняя версия десктопного Модуля Бармена (синяя кнопка "ЕГАИС" поверх кассы/рабочего стола) - .NET Framework 4.8
Последняя версия Модуля Синхронизации (ставится там же где УТМ (егаисовский рутокен)) - .NET 6.0
Т.о. необходимо проверить, что на ПК с данными модулями ОС не ниже Windows 7 SP1 (и на них возможно установить вышеперечисленные .NET).
==БАРЛАЙВ в интеграции с R-keeper==
'''ПРИМЕЧАНИЕ''': Данная инструкция будет дополняться и правиться в первое время внедрения "порционного учёта".
Последние правки - 01.06.2025
Описание работы с "порционным учётом" в интеграции с R-keeper:
1 - Бармен открыл бутылку, отсканировал в БАРЛАЙВ штрих-код; этот ШК зафиксировался в пуле открытых бутылок (этот "пул" представляет из себя таблицу из ШК и доступного объёма в миллилитрах).
2 - Бармен закрывает заказ, пробивает чек в R-keeper; R-keeper отправляет информацию в БАРЛАЙВ с пометкой “чистый алкоголь” или “коктейли”.
2.1 - Если в заказе “чистый” алкоголь - то БАРЛАЙВ смотрит в пуле открытых бутылок есть ли ШК нужной продукции и достаточно ли там объёма - забирает ШК и с помощью него формирует чек, отправляет в ЕГАИС.
2.2 - Если в заказе “коктейль” - то БАРЛАЙВ смотрит в пуле открытых бутылок есть ли ШК нужных бутылок и достаточно ли там объёма - забирает ШК и с помощью них формирует акт списания с причиной “приготовление” и отправляет в ЕГАИС.
Сопоставление "код блюда r-keeper" - "алккод ЕГАИС" происходит по внутренним справочникам в БАРЛАЙВ. Блюда из R-keeper можно выгрузить; а тех-карты коктейлей для sh4 заполняются вручную, для sh5 (с лицензией WS) - подгружаются. Об этом ниже будет подробнее.
Таким образом, после предварительных настроек работа на стороне пользователя останется прежней - надо будет как ранее просто сканировать при вскрытии бутылки в БАРЛАЙВ.
'''ПРИМЕЧАНИЕ''': При пробитии заказов у алкогольной продукции будет показывать знак вопроса - '''НЕ НАЖИМАТЬ''' на него, иначе будет требовать указание модификатора.
[[File:bl-rk-questionmark.png|400px]]
===Предварительные настройки в R-keeper===
Минимальная версия для работы с интеграцией - 7.07.00.359
Если встречаются ошибки с передачей цен - рекомендуется обновиться до 7.7.0.361
'''Базовые настройки в RK7Man'''
Настройки ниже делаются дилером.
1. В справочнике Настройки > Параметры в параметре «Режим работы заведения» выберите значение '''Режим HoReCa'''.
2. В справочнике Настройки > Параметры в параметре Ввод марок для крепкого алкоголя установите значение:
'''Автоматически - через систему управления складом'''
3. В справочнике Настройки – Центральный офис – Собственные юр.лица – заполните реквизиты собственного юр. Лица (см. [https://docs.rkeeper.ru/rk7/latest/ru/sobstvennye-yuridicheskie-litsa-37065851.html#id-%D0%AE%D1%80%D0%B8%D0%B4%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5%D0%BB%D0%B8%D1%86%D0%B0-%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5%D0%BD%D0%BE%D0%B2%D0%BE%D0%B3%D0%BE%D1%8E%D1%80%D0%B8%D0%B4%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B3%D0%BE%D0%B руководство пользователя])
Для КПП (или FIAS_ID) необходимо заполнить FSRAR_ID
[[File:rkeeper1.png|center|border]]
4. Определите главный кассовый сервер
В справочнике Сервис > Станции и устройства заполните для ресторана свойство Главный кассовый сервер — кассовый сервер, на котором будет производиться учет марок.
[[File:rkeeper2.png|center|border]]
Продавать алкоголь можно на любом кассовом сервере. При закрытии чека касса отправляет запрос на свой кассовый сервер, а тот пересылает запрос на главный кассовый сервер.
5. В справочнике Сервис > Станции и устройства для все рабочих кассовых станций выберите реквизиты юридического лица для ФР. Данные реквизиты будут использованы для передачи данных интегратору
[[File:rkeeper3.png|center|border]]
Когда в одной базе ведется несколько ресторанов:
- В случае, если они принадлежат одному юр.лицу, необходимо создавать реквизиты для одного юр.лица с разными КПП и привязывать эти реквизиты к принтерам
- В случае, если они принадлежат разным юр.лицам, необходимо создавать отдельные юр. лица и реквизиты к ним.
6. В справочнике Сервис > Обработка сигналов устройств > MCR алгоритмы активированы предустановленные MCR-алгоритмы ЕГАИС EAN13 и ЕГАИС PDF417.
7. В справочнике Настройки > Печать > Документы и макеты в разделе Документы CRM > Купон создайте новый макет печати ЕГАИС: Инфо.
'''ПРИМЕЧАНИЕ''': Печать данного QR-кода необязательна, т.к. уже печатается QR-код по 54-ФЗ, дублирование не требуется (Приказ Росалкогольрегулирования 20.10.2020 N 335)
Но если решили всё равно его настроить, то:
a. откройте дизайнер макета и импортируйте готовой макет EGAIS_kupon.mak (находится на FTP [ftp://ftp.ucs.ru/rk7/other/fc_egais/EGAIS_kupon.mak])
b. в печатный макет кроме команды QRCode можно добавлять параметр QRProperties <высота>;<Уровень коррекции QR-кода>, например: <QRProperties 100;15%><QRCode "[QRCodeField]">.
c. В справочнике Настройки > Печать > Схемы печати выберите требуемую схему печати и добавьте в представления документов созданный макет печати ЕГАИС: Инфо. В свойствах представления выберите Класс основного принтера, который будет печатать QR-код (как правило это чековый принтер).
8. В справочнике Параметры > Установочные > Связь с другими системами в свойствах параметра Классификация для ЕГАИС выберите классификацию Маркировка/Россия (в параметре "Ссылка")
'''Настройки связи с интегратором'''
1. В пункте меню Сервис –Кассовые станции и устройства - Для главного кассового сервера на закладке Устройства, добавляем из списка драйверов, драйвер:
''Alcohol accounting interface for external services''
На другие кассовые сервера в рамках ресторана добавлять драйвер не требуется!
[[File:rkeeper4.png|center|border]]
Находим драйвер и перетаскиваем в раздел Устройства
[[File:rkeeper5.png|center|border]]
Соглашаемся с назначением в интерфейс
[[File:rkeeper6.png|center|border]]
2. В свойствах драйвера указывает URL интегратора и Токен
URL:
https://barlane.ru/api/v1/rkeeper/sales/xml
В поле "Authorization header fo" оставить значение по умолчанию:
Authorization:Bearer %s
Токен можно запросить у технической поддержки БАРЛАЙВ (или самостоятельно взять в свойствах "Торгового объекта" в блоке "Порционный учёт" (не перепутать с токеном для IIKO!); если в строке токена пусто - нажать "записать" и затем заново открыть свойства "торгового объекта").
[[File:rkeeper7.png|center|border]]
'''БУФЕРНЫЙ МОДУЛЬ'''
'''ВАЖНО!''' Для работы оффлайн режима можно установить "Буферный модуль" - его установка и настройка описана ниже в [[Порционное_списание_в_ЕГАИС#ПРИЛОЖЕНИЕ 1. Настройка "Буферного Модуля"|приложении]] (ставится туда где есть локальная связь с Кассовым Сервером).
В случае если используется "Буферный модуль", в "Менеджерской" Ркипер надо поменять настройку для алкоинтерфейса кассового сервера с https://barlane.ru/api/v1/rkeeper/sales/xml на http://localhost:7300/buffer/v1/rkeeper/sales/xml (адрес и порт такие если модуль на одном ПК с кассовым сервером).
Логи обмена Rkeeper с БАРЛАЙВ хранятся в папке, где установлен кассовый сервер, в файле rkalcoex.log.
'''ВАЖНО''': Проверьте, чтобы не был включен "фаркардс" настроенный на ЕГАИС; если вдруг включен (как на скриншоте ниже) - ОТКЛЮЧИТЕ ЕГО!
[[File:farcards.png|center|border]]
'''Настройки карточки блюда в RK'''
0. Сервис - Интерфейсы - проверьте что "'''Интерфейс Алкоголь/Россия линк'''" активен, а также что у него проставлена связь с добавленным ранее драйвером:
[[File:rk-interface-c.png|center|border]]
1. Проверьте наличие предустановленных условий:
[[File:rkeeper8.png|center|border]]
Также убедитесь, что модификаторы включены в используемые торговые группы
2. В справочнике Меню > Схемы модификаторов по умолчанию добавлена схема РОССИЯ: ЕГАИС, в которую входят группу модификаторов ЕГАИС EAN13 и DataMatrix/PDF417
[[File:rkeeper9.png|center|border]]
3. В справочник Меню > Классификации блюд по умолчанию добавлена классификация Маркировка/Россия с предустановленными категориями. Если классификация не активирована, активируйте ее.
Если меню было заведено до активации классификации, чтобы активировать классификацию Маркировка/Россия, снимите флаг Обяз. группировка. Активируйте классификацию, распределите все блюда по категориям, а потом снова выставьте флаг, если обязательность группировки нужна.
Для продажи алкоголя будут использоваться категории Алкогольные напитки и Алкогольные коктейли. Для категории Алкогольные напитки выбрана схема модификаторов РОССИЯ: ЕГАИС.
Также убедитесь, что категории включены в используемую торговую группу.
[[File:rkeeper10.png|center|border]]
4. Для каждого блюда, которое должно учитываться при порционной продаже алкоголя, заполните обязательные параметры.
Для чистого алкоголя:
a. В классификации Маркировка/Россия выберите категорию Алкогольные напитки.
b. Выберите Литр в свойстве Тип единицы измерения. Выбранное значение передаётся в атрибут фискального чека Мера количества предмета расчета (Тег 2108). Если значение не заполнено, передаются штуки.
c. В свойстве Тип товара выберите значение Подакцизный товар без кода маркировки.
d. Укажите объём порции.
'''ВАЖНО!''' Цена блюда должна быть выше 0 (и соотв-но должно пробиваться фискальными валютами) - иначе ЕГАИС вернёт ошибку о попытке реализации с нулевой ценой.
[[File:Rkeeper11aaa.png|center|border]]
'''Для коктейлей''':
a. В классификации Маркировка/Россия выберите категорию Алкогольные коктейли
b. В свойстве Тип товара оставьте значение Товар.
[[File:Rkeeper11b.png|center|border]]
===Загрузка номенклатуры из R-keeper===
После проставления настроек блюд описанных выше, для загрузки данных в справочник БАРЛАЙВ необходимо сделать два XML-запроса в r-keeper. Их можно сделать вручную, или через кнопку на сайте если настроен "Буферный модуль".
Речь о запросах описанных в этой [https://docs.rkeeper.ru/rk7/latest/ru/xml-interfejs-r_keeper-7-19605640.html#XMLинтерфейсr_keeper7-Аутентификацияивыполнениезапросов инструкции].
'''ВАЖНО''': Убедитесь, что признаки "алкогольные напитки" и "алкогольные коктейли" у нужных блюд проставлены.
'''ПРИМЕЧАНИЕ''': Если настроен "Буферный модуль" - то запросы ниже вручную делать не требуется, достаточно нажать на кнопку "Загрузить меню из RK" в разделе "Справочник номенклатуры". О настройке "Буферного модуля" - [[#ПРИЛОЖЕНИЕ 1. Настройка "Буферного Модуля"]]
[[File:bm5.png|center|border]]
Ниже описаны запросы для ручного формирования файлов и их загрузки в "Справочник номенклатуры".
'''Первый запрос''':
<?xml version="1.0" encoding="UTF-8"?>
<RK7Query >
<RK7CMD CMD="GetRefdata" RefName="ClassificatorGroups" >
</RK7CMD>
</RK7Query>
'''Второй запрос''':
<?xml version="1.0" encoding="UTF-8"?>
<RK7Query >
<RK7CMD CMD="GetRefdata" RefName="menuitems" OnlyActive="true">
</RK7CMD>
</RK7Query>
Файлы передать поддержке БАРЛАЙВ (указав какой первый, а какой второй) - и номенклатура будет загружена в систему. Или самостоятельно загрузить соответствующими кнопка в "Справочнике номенклатуры".
Если для "алкогольных напитков" не было указано алккодов в карточках R-keeper, то надо будет внести их в "справочник номенклатуры" вручную; об этом подробнее [[Модуль_Бухгалтера_БАРЛАЙВ#Справочник номенклатуры|инструкции]].
Для StoreHouse 5 есть возможность подгрузить алккоды и техкарты - об этом подробнее ниже.
===Получение данных из StoreHouse 5===
'''ПРИМЕЧАНИЕ''': При работе со StoreHouse 4 - придётся вручную проставить информацию об ингредиентах коктейлей в [[Модуль_Бухгалтера_БАРЛАЙВ#Справочник номенклатуры|справочнике БАРЛАЙВ]].
При работе со StoreHouse 5 - есть возможность подгрузить данные по коктейлям и алккоды "чистого" автоматически - для этого понадобится отдельная лицензия:
'''R-Keeper модуль Интеграции SH5 для внешних систем ЕГАИС 12 мес ПО (или 1 мес) – лицензия для интеграции ЕГАИС внешних систем.'''
Соотв-но без этой лицензии - тоже придётся заносить данные о коктейлях в справочник БАРЛАЙВ вручную.
Лицензирование проводится представителями вендора (дилерами). Также из технических требований - WhiteServer версии не ниже 2.8.6.1, более подробно о настройках WS - в [https://docs.rkeeper.ru/rk7/latest/ru/integratsiya-s-ispol-zovaniem-sh5-119014236.html инструкции от UCS].
Ниже описаны необходимые настройки в самом StoreHouse 5.
'''Настройки справочников'''
1. У ингредиентов коктейля должен быть выставлен флаг «Алкогольная продукция». И у данного товара на закладке «Единицы измерения» есть единица измерения «Литр»
[[File:rkeeper12.png|center|border]]
2. В комплекты блюд «коктейля» входят ингредиенты с флагом алкогольная продукция.
3. На блюде обязательно должен стоять флаг Производить.
4. Для блюд r_k 7 должна быть заполнена закладка "Списание" (определены подразделения списания)
Соотв-но сработает и для "чистого" алкоголя, если для него по аналогии настроен комплект.
А также необходимо передать поддержке БАРЛАЙВ следующие данные:
- Код ресторана в системе лицензирования
- Guid в SH Предприятие (=GUID ресторана RK)
- Guid в SH Место реализации (=GUID категории заказа RK; которое используется для коктейлей)
'''ВАЖНО!''' - "гуиды" вносить БЕЗ фигурных скобок {}
В R-keeper эти данные можно найти тут:
[[File:sh5downloadporc2.png|center|boreder]]
[[File:sh5downloadporc3.png|center|boreder]]
Или самостоятельно указать их в настройках "Торгового объекта" в блоке "Включить загрузку техкарт из sh5" (и включив эту настройку).
Если всё было сделано правильно, то в разделе "Справочник номенклатуры" появится кнопка "Загрузить тех.карты из sh5":
[[File:sh5downloadporc.png|center|boreder]]
По нажатию будут загружены техкарты по всем "коктейлям" у которых их нет.
===ПРИЛОЖЕНИЕ 1. Настройка "Буферного Модуля"===
Стандартная настройка "порционного учёта" с R-keeper (описанная выше) подразумевает прямую связь между Кассовым Сервером R-keeper ("MID") и сервером БАРЛАЙВ.
"Буферный модуль" ставится между Кассовым Сервером R-keeper ("MID") и сервером БАРЛАЙВ, обеспечивая "оффлайн режим" работы в случае сбоев интернета - т.е. чеки будут закрываться и сохраняться в памяти модуля, и как только связь появится - всё будет отправлено на сервер и соотв-но в ЕГАИС; а также обеспечивает загрузку меню в "Справочник номенклатуры" через сайт (без ручных выгрузок и загрузок файлов).
Модуль устанавливается туда, где есть локальная связь с Кассовым Сервером. В идеале - на тот же ПК где Кассовый Сервер и стоит - тогда адрес будет localhost; Но можно напр-р и на ПК с кассой (у которой очевидно есть локальная связь с Кассовым Сервером) - тогда надо будет указать не localhost а локальный ip Кассового Сервера (и убедиться что порт 7300 доступен).
Перед установкой также необходимо узнать адрес XML-интерфейса и логин и пароль (где делаются запросы для получения файлов меню для "Справочника номенклатуры").
Пример такого адреса - https://192.168.150.200:7777/rk7api/v0/xmlinterface.xml ; логин - http , пароль - http
ВАЖНО! Обратите внимание на переданный вам адрес, на его "хвост" - он может быть вида https://192.168.150.200:7777/webgui/iservxmltest.htm - такой адрес не подойдёт, это адрес для входа через браузер; если дали такой адрес, то просто сами поменяйте "хвост" - '''/webgui/iservxmltest.htm''' на '''/rk7api/v0/xmlinterface.xml'''
Порядок установки:
1 - Установить ASP.NET Core 8 и .NET Desktop Runtime 8 соответствующие разрядности ОС
https://dotnet.microsoft.com/en-us/download/dotnet/8.0
2 - Установить [https://disk.360.yandex.ru/d/D7Q2EonyEjObqg буферный модуль]
3 - В конфиге "буферного модуля" (файл appsettings.json) внести токен авторизации для R-keeper (в строке '''"XmlInterfaceApiTokens": [ "" ]''' , указать между кавычек), сохранить его. Пример:
[[File:bm1.png|center|border]]
4 - В настройках "торгового объекта" поставить галку у параметра '''"Включить xml-обмен через буферный модуль"''', в появившихся полях внести данные связи с xml-интерфейсом, пример:
[[File:bm2.png|center|border]]
5 - В "Менеджерской" Ркипер поменять настройку для алкоинтерфейса кассового сервера с https://barlane.ru/api/v1/rkeeper/sales/xml на http://localhost:7300/buffer/v1/rkeeper/sales/xml
(ВАЖНО! Если "Буферный модуль" не на том же ПК что и Кассовый Сервер RK, то будет не "localhost" а ip адрес ПК где установили "Буферный модуль")
[[File:bm3.png|center|border]]
6 - Перезапустить кассовый сервер (ВАЖНО! Согласовать перезапуск c ответственными в заведении, т.к. в этот момент ~минуту кассы будут недоступны)
7 - Запустить службу "буферного модуля" (Barlane Buffer Module Service)
[[File:bm4.png|center|border]]
8 - Проверить загрузку меню - "Справочник номенклатуры" - кнопка "Загрузить меню из RK"
[[File:bm5.png|center|border]]
Ответ можно увидеть в т.ч. логах (кнопка сверху слева "Логи RK")
[[File:bm6.png|center|border]]
В случае ошибок или зависания запроса - перепроверьте все настройки выше (в т.ч. указанный адрес XML-интерфейса - что там "хвост" '''/rk7api/v0/xmlinterface.xml''' а не '''/webgui/iservxmltest.htm''')
9 - Проверить что чеки успешно закрываются и приходят на сайт в раздел "Чеки".
==БАРЛАЙВ в интеграции с IIKO==
'''ПРИМЕЧАНИЕ''': Данная инструкция будет дополняться и правиться в первое время внедрения "порционного учёта".
Последние правки - 09.07.2024
Описание работы с "порционным учётом" в интеграции с IIKO:
1 - Бармен открыл бутылку, отсканировал в БАРЛАЙВ штрих-код; этот ШК зафиксировался в пуле открытых бутылок (этот пул представляет из себя таблицу из ШК и доступного объёма в миллилитрах).
2 - Бармен закрывает заказ, пробивает чек в IIKO; IIKO отправляет информацию в БАРЛАЙВ с пометкой "чистый алкоголь" или "коктейли".
2.1 - Если в заказе "чистый" алкоголь - то БАРЛАЙВ смотрит в пуле открытых бутылок есть ли ШК нужной продукции и достаточно ли там объёма - забирает ШК и с помощью него формирует чек, отправляет в ЕГАИС.
2.2 - Если в заказе "коктейль" - то БАРЛАЙВ смотрит (по техкарте) в пуле открытых бутылок есть ли ШК нужных бутылок и достаточно ли там объёма - забирает ШК и с помощью них формирует акт списания с причиной "приготовление" и отправляет в ЕГАИС.
Для работы интеграции необходимо установить плагин БАРЛАЙВ, а также произвести необходимые настройки в IIKO (и проверить наличие необходимых лицензий).
===Предварительные настройки в IIKO===
Необходимые настройки:
1. Версия iiko 8.*.* и выше
a. Для корректной отправки заказа во внешнюю систему нужно убедиться, что заполнено
b. ИНН и КПП в разделе «Общие настройки»
c. В настройках юр.лица проверить что проставлены название, ИНН и КПП:
[[File:iikoapi1.png|border|center]]
d. Все алкогольные товары iiko имеют ед. изменения "л" и заполнен классификатор видов алкогольной продукции (в карточке товара вкладка "Дополнительная информация" - "Алкогольная декларация" проставлен вид алкогольной продукции):
[[File:iikoapi2.png|border|center]]
e. В настройках учёта разрешены АР с отрицательными остатками ("настройках торгового предприятия" - во вкладке "настройки учёта"):
[[File:iikoapi3.png|border|center]]
f. Структура Блюд или Товаров, которые продаются на кассе с содержанием алкоголя могут быть вида
g. Продажа сразу товара на кассе
h. Блюдо содержит в ттк сам алкогольный товар или вложенное блюдо/заготовку , в структуре
вложений которого есть непосредственно алкоголь,
i. Само блюдо и вложенные в него ПФ должны иметь метод списания «Списывать ингредиенты»
[[File:iikoapi4.png|border|center]]
j. Блюдо с модификаторами, в составе которых есть алкоголь также будут учтены, в составе позиции будут переданы все алкогольные позиции
'''ПРИМЕЧАНИЕ 1''':
Для "чистых" блюд, у которых в техкарте несколько ингредиентов (напр-р "Коньяк 50мл" с долькой лимона) необходимо указывать пользовательское свойство '''NotCocktail''', чтобы уходило как "чистый" а не "коктейль".
Создание "пользовательского свойства" описано в [https://ru.iiko.help/articles/#!iikooffice-8-4/custom-tags/a/h2__773755849 инструкции] от IIKO. '''ВАЖНО''' - называться свойство должно именно '''NotCocktail'''
'''ПРИМЕЧАНИЕ 2''':
Для блюд, в которых есть алкогольные товары но которые не должны учитываться, необходимо указывать пользовательское свойство "notAlcohol".
===Установка плагина БАРЛАЙВ для IIKO Front===
[https://disk.360.yandex.ru/d/L5e2Eh8VeMyJjQ Скачать плагин БАРЛАЙВ для IIKO Front]
Установка плагина:
'''ВАЖНО!''' Плагин ставится на каждый терминал, где фискальная касса (ККТ/ФР) и пробивают алкоголь содержащие позиции.
1. Для запуска плагина необходима лицензия (21016318) 'FrontPaymentPlugin (Внутренний платежный интерфейс фронта)
2. Api Server – для доступа к ттк и отчётам по продажам, обе лицензии как правило есть в
решениях iiko Cloud
3. Поместить содержимое архива выше в Папку Plugins iikoFront например
C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Barlane
4. При запуске должно возникнуть сообщение об ошибке запуска плагина, необходимо выключить
фронт и изменить файл настроек, который хранится в разделе
5. C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\AppData\Roaming\iiko\CashServer\PluginConfigs\Barlane\Barlane_Front_Config.xml
<Uri>https://example.iiko.it:443/resto<</Uri> -- адрес и порт сервера IIKO
<Login>admin</Login> -- логин учётки IIKO (напр-р "системного администратора")
<Pass>1</Pass> -- пароль учётки IIKO
<BarlaneURI> https://barlane.ru/api</BarlaneURI>> -- оставить по умолчанию (адрес сервера БАРЛАЙВ)
<Barlane_Token>yWrm8dSRC-1pCJ1JtRIi5*********</Barlane_Token> -- токен авторизации объекта
'''ПРИМЕЧАНИЕ 1''': Токен запросите у тех.поддержки БАРЛАЙВ (с указанием что для IIKO) или посмотрите в свойствах "Торгового объекта" в блоке "Порционный учёт" (не перепутайте с токеном для R-keeper!).
'''ПРИМЕЧАНИЕ 2''': Актуальный адрес сервера IIKO можно посмотреть в настройках подключения IIKO Office:
[[File:iiko-resto.png|center|border]]
'''ПРИМЕЧАНИЕ 3''': НЕ ЗАБЫВАЙТЕ ПРО ПУТЬ "/resto" !!! Ещё раз пример указания адреса в конфиге:
<Uri>https://example.iiko.it:443/resto<</Uri>
6. После внесений изменений и запуска кассы будет выведено сообщение вида:
[[File:iiko-plugin-success.png|center]]
7. Кассир получает уведомления только в случае ошибок отправки заказа.
8. Если нет связи с сервером IIKO или БАРЛАЙВ или ошибка отправки заказ – плагин повторно
обрабатывает заказ.
9. Для тестирования можно создать заказ с алкоголем и после его отменить/удалить и проверить
успешность создания заказа в БАРЛАЙВ.
===Настройки Справочника IIKO в БАРЛАЙВ===
Если вы выгружали накладные из БАРЛАЙВ в IIKO, то дополнительных действий по "чистым" блюдам не потребуется. Если же не выгружали - то сделайте настройки по данной [[Модуль Бухгалтера БАРЛАЙВ# Выгрузка в iiko|инструкции]].
==БАРЛАЙВ в работе с только коктейлями==
Данный режим подходит заведениям, где есть только коктейли; а также концертным площадкам и ночным клубам, которые пользуются функцией "режим исключения" при работе с Модулем Бармена БАРЛАЙВ.
Как это было до 01.07.2024:
1 - Перед мероприятием (сменой) бармены сканируют в БАРЛАЙВ весь закрытый алкоголь, который будет доступен для реализации.
2 - Во время мероприятия (смены) бармены не отвлекаются на сканирование бутылок - и концентрируются на работе с гостями.
3 - После окончания мероприятия (смены) бармены переключают приложение БАРЛАЙВ в "режим исключения" и сканируют оставшиеся закрытые бутылки - они исключаются из общего списка, т.о. там остаются только те позиции, которые были реализованы - и они уходят на списание.
Чтобы сохранить данный режим работы, помимо обновления Модуля Бармена БАРЛАЙВ (о наличии новой версии будет указано здесь), необходимо перевести все свои алкогольные ("крепкие") позиции в "коктейли" согласно определению:
"Коктейль" - это «блюдо», приготовленное в соответствии с технологической картой организации, путем смешения закупленной алкогольной продукции, содержащейся в потребительской упаковке и маркированной в соответствии со статьей 12 Закона № 171-ФЗ с иной пищевой продукцией (пункт 15 статьи 2 Закона № 171-ФЗ).
Т.о. не потребуется интеграция с кассовым ПО, т.к. весь алкоголь будет списываться актами, напрямую через БАРЛАЙВ.
И самое важное - бармены точно так же будут сканировать бутылки без указания порций, как делали это и раньше.
'''ПРИМЕЧАНИЕ''': Для заведений с коктейлями и с небольшим потоком доступен и режим с указанием порций при каждом сканировании.
С 01.07.2024 в работе предприятий общественного питания (HoReCa) вступили новые требования по фиксации "порционной" реализации "крепкого" (маркируемого) алкоголя.
'''ВАЖНО''': Пива данные нововведения НЕ КАСАЮТСЯ!!!
https://fsrar.gov.ru/news/view/?id=6005
Ранее реализация в ЕГАИС для HoReCa фиксировалась следующим образом:
Бармен вскрывает бутылку, сканирует её штрих-код - по этим данным формируется акт списания с причиной "Реализация" и т.о. списывается сразу вся бутылка целиком.
С 01.07:
1 - Бармен пробивает чек с "чистым" алкоголем, и в ЕГАИС должен уйти чек с указанием реализованной порции (в миллилитрах) и штрих-кодом бутылки.
2 - Бармен пробивает чек с "коктейлем", и в ЕГАИС должен уйти новый акт списания с причиной "Приготовление", с указанием порции (в миллилитрах) и штрих-кодом бутылки.
Определение "коктейля":
"Коктейль" - это «блюдо», приготовленное в соответствии с технологической картой организации, путем смешения закупленной алкогольной продукции, содержащейся в потребительской упаковке и маркированной в соответствии со статьей 12 Закона № 171-ФЗ с иной пищевой продукцией (пункт 15 статьи 2 Закона № 171-ФЗ).
==Варианты работы с "порционкой" в БАРЛАЙВ==
Для удобства пользователей в БАРЛАЙВ реализовано 2 варианта работы с "порционкой":
1 - В интеграции с кассовым ПО (R-keeper, IIKO)
2 - Работа только с коктейлями (для концертных площадок и ночных клубов)
Во всех вариантах главное - с точки зрения пользователя процесс не поменяется.
----
<FONT SIZE=5>'''ВАЖНО''' - Бармену так же как и раньше - надо будет просто сканировать вскрытые бутылки в приложение БАРЛАЙВ, всё, дополнительных действий не появится.</FONT>
----
Основное изменение коснётся автоматической работы с отсканированными марками - если сейчас автоматика работает одним образом, то с "порционкой" будет работать по-новому (в т.ч. в интеграции с кассовым ПО).
==Требуемые обновления и настройки модулей БАРЛАЙВ==
Позже здесь будет написано о релизе новых версий.
Все требуемые обновления и настройки со стороны БАРЛАЙВ - сделает тех.поддержка.
Однако, заранее стоит проверить свои ПК на возможную необходимость в обновлении операционной системы.
Последняя версия десктопного Модуля Бармена (синяя кнопка "ЕГАИС" поверх кассы/рабочего стола) - .NET Framework 4.8
Последняя версия Модуля Синхронизации (ставится там же где УТМ (егаисовский рутокен)) - .NET 6.0
Т.о. необходимо проверить, что на ПК с данными модулями ОС не ниже Windows 7 SP1 (и на них возможно установить вышеперечисленные .NET).
==БАРЛАЙВ в интеграции с R-keeper==
'''ПРИМЕЧАНИЕ''': Данная инструкция будет дополняться и правиться в первое время внедрения "порционного учёта".
Последние правки - 01.06.2025
Описание работы с "порционным учётом" в интеграции с R-keeper:
1 - Бармен открыл бутылку, отсканировал в БАРЛАЙВ штрих-код; этот ШК зафиксировался в пуле открытых бутылок (этот "пул" представляет из себя таблицу из ШК и доступного объёма в миллилитрах).
2 - Бармен закрывает заказ, пробивает чек в R-keeper; R-keeper отправляет информацию в БАРЛАЙВ с пометкой “чистый алкоголь” или “коктейли”.
2.1 - Если в заказе “чистый” алкоголь - то БАРЛАЙВ смотрит в пуле открытых бутылок есть ли ШК нужной продукции и достаточно ли там объёма - забирает ШК и с помощью него формирует чек, отправляет в ЕГАИС.
2.2 - Если в заказе “коктейль” - то БАРЛАЙВ смотрит в пуле открытых бутылок есть ли ШК нужных бутылок и достаточно ли там объёма - забирает ШК и с помощью них формирует акт списания с причиной “приготовление” и отправляет в ЕГАИС.
Сопоставление "код блюда r-keeper" - "алккод ЕГАИС" происходит по внутренним справочникам в БАРЛАЙВ. Блюда из R-keeper можно выгрузить; а тех-карты коктейлей для sh4 заполняются вручную, для sh5 (с лицензией WS) - подгружаются. Об этом ниже будет подробнее.
Таким образом, после предварительных настроек работа на стороне пользователя останется прежней - надо будет как ранее просто сканировать при вскрытии бутылки в БАРЛАЙВ.
'''ПРИМЕЧАНИЕ''': При пробитии заказов у алкогольной продукции будет показывать знак вопроса - '''НЕ НАЖИМАТЬ''' на него, иначе будет требовать указание модификатора.
[[File:bl-rk-questionmark.png|400px]]
===Предварительные настройки в R-keeper===
Минимальная версия для работы с интеграцией - 7.07.00.359
Если встречаются ошибки с передачей цен - рекомендуется обновиться до 7.7.0.361
'''Базовые настройки в RK7Man'''
Настройки ниже делаются дилером.
1. В справочнике Настройки > Параметры в параметре «Режим работы заведения» выберите значение '''Режим HoReCa'''.
2. В справочнике Настройки > Параметры в параметре Ввод марок для крепкого алкоголя установите значение:
'''Автоматически - через систему управления складом'''
3. В справочнике Настройки – Центральный офис – Собственные юр.лица – заполните реквизиты собственного юр. Лица (см. [https://docs.rkeeper.ru/rk7/latest/ru/sobstvennye-yuridicheskie-litsa-37065851.html#id-%D0%AE%D1%80%D0%B8%D0%B4%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5%D0%BB%D0%B8%D1%86%D0%B0-%D0%A1%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5%D0%BD%D0%BE%D0%B2%D0%BE%D0%B3%D0%BE%D1%8E%D1%80%D0%B8%D0%B4%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B3%D0%BE%D0%B руководство пользователя])
Для КПП (или FIAS_ID) необходимо заполнить FSRAR_ID
[[File:rkeeper1.png|center|border]]
4. Определите главный кассовый сервер
В справочнике Сервис > Станции и устройства заполните для ресторана свойство Главный кассовый сервер — кассовый сервер, на котором будет производиться учет марок.
[[File:rkeeper2.png|center|border]]
Продавать алкоголь можно на любом кассовом сервере. При закрытии чека касса отправляет запрос на свой кассовый сервер, а тот пересылает запрос на главный кассовый сервер.
5. В справочнике Сервис > Станции и устройства для все рабочих кассовых станций выберите реквизиты юридического лица для ФР. Данные реквизиты будут использованы для передачи данных интегратору
[[File:rkeeper3.png|center|border]]
Когда в одной базе ведется несколько ресторанов:
- В случае, если они принадлежат одному юр.лицу, необходимо создавать реквизиты для одного юр.лица с разными КПП и привязывать эти реквизиты к принтерам
- В случае, если они принадлежат разным юр.лицам, необходимо создавать отдельные юр. лица и реквизиты к ним.
6. В справочнике Сервис > Обработка сигналов устройств > MCR алгоритмы активированы предустановленные MCR-алгоритмы ЕГАИС EAN13 и ЕГАИС PDF417.
7. В справочнике Настройки > Печать > Документы и макеты в разделе Документы CRM > Купон создайте новый макет печати ЕГАИС: Инфо.
'''ПРИМЕЧАНИЕ''': Печать данного QR-кода необязательна, т.к. уже печатается QR-код по 54-ФЗ, дублирование не требуется (Приказ Росалкогольрегулирования 20.10.2020 N 335)
Но если решили всё равно его настроить, то:
a. откройте дизайнер макета и импортируйте готовой макет EGAIS_kupon.mak (находится на FTP [ftp://ftp.ucs.ru/rk7/other/fc_egais/EGAIS_kupon.mak])
b. в печатный макет кроме команды QRCode можно добавлять параметр QRProperties <высота>;<Уровень коррекции QR-кода>, например: <QRProperties 100;15%><QRCode "[QRCodeField]">.
c. В справочнике Настройки > Печать > Схемы печати выберите требуемую схему печати и добавьте в представления документов созданный макет печати ЕГАИС: Инфо. В свойствах представления выберите Класс основного принтера, который будет печатать QR-код (как правило это чековый принтер).
8. В справочнике Параметры > Установочные > Связь с другими системами в свойствах параметра Классификация для ЕГАИС выберите классификацию Маркировка/Россия (в параметре "Ссылка")
'''Настройки связи с интегратором'''
1. В пункте меню Сервис –Кассовые станции и устройства - Для главного кассового сервера на закладке Устройства, добавляем из списка драйверов, драйвер:
''Alcohol accounting interface for external services''
На другие кассовые сервера в рамках ресторана добавлять драйвер не требуется!
[[File:rkeeper4.png|center|border]]
Находим драйвер и перетаскиваем в раздел Устройства
[[File:rkeeper5.png|center|border]]
Соглашаемся с назначением в интерфейс
[[File:rkeeper6.png|center|border]]
2. В свойствах драйвера указывает URL интегратора и Токен
URL:
https://barlane.ru/api/v1/rkeeper/sales/xml
В поле "Authorization header fo" оставить значение по умолчанию:
Authorization:Bearer %s
Токен можно запросить у технической поддержки БАРЛАЙВ (или самостоятельно взять в свойствах "Торгового объекта" в блоке "Порционный учёт" (не перепутать с токеном для IIKO!); если в строке токена пусто - нажать "записать" и затем заново открыть свойства "торгового объекта").
[[File:rkeeper7.png|center|border]]
'''БУФЕРНЫЙ МОДУЛЬ'''
'''ВАЖНО!''' Для работы оффлайн режима можно установить "Буферный модуль" - его установка и настройка описана ниже в [[Порционное_списание_в_ЕГАИС#ПРИЛОЖЕНИЕ 1. Настройка "Буферного Модуля"|приложении]] (ставится туда где есть локальная связь с Кассовым Сервером).
В случае если используется "Буферный модуль", в "Менеджерской" Ркипер надо поменять настройку для алкоинтерфейса кассового сервера с https://barlane.ru/api/v1/rkeeper/sales/xml на http://localhost:7300/buffer/v1/rkeeper/sales/xml (адрес и порт такие если модуль на одном ПК с кассовым сервером).
Логи обмена Rkeeper с БАРЛАЙВ хранятся в папке, где установлен кассовый сервер, в файле rkalcoex.log.
'''ВАЖНО''': Проверьте, чтобы не был включен "фаркардс" настроенный на ЕГАИС; если вдруг включен (как на скриншоте ниже) - ОТКЛЮЧИТЕ ЕГО!
[[File:farcards.png|center|border]]
'''Настройки карточки блюда в RK'''
0. Сервис - Интерфейсы - проверьте что "'''Интерфейс Алкоголь/Россия линк'''" активен, а также что у него проставлена связь с добавленным ранее драйвером:
[[File:rk-interface-c.png|center|border]]
1. Проверьте наличие предустановленных условий:
[[File:rkeeper8.png|center|border]]
Также убедитесь, что модификаторы включены в используемые торговые группы
2. В справочнике Меню > Схемы модификаторов по умолчанию добавлена схема РОССИЯ: ЕГАИС, в которую входят группу модификаторов ЕГАИС EAN13 и DataMatrix/PDF417
[[File:rkeeper9.png|center|border]]
3. В справочник Меню > Классификации блюд по умолчанию добавлена классификация Маркировка/Россия с предустановленными категориями. Если классификация не активирована, активируйте ее.
Если меню было заведено до активации классификации, чтобы активировать классификацию Маркировка/Россия, снимите флаг Обяз. группировка. Активируйте классификацию, распределите все блюда по категориям, а потом снова выставьте флаг, если обязательность группировки нужна.
Для продажи алкоголя будут использоваться категории Алкогольные напитки и Алкогольные коктейли. Для категории Алкогольные напитки выбрана схема модификаторов РОССИЯ: ЕГАИС.
Также убедитесь, что категории включены в используемую торговую группу.
[[File:rkeeper10.png|center|border]]
4. Для каждого блюда, которое должно учитываться при порционной продаже алкоголя, заполните обязательные параметры.
Для чистого алкоголя:
a. В классификации Маркировка/Россия выберите категорию Алкогольные напитки.
b. Выберите Литр в свойстве Тип единицы измерения. Выбранное значение передаётся в атрибут фискального чека Мера количества предмета расчета (Тег 2108). Если значение не заполнено, передаются штуки.
c. В свойстве Тип товара выберите значение Подакцизный товар без кода маркировки.
d. Укажите объём порции.
'''ВАЖНО!''' Цена блюда должна быть выше 0 (и соотв-но должно пробиваться фискальными валютами) - иначе ЕГАИС вернёт ошибку о попытке реализации с нулевой ценой.
[[File:Rkeeper11aaa.png|center|border]]
'''Для коктейлей''':
a. В классификации Маркировка/Россия выберите категорию Алкогольные коктейли
b. В свойстве Тип товара оставьте значение Товар.
[[File:Rkeeper11b.png|center|border]]
===Загрузка номенклатуры из R-keeper===
После проставления настроек блюд описанных выше, для загрузки данных в справочник БАРЛАЙВ необходимо сделать два XML-запроса в r-keeper. Их можно сделать вручную, или через кнопку на сайте если настроен "Буферный модуль".
Речь о запросах описанных в этой [https://docs.rkeeper.ru/rk7/latest/ru/xml-interfejs-r_keeper-7-19605640.html#XMLинтерфейсr_keeper7-Аутентификацияивыполнениезапросов инструкции].
'''ВАЖНО''': Убедитесь, что признаки "алкогольные напитки" и "алкогольные коктейли" у нужных блюд проставлены.
'''ПРИМЕЧАНИЕ''': Если настроен "Буферный модуль" - то запросы ниже вручную делать не требуется, достаточно нажать на кнопку "Загрузить меню из RK" в разделе "Справочник номенклатуры". О настройке "Буферного модуля" - [[#ПРИЛОЖЕНИЕ 1. Настройка "Буферного Модуля"]]
[[File:bm5.png|center|border]]
Ниже описаны запросы для ручного формирования файлов и их загрузки в "Справочник номенклатуры".
'''Первый запрос''':
<?xml version="1.0" encoding="UTF-8"?>
<RK7Query >
<RK7CMD CMD="GetRefdata" RefName="ClassificatorGroups" >
</RK7CMD>
</RK7Query>
'''Второй запрос''':
<?xml version="1.0" encoding="UTF-8"?>
<RK7Query >
<RK7CMD CMD="GetRefdata" RefName="menuitems" OnlyActive="true">
</RK7CMD>
</RK7Query>
Файлы передать поддержке БАРЛАЙВ (указав какой первый, а какой второй) - и номенклатура будет загружена в систему. Или самостоятельно загрузить соответствующими кнопка в "Справочнике номенклатуры".
Если для "алкогольных напитков" не было указано алккодов в карточках R-keeper, то надо будет внести их в "справочник номенклатуры" вручную; об этом подробнее [[Модуль_Бухгалтера_БАРЛАЙВ#Справочник номенклатуры|инструкции]].
Для StoreHouse 5 есть возможность подгрузить алккоды и техкарты - об этом подробнее ниже.
===Получение данных из StoreHouse 5===
'''ПРИМЕЧАНИЕ''': При работе со StoreHouse 4 - придётся вручную проставить информацию об ингредиентах коктейлей в [[Модуль_Бухгалтера_БАРЛАЙВ#Справочник номенклатуры|справочнике БАРЛАЙВ]].
При работе со StoreHouse 5 - есть возможность подгрузить данные по коктейлям и алккоды "чистого" автоматически - для этого понадобится отдельная лицензия:
'''R-Keeper модуль Интеграции SH5 для внешних систем ЕГАИС 12 мес ПО (или 1 мес) – лицензия для интеграции ЕГАИС внешних систем.'''
Соотв-но без этой лицензии - тоже придётся заносить данные о коктейлях в справочник БАРЛАЙВ вручную.
Лицензирование проводится представителями вендора (дилерами). Также из технических требований - WhiteServer версии не ниже 2.8.6.1, более подробно о настройках WS - в [https://docs.rkeeper.ru/rk7/latest/ru/integratsiya-s-ispol-zovaniem-sh5-119014236.html инструкции от UCS].
Ниже описаны необходимые настройки в самом StoreHouse 5.
'''Настройки справочников'''
1. У ингредиентов коктейля должен быть выставлен флаг «Алкогольная продукция». И у данного товара на закладке «Единицы измерения» есть единица измерения «Литр»
[[File:rkeeper12.png|center|border]]
2. В комплекты блюд «коктейля» входят ингредиенты с флагом алкогольная продукция.
3. На блюде обязательно должен стоять флаг Производить.
4. Для блюд r_k 7 должна быть заполнена закладка "Списание" (определены подразделения списания)
Соотв-но сработает и для "чистого" алкоголя, если для него по аналогии настроен комплект.
А также необходимо передать поддержке БАРЛАЙВ следующие данные:
- Код ресторана в системе лицензирования
- Guid в SH Предприятие (=GUID ресторана RK)
- Guid в SH Место реализации (=GUID категории заказа RK; которое используется для коктейлей)
'''ВАЖНО!''' - "гуиды" вносить БЕЗ фигурных скобок {}
В R-keeper эти данные можно найти тут:
[[File:sh5downloadporc2.png|center|boreder]]
[[File:sh5downloadporc3.png|center|boreder]]
Или самостоятельно указать их в настройках "Торгового объекта" в блоке "Включить загрузку техкарт из sh5" (и включив эту настройку).
Если всё было сделано правильно, то в разделе "Справочник номенклатуры" появится кнопка "Загрузить тех.карты из sh5":
[[File:sh5downloadporc.png|center|boreder]]
По нажатию будут загружены техкарты по всем "коктейлям" у которых их нет.
===ПРИЛОЖЕНИЕ 1. Настройка "Буферного Модуля"===
Стандартная настройка "порционного учёта" с R-keeper (описанная выше) подразумевает прямую связь между Кассовым Сервером R-keeper ("MID") и сервером БАРЛАЙВ.
"Буферный модуль" ставится между Кассовым Сервером R-keeper ("MID") и сервером БАРЛАЙВ, обеспечивая "оффлайн режим" работы в случае сбоев интернета - т.е. чеки будут закрываться и сохраняться в памяти модуля, и как только связь появится - всё будет отправлено на сервер и соотв-но в ЕГАИС; а также обеспечивает загрузку меню в "Справочник номенклатуры" через сайт (без ручных выгрузок и загрузок файлов).
Модуль устанавливается туда, где есть локальная связь с Кассовым Сервером. В идеале - на тот же ПК где Кассовый Сервер и стоит - тогда адрес будет localhost; Но можно напр-р и на ПК с кассой (у которой очевидно есть локальная связь с Кассовым Сервером) - тогда надо будет указать не localhost а локальный ip Кассового Сервера (и убедиться что порт 7300 доступен).
Перед установкой также необходимо узнать адрес XML-интерфейса и логин и пароль (где делаются запросы для получения файлов меню для "Справочника номенклатуры").
Пример такого адреса - https://192.168.150.200:7777/rk7api/v0/xmlinterface.xml ; логин - http , пароль - http
ВАЖНО! Обратите внимание на переданный вам адрес, на его "хвост" - он может быть вида https://192.168.150.200:7777/webgui/iservxmltest.htm - такой адрес не подойдёт, это адрес для входа через браузер; если дали такой адрес, то просто сами поменяйте "хвост" - '''/webgui/iservxmltest.htm''' на '''/rk7api/v0/xmlinterface.xml'''
Порядок установки:
1 - Установить ASP.NET Core 8 и .NET Desktop Runtime 8 соответствующие разрядности ОС
https://dotnet.microsoft.com/en-us/download/dotnet/8.0
2 - Установить [https://disk.360.yandex.ru/d/D7Q2EonyEjObqg буферный модуль]
3 - В конфиге "буферного модуля" (файл appsettings.json) внести токен авторизации для R-keeper (в строке '''"XmlInterfaceApiTokens": [ "" ]''' , указать между кавычек), сохранить его. Пример:
[[File:bm1.png|center|border]]
4 - В настройках "торгового объекта" поставить галку у параметра '''"Включить xml-обмен через буферный модуль"''', в появившихся полях внести данные связи с xml-интерфейсом, пример:
[[File:bm2.png|center|border]]
5 - В "Менеджерской" Ркипер поменять настройку для алкоинтерфейса кассового сервера с https://barlane.ru/api/v1/rkeeper/sales/xml на http://localhost:7300/buffer/v1/rkeeper/sales/xml
(ВАЖНО! Если "Буферный модуль" не на том же ПК что и Кассовый Сервер RK, то будет не "localhost" а ip адрес ПК где установили "Буферный модуль")
[[File:bm3.png|center|border]]
6 - Перезапустить кассовый сервер (ВАЖНО! Согласовать перезапуск c ответственными в заведении, т.к. в этот момент ~минуту кассы будут недоступны)
7 - Запустить службу "буферного модуля" (Barlane Buffer Module Service)
[[File:bm4.png|center|border]]
8 - Проверить загрузку меню - "Справочник номенклатуры" - кнопка "Загрузить меню из RK"
[[File:bm5.png|center|border]]
Ответ можно увидеть в т.ч. логах (кнопка сверху слева "Логи RK")
[[File:bm6.png|center|border]]
В случае ошибок или зависания запроса - перепроверьте все настройки выше (в т.ч. указанный адрес XML-интерфейса - что там "хвост" '''/rk7api/v0/xmlinterface.xml''' а не '''/webgui/iservxmltest.htm''')
9 - Проверить что чеки успешно закрываются и приходят на сайт в раздел "Чеки".
==БАРЛАЙВ в интеграции с IIKO==
'''ПРИМЕЧАНИЕ''': Данная инструкция будет дополняться и правиться в первое время внедрения "порционного учёта".
Последние правки - 09.07.2024
Описание работы с "порционным учётом" в интеграции с IIKO:
1 - Бармен открыл бутылку, отсканировал в БАРЛАЙВ штрих-код; этот ШК зафиксировался в пуле открытых бутылок (этот пул представляет из себя таблицу из ШК и доступного объёма в миллилитрах).
2 - Бармен закрывает заказ, пробивает чек в IIKO; IIKO отправляет информацию в БАРЛАЙВ с пометкой "чистый алкоголь" или "коктейли".
2.1 - Если в заказе "чистый" алкоголь - то БАРЛАЙВ смотрит в пуле открытых бутылок есть ли ШК нужной продукции и достаточно ли там объёма - забирает ШК и с помощью него формирует чек, отправляет в ЕГАИС.
2.2 - Если в заказе "коктейль" - то БАРЛАЙВ смотрит (по техкарте) в пуле открытых бутылок есть ли ШК нужных бутылок и достаточно ли там объёма - забирает ШК и с помощью них формирует акт списания с причиной "приготовление" и отправляет в ЕГАИС.
Для работы интеграции необходимо установить плагин БАРЛАЙВ, а также произвести необходимые настройки в IIKO (и проверить наличие необходимых лицензий).
===Предварительные настройки в IIKO===
Необходимые настройки:
1. Версия iiko 8.*.* и выше
a. Для корректной отправки заказа во внешнюю систему нужно убедиться, что заполнено
b. ИНН и КПП в разделе «Общие настройки»
c. В настройках юр.лица проверить что проставлены название, ИНН и КПП:
[[File:iikoapi1.png|border|center]]
d. Все алкогольные товары iiko имеют ед. изменения "л" и заполнен классификатор видов алкогольной продукции (в карточке товара вкладка "Дополнительная информация" - "Алкогольная декларация" проставлен вид алкогольной продукции):
[[File:iikoapi2.png|border|center]]
e. В настройках учёта разрешены АР с отрицательными остатками ("настройках торгового предприятия" - во вкладке "настройки учёта"):
[[File:iikoapi3.png|border|center]]
f. Структура Блюд или Товаров, которые продаются на кассе с содержанием алкоголя могут быть вида
g. Продажа сразу товара на кассе
h. Блюдо содержит в ттк сам алкогольный товар или вложенное блюдо/заготовку , в структуре
вложений которого есть непосредственно алкоголь,
i. Само блюдо и вложенные в него ПФ должны иметь метод списания «Списывать ингредиенты»
[[File:iikoapi4.png|border|center]]
j. Блюдо с модификаторами, в составе которых есть алкоголь также будут учтены, в составе позиции будут переданы все алкогольные позиции
'''ПРИМЕЧАНИЕ 1''':
Для "чистых" блюд, у которых в техкарте несколько ингредиентов (напр-р "Коньяк 50мл" с долькой лимона) необходимо указывать пользовательское свойство '''NotCocktail''', чтобы уходило как "чистый" а не "коктейль".
Создание "пользовательского свойства" описано в [https://ru.iiko.help/articles/#!iikooffice-8-4/custom-tags/a/h2__773755849 инструкции] от IIKO. '''ВАЖНО''' - называться свойство должно именно '''NotCocktail'''
'''ПРИМЕЧАНИЕ 2''':
Для блюд, в которых есть алкогольные товары но которые не должны учитываться, необходимо указывать пользовательское свойство "notAlcohol".
===Установка плагина БАРЛАЙВ для IIKO Front===
[https://disk.360.yandex.ru/d/L5e2Eh8VeMyJjQ Скачать плагин БАРЛАЙВ для IIKO Front]
Установка плагина:
'''ВАЖНО!''' Плагин ставится на каждый терминал, где фискальная касса (ККТ/ФР) и пробивают алкоголь содержащие позиции.
1. Для запуска плагина необходима лицензия (21016318) 'FrontPaymentPlugin (Внутренний платежный интерфейс фронта)
2. Api Server – для доступа к ттк и отчётам по продажам, обе лицензии как правило есть в
решениях iiko Cloud
3. Поместить содержимое архива выше в Папку Plugins iikoFront например
C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Barlane
4. При запуске должно возникнуть сообщение об ошибке запуска плагина, необходимо выключить
фронт и изменить файл настроек, который хранится в разделе
5. C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\AppData\Roaming\iiko\CashServer\PluginConfigs\Barlane\Barlane_Front_Config.xml
<Uri>https://example.iiko.it:443/resto<</Uri> -- адрес и порт сервера IIKO
<Login>admin</Login> -- логин учётки IIKO (напр-р "системного администратора")
<Pass>1</Pass> -- пароль учётки IIKO
<BarlaneURI> https://barlane.ru/api</BarlaneURI>> -- оставить по умолчанию (адрес сервера БАРЛАЙВ)
<Barlane_Token>yWrm8dSRC-1pCJ1JtRIi5*********</Barlane_Token> -- токен авторизации объекта
'''ПРИМЕЧАНИЕ 1''': Токен запросите у тех.поддержки БАРЛАЙВ (с указанием что для IIKO) или посмотрите в свойствах "Торгового объекта" в блоке "Порционный учёт" (не перепутайте с токеном для R-keeper!).
'''ПРИМЕЧАНИЕ 2''': Актуальный адрес сервера IIKO можно посмотреть в настройках подключения IIKO Office:
[[File:iiko-resto.png|center|border]]
'''ПРИМЕЧАНИЕ 3''': НЕ ЗАБЫВАЙТЕ ПРО ПУТЬ "/resto" !!! Ещё раз пример указания адреса в конфиге:
<Uri>https://example.iiko.it:443/resto<</Uri>
6. После внесений изменений и запуска кассы будет выведено сообщение вида:
[[File:iiko-plugin-success.png|center]]
7. Кассир получает уведомления только в случае ошибок отправки заказа.
8. Если нет связи с сервером IIKO или БАРЛАЙВ или ошибка отправки заказ – плагин повторно
обрабатывает заказ.
9. Для тестирования можно создать заказ с алкоголем и после его отменить/удалить и проверить
успешность создания заказа в БАРЛАЙВ.
===Настройки Справочника IIKO в БАРЛАЙВ===
Если вы выгружали накладные из БАРЛАЙВ в IIKO, то дополнительных действий по "чистым" блюдам не потребуется. Если же не выгружали - то сделайте настройки по данной [[Модуль Бухгалтера БАРЛАЙВ# Выгрузка в iiko|инструкции]].
==БАРЛАЙВ в работе с только коктейлями==
Данный режим подходит заведениям, где есть только коктейли; а также концертным площадкам и ночным клубам, которые пользуются функцией "режим исключения" при работе с Модулем Бармена БАРЛАЙВ.
Как это было до 01.07.2024:
1 - Перед мероприятием (сменой) бармены сканируют в БАРЛАЙВ весь закрытый алкоголь, который будет доступен для реализации.
2 - Во время мероприятия (смены) бармены не отвлекаются на сканирование бутылок - и концентрируются на работе с гостями.
3 - После окончания мероприятия (смены) бармены переключают приложение БАРЛАЙВ в "режим исключения" и сканируют оставшиеся закрытые бутылки - они исключаются из общего списка, т.о. там остаются только те позиции, которые были реализованы - и они уходят на списание.
Чтобы сохранить данный режим работы, помимо обновления Модуля Бармена БАРЛАЙВ (о наличии новой версии будет указано здесь), необходимо перевести все свои алкогольные ("крепкие") позиции в "коктейли" согласно определению:
"Коктейль" - это «блюдо», приготовленное в соответствии с технологической картой организации, путем смешения закупленной алкогольной продукции, содержащейся в потребительской упаковке и маркированной в соответствии со статьей 12 Закона № 171-ФЗ с иной пищевой продукцией (пункт 15 статьи 2 Закона № 171-ФЗ).
Т.о. не потребуется интеграция с кассовым ПО, т.к. весь алкоголь будет списываться актами, напрямую через БАРЛАЙВ.
И самое важное - бармены точно так же будут сканировать бутылки без указания порций, как делали это и раньше.
'''ПРИМЕЧАНИЕ''': Для заведений с коктейлями и с небольшим потоком доступен и режим с указанием порций при каждом сканировании.