Назначение

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

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

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

Цены по Типу цен площадки

Установка цены по типу цены товарной площадки (базовая, без скидки, премиум)

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

POST /ExternalExchange/v2/price/set HTTP/1.1 
Content-Type: application/json;
{
  "externalSystemId": "000000002",
  "merchantId": "000000002",
  "prices": [
    {
      "externalSystemProductId": "sk-01232220",
      "price": 420,
      "priceType": "basic"
    },
    {
      "externalSystemProductId": "sk-01232220",
      "price": 500,
      "priceType": "noDiscount"
    }
  ]
}
JS

Цены по Виду цен 1С

Установка цен номенклатуры по наименованию видов цен

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

POST /ExternalExchange/v2/price/set HTTP/1.1 
Content-Type: application/json;
{
  "externalSystemId": "000000002",
  "merchantId": "000000002",
  "prices": [
    {
      "externalSystemProductId": "sk-01232220",
      "price": 420,
      "priceKind": "Розничная"
    },
    {
      "externalSystemProductId": "sk-0123220",
      "price": 300,
      "priceKind": "Оптовая"
    }
  ]
}
JS

Успешный ответ

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

{
	"message": "Prices were successfully updated",
	"success": true,
	"successInAllSubrequests": true,
	"merchantId": "000000002"
}
JS

Ответ с ошибкой

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

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

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


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

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


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

Тип цены торговой площадки. Допустимые значения:

  • basic - базовая цена
  • noDiscount - без скидки
  • premium - премиум цен

Вид цены, соответствующий типу цены, устанавливается в настройках личного кабинета в системе РДВ:Маркет.

6priceKinddecimalНет

Наименование вида цены для установки цены товара.

Если вид цены не найден по наименованию, то не выполняется установка цен. Запрос считается не успешным.

В массиве "errors" регистрируются описания ошибок для видов цен не найденных по наименованию.

Должно быть заполнено одно из двух полей priceType или priceKind, иначе регистрируется ошибка.

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

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

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

messagestringДа

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

successInAllSubrequestsbooleanДа

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

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

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

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

Массив ошибок установки цен

externalSystemProductIdstringНетИдентификатор товара во внешней системы
priceTypestringНетТип цены с ошибкой
priceKindstringНетВида цены с ошибкой
messagestringДаОписание ошибки установки цены