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