Как работать по api с wildberries

API-ключ Wildberries: что такое, как подключить и интеграция с личным кабинетом

На сегодняшний день появилось много сервисов аналитики Wildberries и модель работы с маркетплейсом – FBS или продажа со склада поставщика. Большинство клиентов используют интеграцию посредством API с Wildberries специальным ключом.

В этой статье вы найдете инструкцию по получению api и последующему его использованию.

Что такое API для Wildberries и зачем он нужен?

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

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

Это удобный способ интеграции с сервисами аналитики или с такими программами, как 1С, Мойсклад при работе по модели FBS, которые призваны помочь поставщикам при ведении бизнеса на Wildberries.

Преимущества API

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

Как подключить API через личный кабинет поставщика WB

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

API-ключ есть

Откройте свой личный кабинет поставщика Wildberries.

Если идентификатор уже есть, то он будет доступен в разделе «Доступ к API». Если вы его не нашли, то его нужно запросить в службе поддержки. Как это сделать, смотрите ниже в пункте «Ключа нет».

Скачайте документ «API-ключ.txt». При этом в файле будут две строки «Ключ» и «Ключ Base64». Вам потребуется именно «Ключ Base64».

Как воспользоваться этим, покажем вам на примере сервиса Stat4market.

• Скопируйте «Ключ Base64».
• Найдите в личном кабинете «Аналитика по API» >> «Интеграция».
• Вставьте скопированное ранее в строку и нажмите «Подключить».

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

Ключа нет

Вы провели проверку наличия идентификатора, как описано выше, и если у вас нет раздела «Доступ к API» и файла «API-ключ.txt», то следует запросить его в службе поддержки поставщиков Wildberries.

Перейдите в раздел Service Desk в личном кабинете:

• У вас откроется форма создания заявки.
• Далее «Категория» >> «Поддержка».

В поле «Комментарий» написать:

«Здравствуйте! Можно мне предоставить API-ключ для интеграции? Спасибо!»

Нажать кнопку «Создать заявку».

После создания заявки выдача займет около 24 часов.

Служба поддержки WB создаст вам личный идентификатор. Он появится в разделе «Шаблоны документов». Далее нужно будет сделать то, что описано в пункте «API-ключ есть» выше.

Особенности работы

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

Однако через некоторое время данные появятся за предыдущие 90 дней включительно.

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

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

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

Ответы на вопросы

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

К слову, такая модель появилась у WB не так давно. Для маркетплейсов типа Ozon или Lamoda это уже давно стандартная практика. В этой модели есть свои плюсы и минусы.

Запрос возможен 1 раз в 60 секунд.

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

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

В завершение

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

Модель FBS, которая сейчас приобретает популярность среди поставщиков, тоже нуждается в таком методе интеграции с программами складского учета. Но такая синхронизация с Вайлдберриз требует привлечения специалистов.

Что такое доступ по API Wildberries: ключ, документация

Мой выбор!

25 февраля стартует мой онлайн-курс по SEO-оптимизации карточек на WildBerries. На котором я расскажу тебе, как увеличить показы карточки и поднять ее в ТОП!

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

ЧТО ТАКОЕ API-КЛЮЧ ДЛЯ WILDBERRIES?

АПИ-ключ для «Вайлдберис» – это цифровой идентификатор, который является уникальным для каждого поставщика маркетплейса. При помощи него можно осуществлять обмен данными между сервером Wildberries и софтом пользователя, например, 1С, «МойСклад» и так далее. Сам идентификатор состоит из уникальной последовательности символов, которая разделена на 2 части по 32 и 64 знака. Ключ на 64 и нужен для обмена данных со своим софтом.

КАКИЕ ДАННЫЕ МОЖЕТ ПЕРЕДАТЬ API-КЛЮЧ?

Данные по заказу

Данные по складам

Данные по финансам

Товары в заказе

Затраты на логистику

Время прибытия и отбытия

Точные суммы перечисления

Другие данные по финансам за неделю

ПРЕИМУЩЕСТВА АПИ-КЛЮЧА ДЛЯ WILDBERRIES

Можно выделить следующие достоинства API-ключа для «Вайлдберис»:

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

КАК РАБОТАЕТ API-КЛЮЧ?

Как только пользователь подключить АПИ-ключ к своей системе аналитики, она сразу же начнет накапливать данные. Правда, на накопление требуется время. Поэтому через 1,5-2 недели владелец сможет увидеть ясную картину по своему ассортименту и провести полную аналитику по финансам, товарам, складам и передвижению заказов. А значит, продавец на Wildberries, используя полученные аналитические данные, сможет:

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

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

Другой сложностью использования АПИ-ключа является лимит запросов. То есть для получения максимум информации о своей работе в маркетплейсе следует подключать API-key к одному аккаунту в сервисе и к одной аналитической программе. В противном случае данные на разные сервисы будут поступать обрывочными, а значит, будет страдать качество аналитики. Поэтому подключать ключ можно только к одной программе.

КАК ПОЛУЧИТЬ API-КЛЮЧ В WILDBERRIES?

Для любого магазина в маркетплейсе «Вайлдберис» есть свой уникальный API-ключ, который находится в личном кабинете поставщика. Для получения этой последовательности символов необходимо перейти в раздел «Настройки», а затем кликнуть на «Доступ по API». В этом разделе находится 2 ключа: на 32 и 64 символа. Для интеграции в аналитическую программу необходимо скопировать второй вариант на 64 знака.

Теперь для начала сбора аналитических данных необходимо его интегрировать в выбранную программу аналитики. Конкретные действия написать здесь трудно, так как все подобные сервисы отличаются друг от друга, но общий принцип есть. Необходимо в личном кабинете аналитической программы найти надпись: «Аналитика по API» – (или что-то похожее), вставить скопированный ключ в строку и кликнуть по «Подключить».

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

ЧТО ДЕЛАТЬ, ЕСЛИ КЛЮЧА API НЕТ НА МЕСТЕ?

В некоторых ситуациях АПИ-ключа может не быть в разделе «Доступ по API». Сейчас, конечно, такое происходит редко, благодаря постоянной работе технической службе поддержки, которая успешно пофиксила этот баг. Тем не менее, риск оказаться без индивидуального идентификатора еще остается. На самом деле, API-ключ есть, просто он не отображается в личном кабинете. Чтобы его получить, необходимо следовать этой пошаговой инструкции:

• Зайти в личный кабинет поставщика на Wildberries и перейти в раздел «Service Desk».
• Появится форма создания заявки.

• В разделе «Категория» выбрать «Поддержка».
• А в поле комментарий написать: «Доброго времени суток! Можете передать мне индивидуальный API-ключ для интеграции? Спасибо!» – или что-то в этом роде.
• Нажать кнопку «Создать заявку».

После отправки заявки служба поддержки вышлет личный АПИ-ключ в течение суток. После этого его можно будет скопировать и интегрировать в выбранную вами аналитическую программу. Как это сделать было максимально подробно рассмотрено в предыдущем блоке. Стоит отметить, что в службу поддержки «Вайлдберис» можно обращаться по любым вопросам и спорным ситуациях. Этот отдел маркетплейса всегда оперативно и максимально развернуто отвечает.

ВЫВОДЫ

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

API Wildberries: что это такое и как его получить

Что это такое? API Wildberries – это идентификационный ключ для работы с данными маркетплейса. Благодаря ему продавцу удастся проанализировать информацию о заказе, продажах (своих и конкурентов) и многое другое.

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

Что такое API-ключ Wildberries

API, то есть Application Programming Interface, переводится как «интерфейс программирования приложений» или «программный интерфейс приложения». Эта аббревиатура означает комплекс готовых классов, функций, процедур, структур и констант.

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

• Как в 2023 вывести товар в ТОП Wildberries за 1 день
• Кто получит бан на Wildberries WB в ближайшие 2 недели
• Самовыкупы — ДА или НЕТ?

Сооснователь компании Маркет Гуру

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

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

К ней относится следующая информация:

• В каком регионе находится покупатель.
• Сколько товарных единиц приобретает покупатель в рамках одного заказа.
• Какие товары проданы и вручены клиенту, какие возращены на склад.
• Статус конкретного заказа.
• Количество единиц, которые остались на складе.
• Анализ продавцов-конкурентов.
• Финансовая информация (сумма комиссионных сборов, затраты на логистические услуги и пр.).
• Какие товары в настоящее время находятся в пути на ПВЗ, какие доставляются после возврата.

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

Где взять API-ключ Wildberries

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

У вас имеется API-ключ / У вас есть API-ключ, но вы об этом лишь догадываетесь

Для начала зайдите в свой личный кабинет и перейдите в раздел «Доступ к API». Если у вас есть ключ, то информация о нем будет там отображена. Если же данные о API нет, запросите ключ в службе поддержке (смотрите пункт 2).

Далее скачайте файл «API-ключ.txt» в личном кабинете. В скачанном документе вы увидите «Ключ» и «Ключ Base64». Вас интересует «Ключ Base64».

Рассмотрим вариант использования API-ключа Wildberries на примере сервиса MarketGuru.io.

Сначала нужно скопировать ключ «Ключ Base64» и вставить его в поле для текста «API ключ». Оно находится на странице загрузки данных. Далее следует нажать «Сохранить».

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

Name already in use

wildberries_api / README.md

• Go to file T
• Go to line L
• Copy path
• Copy permalink

• Open with Desktop
• View raw
• Copy raw contents Copy raw contents

Copy raw contents

Copy raw contents

Описание работы API Wildberries

Создание карточки/карточек товаров.

CardByImtID. https://suppliers-api.wildberries.ru/card/cardByImtID

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

Для начала работ обязательно необходимо убедится, что Вы входили на https://suppliers-portal.wildberries.ru/ в качестве поставщика со своим номером телефона. В личном кабинете поставщика номер телефона должен быть связан с поставщиком иначе доступа для работы с карточками товара не будет.

Всё взаимодействие ведётся в рамках протокола json-rpc

Номер телефона должен быть связан также с учётной записью на сайте https://www.wildberries.ru/

https://t.me/wildberriesApiForDev
⚠️ Не официальная группа по обсуждению API Wildberries

Особенности работы системы:

1. Тестового окружения для поставщиков не предусмотрено. Все карточки сразу создаются в продуктовой среде. В случае ошибок, для исправления которых нет методов в API можно обращаться в службу поддержки с темой Заявка на API Content
2. Цены для карточек указываются на момент создания — это требование системы. Изменение цен происходит в разделе «Цены и скидки». Также можно воспользоваться API

Аутентификация с помощью токена

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

Раздел и генерация токена доступна только владельцу аккаунта!

Указать имя токена и нажать кнопку Сгенерировать токен Вам будет предоставлен токен доступа для работы с API — его сразу необходимо скопировать.
При повторном заходе на страницу получения токена скопировать уже выпущенные токены не удастся.
Время жизни токена не ограничено, но его можно отозвать (удалить).
На странице будет доступна информация о дате создания и дате последнего использования токена.
Токен доступа представляет собой jwt-токен, состоящий из 3 частей: тип и алгоритм шифрования, «accessID» пользователя, подпись токена — для проверки его целостности.
Проверить на валидность токен можно на https://jwt.io/

Работа с карточками товара

Перед началом работы, если есть необходимость в изучении API на примере — можно посмотреть принцип работы https://suppliers-portal.wildberries.ru/goods/products-card/
Через инструмент разработчика — сеть.
Все запросы идентичны и отличаются лишь заголовками и URL

Создание одной карточки (POST /card/create)

Описание: метод позволяет создать одну новую карточку товара.

Параметры запроса- отсутствуют

Тело запроса выглядит следующим образом:

https://suppliers-api.wildberries.ru/card/batchCreate Описание: метод позволяет создавать сразу много карточек.

Тело запроса выглядит следующим образом:

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

params , в свою очередь, содержит следующие поля для более удобного хранения характеристик:

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

В результате в формате json вернётся список характеристик данной категории товаров (в примере используется категория Кроссовки ) и требования к ним. Получение списка возможных категорий товаров будет описано ниже в пункте “Поиск ключа объекта”. Некоторые характеристики требуется заполнять из словарных значений. Для получения списка возможных значений характеристик используется следующий запрос:

В данном запросе имеется 3 параметра: pattern позволяет указать шаблон для поиска значения характеристики; lang — обязательный параметр, на данный момент используется только ru ; top — ограничение по количеству объектов, если не указано — 10 шт.

Список всех доступных категорий можно получить запросом

Для получения карточек существует метод:

CardByImtID. https://suppliers-api.wildberries.ru/card/cardByImtID

Описание: метод позволяет получить карточку поставщика с указанным ID. Тело запроса выглядит следующим образом:

Описание: метод позволяет обновить одну карточку товара.

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

Пример тела для обновление карточки:

Метод POST https://suppliers-api.wildberries.ru/card/deleteNomenclature

Описание: метод позволяет удалить номенклатуру из карточки поставщика с указанным ID. Тело запроса выглядит следующим образом:

Описание: метод позволяет получить список карточек по указанным параметрам. Фильтрация позволяет исключить из итогового списка карточек те, в которых указанное поле column содержит значение excludedValues . Поиск позволяет оставить в итоговом списке карточек только те, у которых поле column имеет значение search , если это число, если это строка, то значение поля начинается с search . Сортировка позволяет отсортировать список по полю column в порядке order . query содержит значения limit и offset который указывают соответственно на максимальное количество карточек, которые надо вывести и на количество карточек, которые с самого начала списка нужно пропустить. Наименования полей соответствуют пути до этого поля через точку. Так, например, чтобы добраться до поля barcode , понадобится путь nomenclatures.variations.barcode . Исключения — параметры, лежащие внутри структуры addin . Чтобы добраться до них, требуется в пути после addin через точку указать type этого параметра. Например, чтобы получить бренд , потребуется путь addin.Бренд . Бренд написан с большой буквы, так как type был написан тоже с большой. Тело запроса выглядит следующим образом:

В результате вышеприведённого запроса нам вернутся все карточки поставщика 00000000-0000-0000-0000-000000000000 , среди которых не будет карточек с красными цветами и джинс, у всех карточек будут товары с размером “M”. И все эти карточки будут отсортированы по дате создания в порядке возрастания (сначала старые).