Цены для продвижения товаров

Deprecated

Info

Console

Этот метод устарел. Не используйте его, это может привести к ошибкам. Информацию о ценах вы можете получить в помощью отчета «Цены на рынке».

Этот метод подходит только тем магазинам, которые устанавливают цены на товары в рублях.

Возвращает цены для продвижения товаров, которые вы размещаете на Маркете.

Товары, для которых нужно получить цены, передаются в теле POST-запроса.

Цены для продвижения зависят от цен, установленных на товары другими партнерами. Если один товар поставляют несколько партнеров, на Маркете сначала продается товар с более низкой ценой. Когда закончится товар по низкой цене, начнет продаваться товар по более высокой цене.

Выходные данные содержат для каждого товара несколько цен, соответствующих разным типам продвижения.

Установить цены на товары можно с помощью запроса POST campaigns/{campaignId}/offer-prices/updates или другими способами: например, указать их в файле с каталогом. Также вы можете использовать стратегии для автоматической установки рекомендованных цен или минимальных цен на Маркете.

Подробно об автоматическом управлении ценами рассказано в Справке Маркета для продавцов.

⚙️ Лимит: 100 000 товаров в час

Request

POST

https://api.partner.market.yandex.ru/campaigns/{campaignId}/offer-prices/suggestions

Path parameters

Name

Description

campaignId*

Type: integer<int64>

Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете.

Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

Min value: 1

Body

application/json

{
    "offers": [
        {
            "offerId": "string",
            "marketSku": 0
        }
    ]
}

Name

Description

offers*

Type: SuggestOfferPriceDTO[]

Список товаров.
Товар, для которого требуется получить цены для продвижения.

Max items: 1000

SuggestOfferPriceDTO

Товар, для которого требуется получить цены для продвижения.

Name

Description

marketSku

Type: integer<int64>

SKU на Маркете.

Min value: 1

offerId

Type: string

Идентификатор предложения из прайс-листа.

Min length: 1

Max length: 255

Pattern: ^[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Responses

200 OK

Список цен для продвижения на Маркете.

Body

application/json

{
    "status": "OK",
    "result": {
        "offers": [
            {
                "marketSku": 0,
                "offerId": "string",
                "priceSuggestion": [
                    {
                        "type": "BUYBOX",
                        "price": 0
                    }
                ]
            }
        ]
    }
}

Name

Description

result

Type: SuggestPricesResultDTO

Результат запроса цен для продвижения.

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

SuggestPricesResultDTO

Результат запроса цен для продвижения.

Name

Description

offers*

Type: PriceSuggestOfferDTO[]

Список товаров с ценами для продвижения.
Товар с ценами для продвижения.

ApiResponseStatusType

Тип ответа.

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

PriceSuggestOfferDTO

Товар с ценами для продвижения.

Name	Description
marketSku	Type: integer<int64> SKU на Маркете. Min value: `1`
offerId	Type: string Идентификатор предложения из прайс-листа. Min length: `1` Max length: `255` Pattern: `^[^\x00-\x08\x0A-\x1f\x7f]{1,255}$`
priceSuggestion	Type: PriceSuggestDTO[] Цены для продвижения. Тип цены.

PriceSuggestDTO

Тип цены.

Name

Description

price

Type: number

Цена в рублях.

type

Type: PriceSuggestType

Тип цены.

Enum: BUYBOX, DEFAULT_OFFER, MIN_PRICE_MARKET

PriceSuggestType

Тип цены:

BUYBOX — самая низкая цена на товар, по которой он продается сейчас. Эта цена обновляется в режиме реального времени. Если вы установите цену ниже, начнет показываться ваше предложение. Если для этого значения в параметре price указана цена, которая совпадает с вашей, значит, ваш товар уже показывается на витрине. Если кроме вас этот товар продают другие продавцы по такой же цене, их предложения также будут отображаться вместе с вашими по очереди.
DEFAULT_OFFER — рекомендованная Маркетом цена, которая привлекает покупателей. Рассчитывается только для популярных на сервисе товаров и обновляется раз в четыре часа.
MIN_PRICE_MARKET — минимальная цена на Маркете. Самая низкая цена среди всех предложений товара на Маркете во всех регионах, включая те, которые не видны на витрине. Эта цена обновляется в режиме реального времени и обеспечивает большее количество показов на Маркете, чем самая низкая или рекомендованная цена.

Type	Description
PriceSuggestType	Enum: `BUYBOX`, `DEFAULT_OFFER`, `MIN_PRICE_MARKET`

400 Bad Request

Запрос содержит неправильные данные.

Body

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа.

application/json

{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

Список ошибок.
Общий формат ошибки.

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

Была ли статья полезна?

Список цен

Рекомендованные карточки