API Wildberries: какие данные доступны селлеру для аналитики

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

Что даёт API Wildberries селлеру

API Wildberries — это набор методов, через которые селлер получает данные напрямую из кабинета в свою таблицу, BI-систему или складскую программу. Для аналитики это полезно тем, что можно видеть картину по SKU в динамике: сколько товара осталось, сколько заказали, сколько выкупили, какие расходы начислены и где начинается риск нехватки товара.

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

Какие данные можно получить через API Wildberries

Набор доступных методов зависит от версии API и прав токена, но для селлера ключевыми остаются несколько групп данных. Их достаточно, чтобы построить базовую управленческую аналитику и контролировать продажи по каждому артикулу.

Остатки и движение товара

• текущий остаток по складам и складу поставки
• резерв под заказы
• товар в пути и в обработке, если данные доступны в выбранном методе
• история изменения остатков для расчёта скорости расходования

Продажи и заказы

• количество заказов по артикулу и дате
• количество выкупов
• отмены и возвраты
• сумма продаж и средний чек по SKU

Тарифы и финансовые параметры

• комиссия площадки
• стоимость логистики
• хранение
• платные услуги и удержания
• штрафы и корректировки

Отдельно важно, что через API можно собирать данные не только для отчёта «что продалось», но и для расчёта маржинальности. Если к продажам добавить комиссию, логистику, хранение и себестоимость, селлер получает реальную прибыль по каждому товару, а не только выручку.

Какие токены нужны и как их использовать

Для работы с API Wildberries обычно нужен токен доступа. Он выдаётся в личном кабинете и используется для авторизации запросов. Без токена система не отдаст данные, а для разных разделов кабинета могут потребоваться отдельные права доступа.

Практически важно разделять токены по задачам: один использовать для склада и остатков, другой — для продаж и заказов, третий — для финансов. Так проще контролировать безопасность и быстрее находить ошибку, если какой-то отчёт перестал обновляться.

Что проверить перед подключением

1. есть ли у токена доступ к нужным методам
2. не истёк ли срок действия токена
3. правильно ли настроен формат дат и часовой пояс
4. совпадает ли артикул в API с внутренним SKU в вашей системе

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

Как считать поставки на основе данных API

Главная польза API для селлера — не просто видеть цифры, а превращать их в управленческое решение. Для этого сравнивают текущий остаток с темпом продаж и добавляют срок поставки. Так можно понять, когда товар закончится и сколько единиц нужно довезти.

Поставка = (Средние продажи в день x Дней до новой поставки) + Страховой запас - Текущий остаток

Пример расчёта. Допустим, товар продаётся в среднем по 18 штук в день, срок новой поставки — 10 дней, страховой запас — 50 штук, текущий остаток — 80 штук. Тогда потребность в поставке составит: (18 x 10) + 50 - 80 = 150 штук. Это значит, что для сохранения продаж без провала остатка нужно завезти 150 единиц.

Если добавить в расчёт ещё и возвраты, формула станет точнее. Например, при 18 заказах в день и 12% возвратов чистая продажа будет не 18, а 15,84 штуки в день. Тогда план поставки можно скорректировать и не завозить лишний объём.

Как API помогает контролировать прибыль и тарифы

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

Минимальная модель расчёта прибыли

Прибыль = Выручка - Комиссия - Логистика - Хранение - Себестоимость - Прочие удержания

Пример. Выручка по товару — 12 000 рублей, комиссия — 1 800 рублей, логистика — 900 рублей, хранение — 300 рублей, себестоимость — 5 000 рублей, прочие удержания — 200 рублей. Тогда прибыль: 12 000 - 1 800 - 900 - 300 - 5 000 - 200 = 3 800 рублей. Если этот расчёт делается автоматически через API, селлер быстро видит, какие позиции стоит масштабировать, а какие лучше выводить из ассортимента.

Для ассортимента с низкой маржой особенно важно считать не только абсолютную прибыль, но и процент рентабельности. Формула простая: прибыль / себестоимость x 100%. В примере выше рентабельность составит 3 800 / 5 000 x 100% = 76%.

Как выстроить аналитику без ручной выгрузки

Если селлер работает с десятками или сотнями SKU, ручная выгрузка быстро становится неэффективной. API позволяет автоматизировать сбор данных по расписанию: например, обновлять остатки каждый час, продажи — раз в сутки, финансы — раз в день. Это снижает риск ошибки и экономит время аналитика.

Хорошая схема работы выглядит так: данные из API Wildberries попадают в таблицу или систему аналитики, затем они очищаются, группируются по SKU и превращаются в отчёты по остаткам, продажам, оборачиваемости и прибыли. После этого можно настроить сигналы: когда остаток опускается ниже порога, система показывает, что товар вышел из остатков в зоне риска.

Что стоит отслеживать ежедневно

• остаток по ключевым SKU
• продажи за вчера и за 7 дней
• процент возвратов
• изменение комиссии и логистики
• товары с запасом менее срока поставки

Для практики достаточно начать с трёх показателей: остатки, продажи и срок поставки. Уже на этом этапе можно снизить вероятность провала в продажах и сократить лишние закупки. Когда базовая модель работает, добавляйте тарифы, возвраты и маржинальность.

Связанные статьи: Аналитика продаж на WB, Автоматизация поставок на WB, Остатки по складам WB.