Что такое ветис api
Часто задаваемые вопросы по Ветис.API
Содержание
Часто задаваемые вопросы
Общие вопросы.
Остаётся ли доступ на тестовый сервер при переходе на продуктивную версию?
Да, остаётся. Доступ на тест не ограничивается после перехода на продуктивную версию и не ограничивается с течением времени.
Входят ли в цепочку прослеживаемости производственные сертификаты?
Нет, не входят. На данный момент в Меркурии реализована низкая система прослеживаемости. Это значит, что в цепочке прослеживаемости участвуют только транспортные сертификаты. Они же могут быть просмотрены через публичную часть Меркурия.
Должны ли отображаться 7-9-значные номера в запросах и ответах сервиса?
Нет, не должны. Уникальным номером ветеринарного сертификата является 36-значный код. Именно он однозначно определяет документ, 7-9-значные номера были введены исключительно с целью удобства чтения людьми.
Возможна ли групповая отправка заявок?
Для версии 1.4 такое невозможно.
Откуда берутся данные о враче или уполномоченном лице в ветеринарном сертификате, оформленном через шлюз?
Данные получаются из системы Ветис.Паспорт и зависят от того, на сколько заполнен там профиль пользователя, логин которого указан в поле initiator в запросе.
Совпадают ли идентификаторы записей на тестовом и боевом сервере?
Нет, не совпадают. Мы настоятельно рекомендуем использовать тестовый сервер именно как тестовый, не привязывая большое количество продукции и не создавая большое количество предприятий. Справочники после перехода на бой придётся обновлять.
Нет, не синхронизируются и их синхронизация не планируется из-за различия в идентификаторах сущностей.
Чем различаются guid и uuid?
Можно ли получить номер предприятия в реестре Россельхознадзора через Ветис.API?
Нет, нельзя. Через сервисы передаётся только guid. Поиск предприятий мы рекомендуем осуществлять по названию или его части и адресу.
Есть ли ограничение на количество запросов к серверу через API?
Да, сейчас установлено ограничение не более 5 запросов в секунду. То есть в течение одной секунды пользователь может отправить только 5 запросов, при отправке шестого в ответ он получит отказ (ошибка 429). При этом нет разницы, последовательно или параллельно вы отправляете запросы.
Поле owner у предприятия. Это тот хозяйствующий субъект, который к нему привязан?
Чем отличаются пользователи ХС и пользователи ГВЭ? Будет ли на продуктивном сервере предоставлен логин пользователю к веб-интерфейсу Аргус.ВУ и Меркурий.ГВЭ?
Пользователь хозяйствующего субъекта может гасить ветеринарные сертификаты, создавать возвратные ВСД и оформлять ВСД на продукцию из перечня приказа МСХ №646. Возможности пользователя зависят от назначенных ему прав в системе Ветис.Паспорт. По умолчанию при регистрации на тестовом сервере пользователю ХС назначаются права на гашение ВСД, на оформление возвратных и производственных ВСД, а также права уполномоченного лица, чтобы была возможность оформлять ВСД на продукцию из перечня приказа МСХ №646. Процедура регистрации на продуктивный сервер описана тут.
Права пользователя ветеринарного управления на тестовом сервере могут быть назначены по отдельному письму. На продуктивный сервер такие права предоставляются исключительно сотрудникам госветслужбы.
Гашение ветеринарных сертификатов (IncomingOperation)
Можно ли при гашении ВСД указать несколько партий продукции?
Нет, нельзя. В одной заявке можно гасить только один ВСД, вне зависимости от того, электронный он или бумажный.
Оформление производственной партии
Можно ли объединять производственные партии?
В текущей версии 1.4 этого делать нельзя. Однако, в этой версии реализована операция незавершённого производства, с помощью которой можно выпустить несколько партий продукции в течение определённого времени, на которую будет выписан один ветеринарный сертификат и создана одна запись складского журнала. Списание сырья произойдёт с указанных в запросе записей.
Оформление транспортного сертификата (TransportOperation)
Можно ли отправить в одном запросе на транспортную операцию несколько партий?
Можно, если эти несколько партий отправляются одному и тому же получателю. Нескольким получателям одним запросом отправить партии продукции не получится. При отправке нескольких партий продукции получателю в ответе вернётся несколько ВСД, оформленных на продукцию, и несколько изменённых записей журнала.
Как отображается маркировка, передаваемая через шлюз?
Маркировка, согласно требованиям должна отображаться:
Аннулирование ветеринарных сертификатов
Почему при аннулировании не возвращаются данные об обновлённой записи?
На данный момент это не реализовано. Предполагается, что пользователь будет хранить самостоятельно связь между идентификатором записи журнала и ветеринарным сертификатом. Предполагается реализовать этот функционал в версии 2.0
Подсистема обработки заявок в Ветис.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 Backlog v3.x
Преследуемые цели и задачи для версии 3.х
Возможность частичного гашения сертификатов с СВХ с указанием номенклатуры (productItem) аналогично функционалу веб-интерфейса.
Возможность заполнить номера транспортных средств в запросе на гашение ВСД (в том числе пакетном).
Реализация механизма оповещений отправителю о составлении актов несоответствия получателем ВСД при гашении.
Сохранение при оформлении в возвратный ВСД ссылки на исходный сертификат, по которому оформляется возврат.
Возможность указать причину возврата продукции при оформлении возвратного ВСД.
Рассматривается возможность реализации сценария отклонения входящего ВСД получателем в случае отсутствия реальной поставки, когда отправитель по каким-либо причинам не аннулирует такой ВСД.
Расширение сценариев производственной операции для отражения различных технологических процессов с фиксацией роли каждого из производителей или обработчиков продукции. В частности:
Расширение сценариев оформления транспортных сертификатов при экспорте продукции для перемещения грузов по территории РФ до пунктов пропуска.
Рассматривается возможность расширения состава полей для передачи сведений о согласованных между отправителем и получателем наименований продукции.
Возможность получения информации о составленных актах несоответствия при гашении ВСД и инвентаризации.
Рассматривается возможность реализации операции получения списка идентификаторов ВСД, оформленных по заданной(-ым) записи(-ям) журнала.
Возможность регистрации площадок для хозяйствующих субъектов будет закрыта. Все регистрационные действия будут осуществляться только через систему «Цербер» сотрудниками ТУ/ВУ регионов.
Ограничение задокументированным максимальным порогом всех сущностей системы, принимающих множество значений [0..*].
Реализация операции получения любого сертификата по идентификатору через сервис аналогично публичной части системы Меркурий с сокращённым набором полей.
Получение в операциях сервиса информации о статусе синхронизации информации о хозяйствующем субъекте с сервисом ФНС.
Добавление атрибутов id и qualifier в запросе и ответе для записей журнала для сопоставления записей в запросе и ответе, а также для возврата сообщений об ошибках для конкретных записей журнала.
Добавление типа документа «Акт возврата товара поставщику» в перечень типов связанных документов.
Поддержка ФГИС «Меркурий» в «1С»
С 1 июля 2018 г. на территории РФ была введена обязательная регистрация информации о продуктах животного происхождения в Федеральной государственной системе «Меркурий» (далее ФГИС «Меркурий»). Подконтрольные товары данной категории должны быть зарегистрированы на всех контрольных точках производственного цикла, вплоть до момента приобретения конечным потребителем.
Решение от «1С» для работы с ФГИС
В типовых решениях «1С» для обмена с ФГИС «Меркурий» в основном используются четыре документа:
Для оформления продажи или перемещения подконтрольной продукции с оформлением транспортных ВСД предназначен документ «Исходящая транспортная операция ВЕТИС», так же, как и в предыдущем документе здесь реализована поддержка правил регионализации и перевозки, выполненные по одному договору, но разными видами транспорта.
Регистрация производственных ВСД на всех предполагаемых этапах (в том числе этап незавершенного производства), а также утилизация продукции производится посредством документа «Производственная операция ВЕТИС».
Инвентаризация продукции ВЕТИС отражает операции оприходования и списания продукции ВЕТИС.
Интеграционное решение также поддерживает полный функционал складского журнала, он предназначен для отслеживания информации о поступивших, реализуемых и производимых на производственной площадке подконтрольных продуктов. Складской журнал вдобавок содержит в себе список подконтрольной продукции, принадлежащей хозяйствующему субъекту (далее ХС). Записи складского журнала формируются в результате гашения ВСД, на продукты, которые поступают на склад предприятия-получателя.
Также решение производит автоматический обмен документами с ВЕТИС.
У хозяйствующего субъекта есть необходимость организовать транспортировку подконтрольной продукции по Приказу №648, то есть той продукции, которая требует оформления ВСД исключительно государственным ветеринарным врачом.
Подключение к ВЕТИС.API
Шаблон заявления на подключение к ВЕТИС
Подключение к «1С»
Для этого выполняем следующие действия:
Раздел «Настройка интеграции с ВЕТИС»
Далее происходит операция подключения, время выполнения которой зависит от количества ваших производственных площадок (с помощью которых производится реализация или же хранение продукции, магазин, склад и т.д.): чем их больше, тем дольше выполняется операция. После окончания процессов по подключению выводится окно с сообщением об успешном подключении и затем по нажатию кнопки «Закрыть» переходим в карточку хозяйствующего субъекта, в которую уже автоматически подтягивается информация из ВЕТИС о ваших производственных площадках, пользователях и правах, и другая служебная информация.
Также данную закладку можно открыть из панели «Обмен с ВЕТИС», которая доступна из таких разделов, как «Продажи», «Покупки», «Производство» и «Склад». В панели обмена разворачиваем закладку «Настройки и справочники», переходим по гиперссылке «Хозяйствующие субъекты ВЕТИС» и попадаем в список хозяйствующих субъектов.
Панель «Обмен с ВЕТИС»
В открывшейся форме хозяйствующего субъекта на закладке «Основное» необходимо сопоставить организацию из базы с организацией в ВЕТИС, затем в закладке «Предприятия» сопоставить площадки организации, и на закладке «Пользователи» – пользователей информационной базы с пользователями ВЕТИС. Сопоставление производится автоматически путем заполнения ИНН и КПП, а также может производится вручную при обращении к «Поиску в классификаторе».
Список хозяйствующих субъектов
Форма хозяйствующего субъекта
Условия работы с данными ВЕТИС
В начале работы через ВЕТИС.API в информационной базе «1С» необходимо внести в справочник номенклатуры соответствующие товары (подконтрольная продукция) для корректного обмена с ФГИС «Меркурий». Для этого в конфигурации внесена новая особенность учета «Подконтрольная продукция ВЕТИС», в соответствии с которой при внесении информации о данной продукции помимо единицы измерения (объем, вес, длина, штука, голова и т.д.) необходимо вводить ее соответствие единице объема (веса или длины). В ином случае система выдает ошибку обмена.
Например, в конфигурации «1С:Бухгалтерия 8» для того, чтобы вести учет подконтрольной продукции, в справочнике «Номенклатура» при создании новой номенклатурной позиции необходимо установить флажок «Ветеринарный контроль», что позволит сопоставить позиции номенклатуры в справочнике информационной базы «1С» и справочника «Продукция ВЕТИС».
Отображение свойства подконтрольной продукции в «1С:Бухгалтерии 8»
А в таком типовом решении, как «1С:ERP Управление предприятием 2», «Подконтрольная продукция ВЕТИС» является видом номенклатуры.
Схема работы с документами ВЕТИС
Для реализации обмена с ФГИС «Меркурий» на основании складских операций требуется создавать документ «Инвентаризация продукции ВЕТИС». Эту операцию имеют право оформлять пользователи, имеющие право на выполнение операций в ФГИС «Меркурий». «Инвентаризация продукции ВЕТИС» оформляется на основании таких документов, как оприходование и списание товаров, которые в свою очередь можно создать на основании документа инвентаризация товаров.
Для корректного ведения учета рекомендуется привести в соответствие остатки продукции в информационной базе «1С» и в ФГИС «Меркурий». Это не требование законодательства, а совет от разработчиков для облегчения работы пользователей.
На примере оприходования продукции рассмотрим процедуру оформления операции «Инвентаризация продукции ВЕТИС» в конфигурации «1С:Бухгалтерия 8». Допустим, при пересчете продукции у вас оказывается единица продукции, которую необходимо оприходовать. Вы создаете документ «Оприходование товаров» в учетной системе, после проведения которого, по нажатию кнопки в шапке формы «Выгрузить в ВЕТИС», создается операция «Инвентаризация продукции ВЕТИС». После ввода документа-основания автоматически заполняются необходимые реквизиты, при условии ведения на предприятии партионного учета.
Также, если продукция к оприходованию еще не была сопоставлена, то необходимо выбрать из классификатора ВЕТИС необходимую номенклатуру. В случае, если не была найдена нужная номенклатура, ее нужно создать и передать запрос в ВЕТИС, после обработки которого нужная вам продукция будет доступна к выбору. После чего необходимо указать причину несоответствия в «Акте несоответствия» и нажать на команду «Передайте данные» для осуществления обмена с ВЕТИС. Далее, при условии успешной обработки запроса статус документа «Инвентаризация продукции ВЕТИС» изменится на «Выполнен».
Отдельное внимание стоит уделить оформлению поступления подконтрольной продукции. На основании входящих ВСД, которые автоматически загружаются в базу «1С» Предприятия через обмен с ФГИС «Меркурий» создаются такие документы как, например, поступление товаров, возврат товаров от покупателя и т.д. Также именно этот документ отвечает за такой функционал, как гашение ВСД. То есть при оформлении входящей транспортной операции ВЕТИС на основании входящего ВСД автоматически происходит гашение ВСД после перехода по гиперссылке передайте данные в шапке формы. В следствие чего статус документа меняется на «ВСД погашены».
Порядок создания других операций ВЕТИС такой же. На основании документов учетной системы создаются документы ВЕТИС, которые обеспечивают обмен между базой «1С» и ФГИС «Меркурий» с помощью изменений записей складского журнала. В интеграционном решении предусмотрен и иной способ организации работы с документами посредством перехода из разделов прикладного решения, таких как «Продажи», «Покупки» и «Склад», сразу в панель «Обмен с ВЕТИС». Так на главной странице панели «Обмен с ВЕТИС» необходимые к отработке и оформлению документы отображаются соответствующими гиперссылками «Отработайте» и «Оформите».
Как быстро зарегистрироваться в ВетИС.API
Общая схема подключения к системе ВетИС
Система по контролю в области ветеринарной продукции ВетИС функционирует уже довольно давно (с 2012 года). Претерпевала множество изменений, но даже в текущем доработанном виде, она все еще не так проста. Это касается и самой работы с системой, но, что странно, в большей степени в регистрации. Если изложить процесс регистрации в системе ВетИС, то он выглядит в следующим образом:
Всего 3 шага, кажется легко и просто, но, когда дело доходит до реализации все перестает выглядеть так радужно, однако ситуация не является безвыходной, а временные издержки можно существенно сократить. Далее обо всем по порядку.
Радости работы в тестовом контуре ВетИС.API
Начнем с того, что рассмотрение самого заявления занимает порядка 5 рабочих дней. После этого вы получите данные для подключения ВетИС API к вашей товароучетной программе. Поскольку контур тестовый, вам нужно будет самостоятельно настроить пользователей, создать площадки, товарные позиции и т.д. Несмотря на то, что вы можете делать в этом контуре делать, что угодно разобраться в нем с «наскока» не выйдет. Если вы решите делать это самостоятельно, то это также может занять значительное время (около 1 дня). Квалифицированный специалист выполнит эту задачу намного быстрее (около 1-2 часов). В случае, если вы не выполните требования по работе с тестовым контуром и подадите заявку на продуктивный контур, то доступ не получите, а только лишь потеряете порядка 5 дней на ожидание рассмотрения заявки. В итоге вы получите сообщение от ВетИС следующего содержания:
К сожалению, Ваша заявка номер 00-АА/12345 на предоставление доступа к системе Ветис.API для ХС с ИНН 1234567890 не может быть одобрена по следующей причине:
К сожалению, вы не вели деятельность на тестовом сервере. Согласно регламенту http://help.vetrf.ru/wiki/Ветис.API и новости http://fsvps.ru/fsvps/news/29246.html, хозяйствующие субъекты должны отработать свои бизнес-процессы на тестовом сервере прежде, чем переходить на рабочий. Поэтому мы рекомендуем оформить хотя бы 10 транспортных ВСД на тестовом сервисе, а также научиться работать с остальными нужными вам методами ВетИС.API, такими как загрузка списка ветеринарных сертификатов, загрузка списка записей журнала, производственные ВСД (если требуется по вашим процессам), гашение ВСД, инвентаризация. Заявление оформлено не по образцу
По всем возникшим вопросам Вы можете обратиться по адресу api@vetrf.ru, обязательно указав при этом номер заявки 00-АА/12345.
Письмо сгенерировано автоматически и не требует ответ».
Таким образом, для выполнения всех требований ВетИС, необходимо договориться с поставщиком, чтобы он отгрузил вам в тестовом режиме товары, вы их приняли, погасили эВСД, проверили инвентаризацию, оформили возвраты и это далеко не полный перечень операций, который нужно совершить. Кроме операций приемки, вам необходимо также произвести отправку продукции, т.е. выступить в роли поставщика. Только в случае выполнения всех операций, ваш опыт использования тестового контура будет считаться успешным.
Как итог вам придется потратить порядка полутора недель, чтобы дойти до возможно только подать заявление на продуктовую версию ВетИС.API. И все еще сохраняется риск, что где-то будет допущена неточность и вы получите отказ.
Что можно сделать, чтобы не тратить такое количество времени?
Время дорого и его всегда не хватает. Есть несколько способов существенно ускорить процесс подключения к системе ВетИС.