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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(Egorova-iv-150707 переименовал страницу ModifyBusinessEntityOperation в ModifyBusinessEntityOperation v1.2)
 
Строка 1: Строка 1:
#перенаправление [[ModifyBusinessEntityOperation v1.2]]
==Общие сведения==
Операция '''ModifyBusinessEntityOperation''' предназначена для регистрации новых хозяйствующих субъектов в реестре, а так же  для изменения информации об уже зарегистрированных.
Хозяйствующий субъект может быть трех типов:
* юридическое лицо;
* индивидуальный предприниматель/КФХ;
* физическое лицо.
 
Реестр хозяйствующих субъектов ведется с применением версионирования, это означает, что запись об одном лице может иметь несколько версий. При каждом изменении записи реестра создается новая версия этой записи. То есть при регистрации нового хозяйствующего субъекта создаётся новая запись, а если информация о хозяйствующем субъекте изменяется, то в реестр вносится ещё одна версия записи.
 
Идентификация  каждой  записи  производится  по следующим полям:
* GUID - глобальный идентификатор записи. Данный идентификатор остается неизменным для всех версий записи о хозяйствующем субъекте.
* UUID - идентификатор версии записи. Данный идентификатор изменяется для каждой новой версии записи о хозяйствующем субъекте.
При создании каждой новой версии записи о хозяйствующем субъекте, старая версия записи становится неактивной и должна ссылаться на новую версию, а новая — на старую. Таким образом, возможно восстановить историю изменений.
Для одной записи журнала может существовать только одна актуальная версия.
 
При выполнении операции '''ModifyBusinessEntityOperation''' на вход системы передаются следующие сведения:
* информация о пользователе - инициаторе запроса;
* тип операции (добавление, поиск или изменение);
* информация о хозяйствующем субъекте (организационно-правовая форма, ИНН, ОГРН, КПП  и другие данные, характеризующие организацию или физическое лицо).
 
Результатом выполнения данной операции является добавление записи о новом хозяйствующем субъекте в реестре или внесение изменений в существующую запись.
 
===Возможные сценарии===
При выполнении операции возможны следующие сценарии:<br />
1. Создание хозяйствующего субъекта.
:1.1. В реестр можно внести три типа хозяйствующих субъектов:<br />
::* <div id ="legalEntity">[[#scenario1|юридическое лицо]];</div>
::* <div id = "physicalPerson">[[#scenario2|физическое лицо]];</div>
::* <div id="entrepreneur">[[#scenario3|индивидуального предпринимателя]]. </div>
:1.2. Ошибка обработки запроса, в случае, если хозяйствующих субъект с указанными данными уже существует.
<div id="changeData">2. [[#scenario4|Изменение данных хозяйствующего субъекта]].</div>
<div id="search">3. [[#scenario5|Поиск хозяйствующего субъекта по ИНН и ОГРН]]. Пользователь передает сведения о хозяйствующем субъекте и в реестре осуществляется поиск по этим данным. В случае, если запрашиваемый хозяйствующий субъект уже существует, то пользователю возвращается информация об этом хозяйствующем субъекте. Если хозяйствующего субъекта с указанными данными нет в реестре, то в реестр добавляется соответствующая запись.</div>
 
===Используемые пространства имён и типы===
{{столбцы}}
{{столбец}}
*[[NameSpaces#http://api.vetrf.ru/schema/cdm/cerberus/enterprise|enterprise]] (<nowiki>http://api.vetrf.ru/schema/cdm/cerberus/enterprise</nowiki>)
** [[ProducerList|ent:ProducerList]]
** [[Producer|ent:Producer]]
** [[Enterprise|ent:Enterprise]]
** [[EnterpriseRole|ent:EnterpriseRole]]
** [[BusinessEntity|ent:BusinessEntity]]
** [[BusinessMember|ent:BusinessMember]]
** [[BusinessEntityList|ent:BusinessEntityList]]
** [[IncorporationForm|ent:IncorporationForm]]
** [[BEModificationOperation|ent:BEModificationOperation]]
** [[BusinessEntityType|ent:BusinessEntityType]]
{{столбец}}
*[[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://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]
*[[NameSpaces#http://api.vetrf.ru/schema/cdm/ikar|ikar]] (<nowiki>http://api.vetrf.ru/schema/cdm/ikar</nowiki>)
** [[Country|ikar:Country]]
** [[Region|ikar:Region]]
 
{{столбцы/конец}}
 
==Данные запроса==
<!--- <div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Структура данных запроса в формате ХML.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<mercvu:modifyBusinessEntityRequest 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">
    <mercvu:localTransactionId>{xs:NCName}</mercvu:localTransactionId>
    <mercvu:initiator>
        <base:uuid>{bs:UUID}</base:uuid>
        <com:login>{xs:NCName}</com:login>
    </mercvu:initiator>
    <mercvu:modificationOperation>
        <ent:type>{bs:String255}</ent:type>
        <ent:resultingList>
            <ent:businessEntity>
                <base:uuid>{base:UUID}</base:uuid>
        <ent:type>{bs:String255}</ent:type>
                <ent:incorporationForm>
                    <ent:uuid>{bs:UUID}</ent:uuid>
                    <ent:name>{bs:String255}</ent:name>
                    <ent:code>{bs:String255}</ent:code>
                    <ent:shortName>{bs:String255}</ent:shortName>
                </ent:incorporationForm>
        <ent:name>{bs:String255}</ent:name>
                <ent:fullName>{bs:String255}</ent:fullName>
                <ent:fio>{bs:String255}</ent:fio>
        <ent:inn>{bs:String255}</ent:inn>
        <ent:kpp>{bs:String255}</ent:kpp>
        <ent:ogrn>{bs:String255}</ent:ogrn>
        <ent:juridicalAddress>
            <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:juridicalAddress>
    </ent:businessEntity>
        </ent:resultingList>
        <ent:reason>{bs:String255}</ent:reason>
    </merc:modificationOperation>
</merc:modifyBusinessEntityRequest>
</syntaxhighlight>
</div>
</div> -->
 
===Объект modifyBusinessEntityRequest===
Корневой элемент содержимого заявки. Содержит сведения для выполнения операции добавления/изменения сведений в реестре хозяйствующих субъектов.
{| 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
|}
 
===Объект [[#Объект modifyBusinessEntityRequest|..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]
|}
 
===Объект [[#Объект modifyBusinessEntityRequest|..Request]]/'''modificationOperation'''===
 
Объект содержит общую информацию о выполняемой операции: тип операции, причину внесения записи в реестр и информацию о хозяйствующем субъекте.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''type''' || Тип операции:
*CREATE - добавление новой записи в реестр;
*FIND_OR_CREATE - поиск существующей или добавление новой записи в реестр;
*UPDATE - внесение изменений в существующую запись. Хозяйствующий субъект может вносить изменения в свои данные, а так же в сведения о хозяйствующих субъектах, которые были добавлены им.
|| [[RegisterModificationType|bs:RegisterModificationType]]  || 1
|-
| [[#Объект ..Request/modificationOperation/resultingList|'''resultingList''']] || Список, который содержит сведения о добавляемых хозяйствующих субъектах. На данный момент поддерживается добавление только одного субъекта в рамках одной заявки. || [[BusinessEntityList|ent:BusinessEntityList]] || 1
|-
| '''reason''' || Основание добавления записи в реестр. На этапе формирования справочника указывается текстом, далее в данном поле будет передаваться строковый код из справочника. || [[String255|bs:String255]] || 1
|}
 
===Объект [[#Объект modifyBusinessEntityRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/'''resultingList'''===
 
Объект содержит сведения о хозяйствующих субъектах, информацию о которых необходимо добавить/изменить в реестре.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Request/modificationOperation/resultingList/businessEntity|'''businessEntity''']] || Элемент, содержащий информацию о хозяйствующем субъекте. || [[BusinessEntity|ent:BusinessEntity]] || 1
|}
 
===Объект [[#Объект modifyBusinessEntityRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/'''businessEntity'''===
 
Объект содержит подробную информацию о хозяйствующем субъекте.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Идентификатор хозяйствующего субъекта.
* Указывается в случае изменения данных о хозяйствующем субъекте.
|| [[UUID|bs:UUID]] || 0..1
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта.
* Указывается в случае изменения данных о хозяйствующем субъекте.
|| [[UUID|bs:UUID]] || 0..1
|-
| '''type''' || Тип создаваемого или редактируемого хозяйствующего субъекта:
*1 - юридическое лицо;
*2 - физическое лицо;
*3 - индивидуальный предприниматель.
|| [[BusinessEntityType|ent:BusinessEntityType]] || 1
|-
| [[#Объект ..Request/modificationOperation/resultingList/businessEntity/incorporationForm|'''incorporationForm''']] ||Организационно-правовая форма хозяйствующего субъекта. Название указывается согласно общероссийскому классификатору организационно-правовых форм (ОКОПФ). Идентификатор организационно-правовой формы состоит из пяти знаков и вводится без пробелов.
* Обязательно указывается только для юридических лиц.
* Для физических лиц и для индивидуальных предпринимателей поле не указывается.
|| [[IncorporationForm|ent:IncorporationForm]] || 0..1
|-
| '''name''' || Наименование хозяйствующего субъекта без указания организационно-правовой формы.
* Обязательно указывается только для юридических лиц.
* Для физических лиц и для индивидуальных предпринимателей поле не указывается.
|| [[String255|bs:String255]] || 0..1
|-
| '''fullName''' || Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
* Обязательно указывается только для юридических лиц.
* Для физических лиц и для индивидуальных предпринимателей поле не указывается.
|| [[String255|bs:String255]] || 0..1
|-
| '''fio''' || ФИО физического лица или индивидуального предпринимателя.
* Обязательно указывается при создании хозяйствующего субъекта - ИП или физического лица.
* Для юридических лиц поле не указывается.
|| [[String255|bs:String255]] || 0..1
|-
| '''inn''' || ИНН хозяйствующего субъекта.
* Указывается 10 цифр для юридических лиц.
* Указывается 12 цифр для физических лиц и ИП.
* Обязательно указывается только для юридических лиц и ИП.
* Для физических лиц поле не указывается.
|| [[String255|bs:String255]] || 0..1
|-
| '''kpp''' || Код причины постановки на учет.
* Указывается только для юридических лиц, поле необязательно для заполнения.
* Для физических лиц и для индивидуальных предпринимателей поле не указывается.
|| [[String255|bs:String255]] || 0..1
|-
| '''ogrn''' || ОГРН или ОГРНИП.
* Обязательно указывается только для юридических лиц и ИП.
* Для физических лиц поле не указывается.
|| [[String255|bs:String255]] || 0..1
|-
| [[#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress|'''juridicalAddress''']] || Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект.
* При создании хозяйствующего субъекта обязательным является указание идентификатора страны, региона, района или города (для городов регионального подчинения) и текстового представления адреса. Желательным является указание адреса в виде идентификаторов компонентов адреса: страна, регион, район, населенный пункт, улица.
* Для городов федерального подчинения указывается страна, регион (название города) и улица, где зарегистрирован ХС.
|| [[Address|ikar:Address]] || 1
|}
 
===Объект [[#Объект modifyBusinessEntityRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/businessEntity|businessEntity]]/'''incorporationForm'''===
Объект содержит данные об организационно-правовой форме хозяйствующего субъекта.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''name''' || Название организационно-правовой формы предприятия согласно справочнику ОКОПФ.
* Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
|| [[String255|bs:String255]] || 0..1
|-
| '''code''' || Код организационно-правовой формы предприятия согласно справочнику ОКОПФ.
* Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
|| [[String255|bs:String255]] || 1
|-
| '''shortName''' || Краткое название организационно-правовой формы предприятия.
* Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
|| [[String255|bs:String255]] || 0
|}
 
===Объект [[#Объект modifyBusinessEntityRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/businessEntity|businessEntity]]/'''juridicalAddress'''===
 
Объект описывает поля юридического адреса хозяйствующего субъекта.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress/country|'''country''']] || Страна, в которой зарегистрирован хозяйствующий субъект. || [[Country|ikar:Country]] || 1
|-
| [[#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress/region|'''region''']] || Регион страны, в которой зарегистрирован хозяйствующий субъект. || [[Region|ikar:Region]] || 1
<!-- |-
| [[#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress/locality|'''locality''']] || Город региона страны (город регионального подчинения), где зарегистрирован хозяйствующий субъект. || [[Locality|ikar:Localilty]] || 0..1
|-
| [[#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress/district|'''district''']] || Район региона страны, где зарегистрирован хозяйствующий субъект. || [[Locality|ikar:Locality]] || 0..1
|-
| [[#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress/street|'''street''']] || Улица города, где зарегистрирован хозяйствующий субъект
* Обязательно для заполнения при регистриации хозяйствующих субъектов в городах федерального значения.
|| [[Street|ikar:Street]] || 0..1 -->
|-
| '''addressView''' || Строковое представление адреса. || [[String255|bs:String255]] || 1
 
|}
 
===Объект [[#Объект modifyBusinessEntityRequest|..Request]]/[[#Объект ..Request/modificationOperation|modificationOperation]]/[[#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[#Объект ..Request/modificationOperation/resultingList/businessEntity|businessEntity]]/[[#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress|juridicalAddress]]/'''country'''===
 
Объект содержит сведения о стране, в которой зарегистрирован хозяйствующий субъект.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
| Уникальный идентификатор страны в соответствии со справочником РСХН.
| [[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID'''
| Глобальный идентификатор страны в соответствии со справочником РСХН.
| [[UUID|bs:UUID]]
|}
 
===Объект [[ModifyBusinessEntityOperationForVetControl#Объект modifyBusinessEntityRequest|..Request]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation|modificationOperation]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity|businessEntity]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress|juridicalAddress]]/'''region'''===
 
Объект содержит сведения о регионе страны, в котором зарегистрирован хозяйствующий субъект.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
| Уникальный идентификатор региона страны в соответствии со справочником РСХН. 
|[[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID'''
| Глобальный идентификатор региона страны в соответствии со справочником РСХН.
* Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
| [[UUID|bs:UUID]]
|}
 
<!---
 
===Объект [[ModifyBusinessEntityOperationForVetControl#Объект modifyBusinessEntityRequest|..Request]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation|modificationOperation]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity|businessEntity]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress|juridicalAddress]]/'''locality'''===
 
Объект содержит сведения о городе регионального подчинения, в котором зарегистрирован хозяйствующий субъект.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
| Уникальный идентификатор региона страны в соответствии со справочником РСХН. 
|[[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID'''
| Глобальный идентификатор региона страны в соответствии со справочником РСХН.
* Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
| [[UUID|bs:UUID]]
|}
-->
 
<!--
===Объект [[ModifyBusinessEntityOperationForVetControl#Объект modifyBusinessEntityRequest|..Request]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation|modificationOperation]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity|businessEntity]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress|juridicalAddress]]/'''district'''===
 
Объект содержит сведения о районе региона страны, в котором зарегистрирован хозяйствующий субъект.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID'''
| Уникальный идентификатор региона страны в соответствии со справочником РСХН. 
|[[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''GUID'''
| Глобальный идентификатор региона страны в соответствии со справочником РСХН.
* Для РФ совпадает с идентификатором реестра адресов ФНС - Федеральной информационной адресной системой (ФИАС).
| [[UUID|bs:UUID]]
|}
-->
 
<!--
===Объект [[ModifyBusinessEntityOperationForVetControl#Объект modifyBusinessEntityRequest|..Request]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation|modificationOperation]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity|businessEntity]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress|juridicalAddress]]/'''street'''===
 
Объект содержит сведения об улице города, где зарегистрирован хозяйствующий субъект. Обязательно для заполнения при регистрации хозяйствующего субъекта в городе федерального значения.
 
{| 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">
<modifyBusinessEntityResponse 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:businessEntity>
        <base:uuid>{bs:UUID}</base:uuid>
        <base:guid>{bs:UUID}</base:guid>
        <base:active>{xs:boolean}</base:active>
        <base:last>{xs:boolean}</base:last>
        <base:status>{xs:string}</base:status>
        <base:createDate>{xs:dateTime}</base:createDate>
        <base:updateDate>{xs:dateTime}</base:updateDate>
        <ent:type>{bs:String255}</ent:type>
        <ent:name>{bs:String255}</ent:name>
        <ent:incorporationForm>
            <base:uuid>{bs:UUID}</base:uuid>
        </ent:incorporationForm>
        <ent:fullName>{bs:String255}</ent:fullName>                 
        <ent:fio>{bs:String255}</ent:fio>
        <ent:inn>{bs:String255}</ent:inn>
        <ent:juridicalAddress>
          <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>{bs:String255}</ikar:addressView>
        </ent:juridicalAddress>
    </merc:businessEntity>
</modifyBusinessEntityResponse>
</syntaxhighlight>
</div>
</div> -->
 
===Объект modifyBusinessEntityResponse===
Объект содержит сведения о хозяйствующем субъекте, который был изменен или добавлен.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[ModifyBusinessEntityOperationForVetControl#Объект ..Response/businessEntity|'''businessEntity''']] || Элемент содержит сведения о хозяйствующем субъекте. || [[BusinessEntity|ent:BusinessEntity]] || 0..*
|}
 
===Объект [[ModifyBusinessEntityOperationForVetControl#Объект modifyBusinessEntityResponse|..Response]]/businessEntity===
Объект содержит подробную информацию о хозяйствующем субъекте.
{| 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''' || Текущий статус версии записи реестра хозяйствующих субъектов.
* 100 - новый объект;
* 200 - отредактированный объект.
|| [[RegisterModificationType|bs:RegisterModificationType]] || 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
|-
| '''type''' || Организационно-правовая форма.
*1 - юридическое лицо;
*2 - физическое лицо;
*3 - индивидуальный предприниматель.
|| [[BusinessEntityType|ent:BusinessEntityType]] || 1
|-
| '''name''' || Наименование хозяйствующего субъекта без организационно-правовой формы.
*Поле возвращается только для юридических лиц.
*Для физических лиц и индивидуальных предпринимателей возвращается поле fio.
|| [[String255|bs:String255]] || 0..1
|-
| [[ModifyBusinessEntityOperation#Объект ..Response/businessEntity/incorporationForm|'''incorporationForm''']] ||  Организационно-правовая форма хозяйствующего субъекта.
* Поле возвращается только для юридических лиц.
|| [[IncorporationForm|ent:IncorporationForm]] ||0..1
|-
| '''fullName''' || Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
* Возвращается только для юридических лиц.
|| [[String255|bs:String255]] || 0..1
|-
| '''fio''' || ФИО.
* Возвращается только для физических лиц и индивидуальных предпринимателей.
|| [[String255|bs:String255]] || 0..1
|-
| '''inn''' || ИНН хозяйствующего субъекта.
* Возвращается только для физических лиц и индивидуальных предпринимателей.
|| [[String255|bs:String255]] || 0..1
|-
| '''kpp''' || КПП хозяйствующего субъекта. || [[String255|bs:String255]] || 0..1
|-
| '''ogrn''' || ОГРН хозяйствующего субъекта.
* Возвращается, если был задан (для юридических лиц и ИП).  
|| [[String255|bs:String255]] || 0..1
|-
| [[ModifyBusinessEntityOperationForVetControl#Объект ..Response/businessEntity/juridicalAddress|'''juridicalAddress''']] || Юридический адрес хозяйствующего субъекта. || [[Address|ikar:Address]] || 1
|}
 
===Объект [[ModifyBusinessEntityOperationForVetControl#Объект modifyBusinessEntityResponse|..Response]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Response/businessEntity|businessEntity]]/incorporationForm===
Объект содержит данные об организационно-правовой форме предприятия.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность 
|-
| '''UUID''' || Уникальный идентификатор записи в справочнике организационно-правовых форм. || [[UUID|bs:UUID]] || 1
|}
 
===Объект [[ModifyBusinessEntityOperationForVetControl#Объект modifyBusinessEntityRequest|..Response]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Response/businessEntity|businessEntity]]/'''juridicalAddress'''===
 
Объект содержит сведения о юридическом адресе хозяйствующего субъекта.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress/country|'''country''']] || Страна, в которой зарегистрирован хозяйствующий субъект. || [[Country|ikar:country]] || 1
|-
| [[ModifyBusinessEntityOperationForVetControl#Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress/region|'''region''']] || Регион страны, в которой зарегистрирован хозяйствующий субъект. || [[Region|ikar:region]] || 1
|-
| '''addressView''' || Строковое представление адреса. || [[String255|bs:String255]] || 1
|}
 
===Объект [[ModifyBusinessEntityOperationForVetControl#Объект modifyBusinessEntityResponse|..Response]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Response/businessEntity|businessEntity]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Response/businessEntity/juridicalAddress|juridicalAddress]]/'''country'''===
 
Объект содержит данные о стране, в которой зарегистрирован хозяйствующий субъект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор страны в соответствии со справочником РСХН.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор страны в соответствии со справочником РСХН.  || [[UUID|bs:UUID]] || 1
|}
 
===Объект [[ModifyBusinessEntityOperationForVetControl#Объект modifyBusinessEntityResponse|..Response]]/[[ModifyBusinessEntityOperationForVetControl#Объект ..Response/businessEntity|businessEntity]]/[[ModifyBusinessEntityOperation#Объект ..Response/businessEntity/juridicalAddress|juridicalAddress]]/'''region'''===
 
Объект содержит данные о регионе страны, где зарегистрирован хозяйствующий субъект.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор региона страны в соответствии со справочником РСХН. || [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор региона страны в соответствии со справочником РСХН.|| [[UUID|bs:UUID]] || 1
|}
 
==Коды ошибок==
{| class="wikitable"
|-
! Код !! Описание ошибки
|-
| MERC03147 || Страна с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC03148|| Регион с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC03149 || Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC03150 || Наименование хозяйствующего субъекта (юридического лица) обязательно для заполнения.
|-
| MERC03151 || Наименование хозяйствующего субъекта (юридического лица) превышает допустимую длину текста.
|-
| MERC03152 || Страна хозяйствующего субъекта обязательна для заполнения.
|-
| MERC03153 || Регион хозяйствующего субъекта обязателен для заполнения.
|-
| MERC03154 || Юридический адрес (адрес регистрации) хозяйствующего субъекта обязателен для заполнения.
|-
| MERC03155 || Юридический адрес (адрес регистрации) хозяйствующего субъекта превышает допустимую длину текста.
|-
| MERC03156 || ИНН хозяйствующего субъекта обязателен для заполнения.
|-
| MERC03159 || ИНН хозяйствующего субъекта в Республике Казахстан должен содержать 12 цифр.
|-
| MERC03160 || ИНН юридического лица указан некорректно.
|-
| MERC03161 || ИНН физического лица указан некорректно.
|-
| MERC03162 || ОГРН должен состоять из тринадцати цифр.
|-
| MERC03163 || Неверно указано контрольное число в ОГРН.
|-
| MERC03164 || Код причины постановки на учёт должен состоять из девяти цифр
|-
| MERC03165 || Причина редактирования реестра хозяйствующих суъектов обязательна для заполнения.
|-
| MERC03166 || В запросе отсутствуют сведения о хозяйствующем субъекте.
|-
| MERC03167 || ФИО хозяйствующего субъекта (физического лица) обязательно для заполнения.
|-
| MERC03168 || ФИО хозяйствующего субъекта (физического лица) превышает допустимую длину текста.
|-
| MERC03169 || Паспортные данные хозяйствующего субъекта (физического лица) обязательны для заполнения.
|-
| MERC03170 || Паспортные данные хозяйствующего субъекта (физического лица) превышают допустимую длину текста.
|-
| MERC03171 || Тип хозяйствующего субъекта обязателен для заполнения.
|-
| MERC03173 || Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
|-
| MERC03177 || Хозяйствующий субъект с указанным ИНН уже существует в реестре РСХН.
|-
| MERC03178 || Хозяйствующий субъект с указанным ОГРН уже существует в реестре РСХН.
|-
| MERC03290 || В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН.
|-
| MERC03299 || Указанный регион относится к другой стране 
|-
| MERC04001 || Отредактировать хозяйствующий субъект может только хозяйствующий субъект-владелец или хозяйствующий субъект, добавивший запись в реестр.
|-
| MERC04147 || Страна с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC04148 || Регион с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC04149 || Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC04150 || Наименование хозяйствующего субъекта (юридического лица) обязательно для заполнения.
|-
| MERC04151 || Наименование хозяйствующего субъекта (юридического лица) превышает допустимую длину текста.
|-
| MERC04152 || Страна хозяйствующего субъекта обязательна для заполнения.
|-
| MERC04153 || Регион хозяйствующего субъекта обязателен для заполнения.
|-
| MERC04154 || Юридический адрес (адрес регистрации) хозяйствующего субъекта обязателен для заполнения.
|-
| MERC04155 || Юридический адрес (адрес регистрации) хозяйствующего субъекта превышает допустимую длину текста.
|-
| MERC04156 || ИНН хозяйствующего субъекта обязателен для заполнения.
|-
| MERC04159 || ИНН хозяйствующего субъекта в Республике Казахстан должен содержать 12 цифр.
|-
| MERC04160 || ИНН юридического лица указан некорректно.
|-
| MERC04161 || ИНН физического лица указан некорректно.
|-
| MERC04162 || ОГРН должен состоять из тринадцати цифр.
|-
| MERC04163 || Неверно указано контрольное число в ОГРН.
|-
| MERC04164 || Код причины постановки на учёт должен состоять из девяти цифр
|-
| MERC04165 || Причина редактирования реестра хозяйствующих суъектов обязательна для заполнения.
|-
| MERC04166 || В запросе отсутствуют сведения о хозяйствующем субъекте.
|-
| MERC04167 || ФИО хозяйствующего субъекта (физического лица) обязательно для заполнения.
|-
| MERC04168 || ФИО хозяйствующего субъекта (физического лица) превышает допустимую длину текста.
|-
| MERC04169 || Паспортные данные хозяйствующего субъекта (физического лица) обязательны для заполнения.
|-
| MERC04170 || Паспортные данные хозяйствующего субъекта (физического лица) превышают допустимую длину текста.
|-
| MERC04171 || Тип хозяйствующего субъекта обязателен для заполнения.
|-
| MERC04173 || Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
|-
| MERC04174 || Хозяйствующий субъект с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC04175 || В запросе для хозяйствующего субъекта указан идентификатор (UUID) устаревшей версии записи реестра РСХН.
|-
| MERC04176 || Идентификатор хозяйствующего субъекта (UUID) обязателен для заполнения.
|-
| MERC04177 || Хозяйствующий субъект с указанным ИНН уже существует в реестре РСХН.
|-
| MERC04178 || Хозяйствующий субъект с указанным ОГРН уже существует в реестре РСХН.
|-
| MERC04290 || В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН.
|-
| MERC04299 || Указанный регион относится к другой стране 
|}
 
==Примеры запросов==
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id = "scenario1">[[#legalEntity|Создание юридического лица]]</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:modifyBusinessEntityRequest>
                <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:businessEntity>
                            <ent:type>1</ent:type>
                            <ent:name>Гладиолус</ent:name>
                            <ent:incorporationForm>
                              <ent:code>12300</ent:code>
                            </ent:incorporationForm>
                            <ent:fullName>Общество с ограниченной ответственностью "Гладиолус"</ent:fullName>
                            <ent:inn>3312200096</ent:inn>
                            <ent:ogrn>4085022240002</ent:ogrn>
                            <ent:juridicalAddress>
                              <ikar:country>
                                  <base:guid>123456987</base:guid>
                              </ikar:country>
                              <ikar:region>
                                  <base:guid>123654789</base:guid>
                              </ikar:region>
                              <ikar:addressView>123110, обл.Московская, г.Коломна, ул.Октябрьской Революции,д.223, кв.3</ikar:addressView>
                          </ent:juridicalAddress>
                  </ent:businessEntity>
                  </ent:resultingList>
                  <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
                  </mercvu:modificationOperation>
              </merc:modifyBusinessEntityRequest> 
          </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">[[#physicalPerson|Создание физического лица]]</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:modifyBusinessEntityRequest>
                    <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                    <mercvu:initiator>
                      <com:login>mercury_user</com:login>
                    </mercvu:initiator>
                    <mercvu:modificationOperation>
                      <ent:type>CREATE</ent:type>
                      <ent:resultingList count="1" total="1" offset="0">
                          <ent:businessEntity>
                            <ent:type>2</ent:type>
                            <ent:fio>Ромашкин А.В.</ent:fio>
                            <ent:inn>330110001981</ent:inn>
                            <ent:ogrn>4085022240002</ent:ogrn>
                            <ent:juridicalAddress>
                                <ikar:country>
                                    <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                                </ikar:country>
                                <ikar:region>
                                    <base:guid>c2deb16a-0330-4f05-821f-1d09c93331e6</base:guid>
                                </ikar:region>
                                <ikar:addressView>600321, обл.Владимирская, с. Семёновское-Красное, ул.Октябрьской Революции,д.2Б</ikar:addressView>
                            </ent:juridicalAddress>
                        </ent:businessEntity>
                    </ent:resultingList>
                    <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
                </mercvu:modificationOperation>
            </mercvu:modifyBusinessEntityRequest> 
          </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 = "scenario3">[[#entrepreneur|Создание индивидуального предпринимателя]]</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:modifyBusinessEntityRequest>
                  <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                  <mercvu:initiator>
                    <com:login>mercury_user</com:login>
                  </mercvu:initiator>
                  <mercvu:modificationOperation>
                    <ent:type>CREATE</ent:type>
                    <ent:resultingList count="1" total="1" offset="0">
                        <ent:businessEntity>
                            <ent:type>3</ent:type>
                            <ent:fio>ИП Ромашкин А.В.</ent:fio>
                            <ent:inn>332110001953</ent:inn>
                            <ent:ogrn>4085022240002</ent:ogrn>
                            <ent:juridicalAddress>
                              <ikar:country>
                                  <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                              </ikar:country>
                              <ikar:region>
                                  <base:guid>c2deb16a-0330-4f05-821f-1d09c93331e6</base:guid>
                              </ikar:region>
                              <ikar:addressView>600021, обл.Владимирская, г.Владимир, ул.Октябрьской Революции,д.2Б</ikar:addressView>
                          </ent:juridicalAddress>
                      </ent:businessEntity>
                  </ent:resultingList>
                  <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
                </mercvu:modificationOperation>
              </mercvu:modifyBusinessEntityRequest>
            </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 = "scenario4">[[#changeData|Редактирование данных хозяйствующего субъекта (на примере индивидуального предпринимателя)]]</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:modifyBusinessEntityRequest>
                <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:businessEntity>
                          <base:uuid>4dc6a054-fa2c-4d1e-aaac-bcd5662d23dd</base:uuid>
                          <ent:type>3</ent:type>
                          <ent:fio>ИП Ромашкин А.В.</ent:fio>
                          <ent:inn>332110001953</ent:inn>
                          <ent:ogrn>4085022240002</ent:ogrn>
                          <ent:juridicalAddress>
                              <ikar:country>
                                  <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                              </ikar:country>
                              <ikar:region>
                                  <base:guid>c2deb16a-0330-4f05-821f-1d09c93331e6</base:guid>
                            </ikar:region>
                            <ikar:addressView>600021, обл.Владимирская, г.Владимир, ул.Зелёная, д.2Б</ikar:addressView> <!---Изменение адреса ХС-->
                        </ent:juridicalAddress>
                    </ent:businessEntity>
                  </ent:resultingList>
                  <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
              </mercvu:modificationOperation>
            </mercvu:modifyBusinessEntityRequest>
        </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 = "scenario5">[[#search|Поиск хозяйствующего субъекта (на примере ИП)]]. Если хозяйствующий субъект с таким ОГРН уже существует, то вернётся не ошибка, а данные этого хозяйствующего субъекта. Если хозяйствующего субъекта с таким ОГРН нет, то в реестр будет добавлена новая запись.</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:modifyBusinessEntityRequest>
                <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                <mercvu:initiator>
                    <com:login>mercury_user</com:login>
                </mercvu:initiator>
                <mercvu:modificationOperation>
                    <ent:type>FIND_OR_CREATE</ent:type>
                    <ent:resultingList count="1" total="1" offset="0">
                        <ent:businessEntity>
                          <ent:type>3</ent:type>
                          <ent:fio>ИП Ромашкин А.В.</ent:fio>
                          <ent:inn>332110001953</ent:inn>
                          <ent:ogrn>4085022240002</ent:ogrn>
                          <ent:juridicalAddress>
                              <ikar:country>
                                <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                              </ikar:country>
                              <ikar:region>
                                  <base:guid>c2deb16a-0330-4f05-821f-1d09c93331e6</base:guid>
                              </ikar:region>
                              <ikar:addressView>600021, обл.Владимирская, г.Владимир, ул.Октябрьской Революции,д.2Б</ikar:addressView>
                          </ent:juridicalAddress>
                        </ent:businessEntity>
                  </ent:resultingList>
                  <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
              </mercvu:modificationOperation>
          </mercvu:modifyBusinessEntityRequest>
        </app:data>
      </app:application>
    </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
 
 
<!-- [[#top|Вернуться к началу &uarr;]]
[[Category:Ветис.API]]
[[Category:изменение реестра хозяйствующих субъектов]]
[[Category:Ветис.API для ветеринарных управлений]] -->

Версия 16:04, 3 июня 2016

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

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

  • юридическое лицо;
  • индивидуальный предприниматель/КФХ;
  • физическое лицо.

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

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

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

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

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

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

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

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

При выполнении операции возможны следующие сценарии:
1. Создание хозяйствующего субъекта.

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

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


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

Объект modifyBusinessEntityRequest

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

Поле Описание Тип Обязательность
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 - добавление новой записи в реестр;
  • FIND_OR_CREATE - поиск существующей или добавление новой записи в реестр;
  • UPDATE - внесение изменений в существующую запись. Хозяйствующий субъект может вносить изменения в свои данные, а так же в сведения о хозяйствующих субъектах, которые были добавлены им.
 bs:RegisterModificationType 1
resultingList Список, который содержит сведения о добавляемых хозяйствующих субъектах. На данный момент поддерживается добавление только одного субъекта в рамках одной заявки. ent:BusinessEntityList 1
reason Основание добавления записи в реестр. На этапе формирования справочника указывается текстом, далее в данном поле будет передаваться строковый код из справочника. bs:String255 1

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

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

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

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

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

Поле Описание Тип данных Обязательность
UUID Идентификатор хозяйствующего субъекта.
  • Указывается в случае изменения данных о хозяйствующем субъекте.
 bs:UUID 0..1
GUID Глобальный идентификатор хозяйствующего субъекта.
  • Указывается в случае изменения данных о хозяйствующем субъекте.
 bs:UUID 0..1
type Тип создаваемого или редактируемого хозяйствующего субъекта:
  • 1 - юридическое лицо;
  • 2 - физическое лицо;
  • 3 - индивидуальный предприниматель.
 ent:BusinessEntityType 1
incorporationForm Организационно-правовая форма хозяйствующего субъекта. Название указывается согласно общероссийскому классификатору организационно-правовых форм (ОКОПФ). Идентификатор организационно-правовой формы состоит из пяти знаков и вводится без пробелов.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
 ent:IncorporationForm 0..1
name Наименование хозяйствующего субъекта без указания организационно-правовой формы.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
 bs:String255 0..1
fullName Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
 bs:String255 0..1
fio ФИО физического лица или индивидуального предпринимателя.
  • Обязательно указывается при создании хозяйствующего субъекта - ИП или физического лица.
  • Для юридических лиц поле не указывается.
 bs:String255 0..1
inn ИНН хозяйствующего субъекта.
  • Указывается 10 цифр для юридических лиц.
  • Указывается 12 цифр для физических лиц и ИП.
  • Обязательно указывается только для юридических лиц и ИП.
  • Для физических лиц поле не указывается.
 bs:String255 0..1
kpp Код причины постановки на учет.
  • Указывается только для юридических лиц, поле необязательно для заполнения.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
 bs:String255 0..1
ogrn ОГРН или ОГРНИП.
  • Обязательно указывается только для юридических лиц и ИП.
  • Для физических лиц поле не указывается.
 bs:String255 0..1
juridicalAddress Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект.
  • При создании хозяйствующего субъекта обязательным является указание идентификатора страны, региона, района или города (для городов регионального подчинения) и текстового представления адреса. Желательным является указание адреса в виде идентификаторов компонентов адреса: страна, регион, район, населенный пункт, улица.
  • Для городов федерального подчинения указывается страна, регион (название города) и улица, где зарегистрирован ХС.
 ikar:Address 1

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

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

Поле Описание Тип данных Обязательность
name Название организационно-правовой формы предприятия согласно справочнику ОКОПФ.
  • Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
 bs:String255 0..1
code Код организационно-правовой формы предприятия согласно справочнику ОКОПФ.
  • Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
 bs:String255 1
shortName Краткое название организационно-правовой формы предприятия.
  • Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
 bs:String255 0

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

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

Поле Описание Тип данных Обязательность
country Страна, в которой зарегистрирован хозяйствующий субъект. ikar:Country 1
region Регион страны, в которой зарегистрирован хозяйствующий субъект. ikar:Region 1
addressView Строковое представление адреса. bs:String255 1

Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress/country

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

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

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

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

Объект ..Request/modificationOperation/resultingList/businessEntity/juridicalAddress/region

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

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

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

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



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

Объект modifyBusinessEntityResponse

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

Поле Описание Тип Обязательность
businessEntity Элемент содержит сведения о хозяйствующем субъекте. ent:BusinessEntity 0..*

Объект ..Response/businessEntity

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

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор хозяйствующего субъекта в реестре. bs:UUID 1
GUID Глобальный идентификатор хозяйствующего субъекта в реестре. bs:UUID 1
active Является ли запись о хозяйствующем субъекте активной:
  • true - запись активна;
  • false - запись не активна.
 xs:boolean 1
last Является ли запись о хозяйствующем субъекте последней:
  • true - запись последняя;
  • false - запись не последняя.
 xs:boolean 1
status Текущий статус версии записи реестра хозяйствующих субъектов.
  • 100 - новый объект;
  • 200 - отредактированный объект.
 bs:RegisterModificationType 1
createDate Дата создания текущей записи в реестре. xs:dateTime 1
updateDate Дата обновления текущей записи реестра. xs:dateTime 1
previous Идентификатор предыдущей версии записи реестра хозяйствующих субъектов. bs:UUID 0..1
next Идентификатор следующей версии записи реестра хозяйствующих субъектов. bs:UUID 0..1
type Организационно-правовая форма.
  • 1 - юридическое лицо;
  • 2 - физическое лицо;
  • 3 - индивидуальный предприниматель.
 ent:BusinessEntityType 1
name Наименование хозяйствующего субъекта без организационно-правовой формы.
  • Поле возвращается только для юридических лиц.
  • Для физических лиц и индивидуальных предпринимателей возвращается поле fio.
 bs:String255 0..1
incorporationForm Организационно-правовая форма хозяйствующего субъекта.
  • Поле возвращается только для юридических лиц.
 ent:IncorporationForm 0..1
fullName Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
  • Возвращается только для юридических лиц.
 bs:String255 0..1
fio ФИО.
  • Возвращается только для физических лиц и индивидуальных предпринимателей.
 bs:String255 0..1
inn ИНН хозяйствующего субъекта.
  • Возвращается только для физических лиц и индивидуальных предпринимателей.
 bs:String255 0..1
kpp КПП хозяйствующего субъекта. bs:String255 0..1
ogrn ОГРН хозяйствующего субъекта.
  • Возвращается, если был задан (для юридических лиц и ИП).
 bs:String255 0..1
juridicalAddress Юридический адрес хозяйствующего субъекта. ikar:Address 1

Объект ..Response/businessEntity/incorporationForm

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

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

Объект ..Response/businessEntity/juridicalAddress

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

Поле Описание Тип данных Обязательность
country Страна, в которой зарегистрирован хозяйствующий субъект. ikar:country 1
region Регион страны, в которой зарегистрирован хозяйствующий субъект. ikar:region 1
addressView Строковое представление адреса. bs:String255 1

Объект ..Response/businessEntity/juridicalAddress/country

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

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

Объект ..Response/businessEntity/juridicalAddress/region

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

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

Коды ошибок

Код Описание ошибки
MERC03147 Страна с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC03148 Регион с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC03149 Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC03150 Наименование хозяйствующего субъекта (юридического лица) обязательно для заполнения.
MERC03151 Наименование хозяйствующего субъекта (юридического лица) превышает допустимую длину текста.
MERC03152 Страна хозяйствующего субъекта обязательна для заполнения.
MERC03153 Регион хозяйствующего субъекта обязателен для заполнения.
MERC03154 Юридический адрес (адрес регистрации) хозяйствующего субъекта обязателен для заполнения.
MERC03155 Юридический адрес (адрес регистрации) хозяйствующего субъекта превышает допустимую длину текста.
MERC03156 ИНН хозяйствующего субъекта обязателен для заполнения.
MERC03159 ИНН хозяйствующего субъекта в Республике Казахстан должен содержать 12 цифр.
MERC03160 ИНН юридического лица указан некорректно.
MERC03161 ИНН физического лица указан некорректно.
MERC03162 ОГРН должен состоять из тринадцати цифр.
MERC03163 Неверно указано контрольное число в ОГРН.
MERC03164 Код причины постановки на учёт должен состоять из девяти цифр
MERC03165 Причина редактирования реестра хозяйствующих суъектов обязательна для заполнения.
MERC03166 В запросе отсутствуют сведения о хозяйствующем субъекте.
MERC03167 ФИО хозяйствующего субъекта (физического лица) обязательно для заполнения.
MERC03168 ФИО хозяйствующего субъекта (физического лица) превышает допустимую длину текста.
MERC03169 Паспортные данные хозяйствующего субъекта (физического лица) обязательны для заполнения.
MERC03170 Паспортные данные хозяйствующего субъекта (физического лица) превышают допустимую длину текста.
MERC03171 Тип хозяйствующего субъекта обязателен для заполнения.
MERC03173 Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
MERC03177 Хозяйствующий субъект с указанным ИНН уже существует в реестре РСХН.
MERC03178 Хозяйствующий субъект с указанным ОГРН уже существует в реестре РСХН.
MERC03290 В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН.
MERC03299 Указанный регион относится к другой стране
MERC04001 Отредактировать хозяйствующий субъект может только хозяйствующий субъект-владелец или хозяйствующий субъект, добавивший запись в реестр.
MERC04147 Страна с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC04148 Регион с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC04149 Хозяйствующий субъект, добавляющий запись, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC04150 Наименование хозяйствующего субъекта (юридического лица) обязательно для заполнения.
MERC04151 Наименование хозяйствующего субъекта (юридического лица) превышает допустимую длину текста.
MERC04152 Страна хозяйствующего субъекта обязательна для заполнения.
MERC04153 Регион хозяйствующего субъекта обязателен для заполнения.
MERC04154 Юридический адрес (адрес регистрации) хозяйствующего субъекта обязателен для заполнения.
MERC04155 Юридический адрес (адрес регистрации) хозяйствующего субъекта превышает допустимую длину текста.
MERC04156 ИНН хозяйствующего субъекта обязателен для заполнения.
MERC04159 ИНН хозяйствующего субъекта в Республике Казахстан должен содержать 12 цифр.
MERC04160 ИНН юридического лица указан некорректно.
MERC04161 ИНН физического лица указан некорректно.
MERC04162 ОГРН должен состоять из тринадцати цифр.
MERC04163 Неверно указано контрольное число в ОГРН.
MERC04164 Код причины постановки на учёт должен состоять из девяти цифр
MERC04165 Причина редактирования реестра хозяйствующих суъектов обязательна для заполнения.
MERC04166 В запросе отсутствуют сведения о хозяйствующем субъекте.
MERC04167 ФИО хозяйствующего субъекта (физического лица) обязательно для заполнения.
MERC04168 ФИО хозяйствующего субъекта (физического лица) превышает допустимую длину текста.
MERC04169 Паспортные данные хозяйствующего субъекта (физического лица) обязательны для заполнения.
MERC04170 Паспортные данные хозяйствующего субъекта (физического лица) превышают допустимую длину текста.
MERC04171 Тип хозяйствующего субъекта обязателен для заполнения.
MERC04173 Хозяйствующий субъект, добавляющий запись, обязателен для заполнения.
MERC04174 Хозяйствующий субъект с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC04175 В запросе для хозяйствующего субъекта указан идентификатор (UUID) устаревшей версии записи реестра РСХН.
MERC04176 Идентификатор хозяйствующего субъекта (UUID) обязателен для заполнения.
MERC04177 Хозяйствующий субъект с указанным ИНН уже существует в реестре РСХН.
MERC04178 Хозяйствующий субъект с указанным ОГРН уже существует в реестре РСХН.
MERC04290 В запросе для хозяйствующего субъекта добавляющего запись указан идентификатор устаревшей версии записи реестра РСХН.
MERC04299 Указанный регион относится к другой стране

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

<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:modifyBusinessEntityRequest>
                 <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:businessEntity>
                            <ent:type>1</ent:type>
                            <ent:name>Гладиолус</ent:name>
                            <ent:incorporationForm>
                               <ent:code>12300</ent:code> 
                            </ent:incorporationForm>
                            <ent:fullName>Общество с ограниченной ответственностью "Гладиолус"</ent:fullName>
                            <ent:inn>3312200096</ent:inn>
                            <ent:ogrn>4085022240002</ent:ogrn>
                            <ent:juridicalAddress>
                               <ikar:country>
                                   <base:guid>123456987</base:guid>
                               </ikar:country>
                               <ikar:region>
                                  <base:guid>123654789</base:guid>
                               </ikar:region>
                               <ikar:addressView>123110, обл.Московская, г.Коломна, ул.Октябрьской Революции,д.223, кв.3</ikar:addressView>
                           </ent:juridicalAddress>
                   </ent:businessEntity>
                   </ent:resultingList>
                   <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
                  </mercvu:modificationOperation>
              </merc:modifyBusinessEntityRequest>   
          </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:modifyBusinessEntityRequest>
                    <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                    <mercvu:initiator>
                       <com:login>mercury_user</com:login>
                    </mercvu:initiator>
                    <mercvu:modificationOperation>
                       <ent:type>CREATE</ent:type>
                       <ent:resultingList count="1" total="1" offset="0">
                          <ent:businessEntity>
                             <ent:type>2</ent:type>
                             <ent:fio>Ромашкин А.В.</ent:fio>
                             <ent:inn>330110001981</ent:inn>
                             <ent:ogrn>4085022240002</ent:ogrn>
                             <ent:juridicalAddress>
                                <ikar:country>
                                    <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                                </ikar:country>
                                <ikar:region>
                                    <base:guid>c2deb16a-0330-4f05-821f-1d09c93331e6</base:guid>
                                </ikar:region>
                                <ikar:addressView>600321, обл.Владимирская, с. Семёновское-Красное, ул.Октябрьской Революции,д.2Б</ikar:addressView>
                            </ent:juridicalAddress>
                         </ent:businessEntity>
                    </ent:resultingList>
                    <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
                </mercvu:modificationOperation>
            </mercvu:modifyBusinessEntityRequest>  
           </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:modifyBusinessEntityRequest>
                  <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                  <mercvu:initiator>
                     <com:login>mercury_user</com:login>
                  </mercvu:initiator>
                  <mercvu:modificationOperation>
                     <ent:type>CREATE</ent:type>
                     <ent:resultingList count="1" total="1" offset="0">
                        <ent:businessEntity>
                            <ent:type>3</ent:type>
                            <ent:fio>ИП Ромашкин А.В.</ent:fio>
                            <ent:inn>332110001953</ent:inn>
                            <ent:ogrn>4085022240002</ent:ogrn>
                            <ent:juridicalAddress>
                               <ikar:country>
                                  <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                               </ikar:country>
                               <ikar:region>
                                   <base:guid>c2deb16a-0330-4f05-821f-1d09c93331e6</base:guid>
                               </ikar:region>
                               <ikar:addressView>600021, обл.Владимирская, г.Владимир, ул.Октябрьской Революции,д.2Б</ikar:addressView>
                           </ent:juridicalAddress>
                       </ent:businessEntity>
                   </ent:resultingList>
                   <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
                </mercvu:modificationOperation>
              </mercvu:modifyBusinessEntityRequest>
            </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:modifyBusinessEntityRequest>
                 <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:businessEntity>
                          <base:uuid>4dc6a054-fa2c-4d1e-aaac-bcd5662d23dd</base:uuid>
                          <ent:type>3</ent:type>
                          <ent:fio>ИП Ромашкин А.В.</ent:fio>
                          <ent:inn>332110001953</ent:inn>
                          <ent:ogrn>4085022240002</ent:ogrn>
                          <ent:juridicalAddress>
                              <ikar:country>
                                  <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                              </ikar:country>
                              <ikar:region>
                                  <base:guid>c2deb16a-0330-4f05-821f-1d09c93331e6</base:guid>
                             </ikar:region>
                             <ikar:addressView>600021, обл.Владимирская, г.Владимир, ул.Зелёная, д.2Б</ikar:addressView> <!---Изменение адреса ХС-->
                         </ent:juridicalAddress>
                    </ent:businessEntity>
                  </ent:resultingList>
                  <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
              </mercvu:modificationOperation>
            </mercvu:modifyBusinessEntityRequest>
        </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:modifyBusinessEntityRequest>
                 <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                 <mercvu:initiator>
                     <com:login>mercury_user</com:login>
                 </mercvu:initiator>
                 <mercvu:modificationOperation>
                    <ent:type>FIND_OR_CREATE</ent:type>
                    <ent:resultingList count="1" total="1" offset="0">
                        <ent:businessEntity>
                           <ent:type>3</ent:type>
                           <ent:fio>ИП Ромашкин А.В.</ent:fio>
                           <ent:inn>332110001953</ent:inn>
                           <ent:ogrn>4085022240002</ent:ogrn>
                           <ent:juridicalAddress>
                              <ikar:country>
                                 <base:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</base:guid>
                              </ikar:country>
                              <ikar:region>
                                  <base:guid>c2deb16a-0330-4f05-821f-1d09c93331e6</base:guid>
                              </ikar:region>
                              <ikar:addressView>600021, обл.Владимирская, г.Владимир, ул.Октябрьской Революции,д.2Б</ikar:addressView>
                           </ent:juridicalAddress>
                        </ent:businessEntity>
                   </ent:resultingList>
                   <ent:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</ent:reason>
               </mercvu:modificationOperation>
           </mercvu:modifyBusinessEntityRequest>
        </app:data>
      </app:application>
    </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>


Источник — http://help.vetrf.ru/index.php?title=ModifyBusinessEntityOperation&oldid=16700