Просмотр цен на указанные товары в конкретном магазине
Метод доступен для всех моделей.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- pricing — Управление ценами
- pricing:read-only — Просмотр цен
- all-methods — Полное управление кабинетом
- all-methods:read-only — Просмотр всех данных
Возвращает список цен на указанные товары в магазине.
Метод только для отдельных магазинов
Используйте этот метод, только если в кабинете установлены уникальные цены в отдельных магазинах.
Для просмотра цен, которые действуют во всех магазинах, используйте POST businesses/{businessId}/offer-mappings.
⚙️ Лимит: 150 000 товаров в минуту |
---|
Request
POST
https://api.partner.market.yandex.ru/campaigns/{campaignId}/offer-prices
Path parameters
Name |
Description |
campaignId* |
Type: integer<int64> Идентификатор кампании. Его можно узнать с помощью запроса GET campaigns или найти в кабинете продавца на Маркете — нажмите на название своего бизнеса и перейдите на страницу:
⚠️ Не передавайте вместо него идентификатор магазина, который указан в кабинете продавца на Маркете рядом с названием магазина и в некоторых отчетах.
Min value: |
Query parameters
Name |
Description |
limit |
Type: integer<int32> Количество значений на одной странице.
Min value: |
page_token |
Type: string Идентификатор страницы c результатами. Если параметр не указан, возвращается первая страница. Рекомендуем передавать значение выходного параметра Если задан |
Body
application/json
{
"offerIds": [
"string"
]
}
Name |
Description |
offerIds |
Type: string[] Список SKU. Такой список возвращается только целиком Если вы запрашиваете информацию по конкретным SKU, не заполняйте:
Правила использования SKU:
SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов. Что такое SKU и как его назначать Min length: Max length: Pattern: Min items: Max items: Unique items |
Responses
200 OK
Список товаров с установленными для заданного магазина ценами.
Body
application/json
{
"status": "OK",
"result": {
"offers": [
{
"offerId": "string",
"price": {
"value": 0,
"discountBase": 0,
"currencyId": "RUR",
"vat": 0
},
"updatedAt": "2022-12-29T18:02:01Z"
}
],
"paging": {
"nextPageToken": "string"
}
}
}
Name |
Description |
result |
Type: OfferPriceByOfferIdsListResponseDTO Список цен. |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
OfferPriceByOfferIdsListResponseDTO
Список цен.
Name |
Description |
offers* |
Type: OfferPriceByOfferIdsResponseDTO[] Страница списка цен. |
paging |
Type: ForwardScrollingPagerDTO Идентификатор следующей страницы. |
ApiResponseStatusType
Тип ответа. Возможные значения:
OK
— ошибок нет.ERROR
— при обработке запроса произошла ошибка.
Type |
Description |
Enum: |
OfferPriceByOfferIdsResponseDTO
Информация об установленной цене.
Name |
Description |
offerId |
Type: string Ваш SKU — идентификатор товара в вашей системе. Правила использования SKU:
SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов. Что такое SKU и как его назначать Min length: Max length: Pattern: |
price |
Type: PriceDTO Цена с указанием скидки, валюты и времени последнего обновления. |
updatedAt |
Type: string<date-time> Дата и время последнего обновления цены. |
ForwardScrollingPagerDTO
Идентификатор следующей страницы.
Name |
Description |
nextPageToken |
Type: string Идентификатор следующей страницы результатов. |
PriceDTO
Цена с указанием скидки, валюты и времени последнего обновления.
Name |
Description |
currencyId |
Type: CurrencyType Валюта, в которой указана цена на товар. Enum: |
discountBase |
Type: number Зачеркнутая цена. Число должно быть целым. Вы можете указать цену со скидкой от 5 до 99%. Передавайте этот параметр при каждом обновлении цены, если предоставляете скидку на товар. Min value (exclusive): |
value |
Type: number Цена на товар. Min value (exclusive): |
vat |
Type: integer<int32> Идентификатор НДС, применяемый для товара:
Если параметр не указан, используется НДС, установленный в кабинете. Для продавцов Market Yandex Go недоступна передача и получение НДС. |
CurrencyType
Коды валют:
RUR
— российский рубль.UAH
— украинская гривна.BYR
— белорусский рубль.KZT
— казахстанский тенге.UZS
— узбекский сум.
Type |
Description |
Enum: |
400 Bad Request
Запрос содержит неправильные данные. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
ApiErrorDTO
Общий формат ошибки.
Name |
Description |
code* |
Type: string Код ошибки. |
message |
Type: string Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
404 Not Found
Запрашиваемый ресурс не найден. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
420 Method Failure
Превышено ограничение на доступ к ресурсу. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
500 Internal Server Error
Внутренняя ошибка Маркета. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
No longer supported, please use an alternative and newer version.