Список цен
Deprecated
Этот метод устарел. Вместо него используйте POST campaigns/{campaignId}/offer-prices.
Возвращает список цен, установленных вами на товары любым способом: например, через партнерский API или в файле с каталогом.
Примечание
Общее количество товаров считается по данным за последние семь дней (не включая сегодня) и не может быть выше 2 миллионов.
Способы установки цен описаны в Справке для продавцов.
⚙️ Лимит: (количество товаров партнера на витрине) * 25 товаров в сутки |
---|
Request
GET
https://api.partner.market.yandex.ru/campaigns/{campaignId}/offer-prices
Path parameters
Name |
Type |
Description |
campaignId* |
integer<int64> |
Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете. Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns. |
Query parameters
Name |
Type |
Description |
page_token |
string |
Идентификатор страницы c результатами. Если параметр не указан, возвращается самая старая страница. Рекомендуется передавать значение выходного параметра Если задан |
limit |
integer<int32> |
Количество товаров на одной странице.
|
archived |
boolean |
Фильтр по нахождению в архиве. |
Responses
200 OK
Список всех товаров с установленными ценами.
Body
{
"status": "OK",
"result": {
"offers": [
{
"id": "string",
"price": {
"value": 0,
"discountBase": 0,
"currencyId": "RUR",
"vat": 0
},
"marketSku": 0,
"updatedAt": "2022-12-29T18:02:01Z"
}
],
"paging": {
"nextPageToken": "string",
"prevPageToken": "string"
},
"total": 0
}
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
result |
Список цен на товары. |
OfferPriceListResponseDTO
Список цен на товары.
Name |
Type |
Description |
offers |
Страница списка. |
|
paging |
Информация о страницах результатов. |
|
total |
integer<int32> |
Количество всех цен магазина, измененных через API. |
OfferPriceResponseDTO
Информация об установленной цене на товар.
Name |
Type |
Description |
id |
string |
Идентификатор предложения из прайс-листа. |
price |
Цена с указанием скидки, валюты и времени последнего обновления. |
|
marketSku |
integer<int64> |
SKU на Маркете. |
updatedAt |
string<date-time> |
Дата и время последнего обновления цены на товар. |
ScrollingPagerDTO
Информация о страницах результатов.
Name |
Type |
Description |
nextPageToken |
string |
Идентификатор следующей страницы результатов. |
prevPageToken |
string |
Идентификатор предыдущей страницы результатов. |
PriceDTO
Цена с указанием скидки, валюты и времени последнего обновления.
Name |
Type |
Description |
value |
number |
Цена на товар. |
discountBase |
number |
Цена на товар без скидки. Число должно быть целым. Вы можете указать цену со скидкой от 5 до 75%. Передавайте этот параметр при каждом обновлении цены, если предоставляете скидку на товар. |
currencyId |
Валюта, в которой указана цена на товар. Возможно только значение
|
|
vat |
integer<int32> |
Идентификатор ставки НДС, применяемой для товара:
Если параметр не указан, используется ставка НДС, установленная в кабинете. |
CurrencyType
Коды валют. Возможные значения:
BYR
— белорусский рубль.KZT
— казахстанский тенге.RUR
— российский рубль.UAH
— украинская гривна.
Type |
Description |
Enum: |
400 Bad Request
Запрос содержит неправильные данные.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
ApiErrorDTO
Общий формат ошибки.
Name |
Type |
Description |
code* |
string |
Код ошибки. |
message |
string |
Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
404 Not Found
Запрашиваемый ресурс не найден.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Type |
Description |
status |
Тип ответа.
|
|
errors |
Список ошибок. |