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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(Содержимое страницы заменено на «==1 == as»)
Строка 1: Строка 1:
== Общие сведения ==
==1 ==
Операция '''ModifyBusinessEntityOperation''' предназначена для регистрации новых хозяйствующих субъектов в реестре, а так же для изменения информации об уже зарегистрированных.
as
Хозяйствующий субъект может быть трех типов:
* юридическое лицо;
* индивидуальный предприниматель/КФХ;
* физическое лицо.
 
Реестр хозяйствующих субъектов ведется с применением версионирования, это означает, что запись об одном лице может иметь несколько версий. При каждом изменении записи реестра создается новая версия этой записи. То есть при регистрации нового хозяйствующего субъекта создаётся новая запись, а если информация о хозяйствующем субъекте изменяется, то в реестр вносится ещё одна версия записи.
 
Идентификация  каждой  записи  производится  по следующим полям:
* GUID - глобальный идентификатор записи. Данный идентификатор остается неизменным для всех версий записи о хозяйствующем субъекте.
* UUID - идентификатор версии записи. Данный идентификатор изменяется для каждой новой версии записи о хозяйствующем субъекте.
При создании каждой новой версии записи о хозяйствующем субъекте, старая версия записи становится неактивной и должна ссылаться на новую версию, а новая — на старую. Таким образом, возможно восстановить историю изменений.
Для одной записи журнала может существовать только одна актуальная версия.
 
В рамках операции '''ModifyBusinessEntityOperation''' доступны следующие действия:
* создание нового хозяйствующего субъекта;
* поиск существующей или добавление новой записи о хозяйствующем субъекте в реестр;
* редактирование сведений о хозяйствующем субъекте.
 
При выполнении операции '''ModifyBusinessEntityOperation''' на вход системы передаются следующие сведения:
* информация о пользователе - инициаторе запроса;
* тип операции (добавление, поиск или изменение);
* информация о хозяйствующем субъекте (организационно-правовая форма, ИНН, ОГРН, КПП  и другие данные, характеризующие организацию или физическое лицо).
 
Результатом выполнения данной операции в зависимости от типа операции является:
* добавление записи о новом хозяйствующем субъекте в реестре;
* внесение изменений в существующую запись.
 
===Возможные сценарии===
При выполнении операции возможны следующие сценарии:<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/base|bs]] (<nowiki>http://api.vetrf.ru/schema/cdm/base</nowiki>)
** [[RegisterModificationType_v2.0|bs:RegisterModificationType]]
** [[String255|bs:String255]]
** [[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>)
** [[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]]
** [[IncorporationForm_v2.0|dt:IncorporationForm]]
** [[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>)
** [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
** [http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
** [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
 
{{столбцы/конец}}

Версия 14:36, 8 ноября 2017

1

as