Установка цен (v2/price/set)
Назначение
Используется для установки цен на товары.
Пример запроса 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"
}
]
}
Цены по Виду цен 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": "Оптовая"
}
]
}
Успешный ответ
Пример успешного ответа
{
"message": "Prices were successfully updated",
"success": true,
"successInAllSubrequests": true,
"merchantId": "000000002"
}
Ответ с ошибкой
Пример ответа 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",
}
]
}
Описание параметров запроса
Параметр | Тип | Обязателен | Описание | |
---|---|---|---|---|
1 | externalSystemId | string | Нет | Код внешней системы откуда идет подключение к базе маркета |
2 | merchantId | string | Да | Внутренний идентификатор личного кабинета торговой площадки (Справочник "Подключения к личным кабинетам") |
prices | Массив | Да | Массив цен товаров для установки | |
3 | externalSystemProductId | string | Да | Идентификатор товара во внешней системы. Например, код справочника "Номенклатура" во внешней системе 1С. |
4 | price | decimal | Да | Цена товара. Запрещено передавать значение 0. |
5 | priceType | decimal | Нет | Тип цены торговой площадки. Допустимые значения:
Вид цены, соответствующий типу цены, устанавливается в настройках личного кабинета в системе РДВ:Маркет. |
6 | priceKind | decimal | Нет | Наименование вида цены для установки цены товара. Если вид цены не найден по наименованию, то не выполняется установка цен. Запрос считается не успешным. В массиве "errors" регистрируются описания ошибок для видов цен не найденных по наименованию. Должно быть заполнено одно из двух полей priceType или priceKind, иначе регистрируется ошибка. |
Описание параметров ответа
Параметр | Тип | Обязателен | Описание |
---|---|---|---|
merchantId | string | Да | Внутренний идентификатор личного кабинета торговой площадки |
message | string | Да | Описание результата запроса |
successInAllSubrequests | boolean | Да | Статус выполнения подзапросов метода
|
success | boolean | Да | Общий статус запроса
|
errors | Массив | Нет | Массив ошибок установки цен |
externalSystemProductId | string | Нет | Идентификатор товара во внешней системы |
priceType | string | Нет | Тип цены с ошибкой |
priceKind | string | Нет | Вида цены с ошибкой |
message | string | Да | Описание ошибки установки цены |