Wildberries выпустил вторую версию API-отчёта «Оценка товара», включив в неё данные о скрытых из каталога карточках. Обновление объявлено 16 июля 2026 года. Для разработчиков это смена не только адреса запроса: поменялись имена полей и появилась отдельная фильтрация скрытых товаров.

Как работает новая версия

Метод POST /api/analytics/v2/item-rating поддерживает параметр onlyShadowedNms. Значение true ограничивает выборку скрытыми товарами; false при отсутствии других ограничений возвращает все товары. В ответе признак isShadowed показывает состояние конкретной позиции. Для вызова нужен Персональный или Сервисный токен категории «Аналитика».

В ответе массив cards переименован в items, а в имени isNotIncludeNmsWithoutSales изменён регистр части Nms. Старую версию отчёта и отдельный метод скрытых товаров площадка объявила к отключению 30 июля. К октябрю интеграции следует проверять уже по новой схеме, а не проектировать переход как отдалённую задачу.

Какие ошибки возможны в отчёте

Самый неприятный сбой — пустой список без технической ошибки. Если программа продолжит искать массив cards, она может решить, что проблемных карточек нет. Аналогичный результат возможен при неправильной обработке фильтра. Поэтому проверять нужно содержание ответа и известные контрольные товары, а не только успешный HTTP-код.

Для мониторинга ассортимента полезно сохранять историю состояния каждой карточки. Разовый список показывает сегодняшнюю ситуацию, но не отвечает, когда товар исчез из каталога и восстановился ли после исправления. Сравнение последовательных снимков помогает создать адресную задачу контент-менеджеру и закрыть её после подтверждённого изменения.

Как организовать очередь исправлений

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

Приоритет стоит определять по влиянию на бизнес: важность товара в ассортименте, остатки, активные маркетинговые действия и наличие аналогов. Сам факт скрытия ещё не объясняет причину. Нельзя автоматически назначать всем карточкам одну корректировку описания или изображения: сначала нужно выяснить конкретную проблему в доступных данных кабинета и документах.

Как проверить интеграцию после обновления

Подготовьте контрольный набор из обычной карточки и карточки с известным проблемным состоянием. Сравните общую выборку и результат с onlyShadowedNms=true. Убедитесь, что фильтры не исключают важные позиции без продаж, если именно их должна обнаруживать система. Отдельно проверьте повторный запуск и сохранение статуса уже созданных задач.

Руководителю полезнее видеть число новых и решённых случаев за период, чем общий размер очереди без контекста. Такой отчёт показывает работу команды и не превращает временное изменение каталога в необъяснимую цифру. Обновлённый API даёт структурированный сигнал, а решение о восстановлении карточки всё равно требует проверки её содержания и требований площадки.