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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(Отмена правки 21608, сделанной участником Romanov-av-170814 (обс.))
Строка 91: Строка 91:
|-
|-
|1
|1
|style="font-weight: bold; font-family: Courier;" |<merc:modifyProducerStockListRequest>
|style="font-weight: bold; font-family: Courier;" |<merc:modifyBusinessEntityRequest>
|
|
|
|
Строка 108: Строка 108:
|[[User_v2.0|dt:User]]
|[[User_v2.0|dt:User]]
|[1..1]
|[1..1]
|Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу.  
|Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
* Является ответственным за выполнение бизнес-операции.  
* Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
Строка 128: Строка 126:
|-
|-
|6
|6
|style="font-weight: bold; font-family: Courier;" |···<merc:modificationOperation>
|style="font-weight: bold; font-family: Courier;" |···<vd:modificationOperation>
|[[PSLModificationOperation_v2.0|vd:PSLModificationOperation]]
|[[BEModificationOperation_v2.0|vd:BEModificationOperation]]
|[1..1]
|[1..1]
|
|Описание операции добавления/изменения информации о хозяйствующем субъекте.
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|7
|7
|style="font-weight: bold; font-family: Courier;" |······<vd:type>
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:type>
|[[RegisterModificationType|bs:RegisterModificationType]]
|[[RegisterModificationType_v2.0|bs:RegisterModificationType]]
|[1..1]
|[1..1]
|Тип операции.
|Тип операции.
* CREATE - создание новой записи в списке продукции;
*CREATE - добавление новой записи в реестр;
* UPDATE - обновление записи о продукции в реестре;
*FIND_OR_CREATE - поиск существующей или добавление новой записи в реестр;
* DELETE - удаление записи о продукции
*UPDATE - внесение изменений в существующую запись. Хозяйствующий субъект может вносить изменения в свои данные, а так же в сведения о хозяйствующих субъектах, которые были добавлены им.
|style="font-family: Courier;" |<vd:type>CREATE</vd:type>
|style="font-family: Courier;" |<vd:type>CREATE</vd:type>
|-
|-
|8
|8
|style="font-weight: bold; font-family: Courier;" |······<vd:affectedList>
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:resultingList>
|[[ProductItemList_v2.0|dt:ProductItemList]]
|[[BusinessEntityList_v2.0|dt:BusinessEntityList]]
|[0..1]
|[1..1]
| Входящие записи для операции.  
|Список, который содержит сведения о добавляемых хозяйствующих субъектах. На данный момент поддерживается добавление только одного субъекта в рамках одной заявки.
* На данный момент разрешается добавлять только по одной позиции.  
* Используется только при удалении позиции (DELETE)
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|9
|9
|style="font-weight: bold; font-family: Courier;" |·········<vd:productItem>
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:businessEntity>
|[[ProductItem_v2.0|dt:ProductItem]]
|[[BusinessEntity_v2.0|dt:BusinessEntity]]
|[1..1]
|[1..1]
|Сведения о наименовании продукции в соответствии с номенклатурой производителя.
|Элемент, содержащий информацию о хозяйствующем субъекте.
* Обязателен для указания uuid
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|10
|10
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|[[UUID|bs:UUID]]
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Идентификатор версии номенклатуры.
| Идентификатор хозяйствующего субъекта.
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
* Указывается в случае изменения данных о хозяйствующем субъекте.  
|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
|-
|-
|11
|11
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:globalID>
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|[[GTINType_v2.0|dt:GTINType]]
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Trade Identification Number (GTIN) - уникальный идентификационный номер продукции производителя.  
|Глобальный идентификатор хозяйствующего субъекта.
|style="font-family: Courier;" |&lt;dt:globalID>85672854</dt:globalID>
* Указывается в случае изменения данных о хозяйствующем субъекте.
|style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
|-
|-
|12
|12
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:type>
|[[String255|bs:String255]]
|[[BusinessEntityType_v2.0|dt:BusinessEntityType]]  
|[0..1]
|[1..1]
|Наименование продукции.
|Тип создаваемого или редактируемого хозяйствующего субъекта:
|style="font-family: Courier;" |&lt;dt:name>Название</dt:name>
*1 - юридическое лицо;
*2 - физическое лицо;
*3 - индивидуальный предприниматель.  
|style="font-family: Courier;" |&lt;dt:type>1</dt:type>
|-
|-
|13
|13
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:code>
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:incorporationForm>
|[[String255|bs:String255]]
|[[IncorporationForm_v2.0|dt:IncorporationForm]]
|[0..1]
|[0..1]
|Артикул (код) продукции в соответствии с внутренним кодификатором производителя.  
|Организационно-правовая форма хозяйствующего субъекта. Название указывается согласно общероссийскому классификатору организационно-правовых форм (ОКОПФ). Идентификатор организационно-правовой формы состоит из пяти знаков и вводится без пробелов.
|style="font-family: Courier;" |&lt;dt:code>12</dt:code>
* Обязательно указывается только для юридических лиц.
* Для физических лиц и для индивидуальных предпринимателей поле не указывается.
* При указании обязательно заполнять либо uuid, либо code.
|style="font-family: Courier;" |
|-
|-
|14
|14
|style="font-weight: bold; font-family: Courier;" |·········</vd:productItem>
|style="font-weight: bold; font-family: Courier;" |···············<bs:uuid>
|
|[[UUID|bs:UUID]]
|
|[0..1]
|
|Идентификатор версии организационно-правовой формы хозяйствующего субъекта.
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|15
|15
|style="font-weight: bold; font-family: Courier;" |······</vd:affectedList>
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:name>
|
|[[String255|bs:String255]]
|
|[0..1]
|
|Название организационно-правовой формы предприятия согласно справочнику ОКОПФ.
|style="font-family: Courier;" |
* Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
|style="font-family: Courier;" |&lt;dt:name>Общество с ограниченной ответственностью</dt:name>
|-
|-
|16
|16
|style="font-weight: bold; font-family: Courier;" |······<vd:resultingList>
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:code>
|[[ProductItemList_v2.0|dt:ProductItemList]]
|[[String255|bs:String255]]
|[0..1]
|[1..1]
|Входящие записи для операции.  
|Код организационно-правовой формы предприятия согласно справочнику ОКОПФ.  
* На данный момент разрешается добавлять только по одной позиции
* Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
* Используется при добавлении и редактировании записи (CREATE и UPDATE)
|style="font-family: Courier;" |&lt;dt:code>12300</dt:code>
|style="font-family: Courier;" |
|-
|-
|17
|17
|style="font-weight: bold; font-family: Courier;" |·········<vd:productItem>
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:shortName>
|[[ProductItem_v2.0|dt:ProductItem]]
|[[String255|bs:String255]]
|[1..1]
|[0..1]
|Сведения о наименовании продукции в соответствии с номенклатурой производителя.
|Краткое название организационно-правовой формы предприятия.
|style="font-family: Courier;" |
* Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
|style="font-family: Courier;" |&lt;dt:shortName>ООО</dt:shortName>
|-
|-
|18
|18
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|style="font-weight: bold; font-family: Courier;" |············</dt:incorporationForm>
|[[UUID|bs:UUID]]
|
|[0..1]
|
|Идентификатор версии номенклатуры.
|
* Указывается при изменении записи.
|style="font-family: Courier;" |
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|-
|-
|19
|19
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:globalID>
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|[[GTINType_v2.0|dt:GTINType]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Trade Identification Number (GTIN) - уникальный идентификационный номер продукции производителя.  
|Наименование хозяйствующего субъекта без указания организационно-правовой формы.  
* По задумке создателей GTIN должен быть уникален для продукции всех производителей, но на практике встречаются случаи недокументированного использования GTIN внутри компаний, что не обеспечивает уникальность GTIN, поэтому уникальность поля не проверяется.
* Обязательно указывается только для юридических лиц.
|style="font-family: Courier;" |&lt;dt:globalID>85672854</dt:globalID>
* Для физических лиц и для индивидуальных предпринимателей поле не указывается.
|style="font-family: Courier;" |&lt;dt:name>Гладиолус</dt:name>
|-
|-
|20
|20
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:fullName>
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Наименование продукции.
|Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
|style="font-family: Courier;" |&lt;dt:name>Название</dt:name>
* Обязательно указывается только для юридических лиц.
* Для физических лиц и для индивидуальных предпринимателей поле не указывается.
|style="font-family: Courier;" |&lt;dt:fullName>Общество с ограниченной ответственностью "Гладиолус"</dt:fullName>
|-
|-
|21
|21
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:code>
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:fio>
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Артикул (код) продукции в соответствии с внутренним кодификатором производителя.
|ФИО физического лица или индивидуального предпринимателя.
* Артикул продукции должен быть уникальным в пределах одного производителя.
* Обязательно указывается при создании хозяйствующего субъекта - ИП или физического лица.
|style="font-family: Courier;" |&lt;dt:code>12</dt:code>
* Для юридических лиц поле не указывается.
|style="font-family: Courier;" |&lt;dt:fio>Иванов Сергей Петрович</dt:fio>
|-
|-
|22
|22
|style="font-weight: bold; font-family: Courier;" |············<vd:productType>
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:inn>
|[[ProductType_v2.0|dt:ProductType]]
|[[String255|bs:String255]]
|[1..1]
|[0..1]
|Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий.
|ИНН хозяйствующего субъекта.
|style="font-family: Courier;" |<vd:productType>1</vd:productType>
* Указывается 10 цифр для юридических лиц.
* Указывается 12 цифр для физических лиц и ИП.  
* Обязательно указывается только для юридических лиц.
* Для физических лиц поле не указывается.
|style="font-family: Courier;" |&lt;dt:inn>3312200096</dt:inn>
|-
|-
|23
|23
|style="font-weight: bold; font-family: Courier;" |············<vd:product>
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:kpp>
|[[Product_v2.0|dt:Product]]
|[[String255|bs:String255]]
|[1..1]
|[0..1]
|Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.  
|Код причины постановки на учет.  
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
* Указывается только для юридических лиц, поле необязательно для заполнения.
|style="font-family: Courier;" |
* Для физических лиц и для индивидуальных предпринимателей поле не указывается.
|style="font-family: Courier;" |&lt;dt:kpp>163501001</dt:kpp>
|-
|-
|24
|24
|style="font-weight: bold; font-family: Courier;" |···············<bs:uuid>
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:ogrn>
|[[UUID|bs:UUID]]
|[1..1]
|Идентификатор версии продукции.
|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
|-
|25
|style="font-weight: bold; font-family: Courier;" |···············<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор продукции.
|style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
|-
|26
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:name>
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Наименование продукции.
|ОГРН или ОГРНИП.
|style="font-family: Courier;" |&lt;dt:name>говядина</dt:name>
* Обязательно указывается только для юридических лиц.
* Для ИП ОГРНИП можно не указывать.
* Для физических лиц поле не указывается.
|style="font-family: Courier;" |&lt;dt:ogrn>4085022240002</dt:ogrn>
|-
|-
|27
|25
|style="font-weight: bold; font-family: Courier;" |············</vd:product>
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:juridicalAddress>
|
|[[Address_v2.0|dt:Address]]
|
|
|style="font-family: Courier;" |
|-
|28
|style="font-weight: bold; font-family: Courier;" |············<vd:subProduct>
|[[SubProduct_v2.0|dt:SubProduct]]
|[1..1]
|[1..1]
|Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
|Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
* При создании хозяйствующего субъекта обязательным является указание идентификатора страны, региона, района или города (для городов регионального подчинения) и текстового представления адреса. Желательным является указание адреса в виде идентификаторов компонентов адреса: страна, регион, район, населенный пункт, улица.
* Для городов федерального подчинения указывается страна, регион (название города) и улица, где зарегистрирован ХС.
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|29
|26
|style="font-weight: bold; font-family: Courier;" |···············<bs:uuid>
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:country>
|[[UUID|bs:UUID]]
|[[Country_v2.0|dt:Country]]
|[1..1]
|[1..1]
|Идентификатор версии вида продукции.
|Страна, в которой зарегистрирован хозяйствующий субъект.  
|style="font-family: Courier;" |<bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid>
|-
|30
|style="font-weight: bold; font-family: Courier;" |···············<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор вида продукции.
|style="font-family: Courier;" |<bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
|-
|31
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:name>
|[[String255|bs:String255]]
|[0..1]
|Наименование вида продукции.
|style="font-family: Courier;" |&lt;dt:name>говядина на кости охлажденная</dt:name>
|-
|32
|style="font-weight: bold; font-family: Courier;" |············</vd:subProduct>
|
|
|
|style="font-family: Courier;" |
|-
|33
|style="font-weight: bold; font-family: Courier;" |············<vd:correspondsToGost>
|[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
|[0..1]
|Соответствует ли ГОСТу.
|style="font-family: Courier;" |<vd:correspondsToGost>true</vd:correspondsToGost>
|-
|34
|style="font-weight: bold; font-family: Courier;" |············<vd:gost>
|[[String255|bs:String255]]
|[0..1]
|ГОСТ.
|style="font-family: Courier;" |<vd:gost>ГОСТ-621187/53</vd:gost>
|-
|35
|style="font-weight: bold; font-family: Courier;" |············<vd:producer>
|[[BusinessEntity_v2.0|dt:BusinessEntity]]
|[0..1]
|ХС-производитель продукции.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|36
|27
|style="font-weight: bold; font-family: Courier;" |···············<bs:uuid>
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|[[UUID|bs:UUID]]
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Идентификатор версии хозяйствующего субъекта-производителя.
|Уникальный идентификатор страны в соответствии со справочником РСХН.  
|style="font-family: Courier;" |<bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
|-
|-
|37
|28
|style="font-weight: bold; font-family: Courier;" |···············<bs:guid>
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|[[UUID|bs:UUID]]  
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Глобальный идентификатор хозяйствующего субъекта-производителя.
|Глобальный идентификатор страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
|style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
|-
|-
|38
|29
|style="font-weight: bold; font-family: Courier;" |············</vd:producer>
|style="font-weight: bold; font-family: Courier;" |···············</dt:country>
|
|
|
|
Строка 372: Строка 325:
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|39
|30
|style="font-weight: bold; font-family: Courier;" |············<vd:tmOwner>
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:region>
|[[BusinessEntity_v2.0|dt:BusinessEntity]]
|[[Region_v2.0|dt:Region]]
|[0..1]
|[1..1]
|ХС-собственник торговой марки.
|Регион страны, в которой зарегистрирован хозяйствующий субъект.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|40
|31
|style="font-weight: bold; font-family: Courier;" |···············<bs:uuid>
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|[[UUID|bs:UUID]]
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Идентификатор версии хозяйствующего субъекта-владельца.
|Уникальный идентификатор региона страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
|-
|-
|41
|32
|style="font-weight: bold; font-family: Courier;" |···············<bs:guid>
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|[[UUID|bs:UUID]]  
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Глобальный идентификатор хозяйствующего субъекта-владельца.
|Глобальный идентификатор региона страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
|style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
|-
|-
|42
|33
|style="font-weight: bold; font-family: Courier;" |············</vd:tmOwner>
|style="font-weight: bold; font-family: Courier;" |···············</dt:region>
|
|
|
|
Строка 401: Строка 354:
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|43
|34
|style="font-weight: bold; font-family: Courier;" |············<vd:producing>
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:locality>
|[[ProductItemProducing_v2.0|dt:ProductItemProducing]]
|[[Localilty_v2.0|dt:Localilty]]
|[0..*]
|[0..1]
|Список площадок, на которых выпускается данная продукция.
|Город региона страны (город регионального подчинения), где зарегистрирован хозяйствующий субъект.
|style="font-family: Courier;" |
|-
|44
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:location>
|[[Enterprise_v2.0|dt:Enterprise]]
|[1..1]
|Площадка, осуществляющая выпуск продукции.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|45
|35
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|[[UUID|bs:UUID]]
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Идентификатор версии предприятия.
|Уникальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
|-
|-
|46
|36
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|[[UUID|bs:UUID]]  
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Глобальный идентификатор предприятия.
|Глобальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
|style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
|-
|-
|47
|37
|style="font-weight: bold; font-family: Courier;" |···············</dt:location>
|style="font-weight: bold; font-family: Courier;" |···············</dt:locality>
|
|
|
|
Строка 437: Строка 383:
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|48
|38
|style="font-weight: bold; font-family: Courier;" |············</vd:producing>
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:district>
|
|[[Localilty_v2.0|dt:Localilty]]
|
|
|style="font-family: Courier;" |
|-
|49
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:packaging>
|[[Packaging_v2.0|dt:Packaging]]
|[0..1]
|[0..1]
|Фасовка.
|Район региона страны, где зарегистрирован хозяйствующий субъект.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|50
|39
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:packagingType>
|[[PackingType_v2.0|dt:PackingType]]
|[1..1]
|Тип упаковки.
|style="font-family: Courier;" |&lt;dt:packagingType>1</dt:packagingType>
|-
|51
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|[[UUID|bs:UUID]]
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Идентификатор версии типа упаковки.
|Уникальный идентификатор района региона в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
|-
|-
|52
|40
|style="font-weight: bold; font-family: Courier;" |··················&lt;dt:globalID>
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|[[PackingCodeType_v2.0|dt:PackingCodeType]]
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Уникальный идентификатор упаковки.
|Глобальный идентификатор района региона в соответствии со справочником РСХН.
|style="font-family: Courier;" |&lt;dt:globalID>7B</dt:globalID>
|style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
|-
|-
|53
|41
|style="font-weight: bold; font-family: Courier;" |··················&lt;dt:name>
|style="font-weight: bold; font-family: Courier;" |···············</dt:district>
|[[String255|bs:String255]]
|[0..1]
|Наименование упаковки.
|style="font-family: Courier;" |&lt;dt:name>Название</dt:name>
|-
|54
|style="font-weight: bold; font-family: Courier;" |···············</dt:packagingType>
|
|
|
|
Строка 486: Строка 412:
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|55
|42
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:quantity>
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:street>
|[http://www.w3.org/TR/xmlschema-2/#int xs:int]
|[[Street_v2.0|dt:Street]]
|[0..1]
|Количество единиц упаковки.
|style="font-family: Courier;" |&lt;dt:quantity>10</dt:quantity>
|-
|56
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:volume>
|[[Decimal |bs:Decimal]]
|[0..1]
|[0..1]
|Объём единицы упаковки товара.
|Улица города, где зарегистрирован хозяйствующий субъект
|style="font-family: Courier;" |&lt;dt:volume>50</dt:volume>
* Обязательно для заполнения при регистриации хозяйствующих субъектов в городах федерального значения.
|-
|57
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:unit>
|[[Unit_v2.0|dt:Unit]]
|[0..1]
|Единица измерения объёма единицы упаковки товара.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|58
|43
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|[[UUID|bs:UUID]]
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Идентификатор версии единицы измерения.
|Уникальный идентификатор улица города страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
|-
|-
|59
|44
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|[[UUID|bs:UUID]]  
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Глобальный идентификатор единицы измерения.
|Глобальный идентификатор улица города в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
|style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
|-
|-
|60
|45
|style="font-weight: bold; font-family: Courier;" |···············</dt:unit>
|style="font-weight: bold; font-family: Courier;" |···············</dt:street>
|
|
|
|
Строка 529: Строка 442:
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|61
|46
|style="font-weight: bold; font-family: Courier;" |············</dt:packaging>
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:addressView>
|[[String255|bs:String255]]
|[0..1]
|Строковое представление адреса.
|style="font-family: Courier;" |&lt;dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
|-
|47
|style="font-weight: bold; font-family: Courier;" |············</dt:juridicalAddress>
|
|
|
|
Строка 536: Строка 456:
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|62
|48
|style="font-weight: bold; font-family: Courier;" |·········</vd:productItem>
|style="font-weight: bold; font-family: Courier;" |·········</dt:businessEntity>
|
|
|
|
Строка 543: Строка 463:
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|63
|49
|style="font-weight: bold; font-family: Courier;" |······</vd:resultingList>
|style="font-weight: bold; font-family: Courier;" |······</dt:resultingList>
|
|
|
|
Строка 550: Строка 470:
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|64
|50
|style="font-weight: bold; font-family: Courier;" |···</merc:modificationOperation>
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:reason>
|[[String255|bs:String255]]
|[1..1]
|Основание добавления записи в реестр. На этапе формирования справочника указывается текстом, далее в данном поле будет передаваться строковый код из справочника.
|style="font-family: Courier;" |&lt;dt:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</dt:reason>
|-
|51
|style="font-weight: bold; font-family: Courier;" |···</vd:modificationOperation>
|
|
|
|
Строка 557: Строка 484:
|style="font-family: Courier;" |
|style="font-family: Courier;" |
|-
|-
|65
|52
|style="font-weight: bold; font-family: Courier;" |</merc:modifyProducerStockListRequest>
|style="font-weight: bold; font-family: Courier;" |</merc:modifyBusinessEntityRequest>
|
|
|
|

Версия 08:35, 25 сентября 2017

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

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

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

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

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

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

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

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

  • создание нового хозяйствующего субъекта;
  • поиск существующей или добавление новой записи о хозяйствующем субъекте в реестр;
  • редактирование сведений о хозяйствующем субъекте.

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

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

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

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

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

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

1.1. Запрос успешно обработан. В реестре зарегистрирован один из трех типов хозяйствующих субъектов:
1.2. Ошибка обработки запроса, в случае, если хозяйствующих субъект с указанными данными уже существует.
1.3. Некорректный запрос.
1.4. Внутренняя ошибка системы.
2.1. Запрос успешно обработан. Данные хозяйствующего субъекта изменены.
2.2. Произошла ошибка при обработке запроса.
• Некорректный запрос.
• Внутренняя ошибка системы.
3.1. Запрос успешно обработан. Данные хозяйствующего субъекта изменены.
3.2. Произошла ошибка при обработке запроса.
• Некорректный запрос.
• Внутренняя ошибка системы.

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


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

# Название XML-элемента Тип Обязат. Описание Пример
1 <merc:modifyBusinessEntityRequest>
2 ···<merc:localTransactionId> xs:NCName [1..1] Идентификатор заявки в клиентской системе. <bs:guid>A00001</bs:guid>
3 ···<merc:initiator> dt:User [1..1] Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
4 ······<vd:login> xs:NCName [1..1] Логин пользователя, зарегистрированного в системе Меркурий. <vd:login>user_ab_150101</vd:login>
5 ···</merc:initiator>
6 ···<vd:modificationOperation> vd:BEModificationOperation [1..1] Описание операции добавления/изменения информации о хозяйствующем субъекте.
7 ······<dt:type> bs:RegisterModificationType [1..1] Тип операции.
  • CREATE - добавление новой записи в реестр;
  • FIND_OR_CREATE - поиск существующей или добавление новой записи в реестр;
  • UPDATE - внесение изменений в существующую запись. Хозяйствующий субъект может вносить изменения в свои данные, а так же в сведения о хозяйствующих субъектах, которые были добавлены им.
<vd:type>CREATE</vd:type>
8 ······<dt:resultingList> dt:BusinessEntityList [1..1] Список, который содержит сведения о добавляемых хозяйствующих субъектах. На данный момент поддерживается добавление только одного субъекта в рамках одной заявки.
9 ·········<dt:businessEntity> dt:BusinessEntity [1..1] Элемент, содержащий информацию о хозяйствующем субъекте.
10 ············<bs:uuid> bs:UUID [0..1] Идентификатор хозяйствующего субъекта.
  • Указывается в случае изменения данных о хозяйствующем субъекте.
<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
11 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта.
  • Указывается в случае изменения данных о хозяйствующем субъекте.
<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
12 ············<dt:type> dt:BusinessEntityType [1..1] Тип создаваемого или редактируемого хозяйствующего субъекта:
  • 1 - юридическое лицо;
  • 2 - физическое лицо;
  • 3 - индивидуальный предприниматель.
<dt:type>1</dt:type>
13 ············<dt:incorporationForm> dt:IncorporationForm [0..1] Организационно-правовая форма хозяйствующего субъекта. Название указывается согласно общероссийскому классификатору организационно-правовых форм (ОКОПФ). Идентификатор организационно-правовой формы состоит из пяти знаков и вводится без пробелов.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
  • При указании обязательно заполнять либо uuid, либо code.
14 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии организационно-правовой формы хозяйствующего субъекта.
15 ···············<dt:name> bs:String255 [0..1] Название организационно-правовой формы предприятия согласно справочнику ОКОПФ.
  • Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
<dt:name>Общество с ограниченной ответственностью</dt:name>
16 ···············<dt:code> bs:String255 [1..1] Код организационно-правовой формы предприятия согласно справочнику ОКОПФ.
  • Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
<dt:code>12300</dt:code>
17 ···············<dt:shortName> bs:String255 [0..1] Краткое название организационно-правовой формы предприятия.
  • Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
<dt:shortName>ООО</dt:shortName>
18 ············</dt:incorporationForm>
19 ············<dt:name> bs:String255 [0..1] Наименование хозяйствующего субъекта без указания организационно-правовой формы.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
<dt:name>Гладиолус</dt:name>
20 ············<dt:fullName> bs:String255 [0..1] Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
<dt:fullName>Общество с ограниченной ответственностью "Гладиолус"</dt:fullName>
21 ············<dt:fio> bs:String255 [0..1] ФИО физического лица или индивидуального предпринимателя.
  • Обязательно указывается при создании хозяйствующего субъекта - ИП или физического лица.
  • Для юридических лиц поле не указывается.
<dt:fio>Иванов Сергей Петрович</dt:fio>
22 ············<dt:inn> bs:String255 [0..1] ИНН хозяйствующего субъекта.
  • Указывается 10 цифр для юридических лиц.
  • Указывается 12 цифр для физических лиц и ИП.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц поле не указывается.
<dt:inn>3312200096</dt:inn>
23 ············<dt:kpp> bs:String255 [0..1] Код причины постановки на учет.
  • Указывается только для юридических лиц, поле необязательно для заполнения.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
<dt:kpp>163501001</dt:kpp>
24 ············<dt:ogrn> bs:String255 [0..1] ОГРН или ОГРНИП.
  • Обязательно указывается только для юридических лиц.
  • Для ИП ОГРНИП можно не указывать.
  • Для физических лиц поле не указывается.
<dt:ogrn>4085022240002</dt:ogrn>
25 ············<dt:juridicalAddress> dt:Address [1..1] Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект.
  • При создании хозяйствующего субъекта обязательным является указание идентификатора страны, региона, района или города (для городов регионального подчинения) и текстового представления адреса. Желательным является указание адреса в виде идентификаторов компонентов адреса: страна, регион, район, населенный пункт, улица.
  • Для городов федерального подчинения указывается страна, регион (название города) и улица, где зарегистрирован ХС.
26 ···············<dt:country> dt:Country [1..1] Страна, в которой зарегистрирован хозяйствующий субъект.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
27 ··················<bs:uuid> bs:UUID [0..1] Уникальный идентификатор страны в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
28 ··················<bs:guid> bs:UUID [0..1] Глобальный идентификатор страны в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
29 ···············</dt:country>
30 ···············<dt:region> dt:Region [1..1] Регион страны, в которой зарегистрирован хозяйствующий субъект.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
31 ··················<bs:uuid> bs:UUID [0..1] Уникальный идентификатор региона страны в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
32 ··················<bs:guid> bs:UUID [0..1] Глобальный идентификатор региона страны в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
33 ···············</dt:region>
34 ···············<dt:locality> dt:Localilty [0..1] Город региона страны (город регионального подчинения), где зарегистрирован хозяйствующий субъект.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
35 ··················<bs:uuid> bs:UUID [0..1] Уникальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
36 ··················<bs:guid> bs:UUID [0..1] Глобальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
37 ···············</dt:locality>
38 ···············<dt:district> dt:Localilty [0..1] Район региона страны, где зарегистрирован хозяйствующий субъект.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
39 ··················<bs:uuid> bs:UUID [0..1] Уникальный идентификатор района региона в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
40 ··················<bs:guid> bs:UUID [0..1] Глобальный идентификатор района региона в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
41 ···············</dt:district>
42 ···············<dt:street> dt:Street [0..1] Улица города, где зарегистрирован хозяйствующий субъект
  • Обязательно для заполнения при регистриации хозяйствующих субъектов в городах федерального значения.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
43 ··················<bs:uuid> bs:UUID [0..1] Уникальный идентификатор улица города страны в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
44 ··················<bs:guid> bs:UUID [0..1] Глобальный идентификатор улица города в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
45 ···············</dt:street>
46 ···············<dt:addressView> bs:String255 [0..1] Строковое представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
47 ············</dt:juridicalAddress>
48 ·········</dt:businessEntity>
49 ······</dt:resultingList>
50 ······<dt:reason> bs:String255 [1..1] Основание добавления записи в реестр. На этапе формирования справочника указывается текстом, далее в данном поле будет передаваться строковый код из справочника. <dt:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</dt:reason>
51 ···</vd:modificationOperation>
52 </merc:modifyBusinessEntityRequest>

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

# Название XML-элемента Тип Обязат. Описание Пример
1 <merc:modifyBusinessEntityResponse>
2 ···<merc:businessEntity> dt:BusinessEntity [1..2] Данные о хозяйствующем субъекте.
  • В случае изменения в ответе вернутся две записи: старая и новая
3 ······<bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
4 ······<bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта. <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
5 ······<bs:active> xs:boolean [1..1] Является ли запись хозяйствующего субъекта активной:
  • true - запись активна;
  • false - запись не активна.
<bs:active>true</bs:active>
6 ······<bs:last> xs:boolean [1..1] Последняя версия хозяйствующего субъекта:
  • true - да;
  • false - нет.
<bs:last>true</bs:last>
7 ······<bs:status> bs:VersionStatus [1..1] Статус версии хозяйствующего субъекта. <bs:status></bs:status>
8 ······<bs:createDate> xs:DateTime [1..1] Дата создания хозяйствующего субъекта. <bs:createDate>2017-07-07T12:00:00</bs:createDate>
9 ······<bs:updateDate> xs:DateTime [1..1] Дата изменения хозяйствующего субъекта. <bs:updateDate>2017-07-07T12:00:00</bs:updateDate>
10 ······<bs:previous> bs:UUID [0..1] Идентификатор предыдущей версии записи реестра хозяйствующих субъектов. <bs:previous>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:previous>
11 ······<bs:next> bs:UUID [0..1] Идентификатор следующей версии записи реестра хозяйствующих субъектов. <bs:next>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:next>
12 ······<dt:type> dt:BusinessEntityType [1..1] Тип создаваемого или редактируемого хозяйствующего субъекта:
  • 1 - юридическое лицо;
  • 2 - физическое лицо;
  • 3 - индивидуальный предприниматель.
<dt:type>1</dt:type>
13 ······<dt:incorporationForm> dt:IncorporationForm [0..1] Организационно-правовая форма хозяйствующего субъекта. Название указывается согласно общероссийскому классификатору организационно-правовых форм (ОКОПФ). Идентификатор организационно-правовой формы состоит из пяти знаков и вводится без пробелов.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
14 ·········<dt:name> bs:String255 [0..1] Название организационно-правовой формы предприятия согласно справочнику ОКОПФ.
  • Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
<dt:name>Общество с ограниченной ответственностью</dt:name>
15 ·········<dt:code> bs:String255 [1..1] Код организационно-правовой формы предприятия согласно справочнику ОКОПФ.
  • Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
<dt:code>12300</dt:code>
16 ·········<dt:shortName> bs:String255 [0..1] Краткое название организационно-правовой формы предприятия.
  • Указывается только в случае добавления/изменения сведений о хозяйствующем субъекте - юридическом лице.
<dt:shortName>ООО</dt:shortName>
17 ······</dt:incorporationForm>
18 ······<dt:name> bs:String255 [0..1] Наименование хозяйствующего субъекта без указания организационно-правовой формы.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
<dt:name>Гладиолус</dt:name>
19 ······<dt:fullName> bs:String255 [0..1] Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
<dt:fullName>Общество с ограниченной ответственностью "Гладиолус"</dt:fullName>
20 ······<dt:fio> bs:String255 [0..1] ФИО физического лица или индивидуального предпринимателя.
  • Обязательно указывается при создании хозяйствующего субъекта - ИП или физического лица.
  • Для юридических лиц поле не указывается.
<dt:fio>Иванов Сергей Петрович</dt:fio>
21 ······<dt:inn> bs:String255 [0..1] ИНН хозяйствующего субъекта.
  • Указывается 10 цифр для юридических лиц.
  • Указывается 12 цифр для физических лиц и ИП.
  • Обязательно указывается только для юридических лиц.
  • Для физических лиц поле не указывается.
<dt:inn>3312200096</dt:inn>
22 ······<dt:kpp> bs:String255 [0..1] Код причины постановки на учет.
  • Указывается только для юридических лиц, поле необязательно для заполнения.
  • Для физических лиц и для индивидуальных предпринимателей поле не указывается.
<dt:kpp>163501001</dt:kpp>
23 ······<dt:ogrn> bs:String255 [0..1] ОГРН или ОГРНИП.
  • Обязательно указывается только для юридических лиц.
  • Для ИП ОГРНИП можно не указывать.
  • Для физических лиц поле не указывается.
<dt:ogrn>4085022240002</dt:ogrn>
24 ······<dt:juridicalAddress> dt:Address [1..1] Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект.
  • При создании хозяйствующего субъекта обязательным является указание идентификатора страны, региона, района или города (для городов регионального подчинения) и текстового представления адреса. Желательным является указание адреса в виде идентификаторов компонентов адреса: страна, регион, район, населенный пункт, улица.
  • Для городов федерального подчинения указывается страна, регион (название города) и улица, где зарегистрирован ХС.
25 ·········<dt:country> dt:Country [1..1] Страна, в которой зарегистрирован хозяйствующий субъект.
26 ············<bs:uuid> bs:UUID [0..1] Уникальный идентификатор страны в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
27 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор страны в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
28 ·········</dt:country>
29 ·········<dt:region> dt:Region [1..1] Регион страны, в которой зарегистрирован хозяйствующий субъект.
30 ············<bs:uuid> bs:UUID [0..1] Уникальный идентификатор региона страны в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
31 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор региона страны в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
32 ·········</dt:region>
33 ·········<dt:locality> dt:Localilty [0..1] Город региона страны (город регионального подчинения), где зарегистрирован хозяйствующий субъект.
34 ············<bs:uuid> bs:UUID [0..1] Уникальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
35 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
36 ·········</dt:locality>
37 ·········<dt:district> dt:Localilty [0..1] Район региона страны, где зарегистрирован хозяйствующий субъект.
38 ············<bs:uuid> bs:UUID [0..1] Уникальный идентификатор района региона в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
39 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор района региона в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
40 ·········</dt:district>
41 ·········<dt:street> dt:Street [0..1] Улица города, где зарегистрирован хозяйствующий субъект
  • Обязательно для заполнения при регистриации хозяйствующих субъектов в городах федерального значения.
42 ············<bs:uuid> bs:UUID [0..1] Уникальный идентификатор улица города страны в соответствии со справочником РСХН. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
43 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор улица города в соответствии со справочником РСХН. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
44 ·········</dt:street>
45 ·········<dt:addressView> bs:String255 [0..1] Строковое представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
46 ······</dt:juridicalAddress>
47 ···</merc:businessEntity>
48 </merc:modifyBusinessEntityResponse>

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

Запрос 1. Поиск хозяйствующего субъекта. Если хозяйствующий субъект с таким ИНН уже существует, то вернётся не ошибка, а данные этого хозяйствующего субъекта. Если хозяйствующего субъекта с таким ИНН нет, то в реестр будет добавлена новая запись. Операция выполняется от имени хозяйствующего субъекта.
<SOAP-ENV:Envelope xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2" xmlns:bs="http://api.vetrf.ru/schema/cdm/base" xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/g2b/applications/v2" xmlns:apldef="http://api.vetrf.ru/schema/cdm/application/ws-definitions" xmlns:apl="http://api.vetrf.ru/schema/cdm/application" xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <apldef:submitApplicationRequest>
      <apldef:apiKey>apikey</apldef:apiKey>
      <apl:application>
        <apl:serviceId>mercury-g2b.service:2.0</apl:serviceId>
        <apl:issuerId>issuerId</apl:issuerId>
        <apl:issueDate>2017-09-18T10:16:12</apl:issueDate>
        <apl:data>
          <merc:modifyBusinessEntityRequest>
            <merc:localTransactionId>a10003</merc:localTransactionId>
            <merc:initiator>
              <vd:login>user_login</vd:login>
            </merc:initiator>
            <merc:modificationOperation>
              <vd:type>FIND_OR_CREATE</vd:type>
              <vd:resultingList>
                <dt:businessEntity>
                  <dt:type>1</dt:type>
                  <dt:name>ООО "ААА"</dt:name>
                  <dt:incorporationForm>
                    <bs:uuid>f381ed23-8afd-447b-8c45-652a1d6c2d0b</bs:uuid>
                  </dt:incorporationForm>
                  <dt:fullName>Общество с ограниченной ответственностью "ААА"</dt:fullName>
                  <dt:inn>3528077014</dt:inn>
                  <dt:ogrn>1023501253236</dt:ogrn>
                  <dt:juridicalAddress>
                    <dt:country>
                      <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                    </dt:country>
                    <dt:region>
                      <bs:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</bs:guid>
                    </dt:region>
                    <dt:locality>
                      <bs:guid>0d7d5d87-f0a6-428f-b655-d3be106c64a2</bs:guid>
                    </dt:locality>
                    <dt:addressView>600021, обл.Владимирская, г.Муром, ул. Московская, 177</dt:addressView>
                  </dt:juridicalAddress>
                </dt:businessEntity>
              </vd:resultingList>
              <vd:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</vd:reason>
            </merc:modificationOperation>
          </merc:modifyBusinessEntityRequest>
        </apl:data>
      </apl:application>
    </apldef:submitApplicationRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


Ответ на запрос 1.
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
   <env:Header/>
   <env:Body>
      <receiveApplicationResultResponse xmlns="http://api.vetrf.ru/schema/cdm/application/ws-definitions">
         <application xmlns="http://api.vetrf.ru/schema/cdm/application">
            <applicationId>ec807820-c1a8-45d0-b96a-bb1bdc751579</applicationId>
            <status>COMPLETED</status>
            <serviceId>mercury-g2b.service</serviceId>
            <issuerId>issuerId</issuerId>
            <issueDate>2017-09-18T10:16:12.000+03:00</issueDate>
            <rcvDate>2017-09-18T15:36:56.000+03:00</rcvDate>
            <prdcRsltDate>2017-09-18T15:36:56.000+03:00</prdcRsltDate>
            <result>
               <merc:modifyBusinessEntityResponse xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2" xmlns:bs="http://api.vetrf.ru/schema/cdm/base" xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/g2b/applications/v2">
                  <merc:businessEntity>
                     <bs:uuid>a85c3044-d4f0-4b20-a63e-917398e1b897</bs:uuid>
                     <bs:guid>1d8a74d2-1652-4b24-8456-72475906b238</bs:guid>
                     <bs:active>true</bs:active>
                     <bs:last>true</bs:last>
                     <bs:status>100</bs:status>
                     <bs:createDate>2017-09-18T15:36:57+03:00</bs:createDate>
                     <bs:updateDate>2017-09-18T15:36:57+03:00</bs:updateDate>
                     <dt:type>1</dt:type>
                     <dt:name>ООО "ААА"</dt:name>
                     <dt:incorporationForm>
                        <bs:uuid>f381ed23-8afd-447b-8c45-652a1d6c2d0b</bs:uuid>
                     </dt:incorporationForm>
                     <dt:fullName>Общество с ограниченной ответственностью "ААА"</dt:fullName>
                     <dt:inn>3528077014</dt:inn>
                     <dt:ogrn>1023501253236</dt:ogrn>
                     <dt:juridicalAddress>
                        <dt:country>
                           <bs:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</bs:uuid>
                           <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                        </dt:country>
                        <dt:region>
                           <bs:uuid>18489346-08c0-41f4-9a46-b9d1f5a819d9</bs:uuid>
                           <bs:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</bs:guid>
                        </dt:region>
                        <dt:locality>
                           <bs:uuid>05c2b5fb-cdb6-41f6-a4a6-0209b435aad3</bs:uuid>
                           <bs:guid>0d7d5d87-f0a6-428f-b655-d3be106c64a2</bs:guid>
                        </dt:locality>
                        <dt:addressView>Российская Федерация, Владимирская область, г. Муром</dt:addressView>
                     </dt:juridicalAddress>
                  </merc:businessEntity>
               </merc:modifyBusinessEntityResponse>
            </result>
         </application>
      </receiveApplicationResultResponse>
   </env:Body>
</env:Envelope>