Exportcenter:Services
Версия от 03:29, 7 сентября 2021; Romanov-av-170814 (обсуждение | вклад) (→Подсистема работы со справочниками и реестрами)
Предоставляемые сервисы
Подсистема обработки заявок (ApplicationManagementService)
Версия | WSDL | serviceId |
---|---|---|
v2 | https://api.vetrf.ru/schema/platform/exportcenter/v2.0b-20210906/ams-exportcenter.service_v2.0.wsdl |
Принципы взаимодействия
Работа с сервисом 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 предназначен для работы с реестром хозяйствующих субъектов и предприятий.