GetVetDocumentByUuidOperation: различия между версиями

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 120: Строка 120:
|}
|}


 
===Пример заполнения таблицы===


{| class="wikitable"
{| class="wikitable"

Версия 16:00, 7 июля 2017

Общие сведения

Операция GetVetDocumentByUuidOperation предназначена для получения ветеринарно-сопроводительного документа (ВСД) по его уникальному идентификатору. На вход системы передаются следующие сведения:

  • информация о пользователе - инициаторе запроса;
  • идентификатор ВСД.

Результатом выполнения данной операции является:

  • пользователю передаются сведения о запрашиваемом ВСД.

Запрашиваться могут только те ВСД, которые ветеринарное управление инициатор оформило. Если запрос оформляется от имени предприятия, то ему могут быть доступны только его собственные входящие, исходящие и производственные сертификаты.

Возможные сценарии

При обработке запроса возможны следующие сценарии:

  1. Запрос успешно обработан.
  2. Произошла ошибка при обработке запроса.
  • Некорректный запрос.
  • Внутренняя ошибка системы.

Используемые пространства имён и типы

Общие отличия между версией для хозяйствующих субъектов и ветеринарных управлений

Различающиеся параметры Версия для хозяйствующих субъектов Версия для ветеринарных управлений
Пространство имён merc:http://api.vetrf.ru/schema/cdm/mercury/applications mercvu:http://api.vetrf.ru/schema/cdm/mercury/vu/applications
Имя сервиса mercury-g2b.service mercury-vu.service

Данные запроса

Объект getVetDocumentByUuidRequest

Корневой элемент содержимого заявки на получение ВСД по идентификатору.

Поле Описание Тип Обязательность
localTransactionId Идентификатор заявки в клиентской системе. xs:NCName 1
initiator Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт. argc:User 1
UUID Идентификатор ВСД. bs:UUID 1
enterpriseGuid Идентификатор предприятия, для которого запрошен ВСД. bs:UUID 1 - обязателен для ХС. При запросе от ВУ не требуется.

Пример заполнения таблицы

# Название XML-элемента Тип Кардинальность Возможные значения Описание Пример
001 <DOCUMENT> [1..1]
002    <METADATA> [1..1] Метаданные документа-выгрузки
003       <ID> Строка [1..1] Идентификатор документа-выгрузки A00001
004       <VERSION> Строка [1..1] Версия документа 1
005       <VERSION> Дата и время [1..1] Дата и время формирования документа. Указывается с временной зоной. 2017-12-31T23:59:59+03:00
006       <ORG> [1..1] Организация, сформировавшая выгрузку. ГК “Мясные продукты”
007          <INN> Строка [1..1] ИНН организации. Формат 10 (ЮЛ) или 12 (ИП) цифр 123456789012
008          <OGRN> Строка [1..1] ОГРН организации. Формат 13 цифр 1234567890123
009          <NAME> Строка [1..1] Полное наименование организации ООО “ГК “Мясные продукты”
010          <ADDR> Строка [1..1] Юридический адрес 600000, Российская Федерация, Владимирская область, г. Владимир, мкр. Юрьевец, ул. Институтский городок, д. 33, оф. 16
011       </ORG>
012       <CONTACT> [1..1] Контакты специалиста, ответственного за формирование выгрузки
013          <FIO> Строка [1..1] ФИО специалиста Иванов Сергей Игоревич
014          <POST> Строка [1..1] Должность специалиста Начальник ИТ
015          <PHONE> Строка [1..1] Контактный телефон. Формат: 10 цифр 9109071234
016          <EMAIL> Строка [1..1] Адрес электронной почты ivanov.ci@gkmyasprod.ru
017       </CONTACT>
018    </METADATA>
019    <BELIST> Список [0..1] Необязательный список хозяйствующих субъектов. Здесь могут быть перечислены все Хсы, встречающиеся далее в списке предприятий в качестве атрибутов (собственник площадки, ХС, осуществляющий деятельность на площадке). Сведения о ХСе могут быть указаны также и в качестве атрибута площадки. Вынос этих сведений в список BELIST необходим для избавления от возможного дублирования. В этом случае в соответствующем атрибуте площадки указывается только идентификатор ХСа из списка BELIST.
020       <BE seqnum="1"> [0..*] Объект, содержащий сведения о хозяйствующем субъекте: юридическом лице, ИП или физ.лице. В атрибуте seqnum указывается порядковый номер Хcа в списке BELIST.
021          <ID class="INN"> Строка [1..*] Class = INNClass = KPPClass = OGRNClass = GLNClass = SNILSClass = PASSClass = MGUIDClass = CGUID Идентификатор ХСа: ИНН, ОГРН, КПП, GLN, СНИЛС, номер паспорта. Элемент ID может повторяться несколько раз с разным значением атрибута class, в котором указывается тип идентификатора. Для юридического лица обязательно должны быть указаны ИНН, ОГРН и КПП; для ИП обязательны ИНН и ОГРНИП; для физического лица указывается СНИЛС и/или номер паспорта.Также в качестве идентификатора хоз.субъекта может быть указан GUID из реестра ИС Меркурий или ИС Цербер. <ID class=”INN”>1234567890</ID><ID class=”OGRN”>1234567890123</ID>
022          <NAME> Строка [1..1] Наименование хозяйствующего субъекта для юридического лица и ИП. Указывается наименование без организационно-правовой формы, возможны сокращения. ГК “Мясные продукты”
023          <TYPE> [1..1] Тип хозяйствующиего субъекта: юридическое лицо (в т.ч. ИП) или физ.лицо
024             <ID> Строка [1..1] UL – юр.лицоFL – физ.лицо Идентификатор типа хоз.субъекта UL
025             <NAME> [0..1] Необязательное наименование типа хоз.субъекта Юридическое лицо
026          </TYPE>
027          <INCFORM> [0..1] Организационно-правовая форма, элемент обязателен для юридического лица, в т.ч. индивидуального предпринимателя. Для физ.лица не указывается.
028             <ID class="OKOPF"> Строка [1..1] Class = OKOPF Код ОПФ в соответствии с ОКОПФ с учетом изменения № 2/2014 ОКОПФ, утверждено Приказом Росстандарта № 2011-ст от 12.12.2014, действует с 01.01.2015. Значение по умолчанию для атрибута class – OKOPF, может быть не указано. <ID>12300</ID>
029             <NAME> Необязательное наименование организационно-правовой формы Общества с ограниченной ответственностью
030          </INCFORM>
031          <FULLNAME> Строка [0..1] Полное наименование хозяйствующего субъекта. Элемент обязателен для юридического лица, в т.ч. ИП. Для физ.лица не указывается. Общество с ограниченной ответственностью “Группа компаний “Мясные продукты”
032          <FIO> Строка [0..1] ФИО физического лица. Поле не указывается для юр.лиц Сергеев Иван Федорович
033          <ADDR> Юридический адрес хозяйствующего субъекта в соответствии с административно-территориальным делением. Наряду с идентификаторами ИС Икар и ФИАС для элементов адреса может быть указан код ОКАТО.
034             <COUNTRY> [1..1] Страна
035                <ID class="ALPHA"> Строка [1..*] Class = ALPHAClass = IKAR Двухбуквенный код (alpha 2) страны в соответствии с ISO-3166 (class = ALPHA) или идентификатора ИС Икар (class = IKAR). Допускается указание только идентификатора России. Значение по умолчанию для атрибута class – ALPHA. <ID>RU</ID>
036                <NAME> Строка [0..1] Необязательное наименование страны Российская Федерация
037             </COUNTRY>
038             <REGION> [1..1] Субъект РФ. В случае городов федерального значения (Москва, Санкт-Петербург, Севастополь) элемент REGION соответствует городу, элементы DISTRICT, CITY не заполняются; остальные элементы заполняются в соответствии с адресом. Владимирская область
039                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор субъекта РФ в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR. <ID>92b78340-27b2-472d-a6cf-0b9b027d71e1</ID>
040                <NAME> Строка [0..1] Наименование субъекта РФ.
041             </REGION>
042             <DISTRICT> [0..1] Район субъекта РФ. Может быть не указан в случае отсутствия.
043                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор района субъекта РФ в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR. <ID>92b78340-27b2-472d-a6cf-0b9b027d71e1</ID>
044                <NAME> Строка [0..1] Наименование района субъекта РФ. Гороховецкий район
045             </DISTRICT>
046             <CITY> [0..1] Город. Может быть не указан в случае отсутствия. Может быть указан совместно с REGION для городов федерального значения.
047                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор города в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR. <ID>92b78340-27b2-472d-a6cf-0b9b027d71e1</ID>
048                <NAME> Строка [0..1] Наименование города. Гороховец
049             </CITY>
050             <LOCALITY> [0..1] Населенный пункт (село, посёлок, деревня, микрорайон и т.п.). Может быть не указан в случае отсутствия. Может быть указан совместно с CITY в случае административного подчинения городу или совместно с REGION для городов федерального значения.
051                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор населенного пункта в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR. <ID class=”OKATO”>17401000011</ID>
052                <NAME> Строка [0..1] Наименование населенного пункта. с. Осокино
053             </LOCALITY>
054             <AREA> [0..1] Элемент планировочной структуры (микрорайон, квартал, территория и т.п.). Может быть не указан в случае отсутствия.
055                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор элемента планировочной структуры в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR. <ID>92b78340-27b2-472d-a6cf-0b9b027d71e1</ID>
056                <NAME> Строка [0..1] Наименование элемента планировочной структуры Четвертый квартал
057             </AREA>
058             <STREET> [0..1] Улица (в т.ч. проспект, территория, квартал и т.п.). Может быть не указана в случае отсутствия.
059                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор улицы в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR. <ID>92b78340-27b2-472d-a6cf-0b9b027d71e1</ID>
060                <NAME> Строка [0..1] Наименование улицы.
061             </STREET>
062             <HOUSE> [0..1] Дом. Может быть не указан в случае отсутствия.
063                <ID class="FIAS"> Строка [0..1] Class = FIASClass = OKATO Идентификатор дома в соответствии с классификатором Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Указание дома идентификатором необязательно, возможно указание значения в элементе NAME.
064                <NAME> Строка [0..1] Номер дома 33А
065             </HOUSE>
066             <BUILDING> Строка [0..1] Строение. Может быть не указан в случае отсутствия. 1
067             <BLOCK> Строка [0..1] Корпус. Может быть не указан в случае отсутствия. Б
068             <LITER> Строка [0..1] Литер. Может быть не указан в случае отсутствия. Ж
069             <ROOM> Строка [0..1] Квартира. Может быть не указан в случае отсутствия. 11
070             <OFFICE> Строка [0..1] Офис. Может быть не указан в случае отсутствия. 16
071             <PBOX> Строка [0..1] Абоненсткий ящик. Может быть не указан в случае отсутствия. 128
072             <DESC> Строка [0..1] Дополнительное описание месторасположения. Может быть не указан в случае отсутствия. 20ый километр Минского шоссе, недалеко от железнодорожного переезда
073             <INDEX> Строка [0..1] Почтовый индекс. Формат 6 цифр 600901
074          </ADDR>
075          <HPOST> Строка [1..1] Должность руководителя организации Генеральный директор
076          <HFIO> Строка [1..1] ФИО руководителя организации Сергеев Федор Иванович
077          <PHONE> Строка [1..1] Контактный телефон. Формат: 10 цифр 9111234567
078          <FAX> Строка [0..1] Факс 4922112233
079          <EMAIL> Строка [0..1] Адрес электронной почты info@gkmyasprod.ru
080          <SITE> Строка [0..1] Сайт организации www.gkmyasprod.ru
081          <PRNTBE> [0..1] Вышестоящая (головная) организация в случае, если хозяйствующий субъект входит в состав холдинга или группы компаний.
082             <ID class=”OGRN”> Строка [1..*] Идентификатор Хса. В случае, если вышестоящая организация присутствует в списке BELIST как самостоятельный элемент, то может быть указан только идентификатор: ОГРН или ИНН или GLN – в зависимости от того, какой из них был указан при описании организации. Если вышестоящая организация отсутствует в списке BELIST, то должны быть указаны ИНН, КПП, ОГРН; может быть указан GLN. <ID class=”OGRN”>1234567890123</ID>
083             <FULLNAME> Строка [0..1] Полное наименование организации
084          </PRNTBE>
085       </BE>
086    </BELIST>
087    <ENTLIST> [1..1] Список площадок, который необходимо загрузить в Ветис.
088       <ENT seqnum=”1”> [0..*] Объект, содержащий сведения о площадке – физический объект, на котором осуществляется деятельность, подконтрольная Россельхознадзору. В атрибуте seqnum указывается порядковый номер площадки в списке ENTLIST.
089          <ID class="MGUID"> Строка [1..*] Class = MGUIDClass = MCODEClass = CGUIDClass = CCODE Идентификатор площадки в соответствии с ИС Меркурий и/или ИС Цербер. Если указан идентификатор, площадка может быть отредактирована (при необходимости). GUID площадки Меркурия (enterprise) указывается с class = MGUID, номер предприятия Меркурия (вида RU12345) указывается с class = MCODE. GUID производственной площадки Цербера (не путать с поднадзорным объектом) указывается с class = CGUID, номер производственной площадки Цербера – с class = CCODE. Значение по умолчанию для атрибута class – MGUID. Одновременно могут быть указаны идентификаторы Меркурия и Цербера. <ID class=”MCODE”>RU12345</ID><ID class=”CGUID”>92b78340-27b2-472d-a6cf-0b9b027d71e1</ID>
090          <NAME> Строка [0..1] Наименование производственной площадки, допускаются сокращения (безотносительно хоз.субъекта, осуществляющего деятельность на этой площадке). Склад №1
091          <FULLNAME> Строка [1..1] Полное наименование производственной площадки. Например, Склад №1, помещения которого арендуют ООО “Ромашка” и ЗАО “Лютик”, принадлежит ООО “Складская компания”. В этом случае полное наименование площадки может быть Склад №1 (ООО “Складская компания”). Название Ромашки и Лютик при этом могут фигурировать только в описании поднадзорного объекта (ENTLIST/ENT/USAGE/NAME). Склад №1 (ООО “Складская компания”)
092          <ADDR> Адрес местонахождения площадки в соответствии с административно-территориальным делением. Обязательными считаются все вложенные элементы, соответствующие компонентам адреса. Допускается не указывать элемент только при отсутствии соответствующего компонента адреса. Например, может отсутствовать район субъекта РФ, если площадка располагается в городе областного (республиканского, краевого) подчинения.Наряду с идентификаторами ИС Икар и ФИАС для элементов адреса может быть указан код ОКАТО.
093             <COUNTRY> [1..1] Страна
094                <ID class="ALPHA"> Строка [1..*] Class = ALPHAClass = IKAR Двухбуквенный код (alpha 2) страны в соответствии с ISO-3166 (class = ALPHA) или идентификатора ИС Икар (class = IKAR). Допускается указание только идентификатора России. Значение по умолчанию для атрибута class – ALPHA. <ID>RU</ID>
095                <NAME> Строка [0..1] Необязательное наименование страны
096             </COUNTRY>
097             <REGION> [1..1] Субъект РФ. В случае городов федерального значения (Москва, Санкт-Петербург, Севастополь) элемент REGION соответствует городу, элементы DISTRICT, CITY не заполняются; остальные элементы заполняются в соответствии с адресом.
098                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор субъекта РФ в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR. <ID>92b78340-27b2-472d-a6cf-0b9b027d71e1</ID>
099                <NAME> Строка [0..1] Наименование субъекта РФ.
100             </REGION>
101             <DISTRICT> [0..1] Район субъекта РФ. Может быть не указан в случае отсутствия.
102                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор района субъекта РФ в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR.
103                <NAME> Строка [0..1] Наименование района субъекта РФ.
104             </DISTRICT>
105             <CITY> [0..1] Город. Может быть не указан в случае отсутствия. Может быть указан совместно с REGION для городов федерального значения.
106                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор города в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR.
107                <NAME> Строка [0..1] Наименование города.
108             </CITY>
109             <LOCALITY> [0..1] Населенный пункт (село, посёлок, деревня, микрорайон и т.п.). Может быть не указан в случае отсутствия. Может быть указан совместно с CITY в случае административного подчинения городу или совместно с REGION для городов федерального значения.
110                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор населенного пункта в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR.
111                <NAME> Строка [0..1] Наименование населенного пункта.
112             </LOCALITY>
113             <AREA> [0..1] Элемент планировочной структуры (микрорайон, квартал, территория и т.п.). Может быть не указан в случае отсутствия.
114                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор элемента планировочной структуры в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR.
115                <NAME> Строка [0..1] Наименование элемента планировочной структуры
116             </AREA>
117             <STREET> [0..1] Улица (в т.ч. проспект, территория, квартал и т.п.). Может быть не указана в случае отсутствия.
118                <ID class="IKAR"> Строка [1..*] Class = IKARClass = FIASClass = OKATO Идентификатор улицы в соответствии с классификатором ИС Икар (class = IKAR) или Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – IKAR.
119                <NAME> Строка [0..1] Наименование улицы.
120             </STREET>
121             <HOUSE> [0..1] Дом. Может быть не указан в случае отсутствия.
122                <ID class="FIAS"> Строка [0..1] Class = FIASClass = OKATO Идентификатор дома в соответствии с классификатором Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Указание дома идентификатором необязательно, возможно указание значения в элементе NAME.
123                <NAME> Строка [0..1] Номер дома
124             </HOUSE>
125             <BUILDING> Строка [0..1] Строение. Может быть не указан в случае отсутствия.
126             <BLOCK> Строка [0..1] Корпус. Может быть не указан в случае отсутствия.
127             <LITER> Строка [0..1] Литер. Может быть не указан в случае отсутствия.
128             <ROOM> Строка [0..1] Квартира. Может быть не указан в случае отсутствия.
129             <OFFICE> Строка [0..1] Офис. Может быть не указан в случае отсутствия.
130             <PBOX> Строка [0..1] Абоненсткий ящик. Может быть не указан в случае отсутствия.
131             <DESC> Строка [0..1] Дополнительное описание месторасположения. Может быть не указан в случае отсутствия. 20ый километр Минского шоссе, недалеко от железнодорожного переезда
132             <INDEX> Строка [0..1] Почтовый индекс
133          </ADDR>
134          <MADDR> [0..1] Адрес местонахождения площадки в соответствии с муниципальным делением. Обязательными считаются все вложенные элементы, соответствующие компонентам адреса. Допускается не указывать элемент только при отсутствии соответствующего компонента адреса. Например, может отсутствовать район субъекта РФ, если площадка располагается в городе областного (республиканского, краевого) подчинения.Наряду с идентификаторами ФИАС для элементов адреса может быть указан код ОКТМО. Справочник адресов ИС Икар в настоящий момент не имеет полной поддержки муниципального деления.
135             <COUNTRY> [1..1] Страна
136                <ID class="ALPHA"> Строка [1..*] Class = ALPHA Двухбуквенный код (alpha 2) страны в соответствии с ISO-3166 (class = ALPHA) или идентификатора ИС Икар (class = IKAR). Допускается указание только идентификатора России. Значение по умолчанию для атрибута class – ALPHA. <ID>RU</ID>
137                <NAME> Строка [0..1] Необязательное наименование страны
138             </COUNTRY>
139             <REGION> [1..1] Субъект РФ. В случае городов федерального значения (Москва, Санкт-Петербург, Севастополь) элемент REGION соответствует городу, элементы DISTRICT, CITY не заполняются; остальные элементы заполняются в соответствии с адресом.
140                <ID class="IKAR"> Строка [1..*] Class = FIASClass = OKTMO Идентификатор субъекта РФ в соответствии с классификатором Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – FIAS. <ID>92b78340-27b2-472d-a6cf-0b9b027d71e1</ID>
141                <NAME> Строка [0..1] Наименование субъекта РФ. г. Москва
142             </REGION>
143             <DISTRICT> [0..1] Муниципальный район или городской округ. Может быть не указан в случае отсутствия.
144                <ID class="IKAR"> Строка [1..*] Class = FIASClass = OKTMO Идентификатор муниципального района или городского округа в соответствии с классификатором Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – FIAS
145                <NAME> Строка [0..1] Наименование муниципального района или городского округа. Городской округ г. Зеленоград
146             </DISTRICT>
147             <CITY> [0..1] Поселение. Может быть не указан в случае отсутствия.
148                <ID class="IKAR"> Строка [1..*] Class = FIASClass = OKTMO Идентификатор поселения в соответствии с классификатором Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – FIAS
149                <NAME> Строка [0..1] Наименование поселения.
150             </CITY>
151             <LOCALITY> [0..1] Населенный пункт. Может быть не указан в случае отсутствия.
152                <ID class="IKAR"> Строка [1..*] Class = FIASClass = OKTMO Идентификатор населенного пункта в соответствии с классификатором Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – FIAS
153                <NAME> Строка [0..1] Наименование населенного пункта.
154             </LOCALITY>
155             <AREA> [0..1] Элемент планировочной структуры (микрорайон, квартал, территория и т.п.). Может быть не указан в случае отсутствия.
156                <ID class="IKAR"> Строка [1..*] Class = FIASClass = OKTMO Идентификатор элемента планировочной структуры в соответствии с классификатором Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – FIAS
157                <NAME> Строка [0..1] Наименование элемента планировочной структуры
158             </AREA>
159             <STREET> [0..1] Улица (в т.ч. проспект, территория, квартал и т.п.). Может быть не указана в случае отсутствия.
160                <ID class="IKAR"> Строка [1..*] Class = FIASClass = OKTMO Идентификатор улицы в соответствии с классификатором Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Значение по умолчанию для атрибута class – FIAS
161                <NAME> Строка [0..1] Наименование улицы.
162             </STREET>
163             <HOUSE> [0..1] Дом. Может быть не указан в случае отсутствия.
164                <ID class="FIAS"> Строка [0..1] Class = FIASClass = OKTMO Идентификатор дома в соответствии с классификатором Федеральной адресной системой ФИАС (fias.nalog.ru, class = FIAS). Указание дома идентификатором необязательно, возможно указание значения в элементе NAME.
165                <NAME> Строка [0..1] Номер дома
166             </HOUSE>
167             <BUILDING> Строка [0..1] Строение. Может быть не указан в случае отсутствия.
168             <BLOCK> Строка [0..1] Корпус. Может быть не указан в случае отсутствия.
169             <LITER> Строка [0..1] Литер. Может быть не указан в случае отсутствия.
170             <ROOM> Строка [0..1] Квартира. Может быть не указан в случае отсутствия.
171             <OFFICE> Строка [0..1] Офис. Может быть не указан в случае отсутствия.
172             <PBOX> Строка [0..1] Абоненсткий ящик. Может быть не указан в случае отсутствия.
173             <DESC> Строка [0..1] Дополнительное описание месторасположения. Может быть не указан в случае отсутствия. 20ый километр Минского шоссе, недалеко от железнодорожного переезда
174             <INDEX> Строка [0..1] Почтовый индекс
175          </MADDR>
176          <GEODATA> [0..1] Географические координаты площадки.
177             <POINT> Список строк [1..1] Точка в формате широта и долгота в вещественном формате через запятую.
178             <POLYGON> Список строк [0..1] Границы объекта. Указываются единым списком последовательно координаты точек, определяющих границы объекта через запятую. Каждая пара значений интерпретируется как координата точки (широта и долгота).
179          </GEODATA>
180          <KADASTR> Строка [0..1] Кадастровый номер земельного участка, на котором располагается площадка в формате АА:ВВ:CCCCCC:КК 47:14:1203001:814
181          <OWNER> [1..1] Хозяйствующий субъект, являющийся собственником площадки (объекта). Объект OWNER может быть заполнен двумя способами: 1. Полностью в соответствии с форматом и описанием объекта BELIST/BE (тип BUSINESS_ENTITY);2. Только идентификатор, при условии что сведения о хоз.субъекте присутствуют в списке BELIST. Причем поиск в списке BELIST будет осуществлен по значению идентификатора и его классу. Допустим, в списке BELIST для хоз.субъекта были указаны идентификаторы ИНН, КПП, ОГРН, GLN. В этом случае корректной ссылкой на этот ХС будет, например, <ID class=”OGRN”>знач</ID>.
182             <ID class="OGRN"> Строка [1..*] Идентификатор хозяйствующего субъекта.
183          </OWNER>
184          <USAGE> [1..*] Сведения об осуществляемой деятельности на объекте (площадке). Может быть указано несколько элементов USAGE по одному для каждого хоз.субъекта, осуществляющего деятельность на данном объекте (площадке).
185             <ID class="GLN"> Строка [0..*] Class = CGUIDClass = GLN В качестве идентификатора может быть указан GUID поднадзорного объекта в ИС Цербер или один или более GLN (Global Location Number). Объект, на который указывает идентификатор должен относиться к тому же хозяйствующему субъекту, который описан далее в элементе BE.
186             <NAME> [0..1] Необязательное наименование поднадзорного объекта. В названии может упоминаться хоз.субъект, осуществляющий деятельность на данной площадке. См. комментарий к ENTLIST/ENT/FULLNAME.
187             <BE> [1..1] Хозяйствующий субъект, осуществляющий деятельность (подконтрольную РСХН) на данной площадке. Может отличаться или совпадать с собственником площадки. Правила заполнения аналогичны объекту ENTLIST/ENT/OWNER.
188                <ID class="OGRN"> [1..*] Идентификатор хозяйствующего субъекта.
189             </BE>
190             <TYPE> [1..1] Тип поднадзорного объекта
191                <ID class="CGUID"> [1..1] Class = CGUID Идентификатор типа объекта в соответствии с классификатором ИС Цербер.
192                <NAME> [0..1]
193             </TYPE>
194             <ACTTYPE> [1..*] Вид осуществляемой деятельности указанным хоз.субъектом (USAGE/BE) на данном объекте.
195                <ID class="OKVED"> [1..1] Class = OKVED Идентификатор вида деятельности в соответствии с ОКВЭД с учетом изменения 12/2016 ОКВЭД2 Общероссийский классификатор видов экономической деятельности ОК 029-2014 (КДЕС Ред. 2)" (принято и введено в действие Приказом Росстандарта от 07.09.2016 N 1326-ст).Формат кода: 32.12.7 или 32.12 (если осуществляемая деятельность включает все виды из указанной группы).
196                <NAME> [0..1] Краткое наименование вида деятельности.
197             </ACTTYPE>
198          </USAGE>
199       </ENT>
200    </ENTLIST>
201 </DOCUMENT>

Объект ..Request/initiator

Объект содержит сведения о пользователе, инициирующем запрос к шлюзу.

Поле Описание Тип Обязательность
UUID Идентификатор пользователя, зарегистрированного в системе Меркурий. bs:UUID 1 - Авторизация проводится по одному из параметров. Если указаны оба параметра, то приоритет за UUID.
login Логин пользователя. xs:NCName

Данные ответа

Объект getVetDocumentByUuidResponse

Объект содержит сведения о результатах обработки запроса на получение сведений о ВСД по его идентификатору.

Поле Описание Тип Обязательность
vetDocument Сведения о ВСД. argc:User 1

Объект ..Response/vetDocument

Объект содержит сведения о ВСД.

Поле Описание Тип Обязательность
UUID Идентификатор ВСД. bs:UUID 1
issueSeries Серия ВСД. Указывается для документа, оформленного на бланке строгой отчётности. bs:String255 0..1
issueNumber Номер ВСД. Указывается для документа, оформленного на бланке строгой отчётности. bs:String255 0..1
issueDate Дата оформления ВСД. xs:date 1
form Форма ВСД. vetd:VetDocumentForm 1
type Тип ВСД. vetd:VetDocumentType 1
status Статус ВСД. vetd:VetDocumentStatus 1
consignor Сведения об отправителе продукции. ent:BusinessMember 1
consignee Сведения о получателе продукции. ent:BusinessMember 1
batch Сведения о партии продукции. vetd:Batch 1
purpose Цель. Назначение груза. argc:Purpose 1
broker Сведения о фирме-посреднике (перевозчике продукции). ent:BusinessEntity 0..1
transportInfo Сведения о транспорте. shp:TransportInfo 0..1
transportStorageType Способ хранения продукции при перевозке. shp:TransportationStorageType 0..1
cargoReloadingPointList Сведения о маршруте следования (пунктах перегрузки). shp:ShipmentRoute 0..1
waybillNumber Номер товарно-транспортной накладной. bs:String255 0..1
waybillDate Дата товарно-транспортной накладной. xs:date 0..1
cargoExpertized Проводилась ли ветсанэкспертиза.
  • Для типа продукции "Живые животные" поле отсутствует.
xs:boolean 0..1
expertiseInfo Результаты лабораторных исследований.
  • Для типа продукции "Живые животные" поле отсутствует.
bs:String255 0..1
confirmedBy Государственный ветврач, выдавший ВСД. argc:User 1
locationProsperity Благополучие местности. bs:String255 1
transferPermit Сведения о ветеринарном разрешении управления ветеринарии субъекта РФ на перемещение продукции в другой субъект. argc:Document 0..1
specialMarks Особые отметки. bs:String255 0..1

Объект ..Response/vetDocument/consignor

Объект содержит сведения об отправителе продукции.

Поле Описание Тип Обязательность
businessEntity Информация о хозяйствующем субъекте-отправителе партии. ent:BusinessEntity 1
enterprise Информация о предприятии-отправителе партии. ent:Enterprise 0..1

Объект ..Response/vetDocument/consignor/businessEntity

Объект содержит сведения о хозяйствующем субъекте.

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта - владельца продукции. bs:UUID 1
GUID Глобальный идентификатор хозяйствующего субъекта - владельца продукции. bs:UUID 1

Объект ..Response/vetDocument/consignor/enterprise

Объект содержит сведения о площадке (поднадзорном объекте).

Поле Описание Тип Обязательность
UUID Идентификатор версии предприятия. bs:UUID 1
GUID Глобальный идентификатор предприятия. bs:UUID 1

Объект ..Response/vetDocument/consignee

Объект содержит сведения о получателе, в случае производственного сертификата объект будет содержать те же сведения, что и в объекте consignor.

Поле Описание Тип Обязательность
businessEntity Информация о хозяйствующем субъекте-получателе партии. ent:BusinessEntity 1
enterprise Информация о предприятии-получателе партии. ent:Enterprise 0..1

Объект ..Response/vetDocument/consignee/businessEntity

Объект содержит сведения о хозяйствующем субъекте.

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта - владельца продукции. bs:UUID 1
GUID Глобальный идентификатор хозяйствующего субъекта - владельца продукции. bs:UUID 1

Объект ..Response/vetDocument/consignee/enterprise

Объект содержит сведения о площадке (поднадзорном объекте).

Поле Описание Тип Обязательность
UUID Идентификатор версии предприятия. bs:UUID 1
GUID Глобальный идентификатор предприятия. bs:UUID 1

Объект ..Response/vetDocument/batch

Объект содержит сведения о партии продукции, на которую был выдан запрашиваемый ВСД.

Поле Описание Тип Обязательность
productType Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий. argpr:ProductType 1
product Продукция. Второй уровень иерархического справочника продукции ИС Меркурий. argpr:Product 1
subProduct Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий. argpr:SubProduct 1
productItem Наименование продукции в номенклатуре производителя. argpr:ProductItem 0..1
volume Объем продукции, на который был выдан ВСД. Значение должно быть больше нуля. bs:Decimal 1
unit Единица измерения объема продукции. argc:Unit 1
packingList Список видов упаковки. argc:PackingFormList 0..1
packingAmount Общее количество единиц упаковки для партии. xs:int 0..1
dateOfProduction Дата выработки продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate. vetd:GoodsDate 1
expiryDate Дата окончания срока годности продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate. vetd:GoodsDate 1
perishable Описывает, является ли продукция скоропортящейся, true – скоропортящаяся, false – не скоропортящаяся. xs:boolean 0..1
countryOfOrigin Страна происхождения продукции. ikar:Country 1
producerList Список производителей продукции. ent:ProducerList 1
productMarkingList Список маркировки, доступный для данного производителя. vetd:ProductMarkingList 0..1
lowGradeCargo Является ли груз некачественным.
  • true – груз некачественный;
  • false – груз качественный.

Элемент может не указываться. В этом случае значение по-умолчанию устанавливается false.

xs:boolean 1
owner Хозяйствующий субъект - владелец продукции. ent:businessEntity 1

Объект ..Response/vetDocument/batch/product

Объект содержит сведения о продукции; второй уровень иерархического справочника продукции ИС Меркурий.

Поле Описание Тип Обязательность
UUID Идентификатор версии продукции. bs:UUID 1
GUID Глобальный идентификатор продукции. bs:UUID 1

Объект ..Response/vetDocument/batch/subProduct

Объект содержит сведения о видах продукции; третий уровень иерархического справочника продукции ИС Меркурий.

Поле Описание Тип Обязательность
UUID Идентификатор версии вида продукции. bs:UUID 1
GUID Глобальный идентификатор продукции. bs:UUID 1

Объект ..Response/vetDocument/batch/productItem

Объект содержит сведения о наименовании продукции.

Поле Описание Тип Обязательность
name Наименование продукции в соответствии с номенклатурой производителя. bs:String255 1

Объект ..Response/vetDocument/batch/unit

Объект содержит сведения о единице измерения объема продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии единицы измерения. bs:UUID 1
GUID Глобальный идентификатор единицы измерения. bs:UUID 1

Объект ..Response/vetDocument/batch/packingList

Объект содержит сведения о списке видов упаковки, которые используются для партии продукции.

Поле Описание Тип Обязательность
packingForm Вид упаковки. vetd:PackingForm 0..1

Объект ..Response/vetDocument/batch/packingList/packingForm

Объект содержит сведения о виде упаковки, которая используются для партии продукции.

Поле Описание Тип Обязательность
UUID Идентификатор упаковки. bs:UUID 1
name Наименование конкретного вида упаковки. bs:String255 1

Объект ..Response/vetDocument/batch/productMarkingList

Объект содержит сведения о списке маркировки.

Поле Описание Тип Обязательность
productMarking Строка с маркировкой продукции. bs:String255 0..*

Объект ..Response/vetDocument/batch/countryOfOrigin

Объект содержит сведения о стране-происхождения продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии страны происхождения. bs:UUID 1
GUID Глобальный идентификатор страны происхождения. bs:UUID 1

Объект ..Response/vetDocument/batch/producerList

Объект содержит сведения о списке производителей продукции.

Поле Описание Тип Обязательность
producer Производитель продукции. vetd:Producer 1

Объект ..Response/vetDocument/batch/producerList/producer

Объект содержит сведения о производителе продукции.

Поле Описание Тип Обязательность
enterprise Информация о предприятие-производителе продукции. ent:Enterprise 1
role Роль предприятия-производителя продукции. ent:EnterpriseRole 1

Объект ..Response/vetDocument/batch/producerList/producer/enterprise

Объект содержит сведение о предприятие-производителе продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии предприятия-производителя продукции. bs:UUID 1
GUID Глобальный идентификатор предприятия-производителя продукции. bs:UUID 1

Объект ..Response/vetDocument/batch/owner

Объект содержит сведения о хозяйствующем субъекте-владельце продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта - владельца продукции. bs:UUID 1
GUID Глобальный идентификатор хозяйствующего субъекта - владельца продукции. bs:UUID 1

Объект ..Response/vetDocument/purpose

Объект содержит сведения о цели перемещения транспортной партии.

Поле Описание Тип Обязательность
UUID Идентификатор записи в справочнике целей. bs:UUID 1
GUID Глобальный идентификатор записи в справочнике целей. bs:UUID 1

Объект ..Response/vetDocument/broker

Объект содержит сведения о хозяйствующем субъекте-посреднике (перевозчик продукции).

Поле Описание Тип Обязательность
UUID Идентификатор хозяйствующего субъекта - перевозчика продукции (посредника). bs:UUID 1
GUID Глобальный идентификатор хозяйствующего субъекта - перевозчика продукции (посредника). bs:UUID 1

Объект ..Response/vetDocument/transportInfo

Объект содержит информацию о транспорте в котором будет перемещаться партия продукции.

Поле Описание Тип Обязательность
transportType Тип транспортного средства. shp:TransportType 1
transportNumber Номер транспортного средства. shp:TransportNumber 1

Объект ..Response/vetDocument/transportInfo/transportNumber

Объект содержит информацию о номере транспортного средства.

Поле Описание Тип Обязательность
vehicleNumber Номер транспортного средства. bs:String255 1

Объект ..Response/vetDocument/cargoReloadingPointList

Объект содержит информацию о списке пунктов перегрузки.

Поле Описание Тип Обязательность
cargoReloadingPoint Пункт перегрузки транспортной партии в другое транспортное средство. shp:CargoReloadingPoint 0..*

Объект ..Response/vetDocument/cargoReloadingPointList/cargoReloadingPoint

Объект содержит информацию о пункте перегрузки.

Поле Описание Тип Обязательность
name Название пункта перегрузки. bs:String255 1
nextTransport Сведения о дальнейшем транспорте. shp:TransportInfo 1

Объект ..Response/vetDocument/cargoReloadingPointList/cargoReloadingPoint/nextTransport

Объект содержит сведения о транспорте, которым далее последует транспортная партия.

Поле Описание Тип Обязательность
transportType Тип транспортного средства. shp:TransportType 1
transportNumber Номер транспортного средства. shp:TransportNumber 1

Объект ..Response/vetDocument/cargoReloadingPointList/cargoReloadingPoint/nextTransport/transportNumber

Объект содержит информацию о номере транспортного средства.

Поле Описание Тип Обязательность
vehicleNumber Номер транспортного средства. bs:String255 1

Объект ..Response/vetDocument/confirmedBy

Объект содержит сведения о ветеринарном враче, оформившим ВСД.

Поле Описание Тип Обязательность
fio ФИО врача, оформившего ветеринарно-сопроводительный документ. bs:String255 1
post Должность врача, оформившего ветеринарно-сопроводительный документ. bs:String255 1

Объект ..Response/vetDocument/transferPermit

Сведения о ветеринарном разрешении управления ветеринарии субъекта РФ на перемещение продукции в другой субъект.

Поле Описание Тип Обязательность
name Название документа. bs:String255 0..1
form Форма документа. bs:String255 0..1
issueSeries Серия документа. bs:String255 0..1
issueNumber Номер документа. bs:String255 0..1
issueDate Дата документа. xs:date 0..1

Пример запроса

Пример запроса - для ветеринарного управления

<codeblock language="xml" class="mw-collapsible> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

                 xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions" 
                 xmlns:app="http://api.vetrf.ru/schema/cdm/application" 
                 xmlns:mercvu="http://api.vetrf.ru/schema/cdm/mercury/vu/applications"  
                 xmlns:base="http://api.vetrf.ru/schema/cdm/base" 
                 xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common" 
                 xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise" 
                 xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar">
  <soapenv:Header/>
  <soapenv:Body>
     <ws:submitApplicationRequest>
        <ws:apiKey>apiKey=</ws:apiKey>
        <app:application>
           <app:serviceId>mercury-vu.service</app:serviceId>
           <app:issuerId>issuerId</app:issuerId>
           <app:issueDate>2015-01-10T17:03:00</app:issueDate>
           <app:data>
              <mercvu:getVetDocumentByUuidRequest>
                 <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                 <mercvu:initiator>
                    <com:login>user</com:login>
                 </mercvu:initiator>
                 <base:uuid>vetDocumentId</base:uuid>
              </mercvu:getVetDocumentByUuidRequest>
           </app:data>
        </app:application>
     </ws:submitApplicationRequest>
  </soapenv:Body>

</soapenv:Envelope> </syntaxhighlight>


Пример запроса - для хозяйствующего субъекта

<codeblock language="xml" class="mw-collapsible> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

                 xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions" 
                 xmlns:app="http://api.vetrf.ru/schema/cdm/application" 
                 xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/applications"  
                 xmlns:base="http://api.vetrf.ru/schema/cdm/base" 
                 xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common" 
                 xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise" 
                 xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar">
  <soapenv:Header/>
  <soapenv:Body>
     <ws:submitApplicationRequest>
        <ws:apiKey>apiKey=</ws:apiKey>
        <app:application>
           <app:serviceId>mercury-g2b.service</app:serviceId>
           <app:issuerId>issuerId</app:issuerId>
           <app:issueDate>2015-01-10T17:03:00</app:issueDate>
           <app:data>
              <merc:getVetDocumentByUuidRequest>
                 <merc:localTransactionId>a10003</merc:localTransactionId>
                 <merc:initiator>
                    <com:login>user</com:login>
                 </merc:initiator>
                 <base:uuid>vetDocumentId</base:uuid>
                 <ent:enterpriseGuid>guid</ent:enterpriseGuid>
              </merc:getVetDocumentByUuidRequest>
           </app:data>
        </app:application>
     </ws:submitApplicationRequest>
  </soapenv:Body>

</soapenv:Envelope> </syntaxhighlight>

Коды ошибок

В таблице ниже приведены коды ошибок, возвращаемые веб-сервисом при различных несоответствиях формату или бизнес-правилам.

Код Описание ошибки
MERC29180 Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC29224 Ветеринарно-сопроводительный документ не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.

Вернуться к началу ↑