Wildberries API в n8n: токен, отзывы, остатки и слоты поставки

В этой статье вы создадите токен Wildberries, подключите его к n8n и сделаете первые запросы: отзывы без ответа, отчёт об остатках и тарифы на поставку. Адреса и лимиты сверены с документацией WB API в октябре 2026 года.

Что понадобится

• Доступ к личному кабинету продавца Wildberries.
• n8n на своём сервере. Как его поставить, описано в статье об установке n8n.
• Канал для уведомлений, например Telegram-бот.

Шаг 1. Выбрать тип токена

У WB четыре типа токенов:

Для n8n на вашем сервере подходит персональный токен. Разница в лимитах большая. Для категории «Вопросы и отзывы» персональный токен даёт 3 запроса в секунду, а базовый только 5 запросов в час.

Шаг 2. Создать токен

1. В личном кабинете откройте раздел «Интеграции по API» и нажмите «+ Создать токен».
2. Выберите вкладку «Для интеграции вручную» и тип токена.
3. Задайте название и отметьте только нужные категории.
4. Выберите уровень доступа: «Только чтение» или «Чтение и запись».
5. Для персонального токена отметьте согласие не передавать токен третьим лицам и нажмите «Создать».
6. Нажмите «Скопировать и закрыть». Повторно посмотреть токен нельзя.

Токен действует 180 дней. Какие категории нужны для задач из этой статьи:

Для отчётов и уведомлений берите «Только чтение». Чтобы публиковать ответы на отзывы, нужен отдельный токен с «Чтением и записью» на одну категорию «Вопросы и отзывы».

Шаг 3. Подключить токен в n8n

В Credentials создайте доступ типа Header Auth:

• Name: Authorization
• Value: токен целиком

Проверьте подключение методом /ping на нужном домене:

curl -H "Authorization: $WB_TOKEN" https://feedbacks-api.wildberries.ru/ping

В ответ придёт "Status": "OK". У этого метода свой лимит, 3 запроса за 30 секунд, поэтому в рабочие сценарии его не ставьте.

Шаг 4. Забрать отзывы без ответа

GET https://feedbacks-api.wildberries.ru/api/v1/feedbacks?isAnswered=false&take=100&skip=0&order=dateDesc

Параметры isAnswered, take и skip обязательны. take принимает до 5000 отзывов за раз. Отзывы без текста, только с оценкой, WB считает обработанными, поэтому в выборку они не попадут.

Список лежит в data.feedbacks. Разбейте его на элементы узлом Split Out и дальше обращайтесь к полям:

{{ $json.id }}
{{ $json.productValuation }}
{{ $json.text }}
{{ $json.productDetails.productName }}

Ответ публикуется так:

POST https://feedbacks-api.wildberries.ru/api/v1/feedbacks/answer

{ "id": "{{ $json.id }}", "text": {{ JSON.stringify($json.answer) }} }

Текст ответа от 2 до 5000 символов, успешный ответ приходит с кодом 204. Учтите, что WB не проверяет ID отзыва. С неверным ID ошибки не будет, ответ просто не появится. Как подготовить текст ответа нейросетью, описано в статье о YandexGPT в n8n.

Шаг 5. Получить остатки на складах WB

Отчёт об остатках строится в три запроса:

1. GET https://seller-analytics-api.wildberries.ru/api/v1/warehouse_remains?groupByNm=true создаёт задание и возвращает data.taskId.
2. GET .../api/v1/warehouse_remains/tasks/{task_id}/status показывает статус. Ждите значения done.
3. GET .../api/v1/warehouse_remains/tasks/{task_id}/download отдаёт отчёт. Готовый отчёт хранится 2 часа.

В n8n между вторым и третьим запросом поставьте узел Wait на 30–60 секунд и узел If, который возвращает сценарий на проверку статуса, пока отчёт не готов. В ответе у каждого товара есть nmId, vendorCode и массив warehouses. Общий остаток в примере ответа WB идёт отдельной строкой:

{{ $json.warehouses.find(w => w.warehouseName === 'Всего находится на складах')?.quantity }}

Если в старых инструкциях вам встречался метод остатков из категории «Статистика», сверьте его с документацией. Сейчас в разделе «Отчёты» описан именно этот отчёт из категории «Аналитика».

Шаг 6. Тарифы на поставку и слоты

Коэффициенты приёмки по складам отдаёт метод из раздела «Тарифы»:

GET https://common-api.wildberries.ru/api/tariffs/v1/acceptance/coefficients?warehouseIDs=507,117501

Он работает с токеном любой категории, лимит для персонального токена 6 запросов в минуту. В ответе есть date, coefficient, warehouseID, warehouseName, allowUnload и boxTypeID.

На октябрь 2026 года документация помечает этот метод как «временно отключён». Так же помечен метод POST /api/v1/acceptance/options на supplies-api.wildberries.ru. Поэтому сценарий поиска бесплатной приёмки сейчас собрать нельзя. Следите за журналом изменений WB API. Как трактовать значения coefficient и allowUnload, сверьте с описанием полей, когда метод снова заработает.

Шаг 7. Собрать сценарий

Типовая схема для отзывов и остатков:

1. Schedule Trigger: отзывы раз в 15–30 минут, остатки раз в несколько часов.
2. HTTP Request с доступом Header Auth.
3. Split Out и Filter: например, отзывы с оценкой 1–3 или товары с остатком ниже порога.
4. Действие: черновик ответа, уведомление, запись в таблицу.

Готовый вариант для отзывов с согласованием негативных ответов описан на странице автоответов на отзывы.

В уведомления в Telegram отправляйте только артикул, оценку и ссылку. Имена покупателей и тексты с личными данными туда не нужны, серверы Telegram находятся за рубежом.

Лимиты запросов

WB считает лимиты по алгоритму token bucket. У каждого метода свой период, лимит и всплеск, они указаны в описании метода. При превышении приходит ошибка 429 с заголовками:

• X-Ratelimit-Retry: через сколько секунд можно повторить запрос;
• X-Ratelimit-Reset: через сколько секунд восстановится весь запас запросов.

В категории «Маркетплейс» запрос с ошибкой 4XX засчитывается как 10 запросов. Чтобы не упираться в лимиты, в узле HTTP Request включите Batching с паузой между пачками и в настройках узла включите Retry On Fail.

Частые ошибки

• 401. Токен истёк, скопирован с ошибкой или не передан в заголовке.
• 403. Категория токена не совпадает с категорией метода, метод недоступен для вашего типа токена или токен создавал удалённый пользователь.
• 429 почти сразу. Чаще всего сценарий работает на базовом токене. Перейдите на персональный.
• Ответ на отзыв не появился. Проверьте, что в запрос ушёл правильный id отзыва. WB его не проверяет.
• Отчёт об остатках не скачивается. Он ещё не готов или с момента создания прошло больше 2 часов.