Информация об ошибках магазина

Описание

GET /campaigns/{campaignId}/quality/tickets

Возвращает данные о текущих ошибках магазина, выявленных службой контроля качества Яндекс.Маркета.

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

URL ресурса:

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

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

Параметр

Тип

Значение

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

campaignId

Int64

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

Необязательные

actualType

Enum

Фильтрация актуальных ошибок магазина.

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

  • 0 — актуальные ошибки (все ошибки, выявленные за последние 30 дней);

  • 1 — архивные ошибки (все ошибки, выявленные более 30, но менее 90 дней назад).

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

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

<response>
  <result>
    <tickets>
      <ticket check-method="{int8}" error-code="{int32}" error-found-time="{date}" error-text="{string}" feed-time="{date}" offer-url="{string}" order-id="{string}" status="{int8}" ticket-id="{int64}"/>
      ...
    </tickets>
  </result>
</response>

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

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

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

Тип

Значение

response

Ответ.

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

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

result result

Результат работы метода.

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

tickets tickets

Список ошибок магазина.

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

ticket

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

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

check-method checkMethod Int8

Тип проверки магазина.

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

  • 1 — проверка по телефону.

  • 2 — проверка с помощью добавления товара в корзину на сайте магазина.

  • 3 — визуальная проверка сайта магазина.

  • 4 — комплексная проверка.

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

error-code errorCode Int32

Код ошибки магазина.

Критичные ошибки.

Проблемы с ценой товара:

  • 1 — Цена на Маркете отличается от цены на сайте магазина.

  • 3 — Реальная цена выше.

  • 34 — Указана стоимость товара при заказе партии.

  • 35 — По указанной цене товар продается в комплекте.

  • 36 — Цена не имеет отношения к товару.

Проблемы с оформлением заказа:

  • 13 — Товара нет в наличии.

  • 15 — Заказать товар нельзя.

  • 16 — На сайте магазина не удается оформить заказ.

  • 17 — Не удалось связаться с магазином по телефону, указанному на его сайте.

  • 39 — Информация о предоплате не указана или указана неверно.

  • 40 — Минимальная сумма заказа не указана или указана неверно.

  • 55 — По ссылке в прайс-листе нельзя посмотреть товар.

  • 58 — Заказ на сайте магазина не был подтвержден в течение часа.

  • 69 — Магазин не принял заказ.

  • 70 — На странице товара нет кнопки для оформления заказа.

  • 72 — Минимальное количество товаров, которое можно заказать, не указано или указано неверно.

  • 82 — Заказ по телефону не был принят в течение часа.

  • 94 — Вместо товара в предложении покупателю предлагают другой.

  • 95 — Не удалось связаться с магазином по телефону, указанному на Маркете.

Проблемы с информацией о товаре или его качеством:

  • 23 — Информация о товаре не соответствует действительности.

  • 41 — Товар ненадлежащего качества или не адаптирован для работы в России.

  • 78 — Товар нельзя продавать дистанционно.

  • 80 — Проблема с гарантией.

  • 81 — Неверная информация о гарантии.

  • 96 — Товар нельзя рекламировать в интернете.

Проблемы с доставкой товара:

  • 30 — Проблема с доставкой.

  • 75 — Нет доставки в регион.

  • 83 — В день доставки никто не вышел на связь с покупателем.

  • 111 — Неверно указан срок или стоимость доставки.

  • 112 — Неверно указан срок или стоимость доставки в пункт выдачи.

Некритичные ошибки:

  • 54 — Предложение дублирует другое.

  • 59 — Слова, набранные заглавными буквами.

  • 76 — Предложение составлено с ошибками.

  • 77 — Повтор слов в названии предложения.

  • 90 — В тексте предложения есть слова, не имеющие к нему отношения.

В качестве текстового описания значений приведены возможные значения параметра error-text.

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

error-found-time errorFoundTime Date

Дата и время выявления ошибки.

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

error-text errorText String

Текстовое описание ошибки.

Возможные значения приведены в описании параметра error-code.

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

feed-time feedTime Date

Дата и время загрузки прайс-листа.

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

offer-url offerURL String

URL-адрес предложения с ошибкой на сайте магазина.

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

order-id orderId String

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

Присутствует в выходных данных, если параметр check-method=2 (проверка с помощью добавления товара в корзину на сайте магазина).

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

status status Int8

Статус ошибки.

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

  • 0 — ошибка выставлена.

  • 1 — магазин исправил ошибку.

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

ticket-id ticketId Int64

Идентификатор тикета на ошибку в службе контроля качества.

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

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

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

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

Описание

Пояснение

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

Ошибка 400 Bad Request

Type mismatch: <message>

Значение параметра не соответствует его типу. Например, для параметра actualType указано значение, отличное от 0 и 1.

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

Ошибка 403 Forbidden

Access denied

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

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

Примеры

Пример запроса:

curl -i -H 'Content-Type: application/xml' -X GET 'https://api.partner.market.yandex.ru/v2/campaigns/1234/quality/tickets.xml'

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

HTTP/1.1 200 OK
Date: Thu, 15 Jun 2017 00:42:42 GMT
Content-Type: application/xml;charset=utf-8
...

<response>
  <result>
    <tickets>
      <ticket check-method="1" error-code="3" error-found-time="2017-06-05T00:42:42" error-text="Реальная цена выше" feed-time="2015-12-27T00:42:42" offer-url="http://shop.seller.ru/products/56789" status="1" ticket-id="1011121"/>
    </tickets>
  </result>
</response>