1029
правок
Изменения
Внутреннее:Инструкция по подключению БАРЛАЙВ ЕГАИС (посмотреть исходный код)
Версия от 14:13, 4 июня 2026
, 4 июньНовая страница: «<center><FONT SIZE=7>Подключение БАРЛАЙВ ЕГАИС</FONT></center> ==Подготовка к подключению== Перед подклю...»
<center><FONT SIZE=7>Подключение БАРЛАЙВ ЕГАИС</FONT></center>
==Подготовка к подключению==
Перед подключением в наличии должны быть следующие сведения:
- Контакты
- Данные админской учётной записи клиента (ФИО и почта, к которой всё будет привязано)
- Информация о месте установки модуля бармена - касса или отдельный ПК; и мобильных барменов
- ИНН, КПП (и юр.лица и обособки; они могут совпадать), ФСРАР-id и адрес точек (а также название объекта – «Кафе Рогалик», «ЕвроМакс» и т.п.)
Должна быть возможность отправлять письма с почты admin@barlive.ru
Должны быть подготовлены актуальные дистрибутвы.
'''ПРИМЕЧАНИЕ''': Проверить через https://egrul.nalog.ru/ корректность ИНН и КПП юр.лица.
==Настройки в ЛК Барлайн (заведение точки и учётных записей)==
[[File:buhlogo.png|right]]
'''Войти в свою учётную запись Интегратора:'''
- Открыть сайт https://egais.barlive.ru/
- Ввести логин и пароль
1. '''Создать Юр.лицо:'''
«Юр.лица» - «Добавить» - Ввести название юр.лица (напр-р ООО «Ромашка») - Ввести ИНН – «Добавить» по примеру ниже:
[[File:blinst1b.png|600px]]
Указывать "Примечание", если есть особая информация по юр.лицу (нет поддержки, поставщик и т.п.).
Примечание можно указывать с html-разметкой, например:
<nowiki>
<font size="5" color="red" face="Arial">БЕЗ ПОДДЕРЖКИ</font>
</nowiki>
где
'''font size''' - размер шрифта
'''color''' - цвет
'''face''' - шрифт
Результат:
[[File:commenturlico.png]]
----
2. '''Создать Торговый Объект:'''
«Торговые объекты» - «Добавить»:
- Название (напр-р «Кафе Рогалик»)
- ИНН предприятия
- КПП юр.лица
- КПП обособленного подразделения
- ФСРАР-id (СИО) (ПРИМЕЧАНИЕ: убедитесь, что таблицы не "съели" первый ноль)
- '''ВАЖНО''': Выбрать созданную ранее корпорацию (т.о. объект привязывается к юр.лицу)
- Пропустить настройки с "галками"
- Адрес
'''ВАЖНО''' - Если у клиент торгует не только пивом, то отметить галку "'''Включить порционное списание'''" - и там указать кассовое ПО; отметить галкой "'''Отправлять чеки в ЕГАИС'''"; а также "Режим "'''Пул вскрытых марок'''": вкл/выкл" (остальные режимы во время обучения можно будет довключить если вдруг потребуется).
Нажать "'''Добавить'''".
'''ПРИМЕЧАНИЕ 1:''' Автосписание, Автозапрос остатков (оба регистра) - не трогать. При их включении необходимо указать время автосписания/автозапроса. В указанное время спишутся все сопоставленные марки/запросятся остатки. При обучении рекомендовать клиенту следующее -
выставлять запрос остатков Р2 за час до автосписания; запрос остатков Р1 - за полтора часа до автосписания.
'''ПРИМЕЧАНИЕ 2:''' Согласовать включение автозапроса марок (для получения всех остатков Р1-Р3).
----
3. Добавить Кассу (модуль бармена):
«Кассы» - «Добавить» - Заполнить поля:
- Название (напр-р «Бар 1 Рогалик»),
- Выбрать созданный ранее **Торговый Объект**,
Нажать «Добавить».
----
4. Добавить Кассу робота (для возможности добавления шк вручную):
«Кассы» - «Добавить» - Заполнить поля:
- Название (напр-р «Робот Рогалик»),
- Выбрать созданный ранее **Торговый Объект**
- Нажать на галку «Виртуальная»,
Нажать «Добавить».
----
5. Добавить Транспортный модуль (для модуля синхронизации с УТМ):
«Транспортные модули» - «Добавить» - Заполнить поля:
- Название (напр-р «УТМ Рогалик»),
- Пароль (сгенерировать)
- Выбрать созданный ранее **Торговый Объект**,
- Отметить галку "включить новую версию (порционка)
Нажать «**Добавить**».
----
6. Добавить Учётную запись Администратора:
«Учётные записи» – «Добавить» - Заполнить поля:
Роль – выбрать роль Администратор (ЕГАИС)
Корпорация – выбрать ранее заведённую корпорацию (ПРИМЕЧАНИЕ: Если учётка для нескольких юр.лиц - указать несколько)
Логин – почту, полученную ранее (напр-р ivan@mail.ru)
Фамилия Имя – ФИО, полученные ранее
e-mail – почта
Телефон – оставить пустым
Пароль - сгенерировать; **ВАЖНО**: Временно сохраните у себя этот пароль, т.к. далее надо будет отправить его клиенту.
Нажать «Добавить».
----
7. Добавить Учётную запись Бармена:
«Учётные записи» – «Добавить» - Заполнить поля:
Роль – выбрать роль Бармен (ЕГАИС)
Корпорация – выбрать ранее заведённую корпорацию
PIN - выставить по умолчанию 1111 (если учёток несколько, то для следующей 2222 и так далее; клиенту сообщить выставленный по умолчанию пин и рассказать, что при желании он может его поменять)
Логин – напр-р «БарменРогалик» (**ВАЖНО**! Используйте в имени название объекта и нумеруйте, если требуется)
Фамилия Имя – напр-р «Бармен Рогалик» (**ВАЖНО**! Используйте в имени название объекта и нумеруйте, если требуется)
----
8. Привязать Учётные записи к Торговому Объекту:
ВАЖНО: Данную процедуру необходимо совершать для ролей "Бухгалтер" и "Бармен"; Для "Администратора" - не требуется.
«Торговые Объекты» - выбрать ранее созданный :
Внизу «Учётные записи», в поиск вставить имя ранее созданной учётной записи (на примере бармена) – нажать «Добавить»:
[[File:blinst2.png|600px]]
то же самое для созданной ранее учётки бухгалтера, если была такая создана; Добавленные учётки должны отображаться в таблице учётных записей.
Нажать «Записать» - учётки привязались.
При обучении клиента рассказать о пунктах 6-8 (заведение учётных записей и привязка к объекту).
ПРИМЕЧАНИЕ: При первом редактировании "Торгового объекта" может выйти ошибка с требованием заполнить "Код страны" и "Код региона"; Код страны всегда указывать **643** (Россия); Код региона как правило первые цифры ИНН, исключением может быть Москва, где начали выдавать ИНН начинающиеся с 99; Код региона Москвы при этом - 77.
----
9. Отправить учётную запись клиенту:
На ранее указанную почту от admin@barlive.ru отправить письмо:
Тема – {Название_корпорации} учётная запись БАРЛАЙВ ЕГАИС
Содержимое письма:
Добрый день,
ИНСТРУКЦИЯ (КАК РАБОТАТЬ В "БАРЛАЙВ ЕГАИС"):
https://wiki.barlive.ru/
Юр.лицо ООО "ХХХХХ"
Ваша учётная запись администратора:
Логин – ххххххх
Пароль – ххххххххх
Рекомендуем самостоятельно сменить пароль (Раздел «Главная» - «Профиль и настройки»)
Зайти в личный кабинет - https://egais.barlive.ru/
Просьба добавить данный адрес (admin@barlive.ru) в список доверенных отправителей, чтобы письма не попадали в спам!
----
10. Связаться с клиентом, получить удалённые доступы к местам установки Модулей Бармена (там, где будут непосредственно сканировать) и Модуля Синхронизации (там, где есть связь с УТМ) – это может быть и один ПК.
Для работы Модулей необходим интернет.
----
==Настройка интеграции с кассовым ПО==
Если клиент работает с "крепким" ("маркируемым") алкоголем, значит для работы с "порционным списанием" необходима интеграция с кассовым ПО.
На данный момент интеграция есть с системами R-keeper и IIKO.
Необходимо взять контакты организации, занимающейся у клиента поддержкой кассового ПО и передать им инструкцию:
https://wiki.barlive.ru/wiki/%D0%9F%D0%BE%D1%80%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D0%BE%D0%B5_%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5_%D0%B2_%D0%95%D0%93%D0%90%D0%98%D0%A1
По которой им требуется произвести настройки у себя.
==Установка Модуля Синхронизации (ТМ)==
[[File:svclogo.png|right|100px]]
'''ВАЖНО''': Если клиент не начинают работу в ЕГАИС с нуля, после установки ТМ обязательно запустить автозапрос марок и проконтролировать его исполнение!!!
Подготовить дистрибутивы (архив с файлом **TransportModuleInstaller-3.x.xxx.x.exe**)
ТМ - https://disk.360.yandex.ru/d/LYEKxPjIplXlsA
.NET 8 - https://disk.yandex.ru/d/jKHpZls3jiYjgQ
VC (Нужно только для Win7; на ОС более новых - не нужно ставить) - https://disk.yandex.ru/d/CHjXsYxgkYVCGg
Подключиться к ПК, с которого есть доступ к УТМ.
Сначала установить .NET; затем если Win7 - установить VC (не требуется если более новые ОС).
Затем запустить файл **TransportModuleInstaller-3.x.xxx.x.exe**, программа установится в папке C:\Barlane\TransportModule
Откроется менеджер ТМ :
[[File:tminstall1.png|600px]]
На сайте открыть раздел "**Транспортные модули**" - найти наш модуль – нажать на иконку QR-кода справа:
[[File:blinst5a.png|600px]]
И скопировать оттуда настройки "транспортного модуля" (сразу все строки) :
[[File:tminstall2.png|600px]]
Вернуться к менеджеру ТМ, нажать на плюс ("Добавить модуль") и вставить настройки:
[[File:tminstall3.png|600px]]
Заполнятся сразу все три строки:
[[File:tminstall4.png|600px]]
В верхней строке написать название объекта.
Нижнюю строку "Адрес УТМ" тоже заполнить самостоятельно.
Адрес УТМ указывается по умолчанию http://localhost:8080, т.к. в большинстве случаев Модуль Синхронизации устанавливается на тот же ПК, где стоит УТМ (как правило с портом 8080); Но бывают исключения, поэтому если УТМ на другом ПК - укажите корректно его ip.
Нажать ОК - модуль добавится и сразу будет запущен:
[[File:tminstall5.png|600px]]
Открыть Менеджер можно из трея (в нижнем правом углу):
[[File:tminstall6.png|600px]]
Соответственно, в случае необходимости на одном ПК можно добавлять несколько модулей.
'''ВАЖНО''': После установки ТМ обязательно запросить остатки (даже если они будут нулевые), иначе могут не записаться в остатки первые ТТН.
----
==Установка Модуля Выгрузки в sh4==
[[File:storexlogo.png|right|100px]]
[[File:sh4logo.png|right|100px]]
'''ВАЖНО''': Пропустить, если клиенту не требуется выгрузка входящих ТТН из БАРЛАЙВ в sh4.
Подготовить дистрибутивы:
blstorexcsvc-installer-x.x.x.xxx - https://disk.yandex.ru/d/P7cObl517rF5Ag
(старая версия - https://disk.yandex.ru/d/rCbwZDmYK3-hZQ)
sh4ole.dll - https://drive.google.com/file/d/1PWcsm9Dbxv4QQXtLAz6upR0Leo_Qqc1h/view?usp=sharing
Midas.dll - https://drive.google.com/file/d/1lAIZlblVKQWRr7Xt4Eg_lHjhQaZksw1K/view?usp=sharing
Клиент sh4 - https://disk.360.yandex.ru/d/vjl9GT6HyzbMmA
Подключиться к ПК, с которого есть доступ до сервера sh4 и доступ в интернет.
----
1. Зарегистрировать библиотеку midas.dll
- Закинуть файл **midas.dll** в папку **C:\Windows\SysWOW64** (для х64 ОС)
- Открыть командную строку (**cmd**) от имени администратора
- Ввести последовательно команды:
''cd C:\Windows\SysWOW64
regsvr32 midas.dll''
- В результате должно появиться окно "Регистрация успешно выполнена..."
'''ПРИМЕЧАНИЕ''': Для х86 (32-битной) ОС использовать путь C:\Windows\System32
----
2. Зарегистрировать библиотеку sh4Ole.dll
- Открыть содержимое папки sh4Ole
- Закинуть всё в каталог с программой StoreHouse4 (обычно C:\UCS\SH4 )
- Запустить под правами администратора программу regole.exe, нажать "RegisterServer".
'''ПРИМЕЧАНИЕ''': Если на ПК нет клиента sh4, то сначала установить его (ссылка на дистрибутив в начале инструкции); Только установить, настраивать не надо (т.е. запускаем установку и "далее" - "далее" - ... )
----
3. Установка Модуля Выгрузки.
Запустить файл **blstorexcsvc-installer-x.x.x.xxx**, программа установится в папку **C:\Barlane\StoreExchange**.
Есть два файла настройки (в папке **C:\Barlane\StoreExchange\config**):
network-config.cfg - связь с сервером БЛ;
store-config.cfg - связь с сервером sh4.
'''ВАЖНО''': Всё касаемо .NET framework - аналогично "Модулю Синхронизации".
----
4. Настройка связи с серевером БЛ.
Открыть файл network-config.cfg с помощью "блокнота".
'''Верхнюю часть не трогать''' (менять что-то только при использовании тестового сервера).
Заполнить значения [Entity] ("торговый объект") и [TransportModule] ("модуль синхронизации") аналогично настройкам Модуля Синхронизации.
Пример заполненного тестового конфига:
[[File:iikoconf1.png|600px]]
----
5. Настройка связи с сервером SH.
Открыть файл store-config.cfg с помощью "блокнота".
Пример конфига:
Version = 1
StoreSystemType = "StoreHouse4"
<nowiki>
[Connection]
Address = "127.0.0.1"
Port = 9080
UserName = "admin"
Password = ""
[Import]
[Import.WayBillSettings]
IgnoreMissingImporter = false
AllowMultipleStoresMatch = false
SpecialAccounting = false
UseStoreSystemCodes = true
UseExtCodes = true
[Import.InventorySettings]
RestsSource = "Real"
SpecialAccounting = false
UseStoreSystemCodes = true
UseExtCodes = true
</nowiki>
Выставить параметр сх4 :
StoreSystemType = "StoreHouse4"
Заполнить настройки связи с сервером sh4 (блок [Connection])
- Адрес и порт можно подсмотреть в sh4setup.exe
- Логин и пароль необходимо узнать у клиента ('''ВАЖНО''': логин пользователя sh4 должен быть в латинице)
Прочие параметры оставляем по-умолчанию, и при обучении по пожеланиям клиента их можно будет поменять (напоминаю, при изменении конфига для их применения необходимо перезапускать службу). Описание этих параметров:
<nowiki>[ImportSettings.WayBillSettings]</nowiki> - для ТТН (приходная накладная)
<nowiki>[ImportSettings.InventorySettings]</nowiki> - для инвентаризаций (сличительная ведомость)
SpecialAccounting - возможность работы в спецучёте.
true - выгрузка в спецучет
false - выгрузка в обычный режим
RestsSource - Источник данных об остатках товара при выгрузке инвентаризации:
"Egais" - остатки ЕГАИС
"Real" - остатки ФАКТ
AllowMultipleStoresMatch - возможность выгрузки в несколько складов, найденных по FSRAR-ID получателя. Копия накладной будет выгружена во все найденные склады.
true - функция включена
false - функция выключена
UseStoreSystemCodes - возможность принудительно использовать при сопоставлении продукции только коды sh4
true - функция включена
false - функция выключена
UseExtCodes - возможность принудительно использовать при сопоставлении продукции только алккоды (по умолчанию работает эта опция)
true - функция включена
false - функция выключена
----
6. Запустить службу Модуля Выгрузки.
Открыть "Службы", запустить "Barlane StoreExchange Module service".
'''ВАЖНО''': Всё касаемо .NET framework - аналогично "Модулю Синхронизации".
----
===Минимум прав для пользователя sh4===
Склад – Накладные – все права (чтение+запись)
Словари – все права на чтение
Алкогольные декларации – все права (чтение+запись)
Общедоступные процедуры – все права (чтение+запись)
Процедуры:
GsExtcodes
GoodsTree
Goods
GoodByRID
GoodsMUnits
CorrPropertyByRID
CorrFList
CorrFullList
InsDoc0
InsDoc8
Doc0
Doc8
SetDocHdrAttr
SetDocSpecAttr
DocAttrList
DocHdrAttrList
CalcDocNum
----
==Установка Модуля Выгрузки в sh5==
[[File:storexlogo.png|right|100px]]
[[File:sh5logo.png|right|100px]]
'''ВАЖНО:''' Пропустить, если клиенту не требуется выгрузка входящих ТТН из БАРЛАЙВ в sh5.
'''ПРИМЕЧАНИЕ''': Здесь описана установка новой выгрузке; описание старой - в архивной "вики".
1 - Выяснить, где доступен sh5webapi настроенный на нужный сервер sh5
2 - Выяснить, на этом ПК есть связь только с sh5 одного объекта или нескольких (как бывает у сетевых); если нескольких - то уточнить, база одна или разные.
Понять это можно посмотрев данные для подключения к сторхаусу - если у двух разных объектов ip и порт сервера сх5 одинаковые - значит они используют одну базу данных (а выгрузка просто внутри идёт на разные "подразделения" ("склады")); если разные - значит связь через 1 ПК но базы разные.
Для чего это нужно - чтобы понять, какие и сколько "агентов" и "складских систем" надо устанавливать/настраивать. Ниже несколько примеров для понимания.
'''ПРИМЕР №1:'''
- Сетевой объект, 2 "типовых" ресторана, с единой базой данных, проверяем, видим что у обоих адрес-порт сервера сх5 - http://10.5.5.43:3457, понимаем, что значит используется одна и та же база данных.
Значит у обоих объектов в BARLANE будет использоваться 1 агент и 1 складская система. Т.е. при настройке второго объекта мы используем кнопку "Добавить существующую".
'''ПРИМЕР №2:'''
- Группа компаний, сетевая инфраструктура объединённая, но форматы разные - проверяем, видим, что адрес-порт серверов сх5 отличаются - http://127.0.0.1:4545 и http://127.0.0.1:4546; значит сервера доступны с одного ПК, но базы данных разные.
Значит у обоих объектов в BARLANE будет использоваться 1 агент и 2 складских системы. Т.е. при настройке второго объекта мы нажмём для "агента" - "добавить существующего"; а "складскую систему" укажем новую.
'''ПРИМЕР №3:'''
Соотв-но если предприятие одиночное, то просто ставится 1 агент для него и 1 складская система.
3 - Подключиться к ПК с sh5webapi (или к ПК откуда он доступен по переданным ip-порту)
Если есть, то остановить старую службу выгрузки (ЕГАИС), удалить, но оставить папку с конфигами.
Закинуть на ПК дистрибутив "агента выгрузки":
https://disk.360.yandex.ru/d/EBlmLYGm5V82oQ
Установить (при установке предложит установить/обновить .NET, согласиться), открыть папку с установившимся агентом.
4 - Настроить "агент" и "складскую систему" на сайте
По-умолчанию, все Торговые объекты работают со старой версией выгрузки. Для работы новой выгрузки нужно включить ее в настройках Торгового объекта:
[[File:image-3.png|600px]]
После сохранения в меню слева внизу появится новый раздел Настройки выгрузки:
[[File:image-4.png|600px]]
Если Торговый объект работает с Сервисом выгрузки впервые, то в таблицах будет пусто:
[[File:image-5.png|600px]]
'''ПРИМЕЧАНИЕ''': Соотв-но по описанным примерам выше, если это сетевой объект и может использовать "агент" и "складскую систему" другого объекта - то использовать кнопку "Добавить существующего"; если нет - то "Создать новый".
5 - Создаём "Агента" - название пишем по объекту юрлицу (напр-р "агент ООО БАРЛАЙН - Кафе БАРЛАЙВ"); если агент общий для сети, то отметить это в названии ("агент ООО БАРЛАЙН - ОБЩИЙ")
6 - Создаём "Складскую систему"** - по названию логика та же, просто без слова "агент".
Тип - StoreHouse 5
URL - указываем адрес и порт sh5webapi, с обязательным указанием http:// или https:// в начале!!!
ПРИМЕЧАНИЕ в случае если переносите данные из конфига старой выгрузки, там будет указано напр-р так:
''Address = "127.0.0.1"
Port = 9797''
То в строке настройке URL "складской системы" надо указать http://127.0.0.1:9797
Логин/Пароль - от сх5, тоже можно взять из конфига старой выгрузки если идёт перенастройка
Агент - выбираем тот что был создан/добавлен выше.
7 - Настраиваем и запускаем агента
Открываем C:\Barlane\Barlane.AgentApp , файл agentsettings.json
Заполняем параметры AgentID и Secret:
[[File:image-6.png|600px]]
Берём им с сайта с настроек агента отображаемых:
[[File:image-7.png|600px]]
Проверяем что всё ок, запустив **Barlane.AgentApp.exe**
Если в командной строке вот это:
[[File:image-8.png|600px]]
Значит связь успешная, всё ок, можно закрывать это окно и запускать службу blagentappsvc (Barlane Agent App Service). Настройка на ПК - завершена.
8 - Загрузить справочники
После настройки выгрузки необходимо загрузить справочники из Складской системы в Сервис выгрузки. Для этого переходим в раздел Накладные, выбираем в списке нашу Складскую систему и нажимаем Запустить. Начнется загрузка справочников, которая может занять длительное время (от 5 минут до нескольких часов). Актуальный статус можно видеть после обновления страницы по F5.
[[File:image-10.png|600px]]
[[File:image-11.png|600px]]
[[File:image-12.png|600px]]
После загрузки справочников можно переходить к сопоставлению и выгрузке накладных.
----
==Установка Модуля Выгрузки в iiko==
[[File:storexlogo.png|right|100px]]
[[File:Iiko-logo.png|right|100px]]
'''ВАЖНО''': Пропустить, если клиенту не требуется выгрузка входящих ТТН из БАРЛАЙВ в IIKO.
Инструкция по новой выгрузке аналогична sh5, см. выше; соотв-но вместо адреса sh5webapi указывается адрес сервера IIKO.
Уточнить, в какой сервер необходима выгрузка - RMS или Chain.
'''ВАЖНО''': Для работы выгрузки нужна лицензия серверного API - iikoAPIServer.
Пользовательские настройки:
https://wiki.barlive.ru/wiki/%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_%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92#.D0.92.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B0_.D0.B2_iiko
==Установка Модуля Выгрузки в 1С==
[[File:storexlogo.png|right|100px]]
[[File:logo1cm.png|right|100px]]
'''ВАЖНО''': Пропустить, если клиенту не требуется выгрузка входящих ТТН из БАРЛАЙВ в 1С.
Поддерживаются конфигурации:
'''1С: Управление рестораном, редакция 3'''
'''1С: Общепит КОРП'''
Подготовить дистрибутивы:
blstorexcsvc-installer-x.x.x.xxx - https://disk.yandex.ru/d/P7cObl517rF5Ag
(старая версия - https://disk.yandex.ru/d/rCbwZDmYK3-hZQ)
файл компонента выгрузки для "управления рестораном" - https://disk.yandex.ru/d/-IciqdF8tZDzDg
файл компонента выгрузки для "Общепит КОРП" (для платформы 1С не ниже 8.3.16) - https://disk.yandex.ru/d/wmV9GzR4nQh7aQ
для версии платформы 1С ниже 8.3.16 - https://disk.yandex.ru/d/EBL7Ors1s7dP_A (данная конкретно - для 1С:Предприятие 8.3 (8.3.11.2867) / 1С:Предприятие 8. Общепит (2.0.28.3))
Загрузить их на ПК, где работают с 1С.
У пользователя, под которым загружаются документы, должны быть права не только на пользование сервисом, но так же на создание документов и чтение справочников.
[[File:prava.jpg|600px]]
----
1 - Установка веб-сервера.
Пропустить, если на ПК уже стоит веб-сервер и перейти к следующему пункту.
Установить Apache HTTP Servver версии 2.4:
https://drive.google.com/file/d/1Xddd35TOJJwM_qS6zsXrtP_yyAo06Jt8/view?usp=sharing
Апач устанавливается запуском .msi файла, далее все установится автоматически. httpd-2.4.43-win64-VS16 - это более новая версия для 64-битных ОС, ее можно распаковать поверх установленной, подменив файлы.
'''ВАЖНО''': Апач ставить по разрядности "конфигуратора", а не разрядности системы. Т.е. если Конфигуратор 1С 32-битный, то ставить надо Apache x86 (32-битная архитектура).
Там где будет просить адрес и название веб-сервера - писать localhost; адрес админа можно любой (например localhost@localhost.ru)
----
2 - Установка компонента BARLane в 1С.
1. Запустить 1С от имени администратора:
[[File:1s1.png|600px]]
2. Запустить конфигурацию 1С в режиме "Конфигуратор":
[[File:1s2.png|600px]]
3. Открыть конфигурацию:
[[File:1s3.png|600px]]
4. Включить возможность изменения конфигурации.
Зайти в пункт меню «Конфигурация» - Поддержка – Настройка поддержки – нажать кнопку «Включить возможность изменения»:
[[File:1s4.png|600px]]
На последующий вопрос нажать «Да». Далее в появившемся окне включить редактирования с сохранением поддержки:
[[File:1s5.png|600px]]
Нажать «Ок». После завершения операции нажать «Закрыть».
5. Сделать сравнение конфигурации 1С с компонентом BARLane.
[[File:1s6.png|600px]]
Зайти в пункт меню «Конфигурация» - Сравнить, объединить с конфигурацией из файла… - выбрать файл «BarlaneStoreExchange.cf» - в появившемся окне снять все галочки:
Нажать «Действия» - Отметить по подсистемам файла – отметить только подсистему «Barlane» - нажать «Установить» - нажать «Выполнить»:
[[File:1s7.png|600px]]
В появившемся окне нажать «Продолжить»:
[[File:1s8.png|600px]]
На предложение сохранения настроек объединения конфигурация можно нажать «Отмена».
6. Сохранить изменения конфигурации.
Зайти в пункт меню «Конфигурация» - Обновить конфигурацию базы данных – в появившемся окне нажать «Принять».
7. Установить права на вызов сервиса.
Пользователю, от имени которого будет осуществляться вызов http-сервиса, дать права на использование сервиса.
Зайти в пункт меню «Администрирование» - Пользователи – открыть нужного пользователя – закладка «Прочие» - отметить галочкой роль «Barlane» - нажать ОК.
8.Настройка времени жизни сеанса.
Конфигурация – ветка «Общие» - HTTP-сервисы – Barlane – правая кнопка мыши – Свойства – параметр «Время жизни»:
[[File:1s9.png|600px]]
'''Внимание''': если сервис уже опубликован и было изменено значение параметра – веб-сервер необходимо перезапустить вручную.
Дополнительно желательно установить время засыпания пассивного сеанса и время завершения спящего сеанса в пункте меню «Администрирование» - Параметры информационной базы:
[[File:1s10.png|600px]]
'''Порядок публикации на веб-сервере'''
Ниже описан порядок публикации на веб-сервере Apache 2.4.
1. 1С должен быть запущен от администратора в режиме конфигуратора.
2. Опубликовать http-сервис.
[[File:1s11.png|600px]]
Зайти в пункт меню «Администрирование» - Публикация на веб-сервере… - указать Веб-сервер «Apache 2.4», задать уникальное Имя публикации, указать Каталог размещения файлов публикации:
Снять ВСЕ галочки, кроме тех что установлены в закладке «HTTP сервисы»:
[[File:1s12.png|600px]]
[[File:1s13.png|600px]]
Нажать кнопку «Опубликовать». На предложение перезапуска веб-сервера нажать кнопку «Да».
'''Порядок настройки компонента BARLane'''
1. Запустить конфигурацию 1С в режиме «Предприятие».
2. Открыть пункт меню «Barlane» - Настройки Barlane – для поля «Каталог алкогольной продукции» нажать кнопку «…» - выбрать группу справочника «Номенклатура», в которой будет размещаться номенклатура для обмена с сервисом Barlane.
'''Внимание'''. У номенклатуры обязательно должен быть заполнен реквизит «Вид алкогольной продукции»:
[[File:1s14.png|600px]]
----
3 - Установка Модуля Выгрузки
Запустить файл blstorexcsvc-installer-x.x.x.xxx.exe, программа установится в папку C:\Barlane\StoreExchange
Есть два файла настройки (в папке C:\Barlane\StoreExchange\config):
network-config.cfg - связь с сервером БЛ;
store-config.cfg - связь с веб-сервером 1С.
'''ВАЖНО''': Всё касаемо .NET framework - аналогично "Модулю Синхронизации".
----
4 - Настройка связи с сервером БЛ.
Открыть файл network-config.cfg с помощью "блокнота".
Верхнюю часть не трогать (менять что-то только при использовании тестового сервера).
Заполнить значения [Entity] ("торговый объект") и [TransportModule] ("модуль синхронизации") аналогично настройкам Модуля Синхронизации.
Пример заполненного тестового конфига:
[[File:iikoconf1.png|600px]]
----
5 - Настройка связи с веб-сервером 1С.
Открыть файл store-config.cfg с помощью "блокнота"
Пример конфига:
<nowiki>
Version = 1
StoreSystemType = "Rarus1C"
[Connection]
Address = "127.0.0.1/UR_MAIN/hs/Store_Exchange"
Port = 80
UserName = "Admin"
Password = "191922"
[Import]
[Import.WayBillSettings]
SpecialAccounting = false
[Import.InventorySettings]
RestsSource = "Real"
SpecialAccounting = false
</nowiki>
1. Задать тип учетной системы:
StoreSystemType = "Rarus1C"
2. Задать адрес и порт (пример):
Address = "127.0.0.1/UR_MAIN/hs/Store_Exchange"
Port = 80
Адрес формируется следующим образом:
"127.0.0.1" - IP-адрес веб-сервера 1С (обычно 127.0.0.1 (localhost), т.к. модуль выгрузки ставится вместе с веб-сервером 1С).
"UR_MAIN" - имя публикации, которое задается при установке компонента (можно задать произвольное имя, см. выше)
"hs/Store_Exchange" - неизменная часть адреса
Порт всегда 80.
Логин и пароль необходимо узнать у клиента.
Прочие параметры (import) оставляем по-умолчанию.
'''ПРИМЕЧАНИЕ 1''': Для версий выгрузки ниже 2.4.0.0 Adress указывается без "Store_Exchange", в примере выше будет Address = "127.0.0.1/UR_MAIN/hs
'''ПРИМЕЧАНИЕ 2''': Для версии конфигурации "Общепит КОРП" ниже 8.3.16 - писать "StoreExchange" вместо "Store_Exchange".
----
6 - Запустить службу Модуля Выгрузки.
Открыть "Службы", запустить "Barlane StoreExchange Module service".
'''ВАЖНО''': Всё касаемо .NET framework - аналогично "Модулю Синхронизации".
----
Настройки со стороны 1С описаны в пользовательской инструкции:
https://wiki.barlive.ru/wiki/%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_%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92#.D0.92.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B0_.D0.B2_1.D0.A1
'''ВАЖНО''': Сделать эти первичные настройки вместе с пользователем.
----
==Установка Модуля Бармена==
[[File:barapp.png|right|100px]]
Подготовить дистрибутив (архив с файлом **bar-app-installer-2.х.х.х**)
https://disk.360.yandex.ru/d/JkxUiZYnfPjq4Q
Подключиться к ПК, с которого будут сканировать бутылки.
Запустить файл **bar-app-installer-2.х.х.х.exe**, программа установится в папке **C:\BarLane\BarApp**
===Настройка Модуля Бармена===
Настройки находятся в папке config (как правило C:\Barlane\BarApp\config)
app-config - настройки приложения
cloud-config - настройки связи с сервером
Открыть файл cloud-config с помощью «блокнота».
Заполнить настройки:
BarlineAddr - адрес сервера БАРЛАЙВ, по умолчанию https://egais.barlive.ru/svc/scanner/ , меняется только для тестового контура и для WinXP;
CashboxInitCode – id кассы, взять с сайта:
«Кассы» - нажать на символ QR-кода – скопировать целиком первую строку:
[[File:blinst8.png|600px]]
'''ВАЖНО''': скопировать строку целиком (включая CashboxInit:)
Сохранить файл и закрыть.
Файл app-config оставить без изменений. Настройки там менять в особых случаях:
'''ПРИМЕЧАНИЕ 1''': Если у клиента возникнет проблема с исчезающей кнопкой (из-за кассы rk7) - выставляем параметр WindowMode = "Agressive".
'''ПРИМЕЧАНИЕ 2:''' В случае, если кнопка есть, но в программу штрих-код не попадает (бывает актуально в rk6), сначала убедиться, что сканер настроен корректно (сканирует в блокнот с переносом строки), если да, то необходимо выставить параметр KeyboardMode = "LowLevel".
'''Расположение кнопки'''
Уточнить у клиента, где ему удобнее будет расположить кнопку ЕГАИС. Для тач-скринов (официантские станции/кассы) как правило выбирают верхний правый угол; для десктопных ПК (обычный компьютер бухгалтера/кладовщика) - по центру.
Переместить кнопку просто (сначала запустить barapp) - щёлкнуть правой кнопкой по значку в трее, выбрать "переместить кнопку".
[[File:barappmove1.png|600px]]
На значке появится иконка перемещения:
[[File:barappmove2.png]]
Перетащить значок в нужную позицию, щёлкнуть правой кнопкой в трее и выбрать "завершить перемещение", новые координаты сохранятся.
[[File:barappmove3.png|600px]]
'''ПРИМЕЧАНИЕ''': Подобный метод перетаскивание не позволяет прятать кнопку за "край" экрана. А иногда пользователи десктопных ПК просят её спрятать. В таком случае используйте ручное указание координат в конфиге app-config :
<nowiki>
#Расположение кнопки "ЕГАИС"
[ButtonLocation]
X = 700
Y = -50
</nowiki>
Пример подобной "спрятанной" кнопки с координатами 700 и -50 :
[[File:barappmove4.png|600px]]
----
===Доступные настройки Модуля Бармена===
Пример полного конфига:
<nowiki>
#Включение полноэкранного режима
FullScreen = true
#Интервал в минутах между сеансами связи с сервером для отправки марок
IntervalMinutes = 5
#Интервал в минутах между обновлениями каталогов
CatalogsIntervalMinutes = 60
#Включение возможности логина через Rkeeper
RkeeperLogin = false
#Режим окна: Standart - стандартный (не используется); TopMost - поверх всех окон; Agressive - поверх всех окон с циклическим обновлением
WindowMode = "TopMost"
#Режим захвата потока символов со сканера: Standart - стандартный; LowLevel - низкоуровневый (захватывать все)
KeyboardMode = "Standart"
#Таймаут потока символов со сканера, мс
KeyboardTimeoutMs = 333
#Номер монитора, на котором стартует приложение: 0 - по умолчанию (старт на активном мониторе); 1 и далее - номер монитора в соответствии с присвоенным в диспетчере мониторов
StartupScreen = 0
#Принудительно конвертировать в верхний регистр символы со сканера
ForceInputUppercase = false
#Префикс сканера, пустая строка, если не используется
ScanCodePrefix = ""
#Суффикс сканера, пустая строка, если не используется
ScanCodeSuffix = ""
#Принудительная конвертация символов в верхний регистр не действует для префикса/суффикса
PrefixSuffixIgnoreForceUppercase = false
#Звуковые уведомления
SoundNotificationsEnabled = true
#Обозначать успешное сканирование
SoundNotificationsOnSuccess = false
#Выделять отдельным звуком марки с неизвестным продуктом
SoundHighlightUnknownProduct = false
#Включить режим каталога и отображение кнопки на панели
ShowCatalog = true
#Включить перенос строки при отображении имени
EnableNameWrap = true
#Игнорировать прокси-сервер
IgnoreProxy = false
#Включить установку срока годности кег по-умолчанию
SetDefaultKegCodeExpiration = true
#Значение срока годности кег по-умолчанию
DefaultKegCodeExpirationValue = 21
#Расположение кнопки "ЕГАИС"
[ButtonLocation]
X = 919
Y = 0
</nowiki>
'''Примечание к настройкам звука:'''
Успешное сканирование - доп.короткий сигнал.
Неуспешное сканирование - два длинных сигнала.
Сканирование марки, отсутствующей в справочниках ("неизвестная продукция" либо "Тип - ...") - два коротких сигнала.
Уведомления можно выключить целиком; а также включить в любой комбинации.
По умолчанию в новых версиях выставлено уведомление на неуспешное сканирование.
'''Настройка автоматической отправки списка по указанному времени:'''
AutoSendListTime = "21:30"
'''Настройка работы со сканером через COM'''
Необходимо добавить в конфиг параметр
ComPortParameters = "COM1/9600/8/N/1"
В данном примере настраивается порт COM1, скорость 9600 бод, 8 бит данных, контроль четности выкл, 1 стоп-бит.
----
===Запуск Модуля Бармена===
'''ПРИМЕЧАНИЕ''': Первый запуск может быть долгим (зависит от мощности ПК и скорости интернет-соединения).
Запуск модуля – открыть файл '''bar-app.exe'''. Появится кнопка - нажать на неё для разворачивания приложения. (Если кнопки после запуска не появилась - возможно вы указали неверные координаты, кнопка "уехала" за границу экрана; закройте программу через "Диспетчер устройств" (процесс "bar-app"), исправьте конфиг, запустите заново).
Если что-то было сделано неправильно, приложение либо не запустится, либо на начальном экране напишет «Инициализация с ошибкой» - это означает что настройки были заполнены неверно (либо проблемы с сервером). Приложение можно закрыть из Диспетчера Задач (процесс "bar-app"), либо в трее (иконка в виде рюмки в нижнем правом углу):
[[File:barapptrayn.png]]
В будущем Модуль будет запускаться автоматически при загрузке ОС (отключить это можно в стандартных настройках ОС).
Ввести пин-код.
'''ПРИМЕЧАНИЕ''': Для того, чтобы Модуль Бармена увидел новые учётные записи (заведённые в Модуле Бухгалтера), необходимо перезапустить приложение.
==Установка Мобильного Бармена==
[[File:androidlogo.png|right|100px]]
[[File:applelogoblack.svg.png|right|100px]]
Adnroid и iOS-приложение, доступно для смартфонов, а также поддерживается работа со следующими ТСД:
- АТОЛ Smart.Prime
- АТОЛ Smart.Lite
- АТОЛ Smart.Slim
- АТОЛ Smart.Droid
Ниже инструкции по установке на ТСД и на смартфонах.
iOS приложение доступно в AppStore:
https://apps.apple.com/ru/app/barlane-%D0%B5%D0%B3%D0%B0%D0%B8%D1%81/id6453991802
ANDROID приложение доступно в Google Play:
https://play.google.com/store/apps/details?id=ru.barlane.barapp
APK-файл для Android-смартфонов:
https://disk.360.yandex.ru/d/zJmU0rpaTsc8Og
===Установка Мобильного Бармена на ТСД===
Файлы для ТСД (без дистрибутива - ссылка на него выше): https://disk.yandex.ru/d/fx8PhWwnEdlDzQ
'''ВАЖНО''': Убедитесь, что ваш ТСД подключен к интернету (включён в wi-fi сеть).
Распаковать архив и загрузить файлы (adcontrol-ad1.apk, anydesk.apk, ru.barlane.barapp-Signed-***.apk, bl-screensaver.png) на устройство в папку Downloads.
Для ТСД Smart.Lite и Smart.Slim (т.е. смартфонов данный пункт не касается) дополнительно настроить '''barcode utility''' по инструкции:
[https://wiki.barlive.ru/images/d/da/Atol_Smart.Lite_-_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D1%81%D0%BA%D0%B0%D0%BD%D0%B5%D1%80%D0%B0_%D0%B4%D0%BB%D1%8F_%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B_%D1%81_Barlane.pdf Скачать инструкцию]
Для ТСД Smart.Droid сделать следующую настройку в приложении ScanWedge:
[[File:nastrojjkatsd.jpg|300px]]
1 - Установить Anydesk и плагин (последовательно файлы anydesk.apk, затем adcontrol-ad1.apk; в процессе разрешить установку из неизвестных источников).
2 - Запустить Anydesk, включить плагин (если при первом входе не включили - можно затем включить в общих настройках устройства в "спецвозможностях"); зайти в "файлы" и дать разрешение. Закрыть энидеск.
3 - Открыть файл bl-screensaver.png, установить его в качестве обоев и экрана блокировки
4 - Установить Мобильный Бармен (файл ru.barlane.barapp-Signed-***.apk).
5 - Запустить установленное приложение, при первом запуске выдать запрошенные разрешения:
[[File:1.1pervyjjzapusk-zaprosrazreshenijj.jpg|400px]]
После выданных разрешений откроется окно активации:
[[File:1.2pervyjjzapusk-skanirovaniekodakassy.jpg|400px]]
Заведите новую кассу в соответствующем разделе Модуля Бухгалтера (в название добавьте Mobile, Мобильный или ТСД), нажмите на значок QR-кода в общем списке:
[[File:aktivacijamobilnogobarmena1.png|400px]]
Откроется окно с qr-кодом:
[[File:aktivacijamobilnogobarmena2.png|400px]]
Его и надо отсканировать устройством (ТСД/смартфоном). ТСД сканирует нажатием аппаратной кнопки SCAN; смартфон - наэкранной кнопкой.
**ВАЖНО** - активируйте отдельно созданную для мобильного устройства кассу; внимательно, т.к. если активируете уже существующую виндовую, будут ошибки.
В случае если был отсканирован правильный штрих-код, запустится активация:
[[File:1.3pervyjjzapusk-zagruzkadannyx.jpg|400px]]
В процессе могут ещё раз быть запрошены необходимые разрешения:
[[File:1.pervyjjzapusk.jpg|400px]]
После успешной активации появится окно авторизации:
[[File:2.loginpopinkodu.jpg|400px]]
Проверить, что название кассы и объекта верные; проверить авторизацию по пин-коду.
6 - Перетащить ярлык "Мобильного Бармена" на рабочий стол; убрать с рабочего стола все остальные ярлыки (в самом низу).
Можно начинать работу с Мобильным Барменом.
Пользовательская инструкция:
https://wiki.barlive.ru/wiki/%D0%9C%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C%D0%BD%D1%8B%D0%B9_%D0%91%D0%B0%D1%80%D0%BC%D0%B5%D0%BD_%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92
----
=== Установка Мобильного Бармена на смартфон===
iOS приложение доступно в AppStore:
https://apps.apple.com/ru/app/barlane-%D0%B5%D0%B3%D0%B0%D0%B8%D1%81/id6453991802
ANDROID приложение доступно в Google Play:
https://play.google.com/store/apps/details?id=ru.barlane.barapp
APK-файл для Android-смартфонов:
https://disk.yandex.ru/d/c_KJeUb34FHUCA
Установить из маркета; или если через apk:
Скачать дистрибутив на устройство, установить (разрешить установку из "неизвестных источников" если запросит).
'''ВАЖНО''': Убедитесь, что смартфон подключён к интернету (желательно в в wi-fi сети).
Запустить установленное приложение, при первом запуске выдать запрошенные разрешения:
[[File:1.1pervyjjzapusk-zaprosrazreshenijj.jpg|400px]]
После выданных разрешений откроется окно активации:
[[File:1.2pervyjjzapusk-skanirovaniekodakassy.jpg|400px]]
Заведите новую кассу в соответствующем разделе Модуля Бухгалтера (в название добавьте Mobile, Мобильный или ТСД), нажмите на значок QR-кода в общем списке:
[[File:aktivacijamobilnogobarmena1.png|400px]]
Откроется окно с qr-кодом:
[[File:aktivacijamobilnogobarmena2.png|400px]]
Его и надо отсканировать устройством (ТСД/смартфоном). ТСД сканирует нажатием аппаратной кнопки SCAN; смартфон - наэкранной кнопкой.
'''ВАЖНО''' - активируйте отдельно созданную для мобильного устройства кассу; внимательно, т.к. если активируете уже существующую виндовую, будут ошибки.
В случае если был отсканирован правильный штрих-код, запустится активация:
[[File:1.3pervyjjzapusk-zagruzkadannyx.jpg|400px]]
В процессе могут ещё раз быть запрошены необходимые разрешения:
[[File:1.pervyjjzapusk.jpg|400px]]
После успешной активации появится окно авторизации:
[[File:2.loginpopinkodu.jpg|400px]]
Можно начинать работу с Мобильным Барменом.
Пользовательская инструкция:
https://wiki.barlive.ru/wiki/%D0%9C%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C%D0%BD%D1%8B%D0%B9_%D0%91%D0%B0%D1%80%D0%BC%D0%B5%D0%BD_%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92
==Завершение установки==
'''ВАЖНО''': Запросить остатки, чтобы в систему загрузились в первый раз до начала приёмок ТТН.
Если объектов или касс несколько – повторить соответствующие пункты.
Проверить авторизацию модуля Бармена / мобильного Бармена.
Передать на обучение.
'''ВАЖНО''': Узнать, есть ли алкогольная лицензия. Если есть, уточнить не является ли она ограниченной по маркируемой продукции крепостью меньше 16.5%. Если да - выставить соответствующую настройку в "Торговых объектах".
==Подготовка к подключению==
Перед подключением в наличии должны быть следующие сведения:
- Контакты
- Данные админской учётной записи клиента (ФИО и почта, к которой всё будет привязано)
- Информация о месте установки модуля бармена - касса или отдельный ПК; и мобильных барменов
- ИНН, КПП (и юр.лица и обособки; они могут совпадать), ФСРАР-id и адрес точек (а также название объекта – «Кафе Рогалик», «ЕвроМакс» и т.п.)
Должна быть возможность отправлять письма с почты admin@barlive.ru
Должны быть подготовлены актуальные дистрибутвы.
'''ПРИМЕЧАНИЕ''': Проверить через https://egrul.nalog.ru/ корректность ИНН и КПП юр.лица.
==Настройки в ЛК Барлайн (заведение точки и учётных записей)==
[[File:buhlogo.png|right]]
'''Войти в свою учётную запись Интегратора:'''
- Открыть сайт https://egais.barlive.ru/
- Ввести логин и пароль
1. '''Создать Юр.лицо:'''
«Юр.лица» - «Добавить» - Ввести название юр.лица (напр-р ООО «Ромашка») - Ввести ИНН – «Добавить» по примеру ниже:
[[File:blinst1b.png|600px]]
Указывать "Примечание", если есть особая информация по юр.лицу (нет поддержки, поставщик и т.п.).
Примечание можно указывать с html-разметкой, например:
<nowiki>
<font size="5" color="red" face="Arial">БЕЗ ПОДДЕРЖКИ</font>
</nowiki>
где
'''font size''' - размер шрифта
'''color''' - цвет
'''face''' - шрифт
Результат:
[[File:commenturlico.png]]
----
2. '''Создать Торговый Объект:'''
«Торговые объекты» - «Добавить»:
- Название (напр-р «Кафе Рогалик»)
- ИНН предприятия
- КПП юр.лица
- КПП обособленного подразделения
- ФСРАР-id (СИО) (ПРИМЕЧАНИЕ: убедитесь, что таблицы не "съели" первый ноль)
- '''ВАЖНО''': Выбрать созданную ранее корпорацию (т.о. объект привязывается к юр.лицу)
- Пропустить настройки с "галками"
- Адрес
'''ВАЖНО''' - Если у клиент торгует не только пивом, то отметить галку "'''Включить порционное списание'''" - и там указать кассовое ПО; отметить галкой "'''Отправлять чеки в ЕГАИС'''"; а также "Режим "'''Пул вскрытых марок'''": вкл/выкл" (остальные режимы во время обучения можно будет довключить если вдруг потребуется).
Нажать "'''Добавить'''".
'''ПРИМЕЧАНИЕ 1:''' Автосписание, Автозапрос остатков (оба регистра) - не трогать. При их включении необходимо указать время автосписания/автозапроса. В указанное время спишутся все сопоставленные марки/запросятся остатки. При обучении рекомендовать клиенту следующее -
выставлять запрос остатков Р2 за час до автосписания; запрос остатков Р1 - за полтора часа до автосписания.
'''ПРИМЕЧАНИЕ 2:''' Согласовать включение автозапроса марок (для получения всех остатков Р1-Р3).
----
3. Добавить Кассу (модуль бармена):
«Кассы» - «Добавить» - Заполнить поля:
- Название (напр-р «Бар 1 Рогалик»),
- Выбрать созданный ранее **Торговый Объект**,
Нажать «Добавить».
----
4. Добавить Кассу робота (для возможности добавления шк вручную):
«Кассы» - «Добавить» - Заполнить поля:
- Название (напр-р «Робот Рогалик»),
- Выбрать созданный ранее **Торговый Объект**
- Нажать на галку «Виртуальная»,
Нажать «Добавить».
----
5. Добавить Транспортный модуль (для модуля синхронизации с УТМ):
«Транспортные модули» - «Добавить» - Заполнить поля:
- Название (напр-р «УТМ Рогалик»),
- Пароль (сгенерировать)
- Выбрать созданный ранее **Торговый Объект**,
- Отметить галку "включить новую версию (порционка)
Нажать «**Добавить**».
----
6. Добавить Учётную запись Администратора:
«Учётные записи» – «Добавить» - Заполнить поля:
Роль – выбрать роль Администратор (ЕГАИС)
Корпорация – выбрать ранее заведённую корпорацию (ПРИМЕЧАНИЕ: Если учётка для нескольких юр.лиц - указать несколько)
Логин – почту, полученную ранее (напр-р ivan@mail.ru)
Фамилия Имя – ФИО, полученные ранее
e-mail – почта
Телефон – оставить пустым
Пароль - сгенерировать; **ВАЖНО**: Временно сохраните у себя этот пароль, т.к. далее надо будет отправить его клиенту.
Нажать «Добавить».
----
7. Добавить Учётную запись Бармена:
«Учётные записи» – «Добавить» - Заполнить поля:
Роль – выбрать роль Бармен (ЕГАИС)
Корпорация – выбрать ранее заведённую корпорацию
PIN - выставить по умолчанию 1111 (если учёток несколько, то для следующей 2222 и так далее; клиенту сообщить выставленный по умолчанию пин и рассказать, что при желании он может его поменять)
Логин – напр-р «БарменРогалик» (**ВАЖНО**! Используйте в имени название объекта и нумеруйте, если требуется)
Фамилия Имя – напр-р «Бармен Рогалик» (**ВАЖНО**! Используйте в имени название объекта и нумеруйте, если требуется)
----
8. Привязать Учётные записи к Торговому Объекту:
ВАЖНО: Данную процедуру необходимо совершать для ролей "Бухгалтер" и "Бармен"; Для "Администратора" - не требуется.
«Торговые Объекты» - выбрать ранее созданный :
Внизу «Учётные записи», в поиск вставить имя ранее созданной учётной записи (на примере бармена) – нажать «Добавить»:
[[File:blinst2.png|600px]]
то же самое для созданной ранее учётки бухгалтера, если была такая создана; Добавленные учётки должны отображаться в таблице учётных записей.
Нажать «Записать» - учётки привязались.
При обучении клиента рассказать о пунктах 6-8 (заведение учётных записей и привязка к объекту).
ПРИМЕЧАНИЕ: При первом редактировании "Торгового объекта" может выйти ошибка с требованием заполнить "Код страны" и "Код региона"; Код страны всегда указывать **643** (Россия); Код региона как правило первые цифры ИНН, исключением может быть Москва, где начали выдавать ИНН начинающиеся с 99; Код региона Москвы при этом - 77.
----
9. Отправить учётную запись клиенту:
На ранее указанную почту от admin@barlive.ru отправить письмо:
Тема – {Название_корпорации} учётная запись БАРЛАЙВ ЕГАИС
Содержимое письма:
Добрый день,
ИНСТРУКЦИЯ (КАК РАБОТАТЬ В "БАРЛАЙВ ЕГАИС"):
https://wiki.barlive.ru/
Юр.лицо ООО "ХХХХХ"
Ваша учётная запись администратора:
Логин – ххххххх
Пароль – ххххххххх
Рекомендуем самостоятельно сменить пароль (Раздел «Главная» - «Профиль и настройки»)
Зайти в личный кабинет - https://egais.barlive.ru/
Просьба добавить данный адрес (admin@barlive.ru) в список доверенных отправителей, чтобы письма не попадали в спам!
----
10. Связаться с клиентом, получить удалённые доступы к местам установки Модулей Бармена (там, где будут непосредственно сканировать) и Модуля Синхронизации (там, где есть связь с УТМ) – это может быть и один ПК.
Для работы Модулей необходим интернет.
----
==Настройка интеграции с кассовым ПО==
Если клиент работает с "крепким" ("маркируемым") алкоголем, значит для работы с "порционным списанием" необходима интеграция с кассовым ПО.
На данный момент интеграция есть с системами R-keeper и IIKO.
Необходимо взять контакты организации, занимающейся у клиента поддержкой кассового ПО и передать им инструкцию:
https://wiki.barlive.ru/wiki/%D0%9F%D0%BE%D1%80%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D0%BE%D0%B5_%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5_%D0%B2_%D0%95%D0%93%D0%90%D0%98%D0%A1
По которой им требуется произвести настройки у себя.
==Установка Модуля Синхронизации (ТМ)==
[[File:svclogo.png|right|100px]]
'''ВАЖНО''': Если клиент не начинают работу в ЕГАИС с нуля, после установки ТМ обязательно запустить автозапрос марок и проконтролировать его исполнение!!!
Подготовить дистрибутивы (архив с файлом **TransportModuleInstaller-3.x.xxx.x.exe**)
ТМ - https://disk.360.yandex.ru/d/LYEKxPjIplXlsA
.NET 8 - https://disk.yandex.ru/d/jKHpZls3jiYjgQ
VC (Нужно только для Win7; на ОС более новых - не нужно ставить) - https://disk.yandex.ru/d/CHjXsYxgkYVCGg
Подключиться к ПК, с которого есть доступ к УТМ.
Сначала установить .NET; затем если Win7 - установить VC (не требуется если более новые ОС).
Затем запустить файл **TransportModuleInstaller-3.x.xxx.x.exe**, программа установится в папке C:\Barlane\TransportModule
Откроется менеджер ТМ :
[[File:tminstall1.png|600px]]
На сайте открыть раздел "**Транспортные модули**" - найти наш модуль – нажать на иконку QR-кода справа:
[[File:blinst5a.png|600px]]
И скопировать оттуда настройки "транспортного модуля" (сразу все строки) :
[[File:tminstall2.png|600px]]
Вернуться к менеджеру ТМ, нажать на плюс ("Добавить модуль") и вставить настройки:
[[File:tminstall3.png|600px]]
Заполнятся сразу все три строки:
[[File:tminstall4.png|600px]]
В верхней строке написать название объекта.
Нижнюю строку "Адрес УТМ" тоже заполнить самостоятельно.
Адрес УТМ указывается по умолчанию http://localhost:8080, т.к. в большинстве случаев Модуль Синхронизации устанавливается на тот же ПК, где стоит УТМ (как правило с портом 8080); Но бывают исключения, поэтому если УТМ на другом ПК - укажите корректно его ip.
Нажать ОК - модуль добавится и сразу будет запущен:
[[File:tminstall5.png|600px]]
Открыть Менеджер можно из трея (в нижнем правом углу):
[[File:tminstall6.png|600px]]
Соответственно, в случае необходимости на одном ПК можно добавлять несколько модулей.
'''ВАЖНО''': После установки ТМ обязательно запросить остатки (даже если они будут нулевые), иначе могут не записаться в остатки первые ТТН.
----
==Установка Модуля Выгрузки в sh4==
[[File:storexlogo.png|right|100px]]
[[File:sh4logo.png|right|100px]]
'''ВАЖНО''': Пропустить, если клиенту не требуется выгрузка входящих ТТН из БАРЛАЙВ в sh4.
Подготовить дистрибутивы:
blstorexcsvc-installer-x.x.x.xxx - https://disk.yandex.ru/d/P7cObl517rF5Ag
(старая версия - https://disk.yandex.ru/d/rCbwZDmYK3-hZQ)
sh4ole.dll - https://drive.google.com/file/d/1PWcsm9Dbxv4QQXtLAz6upR0Leo_Qqc1h/view?usp=sharing
Midas.dll - https://drive.google.com/file/d/1lAIZlblVKQWRr7Xt4Eg_lHjhQaZksw1K/view?usp=sharing
Клиент sh4 - https://disk.360.yandex.ru/d/vjl9GT6HyzbMmA
Подключиться к ПК, с которого есть доступ до сервера sh4 и доступ в интернет.
----
1. Зарегистрировать библиотеку midas.dll
- Закинуть файл **midas.dll** в папку **C:\Windows\SysWOW64** (для х64 ОС)
- Открыть командную строку (**cmd**) от имени администратора
- Ввести последовательно команды:
''cd C:\Windows\SysWOW64
regsvr32 midas.dll''
- В результате должно появиться окно "Регистрация успешно выполнена..."
'''ПРИМЕЧАНИЕ''': Для х86 (32-битной) ОС использовать путь C:\Windows\System32
----
2. Зарегистрировать библиотеку sh4Ole.dll
- Открыть содержимое папки sh4Ole
- Закинуть всё в каталог с программой StoreHouse4 (обычно C:\UCS\SH4 )
- Запустить под правами администратора программу regole.exe, нажать "RegisterServer".
'''ПРИМЕЧАНИЕ''': Если на ПК нет клиента sh4, то сначала установить его (ссылка на дистрибутив в начале инструкции); Только установить, настраивать не надо (т.е. запускаем установку и "далее" - "далее" - ... )
----
3. Установка Модуля Выгрузки.
Запустить файл **blstorexcsvc-installer-x.x.x.xxx**, программа установится в папку **C:\Barlane\StoreExchange**.
Есть два файла настройки (в папке **C:\Barlane\StoreExchange\config**):
network-config.cfg - связь с сервером БЛ;
store-config.cfg - связь с сервером sh4.
'''ВАЖНО''': Всё касаемо .NET framework - аналогично "Модулю Синхронизации".
----
4. Настройка связи с серевером БЛ.
Открыть файл network-config.cfg с помощью "блокнота".
'''Верхнюю часть не трогать''' (менять что-то только при использовании тестового сервера).
Заполнить значения [Entity] ("торговый объект") и [TransportModule] ("модуль синхронизации") аналогично настройкам Модуля Синхронизации.
Пример заполненного тестового конфига:
[[File:iikoconf1.png|600px]]
----
5. Настройка связи с сервером SH.
Открыть файл store-config.cfg с помощью "блокнота".
Пример конфига:
Version = 1
StoreSystemType = "StoreHouse4"
<nowiki>
[Connection]
Address = "127.0.0.1"
Port = 9080
UserName = "admin"
Password = ""
[Import]
[Import.WayBillSettings]
IgnoreMissingImporter = false
AllowMultipleStoresMatch = false
SpecialAccounting = false
UseStoreSystemCodes = true
UseExtCodes = true
[Import.InventorySettings]
RestsSource = "Real"
SpecialAccounting = false
UseStoreSystemCodes = true
UseExtCodes = true
</nowiki>
Выставить параметр сх4 :
StoreSystemType = "StoreHouse4"
Заполнить настройки связи с сервером sh4 (блок [Connection])
- Адрес и порт можно подсмотреть в sh4setup.exe
- Логин и пароль необходимо узнать у клиента ('''ВАЖНО''': логин пользователя sh4 должен быть в латинице)
Прочие параметры оставляем по-умолчанию, и при обучении по пожеланиям клиента их можно будет поменять (напоминаю, при изменении конфига для их применения необходимо перезапускать службу). Описание этих параметров:
<nowiki>[ImportSettings.WayBillSettings]</nowiki> - для ТТН (приходная накладная)
<nowiki>[ImportSettings.InventorySettings]</nowiki> - для инвентаризаций (сличительная ведомость)
SpecialAccounting - возможность работы в спецучёте.
true - выгрузка в спецучет
false - выгрузка в обычный режим
RestsSource - Источник данных об остатках товара при выгрузке инвентаризации:
"Egais" - остатки ЕГАИС
"Real" - остатки ФАКТ
AllowMultipleStoresMatch - возможность выгрузки в несколько складов, найденных по FSRAR-ID получателя. Копия накладной будет выгружена во все найденные склады.
true - функция включена
false - функция выключена
UseStoreSystemCodes - возможность принудительно использовать при сопоставлении продукции только коды sh4
true - функция включена
false - функция выключена
UseExtCodes - возможность принудительно использовать при сопоставлении продукции только алккоды (по умолчанию работает эта опция)
true - функция включена
false - функция выключена
----
6. Запустить службу Модуля Выгрузки.
Открыть "Службы", запустить "Barlane StoreExchange Module service".
'''ВАЖНО''': Всё касаемо .NET framework - аналогично "Модулю Синхронизации".
----
===Минимум прав для пользователя sh4===
Склад – Накладные – все права (чтение+запись)
Словари – все права на чтение
Алкогольные декларации – все права (чтение+запись)
Общедоступные процедуры – все права (чтение+запись)
Процедуры:
GsExtcodes
GoodsTree
Goods
GoodByRID
GoodsMUnits
CorrPropertyByRID
CorrFList
CorrFullList
InsDoc0
InsDoc8
Doc0
Doc8
SetDocHdrAttr
SetDocSpecAttr
DocAttrList
DocHdrAttrList
CalcDocNum
----
==Установка Модуля Выгрузки в sh5==
[[File:storexlogo.png|right|100px]]
[[File:sh5logo.png|right|100px]]
'''ВАЖНО:''' Пропустить, если клиенту не требуется выгрузка входящих ТТН из БАРЛАЙВ в sh5.
'''ПРИМЕЧАНИЕ''': Здесь описана установка новой выгрузке; описание старой - в архивной "вики".
1 - Выяснить, где доступен sh5webapi настроенный на нужный сервер sh5
2 - Выяснить, на этом ПК есть связь только с sh5 одного объекта или нескольких (как бывает у сетевых); если нескольких - то уточнить, база одна или разные.
Понять это можно посмотрев данные для подключения к сторхаусу - если у двух разных объектов ip и порт сервера сх5 одинаковые - значит они используют одну базу данных (а выгрузка просто внутри идёт на разные "подразделения" ("склады")); если разные - значит связь через 1 ПК но базы разные.
Для чего это нужно - чтобы понять, какие и сколько "агентов" и "складских систем" надо устанавливать/настраивать. Ниже несколько примеров для понимания.
'''ПРИМЕР №1:'''
- Сетевой объект, 2 "типовых" ресторана, с единой базой данных, проверяем, видим что у обоих адрес-порт сервера сх5 - http://10.5.5.43:3457, понимаем, что значит используется одна и та же база данных.
Значит у обоих объектов в BARLANE будет использоваться 1 агент и 1 складская система. Т.е. при настройке второго объекта мы используем кнопку "Добавить существующую".
'''ПРИМЕР №2:'''
- Группа компаний, сетевая инфраструктура объединённая, но форматы разные - проверяем, видим, что адрес-порт серверов сх5 отличаются - http://127.0.0.1:4545 и http://127.0.0.1:4546; значит сервера доступны с одного ПК, но базы данных разные.
Значит у обоих объектов в BARLANE будет использоваться 1 агент и 2 складских системы. Т.е. при настройке второго объекта мы нажмём для "агента" - "добавить существующего"; а "складскую систему" укажем новую.
'''ПРИМЕР №3:'''
Соотв-но если предприятие одиночное, то просто ставится 1 агент для него и 1 складская система.
3 - Подключиться к ПК с sh5webapi (или к ПК откуда он доступен по переданным ip-порту)
Если есть, то остановить старую службу выгрузки (ЕГАИС), удалить, но оставить папку с конфигами.
Закинуть на ПК дистрибутив "агента выгрузки":
https://disk.360.yandex.ru/d/EBlmLYGm5V82oQ
Установить (при установке предложит установить/обновить .NET, согласиться), открыть папку с установившимся агентом.
4 - Настроить "агент" и "складскую систему" на сайте
По-умолчанию, все Торговые объекты работают со старой версией выгрузки. Для работы новой выгрузки нужно включить ее в настройках Торгового объекта:
[[File:image-3.png|600px]]
После сохранения в меню слева внизу появится новый раздел Настройки выгрузки:
[[File:image-4.png|600px]]
Если Торговый объект работает с Сервисом выгрузки впервые, то в таблицах будет пусто:
[[File:image-5.png|600px]]
'''ПРИМЕЧАНИЕ''': Соотв-но по описанным примерам выше, если это сетевой объект и может использовать "агент" и "складскую систему" другого объекта - то использовать кнопку "Добавить существующего"; если нет - то "Создать новый".
5 - Создаём "Агента" - название пишем по объекту юрлицу (напр-р "агент ООО БАРЛАЙН - Кафе БАРЛАЙВ"); если агент общий для сети, то отметить это в названии ("агент ООО БАРЛАЙН - ОБЩИЙ")
6 - Создаём "Складскую систему"** - по названию логика та же, просто без слова "агент".
Тип - StoreHouse 5
URL - указываем адрес и порт sh5webapi, с обязательным указанием http:// или https:// в начале!!!
ПРИМЕЧАНИЕ в случае если переносите данные из конфига старой выгрузки, там будет указано напр-р так:
''Address = "127.0.0.1"
Port = 9797''
То в строке настройке URL "складской системы" надо указать http://127.0.0.1:9797
Логин/Пароль - от сх5, тоже можно взять из конфига старой выгрузки если идёт перенастройка
Агент - выбираем тот что был создан/добавлен выше.
7 - Настраиваем и запускаем агента
Открываем C:\Barlane\Barlane.AgentApp , файл agentsettings.json
Заполняем параметры AgentID и Secret:
[[File:image-6.png|600px]]
Берём им с сайта с настроек агента отображаемых:
[[File:image-7.png|600px]]
Проверяем что всё ок, запустив **Barlane.AgentApp.exe**
Если в командной строке вот это:
[[File:image-8.png|600px]]
Значит связь успешная, всё ок, можно закрывать это окно и запускать службу blagentappsvc (Barlane Agent App Service). Настройка на ПК - завершена.
8 - Загрузить справочники
После настройки выгрузки необходимо загрузить справочники из Складской системы в Сервис выгрузки. Для этого переходим в раздел Накладные, выбираем в списке нашу Складскую систему и нажимаем Запустить. Начнется загрузка справочников, которая может занять длительное время (от 5 минут до нескольких часов). Актуальный статус можно видеть после обновления страницы по F5.
[[File:image-10.png|600px]]
[[File:image-11.png|600px]]
[[File:image-12.png|600px]]
После загрузки справочников можно переходить к сопоставлению и выгрузке накладных.
----
==Установка Модуля Выгрузки в iiko==
[[File:storexlogo.png|right|100px]]
[[File:Iiko-logo.png|right|100px]]
'''ВАЖНО''': Пропустить, если клиенту не требуется выгрузка входящих ТТН из БАРЛАЙВ в IIKO.
Инструкция по новой выгрузке аналогична sh5, см. выше; соотв-но вместо адреса sh5webapi указывается адрес сервера IIKO.
Уточнить, в какой сервер необходима выгрузка - RMS или Chain.
'''ВАЖНО''': Для работы выгрузки нужна лицензия серверного API - iikoAPIServer.
Пользовательские настройки:
https://wiki.barlive.ru/wiki/%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_%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92#.D0.92.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B0_.D0.B2_iiko
==Установка Модуля Выгрузки в 1С==
[[File:storexlogo.png|right|100px]]
[[File:logo1cm.png|right|100px]]
'''ВАЖНО''': Пропустить, если клиенту не требуется выгрузка входящих ТТН из БАРЛАЙВ в 1С.
Поддерживаются конфигурации:
'''1С: Управление рестораном, редакция 3'''
'''1С: Общепит КОРП'''
Подготовить дистрибутивы:
blstorexcsvc-installer-x.x.x.xxx - https://disk.yandex.ru/d/P7cObl517rF5Ag
(старая версия - https://disk.yandex.ru/d/rCbwZDmYK3-hZQ)
файл компонента выгрузки для "управления рестораном" - https://disk.yandex.ru/d/-IciqdF8tZDzDg
файл компонента выгрузки для "Общепит КОРП" (для платформы 1С не ниже 8.3.16) - https://disk.yandex.ru/d/wmV9GzR4nQh7aQ
для версии платформы 1С ниже 8.3.16 - https://disk.yandex.ru/d/EBL7Ors1s7dP_A (данная конкретно - для 1С:Предприятие 8.3 (8.3.11.2867) / 1С:Предприятие 8. Общепит (2.0.28.3))
Загрузить их на ПК, где работают с 1С.
У пользователя, под которым загружаются документы, должны быть права не только на пользование сервисом, но так же на создание документов и чтение справочников.
[[File:prava.jpg|600px]]
----
1 - Установка веб-сервера.
Пропустить, если на ПК уже стоит веб-сервер и перейти к следующему пункту.
Установить Apache HTTP Servver версии 2.4:
https://drive.google.com/file/d/1Xddd35TOJJwM_qS6zsXrtP_yyAo06Jt8/view?usp=sharing
Апач устанавливается запуском .msi файла, далее все установится автоматически. httpd-2.4.43-win64-VS16 - это более новая версия для 64-битных ОС, ее можно распаковать поверх установленной, подменив файлы.
'''ВАЖНО''': Апач ставить по разрядности "конфигуратора", а не разрядности системы. Т.е. если Конфигуратор 1С 32-битный, то ставить надо Apache x86 (32-битная архитектура).
Там где будет просить адрес и название веб-сервера - писать localhost; адрес админа можно любой (например localhost@localhost.ru)
----
2 - Установка компонента BARLane в 1С.
1. Запустить 1С от имени администратора:
[[File:1s1.png|600px]]
2. Запустить конфигурацию 1С в режиме "Конфигуратор":
[[File:1s2.png|600px]]
3. Открыть конфигурацию:
[[File:1s3.png|600px]]
4. Включить возможность изменения конфигурации.
Зайти в пункт меню «Конфигурация» - Поддержка – Настройка поддержки – нажать кнопку «Включить возможность изменения»:
[[File:1s4.png|600px]]
На последующий вопрос нажать «Да». Далее в появившемся окне включить редактирования с сохранением поддержки:
[[File:1s5.png|600px]]
Нажать «Ок». После завершения операции нажать «Закрыть».
5. Сделать сравнение конфигурации 1С с компонентом BARLane.
[[File:1s6.png|600px]]
Зайти в пункт меню «Конфигурация» - Сравнить, объединить с конфигурацией из файла… - выбрать файл «BarlaneStoreExchange.cf» - в появившемся окне снять все галочки:
Нажать «Действия» - Отметить по подсистемам файла – отметить только подсистему «Barlane» - нажать «Установить» - нажать «Выполнить»:
[[File:1s7.png|600px]]
В появившемся окне нажать «Продолжить»:
[[File:1s8.png|600px]]
На предложение сохранения настроек объединения конфигурация можно нажать «Отмена».
6. Сохранить изменения конфигурации.
Зайти в пункт меню «Конфигурация» - Обновить конфигурацию базы данных – в появившемся окне нажать «Принять».
7. Установить права на вызов сервиса.
Пользователю, от имени которого будет осуществляться вызов http-сервиса, дать права на использование сервиса.
Зайти в пункт меню «Администрирование» - Пользователи – открыть нужного пользователя – закладка «Прочие» - отметить галочкой роль «Barlane» - нажать ОК.
8.Настройка времени жизни сеанса.
Конфигурация – ветка «Общие» - HTTP-сервисы – Barlane – правая кнопка мыши – Свойства – параметр «Время жизни»:
[[File:1s9.png|600px]]
'''Внимание''': если сервис уже опубликован и было изменено значение параметра – веб-сервер необходимо перезапустить вручную.
Дополнительно желательно установить время засыпания пассивного сеанса и время завершения спящего сеанса в пункте меню «Администрирование» - Параметры информационной базы:
[[File:1s10.png|600px]]
'''Порядок публикации на веб-сервере'''
Ниже описан порядок публикации на веб-сервере Apache 2.4.
1. 1С должен быть запущен от администратора в режиме конфигуратора.
2. Опубликовать http-сервис.
[[File:1s11.png|600px]]
Зайти в пункт меню «Администрирование» - Публикация на веб-сервере… - указать Веб-сервер «Apache 2.4», задать уникальное Имя публикации, указать Каталог размещения файлов публикации:
Снять ВСЕ галочки, кроме тех что установлены в закладке «HTTP сервисы»:
[[File:1s12.png|600px]]
[[File:1s13.png|600px]]
Нажать кнопку «Опубликовать». На предложение перезапуска веб-сервера нажать кнопку «Да».
'''Порядок настройки компонента BARLane'''
1. Запустить конфигурацию 1С в режиме «Предприятие».
2. Открыть пункт меню «Barlane» - Настройки Barlane – для поля «Каталог алкогольной продукции» нажать кнопку «…» - выбрать группу справочника «Номенклатура», в которой будет размещаться номенклатура для обмена с сервисом Barlane.
'''Внимание'''. У номенклатуры обязательно должен быть заполнен реквизит «Вид алкогольной продукции»:
[[File:1s14.png|600px]]
----
3 - Установка Модуля Выгрузки
Запустить файл blstorexcsvc-installer-x.x.x.xxx.exe, программа установится в папку C:\Barlane\StoreExchange
Есть два файла настройки (в папке C:\Barlane\StoreExchange\config):
network-config.cfg - связь с сервером БЛ;
store-config.cfg - связь с веб-сервером 1С.
'''ВАЖНО''': Всё касаемо .NET framework - аналогично "Модулю Синхронизации".
----
4 - Настройка связи с сервером БЛ.
Открыть файл network-config.cfg с помощью "блокнота".
Верхнюю часть не трогать (менять что-то только при использовании тестового сервера).
Заполнить значения [Entity] ("торговый объект") и [TransportModule] ("модуль синхронизации") аналогично настройкам Модуля Синхронизации.
Пример заполненного тестового конфига:
[[File:iikoconf1.png|600px]]
----
5 - Настройка связи с веб-сервером 1С.
Открыть файл store-config.cfg с помощью "блокнота"
Пример конфига:
<nowiki>
Version = 1
StoreSystemType = "Rarus1C"
[Connection]
Address = "127.0.0.1/UR_MAIN/hs/Store_Exchange"
Port = 80
UserName = "Admin"
Password = "191922"
[Import]
[Import.WayBillSettings]
SpecialAccounting = false
[Import.InventorySettings]
RestsSource = "Real"
SpecialAccounting = false
</nowiki>
1. Задать тип учетной системы:
StoreSystemType = "Rarus1C"
2. Задать адрес и порт (пример):
Address = "127.0.0.1/UR_MAIN/hs/Store_Exchange"
Port = 80
Адрес формируется следующим образом:
"127.0.0.1" - IP-адрес веб-сервера 1С (обычно 127.0.0.1 (localhost), т.к. модуль выгрузки ставится вместе с веб-сервером 1С).
"UR_MAIN" - имя публикации, которое задается при установке компонента (можно задать произвольное имя, см. выше)
"hs/Store_Exchange" - неизменная часть адреса
Порт всегда 80.
Логин и пароль необходимо узнать у клиента.
Прочие параметры (import) оставляем по-умолчанию.
'''ПРИМЕЧАНИЕ 1''': Для версий выгрузки ниже 2.4.0.0 Adress указывается без "Store_Exchange", в примере выше будет Address = "127.0.0.1/UR_MAIN/hs
'''ПРИМЕЧАНИЕ 2''': Для версии конфигурации "Общепит КОРП" ниже 8.3.16 - писать "StoreExchange" вместо "Store_Exchange".
----
6 - Запустить службу Модуля Выгрузки.
Открыть "Службы", запустить "Barlane StoreExchange Module service".
'''ВАЖНО''': Всё касаемо .NET framework - аналогично "Модулю Синхронизации".
----
Настройки со стороны 1С описаны в пользовательской инструкции:
https://wiki.barlive.ru/wiki/%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_%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92#.D0.92.D1.8B.D0.B3.D1.80.D1.83.D0.B7.D0.BA.D0.B0_.D0.B2_1.D0.A1
'''ВАЖНО''': Сделать эти первичные настройки вместе с пользователем.
----
==Установка Модуля Бармена==
[[File:barapp.png|right|100px]]
Подготовить дистрибутив (архив с файлом **bar-app-installer-2.х.х.х**)
https://disk.360.yandex.ru/d/JkxUiZYnfPjq4Q
Подключиться к ПК, с которого будут сканировать бутылки.
Запустить файл **bar-app-installer-2.х.х.х.exe**, программа установится в папке **C:\BarLane\BarApp**
===Настройка Модуля Бармена===
Настройки находятся в папке config (как правило C:\Barlane\BarApp\config)
app-config - настройки приложения
cloud-config - настройки связи с сервером
Открыть файл cloud-config с помощью «блокнота».
Заполнить настройки:
BarlineAddr - адрес сервера БАРЛАЙВ, по умолчанию https://egais.barlive.ru/svc/scanner/ , меняется только для тестового контура и для WinXP;
CashboxInitCode – id кассы, взять с сайта:
«Кассы» - нажать на символ QR-кода – скопировать целиком первую строку:
[[File:blinst8.png|600px]]
'''ВАЖНО''': скопировать строку целиком (включая CashboxInit:)
Сохранить файл и закрыть.
Файл app-config оставить без изменений. Настройки там менять в особых случаях:
'''ПРИМЕЧАНИЕ 1''': Если у клиента возникнет проблема с исчезающей кнопкой (из-за кассы rk7) - выставляем параметр WindowMode = "Agressive".
'''ПРИМЕЧАНИЕ 2:''' В случае, если кнопка есть, но в программу штрих-код не попадает (бывает актуально в rk6), сначала убедиться, что сканер настроен корректно (сканирует в блокнот с переносом строки), если да, то необходимо выставить параметр KeyboardMode = "LowLevel".
'''Расположение кнопки'''
Уточнить у клиента, где ему удобнее будет расположить кнопку ЕГАИС. Для тач-скринов (официантские станции/кассы) как правило выбирают верхний правый угол; для десктопных ПК (обычный компьютер бухгалтера/кладовщика) - по центру.
Переместить кнопку просто (сначала запустить barapp) - щёлкнуть правой кнопкой по значку в трее, выбрать "переместить кнопку".
[[File:barappmove1.png|600px]]
На значке появится иконка перемещения:
[[File:barappmove2.png]]
Перетащить значок в нужную позицию, щёлкнуть правой кнопкой в трее и выбрать "завершить перемещение", новые координаты сохранятся.
[[File:barappmove3.png|600px]]
'''ПРИМЕЧАНИЕ''': Подобный метод перетаскивание не позволяет прятать кнопку за "край" экрана. А иногда пользователи десктопных ПК просят её спрятать. В таком случае используйте ручное указание координат в конфиге app-config :
<nowiki>
#Расположение кнопки "ЕГАИС"
[ButtonLocation]
X = 700
Y = -50
</nowiki>
Пример подобной "спрятанной" кнопки с координатами 700 и -50 :
[[File:barappmove4.png|600px]]
----
===Доступные настройки Модуля Бармена===
Пример полного конфига:
<nowiki>
#Включение полноэкранного режима
FullScreen = true
#Интервал в минутах между сеансами связи с сервером для отправки марок
IntervalMinutes = 5
#Интервал в минутах между обновлениями каталогов
CatalogsIntervalMinutes = 60
#Включение возможности логина через Rkeeper
RkeeperLogin = false
#Режим окна: Standart - стандартный (не используется); TopMost - поверх всех окон; Agressive - поверх всех окон с циклическим обновлением
WindowMode = "TopMost"
#Режим захвата потока символов со сканера: Standart - стандартный; LowLevel - низкоуровневый (захватывать все)
KeyboardMode = "Standart"
#Таймаут потока символов со сканера, мс
KeyboardTimeoutMs = 333
#Номер монитора, на котором стартует приложение: 0 - по умолчанию (старт на активном мониторе); 1 и далее - номер монитора в соответствии с присвоенным в диспетчере мониторов
StartupScreen = 0
#Принудительно конвертировать в верхний регистр символы со сканера
ForceInputUppercase = false
#Префикс сканера, пустая строка, если не используется
ScanCodePrefix = ""
#Суффикс сканера, пустая строка, если не используется
ScanCodeSuffix = ""
#Принудительная конвертация символов в верхний регистр не действует для префикса/суффикса
PrefixSuffixIgnoreForceUppercase = false
#Звуковые уведомления
SoundNotificationsEnabled = true
#Обозначать успешное сканирование
SoundNotificationsOnSuccess = false
#Выделять отдельным звуком марки с неизвестным продуктом
SoundHighlightUnknownProduct = false
#Включить режим каталога и отображение кнопки на панели
ShowCatalog = true
#Включить перенос строки при отображении имени
EnableNameWrap = true
#Игнорировать прокси-сервер
IgnoreProxy = false
#Включить установку срока годности кег по-умолчанию
SetDefaultKegCodeExpiration = true
#Значение срока годности кег по-умолчанию
DefaultKegCodeExpirationValue = 21
#Расположение кнопки "ЕГАИС"
[ButtonLocation]
X = 919
Y = 0
</nowiki>
'''Примечание к настройкам звука:'''
Успешное сканирование - доп.короткий сигнал.
Неуспешное сканирование - два длинных сигнала.
Сканирование марки, отсутствующей в справочниках ("неизвестная продукция" либо "Тип - ...") - два коротких сигнала.
Уведомления можно выключить целиком; а также включить в любой комбинации.
По умолчанию в новых версиях выставлено уведомление на неуспешное сканирование.
'''Настройка автоматической отправки списка по указанному времени:'''
AutoSendListTime = "21:30"
'''Настройка работы со сканером через COM'''
Необходимо добавить в конфиг параметр
ComPortParameters = "COM1/9600/8/N/1"
В данном примере настраивается порт COM1, скорость 9600 бод, 8 бит данных, контроль четности выкл, 1 стоп-бит.
----
===Запуск Модуля Бармена===
'''ПРИМЕЧАНИЕ''': Первый запуск может быть долгим (зависит от мощности ПК и скорости интернет-соединения).
Запуск модуля – открыть файл '''bar-app.exe'''. Появится кнопка - нажать на неё для разворачивания приложения. (Если кнопки после запуска не появилась - возможно вы указали неверные координаты, кнопка "уехала" за границу экрана; закройте программу через "Диспетчер устройств" (процесс "bar-app"), исправьте конфиг, запустите заново).
Если что-то было сделано неправильно, приложение либо не запустится, либо на начальном экране напишет «Инициализация с ошибкой» - это означает что настройки были заполнены неверно (либо проблемы с сервером). Приложение можно закрыть из Диспетчера Задач (процесс "bar-app"), либо в трее (иконка в виде рюмки в нижнем правом углу):
[[File:barapptrayn.png]]
В будущем Модуль будет запускаться автоматически при загрузке ОС (отключить это можно в стандартных настройках ОС).
Ввести пин-код.
'''ПРИМЕЧАНИЕ''': Для того, чтобы Модуль Бармена увидел новые учётные записи (заведённые в Модуле Бухгалтера), необходимо перезапустить приложение.
==Установка Мобильного Бармена==
[[File:androidlogo.png|right|100px]]
[[File:applelogoblack.svg.png|right|100px]]
Adnroid и iOS-приложение, доступно для смартфонов, а также поддерживается работа со следующими ТСД:
- АТОЛ Smart.Prime
- АТОЛ Smart.Lite
- АТОЛ Smart.Slim
- АТОЛ Smart.Droid
Ниже инструкции по установке на ТСД и на смартфонах.
iOS приложение доступно в AppStore:
https://apps.apple.com/ru/app/barlane-%D0%B5%D0%B3%D0%B0%D0%B8%D1%81/id6453991802
ANDROID приложение доступно в Google Play:
https://play.google.com/store/apps/details?id=ru.barlane.barapp
APK-файл для Android-смартфонов:
https://disk.360.yandex.ru/d/zJmU0rpaTsc8Og
===Установка Мобильного Бармена на ТСД===
Файлы для ТСД (без дистрибутива - ссылка на него выше): https://disk.yandex.ru/d/fx8PhWwnEdlDzQ
'''ВАЖНО''': Убедитесь, что ваш ТСД подключен к интернету (включён в wi-fi сеть).
Распаковать архив и загрузить файлы (adcontrol-ad1.apk, anydesk.apk, ru.barlane.barapp-Signed-***.apk, bl-screensaver.png) на устройство в папку Downloads.
Для ТСД Smart.Lite и Smart.Slim (т.е. смартфонов данный пункт не касается) дополнительно настроить '''barcode utility''' по инструкции:
[https://wiki.barlive.ru/images/d/da/Atol_Smart.Lite_-_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_%D1%81%D0%BA%D0%B0%D0%BD%D0%B5%D1%80%D0%B0_%D0%B4%D0%BB%D1%8F_%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%8B_%D1%81_Barlane.pdf Скачать инструкцию]
Для ТСД Smart.Droid сделать следующую настройку в приложении ScanWedge:
[[File:nastrojjkatsd.jpg|300px]]
1 - Установить Anydesk и плагин (последовательно файлы anydesk.apk, затем adcontrol-ad1.apk; в процессе разрешить установку из неизвестных источников).
2 - Запустить Anydesk, включить плагин (если при первом входе не включили - можно затем включить в общих настройках устройства в "спецвозможностях"); зайти в "файлы" и дать разрешение. Закрыть энидеск.
3 - Открыть файл bl-screensaver.png, установить его в качестве обоев и экрана блокировки
4 - Установить Мобильный Бармен (файл ru.barlane.barapp-Signed-***.apk).
5 - Запустить установленное приложение, при первом запуске выдать запрошенные разрешения:
[[File:1.1pervyjjzapusk-zaprosrazreshenijj.jpg|400px]]
После выданных разрешений откроется окно активации:
[[File:1.2pervyjjzapusk-skanirovaniekodakassy.jpg|400px]]
Заведите новую кассу в соответствующем разделе Модуля Бухгалтера (в название добавьте Mobile, Мобильный или ТСД), нажмите на значок QR-кода в общем списке:
[[File:aktivacijamobilnogobarmena1.png|400px]]
Откроется окно с qr-кодом:
[[File:aktivacijamobilnogobarmena2.png|400px]]
Его и надо отсканировать устройством (ТСД/смартфоном). ТСД сканирует нажатием аппаратной кнопки SCAN; смартфон - наэкранной кнопкой.
**ВАЖНО** - активируйте отдельно созданную для мобильного устройства кассу; внимательно, т.к. если активируете уже существующую виндовую, будут ошибки.
В случае если был отсканирован правильный штрих-код, запустится активация:
[[File:1.3pervyjjzapusk-zagruzkadannyx.jpg|400px]]
В процессе могут ещё раз быть запрошены необходимые разрешения:
[[File:1.pervyjjzapusk.jpg|400px]]
После успешной активации появится окно авторизации:
[[File:2.loginpopinkodu.jpg|400px]]
Проверить, что название кассы и объекта верные; проверить авторизацию по пин-коду.
6 - Перетащить ярлык "Мобильного Бармена" на рабочий стол; убрать с рабочего стола все остальные ярлыки (в самом низу).
Можно начинать работу с Мобильным Барменом.
Пользовательская инструкция:
https://wiki.barlive.ru/wiki/%D0%9C%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C%D0%BD%D1%8B%D0%B9_%D0%91%D0%B0%D1%80%D0%BC%D0%B5%D0%BD_%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92
----
=== Установка Мобильного Бармена на смартфон===
iOS приложение доступно в AppStore:
https://apps.apple.com/ru/app/barlane-%D0%B5%D0%B3%D0%B0%D0%B8%D1%81/id6453991802
ANDROID приложение доступно в Google Play:
https://play.google.com/store/apps/details?id=ru.barlane.barapp
APK-файл для Android-смартфонов:
https://disk.yandex.ru/d/c_KJeUb34FHUCA
Установить из маркета; или если через apk:
Скачать дистрибутив на устройство, установить (разрешить установку из "неизвестных источников" если запросит).
'''ВАЖНО''': Убедитесь, что смартфон подключён к интернету (желательно в в wi-fi сети).
Запустить установленное приложение, при первом запуске выдать запрошенные разрешения:
[[File:1.1pervyjjzapusk-zaprosrazreshenijj.jpg|400px]]
После выданных разрешений откроется окно активации:
[[File:1.2pervyjjzapusk-skanirovaniekodakassy.jpg|400px]]
Заведите новую кассу в соответствующем разделе Модуля Бухгалтера (в название добавьте Mobile, Мобильный или ТСД), нажмите на значок QR-кода в общем списке:
[[File:aktivacijamobilnogobarmena1.png|400px]]
Откроется окно с qr-кодом:
[[File:aktivacijamobilnogobarmena2.png|400px]]
Его и надо отсканировать устройством (ТСД/смартфоном). ТСД сканирует нажатием аппаратной кнопки SCAN; смартфон - наэкранной кнопкой.
'''ВАЖНО''' - активируйте отдельно созданную для мобильного устройства кассу; внимательно, т.к. если активируете уже существующую виндовую, будут ошибки.
В случае если был отсканирован правильный штрих-код, запустится активация:
[[File:1.3pervyjjzapusk-zagruzkadannyx.jpg|400px]]
В процессе могут ещё раз быть запрошены необходимые разрешения:
[[File:1.pervyjjzapusk.jpg|400px]]
После успешной активации появится окно авторизации:
[[File:2.loginpopinkodu.jpg|400px]]
Можно начинать работу с Мобильным Барменом.
Пользовательская инструкция:
https://wiki.barlive.ru/wiki/%D0%9C%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C%D0%BD%D1%8B%D0%B9_%D0%91%D0%B0%D1%80%D0%BC%D0%B5%D0%BD_%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92
==Завершение установки==
'''ВАЖНО''': Запросить остатки, чтобы в систему загрузились в первый раз до начала приёмок ТТН.
Если объектов или касс несколько – повторить соответствующие пункты.
Проверить авторизацию модуля Бармена / мобильного Бармена.
Передать на обучение.
'''ВАЖНО''': Узнать, есть ли алкогольная лицензия. Если есть, уточнить не является ли она ограниченной по маркируемой продукции крепостью меньше 16.5%. Если да - выставить соответствующую настройку в "Торговых объектах".