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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
м (Nikeshina-ad-171025 переименовал страницу AddBussinessEntityUser v2.0 в AddBussinessEntityUser v2)
 
(не показано 40 промежуточных версий 5 участников)
Строка 1: Строка 1:
==Общие сведения==
==Общие сведения==
Операция '''ModifyBusinessEntityOperation''' предназначена для регистрации новых хозяйствующих субъектов в реестре, а так же для изменения информации об уже зарегистрированных.  
Операция '''AddBussinessEntityUser''' предназначена для регистрации новых пользователей в системе Меркурий или привязки существующих пользователей к хозяйствующему субъекту.
Хозяйствующий субъект может быть трех типов:
* юридическое лицо;
'''При выполнении операции на вход системы передаются следующие сведения:'''
* индивидуальный предприниматель/КФХ;
:* информация о пользователе - инициаторе запроса;
* физическое лицо.  
:* имя пользователя или уникальный идентификатор, если существующий пользователь привязывается к ХС;
:* данные пользователя (ФИО, паспортные данные, гражданство, адрес электронной почты), если регистрируется новый пользователь;
:* при регистрации нового пользователя опционально могут быть переданы дополнительные данные пользователя (телефон, рабочий телефон, рабочий адрес электронной почты и т.д.), которые будут сохранены в системе "Ветис.Паспорт";
:* при регистрации нового пользователя опционально может быть передан список прав пользователя, но назначены эти права будут после активации созданного пользователя.


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


Идентификация  каждой  записи  производится  по следующим полям:
{{ambox
* GUID - глобальный идентификатор записи. Данный идентификатор остается неизменным для всех версий записи о хозяйствующем субъекте.
|type      = warning
* UUID - идентификатор версии записи. Данный идентификатор изменяется для каждой новой версии записи о хозяйствующем субъекте.
|text      = '''ОБРАТИТЕ ВНИМАНИЕ:'''
При создании каждой новой версии записи о хозяйствующем субъекте, старая версия записи становится неактивной и должна ссылаться на новую версию, а новая — на старую. Таким образом, возможно восстановить историю изменений.  
|text-small = Необходимо указывать существующий активный адрес электронной почты (поле email). На указанную в запросе электронную почту придет письмо с назначенным временным паролем и персональной ссылкой для активации и смены временного пароля на постоянный. Без выполнения активации пользователь не сможет работать в системе Меркурий.
Для одной записи журнала может существовать только одна актуальная версия.
}}


В рамках операции '''ModifyBusinessEntityOperation''' доступны следующие действия:
===Возможные сценарии===
* создание нового хозяйствующего субъекта;
'''1. Регистрация нового пользователя (в запросе не передаются uuid или login).'''
* поиск существующей или добавление новой записи о хозяйствующем субъекте в реестр;
:1.1. В запросе переданы данные уже существующего в системе пользователя:
* редактирование сведений о хозяйствующем субъекте.  
::* Если в запросе переданы уже существующие в системе паспортные данные, то вернется отказ в выполнении операции.
::* Если в запросе передан уже существующий в системе адрес электронной почты, то вернется отказ в выполнении операции.
:1.2. В запросе переданы данные отсутствующего в системе пользователя:
::* Будет создан новый пользователь, все указанные данные будут переданы в систему "Ветис.Паспорт".
::* В ответе будет передано сгенерированное имя пользователя (login).
::* На указанный в запросе email будет отправлено письмо с информацией о регистрации нового пользователя, временным паролем для входа, ссылкой для активации пользователя и смены пароля.
::* Пользователь будет привязан к хозяйствующему субъекту.
:1.3. Некорректный запрос.
:1.4. Внутренняя ошибка системы.
'''2. Привязка существующего пользователя к хозяйствующему субъекту (в запросе передаются uuid или login).'''
:2.1. В запросе передан существующий в системе пользователь:
::* Пользователь будет привязан к хозяйствующему субъекту.
:2.2. В запросе передан отсутствующий в системе пользователь:
::* Отказ в выполнении операции.
:2.3. Некорректный запрос.
:2.4. Внутренняя ошибка системы.
<br />
{{ambox
|type      = notice
|text      = '''Инициатор запроса'''
|text-small = Инициатор запроса должен иметь связь с хозяйствующем субъектом, к которому привязывается указываемый в запросе пользователь. Для выполнения операций по добавлению пользователей инициатор запроса должен иметь роль "Администратор ХС" в системе "Ветис.Паспорт".
}}
{{ambox
|type      = notice
|text      = '''Регистрация или привязка списка пользователей'''
|text-small = Операция поддерживает регистрацию списка новых пользователей или привязку списка существующих пользователей к хозяйствующему субъекту.
}}


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


Результатом выполнения данной операции в зависимости от типа операции является:
На данный момент доступен для назначения следующий список прав:
* добавление записи о новом хозяйствующем субъекте в реестре;
 
* внесение изменений в существующую запись.
{| class="wikitable"
|-
! ID роли !! Наименование роли
|-
| '''MERCURY_ACCESS_WEB_READ''' || Доступ к веб-интерфейсу ИС Меркурий только на чтение
|-
| '''MERCURY_ACCESS_WEB_WRITE''' || Доступ к веб-интерфейсу ИС Меркурий на выполнение операций
|-
| '''ARGUS_HS_AUTHORIZED_APPLICANT''' || Авторизованный заявитель в системе Аргус
|-
| '''MERCURY_ACCESS_API_READ''' || Доступ к ИС Меркурий через Ветис.API только на чтение
|-
| '''MERCURY_CONTROL_WORKING_AREA''' || Управление зонами ответственности пользователей
|-
| '''MERCURY_ACCESS_API_WRITE''' || Доступ к ИС Меркурий через Ветис.API на выполнение операций
|-
| '''MERCURY_CERTIFICATE_ACCEPTANCE''' || Гашение ВСД
|-
| '''MERCURY_AUTHORIZED_CERTIFICATE_ACCEPTANCE''' || Уполномоченное гашение ВСД
|-
| '''MERCURY_AUTHORIZED_RETURNED_CERTIFICATE_CREATION''' || Уполномоченное оформление возвратных ВСД
|-
| '''MERCURY_HS_FISH_CERTIFICATE''' || Сертификация уловов ВБР
|-
| '''MERCURY_PRODUCTION_BATCH_CERTIFICATE''' || Оформление ВСД на производственную партию
|-
| '''MERCURY_HS_AUTHORIZED_APPLICANT''' || Авторизованный заявитель в системе Меркурий
|-
| '''MERCURY_RETURNED_CERTIFICATE_CREATION''' || Оформление возвратных ВСД
|-
| '''MERCURY_HS_AUTHORIZED_646''' || Уполномоченное лицо (Оформление ВСД на продукцию из Приказа МСХ РФ № 646)
|-
| '''MERCURY_HS_FRESH_MILK_CERTIFICATE''' || Оформление ВСД на сырое молоко (при наличии справки о безопасности сырого молока)
|-
| '''MERCURY_CREATE_INVENTORY_ACT''' || Создание акта инвентаризации
|-
| '''MERCURY_CREATE_COLLATION_ACT''' || Создание акта сверки
|-
| '''MERCURY_CREATE_DECOMMISSION_ACT''' || Создание акта списания
|}


===Возможные сценарии===
'''Список доступных ролей также можно получить с помощью операции - [[GetApplicableUserAuthorityList_v2.0|getApplicableUserAuthorityList]].'''
При выполнении операции возможны следующие сценарии:<br />
1. Создание хозяйствующего субъекта.
:1.1. Запрос успешно обработан. В реестре зарегистрирован один из трех типов хозяйствующих субъектов:<br />
::* <div id ="legalEntity">юридическое лицо;</div>
::* <div id = "physicalPerson">физическое лицо;</div>
::* <div id="entrepreneur">индивидуальный предприниматель. </div>
:1.2. Ошибка обработки запроса, в случае, если хозяйствующих субъект с указанными данными уже существует.
:1.3. Некорректный запрос.
:1.4. Внутренняя ошибка системы.
<div id="changeData">2. Изменение данных хозяйствующего субъекта.</div>
:2.1. Запрос успешно обработан. Данные хозяйствующего субъекта изменены.<br />
:2.2. Произошла ошибка при обработке запроса.
:: • Некорректный запрос.
:: • Внутренняя ошибка системы.
<div id="search">3. Поиск хозяйствующего субъекта по ИНН и ОГРН. Пользователь передает сведения о хозяйствующем субъекте и в реестре осуществляется поиск по этим данным. В случае, если запрашиваемый хозяйствующий субъект уже существует (проверка осуществляется по ОГРН), то пользователю возвращается информация об этом хозяйствующем субъекте. Если хозяйствующего субъекта с указанными данными нет в реестре, то в реестр добавляется соответствующая запись.</div>
:3.1. Запрос успешно обработан. Данные хозяйствующего субъекта изменены.<br />
:3.2. Произошла ошибка при обработке запроса.
:: • Некорректный запрос.
:: • Внутренняя ошибка системы.


===Используемые пространства имен ===
===Используемые пространства имен и типы===
{{столбцы}}
{{столбцы}}
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2|vd]] (<nowiki>http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2</nowiki>)
** [[AuthorityList_v2.0|vd:AuthorityList]]
** [[Citizenship_v2.0|vd:Citizenship]]
** [[Document_v2.0|vd:Document]]
** [[SNILSType_v2.0|vd:SNILSType]]
** [[UserAuthority_v2.0|vd:UserAuthority]]
** [[User_v2.0|vd:User]]
{{столбец}}
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/base|bs]] (<nowiki>http://api.vetrf.ru/schema/cdm/base</nowiki>)
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/base|bs]] (<nowiki>http://api.vetrf.ru/schema/cdm/base</nowiki>)
** [[RegisterModificationType_v2.0|bs:RegisterModificationType]]
** [[String255|bs:String255]]
** [[String255|bs:String255]]
** [[UUID|bs:UUID]]
** [[UUID|bs:UUID]]
** [[UUID|bs:UUID]]
** [[VersionStatus|bs:VersionStatus]]


* [[NameSpaces#http://api.vetrf.ru/schema/cdm/dictionary|dt]] (<nowiki>http://api.vetrf.ru/schema/cdm/dictionary</nowiki>)
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/dictionary/v2|dt]] (<nowiki>http://api.vetrf.ru/schema/cdm/dictionary/v2</nowiki>)
** [[Address_v2.0|dt:Address]]
** [[BusinessEntity_v2.0|dt:BusinessEntity]]
** [[BusinessEntityList_v2.0|dt:BusinessEntityList]]
** [[BusinessEntityType_v2.0|dt:BusinessEntityType]]
** [[Country_v2.0|dt:Country]]
** [[Country_v2.0|dt:Country]]
** [[IncorporationForm_v2.0|dt:IncorporationForm]]
** [[DocumentType_v2.0|dt:DocumentType]]
** [[Locality_v2.0|dt:Locality]]
 
** [[Region_v2.0|dt:Region]]
** [[Street_v2.0|dt:Street]]
** [[User_v2.0|dt:User]]
{{столбец}}
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/mercury/vet-document|vd]] (<nowiki>http://api.vetrf.ru/schema/cdm/mercury/vet-document</nowiki>)
** [[BEModificationOperation_v2.0|vd:BEModificationOperation]]
* [[NameSpaces#http://www.w3.org/2001/XMLSchema|xs]] (<nowiki>http://www.w3.org/2001/XMLSchema</nowiki>)
* [[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/#boolean xs:boolean]
** [http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
** [http://www.w3.org/TR/xmlschema-2/#DateTime xs:date]
** [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
** [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]


{{столбцы/конец}}
{{столбцы/конец}}


==Данные запроса==
==Спецификация запроса==
{| class="wikitable"
{| class="wikitable"
! #
! #
Строка 87: Строка 132:
! Тип
! Тип
! Обязат.
! Обязат.
! Описание
! Описание (нажмите [...] для отображения дополнительного описания)
! Пример
|-
|-
|1
|001
|style="font-weight: bold; font-family: Courier;" |<merc:modifyBusinessEntityRequest>
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<{{color|#660e7a|merc:}}addBusinessEntityUserRequest>'''}}
|
|
|
|
|
| style="width:52em;"|  
|style="font-family: Courier;" |
|-
|-
|2
|002
|style="font-weight: bold; font-family: Courier;" |···<merc:localTransactionId>
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|merc:}}localTransactionId>'''}}{{color|#131313|А0001}}{{color|#190dbf|'''</{{color|#660e7a|merc:}}localTransactionId>'''}}
|[http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|[http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|[1..1]
|[1..1]
|Идентификатор заявки в клиентской системе.
| style="width:52em;"| Идентификатор заявки в клиентской системе.
|style="font-family: Courier;" |<bs:guid>A00001</bs:guid>
|-
|-
|3
|003
|style="font-weight: bold; font-family: Courier;" |···<merc:initiator>
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|merc:}}initiator>'''}}
|[[User_v2.0|dt:User]]
|[[User_v2.0|vd:User]]
|[1..1]
|[1..1]
|Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|style="font-family: Courier;" |
<span style="white-space:nowrap; font-weight: normal;">Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу.</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* Является ответственным за выполнение бизнес-операции.  
* Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.</div>
</div>
|-
|-
|4
|004
|style="font-weight: bold; font-family: Courier;" |······<vd:login>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}login>'''}}{{color|#131313|user_ab_150101}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}login>'''}}
|[http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|[http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|[1..1]
|[1..1]
|Логин пользователя, зарегистрированного в системе Меркурий.
| style="width:52em;"| Логин пользователя, зарегистрированного в системе Меркурий.
|style="font-family: Courier;" |<vd:login>user_ab_150101</vd:login>
|-
|-
|5
|005
|style="font-weight: bold; font-family: Courier;" |···</merc:initiator>
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|merc:}}initiator>'''}}
|
|
|
|
|
|style="font-family: Courier;" |
| style="width:52em;"|  
|-
|-
|6
|006
|style="font-weight: bold; font-family: Courier;" |···<merc:modificationOperation>
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|vd:}}user>'''}}
|[[BEModificationOperation_v2.0|vd:BEModificationOperation]]
|[[User_v2.0|vd:User]]
|[1..1]
|[1..*]
|Описание операции добавления/изменения информации о хозяйствующем субъекте.
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|style="font-family: Courier;" |
<span style="white-space:nowrap; font-weight: normal;">Описание пользователя системы.</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
* Если регистриуется новый пользователь, то uuid и login не указываются.
* Если существующий пользователь привязывается к ХС, то указывается uuid или login. Остальные поля в случае указания будут проигнорированы.</div>
</div>
|-
|-
|7
|007
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:type>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|UUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|[[RegisterModificationType_v2.0|bs:RegisterModificationType]]
|[1..1]
|Тип операции.
*CREATE - добавление новой записи в реестр;
*FIND_OR_CREATE - поиск существующей или добавление новой записи в реестр;
*UPDATE - внесение изменений в существующую запись. Хозяйствующий субъект может вносить изменения в свои данные, а так же в сведения о хозяйствующих субъектах, которые были добавлены им.
|style="font-family: Courier;" |<vd:type>CREATE</vd:type>
|-
|8
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:resultingList>
|[[BusinessEntityList_v2.0|dt:BusinessEntityList]]
|[1..1]
|Список, который содержит сведения о добавляемых хозяйствующих субъектах. На данный момент поддерживается добавление только одного субъекта в рамках одной заявки.
|style="font-family: Courier;" |
|-
|9
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:businessEntity>
|[[BusinessEntity_v2.0|dt:BusinessEntity]]
|[1..1]
|Данные о хозяйствующем субъекте.
|style="font-family: Courier;" |
|-
|10
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|[[UUID|bs:UUID]]
|[0..1]
|Идентификатор версии хозяйствующего субъекта.
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|-
|11
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|[[UUID|bs:UUID]]  
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Глобальный идентификатор хозяйствующего субъекта.
| style="width:52em;"| Уникальный идентификатор пользователя
|style="font-family: Courier;" |<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
|-
|-
|12
|008
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:type>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}login>'''}}{{color|#131313|ivanov_ii_171105}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}login>'''}}
|[[BusinessEntityType_v2.0|dt:BusinessEntityType]]
|[http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|[1..1]
|Тип создаваемого или редактируемого хозяйствующего субъекта:
*1 - юридическое лицо;
*2 - физическое лицо;
*3 - индивидуальный предприниматель.
|style="font-family: Courier;" |&lt;dt:type>1</dt:type>
|-
|13
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Наименование хозяйствующего субъекта без указания организационно-правовой формы.
| style="width:52em;"| Логин пользователя
* Указывается только для юридических лиц.
* Для физических лиц и для индивидуальных предпринимателей поле не указывается.
|style="font-family: Courier;" |&lt;dt:name>Гладиолус</dt:name>
|-
|-
|14
|009
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:incorporationForm>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}firstName>'''}}{{color|#131313|Иван}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}firstName>'''}}
|[[IncorporationForm_v2.0|dt:IncorporationForm]]
|[1..1]
|Организационно-правовая форма хозяйствующего субъекта.
* Обязательно к указанию uuid или code ОПФ
|style="font-family: Courier;" |
|-
|15
|style="font-weight: bold; font-family: Courier;" |···············<bs:uuid>
|[[UUID|bs:UUID]]
|[0..1]
|Идентификатор версии организационно-правовой формы
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|-
|16
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:name>
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Название организационно-правовой формы предприятия согласно справочнику ОКОПФ.
| style="width:52em;"| Имя
|style="font-family: Courier;" |&lt;dt:name>Общество с ограниченной ответственностью</dt:name>
* Обязательно к указнию только при регистрации нового пользователя
|-
|-
|17
|010
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:code>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}middleName>'''}}{{color|#131313|Иванович}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}middleName>'''}}
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Код организационно-правовой формы предприятия согласно справочнику ОКОПФ.
| style="width:52em;"| Отчество
|style="font-family: Courier;" |&lt;dt:code>12300</dt:code>
* Обязательно к указанию только при регистрации нового пользователя
|-
|-
|18
|011
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:shortName>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}lastName>'''}}{{color|#131313|Иванов}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}lastName>'''}}
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Краткое название организационно-правовой формы предприятия.
| style="width:52em;"| Фамилия
|style="font-family: Courier;" |&lt;dt:shortName>ООО</dt:shortName>
* Обязательно к указанию только при регистрации нового пользователя
|-
|-
|19
|012
|style="font-weight: bold; font-family: Courier;" |············</dt:incorporationForm>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}birthDate>'''}}{{color|#131313|1987-01-02}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}birthDate>'''}}
|
|[http://www.w3.org/TR/xmlschema-2/#date xs:date]
|
|
|style="font-family: Courier;" |
|-
|20
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:fullName>
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
| style="width:52em;"| Дата рождения
|style="font-family: Courier;" |&lt;dt:fullName>Общество с ограниченной ответственностью "Гладиолус"</dt:fullName>
* Обязательно к указанию только при регистрации нового пользователя
|-
|-
|21
|013
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:fio>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}identity>'''}}
|[[String255|bs:String255]]
|[[Document_v2.0|vd:Document]]
|[0..1]
|[0..1]
|ФИО физического лица или индивидуального предпринимателя.
| style="width:52em;"| Документ, удостоверяющий личность
* Для юридических лиц поле не указывается.
* Обязательно к указанию только при регистрации нового пользователя
|style="font-family: Courier;" |&lt;dt:fio>Иванов Сергей Петрович</dt:fio>
|-
|-
|22
|014
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:inn>
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|vd:}}issueSeries>'''}}{{color|#131313|1511}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}issueSeries>'''}}
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[1..1]
|[1..1]
|ИНН хозяйствующего субъекта.
| style="width:52em;"| Серия документа
|style="font-family: Courier;" |&lt;dt:inn>3312200096</dt:inn>
|-
|-
|23
|015
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:kpp>
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|vd:}}issueNumber>'''}}{{color|#131313|241708}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}issueNumber>'''}}
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|Код причины постановки на учет (КПП).
|style="font-family: Courier;" |&lt;dt:kpp>163501001</dt:kpp>
|-
|24
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:ogrn>
|[[String255|bs:String255]]
|[0..1]
|ОГРН или ОГРНИП.
* Для ИП ОГРНИП может быть не указано.
|style="font-family: Courier;" |&lt;dt:ogrn>4085022240002</dt:ogrn>
|-
|25
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:juridicalAddress>
|[[Address_v2.0|dt:Address]]
|[1..1]
|[1..1]
|Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект.
| style="width:52em;"| Номер документа
|style="font-family: Courier;" |
|-
|-
|26
|016
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:country>
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|vd:}}type>'''}}{{color|#131313|17}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}type>'''}}
|[[Country_v2.0|dt:Country]]
|[[DocumentType_v2.0|dt:DocumentType]]
|[1..1]
|[1..1]
|Страна
| style="width:52em;"| Тип документа
* Обязательно должен быть указаны uuid или guid. При указании обоих приоритет у uuid.
* Возможные значения: 17, 18, 19, 20, 21, 22
|style="font-family: Courier;" |
|-
|27
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|[[UUID|bs:UUID]]
|[0..1]
|Уникальный идентификатор страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
|-
|28
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|[[UUID|bs:UUID]]
|[0..1]
|Глобальный идентификатор страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
|-
|-
|29
|017
|style="font-weight: bold; font-family: Courier;" |···············</dt:country>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|vd:}}identity>'''}}
|
|
|
|
|
|style="font-family: Courier;" |
| style="width:52em;"|  
|-
|-
|30
|018
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:region>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}citizenship>'''}}
|[[Region_v2.0|dt:Region]]
|[[Citizenship_v2.0|vd:Citizenship]]
|[1..1]
|Регион
* Обязательно должен быть указаны uuid или guid. При указании обоих приоритет у uuid.
|style="font-family: Courier;" |
|-
|31
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Уникальный идентификатор региона страны в соответствии со справочником РСХН.
| style="width:52em;"| Гражданство пользователя
|style="font-family: Courier;" |<bs:uuid>e440dcdb-31d6-39a4-db63-a1c0731d61d6</bs:uuid>
* Обязательно к указанию только при регистрации нового пользователя
|-
|-
|32
|019
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|vd:}}country>'''}}
|[[UUID|bs:UUID]]
|[[Country_v2.0|dt:Country]]
|[0..1]
|[1..1]
|Глобальный идентификатор региона страны в соответствии со справочником РСХН.
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|style="font-family: Courier;" |<bs:guid>cbdf8cb6-fb9a-4f36-36d3-04488f6d1b82</bs:guid>
<span style="white-space:nowrap; font-weight: normal;">Страна</span>
|-
<div class="mw-collapsible-content" style="font-weight: normal;">
|33
* Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.</div>
|style="font-weight: bold; font-family: Courier;" |···············</dt:region>
</div>
|
|
|
|style="font-family: Courier;" |
|-
|34
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:district>
|[[Locality_v2.0|dt:Locality]]
|[0..1]
|Район региона
* Обязательно должен быть указаны uuid или guid. При указании обоих приоритет у uuid.
|style="font-family: Courier;" |
|-
|35
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|[[UUID|bs:UUID]]
|[0..1]
|Уникальный идентификатор района региона в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>3cb373d5-32f1-ac2a-754c-58d4b33825dd</bs:uuid>
|-
|36
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|[[UUID|bs:UUID]]
|[0..1]
|Глобальный идентификатор района региона в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>90d82878-431a-0cf1-0974-16d4fdff3bc8</bs:guid>
|-
|37
|style="font-weight: bold; font-family: Courier;" |···············</dt:district>
|
|
|
|style="font-family: Courier;" |
|-
|38
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:locality>
|[[Locality_v2.0|dt:Locality]]
|[0..1]
|Населённый пункт
* Обязательно должен быть указаны uuid или guid. При указании обоих приоритет у uuid.
|style="font-family: Courier;" |
|-
|-
|39
|020
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|UUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|[[UUID|bs:UUID]]  
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Уникальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН.
| style="width:52em;"| Уникальный идентификатор страны в соответствии со справочником РСХН.  
|style="font-family: Courier;" |<bs:uuid>70db962b-d3f3-9a13-93d1-f83a9bc6ed80</bs:uuid>
|-
|-
|40
|021
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|[[UUID|bs:UUID]]  
|[[UUID|bs:UUID]]  
|[0..1]
|[0..1]
|Глобальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН.
| style="width:52em;"| Глобальный идентификатор страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>a16545f3-8f9c-2778-099f-a5d302e58712</bs:guid>
|-
|-
|41
|022
|style="font-weight: bold; font-family: Courier;" |···············</dt:locality>
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|vd:}}country>'''}}
|
|
|
|
|
|style="font-family: Courier;" |
| style="width:52em;"|  
|-
|42
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:subLocality>
|[[Locality_v2.0|dt:Locality]]
|[0..1]
|Населённый пункт, подчиненный другогому населенному пункту (locality)
* Обязательно должен быть указаны uuid или guid. При указании обоих приоритет у uuid.
|style="font-family: Courier;" |
|-
|-
|43
|023
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|vd:}}citizenship>'''}}
|[[UUID|bs:UUID]]
|[0..1]
|Уникальный идентификатор населенного пункта в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>3a7b2d0c-2ebd-0dff-9e93-341097ee1db3</bs:uuid>
|-
|44
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|[[UUID|bs:UUID]]
|[0..1]
|Глобальный идентификатор населенного пункта в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>9f315346-b470-3a1c-56d0-ae1afe9579df</bs:guid>
|-
|45
|style="font-weight: bold; font-family: Courier;" |···············</dt:subLocality>
|
|
|
|
|
|style="font-family: Courier;" |
| style="width:52em;"|  
|-
|-
|46
|024
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:street>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}snils>'''}}{{color|#131313|123-123-123 12}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}snils>'''}}
|[[Street_v2.0|dt:Street]]
|[[SNILSType_v2.0|vd:SNILSType]]
|[0..1]
|[0..1]
|Улица
| style="width:52em;"| СНИЛС (опционально)
* Обязательно должен быть указаны uuid или guid. При указании обоих приоритет у uuid.
* Может быть указано только при регистрации нового пользователя
|style="font-family: Courier;" |
|-
|-
|47
|025
|style="font-weight: bold; font-family: Courier;" |··················<bs:uuid>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}phone>'''}}{{color|#131313|23-23-23}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}phone>'''}}
|[[UUID|bs:UUID]]
|[0..1]
|Уникальный идентификатор улицы города страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>90d82878-431a-0cf1-0974-16d4fdff3bc8</bs:uuid>
|-
|48
|style="font-weight: bold; font-family: Courier;" |··················<bs:guid>
|[[UUID|bs:UUID]]
|[0..1]
|Глобальный идентификатор улицы города в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>b014d26b-5391-c852-caa4-60fc9bb0a7d4</bs:guid>
|-
|49
|style="font-weight: bold; font-family: Courier;" |···············</dt:street>
|
|
|
|style="font-family: Courier;" |
|-
|50
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:house>
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Номер дома.
| style="width:52em;"| Телефон пользователя (опционально)
|style="font-family: Courier;" |&lt;dt:house>6</dt:house>
* Может быть указано только при регистрации нового пользователя
|-
|-
|51
|026
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:building>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}email>'''}}{{color|#131313|1511440241708@yandex.ru}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}email>'''}}
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Номер строения.
| style="width:52em;"| Адрес электронной почты пользователя
|style="font-family: Courier;" |&lt;dt:building>1</dt:building>
* Обязательно к указанию только при регистрации нового пользователя
|-
|-
|52
|027
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:room>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}workEmail>'''}}{{color|#131313|34833784001f@yandex.ru}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}workEmail>'''}}
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Номер квартиры / офиса.
| style="width:52em;"| Рабочий адрес электронной почты пользователя (опционально)
|style="font-family: Courier;" |&lt;dt:room>1</dt:room>
* Может быть указано только при регистрации нового пользователя
|-
|-
|53
|028
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:postIndex>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}post>'''}}{{color|#131313|Должность}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}post>'''}}
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Почтовый индекс.
| style="width:52em;"| Должность пользователя (опционально)
|style="font-family: Courier;" |&lt;dt:postIndex>600037</dt:postIndex>
* Может быть указано только при регистрации нового пользователя
|-
|-
|54
|029
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:postBox>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}authorityList>'''}}
|[[String255|bs:String255]]
|[[AuthorityList_v2.0|vd:AuthorityList]]
|[0..1]
|[0..1]
|Абонентский ящик
| style="width:52em;"| Список ролей пользователя (опционально)
|style="font-family: Courier;" |&lt;dt:postBox>а/я 56</dt:postBox>
* Может быть указано только при регистрации нового пользователя
|-
|-
|55
|030
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:additionalInfo>
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|vd:}}authority>'''}}
|[[String255|bs:String255]]
|[[UserAuthority_v2.0|vd:UserAuthority]]
|[0..1]
|[1..*]
|Дополнительная информация.
| style="width:52em;"| Роль пользователя
|style="font-family: Courier;" |&lt;dt:additionalInfo>Доп. инфо</dt:additionalInfo>
|-
|-
|56
|031
|style="font-weight: bold; font-family: Courier;" |···············&lt;dt:addressView>
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|vd:}}ID>'''}}{{color|#131313|MERCURY_AUTHORIZED_APPLICANT}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}ID>'''}}
|[[String255|bs:String255]]
|[http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|[0..1]
|[1..1]
|Строковое представление адреса.
| style="width:52em;"| Идентификатор роли пользователя
|style="font-family: Courier;" |&lt;dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
|-
|-
|57
|032
|style="font-weight: bold; font-family: Courier;" |············</dt:juridicalAddress>
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|vd:}}authority>'''}}
|
|
|
|
|
|style="font-family: Courier;" |
| style="width:52em;"|  
|-
|-
|58
|033
|style="font-weight: bold; font-family: Courier;" |·········</dt:businessEntity>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|vd:}}authorityList>'''}}
|
|
|
|
|
| style="width:52em;"|  
|style="font-family: Courier;" |
|-
|-
|59
|034
|style="font-weight: bold; font-family: Courier;" |······</dt:resultingList>
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|vd:}}user>'''}}
|
|
|
|
|
| style="width:52em;"|  
|style="font-family: Courier;" |
|-
|-
|60
|035
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:reason>
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</{{color|#660e7a|merc:}}addBusinessEntityUserRequest>'''}}
|[[String255|bs:String255]]
|[1..1]
|Основание добавления записи в реестр. На этапе формирования справочника указывается текстом, далее в данном поле будет передаваться строковый код из справочника.
|style="font-family: Courier;" |&lt;dt:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</dt:reason>
|-
|61
|style="font-weight: bold; font-family: Courier;" |···</merc:modificationOperation>
|
|
|
|style="font-family: Courier;" |
|-
|62
|style="font-weight: bold; font-family: Courier;" |</merc:modifyBusinessEntityRequest>
|
|
|
|
|
| style="width:52em;"|  
|style="font-family: Courier;" |
|-
|-
|}
|}


==Данные ответа==
==Спецификация ответа==
{| class="wikitable"
{| class="wikitable"
! #
! #
Строка 549: Строка 379:
! Тип
! Тип
! Обязат.
! Обязат.
! Описание
! Описание (нажмите [...] для отображения дополнительного описания)
! Пример
|-
|-
|1
|001
|style="font-weight: bold; font-family: Courier;" |<merc:modifyBusinessEntityResponse>
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<{{color|#660e7a|merc:}}addBusinessEntityUserResponse>'''}}
|
|
|
|
|
| style="width:52em;"|  
|style="font-family: Courier;" |
|-
|-
|2
|002
|style="font-weight: bold; font-family: Courier;" |···<merc:businessEntity>
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|vd:}}user>'''}}
|[[BusinessEntity_v2.0|dt:BusinessEntity]]
|[[User_v2.0|vd:User]]
|[1..2]
|[1..*]
|Данные о хозяйствующем субъекте.
| style="width:52em;"| Описание пользователя системы
* В случае изменения в ответе вернутся две записи: старая и новая
|style="font-family: Courier;" |
|-
|3
|style="font-weight: bold; font-family: Courier;" |······<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Идентификатор версии хозяйствующего субъекта.
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|-
|-
|4
|003
|style="font-weight: bold; font-family: Courier;" |······<bs:guid>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|UUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|[[UUID|bs:UUID]]  
|[[UUID|bs:UUID]]  
|[1..1]
|[1..1]
|Глобальный идентификатор хозяйствующего субъекта.
| style="width:52em;"| Уникальный идентификатор пользователя
|style="font-family: Courier;" |<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
|-
|-
|5
|004
|style="font-weight: bold; font-family: Courier;" |······<bs:active>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}login>'''}}{{color|#131313|ivanov_ii_171105}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}login>'''}}
|[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
|[http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|[1..1]
|Является ли запись активной:
* true - запись активна;
* false - запись не активна.
|style="font-family: Courier;" |<bs:active>true</bs:active>
|-
|6
|style="font-weight: bold; font-family: Courier;" |······<bs:last>
|[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
|[1..1]
|Является ли версия записи последней:
* true - да;
* false - нет.
|style="font-family: Courier;" |<bs:last>true</bs:last>
|-
|7
|style="font-weight: bold; font-family: Courier;" |······<bs:status>
|[[VersionStatus|bs:VersionStatus]]
|[1..1]
|Статус версии хозяйствующего субъекта.
|style="font-family: Courier;" |<bs:status>230</bs:status>
|-
|8
|style="font-weight: bold; font-family: Courier;" |······<bs:createDate>
|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
|[1..1]
|[1..1]
|Дата создания хозяйствующего субъекта.
| style="width:52em;"| Логин пользователя
|style="font-family: Courier;" |<bs:createDate>2017-07-07T12:00:00</bs:createDate>
|-
|-
|9
|005
|style="font-weight: bold; font-family: Courier;" |······<bs:updateDate>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}firstName>'''}}{{color|#131313|Иван}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}firstName>'''}}
|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
|[1..1]
|Дата изменения хозяйствующего субъекта.
|style="font-family: Courier;" |<bs:updateDate>2017-07-07T12:00:00</bs:updateDate>
|-
|10
|style="font-weight: bold; font-family: Courier;" |······<bs:previous>
|[[UUID|bs:UUID]]
|[0..1]
|Идентификатор предыдущей версии записи реестра хозяйствующих субъектов.
|style="font-family: Courier;" |<bs:previous>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:previous>
|-
|11
|style="font-weight: bold; font-family: Courier;" |······<bs:next>
|[[UUID|bs:UUID]]
|[0..1]
|Идентификатор следующей версии записи реестра хозяйствующих субъектов.
|style="font-family: Courier;" |<bs:next>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:next>
|-
|12
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:type>
|[[BusinessEntityType_v2.0|dt:BusinessEntityType]]
|[1..1]
|Тип создаваемого или редактируемого хозяйствующего субъекта:
*1 - юридическое лицо;
*2 - физическое лицо;
*3 - индивидуальный предприниматель.
|style="font-family: Courier;" |&lt;dt:type>1</dt:type>
|-
|13
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:name>
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|Наименование хозяйствующего субъекта без указания организационно-правовой формы.
* Возвращается только для юридических лиц.
* Для физических лиц и для индивидуальных предпринимателей поле не возвращается.
|style="font-family: Courier;" |&lt;dt:name>Гладиолус</dt:name>
|-
|14
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:incorporationForm>
|[[IncorporationForm_v2.0|dt:IncorporationForm]]
|[1..1]
|Организационно-правовая форма хозяйствующего субъекта.
|style="font-family: Courier;" |
|-
|15
|style="font-weight: bold; font-family: Courier;" |·········<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|[1..1]
|Идентификатор версии организационно-правовой формы
| style="width:52em;"| Имя
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|-
|-
|16
|006
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:name>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}middleName>'''}}{{color|#131313|Иванович}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}middleName>'''}}
|[[String255|bs:String255]]
|[1..1]
|Название организационно-правовой формы предприятия согласно справочнику ОКОПФ.
|style="font-family: Courier;" |&lt;dt:name>Общество с ограниченной ответственностью</dt:name>
|-
|17
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:code>
|[[String255|bs:String255]]
|[1..1]
|Код организационно-правовой формы предприятия согласно справочнику ОКОПФ.
|style="font-family: Courier;" |&lt;dt:code>12300</dt:code>
|-
|18
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:shortName>
|[[String255|bs:String255]]
|[0..1]
|Краткое название организационно-правовой формы предприятия.
|style="font-family: Courier;" |&lt;dt:shortName>ООО</dt:shortName>
|-
|19
|style="font-weight: bold; font-family: Courier;" |······</dt:incorporationForm>
|
|
|
|style="font-family: Courier;" |
|-
|20
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:fullName>
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[0..1]
|[0..1]
|Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
| style="width:52em;"| Отчество
|style="font-family: Courier;" |&lt;dt:fullName>Общество с ограниченной ответственностью "Гладиолус"</dt:fullName>
|-
|21
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:fio>
|[[String255|bs:String255]]
|[0..1]
|ФИО физического лица или индивидуального предпринимателя.
* Для юридических лиц поле не возвращается.
|style="font-family: Courier;" |&lt;dt:fio>Иванов Сергей Петрович</dt:fio>
|-
|22
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:inn>
|[[String255|bs:String255]]
|[0..1]
|ИНН хозяйствующего субъекта.
|style="font-family: Courier;" |&lt;dt:inn>3312200096</dt:inn>
|-
|23
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:kpp>
|[[String255|bs:String255]]
|[0..1]
|Код причины постановки на учет (КПП).
|style="font-family: Courier;" |&lt;dt:kpp>163501001</dt:kpp>
|-
|24
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:ogrn>
|[[String255|bs:String255]]
|[0..1]
|ОГРН или ОГРНИП.
* Для ИП ОГРНИП может быть не указано.
|style="font-family: Courier;" |&lt;dt:ogrn>4085022240002</dt:ogrn>
|-
|25
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:juridicalAddress>
|[[Address_v2.0|dt:Address]]
|[1..1]
|Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект.
|style="font-family: Courier;" |
|-
|26
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:country>
|[[Country_v2.0|dt:Country]]
|[1..1]
|Страна
|style="font-family: Courier;" |
|-
|27
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Уникальный идентификатор страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
|-
|28
|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>
|-
|29
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|[[String255|bs:String255]]
|[1..1]
|Наименование страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |&lt;dt:name>Российская Федерация</dt:name>
|-
|-
|30
|007
|style="font-weight: bold; font-family: Courier;" |·········</dt:country>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}lastName>'''}}{{color|#131313|Иванов}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}lastName>'''}}
|
|
|
|style="font-family: Courier;" |
|-
|31
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:region>
|[[Region_v2.0|dt:Region]]
|[1..1]
|Регион
|style="font-family: Courier;" |
|-
|32
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Уникальный идентификатор региона страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>e440dcdb-31d6-39a4-db63-a1c0731d61d6</bs:uuid>
|-
|33
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор региона страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>cbdf8cb6-fb9a-4f36-36d3-04488f6d1b82</bs:guid>
|-
|34
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[1..1]
|[1..1]
|Наименование региона страны в соответствии со справочником РСХН.
| style="width:52em;"| Фамилия
|style="font-family: Courier;" |&lt;dt:name>Владимирская область</dt:name>
|-
|35
|style="font-weight: bold; font-family: Courier;" |·········</dt:region>
|
|
|
|style="font-family: Courier;" |
|-
|36
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:district>
|[[Locality_v2.0|dt:Locality]]
|[0..1]
|Район региона
|style="font-family: Courier;" |
|-
|37
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Уникальный идентификатор района региона в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>3cb373d5-32f1-ac2a-754c-58d4b33825dd</bs:uuid>
|-
|38
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор района региона в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>90d82878-431a-0cf1-0974-16d4fdff3bc8</bs:guid>
|-
|-
|39
|008
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}workEmail>'''}}{{color|#131313|mail@mail.ru}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}workEmail>'''}}
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[1..1]
|Наименование района региона в соответствии со справочником РСХН.
|style="font-family: Courier;" |&lt;dt:name>Собинский район</dt:name>
|-
|40
|style="font-weight: bold; font-family: Courier;" |·········</dt:district>
|
|
|
|style="font-family: Courier;" |
|-
|41
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:locality>
|[[Locality_v2.0|dt:Locality]]
|[0..1]
|[0..1]
|Населённый пункт
| style="width:52em;"| Рабочий адрес электронной почты пользователя
|style="font-family: Courier;" |
|-
|-
|42
|009
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}post>'''}}{{color|#131313|Должность}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}post>'''}}
|[[UUID|bs:UUID]]
|[1..1]
|Уникальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>70db962b-d3f3-9a13-93d1-f83a9bc6ed80</bs:uuid>
|-
|43
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>a16545f3-8f9c-2778-099f-a5d302e58712</bs:guid>
|-
|44
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[1..1]
|Наименование города региона (города регионального подчинения) страны в соответствии со справочником РСХН.
|style="font-family: Courier;" |&lt;dt:name>Владимир г</dt:name>
|-
|45
|style="font-weight: bold; font-family: Courier;" |·········</dt:locality>
|
|
|
|style="font-family: Courier;" |
|-
|46
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:subLocality>
|[[Locality_v2.0|dt:Locality]]
|[0..1]
|[0..1]
|Населённый пункт, подчиненный другогому населенному пункту (locality)
| style="width:52em;"| Должность пользователя
|style="font-family: Courier;" |
|-
|47
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Уникальный идентификатор населенного пункта в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:uuid>3a7b2d0c-2ebd-0dff-9e93-341097ee1db3</bs:uuid>
|-
|48
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор населенного пункта в соответствии со справочником РСХН.
|style="font-family: Courier;" |<bs:guid>9f315346-b470-3a1c-56d0-ae1afe9579df</bs:guid>
|-
|-
|49
|010
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}authorityList>'''}}
|[[String255|bs:String255]]
|[[AuthorityList_v2.0|vd:AuthorityList]]
|[1..1]
|Наименование населенного пункта в соответствии со справочником РСХН.
|style="font-family: Courier;" |&lt;dt:name>Энергетик мкрн</dt:name>
|-
|50
|style="font-weight: bold; font-family: Courier;" |·········</dt:subLocality>
|
|
|
|style="font-family: Courier;" |
|-
|51
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:street>
|[[Street_v2.0|dt:Street]]
|[0..1]
|[0..1]
|Улица
| style="width:52em;"| Список ролей пользователя
|style="font-family: Courier;" |
|-
|-
|52
|011
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|vd:}}authority>'''}}
|[[UUID|bs:UUID]]  
|[[UserAuthority_v2.0|vd:UserAuthority]]
|[1..1]
|[1..*]
|Уникальный идентификатор улицы города страны в соответствии со справочником РСХН.
| style="width:52em;"| Роль пользователя
|style="font-family: Courier;" |<bs:uuid>90d82878-431a-0cf1-0974-16d4fdff3bc8</bs:uuid>
|-
|-
|53
|012
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|vd:}}ID>'''}}{{color|#131313|MERCURY_AUTHORIZED_APPLICANT}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}ID>'''}}
|[[UUID|bs:UUID]]  
|[http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|[1..1]
|[1..1]
|Глобальный идентификатор улицы города в соответствии со справочником РСХН.
| style="width:52em;"| Идентификатор роли пользователя
|style="font-family: Courier;" |<bs:guid>b014d26b-5391-c852-caa4-60fc9bb0a7d4</bs:guid>
|-
|-
|54
|013
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|vd:}}name>'''}}{{color|#131313|Авторизованный заявитель в системе Меркурий}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}name>'''}}
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[1..1]
|[1..1]
|Наименование улицы города в соответствии со справочником РСХН.
| style="width:52em;"| Описание роли пользователя
|style="font-family: Courier;" |&lt;dt:name>Энергетиков ул</dt:name>
|-
|-
|55
|014
|style="font-weight: bold; font-family: Courier;" |·········</dt:street>
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|vd:}}authority>'''}}
|
|
|
|
|
|style="font-family: Courier;" |
| style="width:52em;"|  
|-
|-
|56
|015
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:house>
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|vd:}}authorityList>'''}}
|[[String255|bs:String255]]
|[0..1]
|Номер дома.
|style="font-family: Courier;" |&lt;dt:house>6</dt:house>
|-
|57
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:building>
|[[String255|bs:String255]]
|[0..1]
|Номер строения.
|style="font-family: Courier;" |&lt;dt:building>1</dt:building>
|-
|58
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:room>
|[[String255|bs:String255]]
|[0..1]
|Номер квартиры / офиса.
|style="font-family: Courier;" |&lt;dt:room>1</dt:room>
|-
|59
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:postIndex>
|[[String255|bs:String255]]
|[0..1]
|Почтовый индекс.
|style="font-family: Courier;" |&lt;dt:postIndex>600037</dt:postIndex>
|-
|60
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:postBox>
|[[String255|bs:String255]]
|[0..1]
|Абонентский ящик
|style="font-family: Courier;" |&lt;dt:postBox>а/я 56</dt:postBox>
|-
|61
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:additionalInfo>
|[[String255|bs:String255]]
|[0..1]
|Дополнительная информация.
|style="font-family: Courier;" |&lt;dt:additionalInfo>Доп. инфо</dt:additionalInfo>
|-
|62
|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>
|-
|63
|style="font-weight: bold; font-family: Courier;" |······</dt:juridicalAddress>
|
|
|
|
|
| style="width:52em;"|  
|style="font-family: Courier;" |
|-
|-
|64
|016
|style="font-weight: bold; font-family: Courier;" |···</merc:businessEntity>
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|vd:}}user>'''}}
|
|
|
|
|
|style="font-family: Courier;" |
| style="width:52em;"|  
|-
|-
|65
|017
|style="font-weight: bold; font-family: Courier;" |</merc:modifyBusinessEntityResponse>
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</{{color|#660e7a|merc:}}addBusinessEntityUserResponse>'''}}
|
|
|
|
|
|style="font-family: Courier;" |
| style="width:52em;"|  
|-
|-
|}
|}


==Примеры запросов==
==Примеры запросов==
===Поиск или создание нового хозяйствующего субъекта===
===Регистрация нового пользователя===
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id = "scenario5">Регистрация нового пользователя</div>
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<SOAP-ENV:Envelope 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>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08</apl:issueDate>
        <apl:data>
          <merc:addBusinessEntityUserRequest>
            <merc:localTransactionId>a10003</merc:localTransactionId>
            <merc:initiator>
              <vd:login>login</vd:login>
            </merc:initiator>
            <vd:user>
              <vd:firstName>Иван</vd:firstName>
              <vd:middleName>Иванович</vd:middleName>
              <vd:lastName>Иванов</vd:lastName>
              <vd:birthDate>1987-01-02</vd:birthDate>
              <vd:identity>
                <vd:issueSeries>1508</vd:issueSeries>
                <vd:issueNumber>436542</vd:issueNumber>
                <vd:type>17</vd:type>
              </vd:identity>
              <vd:citizenship>
                <vd:country>
                  <bs:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</bs:uuid>
                  <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                </vd:country>
              </vd:citizenship>
              <vd:email>1508871436542@yandex.ru</vd:email>
            </vd:user>
          </merc:addBusinessEntityUserRequest>
        </apl:data>
      </apl:application>
    </apldef:submitApplicationRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</syntaxhighlight>
</div>
</div>
<br/>
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id = "scenario5">Ответ на запрос</div>
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<env:Envelope 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:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2">
  <env:Header/>
  <env:Body>
    <apldef:receiveApplicationResultResponse>
      <apl:application>
        <apl:applicationId>ecd5b39a-7bbf-41c5-adfe-a92259b72584</apl:applicationId>
        <apl:status>COMPLETED</apl:status>
        <apl:serviceId>mercury-g2b.service</apl:serviceId>
        <apl:issuerId>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08.000+03:00</apl:issueDate>
        <apl:rcvDate>2017-11-08T10:32:07.000+03:00</apl:rcvDate>
        <apl:prdcRsltDate>2017-11-08T10:32:08.000+03:00</apl:prdcRsltDate>
        <apl:result>
          <merc:addBusinessEntityUserResponse>
            <vd:user>
              <bs:uuid>6c2eb90a-b717-4075-8093-32d59b684452</bs:uuid>
              <vd:login>ivanov_ii_171108</vd:login>
              <vd:firstName>Иван</vd:firstName>
              <vd:middleName>Иванович</vd:middleName>
              <vd:lastName>Иванов</vd:lastName>
              <vd:birthDate>1987-01-02T00:00:00.000+03:00</vd:birthDate>
              <vd:email>1508871436542@yandex.ru</vd:email>
            </vd:user>
          </merc:addBusinessEntityUserResponse>
        </apl:result>
      </apl:application>
    </apldef:receiveApplicationResultResponse>
  </env:Body>
</env:Envelope>
</syntaxhighlight>
</div>
</div>
<br/>
 
===Привязка существующего пользователя к хозяйствующему субъекту===
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id = "scenario5">Поиск и добавление в случае отсутствия нового ХС</div>
<div id = "scenario5">Привязка существующего пользователя к хозяйствующему субъекту</div>
<div class = "mw-collapsible-content">
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<SOAP-ENV:Envelope xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2"
<SOAP-ENV:Envelope xmlns:bs="http://api.vetrf.ru/schema/cdm/base"  
xmlns:bs="http://api.vetrf.ru/schema/cdm/base"  
xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/g2b/applications/v2"  
xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/g2b/applications/v2"  
xmlns:apldef="http://api.vetrf.ru/schema/cdm/application/ws-definitions"  
xmlns:apldef="http://api.vetrf.ru/schema/cdm/application/ws-definitions"  
Строка 1041: Строка 601:
         <apl:serviceId>mercury-g2b.service:2.0</apl:serviceId>
         <apl:serviceId>mercury-g2b.service:2.0</apl:serviceId>
         <apl:issuerId>Id</apl:issuerId>
         <apl:issuerId>Id</apl:issuerId>
         <apl:issueDate>2017-10-15T13:25:17</apl:issueDate>
         <apl:issueDate>2017-11-08T10:32:08</apl:issueDate>
         <apl:data>
         <apl:data>
           <merc:modifyBusinessEntityRequest>
           <merc:addBusinessEntityUserRequest>
             <merc:localTransactionId>a10003</merc:localTransactionId>
             <merc:localTransactionId>a10003</merc:localTransactionId>
             <merc:initiator>
             <merc:initiator>
               <vd:login>login</vd:login>
               <vd:login>login</vd:login>
             </merc:initiator>
             </merc:initiator>
             <merc:modificationOperation>
             <vd:user>
              <vd:type>FIND_OR_CREATE</vd:type>
               <vd:login>ivanov_ii_171108</vd:login>
              <vd:resultingList>
             </vd:user>
                <dt:businessEntity>
           </merc:addBusinessEntityUserRequest>
                  <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>3307012700</dt:inn>
                  <dt:ogrn>1000000000263</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, обл.Владимирская, г.Муром, ул.Октябрьской Революции,д.2Б</dt:addressView>
                  </dt:juridicalAddress>
                </dt:businessEntity>
              </vd:resultingList>
               <vd:reason>Причина добавления субъекта в реестр. Например, сведения о контракте с поставщиком или получателем продукции.</vd:reason>
             </merc:modificationOperation>
           </merc:modifyBusinessEntityRequest>
         </apl:data>
         </apl:data>
       </apl:application>
       </apl:application>
Строка 1088: Строка 623:


<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id = "scenario5">Ответ на запрос 1.</div>
<div id = "scenario5">Ответ на запрос</div>
<div class = "mw-collapsible-content">
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<env:Envelope xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2"
<env:Envelope xmlns:bs="http://api.vetrf.ru/schema/cdm/base"  
xmlns:bs="http://api.vetrf.ru/schema/cdm/base"  
xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/g2b/applications/v2"  
xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/g2b/applications/v2"  
xmlns:apldef="http://api.vetrf.ru/schema/cdm/application/ws-definitions"  
xmlns:apldef="http://api.vetrf.ru/schema/cdm/application/ws-definitions"  
xmlns:apl="http://api.vetrf.ru/schema/cdm/application"  
xmlns:apl="http://api.vetrf.ru/schema/cdm/application"  
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2">
   <env:Header/>
   <env:Header/>
   <env:Body>
   <env:Body>
     <apldef:receiveApplicationResultResponse>
     <apldef:receiveApplicationResultResponse>
       <apl:application>
       <apl:application>
         <apl:applicationId>9fc40807-37d9-4cba-8170-5e83dab20c11</apl:applicationId>
         <apl:applicationId>ecd5b39a-7bbf-41c5-adfe-a92259b72584</apl:applicationId>
         <apl:status>COMPLETED</apl:status>
         <apl:status>COMPLETED</apl:status>
         <apl:serviceId>mercury-g2b.service</apl:serviceId>
         <apl:serviceId>mercury-g2b.service</apl:serviceId>
         <apl:issuerId>Id</apl:issuerId>
         <apl:issuerId>Id</apl:issuerId>
         <apl:issueDate>2017-10-15T13:25:17.000+03:00</apl:issueDate>
         <apl:issueDate>2017-11-08T10:32:08.000+03:00</apl:issueDate>
         <apl:rcvDate>2017-10-15T13:25:17.000+03:00</apl:rcvDate>
         <apl:rcvDate>2017-11-08T10:32:07.000+03:00</apl:rcvDate>
         <apl:prdcRsltDate>2017-10-15T13:25:17.000+03:00</apl:prdcRsltDate>
         <apl:prdcRsltDate>2017-11-08T10:32:08.000+03:00</apl:prdcRsltDate>
         <apl:result>
         <apl:result>
           <merc:modifyBusinessEntityResponse>
           <merc:addBusinessEntityUserResponse>
             <merc:businessEntity>
             <vd:user>
               <bs:uuid>da435085-d8d3-4c02-988f-82828f43c55d</bs:uuid>
               <bs:uuid>2732beec-c3f5-4024-892a-1c92fca663f3</bs:uuid>
               <bs:guid>04f35c17-1d26-44c4-8397-69b5936e5fcf</bs:guid>
               <vd:login>ivanov_ii_171108</vd:login>
               <bs:active>true</bs:active>
            </vd:user>
               <bs:last>true</bs:last>
          </merc:addBusinessEntityUserResponse>
               <bs:status>100</bs:status>
        </apl:result>
               <bs:createDate>2014-03-05T14:57:37+04:00</bs:createDate>
      </apl:application>
              <bs:updateDate>2014-03-05T14:57:37+04:00</bs:updateDate>
    </apldef:receiveApplicationResultResponse>
               <dt:type>1</dt:type>
  </env:Body>
               <dt:fullName>ООО "Макаров и компания"</dt:fullName>
</env:Envelope>
               <dt:inn>3307012700</dt:inn>
</syntaxhighlight>
               <dt:juridicalAddress>
</div>
                 <dt:country>
</div>
<br/>
 
===Регистрация списка новых пользователей===
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id = "scenario5">Привязка существующего пользователя к хозяйствующему субъекту</div>
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<SOAP-ENV:Envelope 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>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08</apl:issueDate>
        <apl:data>
          <merc:addBusinessEntityUserRequest>
            <merc:localTransactionId>a10003</merc:localTransactionId>
            <merc:initiator>
              <vd:login>login</vd:login>
            </merc:initiator>
            <vd:user>
               <vd:firstName>Иван</vd:firstName>
               <vd:middleName>Иванович</vd:middleName>
               <vd:lastName>Иванов</vd:lastName>
               <vd:birthDate>1987-01-02</vd:birthDate>
              <vd:identity>
                <vd:issueSeries>1512</vd:issueSeries>
                <vd:issueNumber>061952</vd:issueNumber>
                <vd:type>17</vd:type>
              </vd:identity>
              <vd:citizenship>
                <vd:country>
                  <bs:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</bs:uuid>
                  <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                </vd:country>
              </vd:citizenship>
              <vd:email>1512053061952@yandex.ru</vd:email>
            </vd:user>
            <vd:user>
              <vd:firstName>Петр</vd:firstName>
              <vd:middleName>Петрович</vd:middleName>
               <vd:lastName>Петров</vd:lastName>
               <vd:birthDate>1987-01-02</vd:birthDate>
               <vd:identity>
                <vd:issueSeries>1508</vd:issueSeries>
                <vd:issueNumber>636157</vd:issueNumber>
                <vd:type>17</vd:type>
              </vd:identity>
               <vd:citizenship>
                 <vd:country>
                   <bs:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</bs:uuid>
                   <bs:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</bs:uuid>
                   <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                   <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                  <dt:name>Российская Федерация</dt:name>
                </vd:country>
                </dt:country>
              </vd:citizenship>
                <dt:region>
              <vd:email>1508171636157@yandex.ru</vd:email>
                  <bs:uuid>18489346-08c0-41f4-9a46-b9d1f5a819d9</bs:uuid>
            </vd:user>
                  <bs:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</bs:guid>
          </merc:addBusinessEntityUserRequest>
                  <dt:name>Владимирская область</dt:name>
        </apl:data>
                </dt:region>
      </apl:application>
                <dt:addressView>602254, г. Муром, ул. Привокзальная, д.2</dt:addressView>
    </apldef:submitApplicationRequest>
               </dt:juridicalAddress>
  </SOAP-ENV:Body>
             </merc:businessEntity>
</SOAP-ENV:Envelope>
           </merc:modifyBusinessEntityResponse>
</syntaxhighlight>
</div>
</div>
<br/>
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div id = "scenario5">Ответ на запрос</div>
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<env:Envelope 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:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2">
  <env:Header/>
  <env:Body>
    <apldef:receiveApplicationResultResponse>
      <apl:application>
        <apl:applicationId>ecd5b39a-7bbf-41c5-adfe-a92259b72584</apl:applicationId>
        <apl:status>COMPLETED</apl:status>
        <apl:serviceId>mercury-g2b.service</apl:serviceId>
        <apl:issuerId>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08.000+03:00</apl:issueDate>
        <apl:rcvDate>2017-11-08T10:32:07.000+03:00</apl:rcvDate>
        <apl:prdcRsltDate>2017-11-08T10:32:08.000+03:00</apl:prdcRsltDate>
        <apl:result>
          <merc:addBusinessEntityUserResponse>
            <vd:user>
              <bs:uuid>80b3835a-5669-4f28-b383-ab11bc0a6cc1</bs:uuid>
              <vd:login>ivanov_ii_171108</vd:login>
              <vd:firstName>Иван</vd:firstName>
              <vd:middleName>Иванович</vd:middleName>
              <vd:lastName>Иванов</vd:lastName>
              <vd:birthDate>1987-01-02T00:00:00.000+03:00</vd:birthDate>
              <vd:email>1512053061952@yandex.ru</vd:email>
              <vd:workEmail>1512053061952@yandex.ru</vd:workEmail>
            </vd:user>
            <vd:user>
              <bs:uuid>c207f427-9252-4e84-89d8-fe4532374234</bs:uuid>
              <vd:login>petrov_pp_171108</vd:login>
              <vd:firstName>Петр</vd:firstName>
              <vd:middleName>Петрович</vd:middleName>
              <vd:lastName>Петров</vd:lastName>
              <vd:birthDate>1987-01-02T00:00:00.000+03:00</vd:birthDate>
              <vd:email>1508171636157@yandex.ru</vd:email>
               <vd:workEmail>1508171636157@yandex.ru</vd:workEmail>
             </vd:user>
           </merc:addBusinessEntityUserResponse>
         </apl:result>
         </apl:result>
       </apl:application>
       </apl:application>
Строка 1144: Строка 784:
</div>
</div>
</div>
</div>
<br/>
[[Category:Ветис.API]]

Текущая версия на 12:08, 1 июня 2023

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

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

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

  • информация о пользователе - инициаторе запроса;
  • имя пользователя или уникальный идентификатор, если существующий пользователь привязывается к ХС;
  • данные пользователя (ФИО, паспортные данные, гражданство, адрес электронной почты), если регистрируется новый пользователь;
  • при регистрации нового пользователя опционально могут быть переданы дополнительные данные пользователя (телефон, рабочий телефон, рабочий адрес электронной почты и т.д.), которые будут сохранены в системе "Ветис.Паспорт";
  • при регистрации нового пользователя опционально может быть передан список прав пользователя, но назначены эти права будут после активации созданного пользователя.

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

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



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

1. Регистрация нового пользователя (в запросе не передаются uuid или login).

1.1. В запросе переданы данные уже существующего в системе пользователя:
  • Если в запросе переданы уже существующие в системе паспортные данные, то вернется отказ в выполнении операции.
  • Если в запросе передан уже существующий в системе адрес электронной почты, то вернется отказ в выполнении операции.
1.2. В запросе переданы данные отсутствующего в системе пользователя:
  • Будет создан новый пользователь, все указанные данные будут переданы в систему "Ветис.Паспорт".
  • В ответе будет передано сгенерированное имя пользователя (login).
  • На указанный в запросе email будет отправлено письмо с информацией о регистрации нового пользователя, временным паролем для входа, ссылкой для активации пользователя и смены пароля.
  • Пользователь будет привязан к хозяйствующему субъекту.
1.3. Некорректный запрос.
1.4. Внутренняя ошибка системы.

2. Привязка существующего пользователя к хозяйствующему субъекту (в запросе передаются uuid или login).

2.1. В запросе передан существующий в системе пользователь:
  • Пользователь будет привязан к хозяйствующему субъекту.
2.2. В запросе передан отсутствующий в системе пользователь:
  • Отказ в выполнении операции.
2.3. Некорректный запрос.
2.4. Внутренняя ошибка системы.




Список доступных для назначения ролей

На данный момент доступен для назначения следующий список прав:

ID роли Наименование роли
MERCURY_ACCESS_WEB_READ Доступ к веб-интерфейсу ИС Меркурий только на чтение
MERCURY_ACCESS_WEB_WRITE Доступ к веб-интерфейсу ИС Меркурий на выполнение операций
ARGUS_HS_AUTHORIZED_APPLICANT Авторизованный заявитель в системе Аргус
MERCURY_ACCESS_API_READ Доступ к ИС Меркурий через Ветис.API только на чтение
MERCURY_CONTROL_WORKING_AREA Управление зонами ответственности пользователей
MERCURY_ACCESS_API_WRITE Доступ к ИС Меркурий через Ветис.API на выполнение операций
MERCURY_CERTIFICATE_ACCEPTANCE Гашение ВСД
MERCURY_AUTHORIZED_CERTIFICATE_ACCEPTANCE Уполномоченное гашение ВСД
MERCURY_AUTHORIZED_RETURNED_CERTIFICATE_CREATION Уполномоченное оформление возвратных ВСД
MERCURY_HS_FISH_CERTIFICATE Сертификация уловов ВБР
MERCURY_PRODUCTION_BATCH_CERTIFICATE Оформление ВСД на производственную партию
MERCURY_HS_AUTHORIZED_APPLICANT Авторизованный заявитель в системе Меркурий
MERCURY_RETURNED_CERTIFICATE_CREATION Оформление возвратных ВСД
MERCURY_HS_AUTHORIZED_646 Уполномоченное лицо (Оформление ВСД на продукцию из Приказа МСХ РФ № 646)
MERCURY_HS_FRESH_MILK_CERTIFICATE Оформление ВСД на сырое молоко (при наличии справки о безопасности сырого молока)
MERCURY_CREATE_INVENTORY_ACT Создание акта инвентаризации
MERCURY_CREATE_COLLATION_ACT Создание акта сверки
MERCURY_CREATE_DECOMMISSION_ACT Создание акта списания

Список доступных ролей также можно получить с помощью операции - getApplicableUserAuthorityList.

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




Спецификация запроса

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:addBusinessEntityUserRequest>
002 ···<merc:localTransactionId>А0001</merc:localTransactionId> xs:NCName [1..1] Идентификатор заявки в клиентской системе.
003 ···<merc:initiator> vd:User [1..1]

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

  • Является ответственным за выполнение бизнес-операции.
  • Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
004 ······<vd:login>user_ab_150101</vd:login> xs:NCName [1..1] Логин пользователя, зарегистрированного в системе Меркурий.
005 ···</merc:initiator>
006 ···<vd:user> vd:User [1..*]

Описание пользователя системы.

  • Если регистриуется новый пользователь, то uuid и login не указываются.
  • Если существующий пользователь привязывается к ХС, то указывается uuid или login. Остальные поля в случае указания будут проигнорированы.
007 ······<bs:uuid>UUID</bs:uuid> bs:UUID [0..1] Уникальный идентификатор пользователя
008 ······<vd:login>ivanov_ii_171105</vd:login> xs:NCName [0..1] Логин пользователя
009 ······<vd:firstName>Иван</vd:firstName> bs:String255 [0..1] Имя
  • Обязательно к указнию только при регистрации нового пользователя
010 ······<vd:middleName>Иванович</vd:middleName> bs:String255 [0..1] Отчество
  • Обязательно к указанию только при регистрации нового пользователя
011 ······<vd:lastName>Иванов</vd:lastName> bs:String255 [0..1] Фамилия
  • Обязательно к указанию только при регистрации нового пользователя
012 ······<vd:birthDate>1987-01-02</vd:birthDate> xs:date [0..1] Дата рождения
  • Обязательно к указанию только при регистрации нового пользователя
013 ······<vd:identity> vd:Document [0..1] Документ, удостоверяющий личность
  • Обязательно к указанию только при регистрации нового пользователя
014 ·········<vd:issueSeries>1511</vd:issueSeries> bs:String255 [1..1] Серия документа
015 ·········<vd:issueNumber>241708</vd:issueNumber> bs:String255 [1..1] Номер документа
016 ·········<vd:type>17</vd:type> dt:DocumentType [1..1] Тип документа
  • Возможные значения: 17, 18, 19, 20, 21, 22
017 ······</vd:identity>
018 ······<vd:citizenship> vd:Citizenship [0..1] Гражданство пользователя
  • Обязательно к указанию только при регистрации нового пользователя
019 ·········<vd:country> dt:Country [1..1]

Страна

  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
020 ············<bs:uuid>UUID</bs:uuid> bs:UUID [0..1] Уникальный идентификатор страны в соответствии со справочником РСХН.
021 ············<bs:guid>GUID</bs:guid> bs:UUID [0..1] Глобальный идентификатор страны в соответствии со справочником РСХН.
022 ·········</vd:country>
023 ······</vd:citizenship>
024 ······<vd:snils>123-123-123 12</vd:snils> vd:SNILSType [0..1] СНИЛС (опционально)
  • Может быть указано только при регистрации нового пользователя
025 ······<vd:phone>23-23-23</vd:phone> bs:String255 [0..1] Телефон пользователя (опционально)
  • Может быть указано только при регистрации нового пользователя
026 ······<vd:email>1511440241708@yandex.ru</vd:email> bs:String255 [0..1] Адрес электронной почты пользователя
  • Обязательно к указанию только при регистрации нового пользователя
027 ······<vd:workEmail>34833784001f@yandex.ru</vd:workEmail> bs:String255 [0..1] Рабочий адрес электронной почты пользователя (опционально)
  • Может быть указано только при регистрации нового пользователя
028 ······<vd:post>Должность</vd:post> bs:String255 [0..1] Должность пользователя (опционально)
  • Может быть указано только при регистрации нового пользователя
029 ······<vd:authorityList> vd:AuthorityList [0..1] Список ролей пользователя (опционально)
  • Может быть указано только при регистрации нового пользователя
030 ·········<vd:authority> vd:UserAuthority [1..*] Роль пользователя
031 ············<vd:ID>MERCURY_AUTHORIZED_APPLICANT</vd:ID> xs:NCName [1..1] Идентификатор роли пользователя
032 ·········</vd:authority>
033 ······</vd:authorityList>
034 ···</vd:user>
035 </merc:addBusinessEntityUserRequest>

Спецификация ответа

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:addBusinessEntityUserResponse>
002 ···<vd:user> vd:User [1..*] Описание пользователя системы
003 ······<bs:uuid>UUID</bs:uuid> bs:UUID [1..1] Уникальный идентификатор пользователя
004 ······<vd:login>ivanov_ii_171105</vd:login> xs:NCName [1..1] Логин пользователя
005 ······<vd:firstName>Иван</vd:firstName> bs:String255 [1..1] Имя
006 ······<vd:middleName>Иванович</vd:middleName> bs:String255 [0..1] Отчество
007 ······<vd:lastName>Иванов</vd:lastName> bs:String255 [1..1] Фамилия
008 ······<vd:workEmail>mail@mail.ru</vd:workEmail> bs:String255 [0..1] Рабочий адрес электронной почты пользователя
009 ······<vd:post>Должность</vd:post> bs:String255 [0..1] Должность пользователя
010 ······<vd:authorityList> vd:AuthorityList [0..1] Список ролей пользователя
011 ·········<vd:authority> vd:UserAuthority [1..*] Роль пользователя
012 ············<vd:ID>MERCURY_AUTHORIZED_APPLICANT</vd:ID> xs:NCName [1..1] Идентификатор роли пользователя
013 ············<vd:name>Авторизованный заявитель в системе Меркурий</vd:name> bs:String255 [1..1] Описание роли пользователя
014 ·········</vd:authority>
015 ······</vd:authorityList>
016 ···</vd:user>
017 </merc:addBusinessEntityUserResponse>

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

Регистрация нового пользователя

Регистрация нового пользователя
<SOAP-ENV:Envelope 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>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08</apl:issueDate>
        <apl:data>
          <merc:addBusinessEntityUserRequest>
            <merc:localTransactionId>a10003</merc:localTransactionId>
            <merc:initiator>
              <vd:login>login</vd:login>
            </merc:initiator>
            <vd:user>
              <vd:firstName>Иван</vd:firstName>
              <vd:middleName>Иванович</vd:middleName>
              <vd:lastName>Иванов</vd:lastName>
              <vd:birthDate>1987-01-02</vd:birthDate>
              <vd:identity>
                <vd:issueSeries>1508</vd:issueSeries>
                <vd:issueNumber>436542</vd:issueNumber>
                <vd:type>17</vd:type>
              </vd:identity>
              <vd:citizenship>
                <vd:country>
                  <bs:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</bs:uuid>
                  <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                </vd:country>
              </vd:citizenship>
              <vd:email>1508871436542@yandex.ru</vd:email>
            </vd:user>
          </merc:addBusinessEntityUserRequest>
        </apl:data>
      </apl:application>
    </apldef:submitApplicationRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


Ответ на запрос
<env:Envelope 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:env="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2">
  <env:Header/>
  <env:Body>
    <apldef:receiveApplicationResultResponse>
      <apl:application>
        <apl:applicationId>ecd5b39a-7bbf-41c5-adfe-a92259b72584</apl:applicationId>
        <apl:status>COMPLETED</apl:status>
        <apl:serviceId>mercury-g2b.service</apl:serviceId>
        <apl:issuerId>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08.000+03:00</apl:issueDate>
        <apl:rcvDate>2017-11-08T10:32:07.000+03:00</apl:rcvDate>
        <apl:prdcRsltDate>2017-11-08T10:32:08.000+03:00</apl:prdcRsltDate>
        <apl:result>
          <merc:addBusinessEntityUserResponse>
            <vd:user>
              <bs:uuid>6c2eb90a-b717-4075-8093-32d59b684452</bs:uuid>
              <vd:login>ivanov_ii_171108</vd:login>
              <vd:firstName>Иван</vd:firstName>
              <vd:middleName>Иванович</vd:middleName>
              <vd:lastName>Иванов</vd:lastName>
              <vd:birthDate>1987-01-02T00:00:00.000+03:00</vd:birthDate>
              <vd:email>1508871436542@yandex.ru</vd:email>
            </vd:user>
          </merc:addBusinessEntityUserResponse>
        </apl:result>
      </apl:application>
    </apldef:receiveApplicationResultResponse>
  </env:Body>
</env:Envelope>


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

Привязка существующего пользователя к хозяйствующему субъекту
<SOAP-ENV:Envelope 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>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08</apl:issueDate>
        <apl:data>
          <merc:addBusinessEntityUserRequest>
            <merc:localTransactionId>a10003</merc:localTransactionId>
            <merc:initiator>
              <vd:login>login</vd:login>
            </merc:initiator>
            <vd:user>
              <vd:login>ivanov_ii_171108</vd:login>
            </vd:user>
          </merc:addBusinessEntityUserRequest>
        </apl:data>
      </apl:application>
    </apldef:submitApplicationRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


Ответ на запрос
<env:Envelope 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:env="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2">
  <env:Header/>
  <env:Body>
    <apldef:receiveApplicationResultResponse>
      <apl:application>
        <apl:applicationId>ecd5b39a-7bbf-41c5-adfe-a92259b72584</apl:applicationId>
        <apl:status>COMPLETED</apl:status>
        <apl:serviceId>mercury-g2b.service</apl:serviceId>
        <apl:issuerId>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08.000+03:00</apl:issueDate>
        <apl:rcvDate>2017-11-08T10:32:07.000+03:00</apl:rcvDate>
        <apl:prdcRsltDate>2017-11-08T10:32:08.000+03:00</apl:prdcRsltDate>
        <apl:result>
          <merc:addBusinessEntityUserResponse>
            <vd:user>
              <bs:uuid>2732beec-c3f5-4024-892a-1c92fca663f3</bs:uuid>
              <vd:login>ivanov_ii_171108</vd:login>
            </vd:user>
          </merc:addBusinessEntityUserResponse>
        </apl:result>
      </apl:application>
    </apldef:receiveApplicationResultResponse>
  </env:Body>
</env:Envelope>


Регистрация списка новых пользователей

Привязка существующего пользователя к хозяйствующему субъекту
<SOAP-ENV:Envelope 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>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08</apl:issueDate>
        <apl:data>
          <merc:addBusinessEntityUserRequest>
            <merc:localTransactionId>a10003</merc:localTransactionId>
            <merc:initiator>
              <vd:login>login</vd:login>
            </merc:initiator>
            <vd:user>
              <vd:firstName>Иван</vd:firstName>
              <vd:middleName>Иванович</vd:middleName>
              <vd:lastName>Иванов</vd:lastName>
              <vd:birthDate>1987-01-02</vd:birthDate>
              <vd:identity>
                <vd:issueSeries>1512</vd:issueSeries>
                <vd:issueNumber>061952</vd:issueNumber>
                <vd:type>17</vd:type>
              </vd:identity>
              <vd:citizenship>
                <vd:country>
                  <bs:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</bs:uuid>
                  <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                </vd:country>
              </vd:citizenship>
              <vd:email>1512053061952@yandex.ru</vd:email>
            </vd:user>
            <vd:user>
              <vd:firstName>Петр</vd:firstName>
              <vd:middleName>Петрович</vd:middleName>
              <vd:lastName>Петров</vd:lastName>
              <vd:birthDate>1987-01-02</vd:birthDate>
              <vd:identity>
                <vd:issueSeries>1508</vd:issueSeries>
                <vd:issueNumber>636157</vd:issueNumber>
                <vd:type>17</vd:type>
              </vd:identity>
              <vd:citizenship>
                <vd:country>
                  <bs:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</bs:uuid>
                  <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                </vd:country>
              </vd:citizenship>
              <vd:email>1508171636157@yandex.ru</vd:email>
            </vd:user>
          </merc:addBusinessEntityUserRequest>
        </apl:data>
      </apl:application>
    </apldef:submitApplicationRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


Ответ на запрос
<env:Envelope 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:env="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2">
  <env:Header/>
  <env:Body>
    <apldef:receiveApplicationResultResponse>
      <apl:application>
        <apl:applicationId>ecd5b39a-7bbf-41c5-adfe-a92259b72584</apl:applicationId>
        <apl:status>COMPLETED</apl:status>
        <apl:serviceId>mercury-g2b.service</apl:serviceId>
        <apl:issuerId>Id</apl:issuerId>
        <apl:issueDate>2017-11-08T10:32:08.000+03:00</apl:issueDate>
        <apl:rcvDate>2017-11-08T10:32:07.000+03:00</apl:rcvDate>
        <apl:prdcRsltDate>2017-11-08T10:32:08.000+03:00</apl:prdcRsltDate>
        <apl:result>
          <merc:addBusinessEntityUserResponse>
            <vd:user>
              <bs:uuid>80b3835a-5669-4f28-b383-ab11bc0a6cc1</bs:uuid>
              <vd:login>ivanov_ii_171108</vd:login>
              <vd:firstName>Иван</vd:firstName>
              <vd:middleName>Иванович</vd:middleName>
              <vd:lastName>Иванов</vd:lastName>
              <vd:birthDate>1987-01-02T00:00:00.000+03:00</vd:birthDate>
              <vd:email>1512053061952@yandex.ru</vd:email>
              <vd:workEmail>1512053061952@yandex.ru</vd:workEmail>
            </vd:user>
            <vd:user>
              <bs:uuid>c207f427-9252-4e84-89d8-fe4532374234</bs:uuid>
              <vd:login>petrov_pp_171108</vd:login>
              <vd:firstName>Петр</vd:firstName>
              <vd:middleName>Петрович</vd:middleName>
              <vd:lastName>Петров</vd:lastName>
              <vd:birthDate>1987-01-02T00:00:00.000+03:00</vd:birthDate>
              <vd:email>1508171636157@yandex.ru</vd:email>
              <vd:workEmail>1508171636157@yandex.ru</vd:workEmail>
            </vd:user>
          </merc:addBusinessEntityUserResponse>
        </apl:result>
      </apl:application>
    </apldef:receiveApplicationResultResponse>
  </env:Body>
</env:Envelope>