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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 268: Строка 268:
|-
|-
| style="text-align:center; vertical-align:top;" |2.1.  
| style="text-align:center; vertical-align:top;" |2.1.  
| style="text-align:left; vertical-align:top;" | [[Herriot:RegisterAnimalIdentity:v1.0|RegisterAnimalIdentity]]
| style="text-align:left; vertical-align:top;" | RegisterAnimalIdentity
| style="text-align:left; vertical-align:top;" |<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:81em;">
| style="text-align:left; vertical-align:top;" |<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:81em;">
<span style="white-space:nowrap; font-weight: normal;">Регистрация сведений об идентификации зарегистрированного животного или группы животных (маркирование)</span>
<span style="white-space:nowrap; font-weight: normal;">Регистрация сведений об идентификации зарегистрированного животного или группы животных (маркирование)</span>
Строка 280: Строка 280:
|-
|-
| style="text-align:center; vertical-align:top;" |2.2.  
| style="text-align:center; vertical-align:top;" |2.2.  
| style="text-align:left; vertical-align:top;" | [[Herriot:RemoveAnimalIdentity:v1.0|RemoveAnimalIdentity]]
| style="text-align:left; vertical-align:top;" | RemoveAnimalIdentity
| style="text-align:left; vertical-align:top;" |<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:81em;">
| style="text-align:left; vertical-align:top;" |<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:81em;">
<span style="white-space:nowrap; font-weight: normal;">Прекращение регистрации сведений об идентификации зарегистрированного животного или группы животных (выбытие средства маркирования)</span>
<span style="white-space:nowrap; font-weight: normal;">Прекращение регистрации сведений об идентификации зарегистрированного животного или группы животных (выбытие средства маркирования)</span>
Строка 293: Строка 293:
|-
|-
| style="text-align:center; vertical-align:top;" |2.3.  
| style="text-align:center; vertical-align:top;" |2.3.  
| style="text-align:left; vertical-align:top;" | [[Herriot:ReplaceAnimalIdentity:v1.0|ReplaceAnimalIdentity]]
| style="text-align:left; vertical-align:top;" | ReplaceAnimalIdentity
| style="text-align:left; vertical-align:top;" |<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:81em;">
| style="text-align:left; vertical-align:top;" |<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:81em;">
<span style="white-space:nowrap; font-weight: normal;">Перерегистрация сведений об идентификации зарегистрированного животного или группы животных (замена средства маркирования)</span>
<span style="white-space:nowrap; font-weight: normal;">Перерегистрация сведений об идентификации зарегистрированного животного или группы животных (замена средства маркирования)</span>
Строка 307: Строка 307:
|-
|-
| style="text-align:center; vertical-align:top;" |2.4.  
| style="text-align:center; vertical-align:top;" |2.4.  
| style="text-align:left; vertical-align:top;" | [[Herriot:WithdrawAnimalIdentity:v1.0|WithdrawAnimalIdentity]]
| style="text-align:left; vertical-align:top;" | WithdrawAnimalIdentity
| style="text-align:left; vertical-align:top;" |<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:81em;">
| style="text-align:left; vertical-align:top;" |<div class="mw-collapsible mw-collapsed" data-expandtext="&nbsp;...&nbsp;" data-collapsetext="свернуть" style="font-weight: bold; width:81em;">
<span style="white-space:nowrap; font-weight: normal;">Аннулирование сведений о регистрации сведений об идентификации животного или группы животных</span>
<span style="white-space:nowrap; font-weight: normal;">Аннулирование сведений о регистрации сведений об идентификации животного или группы животных</span>

Версия 09:09, 13 ноября 2023

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

Сервис позволяет вносить в компонент Хорриот информацию, связанную с маркировкой и учетом животных, и получать от компонента Хорриот эту информацию.

Версии профиля API

Предоставляемые сервисы

Сервис Описание WSDL
1 ApplicationManagementService Подсистема обработки заявок https://api.vetrf.ru/schema/platform/herriot/v1.0b-last/ams-herriot.service_v1.0.wsdl
2 EnterpriseService Сервис реестров хозяйствующих субъектов и предприятий https://api.vetrf.ru/schema/platform/herriot/v1.0b-last/EnterpriseService_v1.0.wsdl
3 DictionaryService Сервис справочной информации https://api.vetrf.ru/schema/platform/herriot/v1.0b-last/DictionaryService_v1.0.wsdl
4 ProductService Сервис реестров категорий продукции https://api.vetrf.ru/schema/platform/herriot/v1.0b-last/ProductService_v1.0.wsdl
5 IkarService Сервис получения адресной информации https://api.vetrf.ru/schema/platform/herriot/v1.0b-last/IkarService_v1.0.wsdl

ApplicationManagementService (подсистема обработки заявок)

Параметры подключения


Продуктивный контур

WSDL https://api.vetrf.ru/schema/platform/herriot/v1.0b-last/ams-herriot.service_v1.0.wsdl
URL точки доступа (Endpoint) временно недоступно
Описание типов заявок включено в WSDL
Код сервиса (serviceId) herriot.service:1.0

Тестовый контур

WSDL https://api.vetrf.ru/schema/platform/herriot/v1.0b-last/ams-herriot.service_v1.0.wsdl
URL точки доступа (Endpoint) временно недоступно
Описание типов заявок включено в WSDL
Код сервиса (serviceId) herriot.service:1.0

Основные сущности и типы данных

HerriotConceptualDataModel.png

Используемые пространства имён

Пространство имён (xmlns) XSD-схема, содержащая описание типов
xmlns:xs="http://www.w3.org/2001/XMLSchema" http://www.w3.org/2001/XMLSchema.xsd
xmlns:bs="http://api.vetrf.ru/schema/cdm/base" base_v2.1.xsd
xmlns:apl="http://api.vetrf.ru/schema/cdm/application" application_v2.1.xsd
xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2" dictionary_v2.5.xsd
xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2" document_v2.5.xsd
xmlns:hrt="http://api.vetrf.ru/schema/cdm/herriot/applications/v1" herriot_applications_v1.0.xsd

Операции, выполняемые через ApplicationManagementService

Название операции / ссылка на спецификацию Описание операции ([ ... ] – входные и выходные данные, сценарии)
Операции по работе с учетной карточкой животного (группы животных)
1.1. RegisterAnimal

Регистрация животного или группы животных

Входные данные:

  • проект регистрационной карточки животного или группы животных, включая сведения об идентификации животного, ввозе на территорию РФ, текущем содержании, потомстве

Выходные данные:

  • зарегистрированная карточка животного или группы животного в статусе PREPARING или ACTIVE
1.2. ModifyAnimalRegistration

Внесение изменений в основные сведения о зарегистрированном животном или группе животных

Входные данные:

  • проект изменений существующей регистрационной карточки с указанным идентификатором версии

Выходные данные:

  • обновленная карточка животного или группы животных в статусе ACTIVE
1.3. RegisterAnimalMovementEvent

Регистрация сведения о перемещении/смене собственника зарегистрированного животного или групп животных

Входные данные:

  • сведения о перемещении
  • сведения перемещаемых зарегистрированных животных или группах животных

Выходные данные:

  • обновленная карточка животного или группы животных в статусе RELOCATING или ACTIVE
1.4. TerminateAnimalRegistration

Прекращение регистрации животного или группы животных (выбытие животного)

Входные данные:

  • сведения о выбытии животного
  • сведения о зарегистрированных животных или группах животных, в отношении которых регистрируется выбытие

Выходные данные:

  • обновленная карточка животного или группы животных в статусе TERMINATED
1.5. WithdrawAnimalRegistration

Аннулирование сведений о регистрации животного или группы животных

Входные данные:

  • сведения об аннулировании регистрационной карточки животного
  • сведения о зарегистрированных животных или группах животных

Выходные данные:

  • обновленная карточка животного или группы животных в статусе WITHDRAWN
1.6. GetAnimalRegistrationByGuid

Получение основных актуальных сведений о регистрации животного или группы животных по глобальному идентификатору

Входные данные:

  • глобальный идентификатор регистрационной карточки животного или группы животных

Выходные данные:

  • актуальная редакция регистрационной карточки животного или группы животных без сведений о ветеринарных профилактических мероприятиях
1.8. GetAnimalRegistrationHistory

Получение всей истории изменений сведений о регистрации животного или группы животных по глобальному идентификатору

Входные данные:

  • глобальный идентификатор регистрационной карточки животного или группы животных

Выходные данные:

  • список версий регистрационной карточки животного или группы животных
1.9. GetAnimalRegistrationChangesList

Получение списка изменений по основным сведениям о регистрации животных или групп животных за указанный период

Входные данные:

  • интервал дат, определяющий запрашиваемый период изменений
  • зона обслуживания: субъект РФ, на территории которого содержатся животные
  • зона обслуживания: место содержания животных
  • поднадзорный объект, на котором осуществляется содержание животных

Выходные данные:

  • список созданных за указанный период времени версий регистрационных карточек животных или групп животных, которые содержатся в указанной зоне обслуживания
1.10. GetAnimalRegistrationByUuid

Получение редакции основных сведений о регистрации животного или группы животных по идентификатору конкретной версии (редакции)

Входные данные:

  • уникальный идентификатор версии регистрационной карточки животного или группы животных

Выходные данные:

  • сведения о запрашиваемой версии регистрационной карточки животного или группы животных без сведений о ветеринарных профилактических мероприятиях
Операции по работе со сведениями об идентификации животного (группы животных)
2.1. RegisterAnimalIdentity

Регистрация сведений об идентификации зарегистрированного животного или группы животных (маркирование)

Входные данные:

  • проект сведений об идентификации, содержащий глобальный идентификатор зарегистрированного животного или группы животных

Выходные данные:

  • зарегистрированные сведения об идентификации животного
2.2. RemoveAnimalIdentity

Прекращение регистрации сведений об идентификации зарегистрированного животного или группы животных (выбытие средства маркирования)

Входные данные:

  • сведения о выбытии зарегистрированного средства маркирования
  • глобальный идентификатор сведений о зарегистрированных сведениях об идентификации животного, в отношении которых регистрируется выбытие

Выходные данные:

  • обновленные сведения об идентификации животного или группы животных в статусе TERMINATED
2.3. ReplaceAnimalIdentity

Перерегистрация сведений об идентификации зарегистрированного животного или группы животных (замена средства маркирования)

Входные данные:

  • сведения о замене средства маркирования
  • глобальный идентификатор сведений о зарегистрированных сведениях об идентификации животного

Выходные данные:

  • обновленные сведения об идентификации животного или группы животных в статусе TERMINATED
  • зарегистрированные сведения о новой идентификации животного или группы животных
2.4. WithdrawAnimalIdentity

Аннулирование сведений о регистрации сведений об идентификации животного или группы животных

Входные данные:

  • сведения об аннулировании сведений
  • глобальный идентификатор аннулируемых сведений об идентификации животного или группы животных

Выходные данные:

  • обновленные сведения об идентификации животного или группы животных в статусе WITHDRAWN
Операции по работе со сведениями о ветеринарных профилактических мероприятиях животного (группы животных)
4.1. RegisterAnimalVeterinaryEvent

Регистрация ветеринарного профилактического мероприятия

Входные данные:

  • проект сведений о ветеринарном профилактическом мероприятии
  • список зарегистрированных животных или групп животных, в отношении которых осуществлялось данное мероприятие

Выходные данные:

  • зарегистрированные сведения о ветеринарном профилактическом мероприятии
4.2. ModifyAnimalVeterinaryEvent

Редактирование сведений о ветеринарном профилактическом мероприятии

Входные данные:

  • проект обновленных сведений о зарегистрированном ветеринарном профилактическом мероприятии с указанным глобальным идентификатором

Выходные данные:

  • обновленная редакция сведений о зарегистрированном ветеринарном профилактическом мероприятии
4.3. WithdrawAnimalVeterinaryEvent

Аннулирование сведений о ветеринарном профилактическом мероприятии

Входные данные:

  • сведения об аннулировании
  • глобальный идентификатор аннулируемых сведений о ветеринарном профилактическом мероприятии

Выходные данные:

  • обновленная редакция сведений о зарегистрированном ветеринарном профилактическом мероприятии в статусе WITHDRAWN
4.4. GetAnimalVeterinaryEventByGuid

Получение актуальных сведений о зарегистрированном ветеринарном профилактическом мероприятии по глобальному идентификатору

Входные данные:

  • глобальный идентификатор зарегистрированных сведений о ветеринарном профилактическом мероприятии

Выходные данные:

  • актуальная редакция зарегистрированных сведений о ветеринарном профилактическом мероприятии
4.5. GetAnimalVeterinaryEventChangesList

Получение списка изменений сведений о зарегистрированных ветеринарных профилактических мероприятиях за указанный период

Входные данные:

  • интервал дат, определяющий запрашиваемый период изменений
  • зона обслуживания: субъект РФ, на территории которого содержатся животные
  • зона обслуживания: место содержания животных
  • поднадзорный объект, на котором осуществляется содержание животных
  • глобальный идентификатор зарегистрированной карточки животного или группы животных

Выходные данные:

  • список созданных за указанный период времени версий сведений о ветеринарных профилактических мероприятиях животных или групп животных, которые содержатся в указанной зоне обслуживания
4.6. GetAnimalVeterinaryEventHistory

Получение всей истории изменений ветеринарного профилактического мероприятия по глобальному идентификатору

Входные данные:

  • глобальный идентификатор зарегистрированных сведений о ветеринарном профилактическом мероприятии

Выходные данные:

  • список версий сведений о ветеринарном профилактическом мероприятии
4.7. GetAnimalVeterinaryEventByUuid

Получение сведений о редакции ветеринарного профилактического мероприятия по идентификатору версии

Входные данные:

  • уникальный идентификатор версии сведений о ветеринарном профилактическом мероприятии

Выходные данные:

  • сведения о запрашиваемой версии сведений о ветеринарном профилактическом мероприятии