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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 134: Строка 134:
|-
|-
|016
|016
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|bs:UUID
|[1..1]
| style="width:52em;"| Идентификатор страны в соответствии со справочником РСХН
|-
|017
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|bs:UUID
|bs:UUID
Строка 139: Строка 145:
| style="width:52em;"| Глобальный идентификатор страны в соответствии со справочником РСХН
| style="width:52em;"| Глобальный идентификатор страны в соответствии со справочником РСХН
|-
|-
|017
|018
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}country>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}country>'''}}
|
|
Строка 145: Строка 151:
|
|
|-
|-
|018
|019
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}region>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}region>'''}}
|dt:Region
|dt:Region
Строка 151: Строка 157:
| style="width:52em;"| Регион (республика, область, край, автономная область)
| style="width:52em;"| Регион (республика, область, край, автономная область)
|-
|-
|019
|020
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|bs:UUID
|[1..1]
| style="width:52em;"| Идентификатор региона в соответствии со справочником РСХН
|-
|021
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|bs:UUID
|bs:UUID
Строка 157: Строка 169:
| style="width:52em;"| Глобальный идентификатор региона в соответствии со справочником РСХН
| style="width:52em;"| Глобальный идентификатор региона в соответствии со справочником РСХН
|-
|-
|020
|022
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}region>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}region>'''}}
|
|
Строка 163: Строка 175:
|
|
|-
|-
|021
|023
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}district>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}district>'''}}
|dt:District
|dt:District
Строка 169: Строка 181:
| style="width:52em;"| Район региона
| style="width:52em;"| Район региона
|-
|-
|022
|024
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|bs:UUID
|[1..1]
| style="width:52em;"| Идентификатор района региона в соответствии со справочником РСХН
|-
|025
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|bs:UUID
|bs:UUID
Строка 175: Строка 193:
| style="width:52em;"| Глобальный идентификатор района региона в соответствии со справочником РСХН
| style="width:52em;"| Глобальный идентификатор района региона в соответствии со справочником РСХН
|-
|-
|023
|026
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}district>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}district>'''}}
|
|
Строка 181: Строка 199:
|
|
|-
|-
|024
|027
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}locality>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}locality>'''}}
|dt:Locality
|dt:Locality
Строка 187: Строка 205:
| style="width:52em;"| Населённый пункт
| style="width:52em;"| Населённый пункт
|-
|-
|025
|028
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|bs:UUID
|[1..1]
| style="width:52em;"| Идентификатор населенного пункта в соответствии со справочником РСХН
|-
|029
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|bs:UUID
|bs:UUID
Строка 193: Строка 217:
| style="width:52em;"| Глобальный идентификатор населенного пункта в соответствии со справочником РСХН
| style="width:52em;"| Глобальный идентификатор населенного пункта в соответствии со справочником РСХН
|-
|-
|026
|030
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}locality>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}locality>'''}}
|
|
Строка 199: Строка 223:
|
|
|-
|-
|027
|031
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}subLocality>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}subLocality>'''}}
|dt:Locality
|dt:Locality
Строка 205: Строка 229:
| style="width:52em;"| Населённый пункт, подчиненный другогому населенному пункту (locality)
| style="width:52em;"| Населённый пункт, подчиненный другогому населенному пункту (locality)
|-
|-
|028
|032
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|bs:UUID
|[1..1]
| style="width:52em;"| Идентификатор населенного пункта в соответствии со справочником РСХН
|-
|033
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|bs:UUID
|bs:UUID
Строка 211: Строка 241:
| style="width:52em;"| Глобальный идентификатор населенного пункта в соответствии со справочником РСХН
| style="width:52em;"| Глобальный идентификатор населенного пункта в соответствии со справочником РСХН
|-
|-
|029
|034
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}subLocality>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}subLocality>'''}}
|
|
Строка 217: Строка 247:
|
|
|-
|-
|030
|035
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''</{{color|#660e7a|dt:}}address>'''}}
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''</{{color|#660e7a|dt:}}address>'''}}
|
|
Строка 223: Строка 253:
|
|
|-
|-
|031
|036
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|vd:}}location>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|vd:}}location>'''}}
|
|
Строка 229: Строка 259:
|
|
|-
|-
|032
|037
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|vd:}}enterprise>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|vd:}}enterprise>'''}}
|dt:Enterprise
|dt:Enterprise
Строка 239: Строка 269:
* '''Указывается в случае, если не указано значение location'''
* '''Указывается в случае, если не указано значение location'''
|-
|-
|033
|038
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}}
|bs:UUID
|[0..1]
| style="width:52em;"| Идентификатор предприятия
|-
|039
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}}
|bs:UUID
|bs:UUID
Строка 245: Строка 281:
| style="width:52em;"| Глобальный идентификатор предприятия
| style="width:52em;"| Глобальный идентификатор предприятия
|-
|-
|034
|040
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|vd:}}enterprise>'''}}
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|vd:}}enterprise>'''}}
|
|
Строка 251: Строка 287:
|
|
|-
|-
|035
|041
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|vd:}}routePoint>'''}}
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|vd:}}routePoint>'''}}
|
|
Строка 257: Строка 293:
|
|
|-
|-
|036
|042
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|vd:}}shipmentRoute>'''}}
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|vd:}}shipmentRoute>'''}}
|
|
Строка 263: Строка 299:
|
|
|-
|-
|037
|043
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</{{color|#660e7a|merc:}}checkShipmentRegionalizationRequest>'''}}
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</{{color|#660e7a|merc:}}checkShipmentRegionalizationRequest>'''}}
|
|

Версия 11:57, 3 июня 2024

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

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

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:modifyActivityLocationsRequest>
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 ···<dt:cargoType> dt:SubProduct [1..*]

Категория груза, для которой запрашиваются правила перемещения по маршруту

  • Третий уровень иерархического справочника продукции ИС Меркурий
  • Обязательно указывать один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid
007 ······<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор версии вида продукции
008 ······<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор вида продукции
009 ···</dt:cargoType>
010 ···<vd:shipmentRoute> vd:ShipmentRoute [1..1]

Сведения о маршруте следования (пунктах перегрузки)

  • Должно быть указано минимум 2 точки в маршруте
011 ······<vd:routePoint> vd:ShipmentRoutePoint [1..1]

Сведения о точке маршрута

  • Обязательно должно быть заполнено хотя бы одно из полей, либо location либо enterprise
012 ·········<bs:sqnId>?</bs:sqnId> bs:SequenceNumber [1..1]

Порядовый номер точки маршрута

  • Не обязателен для заполнения, будет сгенерирован автоматически в ответе
013 ·········<vd:location> dt:Location [0..1]

Сведения о точке маршрута

  • Указывается в случае, если не указано значение enterpise
014 ······<dt:address>
015 ·········<dt:country> dt:Country [1..1] Страна
016 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор страны в соответствии со справочником РСХН
017 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор страны в соответствии со справочником РСХН
018 ·········</dt:country>
019 ·········<dt:region> dt:Region [1..1] Регион (республика, область, край, автономная область)
020 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор региона в соответствии со справочником РСХН
021 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор региона в соответствии со справочником РСХН
022 ·········</dt:region>
023 ·········<dt:district> dt:District [0..1] Район региона
024 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор района региона в соответствии со справочником РСХН
025 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор района региона в соответствии со справочником РСХН
026 ·········</dt:district>
027 ·········<dt:locality> dt:Locality [0..1] Населённый пункт
028 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор населенного пункта в соответствии со справочником РСХН
029 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор населенного пункта в соответствии со справочником РСХН
030 ·········</dt:locality>
031 ·········<dt:subLocality> dt:Locality [0..1] Населённый пункт, подчиненный другогому населенному пункту (locality)
032 ············<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор населенного пункта в соответствии со справочником РСХН
033 ············<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор населенного пункта в соответствии со справочником РСХН
034 ·········</dt:subLocality>
035 ············</dt:address>
036 ·········</vd:location>
037 ·········<vd:enterprise> dt:Enterprise [0..1]

Сведения о предприятии, которое является точкой маршрута

  • Обязательно указывать один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid
  • Указывается в случае, если не указано значение location
038 ············<bs:uuid>?</bs:uuid> bs:UUID [0..1] Идентификатор предприятия
039 ············<bs:guid>?</bs:guid> bs:UUID [0..1] Глобальный идентификатор предприятия
040 ·········</vd:enterprise>
041 ······</vd:routePoint>
042 ···</vd:shipmentRoute>
043 </merc:checkShipmentRegionalizationRequest>

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <merc:checkShipmentRegionalizationResponse
002 ···<vd:r13nRouteSection> vd:RouteSectionR13nRules [1..*]

Описание правил перемещения продукции

  • Количество элементов `r13nRouteSection` в ответе соответствует количеству отрезков маршрута
  • Атрибут `r13nRouteSection/sqnId` равен номеру отрезка, нумерация начинается с единицы
  • Количество элементов `r13nRouteSection/appliedR13nRule` соответствует количеству категорий груза (элемент `cargoType`) в запросе
003 ······<vd:sqnId>?</vd:sqnId> bs:SequenceNumber [1..1] Порядовый номер отрезка маршрута
004 ······<vd:appliedR13nRule> dt:RegionalizationShippingRule [1..*] Применяемое правило перемещения для каждой категории груза на данном участке маршрута
005 ·········<dt:cargoType> dt:SubProduct [1..*] Ветеринарная категория груза, на которую распространяется правило перемещения
006 ············<bs:uuid>?</bs:uuid> bs:SequenceNumber [1..1] Идентификатор версии вида продукцииа
007 ············<bs:guid>?</bs:guid> bs:SequenceNumber [1..1] Глобальный идентификатор вида продукции
008 ·········</dt:cargoType>
009 ·········<dt:decision>?</dt:decision> dt:RegionalizationDecision [1..1]

Решение о возможности перемещения груза

  • 1 - перемещение разрешено
  • 2 - перемещение разрешено при обязательном соблюдении условий
  • 3 - перемещение запрещено
010 ·········<dt:requirement> dt:RegionalizationRequirement [0..*] Требование к перемещению партии в отношении к определенному заболеванию
011 ············<dt:relatedDisease> dt:AnimalDisease [1..1] Заболевание, к которому относится данное требование
012 ···············<bs:uuid>?</bs:uuid> bs:SequenceNumber [1..1] Идентификатор заболевания
013 ···············<bs:guid>?</bs:guid> bs:SequenceNumber [1..1] Глобальный идентификатор заболевания
014 ···············<dt:name>?</dt:name> bs:String255 [1..1] Название заболевания
015 ············</dt:relatedDisease>
016 ············<dt:type>?</dt:type> dt:RegionalizationDecision [1..1]

Вид требования

  • 1 - перемещение разрешено
  • 2 - перемещение разрешено при обязательном соблюдении условий
  • 3 - перемещение запрещено
017 ············<dt:conditionGroup> dt:RegionalizationConditionGroup [0..*]

Группа условий регионализации, соблюдаемых при перевозке продукции

  • Имеет смысл, если тип требования `type` имеет значение 2 (перемещение разрешено при обязательном соблюдении условий). В этом случае требование считается выполненным, если выполнена одна из альтернативных групп условий `conditionGroup`. См. условие выполнения группы в описании типа `dt:RegionalizationConditionGroup`
018 ···············<dt:condition> dt:RegionalizationCondition [1..*] Условие регионализации, соблюдаемое при перевозке груза
019 ··················<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии условия регионализации
020 ··················<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор условия регионализации
021 ··················<dt:referenceNumber>?</dt:referenceNumber> bs:Identifier [1..1] Номер условия регионализации
022 ··················<dt:text>?</dt:text> bs:Text [1..1] Формулировка условия регионализации
023 ··················<dt:strict>?</dt:strict> xs:boolean [0..1] Обязательность соблюдения условия регионализации
024 ··················<dt:relatedDisease> dt:AnimalDisease [1..*] Заболевание, к которому относится данное условие регионализации
025 ·····················<bs:uuid>?</bs:uuid> bs:UUID [1..1] Идентификатор версии заболевания
026 ·····················<bs:guid>?</bs:guid> bs:UUID [1..1] Глобальный идентификатор заболевания
027 ·····················<dt:name>?</dt:name> bs:String255 [1..1] Название заболевания
028 ··················</dt:relatedDisease>
029 ···············</dt:condition>
030 ············</dt:conditionGroup>
031 ·········</dt:requirement>
032 ······</vd:appliedR13nRule>
033 ···</vd:r13nRouteSection>
034 </merc:checkShipmentRegionalizationResponse>

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

TODO

См. также

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

Источник — http://help.vetrf.ru/index.php?title=MercuryG2B:CheckShipmentRegionalization:v3.0&oldid=40227