Руководство разработчика
Методы API

Установка ставок на предложения

Описание

PUT /campaigns/{campaignId}/bids

Устанавливает или удаляет ставки на товарные предложения.

Внимание! Для использования этого метода необходимо, чтобы в личном кабинете в качестве источника информации о ставках был выбран личный кабинет и API.

Передача значений ставок осуществляется в теле PUT-запроса. Действует ограничение на количество ставок в одном запросе: 500 ставок.

URL ресурса:

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/bids.[format]

Входные данные

Параметр

Тип

Значение

Обязательные

campaignId

Int64

Идентификатор кампании.

Структура тела PUT-запроса:

<offer-bids
[no-highlight[

Значение

Список ставок.

]no-highlight]
> <offer-bid
[no-highlight[

Значение

Описание ставки.

Для каждого описания необходимо указать выбранный идентификатор предложения, а также хотя бы один из параметров bid и cbid.

Параметр выводится только для формата XML.

]no-highlight]
bid
[no-highlight[

Значение

Основная ставка, в у. е. Для отделения целой части от дробной используется точка.

Для удаления основной ставки (т. е. установления товарному предложению ставки по умолчанию) необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая основная ставка не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" cbid
[no-highlight[

Значение

Ставка для карточки модели, в у. е. Для отделения целой части от дробной используется точка.

Чтобы удалить ставку для карточки модели (т. е. установить товарному предложению ставку по умолчанию), необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая ставка для карточки модели не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" fee
[no-highlight[

Значение

Размер комиссии на товарное предложение в рамках программы «Заказ на Маркете», в процентах. Для отделения целой части от дробной используется точка.

Чтобы удалить комиссию (т. е. установить товарному предложению комиссию по умолчанию) необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущий размер комиссии не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" feed-id
[no-highlight[

Значение

Идентификатор прайс-листа, содержащего товарное предложение.

Параметр указывается при получении информации о ставке по идентификатору товарного предложения в том случае, если у кампании зарегистрировано более одного прайс-листа.

Для формата XML является атрибутом параметра offer-bid.

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

]no-highlight]
="{integer}" offer-id
[no-highlight[

Значение

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

Укажите параметр offer-id, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-name / offerName.

Для формата XML является атрибутом параметра offer-bid.

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

]no-highlight]
="{string}" offer-name
[no-highlight[

Значение

Название товарного предложения.

Укажите параметр offer-name, если вы используете тип идентификации товаров по названию товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{string}"/> ... </offer-bids>
Структура тела PUT-запроса до версии 2.0 партнерского API Яндекс.Маркета
<offer-bids
[no-highlight[

Значение

Список ставок.

]no-highlight]
> <offer-bid
[no-highlight[

Значение

Описание ставки.

Для каждого описания необходимо указать выбранный идентификатор предложения, а также хотя бы один из параметров bid и cbid.

Параметр выводится только для формата XML.

]no-highlight]
bid
[no-highlight[

Значение

Основная ставка, в у. е. Для отделения целой части от дробной используется точка.

Для удаления основной ставки (т. е. установления товарному предложению ставки по умолчанию) необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая основная ставка не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" cbid
[no-highlight[

Значение

Ставка для карточки модели, в у. е. Для отделения целой части от дробной используется точка.

Чтобы удалить ставку для карточки модели (т. е. установить товарному предложению ставку по умолчанию), необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая ставка для карточки модели не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" offer-name
[no-highlight[

Значение

Название товарного предложения.

Укажите параметр offer-name, если вы используете тип идентификации товаров по названию товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{string}"/> ... </offer-bids>
{
  "bids
[no-highlight[

Значение

Список ставок.

]no-highlight]
": [ { "bid
[no-highlight[

Значение

Основная ставка, в у. е. Для отделения целой части от дробной используется точка.

Для удаления основной ставки (т. е. установления товарному предложению ставки по умолчанию) необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая основная ставка не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "cbid
[no-highlight[

Значение

Ставка для карточки модели, в у. е. Для отделения целой части от дробной используется точка.

Чтобы удалить ставку для карточки модели (т. е. установить товарному предложению ставку по умолчанию), необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая ставка для карточки модели не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "fee
[no-highlight[

Значение

Размер комиссии на товарное предложение в рамках программы «Заказ на Маркете», в процентах. Для отделения целой части от дробной используется точка.

Чтобы удалить комиссию (т. е. установить товарному предложению комиссию по умолчанию) необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущий размер комиссии не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "feedId
[no-highlight[

Значение

Идентификатор прайс-листа, содержащего товарное предложение.

Параметр указывается при получении информации о ставке по идентификатору товарного предложения в том случае, если у кампании зарегистрировано более одного прайс-листа.

Для формата XML является атрибутом параметра offer-bid.

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

]no-highlight]
": {integer}, "offerId
[no-highlight[

Значение

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

Укажите параметр offer-id, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-name / offerName.

Для формата XML является атрибутом параметра offer-bid.

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

]no-highlight]
": "{string}", "offerName
[no-highlight[

Значение

Название товарного предложения.

Укажите параметр offer-name, если вы используете тип идентификации товаров по названию товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": "{string}" }, ... ] }
Структура тела PUT-запроса до версии 2.0 партнерского API Яндекс.Маркета
{
  "bids
[no-highlight[

Значение

Список ставок.

]no-highlight]
": [ { "bid
[no-highlight[

Значение

Основная ставка, в у. е. Для отделения целой части от дробной используется точка.

Для удаления основной ставки (т. е. установления товарному предложению ставки по умолчанию) необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая основная ставка не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "cbid
[no-highlight[

Значение

Ставка для карточки модели, в у. е. Для отделения целой части от дробной используется точка.

Чтобы удалить ставку для карточки модели (т. е. установить товарному предложению ставку по умолчанию), необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая ставка для карточки модели не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "offerName
[no-highlight[

Значение

Название товарного предложения.

Укажите параметр offer-name, если вы используете тип идентификации товаров по названию товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": "{string}" }, ... ] }

В теле PUT-запроса передаются следующие параметры:

Параметр для формата XML

Параметр для формата JSON

Тип

Значение

offer-bids bids

Список ставок.

Параметры, вложенные в offer-bids

offer-bid

Описание ставки.

Для каждого описания необходимо указать выбранный идентификатор предложения, а также хотя бы один из параметров bid и cbid.

Параметр выводится только для формата XML.

Параметры, вложенные в offer-bid / bids

bid bid Float

Основная ставка, в у. е. Для отделения целой части от дробной используется точка.

Для удаления основной ставки (т. е. установления товарному предложению ставки по умолчанию) необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая основная ставка не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

cbid cbid Float

Ставка для карточки модели, в у. е. Для отделения целой части от дробной используется точка.

Чтобы удалить ставку для карточки модели (т. е. установить товарному предложению ставку по умолчанию), необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущая ставка для карточки модели не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

fee fee Float

Размер комиссии на товарное предложение в рамках программы «Заказ на Маркете», в процентах. Для отделения целой части от дробной используется точка.

Чтобы удалить комиссию (т. е. установить товарному предложению комиссию по умолчанию) необходимо в параметре указать значение 0.

Необязательный параметр. Если параметр не задан или в параметре указано пустое значение, текущий размер комиссии не меняется.

Обязательно указать хотя бы один из следующих параметров: bid, cbid, fee.

Для формата XML является атрибутом параметра offer-bid.

feed-id feedId Integer

Идентификатор прайс-листа, содержащего товарное предложение.

Параметр указывается при получении информации о ставке по идентификатору товарного предложения в том случае, если у кампании зарегистрировано более одного прайс-листа.

Для формата XML является атрибутом параметра offer-bid.

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

offer-id offerId String

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

Укажите параметр offer-id, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-name / offerName.

Для формата XML является атрибутом параметра offer-bid.

Параметр доступен начиная с версии 2.0 партнерского API Яндекс.Маркета.

offer-name offerName String

Название товарного предложения.

Укажите параметр offer-name, если вы используете тип идентификации товаров по названию товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

Внимание! 

Ставки на Яндекс.Маркете обновляются:

Поэтому, в зависимости от типа идентификации, не имеет смысла изменять значения ставок чаще чем раз в час либо раз в 30 минут соответственно.

Выходные данные

Структура выходных данных приведена ниже. Порядок следования параметров не гарантируется.

<bids-set
[no-highlight[

Значение

Список установленных ставок.

До версии 2.0 партнерского API Яндекс.Маркета параметр в формате JSON назывался bids-set.

]no-highlight]
> <offer-bid
[no-highlight[

Значение

Описание установленной ставки.

]no-highlight]
bid
[no-highlight[

Значение

Выставленная основная ставка, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" cbid
[no-highlight[

Значение

Выставленная ставка для карточки модели, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" error
[no-highlight[

Значение

Код произошедшей ошибки. Параметр выводится только в случае возникновения ошибки.

Возможные значения:

  • INVALID_BID_VALUE — указано некорректное значение ставки;

  • OFFER_NOT_FOUND — товарное предложение не опубликовано.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{enum}" fee
[no-highlight[

Значение

Выставленный размер комиссии на товарное предложение в рамках программы «Заказ на Маркете», в процентах.

Внимание! 

Выводится размер комиссии, который был передан магазином.

Если переданная магазином комиссия выше максимально допустимого размера (100% от стоимости товара) либо ниже минимально возможного значения в категории, то применяется комиссия, скорректированная системой до допустимого значения. В этом случае размер комиссии, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, применяется комиссия по умолчанию (если установлена магазином) либо минимальная комиссия в категории.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" feed-id
[no-highlight[

Значение

Идентификатор прайс-листа, содержащего товарное предложение.

Параметр выводится при получении информации о ставке, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{integer}" offer-id
[no-highlight[

Значение

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

Параметр выводится при получении информации о ставке, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-name / offerName.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{string}" offer-name
[no-highlight[

Значение

Название товарного предложения.

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

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{string}"/> ... </bids-set>
Структура выходных данных до версии 2.0 партнерского API Яндекс.Маркета
<bids-set
[no-highlight[

Значение

Список установленных ставок.

До версии 2.0 партнерского API Яндекс.Маркета параметр в формате JSON назывался bids-set.

]no-highlight]
> <offer-bid
[no-highlight[

Значение

Описание установленной ставки.

]no-highlight]
bid
[no-highlight[

Значение

Выставленная основная ставка, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" cbid
[no-highlight[

Значение

Выставленная ставка для карточки модели, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{float}" error
[no-highlight[

Значение

Код произошедшей ошибки. Параметр выводится только в случае возникновения ошибки.

Возможные значения:

  • INVALID_BID_VALUE — указано некорректное значение ставки;

  • OFFER_NOT_FOUND — товарное предложение не опубликовано.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{enum}" offer-name
[no-highlight[

Значение

Название товарного предложения.

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

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
="{string}"/> ... </bids-set>
{
  "bidsSet
[no-highlight[

Значение

Список установленных ставок.

До версии 2.0 партнерского API Яндекс.Маркета параметр в формате JSON назывался bids-set.

]no-highlight]
": [ { "bid
[no-highlight[

Значение

Выставленная основная ставка, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "cbid
[no-highlight[

Значение

Выставленная ставка для карточки модели, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "error
[no-highlight[

Значение

Код произошедшей ошибки. Параметр выводится только в случае возникновения ошибки.

Возможные значения:

  • INVALID_BID_VALUE — указано некорректное значение ставки;

  • OFFER_NOT_FOUND — товарное предложение не опубликовано.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": "{enum}", "fee
[no-highlight[

Значение

Выставленный размер комиссии на товарное предложение в рамках программы «Заказ на Маркете», в процентах.

Внимание! 

Выводится размер комиссии, который был передан магазином.

Если переданная магазином комиссия выше максимально допустимого размера (100% от стоимости товара) либо ниже минимально возможного значения в категории, то применяется комиссия, скорректированная системой до допустимого значения. В этом случае размер комиссии, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, применяется комиссия по умолчанию (если установлена магазином) либо минимальная комиссия в категории.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "feedId
[no-highlight[

Значение

Идентификатор прайс-листа, содержащего товарное предложение.

Параметр выводится при получении информации о ставке, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {integer}, "offerId
[no-highlight[

Значение

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

Параметр выводится при получении информации о ставке, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-name / offerName.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": "{string}", "offerName
[no-highlight[

Значение

Название товарного предложения.

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

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": "{string}" }, ... ] }
Структура выходных данных до версии 2.0 партнерского API Яндекс.Маркета
{
  "bids-set
[no-highlight[

Список установленных ставок.

До версии 2.0 партнерского API Яндекс.Маркета параметр в формате JSON назывался bids-set.

]no-highlight]
": [ { "bid
[no-highlight[

Значение

Выставленная основная ставка, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "cbid
[no-highlight[

Значение

Выставленная ставка для карточки модели, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": {float}, "error
[no-highlight[

Значение

Код произошедшей ошибки. Параметр выводится только в случае возникновения ошибки.

Возможные значения:

  • INVALID_BID_VALUE — указано некорректное значение ставки;

  • OFFER_NOT_FOUND — товарное предложение не опубликовано.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": "{enum}", "offerName
[no-highlight[

Значение

Название товарного предложения.

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

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

]no-highlight]
": "{string}" }, ... ] }

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

Параметр для формата XML

Параметр для формата JSON

Тип

Значение

bids-set bidsSet

Список установленных ставок.

До версии 2.0 партнерского API Яндекс.Маркета параметр в формате JSON назывался bids-set.

Параметры, вложенные в bids-set / bidsSet

offer-bid

Описание установленной ставки.

Параметры, вложенные в offer-bid / bidsSet

bid bid Double

Выставленная основная ставка, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

cbid cbid Double

Выставленная ставка для карточки модели, в у. е.

Внимание! 

Выводится размер ставки, который был передан магазином.

Если переданная магазином ставка выше максимально допустимого размера либо ниже минимально допустимого значения, то применяется ставка, скорректированная системой до допустимого значения. В этом случае размер ставки, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, то на товарное предложение основная ставка не установлена, то есть применяется ставка по умолчанию (если установлена) либо минимальная ставка.

Для формата XML является атрибутом параметра offer-bid.

error error Enum

Код произошедшей ошибки. Параметр выводится только в случае возникновения ошибки.

Возможные значения:

  • INVALID_BID_VALUE — указано некорректное значение ставки;

  • OFFER_NOT_FOUND — товарное предложение не опубликовано.

Для формата XML является атрибутом параметра offer-bid.

fee fee Float

Выставленный размер комиссии на товарное предложение в рамках программы «Заказ на Маркете», в процентах.

Внимание! 

Выводится размер комиссии, который был передан магазином.

Если переданная магазином комиссия выше максимально допустимого размера (100% от стоимости товара) либо ниже минимально возможного значения в категории, то применяется комиссия, скорректированная системой до допустимого значения. В этом случае размер комиссии, указанный в данном параметре, отличается от применяемого.

Если параметр не указан, применяется комиссия по умолчанию (если установлена магазином) либо минимальная комиссия в категории.

Для формата XML является атрибутом параметра offer-bid.

feed-id feedId Int64

Идентификатор прайс-листа, содержащего товарное предложение.

Параметр выводится при получении информации о ставке, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Для формата XML является атрибутом параметра offer-bid.

offer-id offerId String

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

Параметр выводится при получении информации о ставке, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Данный параметр является взаимоисключающим с параметром offer-name / offerName.

Для формата XML является атрибутом параметра offer-bid.

offer-name offerName String

Название товарного предложения.

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

Данный параметр является взаимоисключающим с параметром offer-id / offerId.

Для формата XML является атрибутом параметра offer-bid.

Описание ошибок

В случае возникновения ошибочной ситуации сервер возвращает HTTP-код ответа и краткое описание ошибки.

Ошибки, содержащие характерные для данного метода краткие описания:

Описание

Пояснение

Способ возможного решения

Ошибка 400 Bad Request

Current offer identification type is: 'idType'

Идентификация ставок не соответствует установленному режиму.

Идентифицируйте ставки в соответствии с установленным режимом. При необходимости смените режим идентификации в личном кабинете.

Duplicate offer bids are not allowed: 'offerName'

Среди данных, переданных в теле запроса, встречается одно и то же товарное предложение более одного раза.

Проверьте передаваемые в запросе данные на наличие повторяющихся товарных предложений.

Either offer-id or offer-name should be specified

В теле запроса указаны взаимоисключающие параметры offer-id / offerId и offer-name / offerName.

Укажите в теле запроса только один из параметров: offer-id / offerId или offer-name / offerName.

Укажите параметр offer-id / offerId, если вы используете тип идентификации товаров по идентификатору товарного предложения.

Укажите параметр offer-name / offerName, если вы выбрали тип идентификации товаров по названию товарного предложения.

Either one type of bid should be specified

Для каждого товарного предложения, переданного в теле запроса, должен быть указан хотя бы один из параметров: bid, cbid, fee.

Укажите для каждого товарного предложения хотя бы один из параметров: bid, cbid, fee.

Feed should be specified

Не указан идентификатор прайс-листа, являющийся обязательным параметром, если у кампании зарегистрировано более одного прайс-листа и выбран режим получения информации о ставке по идентификатору товарного предложения.

Проверьте корректность передаваемых в запросе данных.

Offer name should not be empty

Название товарного предложения, переданное в теле запроса, не должно быть пустым.

Проверьте корректность передаваемых в запросе данных.

Too many bids: 'bidsCount'

В запросе указано количество ставок превышающее максимальное количество: 500 ставок.

Уменьшите количество передаваемых ставок.

Ошибка 403 Forbidden

Auction is not allowed for campaign 'campaignId'. Reason: 'reason'

Установка или удаление ставок для кампании campaignId невозможно по причине reason.

Возможные причины:

  • FIXED_TARIFF — тип размещения кампании «Старт». Управление ставками для магазинов с типом размещения «Старт» не доступно;

  • OFFLINE_SHOP — кампания является розничным магазином. Управление ставками для розничных магазинов не доступно;

  • SOURCE_NOT_WEB — в личном кабинете в качестве источника информации о ставках указан источник, отличный от «Партнерский интерфейс и API».

При возникновении причины SOURCE_NOT_WEB укажите в личном кабинете в качестве источника информации о ставках вариант «Партнерский интерфейс и API». В остальных случаях управление ставками не доступно.

Ошибка 404 Not Found

Feed not found: 'feedId'

Прайс-лист не найден.

Проверьте корректность передаваемых в запросе данных.

Ограничения

Для методов POST /campaigns/{campaignId}/bids/recommended, POST /campaigns/{campaignId}/bids/recommended/top/market-search и PUT /campaigns/{campaignId}/bids действует групповое ресурсное ограничение. Ограничение вводится на суммарное количество предложений, по которым при помощи этих методов выставлены ставки или получены рекомендации.

Объем запросов к ресурсу, который возможно выполнить в течение суток, рассчитывается индивидуально и зависит от следующих показателей:

  • количество предложений на карточках моделей.

Примечание. 

Количество товарных предложений считается по данным за последние семь дней (не включая сегодня).

Для новых магазинов, не разместивших еще товарные предложения, ограничение равно 0. При размещении предложений этими магазинами ограничение пересчитывается только на следующий день.

Примеры

Пример запроса при установке ставок по идентификатору товарного предложения:

curl -i -H 'Content-Type: application/xml' -X PUT 'https://api.partner.market.yandex.ru/v2/campaigns/10001/bids.xml'

Тело PUT-запроса:

-d '<offer-bids>
  <offer-bid bid="0.22" cbid="0.33" fee="2.5" feed-id="30919" offer-id="239982"/>
  <offer-bid bid="0.22" cbid="0.27" fee="3" feed-id="30919" offer-id="239983"/>
  <offer-bid bid="0.22" cbid="0.15" fee="3.5" feed-id="30919" offer-id="239984"/>
</offer-bids>'

Пример ответа:

HTTP/1.1 200 OK
Date: Sat, 19 Mar 2016 12:08:12 GMT
Content-Type: application/xml;charset=utf-8
...

<response>
  <bids-set>
    <offer-bid bid="0.22" cbid="0.33" fee="2.5" feed-id="30919" offer-id="239982"/>
    <offer-bid bid="0.22" cbid="0.27" fee="3" feed-id="30919" offer-id="239983"/>
    <offer-bid bid="0.22" cbid="0.15" error="OFFER_NOT_FOUND" fee="3.5" feed-id="30919" offer-id="239984"/>
  </bids-set>
</response>
Пример запроса до версии 2.0 партнерского API Яндекс.Маркета
curl -i -H 'Content-Type: application/xml' -X PUT 'https://api.partner.market.yandex.ru/v1/campaigns/10001/bids.xml'

Тело PUT-запроса:

-d '<offer-bids>
  <offer-bid bid="0.4" cbid="0.33" offer-name="Bosch MSM 6B300"/>
  <offer-bid bid="0.35" cbid="0.27" offer-name="Tefal HB 7151"/>
  <offer-bid bid="0.18" cbid="0.15" offer-name="Philips HR 1371"/>
</offer-bids>'

Пример ответа:

HTTP/1.1 200 OK
Date: Sat, 19 Mar 2016 12:08:12 GMT
Content-Type: application/xml;charset=utf-8
...

<response>
  <bids-set>
    <offer-bid bid="0.4" cbid="0.33" offer-name="Bosch MSM 6B300"/>
    <offer-bid bid="0.35" cbid="0.27" offer-name="Tefal HB 7151"/>
    <offer-bid bid="0.18" cbid="0.15" error="OFFER_NOT_FOUND" offer-name="Philips HR 1371"/>
  </bids-set>
</response>

Пример запроса при установке ставок по идентификатору товарного предложения:

curl -i -H 'Content-Type: application/json' -X PUT 'https://api.partner.market.yandex.ru/v2/campaigns/10001/bids.json'

Тело PUT-запроса:

-d '{
  "bids":
  [
    {
      "bid": 0.22,
      "cbid": 0.33,
      "fee": 2.5,
      "feedId": 30919,
      "offerId": "239982"
    },
    {
      "bid": 0.22,
      "cbid": 0.27,
      "fee": 3,
      "feedId": 30919,
      "offerId": "239983"
    },
    {
      "bid": 0.22,
      "cbid": 0.15,
      "fee": 3.5,
      "feedId": 30919,
      "offerId": "239984"
    }
  ]
}'

Пример ответа:

HTTP/1.1 200 OK
Date: Sat, 19 Mar 2016 12:08:12 GMT
Content-Type: application/json;charset=utf-8
...

{
  "bidsSet":
  [
    {
      "bid": 0.22,
      "cbid": 0.33,
      "fee": 2.5,
      "feedId": 30919,
      "offerId": "239982"
    },
    {
      "bid": 0.22,
      "cbid": 0.27,
      "fee": 3,
      "feedId": 30919,
      "offerId": "239983"
    },
    {
      "bid": 0.22,
      "cbid": 0.15,
      "error": "OFFER_NOT_FOUND",
      "fee": 3.5,
      "feedId": 30919,
      "offerId": "239984"
    }
  ]
}
Пример запроса до версии 2.0 партнерского API Яндекс.Маркета
curl -i -H 'Content-Type: application/json' -X PUT 'https://api.partner.market.yandex.ru/v1/campaigns/10001/bids.json'

Тело PUT-запроса:

-d '{
  "bids":
  [
    {
      "bid": 0.4,
      "cbid": 0.33,
      "offerName": "Bosch MSM 6B300"
    },
    {
      "bid": 0.35,
      "cbid": 0.27,
      "offerName": "Tefal HB 7151"
    },
    {
      "bid": 0.18,
      "cbid": 0.15,
      "offerName": "Philips HR 1371"
    }
  ]
}'

Пример ответа:

HTTP/1.1 200 OK
Date: Sat, 19 Mar 2016 12:08:12 GMT
Content-Type: application/json;charset=utf-8
...

{
  "bids-set":
  [
    {
      "bid": 0.4,
      "cbid": 0.33,
      "offerName": "Bosch MSM 6B300"
    },
    {
      "bid": 0.35,
      "cbid": 0.27,
      "offerName": "Tefal HB 7151"
    },
    {
      "bid": 0.18,
      "cbid": 0.15,
      "error": "OFFER_NOT_FOUND",
      "offerName": "Philips HR 1371"
    }
  ]
}
PUT PUT /campaigns/{campaignId}/bids Установка ставок на предложения Удаление ставок Управление ставками Установка ставок