API ВБ (Wildberries): как подключить и что выгружать

Учебный пример подключения API ВБ: магазин использует 2 программы — облачную аналитику из каталога WB и локальную 1С на своём сервере. Первой нужен сервисный токен, второй — персональный. Если аналитика только забирает данные, ей не нужны права менять магазин. Для загрузки изменений из 1С одного чтения уже мало: потребуется доступ «Чтение и запись».

#Что такое API ВБ и какие задачи он решает?

WB API связывает магазин с программой, которая получает или меняет его данные. Через такую связь можно передавать заказы на сборку, анализировать продажи, работать с товарами и рекламой. Ещё один сценарий — обмен с внутренней учётной системой, например 1С.

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

Готовую программу выбирают среди сервисов для селлеров. Разработка нужна, когда вы сами определяете, какие данные принимать и куда их передавать. Остальные процессы магазина собраны в разделе Wildberries для продавцов.

#Какой API-код Wildberries нужен сервису и собственной программе?

Кодом или ключом доступа обычно называют токен. Это отдельный секрет для программы, а не пароль, которым человек входит в кабинет. WB предлагает 4 типа токенов; выбор зависит от места работы программы и от того, реальные ли данные ей нужны.

Для облачной аналитики из примера подходит сервисный токен. Его настройки заполняются по требованиям выбранного сервиса. Если программа поддерживает OAuth 2.0, в окне подключения появится соответствующий вариант: WB рекомендует его вместо ручной передачи ключа.

Персональный токен подходит системе, установленной на вашем или арендованном сервере (не в облаке разработчика). Само название «1С» ещё не определяет тип: сначала нужно выяснить, какая версия подключается. Для облачной версии нельзя брать персональный токен только потому, что у неё знакомый бренд.

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

#Где получить API Wildberries и как создать токен?

Раздел находится в профиле: «Интеграции по API». Создавать и удалять токены может только владелец. Доступ сотрудника к другим функциям кабинета сам по себе этого права не даёт.

1. 1

   Откройте окно создания

   В разделе «Интеграции по API» нажмите «+ Создать токен».

2. 2

   Укажите тип подключения

   Откройте «Для интеграции вручную» и выберите персональный токен для программы на своей инфраструктуре.

3. 3

   Назовите систему и выберите категории

   Например, «1С на сервере компании». Отметьте только данные, с которыми работает интеграция.

4. 4

   Задайте уровень доступа

   «Только чтение» для получения данных; «Чтение и запись» для изменений в магазине. Примите предупреждение о рисках.

5. 5

   Сохраните ключ

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

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

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

#Какие права нужны WB Seller API для выгрузки продаж?

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

Перед настройкой API продаж Wildberries полезно составить задание для разработчика из 4 строк:

• Какие данные получать: например, продажи магазина для учётной системы.
• Куда сохранять результат: в конкретную базу или отчёт.
• Нужно ли менять что-либо на WB или только читать.
• Как проверить результат: выбрать период и сравнить одинаковые показатели.

Для заказов задача другая: получить информацию о новых заказах и передать её на сборку. Названия вроде orders или suppliers в старых примерах не говорят, что делает метод. Разработчику нужно найти в документации операцию, которая отвечает именно за нужный этап, например за получение новых заказов.

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

#Где искать документацию и чем отличаются Wildberries API v1 и v3?

Для собственной интеграции WB направляет на портал разработчиков. Там нужно выбирать описание конкретной операции. Обозначения v1 и v3 в найденном примере сами по себе не объясняют, какие данные получит ваша программа.

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

Для второго маркетплейса подключение рассматривается отдельно: Ozon Seller API. Настройки доступа Wildberries не описывают подключение магазина Ozon.

#Как проверить обмен с 1С или готовым сервисом?

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

WB приводит пример с отзывом: подготовленный в сервисе ответ должен появиться в WB Partners (портал продавца) после публикации, если интеграция работает правильно. Передача цен проверяется отдельно. Это другая функция.

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

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

#Почему интеграция не работает и куда обращаться?

Сначала проверяют правильность токена и срок. После 180 дней ключ перестаёт работать, поэтому программа с истёкшим токеном не получит сведения даже при верно выбранных категориях доступа. Затем проверяют тип. Персональный не подходит облачному сервису; сервисный привязан к одной программе. Тестовый не получает реальные сведения магазина.

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

Собственную интеграцию исправляет её разработчик, готовый сервис — его поддержка. При сбое WB справка предлагает проверить статус API либо создать обращение в категории «Интеграции по API». При подозрении на взлом используют другую категорию: «Безопасность личного кабинета», тему «Несанкционированный вход».

#Как заменить токен и закрыть ненужный доступ?

Продление невозможно. WB рекомендует обновлять токен за 7–14 дней до конца срока. За 3 дня до окончания срока владельцу приходит уведомление на портале WB Partners, но ждать его не стоит.

Порядок замены: в разделе «Интеграции по API» найти токен и нажать «Дублировать» — откроется окно создания нового токена с теми же настройками. Затем скопировать новый токен и заменить им старый в подключённых системах. Старый удаляют после нескольких дней проверки работы нового.

При утечке ждать проверки нельзя: токен нужно немедленно удалить и выпустить другой. Если работа с сервисом закончилась, его ключ удаляют без замены. Секрет хранят в менеджере паролей или защищённом хранилище; в своём списке подключений (например, в таблице) оставляют название системы, ответственного и срок, но не сам токен.