Herriot:VerifyAnimalID:v1.0: различия между версиями

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 129: Строка 129:
|[1..2]
|[1..2]
|<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;">
* Если указанный в запросе номер найден, то возвращается 2 записи animalID с разным значением атрибута format:
* Если указанный в запросе номер найден, то возвращается 2 записи animalID с разным значением атрибута format:
** @format = "UNMM" - полный номер средства маркирования из запроса
** @format = "UNMM" - полный номер средства маркирования
** @format = "ISO" - соответствующий номеру из запроса цифровой номер средства маркирования формата ISO
** @format = "ISO" - цифровой номер средства маркирования формата ISO
* Если указанный в запросе номер не найден, то возвращается 1 запись animalID из запроса с соответствующим статусом (status)</div>
* Если указанный в запросе номер не найден, то возвращается 1 запись animalID из запроса с соответствующим статусом (status)</div>
</div>
</div>

Версия 14:10, 17 июля 2024

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

Код Описание операции
AMS.HRT.2.6 Операция предназначена для проверки статусов выпущенных в оборот номеров средств маркирования животных

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <hrt:verifyAnimalIDRequest>
002 ···<hrt:localTransactionId>?</hrt:localTransactionId> bs:Identifier [1..1] Идентификатор заявки в клиентской системе
003 ···<hrt:initiator> vd:User [1..1]

Пользователь, зарегистрированный в ВетИС, инициирующий запрос

  • является ответственным за выполнение бизнес-операции
  • требуется логин ветврача или пользователя ХС, логин для базовой аутентификации не подойдёт
004 ······<vd:login>?</vd:login> xs:NCName [1..1] Логин пользователя
005 ···</hrt:initiator>
006 ···<hrt:animalIDList> dt:UnifiedAnimalIDList [1..1] Список номеров средств маркирования для проверки
007 ······<dt:animalIDContent> dt:UnifiedAnimalID [1..*] Сведения о номере средства маркирования
008 ·········<dt:animalID format="?">?</dt:animalID> dt:AnimalID [1..1]

Номер средства маркирования в формате, по которому необходимо выполнить поиск

  • Возможные значения атрибута format:
    • @format = "UNMM" - полный номер средства маркирования, по которому будет выполнен поиск номера ISO.
    • @format = "ISO" - цифровой номер средства маркирования формата ISO, по которому будет выполнен поиск номера UNMM.
009 ······</dt:animalIDContent>
010 ···</hrt:animalIDList>
011 </hrt:verifyAnimalIDRequest>

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <hrt:verifyAnimalIDResponse>
002 ···<hrt:animalIDList> dt:UnifiedAnimalIDList [1..1] Список номеров средств маркирования
003 ······<dt:animalIDContent> dt:UnifiedAnimalID [1..*] Сведения о номере средства маркирования
004 ·········<dt:animalID format="?">?</dt:animalID> dt:AnimalID [1..2]

Номер средства маркирования

  • Если указанный в запросе номер найден, то возвращается 2 записи animalID с разным значением атрибута format:
    • @format = "UNMM" - полный номер средства маркирования
    • @format = "ISO" - цифровой номер средства маркирования формата ISO
  • Если указанный в запросе номер не найден, то возвращается 1 запись animalID из запроса с соответствующим статусом (status)
005 ·········<dt:status>?</dt:status> dt:AnimalIDStatus [1..1]

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

  • Возможные значения:
    • UNKNOWN - неизвестный номер (не найдено данных об указанном в запросе номере средства маркирования или номер указан неверно)
    • EMITTED - номер выпущен
    • PRODUCED - изготовлено средство маркирования с данным номером
    • ACTIVE - номер нанесён (используется)
    • TERMINATED - номер выбыл (не используется)
006 ·········<dt:emissionDate>?</dt:emissionDate> xs:date [0..1]

Дата выпуска номера средства маркирования

  • Не возвращается, если данные о номере из запроса не найдены (status == UNKNOWN)
007 ·········<dt:producingDate>?</dt:producingDate> xs:date [0..1]

Дата производства средства маркирования с указанным номером

  • Может возвращаться для статусов для статусов PRODUCED, ACTIVE и TERMINATED
008 ·········<dt:attachmentDate>?</dt:attachmentDate> xs:date [0..1]

Дата нанесения / прикрепления номера средства маркирования

  • Возвращается для статусов ACTIVE и TERMINATED
009 ·········<dt:expiredDate>?</dt:expiredDate> xs:date [0..1]

Дата вывода номера средства маркирования из оборота

  • Возвращается для статуса TERMINATED
010 ······</dt:animalIDContent>
011 ···</hrt:animalIDList>
012 </hrt:verifyAnimalIDResponse>

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

TODO

См. также

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