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