API – технология, которой много лет. Все интеграции и автоматизации современного мира невозможно представить без API. К самой технологии вопросов нет, но насколько можно доверять данным, полученным с её помощью? Особенно когда поставщик данных не гарантирует их корректность, а предоставляет только удобство в их получении (и то с техническими ограничениями на кол-во запросов, доступность сервиса и т.д.). А если копнуть еще поглубже, то легко выясняется, что «посредников» между данными, отражающими реальную картину мира и вами, не так уж и мало. Давайте подробнее.
Кто и как считает?
Сначала давайте разберемся в цепочке «посредников» более детально:
1. Сам WB.
Да, данные его, но возникают вопросы как он их собирает, как хранит, как борется со своими неточностями/ошибками и, что очень немаловажно, как он их предоставляет? Что он может «отдать» по запросу через API, а что не может? Какая логика находится внутри WB между хранящимися данными и теми данными, что он отдает?
Некоторые примеры для понимания последнего вопроса:
Вот что пишет в разъяснениях к своему сервису аналитики MarketRun:
В MarketRun на Главной странице показана Продажа по розничным ценам с учетом скидки, установленной вами. Ее можно сравнить с суммой продаж в Сводном по продавцу, при этом выявленное нами отклонение составляет менее 1%. И это расхождение также приходит к нам по API.
Источник - сайт MarketRun (Ссылка)
А вот о чем предупреждает селлера сам WB в личном кабинете. Для не ИТ-шников поясню. Мобильные приложения WB и сам сайт https://seller.wildberries.ru/ тоже работают по API, чтобы достучаться до своей же базы данных. Только по Private API, который защищен и не доступен сторонним разработчикам и сервисам аналитики. Эти же ребята, в свою очередь, используют Public API – специальный API для третьих лиц. Но суть проста – есть два разных сервиса API и, даже по «своему» Private API, WB не гарантирует точности данных, что уж говорить об API для третьих лиц.
Ну и API – это программный продукт, его надо развивать. Занимаются им другие разработчики, не те, которые логику получения и хранения данных пишут. Т.е. есть временной лаг в появлении поддержки последних изменений логики работы с данными на стороне API. Вот один из примеров:
Не все данные передаются по API-ключу, например, до 28.01.2024 Wildberries не передавали данные по стоимости хранения и прочим расходам по API-токену.
Источник - база знаний MPSTATS (Ссылка)
Или вот – API возвращает некорректные данные по заказам в статистике:
Начал разбираться - как в итоге понял, проблема в том, что WB разделил в статистике данные по заказам товаров, которые непосредственно участвуют в рекламной кампании, и по ассоциированным конверсиям. А раньше эти данные отдавались по API в общей сумме.
Источник - vc.ru (Ссылка)
Банальные баги. Если задаться целью и загуглить, то можно увидеть много всего на просторах Интернета. Банальный пример, показывающий разницу в логике получений данных в ЛК селлера и по доступному Public API:
... в остатках товара на складе, на сайте указано одно число, а в апи приходит другое. (на сайте остаток по номенклатуре N, на складе N - 7, а с апи приходит - 1)
Источник - Хабр (Ссылка)
2. Сервис аналитики или ваш личный разработчик.
Выше разобрались, что API – это живой зверь, постоянно меняющийся (можно кстати подписаться на группу в Телеграм для разработчиков по API WB и увидеть постоянные изменения в этом сервисе https://t.me/wb_api_notifications) и не гарантирующий точность данных в любой момент времени. Теперь следующий шаг – получение данных от WB и их обработка своей логикой.
Собственно «своя логика» – это и есть та ценность, которую продают сервисы аналитики через удобные виджеты и таблички для селлера, а также то, что вы хотите получить, нанимая разработчика с фриланса, чтобы он «сделал красиво!».
Сначала сравним запрос по API со скачиванием детализации из ЛК WB. В личном кабинете вы нажимаете кнопку «Скачать детализацию» и получаете подготовленный архив с excel-файлом, где много тысяч строк. Из неоспоримых плюсов – подготовил и отдал этот файл сам WB. Более того, это срез за период, который является детализацией файла строгой отчетности, подписанного электронной подписью должностного лица WB. Другими словами, у вас на руках «бумага», имеющая юридическую силу. Согласитесь, что на базе такого отчета сильно спокойнее строить свою аналитику и веры в неё больше.
Теперь про загрузку детализации через API. Вот выдержка из документации для разработчиков WB. Тут явно одной кнопкой "Скачать детализацию" не обходится:
Разработчик должен правильно обратиться к сервису API, т.е. передать необходимые параметры в правильном формате и в правильный момент времени, учесть ограничения и следовать логике. Плюс могут возникать инфраструктурые ограничения. Например, ломанулись все в понедельник свои отчеты по API выкачивать, а сервера WB "не вывозят". Вот и ловятся так называемые timeout-ы. Т.е. сервер не переваривает ваш запрос на 20 тыс. строк. Приходится несколько раз меньшее количество запрашивать.
И следующий этап - агрегировать данные и подать их красиво. Конечно ваш личный разработчик-фрилансер сделает всё под вас. Столбцы правильно "по-вашински" назовет, их порядок выстроит, покажет только самое важное. А вот сервисы аналитики сталкиваются со своими продуктовыми вопросами - как универсально вывести данные в интерфейс, как правильно показать их достоверность, какие кнопки должны быть прям под рукой у селлера, а какие можно за 3 дополнительных клика спрятать. Вот и получается порою не сильно удобно и наглядно:
В общем подытоживаем. Получение данных по API - это получение "сырых" данных, которые еще надо правильно обработать и подать. В ходе этих процедур возникает та самая логика, которая у каждого своя.
3. Регулирующий орган.
Вот мы и подошли к самому важному звену всей работы с данными. Это регулятор, а конкретнее ФНС РФ. Можно сказать, что я – предприниматель , ориентируюсь на аналитику, поставки, продажи, маркетинг, а налоги бухгалтер посчитает или какой-нибудь онлайн-сервис. Всё это несомненно так, но наверно не хочется попасть в ситуацию, когда вы считали-считали и получили 1 млн.руб. чистыми по расчетам, а оказывается надо было минусовать не 200 тыс. налога, 500 тыс.? А такая ситуация вполне возможна - API "накосячило", данные за период подгрузились не полностью, не на тот показатель ориентировались, WB скорректировало свои данные за поза-поза прошлый месяц (какие-нибудь коррекции по продажам) и это еще не берем во внимание огромное количество нюансов самого бухгалтерского учета.
Так что же делать? Ответ простой - подходить внимательно и аккуратно к той информации, на основе которой принимаются решения. Во всём объеме рисков и возможных неточностей, необходимо использовать инструменты и механизмы, которые контролируются гос.регулятором, т.к. в случае неточности или ошибок в них, маркетплейс будет должен их исправить и отчитаться перед государством. Думаю, не стоит упоминать, что перед продавцами, глобально то, никакой WB отчитываться не должен. Он в позиции сильного и предлагает сотрудничество селлеру по оферте, которую меняет как хочет.
4. Резюме и ответ на вопрос темы статьи.
Во всем многообразии аналитических отчетов и данных WB есть только один отчет по строгой форме отчетности - это "Еженедельный отчет о реализации", подписанный электронной подписью и его детализация в формате Excel, с которой можно работать и анализировать своё состояние дел, с достаточным уровнем доверия и понимания. Остальные отчеты, безусловно, полезны и дают свои инсайты селлеру, но надежность этих данных необходимо проверять каждый раз, и не важно, откуда получены эти данные - из ЛК WB или через сервис аналитики. Их нужно сверять с еженедельным финансовым отчетом, полученным по кнопке "Скачать детализацию" в формате Excel. А еще лучше, чтобы аналитика строилась от финансового отчета, а не "сбоку". Но это очень нетривиальная задача и тема для другого поста.
Полезность в заключении.
Если у вас есть потребность увидеть раскладку продаж по каждому товару на WB (для анализа фактической юнит-экономики по результатам продаж), то приглашаем воспользоваться нашим бесплатным Телеграм-ботом @wb_unit_parser_bot. Загружаете архив с недельным отчетом и получаете общие данные за неделю по каждому артикулу со всеми продажами, возвратами, логистикой, возмещением, компенсациями и т.д. Корректность расчета легко сверяется с информацией в ЛК WB.