Назначение

Используется для установки цен на товары.

Пример запроса JSON (v1)

Пример демонстрирует вызов метода /price/set.

Пример запроса

POST /ExternalExchange/v1/price/set HTTP/1.1 
Content-Type: application/json; 

{
	"externalSystemId": "000000002",
	"merchantId": "000000002",
	"priceList": [
		{
			"externalSystemProductId": "sk-01232220",
			"marketplaceProductId": "",
			"price": 420,
			"ozonOldPrice": 350,
			"ozonPremiumPrice": 299
		}
	]
}
JS

Пример успешного ответа

{
	"message": "Prices were successfully updated",
	"success": true,
	"successInAllSubrequests": true,
	"merchantId": "000000002",
	"resultList": [
		{
			"message": "",
			"success": true,
			"marketplaceProductId": "",
			"externalSystemProductId": "sk-01232220"
		}
	]
}
JS

Пример ответа c ошибками

{
	"message": "Request was valid but all products have errors",
	"success": false,
	"successInAllSubrequests": false,
	"merchantId": "000000002",
	"resultList": [
		{
			"message": "Product not found by merchantId = 000000002, externalSystemId = 123, marketplaceProductId = and externalSystemProductId = sk-01232220",
			"success": false,
			"marketplaceProductId": "",
			"externalSystemProductId": "sk-01232220"
		}
	]
}
JS

Описание параметров запроса


ПараметрТипОбязателенОписание
1externalSystemIdstringНетКод внешней системы откуда идет подключение к базе маркета
2merchantIdstringДа

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


priceListМассивДаМассив цен товаров
3externalSystemProductIdstringНетИдентификатор товара во внешней системы. Например, код справочника "Номенклатура" во внешней системе 1С.
4marketplaceProductIdstringНетИдентификатор товара торговой площадки
5pricedecimalДаЦена товара. Запрещено передавать значение 0.
6ozonOldPricedecimalДа

(Используется при обмене с OZON) Цена товара без скидки

7ozonPremiumPricedecimalДа(Используется при обмене с OZON) Цена товара "Premium"

Описание параметров ответа

ПараметрТипОбязателенОписание
merchantIdstringДа

Внутренний идентификатор личного кабинета торговой площадки

messagestringДа

Описание результата запроса:

  • "Prices were successfully updated" - все цены установлены успешно
  • "Prices for some products was not updated" - на некоторые товары не удалось установить цены
  • "Some product entries contain empty marketplaceProductId and empty externalSystemProductId" - не заполнен хотя бы один идентификатор товара
successInAllSubrequestsbooleanДа

Статус выполнения подзапросов метода

  • true - все подзапросы метода выполнены успешно
  • false - подзапрос выполнен с ошибкой. Описание ошибки см. в параметре message
successbooleanДа

Общий статус запроса

  • true - запрос успешный
  • false - выполнен с ошибкой
resultListМассивНет

Массив с результатами установки цен по товарам

externalSystemProductIdstringНетИдентификатор товара во внешней системы. Например, код справочника "Номенклатура" во внешней системе 1С.
marketplaceProductIdstringНетИдентификатор товара торговой площадки
messagestringДа

Описание результата запроса по позиции товара

  • (Пусто) - ошибок нет
  • "Could not set ZERO price for product with externalSystemProductId = %1, marketplaceProductId = %2, merchantId = %3 and externalSystemId = %4" - пустое значение цены (price)
  • "For merchantId = %1 and externalSystemId = %2 there are more than one entry with marketplaceProductId = %3 and externalSystemProductId = %4 in request" - передан неуникальный идентификатор товара
  • "Product not found by merchantId = %1, externalSystemId = %2, marketplaceProductId = %3 and externalSystemProductId = %4" - товар не найден по идентификатору
  • "Internal error" - внутренняя ошибка сервиса
successbooleanДа

Статус выполнения изменений по позиции товара

  • true - запрос успешный
  • false - выполнен с ошибкой