Переход отчёта остатков Wildberries на новый API
Переход отчёта остатков Wildberries на новый API возвращает в работу автоматическую выгрузку, которая раньше обращалась к GET /api/v1/supplier/stocks. С 23 июня 2026 года этот метод отключён. Актуальный путь — POST /api/analytics/v1/stocks-report/wb-warehouses на домене Seller Analytics API.
Он принимает фильтры в JSON, использует токен категории «Аналитика», поддерживает офсетную пагинацию и возвращает до 250 000 строк за запрос. Одна строка соответствует одному размеру товара на одном складе; в ответе есть идентификатор склада и регион отгрузки.
Мы обновляем клиент API и одновременно проверяем бизнес-часть отчёта: сопоставление nmId, chrtId и артикула продавца, агрегацию по складам, сохранение нулевых значений, расписание обновления и контроль полноты. Сотрудники продолжают работать в привычной таблице или панели, а источник данных становится актуальным.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- После 23 июня 2026 года старый запрос остатков возвращает ошибку, а отчёт перестал обновляться.
- Скрипт использует токен категории «Статистика», хотя новый метод доступен по Personal или Service token категории «Аналитика».
- В каталоге много размеров и складов, поэтому одна выгрузка требует корректной офсетной пагинации.
- Остатки участвуют в закупках, рекламе или распределении товара, и команде нужен контролируемый свежий снимок.
Что именно мы сделаем
Находим старый метод, его расписание, токен, таблицы назначения и зависимые показатели.
Подключаем новый POST-метод, категорию токена «Аналитика» и актуальную модель ответа.
Настраиваем пагинацию, фильтры, сопоставление товаров, размеров, складов и регионов.
Сверяем контрольную выборку с кабинетом Wildberries и проверяем полную выгрузку.
Запускаем обновление по расписанию и передаём журнал, инструкцию и критерии контроля.
Что входит в стоимость
39 900 ₽ за всю работу
Находим использование отключённого GET /api/v1/supplier/stocks, фиксируем поля и отчёты, которые от него зависят, подключаем новый метод, обновляем авторизацию, тело запроса и модели ответа. Настраиваем обход страниц, фильтрацию по nmIds и chrtIds, сопоставление складов и размеров, журнал запросов, повтор при ограничении частоты и сверку итоговых сумм. Выпуск завершаем контрольным отчётом по выбранным товарам и полной выгрузке.
Что будет готово
Передадим вам
- Обновлённый загрузчик текущих остатков Wildberries через Seller Analytics API.
- Таблица соответствия старых и новых полей, ключей товара, размера, склада и региона.
- Контрольный отчёт по пагинации, дублям, числу строк и сверке выбранных товаров.
- Инструкция по токену категории «Аналитика», расписанию, журналу и повторному запуску.
Перед сдачей проверим
- Запрос с выбранным Analytics-токеном получает данные через POST /api/analytics/v1/stocks-report/wb-warehouses.
- Тест с уменьшенным limit последовательно проходит несколько offset без повторных ключей товара, размера и склада.
- Фильтр по выбранным nmIds или chrtIds возвращает ожидаемые позиции, а итоговый отчёт сохраняет используемую детализацию.
- Автоматический запуск обновляет снимок, записывает время, количество строк и понятный статус выполнения в журнал.
Как это выглядит на практике
Остатки по размерам собираются в привычный отчёт закупок
- 01
Планировщик запрашивает первую страницу нового метода и сохраняет момент начала обновления.
- 02
Загрузчик проходит offset, связывает nmId и chrtId со справочником магазина и записывает каждый склад отдельной строкой.
- 03
Отчёт закупок суммирует остатки по выбранному правилу и оставляет детализацию по региону для проверки распределения.
- 04
Контроль отмечает число полученных строк, уникальных ключей и дату последнего успешного снимка.
Что понадобится для работы
От вас
- Доступ к коду или настройкам действующей выгрузки и месту, где формируется отчёт.
- Personal или Service token Wildberries с категорией «Аналитика», переданный безопасным способом.
- Справочник артикулов, nmId и chrtId либо правило их сопоставления в учётной системе.
- Пример привычного отчёта и перечень складов, регионов и показателей, важных сотрудникам.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 36 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Какой старый метод Wildberries был отключён?
Wildberries отключил GET /api/v1/supplier/stocks 23 июня 2026 года. Для текущих остатков на складах WB официальный журнал изменений направляет на POST /api/analytics/v1/stocks-report/wb-warehouses.
Какой токен подходит новому методу?
Метод доступен по Personal или Service token с категорией «Аналитика». Проверяем права отдельным контрольным запросом и сохраняем секрет в защищённой настройке приложения.
Как часто обновляются данные об остатках?
Wildberries указывает обновление данных каждые 30 минут. Расписание отчёта настраиваем с учётом этой частоты и официального лимита обращения к методу один раз в 20 секунд на аккаунт.
Справится ли загрузчик с большим каталогом?
Новый метод возвращает до 250 000 строк за запрос и поддерживает offset. Мы реализуем последовательный обход, журналируем страницы и проверяем полноту на тесте с уменьшенным limit.
Почему в новом отчёте важен chrtId?
chrtId обозначает размер товара. Одна строка ответа относится к одному размеру на одном складе, поэтому точный ключ помогает сохранить детализацию и корректно суммировать остатки.
Можно загружать остатки только выбранных товаров?
Да. В запросе предусмотрены фильтры по nmIds и chrtIds, до 1 000 позиций. Это удобно для быстрой сверки товара, выборочного мониторинга и диагностики расхождения.
История остатков входит в этот отчёт?
Этот метод отдаёт текущий снимок. Для ежедневной истории Wildberries документирует отдельный CSV-отчёт STOCK_HISTORY_DAILY_CSV. Если история нужна на том же экране, согласуем её подключение к общей модели данных.
Как проверяется результат перехода?
Сверяем несколько товаров, размеров и складов между ответом API, итоговой таблицей и кабинетом с учётом времени обновления. Дополнительно проверяем пагинацию, повторный запуск, фильтр и запись ошибки авторизации.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Инвентаризация Shadow API и старых методов
Найти использование отключённого метода остатков
- 02Переход отчёта остатков Wildberries на новый API
Перевести текущий отчёт на новый Wildberries API
- 03Собственная история остатков Wildberries
Сохранять собственную историю остатков для анализа