Часто задаваемые вопросы по Ветис.API
Часто задаваемые вопросы
Общие вопросы.
Остаётся ли доступ на тестовый сервер при переходе на продуктивную версию?
Да, остаётся. Доступ на тест не ограничивается после перехода на продуктивную версию и не ограничивается с течением времени.
Входят ли в цепочку прослеживаемости производственные сертификаты?
Нет, не входят. На данный момент в Меркурии реализована низкая система прослеживаемости. Это значит, что в цепочке прослеживаемости участвуют только транспортные сертификаты. Они же могут быть просмотрены через публичную часть Меркурия.
- Для продуктивного сервера это http://mercury.vetrf.ru/pub
- Для тестового http://t2-mercury.vetrf.ru/pub
Должны ли отображаться 7-9-значные номера в запросах и ответах сервиса?
Нет, не должны. Уникальным номером ветеринарного сертификата является 36-значный код. Именно он однозначно определяет документ, 7-9-значные номера были введены исключительно с целью удобства чтения людьми.
Возможна ли групповая отправка заявок?
Для версии 1.4 такое невозможно.
Откуда берутся данные о враче или уполномоченном лице в ветеринарном сертификате, оформленном через шлюз?
Данные получаются из системы Ветис.Паспорт и зависят от того, на сколько заполнен там профиль пользователя, логин которого указан в поле initiator в запросе.
Совпадают ли идентификаторы записей на тестовом и боевом сервере?
Нет, не совпадают. Мы настоятельно рекомендуем использовать тестовый сервер именно как тестовый, не привязывая большое количество продукции и не создавая большое количество предприятий. Справочники после перехода на бой придётся обновлять.
Синхронизируются ли боевая и тестовая версии?
Нет, не синхронизируются и их синхронизация не планируется из-за различия в идентификаторах сущностей.
Чем различаются guid и uuid?
GUID - глобальный идентификатор, который не изменяется на протяжении всего жизненного цикла сущности. UUID - идентификатор версии записи. Он меняется при очередном изменении сущности.
Можно ли получить номер предприятия в реестре Россельхознадзора через Ветис.API?
Нет, нельзя. Через сервисы передаётся только guid. Поиск предприятий мы рекомендуем осуществлять по названию или его части и адресу.
Есть ли ограничение на количество запросов к серверу через API?
Да, сейчас установлено ограничение не более 5 запросов в секунду. То есть в течение одной секунды пользователь может отправить только 5 запросов, при отправке шестого в ответ он получит отказ (ошибка 429). При этом нет разницы, последовательно или параллельно вы отправляете запросы.
Поле owner у предприятия. Это тот хозяйствующий субъект, который к нему привязан?
Нет, необязательно. В общем случае владелец предприятия может быть и не указан (например, если он не хочет регистрироваться в базе системы Цербер). Либо он может быть указан, но не вести деятельность на предприятии. По сути владелец - это необязательная информация и указывается дополнительно только через api-интерфейс. Чтобы связать предприятие
Чем отличаются пользователи ХС и пользователи ГВЭ? Будет ли на продуктивном сервере предоставлен логин пользователю к веб-интерфейсу Аргус.ВУ и Меркурий.ГВЭ?
Пользователь хозяйствующего субъекта может гасить ветеринарные сертификаты, создавать возвратные ВСД и оформлять ВСД на продукцию из перечня приказа МСХ №646. Возможности пользователя зависят от назначенных ему прав в системе Ветис.Паспорт. По умолчанию при регистрации на тестовом сервере пользователю ХС назначаются права на гашение ВСД, на оформление возвратных и производственных ВСД, а также права уполномоченного лица, чтобы была возможность оформлять ВСД на продукцию из перечня приказа МСХ №646. Процедура регистрации на продуктивный сервер описана тут.
Права пользователя ветеринарного управления на тестовом сервере могут быть назначены по отдельному письму. На продуктивный сервер такие права предоставляются исключительно сотрудникам госветслужбы.
Гашение ветеринарных сертификатов (IncomingOperation)
Можно ли при гашении ВСД указать несколько партий продукции?
Нет, нельзя. В одной заявке можно гасить только один ВСД, вне зависимости от того, электронный он или бумажный.
Оформление производственной партии
Можно ли объединять производственные партии?
В текущей версии 1.4 этого делать нельзя. Однако, в этой версии реализована операция незавершённого производства, с помощью которой можно выпустить несколько партий продукции в течение определённого времени, на которую будет выписан один ветеринарный сертификат и создана одна запись складского журнала. Списание сырья произойдёт с указанных в запросе записей.
Оформление транспортного сертификата (TransportOperation)
Можно ли отправить в одном запросе на транспортную операцию несколько партий?
Можно, если эти несколько партий отправляются одному и тому же получателю. Нескольким получателям одним запросом отправить партии продукции не получится. При отправке нескольких партий продукции получателю в ответе вернётся несколько ВСД, оформленных на продукцию, и несколько изменённых записей журнала.
Как отображается маркировка, передаваемая через шлюз?
Маркировка, согласно требованиям должна отображаться:
- у записей журнала вырабатываемой продукции;
- в производственном сертификате;
- в транспортном сертификате на выработанную продукцию.
Аннулирование ветеринарных сертификатов
Почему при аннулировании не возвращаются данные об обновлённой записи?
На данный момент это не реализовано. Предполагается, что пользователь будет хранить самостоятельно связь между идентификатором записи журнала и ветеринарным сертификатом. Предполагается реализовать этот функционал в версии 2.0
