Marketplace:Services:v1.0: различия между версиями
Перейти к навигации
Перейти к поиску
м Bondarenko-mv переименовал страницу Справка:Marketplace:Services:v1.0 в Marketplace:Services:v1.0 |
Нет описания правки |
||
| Строка 3: | Строка 3: | ||
== Общие сведения == | == Общие сведения == | ||
Профиль Marketplace.Services v1.0 — интеграционный профиль ВетИС.API для информационных систем операторов посреднических цифровых платформ (маркетплейсов). Позволяет маркетплейсу получать из ФГИС «ВетИС» сведения, необходимые для проверки регистрации продавца, зарегистрированной номенклатуры товара и ветеринарного сопроводительного документа (ВСД). | Профиль Marketplace.Services v1.0 — интеграционный профиль ВетИС.API для информационных систем операторов посреднических цифровых платформ (маркетплейсов). | ||
Позволяет маркетплейсу получать из ФГИС «ВетИС» сведения, необходимые для проверки регистрации продавца, зарегистрированной номенклатуры товара и ветеринарного сопроводительного документа (ВСД). | |||
Через профиль ФГИС «ВетИС» только передаёт сведения о регистрации. Решение о допуске продавца или карточки товара к размещению на платформе принимает сам маркетплейс. | Через профиль ФГИС «ВетИС» только передаёт сведения о регистрации. Решение о допуске продавца или карточки товара к размещению на платформе принимает сам маркетплейс. | ||
| Строка 69: | Строка 71: | ||
! XSD-схема !! Пространство имён | ! XSD-схема !! Пространство имён | ||
|- | |- | ||
| | | marketplace_applications_v1.0.xsd | ||
| xmlns:<b>mplc</b> | |xmlns:<b>mplc</b> | ||
|} | |} | ||
== ApplicationManagementService (подсистема обработки заявок) == | ==ApplicationManagementService (подсистема обработки заявок)== | ||
=== Параметры подключения === | ===Параметры подключения === | ||
{| | {| | ||
| width="50%" valign="top" | | | width="50%" valign="top" | | ||
'''Продуктивный контур''' | '''Продуктивный контур''' | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! scope="col" style="text-align:left;" | WSDL | ! scope="col" style="text-align:left;" | | ||
| https://api.vetrf.ru/schema/platform/marketplace/v1. | WSDL | ||
|https://api.vetrf.ru/schema/platform/marketplace/v1.0b-last/ams-marketplace.service_v1.0.wsdl | |||
|- | |- | ||
! scope="col" style="text-align:left;"| URL точки доступа (Endpoint) | ! scope="col" style="text-align:left;" |URL точки доступа (Endpoint) | ||
| https://api.vetrf.ru/platform/services/2.1/ApplicationManagementService | |https://api.vetrf.ru/platform/services/2.1/ApplicationManagementService | ||
|- | |- | ||
! scope="col" style="text-align:left;"| Описание типов заявок | ! scope="col" style="text-align:left;" |Описание типов заявок | ||
| включено в WSDL | |включено в WSDL | ||
|- | |- | ||
! scope="col" style="text-align:left;"| Код сервиса (serviceId) | ! scope="col" style="text-align:left;" |Код сервиса (serviceId) | ||
| marketplace.service:1.0 | |marketplace.service:1.0 | ||
|- | |- | ||
|} | |} | ||
| width="50%" valign="top" | | | width="50%" valign="top" | | ||
'''Тестовый контур''' | '''Тестовый контур''' | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
! scope="col" style="text-align:left;" | WSDL | ! scope="col" style="text-align:left;" |WSDL | ||
| https://api2.vetrf.ru:8002/schema/platform/marketplace/v1. | |https://api2.vetrf.ru:8002/schema/platform/marketplace/v1.0b-last/ams-marketplace.service_v1.0.wsdl | ||
|- | |- | ||
! scope="col" style="text-align:left;"| URL точки доступа (Endpoint) | ! scope="col" style="text-align:left;" |URL точки доступа (Endpoint) | ||
| https://api2.vetrf.ru:8002/platform/services/2.1/ApplicationManagementService | |https://api2.vetrf.ru:8002/platform/services/2.1/ApplicationManagementService | ||
|- | |- | ||
! scope="col" style="text-align:left;"| Описание типов заявок | ! scope="col" style="text-align:left;" | Описание типов заявок | ||
| включено в WSDL | | включено в WSDL | ||
|- | |- | ||
! scope="col" style="text-align:left;"| Код сервиса (serviceId) | ! scope="col" style="text-align:left;" |Код сервиса (serviceId) | ||
| marketplace.service:1.0 | |marketplace.service:1.0 | ||
|- | |- | ||
|} | |} | ||
| Строка 118: | Строка 119: | ||
|} | |} | ||
WSDL <code>ams-marketplace. | WSDL <code>ams-marketplace.service_v1.0.wsdl</code> включает импорт базового <code>ApplicationManagementService_v2.1.wsdl</code> и <code>marketplace.service_v1.0.wsdl</code>. | ||
=== Принципы взаимодействия === | ===Принципы взаимодействия=== | ||
Работа с сервисом ApplicationManagementService выполняется в два шага (каждый шаг — синхронный): | Работа с сервисом ApplicationManagementService выполняется в два шага (каждый шаг — синхронный): | ||
* '''Шаг 1''' — подача заявки (<code>submitApplication</code>) с параметрами бизнес-операции и получение результата приёма заявки (идентификатор <code>applicationId</code>, статус <code>ACCEPTED</code>); | *'''Шаг 1''' — подача заявки (<code>submitApplication</code>) с параметрами бизнес-операции и получение результата приёма заявки (идентификатор <code>applicationId</code>, статус <code>ACCEPTED</code>); | ||
* '''Шаг 2''' — подача запроса на получение результата (<code>receiveApplicationResult</code>) по <code>applicationId</code>: результат бизнес-операции (статус <code>COMPLETED</code>) либо сведения об ошибке (статус <code>REJECTED</code>). | *'''Шаг 2''' — подача запроса на получение результата (<code>receiveApplicationResult</code>) по <code>applicationId</code>: результат бизнес-операции (статус <code>COMPLETED</code>) либо сведения об ошибке (статус <code>REJECTED</code>). | ||
Каждый запрос дополнительно содержит <code>serviceId = marketplace.service:1.0</code> — общий код профиля, одинаковый для всех маркетплейсов. | Каждый запрос дополнительно содержит <code>serviceId = marketplace.service:1.0</code> — общий код профиля, одинаковый для всех маркетплейсов. | ||
| Строка 131: | Строка 132: | ||
Логин и пароль, выданные при регистрации системы в ВетИС.API, используются только для подключения к сервису (базовая аутентификация) и НЕ передаются в <code>initiator.login</code> — это поле заполняется логином пользователя ВетИС, от имени которого выполняется запрос. | Логин и пароль, выданные при регистрации системы в ВетИС.API, используются только для подключения к сервису (базовая аутентификация) и НЕ передаются в <code>initiator.login</code> — это поле заполняется логином пользователя ВетИС, от имени которого выполняется запрос. | ||
=== Безопасность === | ===Безопасность=== | ||
* Доступ к сервису ограничивается с помощью ключей доступа к API (APIKey). | *Доступ к сервису ограничивается с помощью ключей доступа к API (APIKey). | ||
* Ключи доступа предоставляются при регистрации информационной системы маркетплейса в ВетИС.API как клиента. | *Ключи доступа предоставляются при регистрации информационной системы маркетплейса в ВетИС.API как клиента. | ||
* APIKey идентифицирует информационную систему маркетплейса. | *APIKey идентифицирует информационную систему маркетплейса. | ||
* Перед проверкой APIKey выполняется базовая аутентификация с помощью логина и пароля, выданных при регистрации. | *Перед проверкой APIKey выполняется базовая аутентификация с помощью логина и пароля, выданных при регистрации. | ||
=== Предварительные условия до первого запроса === | ===Предварительные условия до первого запроса=== | ||
# Юрлицо маркетплейса зарегистрировано в ФГИС «ВетИС» как хозяйствующий субъект; | #Юрлицо маркетплейса зарегистрировано в ФГИС «ВетИС» как хозяйствующий субъект; | ||
# Система маркетплейса зарегистрирована в ВетИС.API как клиент; выданы логин и пароль; | #Система маркетплейса зарегистрирована в ВетИС.API как клиент; выданы логин и пароль; | ||
# Выдан APIKey — ключ доступа к API; | #Выдан APIKey — ключ доступа к API; | ||
# Маркетплейсу выдано право на профиль Marketplace.Services; | #Маркетплейсу выдано право на профиль Marketplace.Services; | ||
# Для каждой заявки у маркетплейса есть <code>initiator.login</code> — логин зарегистрированного пользователя ВетИС, от имени которого выполняется запрос. | #Для каждой заявки у маркетплейса есть <code>initiator.login</code> — логин зарегистрированного пользователя ВетИС, от имени которого выполняется запрос. | ||
=== Операции, выполняемые через ApplicationManagementService === | ===Операции, выполняемые через ApplicationManagementService=== | ||
{| class="wikitable" | {| class="wikitable" | ||
! Код операции !! Название операции / ссылка на спецификацию !! Описание операции | ! Код операции!!Название операции / ссылка на спецификацию!!Описание операции | ||
|- | |- | ||
| AMS.MPLC.1.1 | |AMS.MPLC.1.1 | ||
| [Marketplace:CheckBusinessEntity:v1.0] | |[Marketplace:CheckBusinessEntity:v1.0] | ||
| Проверка регистрации хозяйствующего субъекта (продавца) | |Проверка регистрации хозяйствующего субъекта (продавца) | ||
|- | |- | ||
| AMS.MPLC.1.2 | |AMS.MPLC.1.2 | ||
| [Marketplace:GetProductItemByGuid:v1.0] | |[Marketplace:GetProductItemByGuid:v1.0] | ||
| Проверка зарегистрированной номенклатуры товара | |Проверка зарегистрированной номенклатуры товара | ||
|- | |- | ||
| AMS.MPLC.1.3 | |AMS.MPLC.1.3 | ||
| [Marketplace:GetVetDocumentByUuid:v1.0] | |[Marketplace:GetVetDocumentByUuid:v1.0] | ||
| Получение ветеринарного сопроводительного документа (ВСД) по уникальному идентификатору | |Получение ветеринарного сопроводительного документа (ВСД) по уникальному идентификатору | ||
|} | |} | ||
== Ошибки профиля == | ==Ошибки профиля== | ||
При отклонении заявки в её ответе возвращается статус <code>REJECTED</code>, а в элементе <code>apl:errors</code> — текст ошибки и её код. | При отклонении заявки в её ответе возвращается статус <code>REJECTED</code>, а в элементе <code>apl:errors</code> — текст ошибки и её код. | ||
| Строка 170: | Строка 171: | ||
Профиль отклоняет заявку в следующих случаях: | Профиль отклоняет заявку в следующих случаях: | ||
* информационная система передаёт операцию, отличную от трёх разрешённых профилем; | *информационная система передаёт операцию, отличную от трёх разрешённых профилем; | ||
* у информационной системы отсутствует право использования профиля. | *у информационной системы отсутствует право использования профиля. | ||
Остальные ошибки (валидация и выполнение отдельных операций) описаны в разделе «Коды ошибок» спецификации каждой операции. | Остальные ошибки (валидация и выполнение отдельных операций) описаны в разделе «Коды ошибок» спецификации каждой операции. | ||
Версия от 15:37, 14 октября 2026
Marketplace:Services:v1.0
Общие сведения
Профиль Marketplace.Services v1.0 — интеграционный профиль ВетИС.API для информационных систем операторов посреднических цифровых платформ (маркетплейсов).
Позволяет маркетплейсу получать из ФГИС «ВетИС» сведения, необходимые для проверки регистрации продавца, зарегистрированной номенклатуры товара и ветеринарного сопроводительного документа (ВСД).
Через профиль ФГИС «ВетИС» только передаёт сведения о регистрации. Решение о допуске продавца или карточки товара к размещению на платформе принимает сам маркетплейс.
Версии профиля API
- v1.0 — Marketplace:Services:v1.0 (в разработке)
Предоставляемые сервисы
| № | Сервис | Описание |
|---|---|---|
| 1 | ApplicationManagementService | Подсистема обработки заявок профиля |
Структура XSD
Полные URI пространств имён указаны в самих XSD-схемах (передаются в составе пакета WSDL); в таблицах ниже приведены префиксы пространств.
Типы данных транспортного уровня (заявочный режим):
| XSD-схема | Пространство имён |
|---|---|
| application_v2.1.xsd | xmlns:apl |
| application_ws_definitions_v2.1.xsd | xmlns:def |
| base_ws_definitions_v2.1.xsd | xmlns:bsdef |
Базовые типы данных:
| XSD-схема | Пространство имён |
|---|---|
| base_v2.1.xsd | xmlns:bs |
Прикладные типы данных:
| XSD-схема | Пространство имён |
|---|---|
| dictionary_v2.6.xsd | xmlns:dt |
| document_v2.6.xsd | xmlns:vd |
| codelist_v2.6r12.xsd | xmlns:cl |
Типы данных профиля Marketplace.Services:
| XSD-схема | Пространство имён |
|---|---|
| marketplace_applications_v1.0.xsd | xmlns:mplc |
ApplicationManagementService (подсистема обработки заявок)
Параметры подключения
|
Продуктивный контур
|
Тестовый контур
|
WSDL ams-marketplace.service_v1.0.wsdl включает импорт базового ApplicationManagementService_v2.1.wsdl и marketplace.service_v1.0.wsdl.
Принципы взаимодействия
Работа с сервисом ApplicationManagementService выполняется в два шага (каждый шаг — синхронный):
- Шаг 1 — подача заявки (
submitApplication) с параметрами бизнес-операции и получение результата приёма заявки (идентификаторapplicationId, статусACCEPTED); - Шаг 2 — подача запроса на получение результата (
receiveApplicationResult) поapplicationId: результат бизнес-операции (статусCOMPLETED) либо сведения об ошибке (статусREJECTED).
Каждый запрос дополнительно содержит serviceId = marketplace.service:1.0 — общий код профиля, одинаковый для всех маркетплейсов.
Логин и пароль, выданные при регистрации системы в ВетИС.API, используются только для подключения к сервису (базовая аутентификация) и НЕ передаются в initiator.login — это поле заполняется логином пользователя ВетИС, от имени которого выполняется запрос.
Безопасность
- Доступ к сервису ограничивается с помощью ключей доступа к API (APIKey).
- Ключи доступа предоставляются при регистрации информационной системы маркетплейса в ВетИС.API как клиента.
- APIKey идентифицирует информационную систему маркетплейса.
- Перед проверкой APIKey выполняется базовая аутентификация с помощью логина и пароля, выданных при регистрации.
Предварительные условия до первого запроса
- Юрлицо маркетплейса зарегистрировано в ФГИС «ВетИС» как хозяйствующий субъект;
- Система маркетплейса зарегистрирована в ВетИС.API как клиент; выданы логин и пароль;
- Выдан APIKey — ключ доступа к API;
- Маркетплейсу выдано право на профиль Marketplace.Services;
- Для каждой заявки у маркетплейса есть
initiator.login— логин зарегистрированного пользователя ВетИС, от имени которого выполняется запрос.
Операции, выполняемые через ApplicationManagementService
| Код операции | Название операции / ссылка на спецификацию | Описание операции |
|---|---|---|
| AMS.MPLC.1.1 | [Marketplace:CheckBusinessEntity:v1.0] | Проверка регистрации хозяйствующего субъекта (продавца) |
| AMS.MPLC.1.2 | [Marketplace:GetProductItemByGuid:v1.0] | Проверка зарегистрированной номенклатуры товара |
| AMS.MPLC.1.3 | [Marketplace:GetVetDocumentByUuid:v1.0] | Получение ветеринарного сопроводительного документа (ВСД) по уникальному идентификатору |
Ошибки профиля
При отклонении заявки в её ответе возвращается статус REJECTED, а в элементе apl:errors — текст ошибки и её код.
Профиль отклоняет заявку в следующих случаях:
- информационная система передаёт операцию, отличную от трёх разрешённых профилем;
- у информационной системы отсутствует право использования профиля.
Остальные ошибки (валидация и выполнение отдельных операций) описаны в разделе «Коды ошибок» спецификации каждой операции.