2532
правки
Изменения
м
Замена текста — «BARLANE» на «БАРЛАЙВ»
"Коктейль" - это «блюдо», приготовленное в соответствии с технологической картой организации, путем смешения закупленной алкогольной продукции, содержащейся в потребительской упаковке и маркированной в соответствии со статьей 12 Закона № 171-ФЗ с иной пищевой продукцией (пункт 15 статьи 2 Закона № 171-ФЗ).
==Варианты работы с "порционкой" в BARLANEБАРЛАЙВ==
Для удобства пользователей в BARLANE БАРЛАЙВ реализовано 2 варианта работы с "порционкой":
1 - В интеграции с кассовым ПО (R-keeper, IIKO)
----
<FONT SIZE=5>'''ВАЖНО''' - Бармену так же как и раньше - надо будет просто сканировать вскрытые бутылки в приложение BARLANEБАРЛАЙВ, всё, дополнительных действий не появится.</FONT>
----
Основное изменение коснётся автоматической работы с отсканированными марками - если сейчас автоматика работает одним образом, то с "порционкой" будет работать по-новому (в т.ч. в интеграции с кассовым ПО).
==Требуемые обновления и настройки модулей BARLANEБАРЛАЙВ==
Позже здесь будет написано о релизе новых версий.
Все требуемые обновления и настройки со стороны BARLANE БАРЛАЙВ - сделает тех.поддержка.
Однако, заранее стоит проверить свои ПК на возможную необходимость в обновлении операционной системы.
Т.о. необходимо проверить, что на ПК с данными модулями ОС не ниже Windows 7 SP1 (и на них возможно установить вышеперечисленные .NET).
==BARLANE БАРЛАЙВ в интеграции с R-keeper==
'''ПРИМЕЧАНИЕ''': Данная инструкция будет дополняться и правиться в первое время внедрения "порционного учёта".
Описание работы с "порционным учётом" в интеграции с R-keeper:
1 - Бармен открыл бутылку, отсканировал в BARLANE БАРЛАЙВ штрих-код; этот ШК зафиксировался в пуле открытых бутылок (этот "пул" представляет из себя таблицу из ШК и доступного объёма в миллилитрах).
2 - Бармен закрывает заказ, пробивает чек в R-keeper; R-keeper отправляет информацию в BARLANE БАРЛАЙВ с пометкой “чистый алкоголь” или “коктейли”.
2.1 - Если в заказе “чистый” алкоголь - то BARLANE БАРЛАЙВ смотрит в пуле открытых бутылок есть ли ШК нужной продукции и достаточно ли там объёма - забирает ШК и с помощью него формирует чек, отправляет в ЕГАИС.
2.2 - Если в заказе “коктейль” - то BARLANE БАРЛАЙВ смотрит в пуле открытых бутылок есть ли ШК нужных бутылок и достаточно ли там объёма - забирает ШК и с помощью них формирует акт списания с причиной “приготовление” и отправляет в ЕГАИС.
Сопоставление "код блюда r-keeper" - "алккод ЕГАИС" происходит по внутренним справочникам в BARLANEБАРЛАЙВ. Блюда из R-keeper можно выгрузить; а тех-карты коктейлей для sh4 заполняются вручную, для sh5 (с лицензией WS) - подгружаются. Об этом ниже будет подробнее.
Таким образом, после предварительных настроек работа на стороне пользователя останется прежней - надо будет как ранее просто сканировать при вскрытии бутылки в BARLANEБАРЛАЙВ.
'''ПРИМЕЧАНИЕ''': При пробитии заказов у алкогольной продукции будет показывать знак вопроса - '''НЕ НАЖИМАТЬ''' на него, иначе будет требовать указание модификатора.
Authorization:Bearer %s
Токен можно запросить у технической поддержки BARLANE БАРЛАЙВ (или самостоятельно взять в свойствах "Торгового объекта" в блоке "Порционный учёт" (не перепутать с токеном для IIKO!); если в строке токена пусто - нажать "записать" и затем заново открыть свойства "торгового объекта").
[[File:rkeeper7.png|center|border]]
В случае если используется "Буферный модуль", в "Менеджерской" Ркипер надо поменять настройку для алкоинтерфейса кассового сервера с https://barlane.ru/api/v1/rkeeper/sales/xml на http://localhost:7300/buffer/v1/rkeeper/sales/xml (адрес и порт такие если модуль на одном ПК с кассовым сервером).
Логи обмена Rkeeper с BARLANE БАРЛАЙВ хранятся в папке, где установлен кассовый сервер, в файле rkalkosh.log.
'''ВАЖНО''': Проверьте, чтобы не был включен "фаркардс" настроенный на ЕГАИС; если вдруг включен (как на скриншоте ниже) - ОТКЛЮЧИТЕ ЕГО!
===Загрузка номенклатуры из R-keeper===
После проставления настроек блюд описанных выше, для загрузки данных в справочник BARLANE БАРЛАЙВ необходимо сделать два XML-запроса в r-keeper. Их можно сделать вручную, или через кнопку на сайте если настроен "Буферный модуль".
Речь о запросах описанных в этой [https://docs.rkeeper.ru/rk7/latest/ru/xml-interfejs-r_keeper-7-19605640.html#XMLинтерфейсr_keeper7-Аутентификацияивыполнениезапросов инструкции].
</RK7Query>
Файлы передать поддержке BARLANE БАРЛАЙВ (указав какой первый, а какой второй) - и номенклатура будет загружена в систему. Или самостоятельно загрузить соответствующими кнопка в "Справочнике номенклатуры".
Если для "алкогольных напитков" не было указано алккодов в карточках R-keeper, то надо будет внести их в "справочник номенклатуры" вручную; об этом подробнее [[Модуль_Бухгалтера_BARLane#Справочник номенклатуры|инструкции]].
===Получение данных из StoreHouse 5===
'''ПРИМЕЧАНИЕ''': При работе со StoreHouse 4 - придётся вручную проставить информацию об ингредиентах коктейлей в [[Модуль_Бухгалтера_BARLane#Справочник номенклатуры|справочнике BARLANEБАРЛАЙВ]].
При работе со StoreHouse 5 - есть возможность подгрузить данные по коктейлям и алккоды "чистого" автоматически - для этого понадобится отдельная лицензия:
'''R-Keeper модуль Интеграции SH5 для внешних систем ЕГАИС 12 мес ПО (или 1 мес) – лицензия для интеграции ЕГАИС внешних систем.'''
Соотв-но без этой лицензии - тоже придётся заносить данные о коктейлях в справочник BARLANE БАРЛАЙВ вручную.
Лицензирование проводится представителями вендора (дилерами). Также из технических требований - WhiteServer версии не ниже 2.8.6.1, более подробно о настройках WS - в [https://docs.rkeeper.ru/rk7/latest/ru/integratsiya-s-ispol-zovaniem-sh5-119014236.html инструкции от UCS].
Соотв-но сработает и для "чистого" алкоголя, если для него по аналогии настроен комплект.
А также необходимо передать поддержке BARLANE БАРЛАЙВ следующие данные:
- Код ресторана в системе лицензирования
===ПРИЛОЖЕНИЕ 1. Настройка "Буферного Модуля"===
Стандартная настройка "порционного учёта" с R-keeper (описанная выше) подразумевает прямую связь между Кассовым Сервером R-keeper ("MID") и сервером BARLANEБАРЛАЙВ.
"Буферный модуль" ставится между Кассовым Сервером R-keeper ("MID") и сервером BARLANEБАРЛАЙВ, обеспечивая "оффлайн режим" работы в случае сбоев интернета - т.е. чеки будут закрываться и сохраняться в памяти модуля, и как только связь появится - всё будет отправлено на сервер и соотв-но в ЕГАИС; а также обеспечивает загрузку меню в "Справочник номенклатуры" через сайт (без ручных выгрузок и загрузок файлов).
Модуль устанавливается туда, где есть локальная связь с Кассовым Сервером. В идеале - на тот же ПК где Кассовый Сервер и стоит - тогда адрес будет localhost; Но можно напр-р и на ПК с кассой (у которой очевидно есть локальная связь с Кассовым Сервером) - тогда надо будет указать не localhost а локальный ip Кассового Сервера (и убедиться что порт 7300 доступен).
9 - Проверить что чеки успешно закрываются и приходят на сайт в раздел "Чеки".
==BARLANE БАРЛАЙВ в интеграции с IIKO==
'''ПРИМЕЧАНИЕ''': Данная инструкция будет дополняться и правиться в первое время внедрения "порционного учёта".
Описание работы с "порционным учётом" в интеграции с IIKO:
1 - Бармен открыл бутылку, отсканировал в BARLANE БАРЛАЙВ штрих-код; этот ШК зафиксировался в пуле открытых бутылок (этот пул представляет из себя таблицу из ШК и доступного объёма в миллилитрах).
2 - Бармен закрывает заказ, пробивает чек в IIKO; IIKO отправляет информацию в BARLANE БАРЛАЙВ с пометкой "чистый алкоголь" или "коктейли".
2.1 - Если в заказе "чистый" алкоголь - то BARLANE БАРЛАЙВ смотрит в пуле открытых бутылок есть ли ШК нужной продукции и достаточно ли там объёма - забирает ШК и с помощью него формирует чек, отправляет в ЕГАИС.
2.2 - Если в заказе "коктейль" - то BARLANE БАРЛАЙВ смотрит (по техкарте) в пуле открытых бутылок есть ли ШК нужных бутылок и достаточно ли там объёма - забирает ШК и с помощью них формирует акт списания с причиной "приготовление" и отправляет в ЕГАИС.
Для работы интеграции необходимо установить плагин BARLANEБАРЛАЙВ, а также произвести необходимые настройки в IIKO (и проверить наличие необходимых лицензий).
===Предварительные настройки в IIKO===
Для блюд, в которых есть алкогольные товары но которые не должны учитываться, необходимо указывать пользовательское свойство "notAlcohol".
===Установка плагина BARLANE БАРЛАЙВ для IIKO Front===
[https://disk.360.yandex.ru/d/Xi2p2o7mcL1y2w Скачать плагин BARLANE БАРЛАЙВ для IIKO Front]
Установка плагина:
<Pass>1</Pass> -- пароль учётки IIKO
<BarlaneURI> https://barlane.ru/api</BarlaneURI>> -- оставить по умолчанию (адрес сервера BARLANEБАРЛАЙВ)
<Barlane_Token>yWrm8dSRC-1pCJ1JtRIi5*********</Barlane_Token> -- токен авторизации объекта
'''ПРИМЕЧАНИЕ 1''': Токен запросите у тех.поддержки BARLANE БАРЛАЙВ (с указанием что для IIKO) или посмотрите в свойствах "Торгового объекта" в блоке "Порционный учёт" (не перепутайте с токеном для R-keeper!).
'''ПРИМЕЧАНИЕ 2''': Актуальный адрес сервера IIKO можно посмотреть в настройках подключения IIKO Office:
7. Кассир получает уведомления только в случае ошибок отправки заказа.
8. Если нет связи с сервером IIKO или BARLANE БАРЛАЙВ или ошибка отправки заказ – плагин повторно
обрабатывает заказ.
9. Для тестирования можно создать заказ с алкоголем и после его отменить/удалить и проверить
успешность создания заказа в BARLANEБАРЛАЙВ.
===Настройки Справочника IIKO в BARLANEБАРЛАЙВ===
Если вы выгружали накладные из BARLANE БАРЛАЙВ в IIKO, то дополнительных действий по "чистым" блюдам не потребуется. Если же не выгружали - то сделайте настройки по данной [https://wiki.barlane.ru/index.php?title=%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C_%D0%91%D1%83%D1%85%D0%B3%D0%B0%D0%BB%D1%82%D0%B5%D1%80%D0%B0_BARLane#.D0.92.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B0_.D0.B2_iiko инструкции].
==BARLANE БАРЛАЙВ в работе с только коктейлями==
Данный режим подходит заведениям, где есть только коктейли; а также концертным площадкам и ночным клубам, которые пользуются функцией "режим исключения" при работе с Модулем Бармена BARLANEБАРЛАЙВ.
Как это было до 01.07.2024:
1 - Перед мероприятием (сменой) бармены сканируют в BARLANE БАРЛАЙВ весь закрытый алкоголь, который будет доступен для реализации.
2 - Во время мероприятия (смены) бармены не отвлекаются на сканирование бутылок - и концентрируются на работе с гостями.
3 - После окончания мероприятия (смены) бармены переключают приложение BARLANE БАРЛАЙВ в "режим исключения" и сканируют оставшиеся закрытые бутылки - они исключаются из общего списка, т.о. там остаются только те позиции, которые были реализованы - и они уходят на списание.
Чтобы сохранить данный режим работы, помимо обновления Модуля Бармена BARLANE БАРЛАЙВ (о наличии новой версии будет указано здесь), необходимо перевести все свои алкогольные ("крепкие") позиции в "коктейли" согласно определению:
"Коктейль" - это «блюдо», приготовленное в соответствии с технологической картой организации, путем смешения закупленной алкогольной продукции, содержащейся в потребительской упаковке и маркированной в соответствии со статьей 12 Закона № 171-ФЗ с иной пищевой продукцией (пункт 15 статьи 2 Закона № 171-ФЗ).
Т.о. не потребуется интеграция с кассовым ПО, т.к. весь алкоголь будет списываться актами, напрямую через BARLANEБАРЛАЙВ.
И самое важное - бармены точно так же будут сканировать бутылки без указания порций, как делали это и раньше.
'''ПРИМЕЧАНИЕ''': Для заведений с коктейлями и с небольшим потоком доступен и режим с указанием порций при каждом сканировании.