Marketplace:Services:v1.0 - История изменений

Bondarenko-mv в 16:30, 16 октября 2026

2026-10-16T16:30:22Z

← Предыдущая версия		Версия от 16:30, 16 октября 2026
Строка 164:		Строка 164:
	\|}		\|}

	== Ошибки ~~профиля~~ ==		== Ошибки ==

	~~При отклонении заявки в её ответе возвращается статус <code>REJECTED</code>, а в элементе <code>apl~~:~~errors</code> — текст ошибки и её код.~~		Ошибки подсистемы обработки заявок бывают двух уровней:

	~~Профиль отклоняет заявку~~ в ~~следующих случаях~~:		* '''Транспортный уровень''' — fault'ы, задекларированные в WSDL профиля; возвращаются как SOAP-fault, а не в ответе заявки (не в <code>apl:errors</code>):

	* информационная система передаёт операцию, ~~отличную от трёх разрешённых~~ профилем;		{\| class="wikitable"
	* у информационной системы отсутствует право использования профиля.		! Fault !! Возвращает операция !! Описание
			\|-
			\| <code>AccessDeniedFault</code> \|\| <code>submitApplication</code>, <code>receiveApplicationResult</code> \|\| Доступ запрещён
			\|-
			\| <code>ApplicationNotFoundFault</code> \|\| <code>receiveApplicationResult</code> \|\| Заявка с указанным <code>applicationId</code> не найдена
			\|-
			\| <code>IncorrectRequestFault</code> \|\| <code>submitApplication</code>, <code>receiveApplicationResult</code> \|\| Некорректный запрос. Возникает, если запрос не соответствует требованиям, указанным в xsd
			\|-
			\| <code>InternalServiceFault</code> \|\| <code>submitApplication</code>, <code>receiveApplicationResult</code> \|\| Внутренняя ошибка сервиса
			\|-
			\| <code>UnknownServiceIdFault</code> \|\| <code>submitApplication</code> \|\| Неизвестный код сервиса (<code>serviceId</code>)
			\|-
			\| <code>UnsupportedApplicationDataTypeFault</code> \|\| <code>submitApplication</code> \|\| Тип данных заявки не поддерживается профилем
			\|}

	Остальные ошибки (валидация и выполнение отдельных операций) описаны в разделе «Коды ошибок» спецификации каждой операции.		* '''Уровень заявки''' — ошибки, которые приходят в ответе на заявку. При отклонении заявки статус — <code>REJECTED</code>, текст ошибки и её код — в элементе <code>apl:errors</code>. Профиль отклоняет заявку в следующих случаях:
			** информационная система передаёт операцию, отличную от трёх разрешённых профилем;
			** у информационной системы отсутствует право использования профиля.

			Остальные ошибки (валидация и выполнение отдельных операций) передаются тем же способом — описаны в разделе «Коды ошибок» спецификации каждой операции.

Bondarenko-mv в 18:46, 14 октября 2026

2026-10-14T18:46:04Z

Внесённые изменения

Bondarenko-mv в 15:37, 14 октября 2026

2026-10-14T15:37:23Z

Внесённые изменения

Bondarenko-mv: Bondarenko-mv переименовал страницу Справка:Marketplace:Services:v1.0 в Marketplace:Services:v1.0

2026-10-13T18:08:53Z

Bondarenko-mv переименовал страницу Справка:Marketplace:Services:v1.0 в Marketplace:Services:v1.0

← Предыдущая версия	Версия от 18:08, 13 октября 2026
(нет различий)

Bondarenko-mv: Bondarenko-mv переименовал страницу Участник:Bondarenko-mv в Справка:Marketplace:Services:v1.0

2026-10-13T18:08:42Z

Bondarenko-mv переименовал страницу Участник:Bondarenko-mv в Справка:Marketplace:Services:v1.0

← Предыдущая версия	Версия от 18:08, 13 октября 2026
(нет различий)

Bondarenko-mv в 17:55, 13 октября 2026

2026-10-13T17:55:44Z

Внесённые изменения

Bondarenko-mv в 17:39, 13 октября 2026

2026-10-13T17:39:44Z

← Предыдущая версия		Версия от 17:39, 13 октября 2026
Строка 3:		Строка 3:
	==Общие сведения==		==Общие сведения==

	Профиль Marketplace.Services v1.0 — интеграционный профиль ВетИС.API для информационных систем операторов посреднических цифровых платформ (маркетплейсов).		Профиль <code>Marketplace.Services v1.0</code> — интеграционный профиль ВетИС.API для информационных систем операторов посреднических цифровых платформ (маркетплейсов).

	Позволяет маркетплейсу получать из ФГИС «ВетИС» сведения, необходимые для проверки регистрации продавца, зарегистрированной номенклатуры товара и ветеринарного сопроводительного документа (ВСД).		Позволяет маркетплейсу получать из ФГИС «ВетИС» сведения, необходимые для проверки регистрации продавца, зарегистрированной номенклатуры товара и ветеринарного сопроводительного документа (ВСД).
Строка 13:		Строка 13:
	*v1.0 — Marketplace:Services:v1.0 (в разработке)		*v1.0 — Marketplace:Services:v1.0 (в разработке)

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

	{\| class="wikitable"		{\| class="wikitable"
Строка 23:		Строка 23:
	\|}		\|}

	==Структура XSD==		==Структура XSD ==

	Полные URI пространств имён указаны в самих XSD-схемах (передаются в составе пакета WSDL); в таблицах ниже приведены префиксы пространств.		Полные URI пространств имён указаны в самих XSD-схемах (передаются в составе пакета WSDL); в таблицах ниже приведены префиксы пространств.
Строка 32:		Строка 32:
	!XSD-схема!!Пространство имён		!XSD-схема!!Пространство имён
	\|-		\|-
	\|application_v2.1.xsd		\|
			application_v2.1.xsd
	\|xmlns:<b>apl</b>		\|xmlns:<b>apl</b>
	\|-		\|-
Строка 54:		Строка 55:

	{\| class="wikitable"		{\| class="wikitable"
	!XSD-схема!!Пространство имён		!XSD-схема!!
			Пространство имён
	\|-		\|-
	\|dictionary_v2.6.xsd		\|dictionary_v2.6.xsd
Строка 118:		Строка 120:
	\|}		\|}

	WSDL <code>ams-marketplace.service.wsdl</code> включает импорт ~~штатного~~ <code>ApplicationManagementService_v2.1.wsdl</code> и <code>marketplace.service.wsdl</code>.		WSDL <code>ams-marketplace.service.wsdl</code> включает импорт базового <code>ApplicationManagementService_v2.1.wsdl</code> и <code>marketplace.service.wsdl</code>.

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

	Работа с сервисом ApplicationManagementService выполняется в два шага, каждый шаг ~~выполняется синхронно~~:		Работа с сервисом ApplicationManagementService выполняется в два шага (каждый шаг — синхронный):

	*'''Шаг 1''' — подача заявки (<code>submitApplication</code>) с параметрами бизнес-операции и получение результата приёма заявки (идентификатор <code>applicationId</code>, статус <code>ACCEPTED</code>);		*'''Шаг 1''' — подача заявки (<code>submitApplication</code>) с параметрами бизнес-операции и получение результата приёма заявки (идентификатор <code>applicationId</code>, статус <code>ACCEPTED</code>);
Строка 129:		Строка 131:
	Каждый запрос дополнительно содержит <code>serviceId = marketplace.service:1.0</code> — общий код профиля, одинаковый для всех маркетплейсов.		Каждый запрос дополнительно содержит <code>serviceId = marketplace.service:1.0</code> — общий код профиля, одинаковый для всех маркетплейсов.

	Логин и пароль, выданные при регистрации системы в ВетИС.API, используются только для подключения к сервису (базовая аутентификация) и НЕ передаются в <code>initiator.login</code> — поле ~~<code>initiator.login</code>~~ заполняется логином пользователя ВетИС, от имени которого выполняется запрос.		Логин и пароль, выданные при регистрации системы в ВетИС.API, используются только для подключения к сервису (базовая аутентификация) и НЕ передаются в <code>initiator.login</code> — это поле заполняется логином пользователя ВетИС, от имени которого выполняется запрос.

	===Безопасность===		===Безопасность===
Строка 142:		Строка 144:
	#Юрлицо маркетплейса зарегистрировано в ФГИС «ВетИС» как хозяйствующий субъект;		#Юрлицо маркетплейса зарегистрировано в ФГИС «ВетИС» как хозяйствующий субъект;
	#Система маркетплейса зарегистрирована в ВетИС.API как клиент; выданы логин и пароль;		#Система маркетплейса зарегистрирована в ВетИС.API как клиент; выданы логин и пароль;
	#Выдан APIKey — ключ доступа к API;		# Выдан APIKey — ключ доступа к API;
	#Маркетплейсу выдано право на профиль Marketplace.Services;		#Маркетплейсу выдано право на профиль Marketplace.Services;
	#Для каждой заявки у маркетплейса есть <code>initiator.login</code> — логин зарегистрированного пользователя ВетИС, от имени которого выполняется запрос.		#Для каждой заявки у маркетплейса есть <code>initiator.login</code> — логин зарегистрированного пользователя ВетИС, от имени которого выполняется запрос.
Строка 149:		Строка 151:

	{\| class="wikitable"		{\| class="wikitable"
	!Код операции!!Название операции / ссылка на спецификацию!!Описание операции		!Код операции!!Название операции / ссылка на спецификацию !!Описание операции
	\|-		\|-
	\|AMS.MPLC.1.1		\|AMS.MPLC.1.1
Строка 159:		Строка 161:
	\|Проверка зарегистрированной номенклатуры товара		\|Проверка зарегистрированной номенклатуры товара
	\|-		\|-
	\|AMS.MPLC.1.3		\|
			AMS.MPLC.1.3
	\|[Marketplace:GetVetDocumentByUuid:v1.0]		\|[Marketplace:GetVetDocumentByUuid:v1.0]
	\|Получение ветеринарного сопроводительного документа (ВСД) по уникальному идентификатору		\|Получение ветеринарного сопроводительного документа (ВСД) по уникальному идентификатору
	\|}		\|}

Bondarenko-mv: Создание страницы - Marketplace.Services.v1.0.wiki

2026-10-13T17:18:40Z

Создание страницы - Marketplace.Services.v1.0.wiki

Новая страница

=Marketplace:Services:v1.0=

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

Профиль Marketplace.Services v1.0 — интеграционный профиль ВетИС.API для информационных систем операторов посреднических цифровых платформ (маркетплейсов).

Позволяет маркетплейсу получать из ФГИС «ВетИС» сведения, необходимые для проверки регистрации продавца, зарегистрированной номенклатуры товара и ветеринарного сопроводительного документа (ВСД).

Через профиль ФГИС «ВетИС» только передаёт сведения о регистрации. Решение о допуске продавца или карточки товара к размещению на платформе принимает сам маркетплейс.

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

*v1.0 — Marketplace:Services:v1.0 (в разработке)

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

{| class="wikitable"
!№!!Сервис!!Описание
|-
|1
|ApplicationManagementService
|Подсистема обработки заявок профиля
|}

==Структура XSD==

Полные URI пространств имён указаны в самих XSD-схемах (передаются в составе пакета WSDL); в таблицах ниже приведены префиксы пространств.

Типы данных транспортного уровня (заявочный режим):

{| class="wikitable"
!XSD-схема!!Пространство имён
|-
|application_v2.1.xsd
|xmlns:apl
|-
|application_ws_definitions_v2.1.xsd
|xmlns:def
|-
|base_ws_definitions_v2.1.xsd
|xmlns:bsdef
|}

Базовые типы данных:

{| class="wikitable"
!XSD-схема!!Пространство имён
|-
|base_v2.1.xsd
|xmlns:bs
|}

Прикладные типы данных:

{| class="wikitable"
!XSD-схема!!Пространство имён
|-
|dictionary_v2.6.xsd
|xmlns:dt
|-
|document_v2.6.xsd
|xmlns:vd
|-
|codelist_v2.6r12.xsd
|xmlns:cl
|}

Типы данных профиля Marketplace.Services:

{| class="wikitable"
!XSD-схема!!Пространство имён
|-
|marketplace_applications.xsd
|xmlns:mplc
|}

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

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

{|
| width="50%" valign="top" |
'''Продуктивный контур'''
{| class="wikitable"
|-
! scope="col" style="text-align:left;" |WSDL
|https://api.vetrf.ru/schema/platform/marketplace/v1.0b-last/ams-marketplace.service.wsdl
|-
! scope="col" style="text-align:left;" |URL точки доступа (Endpoint)
|https://api.vetrf.ru/platform/services/2.1/ApplicationManagementService
|-
! scope="col" style="text-align:left;" |Описание типов заявок
|включено в WSDL
|-
! scope="col" style="text-align:left;" |Код сервиса (serviceId)
|marketplace.service:1.0
|-
|}

| width="50%" valign="top" |
'''Тестовый контур'''
{| class="wikitable"
|-
! scope="col" style="text-align:left;" |WSDL
|https://api2.vetrf.ru:8002/schema/platform/marketplace/v1.0b-last/ams-marketplace.service.wsdl
|-
! scope="col" style="text-align:left;" |URL точки доступа (Endpoint)
|https://api2.vetrf.ru:8002/platform/services/2.1/ApplicationManagementService
|-
! scope="col" style="text-align:left;" |Описание типов заявок
|включено в WSDL
|-
! scope="col" style="text-align:left;" |Код сервиса (serviceId)
|marketplace.service:1.0
|-
|}

|}

WSDL <code>ams-marketplace.service.wsdl</code> включает импорт штатного <code>ApplicationManagementService_v2.1.wsdl</code> и <code>marketplace.service.wsdl</code>.

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

Работа с сервисом ApplicationManagementService выполняется в два шага, каждый шаг выполняется синхронно:

*'''Шаг 1''' — подача заявки (<code>submitApplication</code>) с параметрами бизнес-операции и получение результата приёма заявки (идентификатор <code>applicationId</code>, статус <code>ACCEPTED</code>);
*'''Шаг 2''' — подача запроса на получение результата (<code>receiveApplicationResult</code>) по <code>applicationId</code>: результат бизнес-операции (статус <code>COMPLETED</code>) либо сведения об ошибке (статус <code>REJECTED</code>).

Каждый запрос дополнительно содержит <code>serviceId = marketplace.service:1.0</code> — общий код профиля, одинаковый для всех маркетплейсов.

Логин и пароль, выданные при регистрации системы в ВетИС.API, используются только для подключения к сервису (базовая аутентификация) и НЕ передаются в <code>initiator.login</code> — поле <code>initiator.login</code> заполняется логином пользователя ВетИС, от имени которого выполняется запрос.

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

*Доступ к сервису ограничивается с помощью ключей доступа к API (APIKey).
*Ключи доступа предоставляются при регистрации информационной системы маркетплейса в ВетИС.API как клиента.
*APIKey идентифицирует информационную систему маркетплейса.
*Перед проверкой APIKey выполняется базовая аутентификация с помощью логина и пароля, выданных при регистрации.

===Предварительные условия до первого запроса===

#Юрлицо маркетплейса зарегистрировано в ФГИС «ВетИС» как хозяйствующий субъект;
#Система маркетплейса зарегистрирована в ВетИС.API как клиент; выданы логин и пароль;
#Выдан APIKey — ключ доступа к API;
#Маркетплейсу выдано право на профиль Marketplace.Services;
#Для каждой заявки у маркетплейса есть <code>initiator.login</code> — логин зарегистрированного пользователя ВетИС, от имени которого выполняется запрос.

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

{| class="wikitable"
!Код операции!!Название операции / ссылка на спецификацию!!Описание операции
|-
|AMS.MPLC.1.1
|[Marketplace:CheckBusinessEntity:v1.0]
|Проверка регистрации хозяйствующего субъекта (продавца)
|-
|AMS.MPLC.1.2
|[Marketplace:GetProductItemByGuid:v1.0]
|Проверка зарегистрированной номенклатуры товара
|-
|AMS.MPLC.1.3
|[Marketplace:GetVetDocumentByUuid:v1.0]
|Получение ветеринарного сопроводительного документа (ВСД) по уникальному идентификатору
|}

==Ошибки профиля==

При отклонении заявки в её ответе возвращается статус <code>REJECTED</code>, а в элементе <code>apl:errors</code> — текст ошибки и её код.

Профиль отклоняет заявку в следующих случаях:

*информационная система передаёт операцию, отличную от трёх разрешённых профилем;
*у информационной системы отсутствует право использования профиля.

Остальные ошибки (валидация и выполнение отдельных операций) описаны в разделе «Коды ошибок» спецификации каждой операции.