Как заполнить реквизиты доступа в Меркурий в программе ВСД Мобайл
Первое, с чем придется столкнуться в начале работы с приложением — заполнение профиля Ветис.API
Полная инструкция по заполнению заявки здесь. После того, как Вы отправите заявку и дождетесь ее одобрения, в полученном письме будут реквизиты доступа к Ветис.API.
Чтобы занести реквизиты доступа в профиль пользователя «ВСД Мобайл» откройте приложение на своем смартфоне или планшете, затем откройте главное меню, нажав кнопку слева вверху. Нужно выбрать пункт «Профили Ветис.API». В открывшейся форме нажмите «+», Вам будет предложено выбрать тип профиля. Если у Вас есть реквизиты для тестового доступа, можно создать тестовый профиль. В пробной версии программы можно гасить ВСД из тестового контура. Для гашения ВСД в продуктивном контуре нужно будет активировать подписку.
Назначение полей формы в продуктивном контуре:
Хозяйствующий субъект — поле только для чтения. Если тестирование профиля пройдет успешно, здесь будет название хозяйствующего субъекта. Пока оно пустое.
API Key — это специальный ключ, который нужен Меркурию для идентификации клиентской программы. Он содержится в присланном при регистрации в Меркурии письме и представляет собой длинную символьную строку, которую вручную ввести на смартфоне нереально. Поэтому для облегчения работы справа расположен сканер QR кодов. Скопируйте API Key в любой редактор QR кодов, например, вот этот, и сгенерируйте соответствующий код. Наведите камеру Вашего смартфона на QR код и сканер считает строку в выбранное поле.
Инициатор — это конкретное лицо, от имени которого будут выполняться действия в системе. Этот реквизит соответствует логину, который Вы получили для входа в веб-интерфейс системы меркурий. Если Вы еще не получили такой доступ, то получать его все равно придется, т.к. он дается при регистрации реальной площадки в системе Меркурий. Подробнее смотрите здесь.
Issuer ID — еще один параметр, который требуется исключительно для корректной работы API. По сути, он представляет собой GUID хозяйствующего субъекта, зарегистрированного в Меркурии. Этот параметр содержится в письме с реквизитами доступа к Ветис.API. Чтобы не вводить 36-значную строку, можно так же воспользоваться генератором QR кодов и просканировать код сканером.
Логин и пароль — эти реквизиты нужно брать из подключения к Ветис.API, реквизиты доступа к веб-интерфейсу не подойдут! Будьте внимательны! Как их получить.
После того, как Вы ввели реквизиты, можно протестировать профиль, выполнив команду из меню вверху формы. Можно также сохранить профиль для того, чтобы вернуться к проверке позже. После успешной проверки в поле «Хозяйствующий субъект» появится название организации, который выданы реквизиты доступа к серверу Меркурия.
После тестирования и сохранения реквизитов, можно будет выбрать профиль из списка и добавить площадки для работы.
Что такое api key в меркурии
Зарегистрирован: 11/05/2017 09:25:20
Сообщений: 4872
Оффлайн
должно быть второе письмо, посмотрите в спаме на почтовом сервере
тех.поддержка 8 (4922) 52-99-29
кстати, и в боевом и в тесте у вас не прикреплена (не создана) площадка
Это сообщение было редактировано 2 раз. Последнее обновление произошло в 06/03/2020 14:11:26
Зарегистрирован: 06/03/2020 13:45:48
Сообщений: 4
Оффлайн
Подскажите пожалуйста как создать площадку? На /mercury.vetrf.ru/hs заходили по боевому логину/паролю.
 |
Зарегистрирован: 11/05/2017 09:25:20
Сообщений: 4872
Оффлайн
здесь https://нмз1.рф/merkurii есть ссылки на тестовый/боевой входы
Это сообщение было редактировано 1 раз. Последнее обновление произошло в 06/03/2020 15:01:50
Зарегистрирован: 06/03/2020 13:45:48
Сообщений: 4
Оффлайн
| |
Зарегистрирован: 06/03/2020 13:45:48
Сообщений: 4
Оффлайн
nmzn1 wrote: добрый
должно быть второе письмо, посмотрите в спаме на почтовом сервере
тех.поддержка 8 (4922) 52-99-29
кстати, и в боевом и в тесте у вас не прикреплена (не создана) площадка
Поддержка ФГИС «Меркурий» в «1С»
С 1 июля 2018 г. на территории РФ была введена обязательная регистрация информации о продуктах животного происхождения в Федеральной государственной системе «Меркурий» (далее ФГИС «Меркурий»). Подконтрольные товары данной категории должны быть зарегистрированы на всех контрольных точках производственного цикла, вплоть до момента приобретения конечным потребителем.
Решение от «1С» для работы с ФГИС
В типовых решениях «1С» для обмена с ФГИС «Меркурий» в основном используются четыре документа:
Для оформления продажи или перемещения подконтрольной продукции с оформлением транспортных ВСД предназначен документ «Исходящая транспортная операция ВЕТИС», так же, как и в предыдущем документе здесь реализована поддержка правил регионализации и перевозки, выполненные по одному договору, но разными видами транспорта.
Регистрация производственных ВСД на всех предполагаемых этапах (в том числе этап незавершенного производства), а также утилизация продукции производится посредством документа «Производственная операция ВЕТИС».
Инвентаризация продукции ВЕТИС отражает операции оприходования и списания продукции ВЕТИС.
Интеграционное решение также поддерживает полный функционал складского журнала, он предназначен для отслеживания информации о поступивших, реализуемых и производимых на производственной площадке подконтрольных продуктов. Складской журнал вдобавок содержит в себе список подконтрольной продукции, принадлежащей хозяйствующему субъекту (далее ХС). Записи складского журнала формируются в результате гашения ВСД, на продукты, которые поступают на склад предприятия-получателя.
Также решение производит автоматический обмен документами с ВЕТИС.
У хозяйствующего субъекта есть необходимость организовать транспортировку подконтрольной продукции по Приказу №648, то есть той продукции, которая требует оформления ВСД исключительно государственным ветеринарным врачом.
Подключение к ВЕТИС.API
Шаблон заявления на подключение к ВЕТИС
Подключение к «1С»
Для этого выполняем следующие действия:
Раздел «Настройка интеграции с ВЕТИС»
Далее происходит операция подключения, время выполнения которой зависит от количества ваших производственных площадок (с помощью которых производится реализация или же хранение продукции, магазин, склад и т.д.): чем их больше, тем дольше выполняется операция. После окончания процессов по подключению выводится окно с сообщением об успешном подключении и затем по нажатию кнопки «Закрыть» переходим в карточку хозяйствующего субъекта, в которую уже автоматически подтягивается информация из ВЕТИС о ваших производственных площадках, пользователях и правах, и другая служебная информация.
Также данную закладку можно открыть из панели «Обмен с ВЕТИС», которая доступна из таких разделов, как «Продажи», «Покупки», «Производство» и «Склад». В панели обмена разворачиваем закладку «Настройки и справочники», переходим по гиперссылке «Хозяйствующие субъекты ВЕТИС» и попадаем в список хозяйствующих субъектов.
Панель «Обмен с ВЕТИС»
В открывшейся форме хозяйствующего субъекта на закладке «Основное» необходимо сопоставить организацию из базы с организацией в ВЕТИС, затем в закладке «Предприятия» сопоставить площадки организации, и на закладке «Пользователи» – пользователей информационной базы с пользователями ВЕТИС. Сопоставление производится автоматически путем заполнения ИНН и КПП, а также может производится вручную при обращении к «Поиску в классификаторе».
Список хозяйствующих субъектов
Форма хозяйствующего субъекта
Условия работы с данными ВЕТИС
В начале работы через ВЕТИС.API в информационной базе «1С» необходимо внести в справочник номенклатуры соответствующие товары (подконтрольная продукция) для корректного обмена с ФГИС «Меркурий». Для этого в конфигурации внесена новая особенность учета «Подконтрольная продукция ВЕТИС», в соответствии с которой при внесении информации о данной продукции помимо единицы измерения (объем, вес, длина, штука, голова и т.д.) необходимо вводить ее соответствие единице объема (веса или длины). В ином случае система выдает ошибку обмена.
Например, в конфигурации «1С:Бухгалтерия 8» для того, чтобы вести учет подконтрольной продукции, в справочнике «Номенклатура» при создании новой номенклатурной позиции необходимо установить флажок «Ветеринарный контроль», что позволит сопоставить позиции номенклатуры в справочнике информационной базы «1С» и справочника «Продукция ВЕТИС».
Отображение свойства подконтрольной продукции в «1С:Бухгалтерии 8»
А в таком типовом решении, как «1С:ERP Управление предприятием 2», «Подконтрольная продукция ВЕТИС» является видом номенклатуры.
Схема работы с документами ВЕТИС
Для реализации обмена с ФГИС «Меркурий» на основании складских операций требуется создавать документ «Инвентаризация продукции ВЕТИС». Эту операцию имеют право оформлять пользователи, имеющие право на выполнение операций в ФГИС «Меркурий». «Инвентаризация продукции ВЕТИС» оформляется на основании таких документов, как оприходование и списание товаров, которые в свою очередь можно создать на основании документа инвентаризация товаров.
Для корректного ведения учета рекомендуется привести в соответствие остатки продукции в информационной базе «1С» и в ФГИС «Меркурий». Это не требование законодательства, а совет от разработчиков для облегчения работы пользователей.
На примере оприходования продукции рассмотрим процедуру оформления операции «Инвентаризация продукции ВЕТИС» в конфигурации «1С:Бухгалтерия 8». Допустим, при пересчете продукции у вас оказывается единица продукции, которую необходимо оприходовать. Вы создаете документ «Оприходование товаров» в учетной системе, после проведения которого, по нажатию кнопки в шапке формы «Выгрузить в ВЕТИС», создается операция «Инвентаризация продукции ВЕТИС». После ввода документа-основания автоматически заполняются необходимые реквизиты, при условии ведения на предприятии партионного учета.
Также, если продукция к оприходованию еще не была сопоставлена, то необходимо выбрать из классификатора ВЕТИС необходимую номенклатуру. В случае, если не была найдена нужная номенклатура, ее нужно создать и передать запрос в ВЕТИС, после обработки которого нужная вам продукция будет доступна к выбору. После чего необходимо указать причину несоответствия в «Акте несоответствия» и нажать на команду «Передайте данные» для осуществления обмена с ВЕТИС. Далее, при условии успешной обработки запроса статус документа «Инвентаризация продукции ВЕТИС» изменится на «Выполнен».
Отдельное внимание стоит уделить оформлению поступления подконтрольной продукции. На основании входящих ВСД, которые автоматически загружаются в базу «1С» Предприятия через обмен с ФГИС «Меркурий» создаются такие документы как, например, поступление товаров, возврат товаров от покупателя и т.д. Также именно этот документ отвечает за такой функционал, как гашение ВСД. То есть при оформлении входящей транспортной операции ВЕТИС на основании входящего ВСД автоматически происходит гашение ВСД после перехода по гиперссылке передайте данные в шапке формы. В следствие чего статус документа меняется на «ВСД погашены».
Порядок создания других операций ВЕТИС такой же. На основании документов учетной системы создаются документы ВЕТИС, которые обеспечивают обмен между базой «1С» и ФГИС «Меркурий» с помощью изменений записей складского журнала. В интеграционном решении предусмотрен и иной способ организации работы с документами посредством перехода из разделов прикладного решения, таких как «Продажи», «Покупки» и «Склад», сразу в панель «Обмен с ВЕТИС». Так на главной странице панели «Обмен с ВЕТИС» необходимые к отработке и оформлению документы отображаются соответствующими гиперссылками «Отработайте» и «Оформите».
Подсистема обработки заявок в Ветис.API
Содержание
Общие сведения
Это сервис для выполнения бизнес-операций в специализированных информационных системах Аргус, Меркурий, Веста и т.д. В подсистеме реализован сервис ApplicationManagementService суть работы которого заключается в приеме, авторизации и маршрутизации заявки к той или иной целевой специализированной информационной системе, получение и предоставление внешней системе результатов обработки заявки.
Принципы взаимодействия
Работа с сервисом ApplicationManagementService реализована по псевдо-асинхронному принципу и осуществляется в два шага (оба из которых выполняются синхронно):
Для данной схемы действуют следующие правила:
Предоставляемые сервисы
ApplicationManagementService является единой внешней точкой доступа ко всем внутренним бизнес-сервисам специализированных информационных систем. При обращении к ApplicationManagementService для маршрутизации заявки клиент в запросе должен указать идентификатор целевого внутреннего сервиса serviceId.
ApplicationManagementService предоставляет возможность обращения к следующим целевым сервисам (serviceId) специализированных информационных систем:
Безопасность
Также перед проверкой APIKey производится базовая аутентификация с помощью логина и пароля, предоставляемых в ответном письме при получении доступа.
Процесс авторизации при подключении к универсальному шлюзу «Ветис.API» описан здесь.
Бизнес-операции
Через «Ветис.API» реализована возможность подачи заявок на выполнение следующих операций:
Меркурий
Целевые сервисы mercury-g2b.service (для хозяйствующих субъектов) и mercury-vu.service (для ветеринарных управлений), набор операций в каждом сервисе совпадает.
Интеграция с государственной информационной системой «Маркировка товаров» (ГИС МТ)
Целевой сервис crpt-gateway.service
Возможные сценарии
При обработке запроса возможны следующие сценарии.
1. Запрос успешно обработан.
2. Произошла ошибка при обработке запроса.
На вход сервиса ApplicationManagementService передаются следующие сведения:
Результатом обработки заявки в заявочной системе является:
Для получения результата обработки заявки необходимо запросить результат по идентификатору заявки.
Используемые пространства имен и типы
Подача заявки
Данные запроса
Структура данных запроса в формате ХML.
Объект submitApplicationRequest
Заявка в единой заявочной системе на выполнение определенной операции, определяет пользователя, который инициирует запрос и содержит сведения самого запроса.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| apiKey | Специальный код, который идентифицирует учетную запись пользователя и позволяет веб-сервису получить доступ к информации о хозяйствующем субъекте и обслуживаемых предприятиях, к которым данный пользователь относится. | app:APIKey | 1 |
| application | Сведения о заявке. | app:application | 1 |
Объект submitApplicationRequest/application
Данные ответа
Структура данных запроса в формате ХML.
Объект submitApplicationResponse
Заявка в заявочной системе, содержит сведения запроса.
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| application | Сведения о заявке. | app:Application | 1 |
Объект submitApplicationResponse/application
| Поле | Описание | Тип | Обязательность |
|---|---|---|---|
| applicationId | Сгенерированный идентификатор заявки. | bs:UUID | 1 |
| status | Статус готовности результата. | app:ApplicationStatus | 1 |
| serviceId | Код запрашиваемого сервиса (системы, к которой обращается пользователь). | xs:NCName | 1 |
| issuerId | Идентификатор хозяйствующего субъекта от имени которого происходит обращение к Ветис.API. Указанный хозяйствующий субъект должен быть одним из хозяйствующих субъектов, обслуживаемых данной программной системой. Перечень обслуживаемых программной системой хозяйствующих субъектов устанавливается при предоставлении доступа к Ветис.API. | bs:UUID | 1 |
| issueDate | Дата и время обращения пользователя к заявочной системе. Устанавливается разработчиком клиентской системы. | xs:dateTime | 1 |
| rcvDate | Дата и время формирования результата. | xs:dateTime | 1 |
Получение результата обработки заявки
Данные запроса
Структура данных запроса в формате ХML.
Объект receiveApplicationResultRequest
Запрос на получение результатов обработки заявки.
Компонент Ветис.API
Содержание
Основное назначение
Универсальный шлюз Ветис.API предоставляет возможность сторонним информационным системам обмениваться информацией с компонентами Ветис для выполнения прикладных задач, получения справочной информации и сведений из реестров.
Цели создания
Использование/возможности
Взаимодействие с компонентом Меркурий
Ветис.API позволяет сторонним информационным системам передавать информацию, необходимую для формирования электронных ветеринарных сертификатов в компоненте Меркурий, получать информацию об оформленных электронных сертификатах из компонента Меркурий.
ApplicationManagementService предоставляет следующие операции: оформление производственной партии; оформление транспортной партии; оформление входящей партии; оформление результатов инвентаризации; объединение записей складского журнала; получение ВСД по его идентификатору; получение ВСД, созданных или измененных за указанный интервал дат (получение истории изменений); получение всех ВСД предприятия с возможностью фильтрации; получение конкретной версии записи складского журнала по ее идентификатору; получение последней (актуальной) версии записи складского журнала по ее идентификатору; получение всех версий записи складского журнала по ее идентификатору; получение актуального списка записей журнала; получение списка версий записей журнала, созданных или измененных за указанный интервал дат (получение истории изменений); добавление/изменение сведений о хозяйствующем субъекте; добавление/изменение сведений о поднадзорном объекте; аннулирование ВСД; создание/удаление связи с площадкой; добавление номенклатуры производителя в справочник.
Подробное описание предоставляемых бизнес-операций можно найти в статье «Подсистема обработки заявок в Ветис.API» / «Меркурий».
Взаимодействие с компонентом Цербер
EnterpriseService позволяет обмениваться информацией с реестром хозяйствующих субъектов и поднадзорных объектов.
Сервис предоставляет следующие операции: Получение списка ХС, Получение объекта ХС по его глобальному идентификатору, Получение записи ХС по ее идентификатору, Получение истории изменений списка ХС, Получение списка зарубежных предприятий, Получение списка российских предприятий, Получение записи предприятия по его глобальному идентификатору, Получение записи предприятия по ее идентификатору, Получение истории изменений списка зарубежных предприятий, Получение истории изменений списка российских предприятий.
Взаимодействие с компонентом Икар
IkarService позволяет получать информацию из единого хранилища адресных данных, которые используются в информационных системах Россельхознадзора.
Сервис предоставляет следующие операции: Получение списка стран, Получение объекта страны по его глобальному идентификатору, Получение записи страны по ее идентификатору, Получение истории изменений списка стран, Получение списка регионов по стране, Получение объекта региона по его глобальному идентификатору, Получение записи региона по ее идентификатору, Получение истории изменений списка регионов, Получение списка районов по региону, Получение объекта района по его глобальному идентификатору, Получение истории изменений списка районов.
Структура
Шлюз состоит из двух подсистем:
Подсистема обработки заявок
Это сервис для выполнения бизнес-операций в специализированных компонентах Аргус, Меркурий, Веста и т.д. В подсистеме реализован сервис ApplicationManagementService суть работы которого заключается в приеме, авторизации и маршрутизации заявки к тому или иному целевому специализированному компоненту. Работа с этим сервисом реализована по псевдо-асинхронному принципу и осуществляется в два шага:
1 шаг – подача заявки на выполнение бизнес-операции, получение результата приема заявки (выполняется синхронно);
2 шаг – подача запроса на получение результатов обработки заявки/выполнения бизнес-операции (выполняется синхронно).
Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье Подсистема обработки заявок в Ветис.API.
Сервис обработки заявок для хозяйствующих субъектов
Сервис обработки заявок для ветеринарных управлений
| Версия | Продуктивный контур | Тестовый контур |
|---|---|---|
| v1.4 | WSDL: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_production.wsdl Описание типов заявок: http://api.vetrf.ru/schema/platform/mercury/vu/applications_v1.4.xsd | WSDL: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_pilot.wsdl Описание типов заявок: http://api.vetrf.ru/schema/platform/mercury/vu/applications_v1.4.xsd |
| v2.0 | WSDL: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-vu.service_v2.0_production.wsdl Описание типов заявок: включено в WSDL | WSDL: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-vu.service_v2.0_pilot.wsdl Описание типов заявок: включено в WSDL |
| v2.1 | WSDL: недоступно | WSDL: недоступно |
Сервис интеграции с государственной информационной системой «Маркировка товаров» (ГИС МТ)
| Версия | Продуктивный контур | Тестовый контур |
|---|---|---|
| v1.0 | WSDL: недоступно Описание типов заявок: недоступно ServiceId: недоступно URL точки доступа: недоступно | WSDL: https://api.vetrf.ru/schema/platform/crptgw/v1.0.0-crpt-latest/ams-crpt-gateway.service_v1.0_pilot.wsdl Описание типов заявок: включено в WSDL ServiceId: crpt-gateway.service URL точки доступа: https://api2.vetrf.ru:8002/platform/services/2.0/ApplicationManagementService |
Подсистема работы со справочниками и реестрами
Это группа сервисов предназначена для работы со справочниками и реестрами, использующимися в Ветис.
Подробно форматы запросов для обращения к справочникам и реестрам Ветис описаны в статье Подсистема работы со справочниками и реестрами в Ветис.API.
Ветис.API 2.1
Продуктивный контур
Тестовый контур
Ветис.API 2.0
Продуктивный контур
Тестовый контур
Изменения в XSD-схемах для версии 2.1 по сравнению с версией 2.0
Предоставление доступа
Доступ к ВетИС.API предоставляется в два этапа:
Первый этап — предоставление доступа к тестовой версии ВетИС.API для разработки и отладки; Второй этап — предоставление доступа к продуктивной версии ВетИС.API.
Процедура предоставления доступа к ВетИС следующая:
С чего начать
ECR-Russia и лично координатор данной организации по вопросам, связанным с оформлением электронных ВСД, Юрий Кумпан, подготовил документ, который содержит практические шаги по реализации интеграционного проекта учетной системы предприятия с ФГИС «Меркурий», называется он «Первые шаги в проектах интеграции с ФГИС Меркурий».
Обновление компонента
Планируемые функции
С предложениями по развитию Ветис.API обращайтесь по электронной почте на адрес api@vetrf.ru или на специализированный форум системы.
Предварительный список изменений для версии 6.7 и версии 2.1 интеграционного шлюза
С выходом обновления 6.7 появятся значительные изменения, связанные с контролем маркировки продукции и сведениями о происхождении продукции. С предварительным списком и описанием изменений можно ознакомиться здесь.
Сопровождение и поддержка
По техническим вопросам, связанным с использованием Ветис.API, обращайтесь по электронной почте на адрес api@vetrf.ru.
При наличии технической проблемы опишите в письме ее суть, приложите примеры SOAP-запросов и ответов. Свои предложения и пожелания по разработке Ветис.API вы можете также направлять по данному адресу.
