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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(Egorova-iv-150707 переименовал страницу ModifyEnterpriseOperation в ModifyEnterpriseOperation v1.2)
 
 
(не показано 18 промежуточных версий 2 участников)
Строка 1: Строка 1:
#перенаправление [[ModifyEnterpriseOperation v1.2]]
==Общие сведения==
Операция '''ModifyEnterpriseOperation''' предназначена для регистрации новых площадок (поднадзорных объектов), где хозяйствующий субъект осуществляет свою деятельность, а так же для изменения информации об уже зарегистрированных поднадзорных объектах.
Поднадзорный объект (площадка) может быть следующих типов:
* предприятие;
* рынок;
* СББЖ;
* судно.
 
Реестр поднадзорных объектов ведется с применением версионирования, это означает, что запись об одной площадке может иметь несколько версий. При каждом изменении записи реестра создается новая версия этой записи. То есть при регистрации нового поднадзорного объекта создаётся новая запись, а если информация о площадке изменяется, то в реестр вносится ещё одна версия записи.
 
Идентификация  каждой  записи  производится  по следующим полям:
* GUID - глобальный идентификатор записи. Данный идентификатор остается неизменным для всех версий записи о поднадзорном объекте.
* UUID - идентификатор версии записи. Данный идентификатор изменяется для каждой новой версии записи о поднадзорном объекте.
При создании каждой новой версии записи о поднадзорном объекте, старая версия записи становится неактивной и должна ссылаться на новую версию, а новая — на старую. Таким образом, возможно восстановить историю изменений.
Для одной записи журнала может существовать только одна актуальная версия.
 
При выполнении операции '''ModifyEnterpriseOperation''' на вход системы передаются следующие сведения:
* информация о пользователе - инициаторе запроса;
* тип операции (добавление или изменение);
* информация о поднадзорном объекте (название площадки, адрес, вид деятельности  и другие данные, характеризующие поднадзорный объект).
 
Результатом выполнения данной операции является добавление записи о новом поднадзорном объекте в реестре или внесение изменений в существующую запись.
 
===Возможные сценарии===
<div id = "createEnterprise">1. [[#scenario1|Создание нового поднадзорного объекта (предприятия).]]</div>
:1.1. Внесение в реестр поднадзорного объекта.<br />
:1.2. Ошибка обработки запроса. 
<div id = "changeEnterprise">2. [[#scenario2|Редактирование данных поднадзорного объекта]].</div>
 
===Ограничения при создании предприятия===
'''Система хозяйствующего субъекта.'''
* Инициатор - ветеринарный врач. Предприятие создаётся в том же регионе, к ГВЭ которого принадлежит ветеринарный врач. Результат: успешное завершение операции - предприятие создано.
* Инициатор - ветеринарный врач. Предприятие создаётся в другом регионе, ветеринарный врач к его ГВЭ не принадлежит. Результат: ошибка "Регион указанной организации и обслуживаемого предприятия должны совпадать". Предприятие не создано.
* Инициатор - пользователь хозяйствующего субъекта. Предприятие создаётся в том же регионе, которому принадлежит ХС. Результат: успешное завершение операции - предприятие создано.
* Инициатор - пользователь хозяйствующего субъекта. Предприятие создаётся в другом регионе, ХС зарегистрирован в другом регионе. Результат: успешное завершение операции - предприятие создано.
'''Система ветеринарного управления.'''
* Инициатор - ветеринарный врач. Предприятие создаётся в том же регионе, что и ГВЭ. Результат: успешное завершение операции - предприятие создано.
* Инициатор - ветеринарный врач. Предприятие создаётся в другом регионе, обслуживаемом другим ГВЭ. Результат: ошибка "Регион указанной организации и обслуживаемого предприятия должны совпадать". Предприятие не создано.
 
===Ограничения при редактировании предприятия===
'''Система хозяйствующего субъекта.'''
*Инициатор - пользователь хозяйствующего субъекта. Предприятие было создано от имени этого ХС или ХС является собственником, оно привязано к ХС. Результат: успешное завершение операции - предприятие отредактировано.
*Инициатор - пользователь хозяйствующего субъекта. Предприятие было создано от имени другого ХС, ХС не является собственником, оно не привязано к ХС. Результат: сообщение об ошибке- предприятие может быть отредактировано либо собственником, либо ХС, который его создал.
*Инициатор - пользователь хозяйствующего субъекта. Предприятие было создано от имени другого ХС, ХС не является собственником, оно привязано к ХС. Результат: сообщение об ошибке- предприятие может быть отредактировано либо собственником, либо ХС, который его создал.
*Инициатор - пользователь хозяйствующего субъекта. Предприятие было создано от имени этого ХС или ХС является собственником, оно не привязано к ХС. Результат: успешное завершение операции - предприятие отредактировано.
'''Система ветеринарного управления.'''
*Инициатор - ветеринарный врач. Предприятие редактируется в том же регионе, к ГВЭ которого принадлежит ветеринарный врач. Результат: успешное завершение операции - предприятие отредактировано.
*Инициатор - ветеринарный врач. Предприятие создаётся в регионе, к ГВЭ которого ветеринарный врач не принадлежит. Результат: ошибка - предприятие не относится к ГВЭ пользователя.
 
===Используемые пространства имён и типы===
{{столбцы}}
{{столбец}}
*[[NameSpaces#http://api.vetrf.ru/schema/cdm/enterprise|ent]] (<nowiki>http://api.vetrf.ru/schema/cdm/cerberus/enterprise</nowiki>)
**  [[BEModificationOperation|ent:BEModificationOperation]]
** [[EnterpriseType|ent:EnterpriseType]]
** [[EnterpriseActivityList|ent:EnterpriseActivityList]]
** [[EnterpriseList|ent:EnterpriseList]]
** [[Enterprise|ent:Enterprise]]
** [[BusinessEntity|ent:BusinessEntity]]
** [[ENTModificationReason|ent:ENTModificationReason]]
<!---** [[BEModificationOperation|ent:BEModificationOperation]]
** [[ENTModificationOperation|ent:ENTModificationOperation]] -->
** [[EnterpriseActivity|ent:EnterpriseActivity]]
** [[ActivityLocation|ent:ActivityLocation]]
{{столбец}}
*[[NameSpaces#http://api.vetrf.ru/schema/cdm/base|bs]] (<nowiki>http://api.vetrf.ru/schema/cdm/base</nowiki>)
** [[String255|bs:String255]]
** [[Decimal|bs:Decimal]]
** [[VersionStatus|bs:VersionStatus]]
** [[RegisterModificationType|bs:RegisterModificationType]]
** [[UUID|bs:UUID]]
 
*[[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/common|argc]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/common</nowiki>)
** [[User|argc:User]]
 
{{Столбец}}
*[[NameSpaces#http://api.vetrf.ru/schema/cdm/ikar|ikar]] (<nowiki>http://api.vetrf.ru/schema/cdm/ikar</nowiki>)
** [[Country|ikar:Country]]
** [[Region|ikar:Region]]
** [[Address|ikar:Address]]
*[[NameSpaces#http://www.w3.org/2001/XMLSchema|xs]](<nowiki>http://www.w3.org/2001/XMLSchema</nowiki>)
**[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
**[http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime]
**[http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
 
{{столбцы/конец}}
 
===Общие отличия между версией для хозяйствующих субъектов и ветеринарных управлений ===
 
{| class="wikitable"
|-
! Различающиеся параметры !! Версия для хозяйствующих субъектов !! Версия для ветеринарных управлений
|-
| '''Пространство имён''' || 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
|-
|}
 
==Данные запроса==
<!--
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Структура данных запроса в формате ХML.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<mercvu:modificationOperation 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">
    <ent:type>{bs:type}</ent:type>
    <ent:resultingList count="1" total="1" offset="0">
        <ent:enterprise>
            <ent:name>{bs:String255}</ent:name>
            <ent:type>{bs:String255}</ent:type>
            <ent:address>
                <ikar:country>
                    <base:guid>{bs:UUID}</base:guid>
                </ikar:country>
                <ikar:region>
                    <base:guid>{bs:UUID}</base:guid>
                </ikar:region>
                <ikar:addressView>{bs:String255}</ikar:addressView>
            </ent:address>
            <ent:activityList count="1" total="1" offset="0">
                <ent:activity>
                    <ent:name>{bs:String255}</ent:name>
                </ent:activity>
            </ent:activityList>
        </ent:enterprise>                       
    </ent:resultingList>
    <ent:reason>{bs:String255}</ent:reason>
</mercvu:modificationOperation>
</syntaxhighlight>
</div>
</div> -->
 
===Объект modifyEnterpriseRequest===
Корневой элемент содержимого заявки. Содержит сведения для выполнения операции добавления/изменения сведений в реестре поднадзорных объектов.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''localTransactionId''' || Идентификатор заявки в клиентской системе. || [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName] || 1
|-
| [[#Объект ..Request/initiator|'''initiator''']] || Пользователь, инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин. || [[User|argc:User]] || 1
|-
| [[#Объект ..Request/modificationOperation|'''modificationOperation''']] || Описание операции добавления/изменения информации о поднадзорном объекте. || [[BEModificationOperation|ent:BEModificationOperation]] || 1
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/'''initiator'''===
 
Содержит сведения о пользователе, зарегистрированном в системе Меркурий и инициирующим запрос к шлюзу.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID'''
| Идентификатор пользователя, зарегистрированного в системе Меркурий.
| [[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо login.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''login'''
| Логин пользователя.
| [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/'''modificationOperation'''===
Объект содержит общую информацию о выполняемой операции: тип операции, причину внесения записи в реестр и информацию о поднадзорном объекте.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''type''' || Тип операции. На данный момент доступны операции двух типов:
* CREATE - создание поднадзорного объекта;
* UPDATE - обновление данных поднадзорного объекта.
|| [[RegisterModificationType|bs:RegisterModificationType]] || 1
|-
| [[#Объект ..Request/modificationOperation/resultingList|'''resultingList''']] || Список, который содержит сведения о добавляемых поднадзорных объектах. На данный момент поддерживается добавление только одной площадки в рамках одной заявки.
|| [[EnterpriseList|ent:EnterpriseList]] || 1
|-
| '''reason''' || Основание добавления/изменения записи в реестре. На этапе формирования справочника указывается текстом, далее в данном поле будет передаваться строковый код из справочника.  || [[ENTModificationReason|ent:ENTModificationReason]] || 1
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/'''resultingList'''===
Объект содержит сведения о поднадзорных объектах, информацию о которых необходимо добавить/изменить в реестре.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise|'''enterprise''']] || Элемент, содержащий информацию о поднадзорном объекте.|| [[Enterprise|ent:Enterprise]] || 1
|-
|}
 
'''Атрибуты списка resultingList'''
{{Ветис.API EntityList Attributes}}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/'''enterprise'''===
Объект содержит подробную информацию о поднадзорном объекте.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Идентификатор поднадзорного объекта.
* Указывается в случае изменения данных о поднадзорном объекте (UPDATE).
|| [[UUID|bs:UUID]] || 0..1
|-
| '''name''' || Полное наименование создаваемого/редактируемого поднадзорного объекта.  || [[String255|bs:String255]] || 1
|-
| '''type''' || Тип поднадзорного объекта:
* 1 - предприятие;
* 2 - рынок;
* 3 - СББЖ;
* 4 - судно.
|| [[EnterpriseType|ent:EnterpriseType]] || 1
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise/address |'''address''']] || Фактический адрес расположения поднадзорного объекта.
* Обязательно указывать только при создании предприятия.
* При редактировании данных предприятия необязателен к указанию.
|| [[Address|ikar:Address]] || 0..1
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise/activityList|'''activityList''']] || Виды деятельности поднадзорного объекта, согласно справочнику. Указывается либо идентификатор, либо название текстом. || [[EnterpriseActivityList|ent:EnterpriseActivityList]] || 1
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise/owner|'''owner''']] || Собственник поднадзорного объекта. На данный момент площадку может добавлять не только хозяйствующий субъект-владелец, но и другие хозяйствующие субъекты, по этой причине необходимо указывать собственника. || [[BusinessEntity|ent:BusinessEntity]] || 0..1
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise|enterprise]]/'''address'''===
 
Объект содержит данные об адресе расположения поднадзорного объекта.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise/address/country|'''country''']] || Страна, где расположен поднадзорный объект. || [[Country|ikar:Country]] || 1
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise/address/region|'''region''']] || Регион (республика, область, край, автономная область), в котором расположен поднадзорный объект.
* Для городов федерального значения в этом поле указать название города.
|| [[Region|ikar:Region]] || 1
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise/address/district|'''district''']] || Район региона, в котором расположен поднадзорный объект. Заполняется, если поднадзорный объект в городе районного подчинения. || [[District|ikar:District]] || 0..1
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise/address/locality|'''locality''']] || Населённый пункт, в котором расположен поднадзорный объект. В случае, если поднадзорный объект расположен в городе регионального подчинения, требуется указать это поле. Поле district не указывать.|| [[Locality|ikar:Locality]] || 0..1
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise/address/street|'''street''']] || Улица, на которой расположен поднадзорный объект. Обязательно для заполненяи в случае, если площадка расположена в городе федерального значения.|| [[Street|ikar:Street]] || 0..1
|-
| '''addressView''' || Строковое представление адреса. || [[String255|bs:String255]]|| 1
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise|enterprise]]/[[ModifyEnterpriseOperationForVetControl#Объект ..Request/modificationOperation/resultingList/enterprise/address|address]]/'''country'''===
Объект содержит сведения о стране, в которой расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
| Уникальный идентификатор страны в соответствии со справочником РСХН.
| [[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID'''
| Глобальный идентификатор страны в соответствии со справочником РСХН.
| [[UUID|bs:UUID]]
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise|enterprise]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise/address|address]]/'''region'''===
Объект содержит сведения о регионе страны, в котором расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
| Уникальный идентификатор региона страны в соответствии со справочником РСХН. 
|[[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID'''
| Глобальный идентификатор региона страны в соответствии со справочником РСХН.
* Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
| [[UUID|bs:UUID]]
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise|enterprise]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise/address|address]]/'''district'''===
Объект содержит сведения о регионе страны, в котором расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
| Уникальный идентификатор района региона (республики, области, края) в соответствии со справочником РСХН. 
|[[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID'''
| Глобальный идентификатор района региона (республики, области, края) страны в соответствии со справочником РСХН.
* Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
| [[UUID|bs:UUID]]
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise|enterprise]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise/address|address]]/'''locality'''===
Объект содержит сведения о регионе страны, в котором расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
| Уникальный идентификатор города в соответствии со справочником РСХН. 
|[[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID'''
| Глобальный идентификатор города в соответствии со справочником РСХН.
* Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
| [[UUID|bs:UUID]]
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise|enterprise]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise/address|address]]/'''street'''===
Объект содержит сведения о регионе страны, в котором расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
| Уникальный идентификатор улицы города в соответствии со справочником РСХН. 
|[[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID'''
| Глобальный идентификатор улицы города в соответствии со справочником РСХН.
* Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
| [[UUID|bs:UUID]]
|}
 
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise|enterprise]]/'''activityList'''===
Объект содержит информацию о видах деятельности поднадзорного объекта.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Request/modificationOperation/resultingList/enterprise/activityList/activity|'''activity''']] || Деятельность, осуществляемая предприятием, указывается согласно справочнику видов деятельности. || [[EnterpriseActivity|ent:EnterpriseActivity]]|| 1..*
|}
 
'''Атрибуты списка activityList'''
{{Ветис.API EntityList Attributes}}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise|enterprise]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise/activityList|activityList]]/'''activity'''===
Объект содержит информацию о виде деятельности, осуществляемой поднадзорным объектом.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор вида деятельности. || [[UUID|bs:UUID]] || 0..1
|-
| '''name''' || Название вида деятельности. Указывается либо название, либо идентификатор. Если будут указаны оба поля, приоритет за UUID. || [[String255|bs:String255]] || 0..1
|}
 
===Объект [[#Объект modifyEnterpriseRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/enterprise|enterprise]]/'''owner'''===
Объект содержит информацию о хозяйствующем субъекте - собственнике поднадзорного объекта.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
|| Уникальный идентификатор хозяйствующего субъекта.
|| [[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта. || [[UUID|bs:UUID]]
|}
 
==Данные ответа==
<!-- <div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Структура данных ответа в формате XML
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<modifyEnterpriseResponse 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">
    <merc:enterprise>
        <base:uuid>{bs:UUID}</base:uuid>
        <base:guid>4{bs:UUID}</base:guid>
        <base:active>{xs:boolean}</base:active>
        <base:last>{xs:boolean}</base:last>
        <base:status>{xs:integer}</base:status>
        <base:createDate>{xs:dateTime}</base:createDate>
        <base:updateDate>{xs:dateTime}</base:updateDate>
        <ent:name>{bs:String255}</ent:name>
        <ent:type>{xs:integer}</ent:type>
        <ent:address>
            <ikar:country>
                <base:uuid>{bs:UUID}</base:uuid>
                <base:guid>{bs:UUID}</base:guid>
            </ikar:country>
            <ikar:region>
                <base:uuid>{bs:UUID}</base:uuid>
                <base:guid>{bs:UUID}</base:guid>
            </ikar:region>
            <ikar:addressView>{xs:string}</ikar:addressView>
        </ent:address>
        <ent:activityList count="1" total="1" offset="0">
            <ent:activity>
                <ent:name>{xs:string}</ent:name>
            </ent:activity>
        </ent:activityList>
        <ent:owner>
            <base:uuid>{bs:UUID}</base:uuid>
            <base:guid>{bs:UUID}</base:guid>
        </ent:owner>
    </merc:enterprise>
</modifyEnterpriseResponse>
</syntaxhighlight>
</div>
</div> -->
 
===Объект modifyEnterpriseResponse===
Объект содержит сведения о поднадзорном объекте, который был изменен или добавлен.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Response/enterprise|'''enterprise''']] || Элемент содержит сведения о поднадзорным объекте. || [[Enterprise|ent:Enterprise]]
|| 1
|}
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/'''enterprise'''===
Объект содержит подробную информацию о поднадзорном объекте.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор поднадзорного объекта в реестре. || [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор поднадзорного объекта в реестре. || [[UUID|bs:UUID]] || 1
|-
| '''active''' || Является ли запись о поднадзорном объекте активной:
* true - запись активна, т.е. содержит последние (акутальные) данные предприятия;
* false - запись неактивна, т.е. данные предприятия обновлялись, есть более новые версии записи.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
| '''last''' || Является ли запись о поднадзорном объекте последней:
*true - запись последняя;*false - запись не последняя.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
| '''status''' || Текущий статус версии записи реестра поднадзорных объектов. || [[VersionStatus|bs:VersionStatus]] || 1
|-
| '''createDate''' || Дата создания текущей записи в реестре.  || [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 1
|-
| '''updateDate''' || Дата обновления текущей записи реестра. || [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 1
|-
| '''previous''' || Идентификатор предыдущий версии записи реестра поднадзорных объектов.  || [[UUID|bs:UUID]] || 0..1
|-
| '''next''' || Идентификатор следующей версии записи реестра поднадзорных объектов.  || [[UUID|bs:UUID]] || 0..1
|-
| '''name''' || Наименование поднадзорного объекта (предприятия). || [[String255|bs:String255]] || 1
|-
| '''type''' || Тип поднадзорного объекта:
* 1 - предприятие;
* 2 - рынок;
* 3 - СББЖ;
* 4 - судно
|| [[EnterpriseType|ent:EnterpriseType]] || 1
|-
| [[#Объект ..Response/enterprise/address|'''address''']] || Фактический адрес расположения поднадзорного объекта. || [[Address|ikar:Address]] || 1
|-
| [[#Объект ..Response/enterprise/activityList|'''activityList''']] || Список видов деятельности поднадзорного объекта. || [[EnterpriseActivityList|ent:EnterpriseActivityList]] || 1
|-
| [[#Объект ..Response/enterprise/owner|'''owner''']] || Собственник поднадзорного объекта. || [[BusinessEntity|ent:BusinessEntity]] || 1
|}
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/[[#Объект ..Response/enterprise|enterprise]]/'''address'''===
Объект содержит сведения о фактическом адресе поднадзорного объекта.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Response/enterprise/address/country|'''country''']] || Страна, где расположен поднадзорный объект. || [[Country|ikar:Country]] || 1
|-
| [[#Объект ..Response/enterprise/address/region|'''region''']] || Регион страны, где расположен поднадзорный объект. || [[Region|ikar:Region]] || 1
|-
| [[#Объект ..Response/enterprise/address/district|'''district''']] || Район региона страны, где расположен поднадзорный объект. || [[District|ikar:District]] || 0..1
|-
| [[#Объект ..Response/enterprise/address/locality|'''locality''']] || Город регионального подчинения, где расположен поднадзорный объект. || [[Locality|ikar:Locality]] || 0..1
|-
| [[ModifyActivityLocationsOperationForVetControl#Объект ..Response/enterprise/address/street|'''street''']] || Улица города, где расположен поднадзорный объект. || [[Street|ikar:Street]] || 0..1
|-
| '''addressView''' || Строковое представление адреса. || [[String255|bs:String255]] || 1
|}
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/[[#Объект ..Response/enterprise|enterprise]]/[[#Объект ..Response/enterprise/address|address]]/'''country''' ===
Объект содержит данные о стране, в которой расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор страны в соответствии со справочником РСХН. || [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор страны в соответствии со справочником РСХН. || [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/[[#Объект ..Response/enterprise|enterprise]]/[[#Объект ..Response/enterprise/address|address]]/'''region''' ===
Объект содержит данные о регионе страны, где расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор региона страны в соответствии со справочником РСХН.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор региона страны в соответствии со справочником РСХН. || [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/[[#Объект ..Response/enterprise|enterprise]]/[[#Объект ..Response/enterprise/address|address]]/'''district''' ===
Объект содержит данные о районе региона страны, где расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор района региона страны в соответствии со справочником РСХН.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор района региона страны в соответствии со справочником РСХН. || [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/[[#Объект ..Response/enterprise|enterprise]]/[[#Объект ..Response/enterprise/address|address]]/'''locality''' ===
Объект содержит данные о городе регионального подчинения, где расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор города регионального подчинения в соответствии со справочником РСХН.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор города регионального подчинения в соответствии со справочником РСХН. || [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/[[#Объект ..Response/enterprise|enterprise]]/[[#Объект ..Response/enterprise/address|address]]/'''street''' ===
Объект содержит данные о регионе страны, где расположен поднадзорный объект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор улицы города в соответствии со справочником РСХН.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор улицы города в соответствии со справочником РСХН. || [[UUID|bs:UUID]] || 1
|}
 
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/[[#Объект ..Response/enterprise|enterprise]]/'''activityList'''===
Объект содержит сведения о видах деятельности поднадзорного объекта.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Response/enterprise/activityList/activity|'''activity''']] || Вид деятельности, осуществляемый поднадзорным объектом. || [[EnterpriseActivity|ent:EnterpriseActivity]] || 1
|}
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/[[#Объект ..Response/enterprise|enterprise]]/[[#Объект ..Response/enterprise/activityList|activityList]]/'''activity'''===
Объект содержит информацию о виде деятельности, осуществляемым поднадзорным объектом.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''name''' || Название вида деятельности, осуществляемого поднадзорным объектом. || [[String255|bs:String255]] || 1
|-
|}
 
===Объект [[#Объект modifyEnterpriseResponse|..Response]]/[[#Объект ..Response/enterprise|enterprise]]/'''owner'''===
Объект содержит информацию о хозяйствующем-субъекте - собственники поднадзорного объекта.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор хозяйствующего субъекта-собственника в реестре РСХН. || [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта-собственника в реестре РСХН. || [[UUID|bs:UUID]] || 1
|}
 
==Коды ошибок==
{| class="wikitable"
|-
! Код  !! Описание ошибки
|-
| MERC07007 || Хозяйствующий субъект, собственник площадки, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату. 
|-
| MERC07147 || Страна с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC08148 || Регион с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC08149 || Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC07173 || Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
|-
| MERC07179 || Район с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC07183 || В запросе отсутствуют сведения о предприятии.
|-
| MERC07184 || Причина редактирования реестра предприятий обязательна для заполнения.
|-
| MERC07185 || Причина редактирования реестра предприятий превышает допустимую длину текста.
|-
| MERC07186 || Хозяйствующий субъект-владелец обязателен для заполнения.
|-
| MERC07187 || Наименование предприятия обязательно для заполнения.
|-
| MERC07188 || Наименование предприятия превышает допустимую длину текста.
|-
| MERC07189 || Вид аттестованной деятельности предприятия обязателен для заполнения.
|-
| MERC07190 || Адрес предприятия обязателен для заполнения.
|-
| MERC07191 || Адрес предприятия превышает допустимую длину текста.
|-
| MERC07192 || Страна предприятия обязательна для заполнения.
|-
| MERC07193 || Регион предприятия обязателен для заполнения.
|-
| MERC07194 || Район предприятия обязателен для заполнения.
|-
| MERC07195 || Тип предприятия обязателен для заполнения.
|-
| MERC07196 || Для предприятия в качестве страны можно указать только Российскую Федерацию.
|-
| MERC07290 || В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН.
|-
| MERC07291 || В запросе для хозяйствующего субъекта, собственника продукции, указан идентификатор устаревшей версии записи реестра РСХН.
|-
| MERC07294 || В сведениях о населенном пункте указан идентификатор района
|-
| MERC07295 || В сведениях о районе указан идентификатор населенного пункта
|-
| MERC07386 || При добавлении предприятия в качестве владельца указан удалённых хозяйствующий субъект
|-
| MERC08001 || Отредактировать или удалить предприятие может только хозяйствующий субъект-владелец или хозяйствующий субъект, добавивший это предприятие.
|-
| MERC08007 || Хозяйствующий субъект, собственник продукции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC08147 || Страна с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC08148 || Регион с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC08149 || Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC08173 || Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
|-
| MERC08179 || Район с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC08180 || Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC08181 || В запросе для предприятия указан идентификатор устаревшей версии записи реестра РСХН.
|-
| MERC08182 || Идентификатор предприятия (UUID) обязателен для заполнения.
|-
| MERC08183 || В запросе отсутствуют сведения о предприятии.
|-
| MERC08184 || Причина редактирования реестра предприятий обязательна для заполнения.
|-
| MERC08185 || Причина редактирования реестра предприятий превышает допустимую длину текста.
|-
| MERC08186 || Хозяйствующий субъект-владелец обязателен для заполнения.
|-
| MERC08187 || Наименование предприятия обязательно для заполнения.
|-
| MERC08188 || Наименование предприятия превышает допустимую длину текста.
|-
| MERC08189 || Вид аттестованной деятельности предприятия обязателен для заполнения.
|-
| MERC08190 || Адрес предприятия обязателен для заполнения.
|-
| MERC08191 || Адрес предприятия превышает допустимую длину текста.
|-
| MERC08192 || Страна предприятия обязательна для заполнения.
|-
| MERC08193 || Регион предприятия обязателен для заполнения.
|-
| MERC08194|| Район предприятия обязателен для заполнения. 
|-
| MERC08195 || Тип предприятия обязателен для заполнения.
|-
| MERC08196 || Для предприятия в качестве страны можно указать только Российскую Федерацию.
|-
| MERC08290 || В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН.
|-
| MERC08291 || В запросе для хозяйствующего субъекта, собственника продукции, указан идентификатор устаревшей версии записи реестра РСХН.
|-
| MERC08294 || В сведениях о населенном пункте указан идентификатор района
|-
| MERC08295 || В сведениях о районе указан идентификатор населенного пункта 
|-
| MERC09001 || Отредактировать или удалить предприятие может только хозяйствующий субъект-владелец или хозяйствующий субъект, добавивший это предприятие.
|-
| MERC09007 || Хозяйствующий субъект, собственник продукции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC09149 || Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC09173 || Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
|-
| MERC09180 || Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC09181 || В запросе для предприятия указан идентификатор устаревшей версии записи реестра РСХН.
|-
| MERC09182 || Идентификатор предприятия (UUID) обязателен для заполнения.
|-
| MERC09183 || В запросе отсутствуют сведения о предприятии. 
|-
| MERC09184 || Причина редактирования реестра предприятий обязательна для заполнения.
|-
| MERC08185 || Причина редактирования реестра предприятий превышает допустимую длину текста.
|-
| MERC09186 || Хозяйствующий субъект-владелец обязателен для заполнения.
|-
| MERC09196 || Для предприятия в качестве страны можно указать только Российскую Федерацию. 
|-
| MERC09290 || В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН. 
|-
| MERC08291 || В запросе для хозяйствующего субъекта, собственника продукции, указан идентификатор устаревшей версии записи реестра РСХН. 
 
|}
 
==Примеры запросов==
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id="scenario1">[[#createEnterprise|Создание поднадзорного объекта - для ветеринарных управлений]]</div>
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<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:modifyEnterpriseRequest>
                  <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                  <mercvu:initiator>
                      <com:login>user</com:login>
                  </mercvu:initiator>
                  <mercvu:modificationOperation>
                      <ent:type>CREATE</ent:type>
                      <ent:resultingList count="1" total="1" offset="0">
                      <ent:enterprise>
                          <ent:name>Сыроежка</ent:name>
                          <ent:type>1</ent:type>
                          <ent:address>
                              <ikar:country>
                                  <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                              </ikar:country>
                              <ikar:region>
                                  <base:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</base:guid>
                              </ikar:region>
                              <ikar:locality>
                                  <base:guid>f66a00e6-179e-4de9-8ecb-78b0277c9f10</base:guid>
                              </ikar:locality>
                              <ikar:addressView> ул. 18 лет Октября, д.205</ikar:addressView>
                          </ent:address>
                          <ent:activityList count="1" total="1" offset="0">
                            <ent:activity>
                                <ent:name>Приготовление полуфабрикатов</ent:name>
                            </ent:activity>
                            <ent:activity>
                                <ent:name>Реализация пищевых продуктов</ent:name>
                            </ent:activity>
                            <ent:activity>
                                <ent:name>Реализация непищевых продуктов</ent:name>
                            </ent:activity>
                        </ent:activityList>
                        <ent:owner>
                            <base:guid>f8f0ea41-2124-4666-8a54-170bdb11f8c1</base:guid>
                        </ent:owner>
                    </ent:enterprise>       
              </ent:resultingList>
              <ent:reason>Причина добавления предприятия в реестр</ent:reason>
          </mercvu:modificationOperation>
        </mercvu:modifyEnterpriseRequest>
      </app:data>
    </app:application>
  </ws:submitApplicationRequest>
</soapenv:Body>
</soapenv:Envelope>
 
</syntaxhighlight>
</div>
</div><br />
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id = "scenario2">[[#changeEnterprise|Редактирование поднадзорного объекта - для ветеринарных управлений]]</div>
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<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:modifyEnterpriseRequest>
                    <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                    <mercvu:initiator>
                        <com:login>mercury_user</com:login>
                    </mercvu:initiator>
                    <mercvu:modificationOperation>
                        <ent:type>UPDATE</ent:type>
                        <ent:resultingList count="1" total="1" offset="0">
                            <ent:enterprise>
                                <base:uuid>8c667140-f9f5-4927-b2c1-caf3b191244e</base:uuid>
                                <ent:name>Сыроежка</ent:name>
                                <ent:type>1</ent:type>
                                <ent:address>
                                    <ikar:country>
                                        <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                                    </ikar:country>
                                    <ikar:region>
                                        <base:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</base:guid>
                                    </ikar:region>
                                    <ikar:locality>
                                        <base:guid>f66a00e6-179e-4de9-8ecb-78b0277c9f10</base:guid>
                                    </ikar:locality>
                                    <ikar:addressView>г.Владимир, ул.20 лет Октября, д.12</ikar:addressView>
                                </ent:address>
                                <ent:activityList count="1" total="1" offset="0">
                                    <ent:activity>
                                        <ent:name>Приготовление полуфабрикатов</ent:name>
                                    </ent:activity>
                                    <ent:activity>
                                        <ent:name>Реализация пищевых продуктов</ent:name>
                                    </ent:activity>
                                    <ent:activity>
                                        <ent:name>Реализация непищевых продуктов</ent:name>
                                    </ent:activity>
                              </ent:activityList>
                              <ent:owner>
                                  <base:guid>f8f0ea41-2124-4666-8a54-170bdb11f8c1</base:guid>
                              </ent:owner>
                        </ent:enterprise>       
                    </ent:resultingList>
                    <ent:reason>Причина изменения записи в реестре</ent:reason>
                </mercvu:modificationOperation>
            </mercvu:modifyEnterpriseRequest>
          </app:data>
      </app:application>
    </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id="scenario1">[[#createEnterprise|Создание поднадзорного объекта - для хозяйствующих субъектов]]</div>
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<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:modifyEnterpriseRequest>
                  <merc:localTransactionId>a10003</merc:localTransactionId>
                  <merc:initiator>
                      <com:login>user</com:login>
                  </merc:initiator>
                  <merc:modificationOperation>
                      <ent:type>CREATE</ent:type>
                      <ent:resultingList count="1" total="1" offset="0">
                      <ent:enterprise>
                          <ent:name>Сыроежка</ent:name>
                          <ent:type>1</ent:type>
                          <ent:address>
                              <ikar:country>
                                  <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                              </ikar:country>
                              <ikar:region>
                                  <base:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</base:guid>
                              </ikar:region>
                              <ikar:locality>
                                  <base:guid>f66a00e6-179e-4de9-8ecb-78b0277c9f10</base:guid>
                              </ikar:locality>
                              <ikar:addressView> ул. 18 лет Октября, д.205</ikar:addressView>
                          </ent:address>
                          <ent:activityList count="1" total="1" offset="0">
                            <ent:activity>
                                <ent:name>Приготовление полуфабрикатов</ent:name>
                            </ent:activity>
                            <ent:activity>
                                <ent:name>Реализация пищевых продуктов</ent:name>
                            </ent:activity>
                            <ent:activity>
                                <ent:name>Реализация непищевых продуктов</ent:name>
                            </ent:activity>
                        </ent:activityList>
                        <ent:owner>
                            <base:guid>f8f0ea41-2124-4666-8a54-170bdb11f8c1</base:guid>
                        </ent:owner>
                    </ent:enterprise>       
              </ent:resultingList>
              <ent:reason>Причина добавления предприятия в реестр</ent:reason>
          </merc:modificationOperation>
        </merc:modifyEnterpriseRequest>
      </app:data>
    </app:application>
  </ws:submitApplicationRequest>
</soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id = "scenario2">[[#changeEnterprise|Редактирование поднадзорного объекта - для хозяйствующих субъектов]]</div>
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<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:bs="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:modifyEnterpriseRequest>
                    <merc:localTransactionId>a10003</merc:localTransactionId>
                    <merc:initiator>
                        <com:login>mercury_user</com:login>
                    </merc:initiator>
                    <merc:modificationOperation>
                        <ent:type>UPDATE</ent:type>
                        <ent:resultingList count="1" total="1" offset="0">
                            <ent:enterprise>
                                <base:uuid>8c667140-f9f5-4927-b2c1-caf3b191244e</base:uuid>
                                <ent:name>Сыроежка</ent:name>
                                <ent:type>1</ent:type>
                                <ent:address>
                                    <ikar:country>
                                        <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                                    </ikar:country>
                                    <ikar:region>
                                        <base:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</base:guid>
                                    </ikar:region>
                                    <ikar:locality>
                                        <base:guid>f66a00e6-179e-4de9-8ecb-78b0277c9f10</base:guid>
                                    </ikar:locality>
                                    <ikar:addressView>г.Владимир, ул.20 лет Октября, д.12</ikar:addressView>
                                </ent:address>
                                <ent:activityList count="1" total="1" offset="0">
                                    <ent:activity>
                                        <ent:name>Приготовление полуфабрикатов</ent:name>
                                    </ent:activity>
                                    <ent:activity>
                                        <ent:name>Реализация пищевых продуктов</ent:name>
                                    </ent:activity>
                                    <ent:activity>
                                        <ent:name>Реализация непищевых продуктов</ent:name>
                                    </ent:activity>
                              </ent:activityList>
                              <ent:owner>
                                  <base:guid>f8f0ea41-2124-4666-8a54-170bdb11f8c1</base:guid>
                              </ent:owner>
                        </ent:enterprise>       
                    </ent:resultingList>
                    <ent:reason>Причина изменения записи в реестре</ent:reason>
                </merc:modificationOperation>
            </merc:modifyEnterpriseRequest>
          </app:data>
      </app:application>
    </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
 
 
[[Category:Ветис.API]]
[[Category:Изменение реестра поднадзорных объектов]]
[[Category:Ветис.API для ветеринарных управлений]]

Текущая версия на 14:30, 30 мая 2017

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

Операция ModifyEnterpriseOperation предназначена для регистрации новых площадок (поднадзорных объектов), где хозяйствующий субъект осуществляет свою деятельность, а так же для изменения информации об уже зарегистрированных поднадзорных объектах. Поднадзорный объект (площадка) может быть следующих типов:

  • предприятие;
  • рынок;
  • СББЖ;
  • судно.

Реестр поднадзорных объектов ведется с применением версионирования, это означает, что запись об одной площадке может иметь несколько версий. При каждом изменении записи реестра создается новая версия этой записи. То есть при регистрации нового поднадзорного объекта создаётся новая запись, а если информация о площадке изменяется, то в реестр вносится ещё одна версия записи.

Идентификация каждой записи производится по следующим полям:

  • GUID - глобальный идентификатор записи. Данный идентификатор остается неизменным для всех версий записи о поднадзорном объекте.
  • UUID - идентификатор версии записи. Данный идентификатор изменяется для каждой новой версии записи о поднадзорном объекте.

При создании каждой новой версии записи о поднадзорном объекте, старая версия записи становится неактивной и должна ссылаться на новую версию, а новая — на старую. Таким образом, возможно восстановить историю изменений. Для одной записи журнала может существовать только одна актуальная версия.

При выполнении операции ModifyEnterpriseOperation на вход системы передаются следующие сведения:

  • информация о пользователе - инициаторе запроса;
  • тип операции (добавление или изменение);
  • информация о поднадзорном объекте (название площадки, адрес, вид деятельности и другие данные, характеризующие поднадзорный объект).

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

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

1.1. Внесение в реестр поднадзорного объекта.
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

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

Объект modifyEnterpriseRequest

Корневой элемент содержимого заявки. Содержит сведения для выполнения операции добавления/изменения сведений в реестре поднадзорных объектов.

Поле Описание Тип данных Обязательность
localTransactionId Идентификатор заявки в клиентской системе. xs:NCName 1
initiator Пользователь, инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин. argc:User 1
modificationOperation Описание операции добавления/изменения информации о поднадзорном объекте. ent:BEModificationOperation 1

Объект ..Request/initiator

Содержит сведения о пользователе, зарегистрированном в системе Меркурий и инициирующим запрос к шлюзу.

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

При указании обоих полей, приоритет у UUID.

login Логин пользователя. xs:NCName

Объект ..Request/modificationOperation

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

Поле Описание Тип данных Обязательность
type Тип операции. На данный момент доступны операции двух типов:
  • CREATE - создание поднадзорного объекта;
  • UPDATE - обновление данных поднадзорного объекта.
 bs:RegisterModificationType 1
resultingList Список, который содержит сведения о добавляемых поднадзорных объектах. На данный момент поддерживается добавление только одной площадки в рамках одной заявки. ent:EnterpriseList 1
reason Основание добавления/изменения записи в реестре. На этапе формирования справочника указывается текстом, далее в данном поле будет передаваться строковый код из справочника. ent:ENTModificationReason 1

Объект ..Request/modificationOperation/resultingList

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

Поле Описание Тип данных Обязательность
enterprise Элемент, содержащий информацию о поднадзорном объекте. ent:Enterprise 1

Атрибуты списка resultingList

Атрибут Описание Тип данных Обязательность
count Количество элементов списка, запрашиваемое или переданное. xs:int 1
total Общий размер списка. xs:long 1
offset Смещение первого элемента списка относительно его начала. xs:int 1

Объект ..Request/modificationOperation/resultingList/enterprise

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

Поле Описание Тип данных Обязательность
UUID Идентификатор поднадзорного объекта.
  • Указывается в случае изменения данных о поднадзорном объекте (UPDATE).
 bs:UUID 0..1
name Полное наименование создаваемого/редактируемого поднадзорного объекта. bs:String255 1
type Тип поднадзорного объекта:
  • 1 - предприятие;
  • 2 - рынок;
  • 3 - СББЖ;
  • 4 - судно.
 ent:EnterpriseType 1
address Фактический адрес расположения поднадзорного объекта.
  • Обязательно указывать только при создании предприятия.
  • При редактировании данных предприятия необязателен к указанию.
 ikar:Address 0..1
activityList Виды деятельности поднадзорного объекта, согласно справочнику. Указывается либо идентификатор, либо название текстом. ent:EnterpriseActivityList 1
owner Собственник поднадзорного объекта. На данный момент площадку может добавлять не только хозяйствующий субъект-владелец, но и другие хозяйствующие субъекты, по этой причине необходимо указывать собственника. ent:BusinessEntity 0..1

Объект ..Request/modificationOperation/resultingList/enterprise/address

Объект содержит данные об адресе расположения поднадзорного объекта.

Поле Описание Тип данных Обязательность
country Страна, где расположен поднадзорный объект. ikar:Country 1
region Регион (республика, область, край, автономная область), в котором расположен поднадзорный объект.
  • Для городов федерального значения в этом поле указать название города.
 ikar:Region 1
district Район региона, в котором расположен поднадзорный объект. Заполняется, если поднадзорный объект в городе районного подчинения. ikar:District 0..1
locality Населённый пункт, в котором расположен поднадзорный объект. В случае, если поднадзорный объект расположен в городе регионального подчинения, требуется указать это поле. Поле district не указывать. ikar:Locality 0..1
street Улица, на которой расположен поднадзорный объект. Обязательно для заполненяи в случае, если площадка расположена в городе федерального значения. ikar:Street 0..1
addressView Строковое представление адреса. bs:String255 1

Объект ..Request/modificationOperation/resultingList/enterprise/address/country

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

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор страны в соответствии со справочником РСХН. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор страны в соответствии со справочником РСХН. bs:UUID

Объект ..Request/modificationOperation/resultingList/enterprise/address/region

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

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор региона страны в соответствии со справочником РСХН. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор региона страны в соответствии со справочником РСХН.
  • Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
 bs:UUID

Объект ..Request/modificationOperation/resultingList/enterprise/address/district

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

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор района региона (республики, области, края) в соответствии со справочником РСХН. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор района региона (республики, области, края) страны в соответствии со справочником РСХН.
  • Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
 bs:UUID

Объект ..Request/modificationOperation/resultingList/enterprise/address/locality

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

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор города в соответствии со справочником РСХН. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор города в соответствии со справочником РСХН.
  • Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
 bs:UUID

Объект ..Request/modificationOperation/resultingList/enterprise/address/street

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

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор улицы города в соответствии со справочником РСХН. bs:UUID 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор улицы города в соответствии со справочником РСХН.
  • Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
 bs:UUID


Объект ..Request/modificationOperation/resultingList/enterprise/activityList

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

Поле Описание Тип данных Обязательность
activity Деятельность, осуществляемая предприятием, указывается согласно справочнику видов деятельности. ent:EnterpriseActivity 1..*

Атрибуты списка activityList

Атрибут Описание Тип данных Обязательность
count Количество элементов списка, запрашиваемое или переданное. xs:int 1
total Общий размер списка. xs:long 1
offset Смещение первого элемента списка относительно его начала. xs:int 1

Объект ..Request/modificationOperation/resultingList/enterprise/activityList/activity

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

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор вида деятельности. bs:UUID 0..1
name Название вида деятельности. Указывается либо название, либо идентификатор. Если будут указаны оба поля, приоритет за UUID. bs:String255 0..1

Объект ..Request/modificationOperation/resultingList/enterprise/owner

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

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

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор хозяйствующего субъекта. bs:UUID

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

Объект modifyEnterpriseResponse

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

Поле Описание Тип данных Обязательность
enterprise Элемент содержит сведения о поднадзорным объекте. ent:Enterprise 1

Объект ..Response/enterprise

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

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор поднадзорного объекта в реестре. bs:UUID 1
GUID Глобальный идентификатор поднадзорного объекта в реестре. bs:UUID 1
active Является ли запись о поднадзорном объекте активной:
  • true - запись активна, т.е. содержит последние (акутальные) данные предприятия;
  • false - запись неактивна, т.е. данные предприятия обновлялись, есть более новые версии записи.
 xs:boolean 1
last Является ли запись о поднадзорном объекте последней:
  • true - запись последняя;*false - запись не последняя.
 xs:boolean 1
status Текущий статус версии записи реестра поднадзорных объектов. bs:VersionStatus 1
createDate Дата создания текущей записи в реестре. xs:dateTime 1
updateDate Дата обновления текущей записи реестра. xs:dateTime 1
previous Идентификатор предыдущий версии записи реестра поднадзорных объектов. bs:UUID 0..1
next Идентификатор следующей версии записи реестра поднадзорных объектов. bs:UUID 0..1
name Наименование поднадзорного объекта (предприятия). bs:String255 1
type Тип поднадзорного объекта:
  • 1 - предприятие;
  • 2 - рынок;
  • 3 - СББЖ;
  • 4 - судно
 ent:EnterpriseType 1
address Фактический адрес расположения поднадзорного объекта. ikar:Address 1
activityList Список видов деятельности поднадзорного объекта. ent:EnterpriseActivityList 1
owner Собственник поднадзорного объекта. ent:BusinessEntity 1

Объект ..Response/enterprise/address

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

Поле Описание Тип данных Обязательность
country Страна, где расположен поднадзорный объект. ikar:Country 1
region Регион страны, где расположен поднадзорный объект. ikar:Region 1
district Район региона страны, где расположен поднадзорный объект. ikar:District 0..1
locality Город регионального подчинения, где расположен поднадзорный объект. ikar:Locality 0..1
street Улица города, где расположен поднадзорный объект. ikar:Street 0..1
addressView Строковое представление адреса. bs:String255 1

Объект ..Response/enterprise/address/country

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

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор страны в соответствии со справочником РСХН. bs:UUID 1
GUID Глобальный идентификатор страны в соответствии со справочником РСХН. bs:UUID 1

Объект ..Response/enterprise/address/region

Объект содержит данные о регионе страны, где расположен поднадзорный объект.

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор региона страны в соответствии со справочником РСХН. bs:UUID 1
GUID Глобальный идентификатор региона страны в соответствии со справочником РСХН. bs:UUID 1

Объект ..Response/enterprise/address/district

Объект содержит данные о районе региона страны, где расположен поднадзорный объект.

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор района региона страны в соответствии со справочником РСХН. bs:UUID 1
GUID Глобальный идентификатор района региона страны в соответствии со справочником РСХН. bs:UUID 1

Объект ..Response/enterprise/address/locality

Объект содержит данные о городе регионального подчинения, где расположен поднадзорный объект.

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор города регионального подчинения в соответствии со справочником РСХН. bs:UUID 1
GUID Глобальный идентификатор города регионального подчинения в соответствии со справочником РСХН. bs:UUID 1

Объект ..Response/enterprise/address/street

Объект содержит данные о регионе страны, где расположен поднадзорный объект.

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор улицы города в соответствии со справочником РСХН. bs:UUID 1
GUID Глобальный идентификатор улицы города в соответствии со справочником РСХН. bs:UUID 1


Объект ..Response/enterprise/activityList

Объект содержит сведения о видах деятельности поднадзорного объекта.

Поле Описание Тип данных Обязательность
activity Вид деятельности, осуществляемый поднадзорным объектом. ent:EnterpriseActivity 1

Объект ..Response/enterprise/activityList/activity

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

Поле Описание Тип данных Обязательность
name Название вида деятельности, осуществляемого поднадзорным объектом. bs:String255 1

Объект ..Response/enterprise/owner

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

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

Коды ошибок

Код Описание ошибки
MERC07007 Хозяйствующий субъект, собственник площадки, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC07147 Страна с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC08148 Регион с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC08149 Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC07173 Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
MERC07179 Район с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC07183 В запросе отсутствуют сведения о предприятии.
MERC07184 Причина редактирования реестра предприятий обязательна для заполнения.
MERC07185 Причина редактирования реестра предприятий превышает допустимую длину текста.
MERC07186 Хозяйствующий субъект-владелец обязателен для заполнения.
MERC07187 Наименование предприятия обязательно для заполнения.
MERC07188 Наименование предприятия превышает допустимую длину текста.
MERC07189 Вид аттестованной деятельности предприятия обязателен для заполнения.
MERC07190 Адрес предприятия обязателен для заполнения.
MERC07191 Адрес предприятия превышает допустимую длину текста.
MERC07192 Страна предприятия обязательна для заполнения.
MERC07193 Регион предприятия обязателен для заполнения.
MERC07194 Район предприятия обязателен для заполнения.
MERC07195 Тип предприятия обязателен для заполнения.
MERC07196 Для предприятия в качестве страны можно указать только Российскую Федерацию.
MERC07290 В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН.
MERC07291 В запросе для хозяйствующего субъекта, собственника продукции, указан идентификатор устаревшей версии записи реестра РСХН.
MERC07294 В сведениях о населенном пункте указан идентификатор района
MERC07295 В сведениях о районе указан идентификатор населенного пункта
MERC07386 При добавлении предприятия в качестве владельца указан удалённых хозяйствующий субъект
MERC08001 Отредактировать или удалить предприятие может только хозяйствующий субъект-владелец или хозяйствующий субъект, добавивший это предприятие.
MERC08007 Хозяйствующий субъект, собственник продукции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC08147 Страна с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC08148 Регион с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC08149 Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC08173 Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
MERC08179 Район с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC08180 Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC08181 В запросе для предприятия указан идентификатор устаревшей версии записи реестра РСХН.
MERC08182 Идентификатор предприятия (UUID) обязателен для заполнения.
MERC08183 В запросе отсутствуют сведения о предприятии.
MERC08184 Причина редактирования реестра предприятий обязательна для заполнения.
MERC08185 Причина редактирования реестра предприятий превышает допустимую длину текста.
MERC08186 Хозяйствующий субъект-владелец обязателен для заполнения.
MERC08187 Наименование предприятия обязательно для заполнения.
MERC08188 Наименование предприятия превышает допустимую длину текста.
MERC08189 Вид аттестованной деятельности предприятия обязателен для заполнения.
MERC08190 Адрес предприятия обязателен для заполнения.
MERC08191 Адрес предприятия превышает допустимую длину текста.
MERC08192 Страна предприятия обязательна для заполнения.
MERC08193 Регион предприятия обязателен для заполнения.
MERC08194 Район предприятия обязателен для заполнения.
MERC08195 Тип предприятия обязателен для заполнения.
MERC08196 Для предприятия в качестве страны можно указать только Российскую Федерацию.
MERC08290 В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН.
MERC08291 В запросе для хозяйствующего субъекта, собственника продукции, указан идентификатор устаревшей версии записи реестра РСХН.
MERC08294 В сведениях о населенном пункте указан идентификатор района
MERC08295 В сведениях о районе указан идентификатор населенного пункта
MERC09001 Отредактировать или удалить предприятие может только хозяйствующий субъект-владелец или хозяйствующий субъект, добавивший это предприятие.
MERC09007 Хозяйствующий субъект, собственник продукции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC09149 Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC09173 Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
MERC09180 Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC09181 В запросе для предприятия указан идентификатор устаревшей версии записи реестра РСХН.
MERC09182 Идентификатор предприятия (UUID) обязателен для заполнения.
MERC09183 В запросе отсутствуют сведения о предприятии.
MERC09184 Причина редактирования реестра предприятий обязательна для заполнения.
MERC08185 Причина редактирования реестра предприятий превышает допустимую длину текста.
MERC09186 Хозяйствующий субъект-владелец обязателен для заполнения.
MERC09196 Для предприятия в качестве страны можно указать только Российскую Федерацию.
MERC09290 В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН.
MERC08291 В запросе для хозяйствующего субъекта, собственника продукции, указан идентификатор устаревшей версии записи реестра РСХН.

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

<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:modifyEnterpriseRequest>
                   <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                   <mercvu:initiator>
                      <com:login>user</com:login>
                   </mercvu:initiator>
                   <mercvu:modificationOperation>
                       <ent:type>CREATE</ent:type>
                       <ent:resultingList count="1" total="1" offset="0">
                       <ent:enterprise>
                           <ent:name>Сыроежка</ent:name> 
                           <ent:type>1</ent:type> 
                           <ent:address>
                               <ikar:country>
                                   <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                               </ikar:country>
                               <ikar:region>
                                   <base:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</base:guid>
                               </ikar:region>
                               <ikar:locality>
                                   <base:guid>f66a00e6-179e-4de9-8ecb-78b0277c9f10</base:guid>
                               </ikar:locality>
                               <ikar:addressView> ул. 18 лет Октября, д.205</ikar:addressView>
                          </ent:address>
                          <ent:activityList count="1" total="1" offset="0">
                             <ent:activity>
                                 <ent:name>Приготовление полуфабрикатов</ent:name>
                             </ent:activity>
                             <ent:activity>
                                <ent:name>Реализация пищевых продуктов</ent:name>
                             </ent:activity>
                             <ent:activity>
                                 <ent:name>Реализация непищевых продуктов</ent:name>
                             </ent:activity>
                         </ent:activityList>
                         <ent:owner>
                            <base:guid>f8f0ea41-2124-4666-8a54-170bdb11f8c1</base:guid>
                         </ent:owner> 
                    </ent:enterprise>         
              </ent:resultingList>
              <ent:reason>Причина добавления предприятия в реестр</ent:reason>
           </mercvu:modificationOperation>
        </mercvu:modifyEnterpriseRequest>
      </app:data>
    </app:application>
   </ws:submitApplicationRequest>
 </soapenv:Body>
</soapenv:Envelope>



<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:modifyEnterpriseRequest>
                    <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                    <mercvu:initiator>
                        <com:login>mercury_user</com:login>
                    </mercvu:initiator>
                    <mercvu:modificationOperation>
                         <ent:type>UPDATE</ent:type>
                         <ent:resultingList count="1" total="1" offset="0">
                             <ent:enterprise>
                                 <base:uuid>8c667140-f9f5-4927-b2c1-caf3b191244e</base:uuid>
                                 <ent:name>Сыроежка</ent:name> 
                                 <ent:type>1</ent:type> 
                                 <ent:address>
                                     <ikar:country>
                                         <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                                     </ikar:country>
                                     <ikar:region>
                                         <base:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</base:guid>
                                     </ikar:region>
                                     <ikar:locality>
                                         <base:guid>f66a00e6-179e-4de9-8ecb-78b0277c9f10</base:guid>
                                     </ikar:locality>
                                     <ikar:addressView>г.Владимир, ул.20 лет Октября, д.12</ikar:addressView>
                                </ent:address>
                                <ent:activityList count="1" total="1" offset="0">
                                    <ent:activity>
                                        <ent:name>Приготовление полуфабрикатов</ent:name>
                                    </ent:activity>
                                    <ent:activity>
                                        <ent:name>Реализация пищевых продуктов</ent:name>
                                    </ent:activity>
                                    <ent:activity>
                                        <ent:name>Реализация непищевых продуктов</ent:name>
                                    </ent:activity>
                               </ent:activityList>
                               <ent:owner>
                                   <base:guid>f8f0ea41-2124-4666-8a54-170bdb11f8c1</base:guid>
                               </ent:owner> 
                         </ent:enterprise>         
                     </ent:resultingList>
                     <ent:reason>Причина изменения записи в реестре</ent:reason>
                </mercvu:modificationOperation>
            </mercvu:modifyEnterpriseRequest>
          </app:data>
      </app:application>
    </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>



<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:modifyEnterpriseRequest>
                   <merc:localTransactionId>a10003</merc:localTransactionId>
                   <merc:initiator>
                      <com:login>user</com:login>
                   </merc:initiator>
                   <merc:modificationOperation>
                       <ent:type>CREATE</ent:type>
                       <ent:resultingList count="1" total="1" offset="0">
                       <ent:enterprise>
                           <ent:name>Сыроежка</ent:name> 
                           <ent:type>1</ent:type> 
                           <ent:address>
                               <ikar:country>
                                   <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                               </ikar:country>
                               <ikar:region>
                                   <base:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</base:guid>
                               </ikar:region>
                               <ikar:locality>
                                   <base:guid>f66a00e6-179e-4de9-8ecb-78b0277c9f10</base:guid>
                               </ikar:locality>
                               <ikar:addressView> ул. 18 лет Октября, д.205</ikar:addressView>
                          </ent:address>
                          <ent:activityList count="1" total="1" offset="0">
                             <ent:activity>
                                 <ent:name>Приготовление полуфабрикатов</ent:name>
                             </ent:activity>
                             <ent:activity>
                                <ent:name>Реализация пищевых продуктов</ent:name>
                             </ent:activity>
                             <ent:activity>
                                 <ent:name>Реализация непищевых продуктов</ent:name>
                             </ent:activity>
                         </ent:activityList>
                         <ent:owner>
                            <base:guid>f8f0ea41-2124-4666-8a54-170bdb11f8c1</base:guid>
                         </ent:owner> 
                    </ent:enterprise>         
              </ent:resultingList>
              <ent:reason>Причина добавления предприятия в реестр</ent:reason>
           </merc:modificationOperation>
        </merc:modifyEnterpriseRequest>
      </app:data>
    </app:application>
   </ws:submitApplicationRequest>
 </soapenv:Body>
</soapenv:Envelope>



<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:bs="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:modifyEnterpriseRequest>
                    <merc:localTransactionId>a10003</merc:localTransactionId>
                    <merc:initiator>
                        <com:login>mercury_user</com:login>
                    </merc:initiator>
                    <merc:modificationOperation>
                         <ent:type>UPDATE</ent:type>
                         <ent:resultingList count="1" total="1" offset="0">
                             <ent:enterprise>
                                 <base:uuid>8c667140-f9f5-4927-b2c1-caf3b191244e</base:uuid>
                                 <ent:name>Сыроежка</ent:name> 
                                 <ent:type>1</ent:type> 
                                 <ent:address>
                                     <ikar:country>
                                         <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                                     </ikar:country>
                                     <ikar:region>
                                         <base:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</base:guid>
                                     </ikar:region>
                                     <ikar:locality>
                                         <base:guid>f66a00e6-179e-4de9-8ecb-78b0277c9f10</base:guid>
                                     </ikar:locality>
                                     <ikar:addressView>г.Владимир, ул.20 лет Октября, д.12</ikar:addressView>
                                </ent:address>
                                <ent:activityList count="1" total="1" offset="0">
                                    <ent:activity>
                                        <ent:name>Приготовление полуфабрикатов</ent:name>
                                    </ent:activity>
                                    <ent:activity>
                                        <ent:name>Реализация пищевых продуктов</ent:name>
                                    </ent:activity>
                                    <ent:activity>
                                        <ent:name>Реализация непищевых продуктов</ent:name>
                                    </ent:activity>
                               </ent:activityList>
                               <ent:owner>
                                   <base:guid>f8f0ea41-2124-4666-8a54-170bdb11f8c1</base:guid>
                               </ent:owner> 
                         </ent:enterprise>         
                     </ent:resultingList>
                     <ent:reason>Причина изменения записи в реестре</ent:reason>
                </merc:modificationOperation>
            </merc:modifyEnterpriseRequest>
          </app:data>
      </app:application>
    </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>
Источник — http://help.vetrf.ru/index.php?title=ModifyEnterpriseOperation&oldid=20296