- Что такое API-ключ Wildberries
- Где взять API-ключ Wildberries
- У вас имеется API-ключ / У вас есть API-ключ, но вы об этом лишь догадываетесь
- У вас нет API-ключа
- Важные моменты в работе с API-ключом Wildberries
- Часто задаваемые вопросы в работе с API-ключом
- Дает ли API-ключ возможность получить сведения по листу ожидания?
- Нужен ли API для работы по схеме «Продажа со склада поставщика»?
- Ошибки в работе с API-ключом
Что это такое? 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-ключ.txt» в личном кабинете. В скачанном документе вы увидите «Ключ» и «Ключ Base64». Вас интересует «Ключ Base64».
Рассмотрим вариант использования API-ключа Wildberries на примере сервиса MarketGuru.io.
Сначала нужно скопировать ключ «Ключ Base64» и вставить его в поле для текста «API ключ». Оно находится на странице загрузки данных. Далее следует нажать «Сохранить».
После того как данные сохранятся, начинается процесс получения сведений о продукции, которую вы продаете на Wildberries. Также здесь формируется база данных, история покупок потребителей за последние три месяца.
В это же время информация тщательно анализируется. В некоторых случаях система справляется с такой задачей за считанные секунды, чаще – за несколько минут. Все зависит от того, сколько товарных единиц в вашем магазине.
Когда все процессы будут завершены, вы можете использовать все предложенные разделы на MarketGuru.
У вас нет API-ключа
Итак, выше мы рассказали, как проверить наличие ключа. Если у вас нет раздела в личном кабинете Wildberries «Доступ к API» и файла «API-ключ.txt», вам нужно сделать запрос на доступ новому API через техническую поддержку.
Чтобы запросить доступ, нужно зайти в раздел Service Desk и заполнить форму заявки.
В «Категории» необходимо открыть пункт «ПОДДЕРЖКА».
В комментарии пропишите запрос на ключ.
«Добрый день! Прошу предоставить доступ к API Wildberries.ru для интеграции».
Отправьте заявку, нажав на кнопку «Создать заявку».
Как правило, ключ готовится в течение суток. Уже спустя 24 часа он будет отображен в разделе «Шаблоны документов». Как с ним работать далее, мы рассказали в первом пункте.
Важные моменты в работе с API-ключом Wildberries
- Статистику о товарах и их движении можно наблюдать только после получения API Wildberries. К примеру, если он появился у вас 7 апреля, то информация о заказах доступна только с этой даты. Посмотреть статистические сводки за более ранний период в начале использования API нельзя.
Спустя некоторое время такая возможность все же появится, но когда именно это случится, точно неизвестно. Посмотреть сводку о предшествующих заказах можно будет только за 90 дней до момента приобретения ключа. По какому принципу появляется информация – это пока загадка.
- Обновление информации по API и в личном кабинете Wildberries происходит по разным алгоритмам. Порой то, что есть в личном кабинете, не отображается в ключе, или наоборот. Маркетплейс периодически задерживается с размещением информации, из-за чего возникают расхождения в сводках.
- API WB в настоящее время еще не может работать стабильно, что говорит о возможных расхождениях информации по API-ключу. Так как данные API синхронизируются с Wildberries, возможны сбои в работе.
Читайте также: Боты для Wildberries в Telegram.: подборка самых популярных
Несмотря на перечисленные недостатки, стоит отметить, что сервис достаточно быстро устраняет проблемы. В некоторых редких случаях на восстановление корректности сводки уходит более 24 часов.
Сама площадка сообщает, что в настоящее время специалисты занимаются развитием API и, возможно, уже в ближайшее время неполадки будут устранены.
- API не содержит все сведения, отображенные в личном кабинете. Например, он не отображает данные по листу ожидания.
- Запрашивать информацию от Wildberries можно не чаще одного раза в минуту.
Давайте рассмотрим пример. При отправке запроса сервисом на получение информации следующий доступ откроется только через 60 секунд. В случае повторной отправки раньше этого маркетплейс выдаст информацию об ошибке. После каждого сообщения со стороны системы время отсчета начинается вновь.
Это говорит, что специалист, выполняющий запрос, должен быть аккуратным. Подход к вопросу о месте сохранения API-ключа требует особенной тщательности. Не стоит размещать один и тот же ключ на разных сервисах. В таком случае может возникнуть «конфликт». Отправленные запросы, возможно, будут пересекаться, из-за чего полученные данные окажутся недостоверными.
К примеру, когда 10 различных сервисов раз в час отправляют по запросу, то примерно 10 минут каждый час система будет зависать и не выдавать информацию.
В действительности масштаб проблемы гораздо шире, чем кажется на первый взгляд. Количество запросов может быть значительно больше, в таком случае лимиты исчерпаются слишком быстро. Это грозит тем, что пользователь вообще не сможет полноценно использовать API-ключ. Тогда сервис аналитики лишается возможности получать актуальную статистическую сводку стабильно.
Читайте также: Документы для Wildberries: требования маркетплейса
Очевидно, что добавление ключа должно осуществляться только на самых важных для продавца сервисах. Если один из них вам больше не нужен, не поленитесь и напишите в техническую поддержку письмо с просьбой удалить API-ключ и не отправлять запросы.
Все это стоит учитывать, так как могут возникнуть серьезные трудности при работе с другими сервисами.
Часто задаваемые вопросы в работе с API-ключом
Дает ли API-ключ возможность получить сведения по листу ожидания?
Нет. Такая возможность не предусмотрена API-идентификатором Wildberries, но это можно сделать в личном кабинете маркетплейса.
Нужен ли API для работы по схеме «Продажа со склада поставщика»?
Нужен. Интеграция необходима для осуществления выгрузки товарных единиц и последующего обмена по остаткам на складах. Эти действия позволяют оперативно обновлять информацию на маркетплейсе.
Отметим, что эта модель была спроектирована для Wildberries относительно недавно. На Ozon она введена еще несколько лет назад. У нее есть свои достоинства и недостатки.
Ошибки в работе с API-ключом
Одна из распространенных ошибок: ваш API-ключ не работает.
Она может возникнуть из-за изначально неверно введенного ключа или его неактивности. Понять, из-за чего возникла ошибка, поможет диагностика:
- Ключ введен неверно — введите API снова
Убедитесь, что введенный ключ корректен его повторным введением. Это можно сделать путем копирования информации из личного кабинета Wildberries.
- API-ключ не активен
Чтобы проверить, активен ли ключ, его необходимо отредактировать по следующему алгоритму.
Сделайте ввод предыдущей даты и ключа (ниже за скобками). Скобки нужно удалить и вставить ваши значения:
https://suppliers-stats.wildberries.ru/api/v1/supplier/sales?dateFrom=2021-01-12(предыдущая дата)T00:00:00.000Z&flag=1&key=ваш ключ.
- Если появилось большое количество данных о поставках, значит, ключ активен.
- Появление одной строчки можно связать со следующими причинами:
- Ключ активен, но в указанную дату не было продаж. Чтобы проверить наверняка, нужно выбрать день, когда были продажи.
- Ключ активен, но выбранная дата не относится к периоду, данные за который сохранены. Указывайте дату в диапазоне последних трех месяцев, а лучше – еще раньше.
- В других случаях ключ не активен и требует перевыпуска. О том, как получить новый ключ, мы рассказали выше.
API позволяет сделать сбор информации автоматизированным процессом, что даст возможность проанализировать эффективность Wildberries. Его использование безопасно, всегда можно выполнить замену ключа.
Популярная сегодня схема FBS нуждается в аналогичном методе интеграции, но чтобы разработать его, необходимо привлечь высококвалифицированных специалистов.
Чек-лист "11 способов заработать деньги 
Видео с закрытой конфереции по заработку на Озон
