Как импортировать товары из кабинета Wildberries: выгрузка и загрузка данных

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

Wildberries предоставляет несколько способов импорта и выгрузки товарных данных: от базового XLS-шаблона до полноценного API. В этой статье разберём все доступные методы, покажем пошаговые инструкции для каждого и расскажем, как автоматизировать процесс с помощью сервисов внешней аналитики.

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

Личный кабинет Wildberries позволяет работать со следующими категориями товарных данных:

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

Каждый из этих типов данных можно загружать как вручную через интерфейс кабинета, так и автоматически через API.

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

Самый простой и доступный способ загрузки товаров в Wildberries - использование стандартного XLS-шаблона. Он подходит для небольших магазинов с ассортиментом до 50-100 товаров или для разовых операций.

Зайдите в личный кабинет Wildberries, перейдите в раздел «Товары и цены» → «Загрузка товаров». Нажмите кнопку «Скачать шаблон» - система предложит XLS-файл с колонками для заполнения.

XLS-шаблон содержит следующие обязательные поля:

• Артикул продавца - ваш внутренний идентификатор товара;
• Наименование - название товара для карточки;
• Бренд - производитель товара;
• Страна производства;
• Количество - остаток на складе;
• Цена - цена для покупателя (без скидки);
• Цена со скидкой - актуальная цена продажи;
• Размер (для размерных товаров);
• Цвет (для цветовариантных товаров).

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

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

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

Ограничения ручного импорта

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

Способ 2: Импорт через API Wildberries

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

Для работы с API потребуется:

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

Какие API доступны для работы с товарами

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

Статистика (Stat API)

Используется для получения данных о продажах, заказах и остатках. Через этот API сервисы аналитики загружают историю продаж, строят отчёты и прогнозы.

Основные методы:

• /api/v1/supplier/orders - получение заказов;
• /api/v1/supplier/sales - получение продаж;
• /api/v1/supplier/stocks - получение остатков.

Контент (Content API)

API для управления контентом карточек: создание и редактирование товаров, управление характеристиками, фото и описаниями.

Основные методы:

• /content/v1/cards/cursor/list - получение списка карточек;
• /content/v1/cards/upload - загрузка и обновление карточек;
• /content/v1/media/save - загрузка изображений.

Цены (Prices API)

API для управления ценами и скидками. Позволяет массово обновлять цены, устанавливать промо-цены, настраивать акции.

Основные методы:

• /api/v1/uploadPrices - загрузка цен;
• /public/api/v1/info - получение текущих цен.

Склад (Warehouse API)

API для управления остатками на складах. Используется при работе по схеме FBS для передачи информации о доступных остатках на собственных складах.

Основные методы:

• /api/v1/warehouse/stocks - загрузка остатков;
• /api/v1/warehouse/stocks/total - получение общих остатков.

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

Для подключения к любому API Wildberries нужен токен - уникальный ключ доступа. Рассмотрим процесс получения по шагам.

Авторизуйтесь на seller.wildberries.ru под учётной записью, у которой есть права на управление API. Обычно это владелец кабинета или администратор.

В правом верхнем углу нажмите на иконку профиля, выберите «Настройки» → «Доступ к API». Откроется страница управления ключами.

Нажмите кнопку «Создать токен». Система попросит указать название токена - задайте понятное имя, чтобы ориентироваться, если у вас несколько ключей. Например, «Внешняя аналитика» или «MP Manager».

Wildberries позволяет гибко настроить разрешения для каждого токена. Вы можете дать доступ только к определённым API:

• Контент - для управления карточками;
• Цены - для работы с ценами;
• Склад - для управления остатками;
• Статистика - для получения данных о продажах;
• Логистика - для работы с поставками.

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

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

Храните токен в надёжном месте. Он даёт доступ к данным вашего магазина.

В личном кабинете сервиса аналитики найдите раздел подключения магазинов. Обычно он называется «Мои магазины» или «Подключения». Выберите Wildberries, вставьте скопированный токен в соответствующее поле и сохраните.

Сервис проверит валидность токена и начнёт синхронизацию данных. Первая загрузка может занять от几分钟 до часа в зависимости от объёма ассортимента и истории продаж.

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

После получения токена и его активации в сервисе аналитики данные начинают синхронизироваться автоматически. Но стоит правильно настроить параметры интеграции.

Какие данные загружать

При подключении можно выбрать, какие данные синхронизировать:

• Продажи и заказы - основная информация для аналитики;
• Остатки - для контроля склада и предотвращения дефицита;
• Цены - для мониторинга и автоматической корректировки;
• Карточки товаров - для SEO-аудита и оптимизации.

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

Периодичность синхронизации

По умолчанию сервисы подтягивают данные каждые 15-30 минут. Этого достаточно для ежедневных оперативных решений. Если вам нужна аналитика в реальном времени, уточните в сервисе возможность ускоренного обновления.

История данных

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

Автоматические отчёты

Настройте регулярную отправку отчётов на почту или в Telegram. Например: каждое утро - сводка по продажам за вчера, каждый понедельник - еженедельный отчёт по топ-товарам, каждый месяц - ABC-XYZ-анализ ассортимента.

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

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

Ошибка 1: Токен недействителен

Причина: Токен скопирован с лишними символами или не полностью. Иногда при копировании в буфер попадают пробелы в начале или конце строки.

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

Ошибка 2: Недостаточно прав для запроса

Причина: При создании токена не отмечены нужные разделы API. Сервис аналитики пытается запросить данные, на которые у токена нет прав.

Решение: Удалите старый токен и создайте новый с правильными правами. Для аналитики нужны права на раздел «Статистика» как минимум.

Ошибка 3: Превышен лимит запросов

Причина: Wildberries ограничивает количество запросов к API в единицу времени. При слишком частых запросах API возвращает ошибку 429 (Too Many Requests).

Решение: Обычно эта проблема решается на стороне сервиса аналитики - он автоматически регулирует частоту запросов. Если ошибка повторяется, обратитесь в поддержку сервиса.

Ошибка 4: Данные не обновляются

Причина: Несколько возможных причин: токен отозван, превышен лимит запросов, технический сбой на стороне Wildberries.

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

Ошибка 5: Расхождения в данных

Причина: Разная частота обновления данных. В кабинете Wildberries данные могут обновляться быстрее, чем через API.

Решение: Учитывайте задержку синхронизации (обычно 15-60 минут). Для сверки используйте данные за один и тот же период времени.

Ошибка 6: Ошибки модерации при загрузке карточек через API

Причина: Неправильно заполнены обязательные поля карточки, неверный формат характеристик, запрещённые символы в названии.

Решение: Перед загрузкой проверьте карточки на соответствие требованиям Wildberries. Убедитесь, что заполнены все обязательные поля: наименование, бренд, страна производства, состав (для одежды), размерная сетка.

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

Одно из главных преимуществ API перед ручной загрузкой - возможность массового редактирования. Рассмотрим типовые сценарии.

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

Через API /api/v1/uploadPrices можно отправить новые цены для всех товаров одним запросом. Это удобно при:

• сезонном переоценивании всего ассортимента;
• акциях и распродажах;
• корректировке цен под конкурентов.

Формат запроса: массив объектов с артикулом продавца, новой ценой и ценой со скидкой. API обрабатывает до 1000 товаров за один запрос.

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

Для схемы FBS критически важно актуально передавать остатки на собственных складах. API /api/v1/warehouse/stocks позволяет загрузить остатки по всем товарам.

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

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

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

Подключение кабинета Wildberries к MP Manager

Сервис внешней аналитики MP Manager поддерживает интеграцию с кабинетом Wildberries через официальный API. После подключения вы получаете единый дашборд с данными по всем магазинам.

Что даёт интеграция

Подключение кабинета к MP Manager открывает доступ к инструментам, которые невозможны при ручной работе с отчётами Wildberries:

• Поиск товарных ниш - анализ категорий Wildberries по объёму рынка, конкуренции, средней цене и динамике спроса. Система автоматически находит ниши с высоким спросом и низкой конкуренцией.

• Анализ конкурентов - детальный отчёт по любому продавцу на Wildberries: ассортимент, цены, динамика продаж, рейтинг, ключевые запросы. Аудит карточек по 30+ критериям.

• Тренды категорий - графики спроса за 1-2 года, сезонные пики и спады, прогноз на следующие 3-6 месяцев. Помогает планировать закупку и поставки.

• Мониторинг цен - отслеживание изменений цен конкурентов и рекомендации по собственной цене для попадания в топ выдачи.

• Автоматические отчёты - регулярная выгрузка отчётов на почту или в Telegram без ручного скачивания из кабинета.

Процесс подключения

1. Зарегистрируйтесь в MP Manager и войдите в личный кабинет.
2. Перейдите в раздел «Мои магазины» → «Подключить магазин».
3. Выберите Wildberries из списка маркетплейсов.
4. Вставьте API-токен, полученный в кабинете Wildberries.
5. Настройте параметры синхронизации: какие данные загружать и за какой период.
6. Дождитесь первой загрузки - обычно 5-15 минут для магазина со 100-200 товарами.

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

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

API-токен даёт доступ к коммерческим данным вашего магазина, поэтому к его хранению нужно подходить ответственно.

Правила безопасного использования

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

Что делать, если токен оказался у посторонних

Немедленно создайте новый токен в кабинете Wildberries и удалите старый. После этого обновите токен во всех сервисах, которые его использовали. Проверьте историю операций в кабинете - нет ли подозрительных действий.

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

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

1. Сверьте общее количество товаров. В сервисе аналитики должно отображаться столько же товаров, сколько в кабинете Wildberries. Расхождение в 1-3% допустимо (архивные позиции могут не попадать в выгрузку).

2. Сравните продажи за последнюю неделю. Откройте отчёт по продажам в Wildberries и в сервисе аналитики. Цифры по заказам и выручке должны совпадать с точностью до комиссий и возвратов.

3. Проверьте данные по остаткам. Остатки на складах - одна из самых динамичных метрик. Убедитесь, что в сервисе отображаются актуальные цифры.

4. Смотрите время последней синхронизации. В интерфейсе сервиса обычно видно, когда данные обновлялись в последний раз. Нормальная задержка - 15-60 минут.

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

Часто задаваемые вопросы

Какие форматы файлов поддерживает Wildberries для импорта?

Wildberries поддерживает загрузку товаров через XLS-шаблоны и через API в формате JSON. XLS-шаблоны подходят для ручного импорта, API - для автоматического.

Можно ли подключить несколько сервисов к одному кабинету Wildberries?

Да. Для каждого сервиса создавайте отдельный API-токен с минимально необходимыми правами. Это упростит управление доступом и позволит отозвать токен одного сервиса, не затронув другие.

Чем отличается импорт через API от загрузки через XLS?

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

Безопасно ли передавать API-токен стороннему сервису?

Да, если сервис использует шифрование при хранении и передаче токенов. Перед подключением убедитесь, что сервис работает по HTTPS, а токены хранятся в зашифрованном виде.

Как часто можно обновлять цены через API?

Wildberries не ограничивает количество обновлений цен через API, но есть лимит на количество запросов в минуту. Типовой лимит - 100-200 запросов в минуту в зависимости от типа API.

Можно ли импортировать фото товаров через API?

Да, Content API Wildberries позволяет загружать и обновлять изображения в карточках товаров. Фото загружаются по ссылкам или через прямой upload.

Почему в сервисе аналитики и в кабинете Wildberries разные цифры продаж?

Возможные причины: разная частота обновления данных, задержки API, различия в методике расчёта (с учётом возвратов или без), временная разница в обработке заказов. Сверяйте данные за один и тот же период.

Нужно ли платить за использование API Wildberries?

Базовый доступ к API Wildberries бесплатный для всех продавцов. Ограничения касаются только количества запросов в минуту. Расширенные тарифы с повышенными лимитами могут быть платными.

Заключение

Импорт товаров в личный кабинет Wildberries - базовая операция, которую можно выполнять как вручную через XLS-шаблоны, так и автоматически через API. Для магазинов с ассортиментом до 50-100 товаров ручного импорта может быть достаточно. Для растущего бизнеса с сотнями и тысячами позиций автоматизация через API становится необходимостью.

Подключение кабинета Wildberries к сервису внешней аналитики через API открывает доступ к инструментам, которые экономят часы ручной работы и помогают принимать решения на основе точных данных: поиск ниш, анализ конкурентов, тренды категорий, мониторинг цен.

Главное - соблюдать правила безопасности: создавать отдельные токены для каждого сервиса, выдавать минимальные права, регулярно обновлять и своевременно отзывать неиспользуемые токены.

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