API Wildberries для продавцов: токен, OAuth 2.0 и категории данных

Как выбрать способ подключения, тип токена, категории данных и уровень доступа WB API. Все 13 категорий, проверка обмена, срок 180 дней и условия обновления подключений.

Содержание

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

Если подключаемый сервис поддерживает OAuth 2.0, предпочтителен этот способ. Токен подходит для собственных программ и разработок, а также для стороннего сервиса без OAuth 2.0. Тип токена выбирают по размещению системы, допустимому получателю доступа и среде тестирования. Категории данных определяют область разрешений, а уровень доступа — можно ли только получать сведения или также изменять их.

Что такое API Wildberries и зачем он продавцу

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

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

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

Персональный токен или OAuth 2.0: что выбрать

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

Способ Кому подходит Как появляется доступ Что важно при выборе
Персональный токен Собственной программе или локальной on-premise системе на своей либо арендованной инфраструктуре Владелец кабинета создаёт токен и самостоятельно настраивает доступ Нельзя передавать третьим лицам или использовать в облачных сервисах
Сервисный токен Конкретному облачному сервису из «Каталога готовых решений для бизнеса» Wildberries Владелец выбирает сервис; категории и уровни доступа заполняются автоматически, создание нужно подтвердить Токен привязан к выбранному сервису и работает только с ним
Базовый токен Для тестирования на реальных данных и случаев, когда не подходят персональный или сервисный токены Владелец самостоятельно выбирает категории и доступ: чтение либо чтение и запись Работа идёт с реальными данными; не путайте с песочницей
Тестовый токен Для разработки и отладки в песочнице WB API Автоматически получает чтение и запись во всех категориях, доступных в тестовом контуре Работает только в песочнице; реальные данные магазина недоступны
OAuth 2.0 Для подключения сервиса, который поддерживает этот протокол Пользователь подтверждает подключение в интерфейсе Wildberries Предпочтительный способ при наличии поддержки в сервисе

Персональный токен: собственная или локальная система

Персональный токен предназначен для собственных программ и корпоративных систем на своей или арендованной инфраструктуре. К этому сценарию относятся готовые ERP/CRM в редакции on-premise, включая коробочную 1С на серверах компании или компьютерах пользователей. Управление пользователями через категорию «Пользователи» доступно только владельцу профиля с персональным токеном; в базовом и сервисном токенах этой категории нет.

Персональный токен нельзя передавать третьим лицам или использовать в облачных сервисах. При создании нужно принять предупреждение об ответственности. Настройки вы выбираете самостоятельно; если неясно, какие параметры нужны, уточните их у разработчика или IT-специалиста, отвечающего за систему.

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

Сервисный токен: облачный сервис из каталога

Для облачного сервиса из «Каталога готовых решений для бизнеса» Wildberries выбирайте сервисный токен. Он привязан к конкретному сервису и работает только с ним. При создании выберите сервис из каталога: необходимые категории данных и уровни доступа заполнятся автоматически. Затем подтвердите создание и передайте токен этому сервису.

Базовый и тестовый токены: разные среды

Базовый токен подходит для тестирования интеграции на реальных данных перед запуском и для случаев, когда нельзя использовать сервисный или персональный токен. Категории данных и уровень доступа — только чтение или чтение и запись — вы выбираете самостоятельно. Ограниченный набор данных для базового токена предусмотрен на будущее.

Тестовый токен нужен для разработки, отладки, изучения методов и проверки новых функций в песочнице WB API. Он работает только со сгенерированными тестовыми данными: реальные данные магазина недоступны. При его создании категории выбирать не нужно — токен автоматически получает чтение и запись во всех категориях тестового контура. Их список может отличаться от списка для обычных токенов; доступные методы и категории проверяйте в документации WB API. Выбирайте среду до начала проверки, чтобы тест на реальных данных не принять за изолированный эксперимент.

Как подключиться по API через OAuth 2.0

При OAuth 2.0 пользователь видит подключаемую интеграцию и подтверждает доступ в интерфейсе Wildberries. Сервис получает авторизацию по протоколу и обрабатывает продление или отзыв доступа. Для подключения используйте инструкцию выбранного сервиса и официальную инструкцию Wildberries «Как подключиться по API через OAuth 2.0».

Как подключиться по API через OAuth 2.0: экран шага 1 в кабинете Wildberries
Как подключиться по API через OAuth 2.0. Шаг 1 в официальной инструкции Wildberries.
Как подключиться по API через OAuth 2.0: экран шага 2 в кабинете Wildberries
Как подключиться по API через OAuth 2.0. Шаг 2 в официальной инструкции Wildberries.
Как подключиться по API через OAuth 2.0: экран шага 3 в кабинете Wildberries
Как подключиться по API через OAuth 2.0. Шаг 3 в официальной инструкции Wildberries.

Как создать токен Wildberries и подключить систему

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

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

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

Как создать, обновить или удалить токен WB API

Как создать, обновить или удалить токен WB API: экран шага 1 в кабинете Wildberries
Как создать, обновить или удалить токен WB API. Шаг 1 в официальной инструкции Wildberries.
Как создать, обновить или удалить токен WB API: экран шага 2 в кабинете Wildberries
Как создать, обновить или удалить токен WB API. Шаг 2 в официальной инструкции Wildberries.
Как создать, обновить или удалить токен WB API: экран шага 3 в кабинете Wildberries
Как создать, обновить или удалить токен WB API. Шаг 3 в официальной инструкции Wildberries.
Как создать, обновить или удалить токен WB API: экран шага 4 в кабинете Wildberries
Как создать, обновить или удалить токен WB API. Шаг 4 в официальной инструкции Wildberries.
Как создать, обновить или удалить токен WB API: экран шага 5 в кабинете Wildberries
Как создать, обновить или удалить токен WB API. Шаг 5 в официальной инструкции Wildberries.
Как создать, обновить или удалить токен WB API: экран шага 6 в кабинете Wildberries
Как создать, обновить или удалить токен WB API. Шаг 6 в официальной инструкции Wildberries.
Как создать, обновить или удалить токен WB API: экран шага 7 в кабинете Wildberries
Как создать, обновить или удалить токен WB API. Шаг 7 в официальной инструкции Wildberries.
Как создать, обновить или удалить токен WB API: экран шага 8 в кабинете Wildberries
Как создать, обновить или удалить токен WB API. Шаг 8 в официальной инструкции Wildberries.
Как создать, обновить или удалить токен WB API: экран шага 9 в кабинете Wildberries
Как создать, обновить или удалить токен WB API. Шаг 9 в официальной инструкции Wildberries.

Категории данных API Wildberries

Категории данных — это разрешения на информацию и операции вашего магазина, а не категории товаров в каталоге. В WB API их 13. Категория определяет, с какой областью работает система; уровень доступа отдельно задаёт, разрешено ли только получать данные или также изменять их.

  1. Опишите операции системы. Например: получать заказы, менять остатки, загружать карточки или публиковать ответы на отзывы. Разделите получение сведений и отправку изменений.
  2. Уточните требования интеграции. Для собственной системы обратитесь к разработчику или ответственному IT-специалисту; для готового сервиса используйте его инструкцию подключения. У сервисного токена нужные категории выбираются автоматически.
  3. Сопоставьте операции с категориями. Используйте карту ниже и учитывайте модель продаж. Не добавляйте разрешения на всякий случай.
  4. Выберите минимально достаточный уровень. «Только чтение» позволяет получать данные, но не менять их. «Чтение и запись» нужно, когда система должна отправлять изменения: например, обновлять статусы или публиковать ответы.

Категория Данные и операции Когда выбирать
Контент Создание и редактирование карточек: названия, описания, характеристики, фото и видео. Получение категорий и характеристик товаров, работа с метками Загружаете товары из учётной системы, синхронизируете изменения карточек или оптимизируете описания через сервис
Аналитика Воронка продаж, поисковые запросы, отчёты по остаткам и возвратам, продажи по регионам, доля бренда, платное хранение и операции при приёмке Анализируете эффективность продаж и спрос, получаете отчёты для планирования закупок
Цены и скидки Изменение цен и скидок, получение информации об акциях, автоматическое добавление товаров в акции Управляете ценами и скидками через внешнюю систему
Маркетплейс Заказы и склады по моделям FBS, DBW, DBS, EDBS и C&C; обновление остатков на складах продавца Передаёте заказы со своего склада в учётную систему, меняете их статусы или синхронизируете остатки
Статистика Детализации к отчётам реализации, списки заказов и продаж Получаете подробные данные для бухгалтерии, финансовых отчётов и анализа рентабельности товаров
Продвижение Создание и управление рекламными кампаниями, изменение ставок, контроль бюджета, статистика эффективности и информация о кампаниях WB Медиа Управляете рекламой и ставками через внешнюю систему или анализируете рекламные расходы
Вопросы и отзывы Получение новых вопросов и отзывов, публикация ответов на них Обрабатываете вопросы о товарах и отзывы, получаете уведомления для работы с репутацией
Чат с покупателем Получение сообщений, отправка ответов, история переписки и работа с жалобами в чате Передаёте обращения из чата Wildberries в CRM или систему поддержки
Поставки Информация для формирования поставок, сведения о поставках и товарах в них по модели «Склад WB» (FBW) Работаете с поставками на склады Wildberries по FBW
Возвраты Получение информации о заявках покупателей на возврат и обработка этих заявок Передаёте заявки в учётную систему или работаете с причинами возвратов
Документы Акты, УПД, печатные формы отчётов и другие документы из раздела «Документы» на WB Partners Скачиваете документы через бухгалтерскую программу, в том числе для загрузки в 1С
Финансы Текущий баланс магазина Автоматически отслеживаете баланс или собираете балансы торговых площадок в системе финансового учёта
Пользователи Приглашение сотрудников, просмотр действующих и приглашённых пользователей, настройка прав и отзыв доступа Владелец профиля управляет доступами через персональный токен. Категория недоступна базовому и сервисному токенам

Категории данных WB API: как выбрать нужные для вашей интеграции: экран шага 1 в кабинете Wildberries
Выбор категорий данных для токена WB API.

При самостоятельной настройке сопоставьте выбранные категории с операциями вашей системы. Для сервисного токена категории подбираются автоматически.

Для склада продавца и склада WB нужны разные категории. «Маркетплейс» относится к заказам и остаткам по моделям «Маркетплейс» (FBS), «Деливери WB» (DBW), «Витрина» (DBS), «Витрина экспресс» (EDBS) и «Самовывоз из магазина продавца» (C&C). «Поставки» относится к модели «Склад WB» (FBW).

«Вопросы и отзывы» не даёт доступ к переписке в чате: для неё нужна категория «Чат с покупателем». Аналогично, «Возвраты» нужна для получения и обработки заявок, а отчёты по возвратам для анализа находятся в области «Аналитика».

Для финансового учёта различайте три задачи: детализации реализации и списки заказов и продаж — «Статистика»; акты, УПД и печатные формы — «Документы»; текущий баланс — «Финансы». Перенос списков отчётов реализации и детализаций финансовых отчётов в «Финансы» предусмотрен как будущее изменение, о котором Wildberries сообщит отдельно в новостях.

Какие разрешения выбрать в типичных сценариях

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

Задача системы Категории Уровень доступа и условие
Получать аналитику продаж и спроса «Аналитика»; дополнительно «Статистика», если нужны детализации реализации Только чтение: система получает данные, но ничего не меняет
Загружать товары из 1С с фотографиями и описаниями «Контент»; дополнительно «Цены и скидки», если система также устанавливает цены Чтение и запись: нужно создавать и изменять карточки
Управлять рекламными кампаниями и ставками «Продвижение»; дополнительно «Аналитика», если решения опираются также на общую эффективность продаж Чтение и запись: система меняет ставки и параметры кампаний
Получать заказы со склада продавца по FBS, DBW, DBS, EDBS или C&C «Маркетплейс» Только чтение для получения заказов; чтение и запись, если система также обновляет их статусы
Комплексно управлять магазином через ERP По используемым функциям: «Контент», «Цены и скидки», «Маркетплейс», «Поставки», «Аналитика», «Статистика», «Документы», «Финансы» Чтение и запись, если ERP действительно управляет магазином и отправляет изменения. Не выдавайте весь набор, если часть функций не используется
Публиковать ответы на отзывы и вопросы, общаться в чате «Вопросы и отзывы» для ответов; «Чат с покупателем» для переписки Чтение и запись: система публикует ответы. Если чат не используется, категория чата не нужна

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

Как изменить набор категорий и отозвать доступ

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

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

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

Каким методам не нужна отдельная категория

«Тарифы», «Новости» и «Информация о продавце» (seller-info) работают с любым активным нетестовым токеном. Для этих справочных методов не нужно выбирать специальную категорию данных.

Срок действия токена и перевыпуск

Срок действия одного токена — 180 дней. За 3 дня до окончания владельцу профиля на WB Partners придёт уведомление в «колокольчик». Вовремя перевыпустите токен и замените его в интеграции, иначе подключённый сервис или собственная система потеряют доступ к данным магазина. Создать новый ключ в кабинете недостаточно — его нужно внести в настройки подключённой системы.

  1. Проверьте дату прекращения действия. Храните её вместе с назначением токена в менеджере паролей или другом защищённом месте.
  2. Перевыпустите токен. Создание выполняет владелец кабинета; доступ должен соответствовать подключаемой системе.
  3. Замените ключ во всех зависимых подключениях. Если один токен используется в нескольких интеграциях, обновите каждую из них.
  4. Проверьте передачу изменений. Повторите проверку в предусмотренном интеграцией направлении.

Что делать при смене владельца кабинета

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

Что делать после смены телефона владельца

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

В разделе «Интеграции по API» появится предупреждение, а на токенах будет указана дата отключения. Ориентируйтесь на эту дату при обновлении всех подключений. За 3 дня до окончания карантина также придёт уведомление. После карантина токены, выпущенные до смены телефона, автоматически отзываются, а интеграции отключаются.

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

Как устроить безопасное подключение

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

  • Храните токены в защищённом месте. Используйте менеджер паролей или защищённое хранилище, а не текстовый файл, мессенджер или общую таблицу.
  • Ограничьте круг сотрудников. Доступ к ключу нужен только ответственным за API-интеграцию.
  • Ведите учёт подключений. Запишите назначение каждого токена и дату прекращения действия; при необходимости — дату создания. Регулярно проверяйте активные ключи в разделе «Интеграции по API».
  • Удаляйте ненужный доступ. При прекращении сотрудничества со сторонним сервисом или разработчиком немедленно удалите токен. Удаление выполняет владелец кабинета. Перед отзывом общего ключа учтите все использующие его системы.

Не публикуйте токен в коде, скриншоте, инструкции или журнале запросов. Если секрет попал в открытый канал, отзовите его, создайте новый и обновите подключение.

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

  • Выдавайте минимум прав. Если система только анализирует данные, ей достаточно чтения; права на изменение цен и карточек для этой задачи не нужны.
  • Разделяйте среды. Для изолированной отладки используйте тестовый токен песочницы. Тестирование на реальных данных с базовым токеном планируйте отдельно.
  • Храните секрет отдельно от кода. Приложение получает его из защищённой конфигурации во время запуска.
  • Фиксируйте вызовы без секрета. В журнале нужны время, метод, результат и идентификатор операции.
  • Ограничивайте повторы. При ошибке предусмотрите паузу и обработку повторного запроса: бесконечный цикл создаёт лишнюю нагрузку и может привести к дублям.
  • Готовьте отзыв доступа. Команда должна знать, какой токен отключить и какие процессы после этого остановятся.

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

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

Ограничения, которые нужно учесть разработчику

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

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

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

Как проверить интеграцию перед запуском

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

  1. Проверьте ключ, срок и разрешения. Убедитесь, что в настройках введён правильный токен, срок его действия не истёк, а категории и уровень доступа соответствуют проверяемой операции.
  2. Проверьте получение данных. Измените в кабинете продавца данные, которые интеграция должна получать. Результат проверки — появление этого изменения в подключённом сервисе.
  3. Проверьте передачу данных, если она предусмотрена. Измените в своей системе только те сведения, которые должны поступать на WB Partners. Результат — появление изменения в кабинете продавца. Для такой операции нужен доступ на чтение и запись в соответствующей категории.

Например, если сервис поддерживает публикацию ответов на отзывы, для проверки нужны категория «Вопросы и отзывы» и чтение и запись. Подготовьте и опубликуйте ответ в сервисе, затем проверьте, появился ли он в кабинете WB Partners. Этот условный сценарий подходит только для интеграции, которая действительно выполняет такую операцию.

Дополнительная приёмка собственной разработки

  1. Сверьте права. Каждый разрешённый раздел должен соответствовать реальной функции.
  2. Пройдите один объект целиком. Возьмите заказ или товар и проследите его от ответа API до конечного отчёта.
  3. Смоделируйте повтор. Повторная загрузка той же записи не должна создавать дубль.
  4. Проверьте восстановление соединения. В тестовой среде прервите обмен и убедитесь, что после восстановления система продолжает работу с предусмотренной контрольной точки.
  5. Проверьте обработку отзыва доступа. Для отдельного тестового подключения убедитесь, что после удаления его токена система показывает понятную ошибку и прекращает защищённые операции. Удаление выполняет владелец кабинета.
  6. Сверьте итог. Сопоставьте остатки, продажи и финансы с контрольной выгрузкой кабинета за тот же период и по тем же объектам.

Финальную прибыль проверяйте через юнит-экономику Wildberries: исправная передача данных ещё не означает, что товар приносит прибыль.

Что делать, если интеграция не работает

Сначала проверьте правильность токена и срок действия. Если прошло 180 дней, создайте новый ключ и замените его в сервисе. При общем токене обновите все использующие его интеграции. Если владелец менял телефон, проверьте предупреждение и дату отключения в разделе «Интеграции по API», затем перевыпустите токены и обновите подключения.

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

Проблема Куда обращаться и что сделать
Ошибка собственной интеграции Обратитесь к разработчику, который создал интеграцию под ваши задачи
Не работает сторонний сервис Обратитесь в поддержку этого сервиса. У большинства сервисов из каталога контакты и инструкции есть на странице сервиса
Сбой или общие вопросы по WB API Проверьте официальную документацию и статус работы API. В поддержке продавцов Wildberries создайте обращение в категории «API»
Несанкционированный вход в профиль В поддержке продавцов создайте обращение с темой «Несанкционированный вход» в категории «Безопасность личного кабинета»

Плюсы и ограничения API

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

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

Кому подходит API Wildberries

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

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

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

Хотите познакомиться с SelSup для работы на маркетплейсах? Запишитесь на демонстрацию SelSup.

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

  • Персональный токен для облачного сервиса. Такой способ использования запрещён. Проверяйте тип токена по размещению системы и допустимому получателю доступа.
  • Один токен для всех сервисов. При его удалении остановятся все зависимые подключения. Создавайте отдельный ключ для каждой интеграции; при перевыпуске общего ключа заменяйте его везде.
  • Пропущенный срок обновления. Через 180 дней доступ по токену прекращается. Храните дату окончания в защищённом учёте и обновляйте ключ в подключённой системе.
  • Смена телефона без обновления подключений. Во время карантина часть запросов выполняется с ошибками, а после его окончания старые токены отзываются. Перевыпустите ключи до указанной даты отключения.
  • Максимальные права без необходимости. Система, которой нужно только чтение, получает лишнюю возможность менять данные. При самостоятельной настройке выдавайте только нужные категории и уровень доступа.
  • Неверная категория для операции. Доступ к балансу через «Финансы» не заменяет детализации реализации в «Статистике», а «Поставки» для FBW не заменяет «Маркетплейс» для заказов со склада продавца. Сверьте задачу с картой категорий до создания ключа.
  • Секрет в общей таблице. Ключ могут скопировать люди, которые не отвечают за интеграцию. Используйте защищённое хранилище и ограничивайте доступ.
  • Повтор без дедупликации. Один заказ или расход может учитываться дважды. В собственной системе предусмотрите уникальный идентификатор и идемпотентную запись.
  • Отсутствие контрольной сверки. Обмен работает технически, но отчёт может расходиться с кабинетом. Сопоставляйте контрольную выгрузку и суммы за один период.

Итог: с чего начать

Выберите одну операцию, которая регулярно отнимает время или создаёт ошибку. Проверьте поддержку OAuth 2.0 в сервисе; если нужен токен, выберите его тип по системе и среде. Сопоставьте операции с категориями и определите, достаточно ли чтения или нужна запись. Владелец кабинета создаёт ключ, настраивает допустимый доступ и вносит его в интеграцию. Затем проверьте появление изменений на принимающей стороне.

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

Каналы SelSup

Продолжайте читать и смотреть

Новости маркетплейсов, автоматизация и практические разборы ИИ — на удобной для вас площадке.

Следующий шаг

Раскроем секреты высокой маржи ТОП-продавцов

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

Больше лайфхаков для селлеров и полезных советов — в нашем телеграм-канале
Подписаться на рассылку
Присоединяйтесь к списку наших подписчиков, чтобы получать последние обновления и статьи на ваш e-mail.
Спасибо!
Ваша заявка принята. Мы свяжемся с вами в ближайшее время.