Сообщить, что прайс-лист обновился

Описание

POST /campaigns/{campaignId}/feeds/{feedId}/refresh

Позволяет сообщить, что магазин обновил прайс-лист. После этого Яндекс.Маркет начнет обновление данных на сервисе.

  1. Магазин обновляет прайс-лист, ссылку на который он указал в личном кабинете.

  2. Магазин отправляет Яндекс.Маркету запрос методом POST /campaigns/{campaignId}/feeds/{feedId}/refresh.

  3. Яндекс.Маркет начинает обновление данных магазина на сервисе.

Внимание. Запрос работает только для включенных магазинов. Если магазин выключен, данные на Яндекс.Маркете не обновятся, даже если HTTP-код — 200 OK. Проверить статус магазина можно с помощью базовых методов или на странице Мои магазины («Мои магазины»).
Примечание. В течение часа магазин может выполнить запрос не более трех раз для одного прайс-листа.

URL ресурса:

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

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

Параметр

Тип

Значение

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

campaignId

Int64

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

Чтобы узнать идентификатор, войдите в личный кабинет, нажмите на название магазина и скопируйте из поля Кампания № число после дефиса. Например, если указано значение «11-213856», то идентификатор кампании — 213856.

feedId

Int64

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

Параметр

Тип

Значение

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

campaignId

Int64

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

Чтобы узнать идентификатор, войдите в личный кабинет, нажмите на название магазина и скопируйте из поля Кампания № число после дефиса. Например, если указано значение «11-213856», то идентификатор кампании — 213856.

feedId

Int64

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

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

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

<response>
  <errors>
    <error code="{enum}" message="{string}"/>
    ...
  </errors>
  <status>{enum}</status>
</response>

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

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

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

Тип

Значение

response

Ответ.

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

Параметры, вложенные в response

errors errors

Список ошибок при выполнении запроса.

Выводится, если status="ERROR".

status status Enum

Статус выполнения запроса.

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

  • OK — запрос выполнен успешно.

  • ERROR — произошла ошибка.

Параметры, вложенные в errors

error

Информация об ошибке.

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

Параметры, вложенные в error / errors

code code Enum

Код ошибки.

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

  • BAD_REQUEST — не удалось выполнить запрос.

  • NOT_FOUND — не указан один или несколько path-параметров. Подробную информацию смотрите в значении параметра message.

  • REFRESH_FEED_ERROR — не удалось обновить прайс-лист. Попробуйте обратиться к ресурсу через некоторое время.

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

message message String

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

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

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

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

Тип

Значение

response

Ответ.

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

Параметры, вложенные в response

errors errors

Список ошибок при выполнении запроса.

Выводится, если status="ERROR".

status status Enum

Статус выполнения запроса.

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

  • OK — запрос выполнен успешно.

  • ERROR — произошла ошибка.

Параметры, вложенные в errors

error

Информация об ошибке.

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

Параметры, вложенные в error / errors

code code Enum

Код ошибки.

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

  • BAD_REQUEST — не удалось выполнить запрос.

  • NOT_FOUND — не указан один или несколько path-параметров. Подробную информацию смотрите в значении параметра message.

  • REFRESH_FEED_ERROR — не удалось обновить прайс-лист. Попробуйте обратиться к ресурсу через некоторое время.

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

message message String

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

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

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

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

Описание

Пояснение

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

Ошибка 403 Forbidden

Access denied

Нет доступа к магазину.

Проверьте корректность идентификатора магазина.

Ошибка 404 Not Found

Not found active shop for campaign: 'campaignId'

Магазин отключен.

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

Описание

Пояснение

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

Ошибка 403 Forbidden

Access denied

Нет доступа к магазину.

Проверьте корректность идентификатора магазина.

Ошибка 404 Not Found

Not found active shop for campaign: 'campaignId'

Магазин отключен.

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

Примеры

Запрос:

curl -i -H 'Content-Type: application/xml' -X POST 'https://api.partner.market.yandex.ru/v2/campaigns/10001/feeds/12345/refresh.xml'

Ответ:

HTTP/1.1 200 OK
Date: Tue, 27 Feb 2018 00:42:42 GMT
Content-Type: application/xml;charset=utf-8
...

<response>
  <status>OK</status>
</response>