Exportcenter:Services:v2.2: различия между версиями

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 46: Строка 46:
|-
|-
! scope="col" style="text-align:left;"| URL точки доступа (Endpoint)
! scope="col" style="text-align:left;"| URL точки доступа (Endpoint)
| https://{server}:{port}/platform/exportcenter/services/2.2/ApplicationManagementService
| https://{server}:{port}/platform/exportcenter/services/2.1/ApplicationManagementService
|-
|-
! scope="col" style="text-align:left;"| Описание типов заявок
! scope="col" style="text-align:left;"| Описание типов заявок

Версия 08:38, 1 марта 2023

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

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

Сервис Описание
ApplicationManagementService Подсистема обработки заявок
EnterpriseService Сервис реестров хозяйствующих субъектов и предприятий
ProductService Сервис реестров категорий продукции
DictionaryService Сервис справочной информации
FMPRegistryService Сервис государственного реестра лекарственных препаратов ветеринарного применения, фармацевтических субстанций, кормов и кормовых добавок

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

WSDL https://api.vetrf.ru/schema/platform/exportcenter/v2.2b-20230222/ams-exportcenter.service_v2.2.wsdl
URL точки доступа (Endpoint) https://{server}:{port}/platform/exportcenter/services/2.1/ApplicationManagementService
Описание типов заявок включено в WSDL
Код сервиса (serviceId) exportcenter.service:2.2

Описание типов заявок (XSD-схемы)

Последняя версия XSD Пространство имен
v2.2b-2023022 https://api.vetrf.ru/schema/platform/exportcenter/v2.2b-20230222/base_v2.0.xsd xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
v2.2b-2023022 https://api.vetrf.ru/schema/platform/exportcenter/v2.2b-20230222/dictionary_v2.3.xsd xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2"
v2.2b-2023022 https://api.vetrf.ru/schema/platform/exportcenter/v2.2b-20230222/document_v2.3.xsd xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2"
v2.2b-2023022 https://api.vetrf.ru/schema/platform/exportcenter/v2.2b-20230222/exportcenter_applications_v2.2.xsd xmlns:exc="http://api.vetrf.ru/schema/cdm/exportcenter/applications/v2"

Принципы взаимодействия

Работа с сервисом ApplicationManagementService реализована по псевдо-асинхронному принципу и осуществляется в два шага, оба из которых выполняются синхронно:

  • 1 шаг – подача запроса с заявкой на выполнение бизнес-операции и получение результата приема заявки (идентификатора заявки);
  • 2 шаг – подача запроса на получение результата обработки заявки или результата выполнения бизнес-операции с использованием полученного на шаге 1 идентификатора заявки.

Для данной схемы действуют следующие правила:

  • Взаимодействие реализуется посредством запросов внешних информационных систем к ApplicationManagementService.
  • Любая операция в рамках информационного взаимодействия представляет собой заявку на выполнение бизнес-операции. Заявка от внешней информационной системы попадает в ApplicationManagementService, проходит форматно-логический контроль, регистрацию (ей присваивается уникальный идентификатор), маршрутизируется на целевой внутренний сервис, который выполняет операцию.
  • ApplicationManagementService позволяет отслеживать состояние данной заявки и получать результат ее выполнения.

Безопасность

  • Доступ к сервису ApplicationManagementService ограничивается с помощью ключей доступа к API (APIKey).
  • Ключи доступа предоставляются при регистрации внешней информационной системы в качестве клиента "Ветис.API".
  • APIKey - ключ, который идентифицирует клиентскую информационную систему. В сочетании с идентификатором пользователя (issuerId), этот ключ позволяет получать доступ к информации о клиенте сервиса.
  • Перед проверкой APIKey производится базовая аутентификация с помощью логина и пароля, предоставляемых в ответном письме при получении доступа. Процесс авторизации описан здесь.

Обработка заявок в ApplicationManagementService

  • Общий принцип работы с ApplicationManagementService, а также спецификации запросов/ответов подачи заявок и получения результатов обработки заявок, описаны здесь.

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

Номер операции Название операции / ссылка на спецификацию Описание операции
ЭВС:9.1. SendWBRComplianceApplication Направление заявления на получение Заключения о соответствии партии ВБР требованиям страны-импортера
ЭВС:9.2. CheckWBRComplianceApplication Получение сведений о результате рассмотрения заявления на получение Заключения о соответствии партии ВБР требованиям страны-импортера
ЭВС:9.3. ModifyWBRComplianceApplication Доработка заявления на получение Заключения о соответствии партии ВБР требованиям страны-импортера
ЭВС:13.1 FindLabResearchReport Проверка наличия протокола ЛИ по его номеру
ЭВС:13.5 GetLabResearchReportByUuid Предоставление сведений из протоколов лабораторных испытаний, оформляемых для получения ветеринарного сертификата
ЭВС:14.5. AttachAccountingDocuments Передача сведений (документов) в контексте заявки


DictionaryService

WSDL https://api.vetrf.ru/schema/platform/exportcenter/v2.2b-20230222/DictionaryService_v2.2.wsdl
URL точки доступа (тестовый контур) https://{server}:{port}/platform/exportcenter/services/2.2/DictionaryService

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

Сервис DictionaryService предназначен для получения справочной информации.

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

Номер операции Название операции / ссылка на спецификацию Описание операции
ЭВС:8.10 GetVeterinaryLaboratoryList Получение списка лабораторий
Источник — http://help.vetrf.ru/index.php?title=Exportcenter:Services:v2.2&oldid=35973