Wildberries API

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

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

Зачем? Потому что большинство программ написаны на разных языках программирования, что затрудняет передачу данных. Существует вариант с выгрузкой данных из разных систем, но, во-первых это долго, во-вторых, иногда придется нехило постараться, чтобы разобраться с форматами данных)

У любимого плейса россиян тоже есть api-ключ, с помощью которого мы напрямую выгружаем отчеты из личного кабинета в Power BI. Такой подход позволяет существенно автоматизировать процесс передачи данных, а также позволяет один раз заложить логику учета показателей, любезно предоставляемых самим WB - всю операционную работу по расчету метрик забирает на себя Power BI.

Документация. У любого сервиса, обладающего api-ключом есть документация с содержанием запросов и ответов, а также всей информацией, которую можно достать из системы.
Документация api сервиса Wildberries
Документация api сервиса Wildberries
Звучит и выглядит все замечательно. Мы изучаем документацию, пишем запросы, получаем данные и визуализируем их в отчеты. К сожалению, на деле все оказывается много сложнее. Дело в том, что нередко в работе передачи данных у WB случаются сбои. Поэтому важно предусмотреть в алгоритме такую вероятность. Например, сбой передачи данных в марте ввел в панику всех наших клиентов, проекты которых непосредственно касались сервиса. Тем не менее нам удалось восстановить исторические данные и наладить работу.

В чем состоит сложность?

У маркетплейс существует ряд особенностей при работе с api-ключом.

WB не хранит историю остатков. То есть сервис отдает данные только за текущую дату на момент запроса. Что мы сделали? Мы написали скрипт, который каждый день получает данные по остаткам и хранит этот массив в базе данных. Мы сохраняем исторические данные, что позволяет расчитывать оборачиваемость товара.

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

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

И все же иногда случаются сбои в работе сервиса. В отличии от нашей базы, где мы храним исторические данные, которые остаются в отчетах даже при перебоях работы сервиса.
Пример алгоритма получения данных по api
На скрине: incomes-выгрузка поступлений на склад, orders- заказы выгрузка, report - недельные итоговые отчеты, sales - продажи, stocks - склад.
Пример алгоритма получения данных по api и сохранения данных в базу данных Exploreyourdata
Пример загрузки данных по временному интервалу
Пример загрузки данных по временному интервалу
Чтобы система не перегружалась за счет количества запросов, наш алгоритм настроен таким образом, чтобы запросы шли последовательно.

Что получаем на выходе? На выходе получаем красивый аккуратный дашборд с историческими данными по всем параметрам и необходимым показателям.
дашборд с историческими данными
В статье мы поделились особенностями при работе с api-сервиса, которые мы учитываем в наших алгоритмах при передаче данных. Мы делимся такими статьями, чтобы вы могли больше узнавать о мире аналитики, полезных вещах и имели возможность заглянуть внутрь процессов, которые на поверхности кажутся очень простыми и понятными, но имеют ряд ограничений.

Мы делаем действительно полезные и классные продукты, опираясь на запросы пользователей систем и их острую нужду в корректных данных.

Чтобы познакомиться с полной версией отчета по Wildberries и забрать пример себе, чтобы детальнее с ним ознакомиться, можно перейти по ссылке.
Закажи аналитику своих продаж на макеркетплейсе
Настроим дашборд под любой запрос
ФИНМОДЕЛЬ
В ПОДАРОК
ОТЧЕТ ОТ 2 990
ШАБЛОННЫЕ ОТЧЕТЫ ЗА 2 ДНЯ