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

Описание

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

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

feedId

Int64

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

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

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

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

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

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

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

Тип

Значение

response

Ответ.

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

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

errorserrors

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

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

statusstatusEnum

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

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

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

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

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

error

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

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

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

codecodeEnum

Код ошибки.

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

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

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

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

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

messagemessageString

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

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

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

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

Описание

Пояснение

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

Ошибка 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>