Exportcenter:Services: различия между версиями
Перейти к навигации
Перейти к поиску
| Строка 235: | Строка 235: | ||
|| Получение списка записей реестров КД и КГМО | || Получение списка записей реестров КД и КГМО | ||
|- | |- | ||
| style="text-align:center;" |'''ССП:1.2<br/> | | style="text-align:center;" |'''ССП:1.2<br/>ССП:2.2''' | ||
|| [[exportcenter:getRegistryEntryByGuid:v2.0|GetRegistryEntryByGuid]] | || [[exportcenter:getRegistryEntryByGuid:v2.0|GetRegistryEntryByGuid]] | ||
|| Получение записи реестра ЛП, ФС, КД или КГМО по ее идентификатору | || Получение записи реестра ЛП, ФС, КД или КГМО по ее идентификатору | ||
|- | |- | ||
|} | |} | ||
Версия 16:04, 23 января 2022
Предоставляемые сервисы
| Сервис | Описание |
|---|---|
| ApplicationManagementService | Подсистема обработки заявок |
| EnterpriseService | Сервис реестров хозяйствующих субъектов и предприятий |
| ProductService | Сервис реестров категорий продукции |
| DictionaryService | Сервис справочной информации |
| FMPRegistryService | Сервис государственного реестра лекарственных препаратов ветеринарного применения, фармацевтических субстанций, кормов и кормовых добавок |
Подсистема обработки заявок (ApplicationManagementService)
| WSDL | https://api.vetrf.ru/schema/platform/exportcenter/v2.0b-20211126/ams-exportcenter.service_v2.0.wsdl |
|---|---|
| URL точки доступа (Endpoint) | https://{server}:{port}/platform/services/2.0/ApplicationManagementService |
| Описание типов заявок | включено в WSDL |
| Код сервиса (serviceId) | exportcenter.service:2.0 |
Принципы взаимодействия
Работа с сервисом ApplicationManagementService реализована по псевдо-асинхронному принципу и осуществляется в два шага, оба из которых выполняются синхронно:
- 1 шаг – подача запроса с заявкой на выполнение бизнес-операции и получение результата приема заявки (идентификатора заявки);
- 2 шаг – подача запроса на получение результата обработки заявки или результата выполнения бизнес-операции с использованием полученного на шаге 1 идентификатора заявки.
Для данной схемы действуют следующие правила:
- Взаимодействие реализуется посредством запросов внешних информационных систем к ApplicationManagementService.
- Любая операция в рамках информационного взаимодействия представляет собой заявку на выполнение бизнес-операции. Заявка от внешней информационной системы попадает в ApplicationManagementService, проходит форматно-логический контроль, регистрацию (ей присваивается уникальный идентификатор), маршрутизируется на целевой внутренний сервис, который выполняет операцию.
- ApplicationManagementService позволяет отслеживать состояние данной заявки и получать результат ее выполнения.
Безопасность
- Доступ к сервису ApplicationManagementService ограничивается с помощью ключей доступа к API (APIKey).
- Ключи доступа предоставляются при регистрации внешней информационной системы в качестве клиента "Ветис.API".
- APIKey - ключ, который идентифицирует клиентскую информационную систему. В сочетании с идентификатором пользователя (issuerId), этот ключ позволяет получать доступ к информации о клиенте сервиса.
- Перед проверкой APIKey производится базовая аутентификация с помощью логина и пароля, предоставляемых в ответном письме при получении доступа. Процесс авторизации описан здесь.
Обработка заявок в ApplicationManagementService
- Общий принцип работы с ApplicationManagementService, а также спецификации запросов/ответов подачи заявок и получения результатов обработки заявок, описаны здесь.
Операции, выполняемые через ApplicationManagementService
| Номер операции | Название операции / ссылка на спецификацию | Описание операции |
|---|---|---|
| 1.1 | RegisterLegalEntityApplication | Направление заявки на регистрацию хозяйствующего субъекта и его уполномоченных лиц в ФГИС ВетИС для осуществления процедуры экспорта |
| 1.2 | CheckRegisterLegalEntityApplication | Получение сведений о результате рассмотрения заявки на регистрацию хозяйствующего субъекта |
| 2.1 | GetVetDocumentByUuid | Получение предэкспортного ВСД по его идентификатору |
| 2.2 | GetPreExportVetDocumentList | Получение списка предэкспортных ВСД на указанную партию продукции |
| 3.2 | GetExportVeterinaryPermitList | Получение списка действующих ветеринарных разрешений, выданных экспортеру |
| 4.1 | SendExportCertificateApplication | Направление заявки на оформление ветеринарных сопроводительных документов на экспорт |
| 4.2 | CheckExportCertificateApplication | Получение сведений о результате рассмотрения заявки на оформление ветеринарных сопроводительных документов |
Подсистема работы со справочниками и реестрами
EnterpriseService
Общие сведения
Сервис EnterpriseService предназначен для работы с реестром хозяйствующих субъектов и предприятий.
Операции, выполняемые через EnterpriseService
| Номер операции | Название операции / ссылка на спецификацию | Описание операции |
|---|---|---|
| 5.1 | GetLegalEntityList | Получение перечня хозяйствующих субъектов |
| 5.2 | GetLegalEntityChangesList | Получение истории изменений реестра хозяйствующих субъектов |
| 6.1 | GetActivityLocationList | Получение перечня мест осуществления деятельности (площадок отгрузки) |
| 6.2 | GetExportClearancePointList | Получение перечня мест оформления ЭВС |
| 7.1 | GetCertifiedProducerList | Получение полного списка предприятий, входящих в реестр экспортеров |
ProductService
| WSDL | https://api.vetrf.ru/schema/platform/exportcenter/v2.0b-20211126/ProductService_v2.0.wsdl |
|---|---|
| URL точки доступа (тестовый контур) | https://api2.vetrf.ru:8002/platform/exportcenter/services/2.0/ProductService |
Общие сведения
Сервис ProductService предназначен для получения реестра категорий продукции.
Операции, выполняемые через ProductService
| Номер операции | Название операции / ссылка на спецификацию | Описание операции |
|---|---|---|
| 8.1 | GetProductByTypeList | Получение полного перечня продукции по типу |
| 8.2 | GetProductChangesList | Получение истории изменений перечня продукции за указанный период |
| 8.3 | GetSubProductByProductList | Получение полного перечня видов продукции по указанному 2-ому уровню справочника |
| 8.4 | GetSubProductChangesList | Получение истории изменений перечня видов продукции за указанный период |
DictionaryService
Общие сведения
Сервис DictionaryService предназначен для получения справочной информации.
Операции, выполняемые через DictionaryService
| Номер операции | Название операции / ссылка на спецификацию | Описание операции |
|---|---|---|
| 8.5 | GetUnitList | Получение полного перечня единиц измерений |
| 8.6 | GetVeterinaryBCPList | Получение перечня ПВКП |
FMPRegistryService
Общие сведения
Сервис FMPRegistryService предназначен для получения сведений из государственного реестра лекарственных препаратов ветеринарного назначения, фармацевтических субстанций, кормов и кормовых добавок.
Операции, выполняемые через FMPRegistryService
| Номер операции | Название операции / ссылка на спецификацию | Описание операции |
|---|---|---|
| ССП:1.1 | GetMedicineRegistryEntryList | Получение списка записей реестров ЛП и ФС |
| ССП:2.1 | GetFodderRegistryEntryList | Получение списка записей реестров КД и КГМО |
| ССП:1.2 ССП:2.2 |
GetRegistryEntryByGuid | Получение записи реестра ЛП, ФС, КД или КГМО по ее идентификатору |
