Уведомления о заказах Wildberries без своего поллинга
Продавец на Wildberries узнаёт о новом сборочном задании, только опросив API. HookPilot опрашивает Seller API по расписанию, следит за окном и курсором и отдаёт в ваш бэкенд события о заказах и остатках с повторами доставки.
Коннектор Wildberries проходит сверку с боевым Seller API и открывается по заявке.
Как подключить
Каждое подключение опрашивает один поток: заказы FBS, заказы FBO или остатки. Под второй поток заводится второе подключение.
- 1
Создайте токен в кабинете продавца: Настройки → Доступ к API. Категории токена должны соответствовать потоку: «Маркетплейс» для заказов FBS, «Статистика» для заказов FBO и остатков.
- 2
Создайте в HookPilot подключение с коннектором «Wildberries (Seller API)» и вставьте токен. Он хранится зашифрованным.
- 3
Выберите поток и расписание опроса от минуты до суток. Под второй поток заведите второе подключение.
- 4
Подпишите эндпоинты на типы событий потока: order.created и order.status_changed для FBS, order.created и order.canceled для FBO, stock.changed для остатков.
Как устроен опрос
Заказы FBS: окно по дате создания
Wildberries фильтрует сборочные задания по дате создания, поэтому смена статуса ловится повторным чтением окна в 48 часов. Окно настраивается до 30 суток.
Заказы FBO и остатки: курсор
Статистический API отдаёт изменения с момента, который мы запоминаем. Окно берётся только на первый опрос, дальше опрос продолжается с курсора.
Дедупликация до вебхука
Одно и то же состояние заказа второй раз не придёт: событие возникает, только когда статус действительно изменился.
Разные лимиты у разных API
У API маркетплейса и API статистики свои лимиты запросов. Разделение потоков по подключениям позволяет задать каждому своё расписание.
Событие не пришло
Три причины, которые встречаются чаще остальных. Всё принятое видно в ленте принятого в кабинете вместе с типом и историей доставки.
Подключение в ошибке
У токена нет нужной категории: для заказов FBS требуется «Маркетплейс», для FBO и остатков «Статистика». Пересоздайте токен с нужными категориями.
Первый опрос идёт долго
Статистика отдаёт ответ одним куском без пагинации, и у продавца с большим каталогом первый опрос остатков тяжёлый. Дальше опрос идёт с курсора и становится лёгким.
Событий нет
Проверьте поток подключения и подписку эндпоинта: события заказов FBO не появятся в подключении с потоком FBS, а неподписанный эндпоинт не получит ничего.
Почему один поток на подключение?
У заказов FBS и у статистики разные лимиты и разный способ отслеживать изменения. Отдельные подключения позволяют опрашивать каждый поток со своим расписанием и не упираться в общий лимит.
Как часто опрашивается Wildberries?
По расписанию подключения: от одной минуты до суток, по умолчанию раз в пять минут.
Когда коннектор станет доступен?
Коннектор написан и проходит сверку с боевым Seller API. Оставьте заявку, и мы откроем его для вашей команды первыми и поможем с настройкой.
Другие интеграции
Платёжные системы, маркетплейсы и любая система с подписанными вебхуками или HTTP API.