24 августа Wildberries представил отчёт по остаткам на складах продавца через POST /api/analytics/v1/stocks-report/seller-warehouses. Для его получения не требуется заранее передавать идентификаторы складов и размеров. Это упрощает сбор общей картины остатков для учётной системы и управленческой сверки.

Чем полезен новый способ получения данных

В объявлении отчёт предлагается как альтернатива чтению остатков через POST /api/v3/stocks/{warehouseId}. Он доступен по Персональному и Сервисному токену категории «Аналитика». На момент анонса Wildberries указал обновление данных раз в тридцать минут. При проектировании расписания нужно учитывать действующую документацию конкретного метода, а не переносить частоту из других аналитических разделов.

Отсутствие необходимости перечислять размеры в запросе уменьшает зависимость проверки от локального справочника. Если в собственной базе потерялась связь с одним товарным вариантом, адресный запрос по известным идентификаторам мог бы его вообще не затронуть. Общая выгрузка полезна именно для поиска таких расхождений между площадкой и внутренней системой.

Как построить сверку остатков

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

Далее сравните количество и время актуальности каждого источника. Расхождение не всегда означает ошибку: между выгрузками могли появиться новые заказы или перемещение товара. Для разбора полезно сохранить момент снимка и список операций за интервал. Это позволяет отделить нормальную временную разницу от систематической проблемы синхронизации.

Что делать с обнаруженными расхождениями

Разделите случаи на неизвестный товар, неизвестный склад и несовпадающее количество. У них разные ответственные и способы исправления. Если одной кнопкой перезаписать все данные, можно устранить симптом в отчёте, но сохранить причину: неверную связь размеров, задержку учёта или параллельную передачу остатков из двух сервисов.

Для каждой пары «товар — склад» должен быть понятен главный источник значения. Если складская система отвечает за доступное количество, маркетплейс используется для проверки результата передачи. Если данные корректирует сотрудник вручную, это действие также должно попадать в журнал. Без такого соглашения автоматические обмены способны бесконечно заменять значения друг друга.

Где граница между отчётом и управлением

Новый метод получает сведения, но сам по себе не решает вопрос резервирования товара. Внутренний процесс должен учитывать уже принятые заказы, физическое наличие и правила распределения запаса между каналами. Аналитический снимок полезен для контроля; считать его единственным мгновенным источником доступного к продаже количества без проверки задержек не стоит.

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