Дайджест WB API — Январь 2025

В свежем выпуске нашего ежемесячного дайджеста мы расскажем о новых функциях и обновлениях, которые вышли в январе 2025

1990
content

Обновления WB API за январь 2025

В январе мы внесли ряд важных обновлений в API. Рассказываем о ключевых изменениях в нашей ежемесячной рубрике


Отключение устаревшего домена suppliers-api.wildberries.ru

Дата отключения: 30 января 2025

Мы переводим все методы Контента, Маркетплейса и Новостей с домена suppliers-api.wildberries.ru на новые, чтобы унифицировать и упорядочить структуру доступных сервисов, а также внедрять обновления и фиксы более адресно.

Новые домены:

  • content-api.wildberries.ru — Контент
  • marketplace-api.wildberries.ru — Маркетплейс
  • common-api.wildberries.ru — Новости

Если у вас уже настроены интеграции через suppliers-api.wildberries.ru, проверьте и обновите URL-адреса на новые домены. Иначе с 30 января 2025 года методы станут недоступны, что может привести к сбоям в работе.

📄 Новости

Реклама и продвижение: новое поле в методе получения конфигурационных значений

В структуру ответа метода добавлена информация о категориях товаров с их минимально допустимыми ставками (categories). Теперь при запросе конфигурационных параметров вы получите массив категорий, каждая из которых имеет:

  • id — ID категории,
  • name — название категории,
  • cpm_min — минимально допустимая ставка.

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

📄 Создание кампаний

Новый метод получения информации о продавце

Добавили метод, позволяющий по любому токену (не тестовому) получить:

  • Наименование продавца,
  • ID (sid) аккаунта,
  • Торговое наименование (tradeMark).

В чём польза?

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

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

📄 Информация о продавце

Документы и бухгалтерия: новые поля в детализациях к еженедельным отчётам реализации

В еженедельный отчёт о продажах по реализации добавлены поля:

  • dlv_prc — Фиксированный коэффициент склада по поставке
  • fix_tariff_date_from — Дата начала действия фиксации
  • fix_tariff_date_to — Дата окончания действия фиксации
  • payment_processing — Тип платежа за Эквайринг/Комиссии за организацию платежей
  • srv_dbs — Признак услуги платной доставки
  • assembly_id — Номер сборочного задания
  • is_legal_entity — Признак B2B-продажи
  • trbx_id — Номер короба для платной приёмки

Почему это важно?

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

Интересные бизнес-кейсы:

  1. B2B-продажи: поле is_legal_entity даёт понять, в каких случаях клиент выступал в роли юридического лица — это важно при ведении отдельных договоров и бухгалтерии.
  2. Анализ комиссионной части: dlv_prc, payment_processing, srv_dbs позволяют рассчитывать итоговую маржинальность. Продавцы могут автоматизировать расчёт эффективной маржи в зависимости от разных типов доставок и эквайринга.
📄 Финансовые отчёты

Переходим на новый портал WB API

С 28 января 2025 года при посещении устаревшего портала openapi.wb.ru вы будете автоматически перенаправлены на новый dev.wildberries.ru.

На новом портале вы найдёте:

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