API Wildberries: что это такое и как его получить
Скачайте бесплатное расширение
"Аналитика Wildberries"
Скачать расширение

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

Api для wildberries WB для продвинутых

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Когда все процессы будут завершены, вы можете использовать все предложенные разделы на MarketGuru.

У вас нет API-ключа

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

Чтобы запросить доступ, нужно зайти в раздел Service Desk и заполнить форму заявки.

В «Категории» необходимо открыть пункт «ПОДДЕРЖКА».

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

В комментарии пропишите запрос на ключ.

«Добрый день! Прошу предоставить доступ к API Wildberries.ru для интеграции».

Отправьте заявку, нажав на кнопку «Создать заявку».

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

Как правило, ключ готовится в течение суток. Уже спустя 24 часа он будет отображен в разделе «Шаблоны документов». Как с ним работать далее, мы рассказали в первом пункте.

Важные моменты в работе с API-ключом Wildberries

  • Статистику о товарах и их движении можно наблюдать только после получения API Wildberries. К примеру, если он появился у вас 7 апреля, то информация о заказах доступна только с этой даты. Посмотреть статистические сводки за более ранний период в начале использования API нельзя.

Спустя некоторое время такая возможность все же появится, но когда именно это случится, точно неизвестно. Посмотреть сводку о предшествующих заказах можно будет только за 90 дней до момента приобретения ключа. По какому принципу появляется информация – это пока загадка.

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

Читайте также: Боты для Wildberries в Telegram.: подборка самых популярных

Несмотря на перечисленные недостатки, стоит отметить, что сервис достаточно быстро устраняет проблемы. В некоторых редких случаях на восстановление корректности сводки уходит более 24 часов.

Важные моменты в работе с API-ключом Wildberries

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

  • API не содержит все сведения, отображенные в личном кабинете. Например, он не отображает данные по листу ожидания.
  • Запрашивать информацию от Wildberries можно не чаще одного раза в минуту.

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

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

Вебинары, которые помогут в 2023 году успешно стартовать на маркетплейсах:
Как заработать первые
100 000 на OZON за 14 дней
Вы узнаете:
На продаже каких товаров легче заработать
новичку
3 ошибки, из-за которых товар на OZON плохо продается
Узнать подробнее
Как стать менеджером WB и заработать от 100000
Вы узнаете:
Как работать по 3-4 часа в день из дома и зарабатывать от 100к?
Как гарантированно получить клиентов сразу после обучения
Узнать подробнее
Что делать, если карточка товара не выходит в ТОП?
Вы узнаете:
3 основные причины, по которым ваша карточка «не продает»
Как профессионально настроить карточку своими руками?
Узнать подробнее

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

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

Читайте также: Документы для Wildberries: требования маркетплейса

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

Все это стоит учитывать, так как могут возникнуть серьезные трудности при работе с другими сервисами.

Часто задаваемые вопросы в работе с API-ключом

Дает ли API-ключ возможность получить сведения по листу ожидания?

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

Нужен ли API для работы по схеме «Продажа со склада поставщика»?

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

Часто задаваемые вопросы в работе с API-ключом

Отметим, что эта модель была спроектирована для Wildberries относительно недавно. На Ozon она введена еще несколько лет назад. У нее есть свои достоинства и недостатки.

Ошибки в работе с API-ключом

Одна из распространенных ошибок: ваш API-ключ не работает.

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

  1. Ключ введен неверно — введите API снова

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

  1. API-ключ не активен

Ошибки в работе с API-ключом

Чтобы проверить, активен ли ключ, его необходимо отредактировать по следующему алгоритму.

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

https://suppliers-stats.wildberries.ru/api/v1/supplier/sales?dateFrom=2021-01-12(предыдущая дата)T00:00:00.000Z&flag=1&key=ваш ключ.

  1. Если появилось большое количество данных о поставках, значит, ключ активен.
  2. Появление одной строчки можно связать со следующими причинами:
    • Ключ активен, но в указанную дату не было продаж. Чтобы проверить наверняка, нужно выбрать день, когда были продажи.
    • Ключ активен, но выбранная дата не относится к периоду, данные за который сохранены. Указывайте дату в диапазоне последних трех месяцев, а лучше – еще раньше.
    • В других случаях ключ не активен и требует перевыпуска. О том, как получить новый ключ, мы рассказали выше.

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

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

Оцените статью
Рейтинг: 5
( голосов 3 )
×
Максим Гральник
Сооснователь MarketGuru
Максим Гральник печатает ...