Импорт товаров на Wildberries: XLS, API и автоматизация для селлера

Каждый день селлеры добавляют новые позиции, обновляют цены и корректируют остатки. Одна опечатка в цене — и десятки тысяч рублей упущенной прибыли. Wildberries даёт несколько инструментов для импорта: от простого XLS до полноценного API. Разберём, что выбрать под свои задачи и как не наступать на грабли.

#Какие данные можно загружать и выгружать

Личный кабинет Wildberries позволяет работать с шестью основными категориями товарных данных. Каждую можно обновлять вручную или через API.

• Номенклатура — создание и редактирование карточек, массовое обновление полей.
• Цены и скидки — установка цен, настройка акций и промо.
• Остатки на складах — актуальное количество товара для FBO и FBS.
• Характеристики и размерная сетка — размеры, цвета, комплектации.
• Фото и медиа — загрузка и обновление изображений.
• Статусы карточек — информация о модерации, ошибках, блокировках.

Для небольших магазинов хватит ручного ввода. Для бизнеса с сотнями позиций — только автоматизация.

#Способ 1: ручной импорт через XLS-шаблон

Самый простой метод — скачать стандартный XLS-шаблон в разделе «Товары и цены» → «Загрузка товаров». Подходит для ассортимента до 50–100 товаров или разовых операций.

#Как заполнить и загрузить

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

После заполнения загрузите файл обратно. Wildberries проверит формат и покажет ошибки: неправильная цена, пропущенные поля, некорректные артикулы. Исправляете — загружаете снова. Если всё ок, товары уходят в модерацию.

Главный минус ручного импорта — человеческий фактор. Перепутанная цена или неверное количество могут стоить дорого, а при каждом изменении нужно скачивать, править и загружать файл заново.

#Способ 2: автоматизация через API Wildberries

API — программный интерфейс, который берёт на себя рутину. Через него можно загружать, обновлять и получать данные без участия человека.

Для работы понадобится:

• аккаунт продавца на Wildberries;
• доступ к разделу «Настройки доступа к API»;
• сгенерированный API-ключ (токен).

#Какие API доступны

Wildberries предоставляет несколько API для разных задач:

1. Stat API — для получения данных о продажах, заказах и остатках. Методы: /api/v1/supplier/orders, /api/v1/supplier/sales, /api/v1/supplier/stocks.
2. Content API — для управления контентом карточек: создание, редактирование, загрузка фото. Методы: /content/v1/cards/cursor/list, /content/v1/cards/upload, /content/v1/media/save.
3. Prices API — для массового обновления цен и скидок. Методы: /api/v1/uploadPrices, /public/api/v1/info.
4. Warehouse API — для управления остатками на складах при FBS. Методы: /api/v1/warehouse/stocks, /api/v1/warehouse/stocks/total.

#Как получить API-ключ

Зайдите в личный кабинет Wildberries, нажмите на иконку профиля → «Настройки» → «Доступ к API». Нажмите «Создать токен», задайте понятное имя (например, «MP Manager») и выберите права доступа.

Для сервиса аналитики обычно достаточно прав на Статистику и Контент (только чтение). Не выдавайте лишнего — это стандартная практика безопасности.

После создания токен отобразится на экране. Скопируйте его сразу — Wildberries показывает его только один раз. Храните в надёжном месте.

#Настройка интеграции с сервисом аналитики

В личном кабинете сервиса найдите раздел подключения магазинов, выберите Wildberries и вставьте токен. Сервис проверит валидность и начнёт синхронизацию.

При подключении можно выбрать, какие данные загружать: продажи, остатки, цены, карточки. Для полноценной аналитики лучше загружать всё. По умолчанию данные подтягиваются каждые 15–30 минут — этого достаточно для оперативных решений.

Первая загрузка обычно захватывает историю за последние 30–90 дней. Некоторые сервисы позволяют загрузить данные за весь период работы магазина — это полезно для трендов и сезонных графиков.

#Типичные ошибки при импорте и их решение

Даже при правильной настройке интеграции могут возникать проблемы. Вот самые частые.

• Токен недействителен. Причина: лишние символы при копировании. Решение: создайте новый токен и скопируйте без пробелов.
• Недостаточно прав для запроса. Причина: при создании токена не отмечены нужные разделы API. Решение: удалите старый токен и создайте новый с правильными правами.
• Превышен лимит запросов. Wildberries ограничивает количество запросов в минуту. При ошибке 429 (Too Many Requests) сервис аналитики обычно сам регулирует частоту.
• Данные не обновляются. Проверьте статус токена в кабинете Wildberries. Если токен активен, пересоздайте его и обновите в сервисе.
• Расхождения в данных. Разная частота обновления: в кабинете данные могут обновляться быстрее, чем через API. Учитывайте задержку 15–60 минут.
• Ошибки модерации при загрузке карточек через API. Проверьте, что заполнены все обязательные поля: наименование, бренд, страна производства, состав (для одежды), размерная сетка.

#Массовое редактирование товаров через API

Главное преимущество API — возможность менять сотни позиций одним запросом.

#Массовое обновление цен

Через Prices API можно отправить новые цены для всех товаров сразу. Удобно при сезонном переоценивании, акциях или корректировке под конкурентов. Один запрос обрабатывает до 1000 товаров.

#Массовое обновление остатков

Для схемы FBS критически важно передавать актуальные остатки на собственных складах. Ошибка в остатках — покупатель заказывает товар, которого нет, — штраф от Wildberries. API исключает человеческий фактор.

#Массовое обновление характеристик

Через Content API можно добавлять новые размеры, менять цвета, корректировать описания. Особенно полезно для сезонного ассортимента: быстро добавить летние позиции и скрыть зимние.

#Безопасность API-токенов

API-токен даёт доступ к коммерческим данным магазина. Относитесь к нему ответственно.

• Не передавайте токен третьим лицам. Только вы и сервис аналитики.
• Используйте минимально достаточные права. Не давайте доступ к управлению ценами, если сервис только читает отчёты.
• Создавайте отдельные токены для разных сервисов. Если один скомпрометируют, остальные продолжат работу.
• Меняйте токены раз в 3–6 месяцев.
• Отзывайте неиспользуемые токены в разделе «Доступ к API».

Если токен оказался у посторонних, немедленно создайте новый и удалите старый. Обновите токен во всех сервисах и проверьте историю операций.

#Как проверить, что интеграция работает

После подключения убедитесь, что данные загружаются корректно:

1. Сверьте общее количество товаров. Расхождение в 1–3% допустимо (архивные позиции могут не попадать в выгрузку).
2. Сравните продажи за последнюю неделю. Цифры по заказам и выручке должны совпадать с точностью до комиссий и возвратов.
3. Проверьте остатки на складах — одна из самых динамичных метрик.
4. Посмотрите время последней синхронизации. Нормальная задержка — 15–60 минут.

Если данные не сходятся, проверьте настройки синхронизации в сервисе: возможно, выбран неверный период или отключены какие-то категории.

#Что это значит для селлеров

Ручной импорт через XLS подходит для старта или разовых задач. Для растущего бизнеса с сотнями товаров автоматизация через API — необходимость. Она экономит часы ручной работы, исключает ошибки и даёт доступ к аналитике: поиск ниш, анализ конкурентов, тренды категорий, мониторинг цен.

Главное — соблюдать правила безопасности: отдельные токены для каждого сервиса, минимальные права, регулярное обновление. Если вы ещё не подключили кабинет к сервису аналитики, попробуйте MP Manager — 7 дней бесплатного доступа без банковской карты. Загрузите данные своего магазина и начните принимать решения на основе точной информации.