WB API ответил 204, а остаток не изменился: как проверить поля запроса
Как проверить изменение остатков Wildberries после ответа 204: точные поля stocks, chrtId и amount, нужный warehouseId и повторное чтение результата по размеру.
Содержание статьи
Ответ 204 при обновлении остатков Wildberries может сопровождаться отсутствием изменения. В документации прямо указано: названия параметров этого запроса не валидируются, и при неверных именах сервер может вернуть успешный код. Поэтому интеграцию принимают по фактическому остатку, а не по одному HTTP-ответу. Проверка выполнена 14 октября 2026 года.
Какие поля нужно сопоставить
PUT /api/v3/stocks/{warehouseId} работает с конкретным складом продавца. В теле передают stocks, внутри — chrtId размера товара и amount. В текущей схеме пакет содержит от 1 до 1 000 записей, а amount ограничен сверху 100 000.
Проверьте фактически сериализованный JSON, а не только названия колонок исходной таблицы. Внутренняя переменная может называться правильно, но преобразователь отправит другое имя. Не подменяйте chrtId артикулом карточки или текстовым названием размера: это разные уровни идентификации товара.
Почему склад нужно проверять отдельно
У одного варианта могут быть разные остатки на нескольких складах. Поэтому правильное число рядом с правильным товаром ещё не доказывает, что изменён нужный склад. Сохраняйте warehouseId в задании и в результате последующей сверки.
Учебная ситуация: сотрудник подготовил пять единиц для склада А, а интеграция использовала сохранённый ранее склад Б. Проверка суммарного остатка по магазину может скрыть ошибку распределения. Контрольная строка должна связывать три значения: склад, размер и ожидаемое количество.
Как принять результат после отправки
После запроса получите остатки по тому же складу и выбранным размерам через предусмотренный метод чтения. Сравните ответ с актуальным заданием. Если величина отличается, сначала проверьте имена полей, идентификаторы и возможные другие изменения, произошедшие между отправкой и чтением.
Не исправляйте расхождение циклической отправкой старого значения: за это время могли поступить новые заказы или новое поручение менеджера. Редакционная рекомендация — фиксировать время снимков и владельца синхронизации, чтобы отличать ошибку запроса от конкурирующих процессов.
Как отделить операцию от аналитического отчёта
Общий отчёт об остатках продавца помогает анализу, но проверка конкретного изменения должна учитывать контракт используемого операционного метода. Не сравнивайте разные представления данных без учёта их назначения и времени получения.
Приёмочный сценарий включает корректное изменение и намеренно неверное имя поля в безопасной тестовой среде. Не проводите такой эксперимент с продаваемым остатком. В рабочем журнале должно быть видно: запрос отправлен, результат перечитан, соответствие подтверждено либо передано на разбор. Зелёный статус HTTP сам по себе эту цепочку не завершает.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы