1029
правок
Изменения
Внутреннее:Инструкция по подключению БАРЛАЙВ МЕРКУРИЙ (посмотреть исходный код)
Версия от 20:22, 1 июня 2026
, 1 июньНовая страница: «<center><FONT SIZE=7>Подключение БАРЛАЙВ МЕРКУРИЙ</FONT></center> ===1. Общая информация=== Актуальный адр...»
<center><FONT SIZE=7>Подключение БАРЛАЙВ МЕРКУРИЙ</FONT></center>
===1. Общая информация===
Актуальный адрес: https://merc.barlive.ru/mercury/
Все действия выполняются только в этом интерфейсе.
Перед настройкой необходимо, чтобы в системе BARLANE были заведены:
'''1. Хозяйствующий субъект (ХС)'''
[[File:image-8-m.png|400px]]
Название - юридическое лицо. Пример: ООО "Барлайн".
Дата - дата подключения.
ИНН - ИНН юридического лица.
КПП - КПП юридического лица.
Юр.лицо - полное наименование юридического лица. Пример: Общество с ограниченной ответственность "Барлайн".
'''2. Площадка (Торговый объект)'''
[[File:image-9-m.png|400px]]
Название - наименование точки (фактического места осуществления деятельности).
ИНН предприятия - ИНН юридического лица.
КПП юр.лица - КПП юридического лица.
КПП обособленного подразделения - КПП обособки.
ФСРАР-id (СИО) - указываем 0 (ноль).
[[File:image-13-m.png|400px]]
Corporation Guid - указывается изначально заведенный Хозяйствующий суъект (ХС) в BARLANE Меркурий.
Меркурий - автогашение - указывается галка Да.
GUID площадки - GUID торгового объекта (площадки).
Настройка суточной задержки - указывается исходя из потребности пользователя, может быть - Автогашение с задержкой или Мгновенное автогашение.
Тип автогашения - может указываеться Отключено (если автогашение не нужно), общее (для всех входящих ВСД), только доверенные.
Время последнего автогашения - не указывать, остается пустым.
Время автогашения - указываем Часы и Минуты, т.е. время, в которое пользователю необходимо, чтобы происходило автогашение.
Адрес - адрес площадки.
'''3. Реквизиты Ветис.API'''
[[File:image-10-m.png|400px]]
Название - наименование Площадки.
Corporation Guid - указывается изначально заведенный Хозяйствующий суъект (ХС) в BARLANE Меркурий.
Is Test - не указываем, оставляем пустым.
Login Account - уточняем логик к Ветис.Меркурий у пользователя. Пример логина: kokoev_it_230313 .
Login – cto-180622 | Данный логин статичен.
Пароль – w7Q9mNiS7 | Данный пароль статичен.
API Key – MDFhNGVmZmYtMjNkNC00ZjU0LWFiZDEtNTJmMWNhZDBmMThlM2IzMGMxYTctYThkYi00ZjU2LTlkZWQtY2MwNGRjMWMwZTA5 | Данный API Key статичен.
Mercury User Guid – (IssuerID) GUID Хозяйствующего субъекта (напр-р bca2f196-ee62-40e4-b182-8c4276e23b95).
GUID площадки – GUID торгового объекта (площадки).
Last Migrate - не трогать, это информационное поле
__Для того, чтобы эти данные можно было завести - необходимо действовать по инструкции ниже.__
[https://wiki.barlive.ru/wiki/%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92_%D0%9C%D0%95%D0%A0%D0%9A%D0%A3%D0%A0%D0%98%D0%99 Ссылка на пользовательскую инструкцую.]
===2. Получение GUID хозсубъекта и площадки===
Организации, работающие с продукцией животного происхождения, обязаны вести учёт оборота через ФГИС «Меркурий». Для работы в системе требуется зарегистрировать хозяйствующий субъект (юридическое лицо или ИП) и площадку (адрес фактического осуществления деятельности). Регистрацию выполняет территориальное управление Россельхознадзора через сервис «Цербер.ХС». После одобрения каждая сущность получает уникальный GUID, используемый для интеграции с БАРЛАЙВ.
Если регистрация была осуществлена - узнать GUID ХС и площадок можно через официальный сервис ВЕТИС или на подобных площадках:
👉 https://ветис-меркурий.рф/поиск-в-меркурии
👉 https://info.ветис-меркурий.рф/BusinessEntity
👉 https://меркурий-россельхознадзор.рф/поиск-в-меркурии/
Если регистрации не было - мы можем ее осуществить самостоятельно, отдел продаж сразу уточняет данную информацию и передает соответствующему специалисту.
При подключении - заполнить данные в таблице [https://docs.google.com/spreadsheets/d/1-J3VXNM7SzJZ5U7rFG3G6YaUX2CwL9pYK4LQHCxdkBY/edit?gid=1573716242#gid=1573716242 “Меркурий БЛ установить”].Если Если данных нет в таблице [https://docs.google.com/spreadsheets/d/1-J3VXNM7SzJZ5U7rFG3G6YaUX2CwL9pYK4LQHCxdkBY/edit?gid=1573716242#gid=1573716242 “Меркурий БЛ установить”] — заполнить вручную.
===3. Подключение или проверка API BARLANE (ключевой этап)===
Перед любыми настройками в интерфейсе BARLANE необходимо подключить API BARLANE в ФГИС “Меркурий”.
Этот шаг выполняется на компьютере с ЭЦП генерального директора.
3.1. Подключение API БАРЛАЙВ и проверка текущего состояния API
- Подключиться к ПК пользователя с ЭЦП ген. директора.
- Открыть https://aplms.vetrf.ru/pub/
- Нажать “Получить доступ (с использованием ЭП)” — выбрать ЭЦП ген. директора.
- Заполнить данные по клиенту (почту ответственного лица клиента, ему должно будет прийти письмо что заявка одобрена)
[[File:image-5-m.png|400px]]
- В форме выбрать "Подключение к существующей клиентской системе"
[[File:image-6-m.png|400px]]
- В "Информация о клиентской системе" - указать ИНН ООО "БАРЛАЙН" - '''7727421269'''
[[File:image-7-m.png|400px]]
- Проверить введённые данные и нажать "Подписать и завершить"
Если заявка создана успешно - дождаться письма о том, что API подключено.
Если появляется ошибка “уже подключено другое ПО” (напр. Docsinbox), перейти сразу к разделу 3.2 — Отключение старого API.
3.2. Отключение API от старого ПО
- Находясь на ПК с ЭЦП ГД, создать заявление об отключении API ([https://disk.360.yandex.ru/d/_L0LBmoVuJ0P2w файл тут])
[[File:image-11-m.png|400px]]
Как заполнять:
1. Желтые поля обязательны для заполнения, зеленые поля заполняются по желанию.
2. Заявка должна быть подписана усиленной квалифицированной электронной подписью (УКЭП) лица, имеющего право действовать от имени организации без доверенности (УКЭП руководителя организации, для которой требуется аннулировать доступ, или организации, владеющей учетной записью).
3. Подписанную заявку направить по электронной почте на адрес api@vetrf.ru, в теме письма указать «Аннулирование доступа - отключение API».
После заполнения необходимо:
- Не отключаясь от ПК пользователя - подписать заявление ЭЦП ГД.
- Сохранить два файла в форматах:
1. заявление.docx
2. заявление.docx.sig
- Отправить оба файла с почты admin@barlane.ru, на адрес: 📩 api@vetrf.ru , тема письма: " Аннулирование доступа - отключение API ".
После - необходимо ожидать уведомление от Ветис.API об отключении (в среднем 3–5 рабочих дней), проверяя почту.
Как подписать в SIG:
1. Открыть Инструменты КриптоПро
[[File:image-14-m.png|400px]]
2. Перейти в Настройки > Создание подписи > Расширение подписанного файла > Выбрать .SIG > У поля Создавать отсоединенную подпись поставить Галку.
[[File:image-15-m.png|400px]]
3. Перейти в Создание подписи > Выбрать нужную > Выбрать файл для подписи > Подписать > Забрать файл себе.
[[File:image-16-m.png|400px]]
[[File:image-17-m.png|400px]]
===4. Настройка интерфейса БАРЛАЙВ Меркурий===
Перейти: https://merc.barlive.ru/mercury/
1. Завести Хозяйствующий субъект
2. Добавить площадку/и
3. Настройка учётной записи
В разделе “Учётные записи” добавить роль “Администратор (Меркурий)”.
Включить оповещение об ошибочных ВСД.
Сохранить изменения.
Одна учётная запись может быть привязана к нескольким юрлицам.
4. Настроить реквизиты Ветис.API
=== 5. Проверка работы ===
- Открыть раздел «Ветеринарные документы» → «Запросить данные».
В течение ~1 минуты должны подгрузиться входящие ВСД.
Если произошла ошибка, проверить:
- корректность указанных GUID хозсубъекта и площадки (без лишних пробелов и символов)
- корректность логинов
- актуальность и валидность API-подключения
- есть ли у учётной записи права в vetis.паспорт
- были ли входящие ВСД у клиента за последние 4 дня
(если документов не было, ориентировать клиента на появление новых входящих ВСД)
Дополнительно:
Запрос остатков можно выполнять в любой момент, он работает независимо от состояния автогашения.
===6. Уведомление клиента===
Если создавалась новая учётная запись:
Тема:
{Название юрлица} — учётная запись Меркурий БАРЛАЙВ
Текст:
Добрый день,
{Название юрлица}
Инструкция по работе:
https://wiki.barlive.ru/wiki/%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92_%D0%9C%D0%95%D0%A0%D0%9A%D0%A3%D0%A0%D0%98%D0%99
Личный кабинет:
https://merc.barlive.ru/mercury/
Учётная запись администратора:
Логин – {почта клиента}
Пароль – {сгенерированный пароль}
Отправлять с admin@barlive.ru
Если создание учётки не требуется - письмо не направляется, но пользователя уведомляем о подключении продукта и передаем на обучение (если требуется).
===7. Сроки и контроль===
Заявка на подключение или отключение API обрабатывается ВЕТИС в среднем 5 рабочих дней, каждая.
После завершения приходит уведомление на почту, указанную при подаче.
Если была подана заявка на отключение - необходимо подать заявку на подключение к BARLANE.
===1. Общая информация===
Актуальный адрес: https://merc.barlive.ru/mercury/
Все действия выполняются только в этом интерфейсе.
Перед настройкой необходимо, чтобы в системе BARLANE были заведены:
'''1. Хозяйствующий субъект (ХС)'''
[[File:image-8-m.png|400px]]
Название - юридическое лицо. Пример: ООО "Барлайн".
Дата - дата подключения.
ИНН - ИНН юридического лица.
КПП - КПП юридического лица.
Юр.лицо - полное наименование юридического лица. Пример: Общество с ограниченной ответственность "Барлайн".
'''2. Площадка (Торговый объект)'''
[[File:image-9-m.png|400px]]
Название - наименование точки (фактического места осуществления деятельности).
ИНН предприятия - ИНН юридического лица.
КПП юр.лица - КПП юридического лица.
КПП обособленного подразделения - КПП обособки.
ФСРАР-id (СИО) - указываем 0 (ноль).
[[File:image-13-m.png|400px]]
Corporation Guid - указывается изначально заведенный Хозяйствующий суъект (ХС) в BARLANE Меркурий.
Меркурий - автогашение - указывается галка Да.
GUID площадки - GUID торгового объекта (площадки).
Настройка суточной задержки - указывается исходя из потребности пользователя, может быть - Автогашение с задержкой или Мгновенное автогашение.
Тип автогашения - может указываеться Отключено (если автогашение не нужно), общее (для всех входящих ВСД), только доверенные.
Время последнего автогашения - не указывать, остается пустым.
Время автогашения - указываем Часы и Минуты, т.е. время, в которое пользователю необходимо, чтобы происходило автогашение.
Адрес - адрес площадки.
'''3. Реквизиты Ветис.API'''
[[File:image-10-m.png|400px]]
Название - наименование Площадки.
Corporation Guid - указывается изначально заведенный Хозяйствующий суъект (ХС) в BARLANE Меркурий.
Is Test - не указываем, оставляем пустым.
Login Account - уточняем логик к Ветис.Меркурий у пользователя. Пример логина: kokoev_it_230313 .
Login – cto-180622 | Данный логин статичен.
Пароль – w7Q9mNiS7 | Данный пароль статичен.
API Key – MDFhNGVmZmYtMjNkNC00ZjU0LWFiZDEtNTJmMWNhZDBmMThlM2IzMGMxYTctYThkYi00ZjU2LTlkZWQtY2MwNGRjMWMwZTA5 | Данный API Key статичен.
Mercury User Guid – (IssuerID) GUID Хозяйствующего субъекта (напр-р bca2f196-ee62-40e4-b182-8c4276e23b95).
GUID площадки – GUID торгового объекта (площадки).
Last Migrate - не трогать, это информационное поле
__Для того, чтобы эти данные можно было завести - необходимо действовать по инструкции ниже.__
[https://wiki.barlive.ru/wiki/%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92_%D0%9C%D0%95%D0%A0%D0%9A%D0%A3%D0%A0%D0%98%D0%99 Ссылка на пользовательскую инструкцую.]
===2. Получение GUID хозсубъекта и площадки===
Организации, работающие с продукцией животного происхождения, обязаны вести учёт оборота через ФГИС «Меркурий». Для работы в системе требуется зарегистрировать хозяйствующий субъект (юридическое лицо или ИП) и площадку (адрес фактического осуществления деятельности). Регистрацию выполняет территориальное управление Россельхознадзора через сервис «Цербер.ХС». После одобрения каждая сущность получает уникальный GUID, используемый для интеграции с БАРЛАЙВ.
Если регистрация была осуществлена - узнать GUID ХС и площадок можно через официальный сервис ВЕТИС или на подобных площадках:
👉 https://ветис-меркурий.рф/поиск-в-меркурии
👉 https://info.ветис-меркурий.рф/BusinessEntity
👉 https://меркурий-россельхознадзор.рф/поиск-в-меркурии/
Если регистрации не было - мы можем ее осуществить самостоятельно, отдел продаж сразу уточняет данную информацию и передает соответствующему специалисту.
При подключении - заполнить данные в таблице [https://docs.google.com/spreadsheets/d/1-J3VXNM7SzJZ5U7rFG3G6YaUX2CwL9pYK4LQHCxdkBY/edit?gid=1573716242#gid=1573716242 “Меркурий БЛ установить”].Если Если данных нет в таблице [https://docs.google.com/spreadsheets/d/1-J3VXNM7SzJZ5U7rFG3G6YaUX2CwL9pYK4LQHCxdkBY/edit?gid=1573716242#gid=1573716242 “Меркурий БЛ установить”] — заполнить вручную.
===3. Подключение или проверка API BARLANE (ключевой этап)===
Перед любыми настройками в интерфейсе BARLANE необходимо подключить API BARLANE в ФГИС “Меркурий”.
Этот шаг выполняется на компьютере с ЭЦП генерального директора.
3.1. Подключение API БАРЛАЙВ и проверка текущего состояния API
- Подключиться к ПК пользователя с ЭЦП ген. директора.
- Открыть https://aplms.vetrf.ru/pub/
- Нажать “Получить доступ (с использованием ЭП)” — выбрать ЭЦП ген. директора.
- Заполнить данные по клиенту (почту ответственного лица клиента, ему должно будет прийти письмо что заявка одобрена)
[[File:image-5-m.png|400px]]
- В форме выбрать "Подключение к существующей клиентской системе"
[[File:image-6-m.png|400px]]
- В "Информация о клиентской системе" - указать ИНН ООО "БАРЛАЙН" - '''7727421269'''
[[File:image-7-m.png|400px]]
- Проверить введённые данные и нажать "Подписать и завершить"
Если заявка создана успешно - дождаться письма о том, что API подключено.
Если появляется ошибка “уже подключено другое ПО” (напр. Docsinbox), перейти сразу к разделу 3.2 — Отключение старого API.
3.2. Отключение API от старого ПО
- Находясь на ПК с ЭЦП ГД, создать заявление об отключении API ([https://disk.360.yandex.ru/d/_L0LBmoVuJ0P2w файл тут])
[[File:image-11-m.png|400px]]
Как заполнять:
1. Желтые поля обязательны для заполнения, зеленые поля заполняются по желанию.
2. Заявка должна быть подписана усиленной квалифицированной электронной подписью (УКЭП) лица, имеющего право действовать от имени организации без доверенности (УКЭП руководителя организации, для которой требуется аннулировать доступ, или организации, владеющей учетной записью).
3. Подписанную заявку направить по электронной почте на адрес api@vetrf.ru, в теме письма указать «Аннулирование доступа - отключение API».
После заполнения необходимо:
- Не отключаясь от ПК пользователя - подписать заявление ЭЦП ГД.
- Сохранить два файла в форматах:
1. заявление.docx
2. заявление.docx.sig
- Отправить оба файла с почты admin@barlane.ru, на адрес: 📩 api@vetrf.ru , тема письма: " Аннулирование доступа - отключение API ".
После - необходимо ожидать уведомление от Ветис.API об отключении (в среднем 3–5 рабочих дней), проверяя почту.
Как подписать в SIG:
1. Открыть Инструменты КриптоПро
[[File:image-14-m.png|400px]]
2. Перейти в Настройки > Создание подписи > Расширение подписанного файла > Выбрать .SIG > У поля Создавать отсоединенную подпись поставить Галку.
[[File:image-15-m.png|400px]]
3. Перейти в Создание подписи > Выбрать нужную > Выбрать файл для подписи > Подписать > Забрать файл себе.
[[File:image-16-m.png|400px]]
[[File:image-17-m.png|400px]]
===4. Настройка интерфейса БАРЛАЙВ Меркурий===
Перейти: https://merc.barlive.ru/mercury/
1. Завести Хозяйствующий субъект
2. Добавить площадку/и
3. Настройка учётной записи
В разделе “Учётные записи” добавить роль “Администратор (Меркурий)”.
Включить оповещение об ошибочных ВСД.
Сохранить изменения.
Одна учётная запись может быть привязана к нескольким юрлицам.
4. Настроить реквизиты Ветис.API
=== 5. Проверка работы ===
- Открыть раздел «Ветеринарные документы» → «Запросить данные».
В течение ~1 минуты должны подгрузиться входящие ВСД.
Если произошла ошибка, проверить:
- корректность указанных GUID хозсубъекта и площадки (без лишних пробелов и символов)
- корректность логинов
- актуальность и валидность API-подключения
- есть ли у учётной записи права в vetis.паспорт
- были ли входящие ВСД у клиента за последние 4 дня
(если документов не было, ориентировать клиента на появление новых входящих ВСД)
Дополнительно:
Запрос остатков можно выполнять в любой момент, он работает независимо от состояния автогашения.
===6. Уведомление клиента===
Если создавалась новая учётная запись:
Тема:
{Название юрлица} — учётная запись Меркурий БАРЛАЙВ
Текст:
Добрый день,
{Название юрлица}
Инструкция по работе:
https://wiki.barlive.ru/wiki/%D0%91%D0%90%D0%A0%D0%9B%D0%90%D0%99%D0%92_%D0%9C%D0%95%D0%A0%D0%9A%D0%A3%D0%A0%D0%98%D0%99
Личный кабинет:
https://merc.barlive.ru/mercury/
Учётная запись администратора:
Логин – {почта клиента}
Пароль – {сгенерированный пароль}
Отправлять с admin@barlive.ru
Если создание учётки не требуется - письмо не направляется, но пользователя уведомляем о подключении продукта и передаем на обучение (если требуется).
===7. Сроки и контроль===
Заявка на подключение или отключение API обрабатывается ВЕТИС в среднем 5 рабочих дней, каждая.
После завершения приходит уведомление на почту, указанную при подаче.
Если была подана заявка на отключение - необходимо подать заявку на подключение к BARLANE.