← Все статьи

От Chrome-расширения к серверу: интеграция WB ПВЗ

REST ingest API, server-side sync с pvz-lk.wb.ru, cron и единый WbIngestService — как данные WB попадают в CRM 24/7.

Оператор ПВЗ Wildberries привык к схеме: открыл личный кабинет pvz-lk.wb.ru, включил Chrome-расширение — и данные о рейтинге, выручке и отзывах попадают куда-то «в систему». Пока сотрудник сидит в браузере. Ночью — тишина. Уволился — данные пропали.

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

Боль Chrome-расширения

  • Данные собираются только пока открыт браузер с расширением.
  • Нет ночного сбора — утренняя сводка неполная.
  • Зависимость от конкретного компьютера и сотрудника.
  • Нет единого API — сложно связать с зарплатой и отчётами.
  • Обновление ЛК WB ломает парсинг DOM.

Этап 1: REST ingest API

Первый шаг — endpoint /api/v2/wb/* для приёма данных из расширения и любых других источников:

  • POST /api/v2/wb/rating — рейтинг ПВЗ;
  • POST /api/v2/wb/billing — выручка за период;
  • POST /api/v2/wb/reviews — отзывы и оценки;
  • POST /api/v2/wb/speed — скорость обработки.

Расширение продолжало работать, но данные шли в CRM по HTTP с токеном авторизации. Единый WbIngestService валидирует, нормализует и пишет в БД.

Этап 2: server-side sync

Для полной автономности добавили серверный sync с pvz-lk.wb.ru:

  • cron каждые 2–4 часа (настраивается);
  • SMS-auth при входе (WB требует подтверждение);
  • refresh-token для продления сессии;
  • headless HTTP-клиент с теми же cookies, что и браузер.

Расширение стало запасным каналом, а не единственным.

Единый WbIngestService

Все источники (расширение, cron, ручной импорт) проходят через один сервис:

  1. Валидация payload (ПВЗ ID, период, тип данных).
  2. Дедупликация — не писать дубли при повторном импорте.
  3. Запись в таблицы: wb_rating, wb_billing, wb_reviews.
  4. Триггер пересчёта зарплаты, если изменились оценки.

Связь с бизнес-процессами

Данные WB в CRM — не ради красивого графика:

  • Зарплата — доплата за «пятёрки» и рейтинг (подробнее).
  • Рабочий стол — виджет рейтинга и выручки.
  • График — слот WB в матрице смен (подробнее).

Надёжность

  • Лог каждого sync: успех/ошибка, количество записей.
  • Алерт в Telegram при 3 неудачных попытках подряд.
  • Fallback на данные расширения, если server-side недоступен.
  • Версионирование API — v2 не ломает v1 клиентов.

Результат

Данные WB попадают в CRM автоматически, 24/7. Рейтинг и выручка связаны с зарплатой и отчётами. Зависимость от браузера снята.

Для операторов ПВЗ WB

Если мотивация завязана на оценки и рейтинг — данные должны быть в вашей системе учёта, а не в Excel из расширения. Мы можем спроектировать ingest + server-side sync под ваш ЛК и правила мотивации.

См. также: зарплата WB + СДЭК, матрица смен, BIT CRM.

Нужна интеграция с 1С?

CodeLab проектирует REST API, B2B-порталы и обмен с внешними системами.

Обсудить задачу