MercuryG2B:ModifyBusinessEntity:v3.0

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

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

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

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<merc:modifyBusinessEntityRequest>
002	···<merc:localTransactionId>?</merc:localTransactionId>	xs:NCName	[1..1]	Идентификатор заявки в клиентской системе
003	···<merc:initiator>	vd:User	[1..1]	Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу Является ответственным за выполнение бизнес-операции Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт
004	······<vd:login>?</vd:login>	xs:NCName	[1..1]	Логин пользователя, зарегистрированного в системе Меркурий
005	···</merc:initiator>
006	···<merc:modificationOperation>	vd:BEModificationOperation	[1..1]	Описание операции добавления/изменения информации о хозяйствующем субъекте
007	······<vd:type>?</vd:type>	bs:RegisterModificationType	[1..1]	Тип операции. CREATE - добавление новой записи в реестр; FIND_OR_CREATE - поиск существующей или добавление новой записи в реестр UPDATE - внесение изменений в существующую запись. Хозяйствующий субъект может вносить изменения в свои данные, а так же в сведения о хозяйствующих субъектах, которые были добавлены им. Изменение записи невозможно после синхронизации данных с сервером ФНС
008	······<dt:resultingList>	dt:BusinessEntityList	[1..1]	Список, который содержит сведения о добавляемых хозяйствующих субъектах На данный момент поддерживается добавление только одного субъекта в рамках одной заявки
009	·········<dt:businessEntity>	dt:BusinessEntity	[1..1]	Данные о хозяйствующем субъекте
010	············<bs:uuid>?</bs:uuid>	bs:UUID	[0..1]	Идентификатор версии хозяйствующего субъекта
011	············<bs:guid>?</bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор хозяйствующего субъекта
012	············<dt:type>?</dt:type>	dt:BusinessEntityType	[1..1]	Тип создаваемого или редактируемого хозяйствующего субъекта 1 - юридическое лицо 2 - физическое лицо 3 - индивидуальный предприниматель
013	············<dt:name>?</dt:name>	bs:String255	[0..1]	Наименование хозяйствующего субъекта без указания организационно-правовой формы Указывается только для юридических лиц Для физических лиц и для индивидуальных предпринимателей поле не указывается
014	············<dt:incorporationForm>	dt:IncorporationForm	[0..1]	Организационно-правовая форма хозяйствующего субъекта Обязательно к указанию uuid или code ОПФ
015	···············<bs:uuid>?</bs:uuid>	bs:UUID	[0..1]	Идентификатор версии организационно-правовой формы
016	···············<dt:name>?</dt:name>	bs:String255	[0..1]	Название организационно-правовой формы предприятия согласно справочнику ОКОПФ
017	···············<dt:code>?</dt:code>	bs:String255	[0..1]	Код организационно-правовой формы предприятия согласно справочнику ОКОПФ
018	···············<dt:shortName>?</dt:shortName>	bs:String255	[0..1]	Краткое название организационно-правовой формы предприятия
019	············</dt:incorporationForm>
020	············<dt:fullName>?</dt:fullName>	bs:String255	[0..1]	Полное наименование хозяйствующего субъекта с указанием ОПФ
021	············<dt:fio>?</dt:fio>	bs:String255	[0..1]	ФИО физического лица или индивидуального предпринимателя Для юридических лиц поле не указывается
022	············<dt:inn>?</dt:inn>	bs:String255	[1..1]	ИНН хозяйствующего субъекта
023	············<dt:kpp>?</dt:kpp>	bs:String255	[0..1]	Код причины постановки на учет (КПП)
024	············<dt:ogrn>?</dt:ogrn>	bs:String255	[0..1]	ОГРН или ОГРНИП Для ИП ОГРНИП может быть не указано
025	············<dt:juridicalAddress>	dt:Address	[1..1]	Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект
026	···············<dt:country>	dt:Country	[1..1]	Страна Достаточно указать один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid
027	··················<bs:uuid>?</bs:uuid>	bs:UUID	[0..1]	Уникальный идентификатор страны в соответствии со справочником РСХН
028	··················<bs:guid>?</bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор страны в соответствии со справочником РСХН
029	···············</dt:country>
030	···············<dt:region>	dt:Region	[1..1]	Регион (республика, область, край, автономная область) Достаточно указать один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid
031	··················<bs:uuid>?</bs:uuid>	bs:UUID	[0..1]	Уникальный идентификатор региона в соответствии со справочником РСХН
032	··················<bs:guid>?</bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор региона в соответствии со справочником РСХН
033	···············</dt:region>
034	···············<dt:district>	dt:District	[0..1]	Район региона
035	··················<bs:uuid>?</bs:uuid>	bs:UUID	[0..1]	Уникальный идентификатор района региона в соответствии со справочником РСХН
036	··················<bs:guid>?</bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор района региона в соответствии со справочником РСХН
037	···············</dt:district>
038	···············<dt:locality>	dt:Locality	[1..1]	Населённый пункт Достаточно указать один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid
039	··················<bs:uuid>?</bs:uuid>	bs:UUID	[0..1]	Уникальный идентификатор населенного пункта в соответствии со справочником РСХН
040	··················<bs:guid>?</bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор населенного пункта в соответствии со справочником РСХН
041	···············</dt:locality>
042	···············<dt:subLocality>	dt:Locality	[0..1]	Населённый пункт, подчиненный другогому населенному пункту (locality) Достаточно указать один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid
043	··················<bs:uuid>?</bs:uuid>	bs:UUID	[0..1]	Уникальный идентификатор населенного пункта в соответствии со справочником РСХН
044	··················<bs:guid>?</bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор населенного пункта в соответствии со справочником РСХН
045	···············</dt:subLocality>
046	···············<dt:street>	dt:Street	[0..1]	Улица Достаточно указать один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid
047	··················<bs:uuid>?</bs:uuid>	bs:UUID	[0..1]	Уникальный идентификатор улицы в соответствии со справочником РСХН
048	··················<bs:guid>?</bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор улицы в соответствии со справочником РСХН
049	···············</dt:street>
050	···············<dt:house>?</dt:house>	bs:String255	[0..1]	Номер дома
051	···············<dt:building>?</dt:building>	bs:String255	[0..1]	Номер строения
052	···············<dt:room>?</dt:room>	bs:String255	[0..1]	Номер квартиры / офиса
053	···············<dt:postIndex>?</dt:postIndex>	bs:String255	[0..1]	Почтовый индекс
054	···············<dt:postBox>?</dt:postBox>	bs:String255	[0..1]	Абонентский ящик
055	···············<dt:additionalInfo>?</dt:additionalInfo>	bs:String255	[0..1]	Дополнительная информация
056	···············<dt:addressView>?</dt:addressView>	bs:String255	[0..1]	Строковое представление адреса
057	············</dt:juridicalAddress>
058	·········</dt:businessEntity>
059	······</dt:resultingList>
060	······<dt:reason>?</dt:reason>	bs:String255	[1..1]	Основание добавления записи в реестр
061	···</merc:modificationOperation>
062	</merc:modifyBusinessEntityRequest>

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

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<merc:modifyBusinessEntityResponse>
002	···<merc:businessEntity>	dt:BusinessEntity	[1..1]	Данные о хозяйствующем субъекте. В случае изменения в ответе вернутся две записи: старая и новая
003	······<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии хозяйствующего субъекта.
004	······<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта.
005	······<bs:active>true</bs:active>	xs:boolean	[1..1]	Флаг: является ли запись активной. true - запись активна; false - запись не активна.
006	······<bs:last>true</bs:last>	xs:boolean	[1..1]	Флаг: является ли версия записи последней. true - да; false - нет.
007	······<bs:status>200</bs:status>	bs:VersionStatus	[1..1]	Статус версии хозяйствующего субъекта. Список статусов находится тут - bs:VersionStatus
008	······<bs:createDate>2018-02-08T11:08:27+03:00</bs:createDate>	xs:DateTime	[1..1]	Дата создания хозяйствующего субъекта.
009	······<bs:updateDate>2018-02-08T11:08:27+03:00</bs:updateDate>	xs:DateTime	[1..1]	Дата изменения хозяйствующего субъекта.
010	······<bs:previous>UUID</bs:previous>	bs:UUID	[0..1]	Идентификатор предыдущей версии записи.
011	······<bs:next>UUID</bs:next>	bs:UUID	[0..1]	Идентификатор следующей версии записи.
012	······<dt:type>1</dt:type>	dt:BusinessEntityType	[1..1]	Тип создаваемого или редактируемого хозяйствующего субъекта. 1 - юридическое лицо; 2 - физическое лицо; 3 - индивидуальный предприниматель.
013	······<dt:name>Наименование</dt:name>	bs:String255	[0..1]	Наименование хозяйствующего субъекта без указания организационно-правовой формы.
014	······<dt:incorporationForm>	dt:IncorporationForm	[0..1]	Организационно-правовая форма хозяйствующего субъекта.
015	·········<bs:uuid>UUID</bs:uuid>	bs:UUID	[0..1]	Идентификатор версии организационно-правовой формы
016	·········<dt:name>Общество с ограниченной ответственностью</dt:name>	bs:String255	[0..1]	Название организационно-правовой формы предприятия согласно справочнику ОКОПФ.
017	·········<dt:code>12300</dt:code>	bs:String255	[0..1]	Код организационно-правовой формы предприятия согласно справочнику ОКОПФ.
018	·········<dt:shortName>ООО</dt:shortName>	bs:String255	[0..1]	Краткое название организационно-правовой формы предприятия.
019	······</dt:incorporationForm>
020	······<dt:fullName>Полное наименование</dt:fullName>	bs:String255	[0..1]	Полное наименование хозяйствующего субъекта с указанием ОПФ.
021	······<dt:fio>Иванов Сергей Петрович</dt:fio>	bs:String255	[0..1]	ФИО физического лица или индивидуального предпринимателя.
022	······<dt:inn>3312200096</dt:inn>	bs:String255	[1..1]	ИНН хозяйствующего субъекта.
023	······<dt:kpp>163501001</dt:kpp>	bs:String255	[0..1]	Код причины постановки на учет (КПП).
024	······<dt:ogrn>4085022240002</dt:ogrn>	bs:String255	[0..1]	ОГРН или ОГРНИП.
025	······<dt:juridicalAddress>	dt:Address	[1..1]	Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект.
026	·········<dt:country>	dt:Country	[1..1]	Страна.
027	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор страны в соответствии со справочником РСХН.
028	·········</dt:country>
029	·········<dt:region>	dt:Region	[1..1]	Регион (республика, область, край, автономная область).
030	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор региона в соответствии со справочником РСХН.
031	·········</dt:region>
032	·········<dt:district>	dt:District	[0..1]	Район региона.
033	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор района региона в соответствии со справочником РСХН.
034	·········</dt:district>
035	·········<dt:locality>	dt:Locality	[1..1]	Населённый пункт.
036	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор населенного пункта в соответствии со справочником РСХН.
037	·········</dt:locality>
038	·········<dt:subLocality>	dt:Locality	[0..1]	Населённый пункт, подчиненный другогому населенному пункту (locality)
039	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор населенного пункта в соответствии со справочником РСХН.
040	·········</dt:subLocality>
041	·········<dt:street>	dt:Street	[0..1]	Улица
042	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор улицы в соответствии со справочником РСХН.
043	·········</dt:street>
044	·········<dt:house>6</dt:house>	bs:String255	[0..1]	Номер дома.
045	·········<dt:building>1</dt:building>	bs:String255	[0..1]	Номер строения.
046	·········<dt:room>1</dt:room>	bs:String255	[0..1]	Номер квартиры / офиса.
047	·········<dt:postIndex>600037</dt:postIndex>	bs:String255	[0..1]	Почтовый индекс.
048	·········<dt:postBox>а/я 56</dt:postBox>	bs:String255	[0..1]	Абонентский ящик
049	·········<dt:additionalInfo>Доп. инфо</dt:additionalInfo>	bs:String255	[0..1]	Дополнительная информация.
050	·········<dt:addressView>Адрес строкой</dt:addressView>	bs:String255	[0..1]	Строковое представление адреса.
051	······</dt:juridicalAddress>
052	···</merc:businessEntity>
053	</merc:modifyBusinessEntityResponse>

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

TODO

См. также

Вернуться к началу ↑
Вернуться на страницу профиля API MercuryG2B:Services:v3.0