ModifyActivityLocationsOperation
Общие сведения
В системе Меркурий ведется учет участников хозяйственной деятельности - хозяйствующих субъектов:
- юридических лиц;
- физических лиц;
- индивидуальных предпринимателей.
У хозяйствующих субъектов есть места осуществления данной деятельности - площадки. Площадкой может быть сооружение, здание, или участок местности (например, охотохозяйство). Хозяйствующий субъект связан с площадкой так называемым "отношением": хозяйствующий субъект может владеть объектом, либо использовать его, например, на правах аренды. Так же у одного хозяйствующего субъекта может быть несколько используемых площадок, либо несколько объектов, которые находятся в его владении. Операция ModifyActivityLocationsOperation позволяет устанавливать такое "отношение", создавая связь между площадкой и хозяйствующим субъектом. Так же данная операция предназначена и для удаления связи, если хозяйствующих субъект более не использует площадку. После создания связи хозяйствующий субъект может использовать данную площадку в системе Меркурий.
При выполнении операции ModifyActivityLocationsOperation на вход системы передаются следующие сведения:
- информация о пользователе - инициаторе запроса;
- тип операции (добавление или удаление связи);
- информация о хозяйствующем субъекте и месте осуществления деятельности - площадке с которой необходимо создать/удалить связь.
Результатом выполнения операции является создание связи между хозяйствующим субъектом и площадкой или удаление этой связи.
Возможные сценарии
- 1.1. Запрос успешно обработан. Связь между площадкой и хозяйствующем субъектом создана.
- 1.2. Произошла ошибка при обработке запроса.
- • Некорректный запрос.
- • Внутренняя ошибка системы.
- 2.1. Запрос успешно обработан. Связь между площадкой и хозяйствующем субъектом удалена.
- 2.2. Произошла ошибка при обработке запроса.
- • Некорректный запрос.
- • Внутренняя ошибка системы.
Пространства имён и типы
|
Общие отличия между версией для хозяйствующих субъектов и ветеринарных управлений
Различающиеся параметры | Версия для хозяйствующих субъектов | Версия для ветеринарных управлений |
---|---|---|
Пространство имён | merc:http://api.vetrf.ru/schema/cdm/mercury/applications | mercvu:http://api.vetrf.ru/schema/cdm/mercury/vu/applications |
Имя сервиса | mercury-g2b.service | mercury-vu.service |
Данные запроса
Объект modifyActivityLocationsRequest
Корневой элемент содержимого заявки. Содержит сведения для создания/удаления связи между площадкой и хозяйствующим субъектом.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
localTransationId | Идентификатор транзакции в клиентской системе. | xs:NCName | 1 |
initiator | Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин пользователя в системе Меркурий. | argc:User | 1 |
modificationOperation | Описание операции создания/удаления связи между площадкой и хозяйствующим субъектом. | ent:BEActivityLocationsModificationOperation | 1 |
Объект ..Request/initiator
Содержит сведения о пользователе, зарегистрированном в системе Меркурий и инициирующим запрос к шлюзу.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
UUID | Идентификатор пользователя, зарегистрированного в системе Меркурий. | bs:UUID | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо login. При указании обоих полей, приоритет у UUID. |
login | Логин пользователя. | xs:NCName |
Объект ..Request/modificationOperation
Объект содержит общие сведения о выполняемой операции: тип операции, информацию о поднадзорном объекте и хозяйствующем субъекте.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
type | Тип операции:
|
bs:RegisterModificationType | 1 |
businessEntity | Информация о хозяйствующем субъекте. | ent:BusinessEntity | 1 |
enterpriseList | Элемент содержит сведения о списке поднадзорных объектов.
|
ent:EnterpriseList | 1 |
Объект ..Request/modificationOperation/businessEntity
Объект содержит сведения о хозяйствующем субъекте.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
UUID | Идентификатор версии хозяйствующего субъекта - владельца продукции. | bs:UUID | 1 |
GUID | Глобальный идентификатор хозяйствующего субъекта - владельца продукции. | bs:UUID | 1 |
Объект ..Request/modificationOperation/enterpriseList
Объект содержит сведения о списке поднадзорных объектов.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
enterprise | Информация о площадке с которой создается/удаляется связь. | ent:Enterprise | 1 |
Объект ..Request/modificationOperation/enterpriseList/enterprise
Объект содержит сведения о поднадзорном объекте.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
UUID | Идентификатор версии предприятия. | bs:UUID | 1 |
GUID | Глобальный идентификатор предприятия. | bs:UUID | 1 |
Данные ответа
Объект modifyActivityLocationsResponse
Объект содержит информацию о хозяйствующем субъекте и площадке, над которыми была выполнена операция.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
businessEntity | Информация о хозяйствующем субъекте и месте осуществления его деятельности (площадке). | ent:BusinessEntity | 1 |
Объект ..Response/businessEntity
Объект содержит информацию о хозяйствующем субъекте и месте осуществления его деятельности (площадке).
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
UUID | Уникальный идентификатор хозяйствующего субъекта в реестре. | bs:UUID | 1 |
GUID | Глобальный идентификатор хозяйствующего субъекта в реестре. | bs:UUID | 1 |
active | Является ли запись активной:
|
xs:boolean | 1 |
last | Является ли запись о хозяйствующем субъекте последней:
|
xs:boolean | 1 |
status | Текущий статус версии записи реестра хозяйствующих субъектов.
|
bs:VersionStatus | 1 |
createDate | Дата создания текущей записи в реестре. | xs:dateTime | 1 |
updateDate | Дата обновления текущей записи реестра. | xs:dateTime | 1 |
previous | Идентификатор предыдущий версии записи реестра хозяйствующих субъектов. | bs:UUID | 0..1 |
next | Идентификатор следующей версии записи реестра хозяйствующих субъектов. | bs:UUID | 0..1 |
type | Тип хозяйствующего субъекта:
|
ent:BusinessEntityType | 1 |
name | Наименование хозяйствующего субъекта без указания организационно-правовой формы.
|
bs:String255 | 0..1 |
incorporationForm | Организационно-правовая форма хозяйствующего субъекта. Название указывается согласно общероссийскому классификатору организационно-правовых форм (ОКОПФ). Идентификатор организационно-правовой формы состоит из пяти знаков и вводится без пробелов.
|
ent:IncorporationForm | 0..1 |
fullName | Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
|
bs:String255 | 0..1 |
fio | ФИО физического лица или индивидуального предпринимателя.
|
bs:String255 | 0..1 |
inn | ИНН хозяйствующего субъекта.
|
bs:String255 | 0..1 |
ogrn | ОГРН или ОГРНИП.
|
bs:String255 | 0..1 |
juridicalAddress | Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект.
|
ikar:Address | 1 |
activityLocation | Место осуществления деятельности.
|
ent:ActivityLocation | 0..1 |
Объект ..Response/businessEntity/incorporationForm
Объект содержит информацию об организационно-правовой форме хозяйствующего субъекта.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
UUID | Идентификатор организационно-правовой формы в справочнике РСХН.
|
bs:UUID | 0..1 |
Объект ..Response/businessEntity/juridicalAddress
Объект описывает поля юридического адреса хозяйствующего субъекта.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
country | Страна, в которой зарегистрирован хозяйствующий субъект. | ikar:Country | 1 |
region | Регион страны, в которой зарегистрирован хозяйствующий субъект. | ikar:Region | 1 |
addressView | Строковое представление адреса. | bs:String255 | 1 |
Объект ..Response/businessEntity/juridicalAddress/country
Объект содержит данные о стране, в которой зарегистрирован хозяйствующий субъект.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
UUID | Уникальный идентификатор страны в соответствии со справочником РСХН. | bs:UUID | 1 |
GUID | Глобальный идентификатор страны в соответствии со справочником РСХН. | bs:UUID | 1 |
Объект ..Response/businessEntity/juridicalAddress/region
Объект содержит данные о регионе страны, где зарегистрирован хозяйствующий субъект.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
UUID | Уникальный идентификатор региона страны в соответствии со справочником РСХН. | bs:UUID | 1 |
GUID | Глобальный идентификатор региона страны в соответствии со справочником РСХН. | bs:UUID | 1 |
Объект ..Response/businessEntity/activityLocation
Объект содержит сведения о месте осуществления деятельности хозяйствующего субъекта.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
enterprise | Информация о поднадзорном объекте (площадке), с которой у хозяйствующего субъекта была создана связь.
|
ent:Enterprise | 0..1 |
Объект ..Response/businessEntity/activityLocation/enterprise
Объект содержит сведения о площадке - месте осуществления деятельности хозяйствующего субъекта.
Поле | Описание | Тип данных | Обязательность |
---|---|---|---|
UUID | Уникальный идентификатор поднадзорного объекта в реестре. | bs:UUID | 1 |
GUID | Глобальный идентификатор поднадзорного объекта в реестре. | bs:UUID | 1 |
Примеры запросов
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions"
xmlns:app="http://api.vetrf.ru/schema/cdm/application"
xmlns:mercvu="http://api.vetrf.ru/schema/cdm/mercury/vu/applications"
xmlns:base="http://api.vetrf.ru/schema/cdm/base"
xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common"
xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar">
<soapenv:Header/>
<soapenv:Body>
<ws:submitApplicationRequest>
<ws:apiKey>apiKey</ws:apiKey>
<app:application>
<app:serviceId>mercury-vu.service</app:serviceId>
<app:issuerId>issuerId</app:issuerId>
<app:issueDate>2015-01-10T17:03:00</app:issueDate>
<app:data>
<mercvu:modifyActivityLocationsRequest>
<mercvu:localTransactionId>a10003</mercvu:localTransactionId>
<mercvu:initiator>
<com:login>user</com:login>
</mercvu:initiator>
<mercvu:modificationOperation>
<ent:type>CREATE</ent:type>
<ent:businessEntity>
<base:guid>54321</base:guid>
</ent:businessEntity>
<ent:enterpriseList count="1" total="1" offset="0">
<ent:enterprise>
<base:guid>6789</base:guid>
</ent:enterprise>
</ent:enterpriseList>
</mercvu:modificationOperation>
</mercvu:modifyActivityLocationsRequest>
</app:data>
</app:application>
</ws:submitApplicationRequest>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions"
xmlns:app="http://api.vetrf.ru/schema/cdm/application"
xmlns:mercvu="http://api.vetrf.ru/schema/cdm/mercury/vu/applications"
xmlns:base="http://api.vetrf.ru/schema/cdm/base"
xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common"
xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar">
<soapenv:Header/>
<soapenv:Body>
<ws:submitApplicationRequest>
<ws:apiKey>apiKey</ws:apiKey>
<app:application>
<app:serviceId>mercury-vu.service</app:serviceId>
<app:issuerId>issuerId</app:issuerId>
<app:issueDate>2015-01-10T17:03:00</app:issueDate>
<app:data>
<mercvu:modifyActivityLocationsRequest>
<mercvu:localTransactionId>a10003</mercvu:localTransactionId>
<mercvu:initiator>
<com:login>user</com:login>
</mercvu:initiator>
<mercvu:modificationOperation>
<ent:type>DELETE</ent:type>
<ent:businessEntity>
<base:guid>54321</base:guid>
</ent:businessEntity>
<ent:enterpriseList count="1" total="1" offset="0">
<ent:enterprise>
<base:guid>6789</base:guid>
</ent:enterprise>
</ent:enterpriseList>
</mercvu:modificationOperation>
</mercvu:modifyActivityLocationsRequest>
</app:data>
</app:application>
</ws:submitApplicationRequest>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions"
xmlns:app="http://api.vetrf.ru/schema/cdm/application"
xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/applications"
xmlns:base="http://api.vetrf.ru/schema/cdm/base"
xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common"
xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar">
<soapenv:Header/>
<soapenv:Body>
<ws:submitApplicationRequest>
<ws:apiKey>apiKey</ws:apiKey>
<app:application>
<app:serviceId>mercury-g2b.service</app:serviceId>
<app:issuerId>issuerId</app:issuerId>
<app:issueDate>2015-01-10T17:03:00</app:issueDate>
<app:data>
<merc:modifyActivityLocationsRequest>
<merc:localTransactionId>a10003</merc:localTransactionId>
<merc:initiator>
<com:login>user</com:login>
</merc:initiator>
<merc:modificationOperation>
<ent:type>CREATE</ent:type>
<ent:businessEntity>
<base:guid>54321</base:guid>
</ent:businessEntity>
<ent:enterpriseList count="1" total="1" offset="0">
<ent:enterprise>
<base:guid>6789</base:guid>
</ent:enterprise>
</ent:enterpriseList>
</merc:modificationOperation>
</merc:modifyActivityLocationsRequest>
</app:data>
</app:application>
</ws:submitApplicationRequest>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions"
xmlns:app="http://api.vetrf.ru/schema/cdm/application"
xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/applications"
xmlns:base="http://api.vetrf.ru/schema/cdm/base"
xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common"
xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar">
<soapenv:Header/>
<soapenv:Body>
<ws:submitApplicationRequest>
<ws:apiKey>apiKey</ws:apiKey>
<app:application>
<app:serviceId>mercury-g2b.service</app:serviceId>
<app:issuerId>issuerId</app:issuerId>
<app:issueDate>2015-01-10T17:03:00</app:issueDate>
<app:data>
<merc:modifyActivityLocationsRequest>
<merc:localTransactionId>a10003</merc:localTransactionId>
<merc:initiator>
<com:login>user</com:login>
</merc:initiator>
<merc:modificationOperation>
<ent:type>DELETE</ent:type>
<ent:businessEntity>
<base:guid>54321</base:guid>
</ent:businessEntity>
<ent:enterpriseList count="1" total="1" offset="0">
<ent:enterprise>
<base:guid>6789</base:guid>
</ent:enterprise>
</ent:enterpriseList>
</merc:modificationOperation>
</merc:modifyActivityLocationsRequest>
</app:data>
</app:application>
</ws:submitApplicationRequest>
</soapenv:Body>
</soapenv:Envelope>
Коды ошибок
Код ошибки | Описание |
---|---|
MERC05001 | Изменить сведения о хозяйствующем субъекте может он сам или хозяйствующий субъект, добавивший его в реестр. |
MERC05002 | В запросе отсутствуют сведения о хозяйствующем субъекте, ответственном за выполнение операции. |
MERC05003 | Отсутствует идентификатор (GUID) хозяйствующего субъекта, ответственного за выполнение операции. |
MERC05004 | В запросе для хозяйствующого субъекта ответственного за выполнение операции указан идентификатор устаревшей версии записи реестра РСХН. |
MERC05005 | Хозяйствующий субъект, ответственный за выполнение операции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату. |
MERC05166 | В запросе отсутствуют сведения о хозяйствующем субъекте. |
MERC05174 | Хозяйствующий субъект с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату. |
MERC05175 | В запросе для хозяйствующего субъекта указан идентификатор устаревшей версии записи реестра РСХН. |
MERC05176 | Идентификатор хозяйствующего субъекта (GUID) обязателен для заполнения. |
MERC05180 | Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату. |
MERC05181 | В запросе для предприятия указан идентификатор устаревшей версии записи реестра РСХН. |
MERC05182 | Идентификатор предприятия (GUID) обязателен для заполнения. |
MERC05360 | Список предприятий не должен быть пустым. |
MERC05361 | Связь с указанным предприятием уже существует. |
MERC06001 | Изменить сведения о хозяйствующем субъекте может он сам или хозяйствующий субъект, добавивший его в реестр |
MERC06002 | В запросе отсутствуют сведения о хозяйствующем субъекте, ответственном за выполнение операции. |
MERC06003 | Отсутствует идентификатор (GUID) хозяйствующего субъекта, ответственного за выполнение операции. |
MERC06004 | В запросе для хозяйствующого субъекта ответственного за выполнение операции указан идентификатор устаревшей версии записи реестра РСХН. |
MERC06005 | Хозяйствующий субъект, ответственный за выполнение операции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату. |
MERC06166 | В запросе отсутствуют сведения о хозяйствующем субъекте. |
MERC06174 | Хозяйствующий субъект с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату. |
MERC06175 | В запросе для хозяйствующего субъекта указан идентификатор устаревшей версии записи реестра РСХН. |
MERC06176 | Идентификатор хозяйствующего субъекта (GUID) обязателен для заполнения. |
MERC06180 | Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату. |
MERC06181 | В запросе для предприятия указан идентификатор устаревшей версии записи реестра РСХН. |
MERC06182 | Идентификатор предприятия (GUID) обязателен для заполнения. |
MERC06360 | Список предприятий не должен быть пустым. |
MERC06362 | Связь с указанным предприятием отсутствует. |