MercuryG2B:ModifyEnterprise:v3.0: различия между версиями

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 57: Строка 57:
|[[ENTModificationOperation_v2.0|vd:ENTodificationOperation]]
|[[ENTModificationOperation_v2.0|vd:ENTodificationOperation]]
|[1..1]
|[1..1]
| style="width:52em;"| Описание операции добавления/изменения информации о предприятии
| style="width:52em;"| Описание операции добавления/изменения информации о площадке
|-
|-
|007
|007
Строка 76: Строка 76:
|[1..1]
|[1..1]
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
<span style="white-space:nowrap; font-weight: normal;">Список, который содержит сведения о добавляемых предприятиях</span>
<span style="white-space:nowrap; font-weight: normal;">Список, который содержит сведения о добавляемых площадках</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
<div class="mw-collapsible-content" style="font-weight: normal;">
* На данный момент поддерживается добавление только одной площадки в рамках одной заявки</div>
* На данный момент поддерживается добавление только одной площадки в рамках одной заявки</div>
Строка 85: Строка 85:
|[[Enterprise_v2.0|dt:Enterprise]]
|[[Enterprise_v2.0|dt:Enterprise]]
|[1..1]
|[1..1]
| style="width:52em;"| Данные о предприятии
| style="width:52em;"| Данные о площадке
|-
|-
|010
|010
Строка 92: Строка 92:
|[0..1]
|[0..1]
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
<span style="white-space:nowrap; font-weight: normal;">Идентификатор версии предприятия</span>
<span style="white-space:nowrap; font-weight: normal;">Идентификатор версии площадки</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
<div class="mw-collapsible-content" style="font-weight: normal;">
* Задается в запросе на изменение (тип операции UPDATE)
* Задается в запросе на изменение (тип операции UPDATE)
Строка 102: Строка 102:
|[[String255|bs:String255]]
|[[String255|bs:String255]]
|[1..1]
|[1..1]
| style="width:52em;"| Полное наименование предприятия
| style="width:52em;"| Полное наименование площадки
|-
|-
|012
|012
Строка 109: Строка 109:
|[1..1]
|[1..1]
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
<span style="white-space:nowrap; font-weight: normal;">Тип предприятия (для предприятия РФ)</span>
<span style="white-space:nowrap; font-weight: normal;">Тип площадки(для площадки РФ)</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
<div class="mw-collapsible-content" style="font-weight: normal;">
* 1 - предприятие
* 1 - предприятие
Строка 122: Строка 122:
|[1..1]
|[1..1]
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
<span style="white-space:nowrap; font-weight: normal;">Фактический адрес расположения предприятия </span>
<span style="white-space:nowrap; font-weight: normal;">Фактический адрес расположения площадки</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
<div class="mw-collapsible-content" style="font-weight: normal;">
* Для российских предприятий детализация адреса должна быть как минимум до locality</div>
* Для российских площадок детализация адреса должна быть как минимум до locality</div>
</div>
</div>
|-
|-
Строка 350: Строка 350:
|[1..*]
|[1..*]
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
<span style="white-space:nowrap; font-weight: normal;">Деятельность, осуществляемая предприятием</span>
<span style="white-space:nowrap; font-weight: normal;">Деятельность, осуществляемая площадкой</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
<div class="mw-collapsible-content" style="font-weight: normal;">
* Указывается согласно справочнику видов деятельности</div>
* Указывается согласно справочнику видов деятельности</div>
Строка 378: Строка 378:
|[0..1]
|[0..1]
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
|<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
<span style="white-space:nowrap; font-weight: normal;">Хозяйствующий субъект-собственник предприятия</span>
<span style="white-space:nowrap; font-weight: normal;">Хозяйствующий субъект-собственник площадки</span>
<div class="mw-collapsible-content" style="font-weight: normal;">
<div class="mw-collapsible-content" style="font-weight: normal;">
* Указание owner влияет на то, сможет ли реальный владелец предприятия (ХС) в дальнейшем её редактировать. По умолчанию редактировать предприятие через API может только тот, кто добавил её в реестр
* Указание owner влияет на то, сможет ли реальный владелец площадки (ХС) в дальнейшем её редактировать. По умолчанию редактировать площадку через API может только тот, кто добавил её в реестр
* Обязательно должен быть указан uuid или guid. При указании обоих приоритет у uuid</div>
* Обязательно должен быть указан uuid или guid. При указании обоих приоритет у uuid</div>
</div>
</div>

Версия 12:47, 14 июня 2024

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

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

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:modifyEnterpriseRequest>
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:ENTodificationOperation [1..1] Описание операции добавления/изменения информации о площадке
007 ······<vd:type>?</vd:type> bs:RegisterModificationType [1..1]

Тип операции

На данный момент доступны операции двух типов:

  • CREATE - создание поднадзорного объекта
  • UPDATE - обновление данных поднадзорного объекта
008 ······<vd:resultingList> dt:EnterpriseList [1..1]

Список, который содержит сведения о добавляемых площадках

  • На данный момент поддерживается добавление только одной площадки в рамках одной заявки
009 ·········<dt:enterprise> dt:Enterprise [1..1] Данные о площадке
010 ············<bs:uuid>?</bs:uuid> bs:UUID [0..1]

Идентификатор версии площадки

  • Задается в запросе на изменение (тип операции UPDATE)
  • Может быть указана только последняя версия записи
011 ············<dt:name>?</dt:name> bs:String255 [1..1] Полное наименование площадки
012 ············<dt:type>?</dt:type> dt:EnterpriseType [1..1]

Тип площадки(для площадки РФ)

  • 1 - предприятие
  • 2 - рынок
  • 3 - СББЖ
  • 4 - судно
013 ············<dt:address> dt:Address [1..1]

Фактический адрес расположения площадки

  • Для российских площадок детализация адреса должна быть как минимум до locality
014 ···············<dt:country> dt:Country [1..1]

Страна

  • Достаточно указать один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid
015 ··················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Уникальный идентификатор страны в соответствии со справочником РСХН
016 ··················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор страны в соответствии со справочником РСХН
017 ···············</dt:country>
018 ···············<dt:region> dt:Region [1..1]

Регион (республика, область, край, автономная область)

  • Достаточно указать один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid
019 ··················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Уникальный идентификатор региона в соответствии со справочником РСХН
020 ··················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор региона в соответствии со справочником РСХН
021 ···············</dt:region>
022 ···············<dt:district> dt:District [0..1] Район региона
023 ··················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Уникальный идентификатор района региона в соответствии со справочником РСХН
024 ··················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор района региона в соответствии со справочником РСХН
025 ···············</dt:district>
026 ···············<dt:locality> dt:Locality [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:locality>
030 ···············<dt:subLocality> dt:Locality [0..1]

Населённый пункт, подчиненный другогому населенному пункту (locality)

  • Достаточно указать один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid
031 ··················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Уникальный идентификатор населенного пункта в соответствии со справочником РСХН
032 ··················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор населенного пункта в соответствии со справочником РСХН
033 ···············</dt:subLocality>
034 ···············<dt:street> dt:Street [0..1]

Улица

  • Достаточно указать один из идентификаторов: uuid или guid. При указании обоих приоритет у uuid
035 ··················<bs:uuid>?</bs:uuid> bs:UUID [0..1] Уникальный идентификатор улицы в соответствии со справочником РСХН
036 ··················<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор улицы в соответствии со справочником РСХН
037 ···············</dt:street>
038 ···············<dt:house>?</dt:house> bs:String255 [0..1] Номер дома
039 ···············<dt:building>?</dt:building> bs:String255 [0..1] Номер строения
040 ···············<dt:room>?</dt:room> bs:String255 [0..1] Номер квартиры / офиса
041 ···············<dt:postIndex>?</dt:postIndex> bs:String255 [0..1] Почтовый индекс
042 ···············<dt:postBox>?</dt:postBox> bs:String255 [0..1] Абонентский ящик
043 ···············<dt:additionalInfo>?</dt:additionalInfo> bs:String255 [0..1] Дополнительная информация
044 ···············<dt:addressView>?</dt:addressView> bs:String255 [0..1] Строковое представление адреса
045 ············</dt:address>
046 ············<dt:activityList> dt:EnterpriseActivityList [1..1] Виды деятельности площадки
047 ···············<dt:activity> dt:EnterpriseActivity [1..*]

Деятельность, осуществляемая площадкой

  • Указывается согласно справочнику видов деятельности
048 ··················<dt:name>?</dt:name> bs:NText [1..1] Название вида деятельности
049 ···············</dt:activity>
050 ············</dt:activityList>
051 ············<dt:owner> dt:BusinessEntity [0..1]

Хозяйствующий субъект-собственник площадки

  • Указание owner влияет на то, сможет ли реальный владелец площадки (ХС) в дальнейшем её редактировать. По умолчанию редактировать площадку через API может только тот, кто добавил её в реестр
  • Обязательно должен быть указан uuid или guid. При указании обоих приоритет у uuid
052 ···············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта
053 ···············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта
054 ············</dt:owner>
055 ············<dt:officialRegistration> dt:EnterpriseOfficialRegistration [0..*] Факт постановки на учёт в налоговом органе
056 ···············<dt:businessEntity> dt:BusinessEntity [1..1] Хозяйствующий субъект, поставивший площадку на учёт в налоговом органе
057 ··················<dt:inn>?</dt:inn> bs:String255 [1..1]

ИНН хозяйствующего субъекта

  • Обязательно указывается ИНН хозяйствующего субъекта. В случае передачи иных полей из типа dt:BusinessEntity они будут проигнорированы
  • ИНН валидируется по контрольному числу. Требуется корректное указание ИНН
058 ···············</dt:businessEntity>
059 ···············<dt:kpp>?</dt:kpp> bs:String255 [1..1] Код причины постановки на учёт (КПП)
060 ············</dt:officialRegistration>
061 ·········</dt:enterprise>
062 ······</vd:resultingList>
063 ······<vd:reason>?</vd:reason> dt:ENTModificationReason [1..1] Основание добавления записи в реестр
064 ···</merc:modificationOperation>
065 </merc:modifyEnterpriseRequest>

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)

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

TODO

См. также

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