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

Версия 22:18, 15 июля 2017

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1.1. В реестр можно внести три типа хозяйствующих субъектов:

юридическое лицо;
физическое лицо;
индивидуального предпринимателя.

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

1.3. Некорректный запрос.

1.4. Внутренняя ошибка системы.

2. Изменение данных хозяйствующего субъекта.

2.1. Запрос успешно обработан. Данные хозяйствующего субъекта изменены.

2.2. Произошла ошибка при обработке запроса.

• Некорректный запрос.

• Внутренняя ошибка системы.

3. Поиск хозяйствующего субъекта по ИНН и ОГРН. Пользователь передает сведения о хозяйствующем субъекте и в реестре осуществляется поиск по этим данным. В случае, если запрашиваемый хозяйствующий субъект уже существует, то пользователю возвращается информация об этом хозяйствующем субъекте. Если хозяйствующего субъекта с указанными данными нет в реестре, то в реестр добавляется соответствующая запись.

3.1. Запрос успешно обработан. Данные хозяйствующего субъекта изменены.

3.2. Произошла ошибка при обработке запроса.

• Некорректный запрос.

• Внутренняя ошибка системы.

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

enterprise (http://api.vetrf.ru/schema/cdm/cerberus/enterprise)

bs (http://api.vetrf.ru/schema/cdm/base)
argc(http://api.vetrf.ru/schema/cdm/argus/common)
- argc:User

xs(http://www.w3.org/2001/XMLSchema)
ikar (http://api.vetrf.ru/schema/cdm/ikar)
- ikar:Country
- ikar:Region

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

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

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

Создание юридического лица от имени хозяйствующего субъекта

Создание физического лица

Создание индивидуального предпринимателя

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

Поиск хозяйствующего субъекта (на примере ИП). Если хозяйствующий субъект с таким ОГРН уже существует, то вернётся не ошибка, а данные этого хозяйствующего субъекта. Если хозяйствующего субъекта с таким ОГРН нет, то в реестр будет добавлена новая запись

Коды ошибок

Вернуться к началу ↑

@@ Строка 1: / Строка 1: @@
 ==Общие сведения==
-Операция '''ModifyBusinessEntityOperation''' предназначена для регистрации новых хозяйствующих субъектов в реестре, а так же  для изменения информации об уже зарегистрированных.
+Операция '''ModifyBusinessEntityOperation''' предназначена для регистрации новых хозяйствующих субъектов в реестре, а так же для изменения информации об уже зарегистрированных.
 Хозяйствующий субъект может быть трех типов:
 * юридическое лицо;
@@ Строка 15: / Строка 15: @@
 В рамках операции '''ModifyBusinessEntityOperation''' доступны следующие действия:
-* регистрация нового хозяйствующего субъекта.
+* создание нового хозяйствующего субъекта;
-* редактирование сведений о площадке.
+* поиск существующей или добавление новой записи о хозяйствующем субъекте в реестр;
+* редактирование сведений о хозяйствующем субъекте.
 При выполнении операции '''ModifyBusinessEntityOperation''' на вход системы передаются следующие сведения:
@@ Строка 23: / Строка 24: @@
 * информация о хозяйствующем субъекте (организационно-правовая форма, ИНН, ОГРН, КПП  и другие данные, характеризующие организацию или физическое лицо).
-Результатом выполнения данной операции является добавление записи о новом хозяйствующем субъекте в реестре или внесение изменений в существующую запись.
+Результатом выполнения данной операции в зависимости от типа операции является:
+* добавление записи о новом хозяйствующем субъекте в реестре;
+* внесение изменений в существующую запись.
 ===Возможные сценарии===
@@ Строка 33: / Строка 36: @@
 ::* <div id="entrepreneur">[[#scenario3|индивидуального предпринимателя]]. </div>
 :1.2. Ошибка обработки запроса, в случае, если хозяйствующих субъект с указанными данными уже существует.
+:1.3. Некорректный запрос.
+:1.4. Внутренняя ошибка системы.
 <div id="changeData">2. [[#scenario4|Изменение данных хозяйствующего субъекта]].</div>
+:2.1. Запрос успешно обработан. Данные хозяйствующего субъекта изменены.<br />
+:2.2. Произошла ошибка при обработке запроса.
+:: • Некорректный запрос.
+:: • Внутренняя ошибка системы.
 <div id="search">3. [[#scenario5|Поиск хозяйствующего субъекта по ИНН и ОГРН]]. Пользователь передает сведения о хозяйствующем субъекте и в реестре осуществляется поиск по этим данным. В случае, если запрашиваемый хозяйствующий субъект уже существует, то пользователю возвращается информация об этом хозяйствующем субъекте. Если хозяйствующего субъекта с указанными данными нет в реестре, то в реестр добавляется соответствующая запись.</div>
+:3.1. Запрос успешно обработан. Данные хозяйствующего субъекта изменены.<br />
+:3.2. Произошла ошибка при обработке запроса.
+:: • Некорректный запрос.
+:: • Внутренняя ошибка системы.
 ===Используемые пространства имён и типы===
@@ Строка 73: / Строка 86: @@
 ==Данные ответа==
 ==Примеры запросов==
 <div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
-<div id="scenario1">[[#createEnterprise|Создание нового поднадзорного объекта (площадки)]]</div>
+<div id = "scenario1">[[#legalEntity|Создание юридического лица]] от имени хозяйствующего субъекта</div>
+<div class = "mw-collapsible-content">
+<syntaxhighlight lang="xml">
+</syntaxhighlight>
+</div>
+</div><br />
+<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
+<div id = "scenario2">[[#physicalPerson|Создание физического лица]] </div>
+<div class = "mw-collapsible-content">
+<syntaxhighlight lang="xml">
+</syntaxhighlight>
+</div>
+</div> <br />
+<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
+<div id = "scenario3">[[#entrepreneur|Создание индивидуального предпринимателя]]</div>
 <div class = "mw-collapsible-content">
 <syntaxhighlight lang="xml">
@@ Строка 81: / Строка 112: @@
 </syntaxhighlight>
 </div>
-</div><br>
+</div> <br />
 <div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
-<div id="scenario2">[[#updateEnterprise|Редактирование данных поднадзорного объекта (площадки)]]</div>
+<div id = "scenario4">[[#changeData|Редактирование данных хозяйствующего субъекта (на примере индивидуального предпринимателя)]]</div>
 <div class = "mw-collapsible-content">
 <syntaxhighlight lang="xml">
@@ Строка 90: / Строка 121: @@
 </syntaxhighlight>
 </div>
-</div><br>
+</div><br />
+<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
+<div id = "scenario5">[[#search|Поиск хозяйствующего субъекта (на примере ИП)]]. Если хозяйствующий субъект с таким ОГРН уже существует, то вернётся не ошибка, а данные этого хозяйствующего субъекта. Если хозяйствующего субъекта с таким ОГРН нет, то в реестр будет добавлена новая запись</div>
+<div class = "mw-collapsible-content">
+<syntaxhighlight lang="xml">
+</syntaxhighlight>
+</div>
+</div>
 ==Коды ошибок==
 [[#top|Вернуться к началу &uarr;]]
 [[Category:Ветис.API]]