Настройка вебхуков для уведомлений о заказах rFBS на Ozon
При модели rFBS товары хранятся у продавца, а заказы приходят через маркетплейс. Чтобы не пропустить новый заказ, настройте вебхуки — они автоматически пришлют данные на ваш сервер.
Сравнение
| Критерий | По теме страницы | Ручная проверка заказов через личный кабинет Ozon |
|---|---|---|
| Способ мониторинга | Вебхуки (автоматические уведомления) | Ручная проверка ЛК |
| Задержка получения | Секунды после создания заказа | От минут до часов |
| Надежность | Высокая (автоматическая переотправка) | Низкая (человеческий фактор) |
| Объем данных | Полная информация о заказе | Только визуальное отображение |
| Сложность настройки | Требует сервера | Не требует настроек |
Как это работает
В ЛК Ozon создайте ключ с правами на вебхуки.
Укажите URL своего обработчика и выберите событие 'Новый заказ'.
Вычислите HMAC-SHA256 из тела запроса с вашим секретным ключом и сравните с заголовком.
Извлеките order_id, список товаров и адрес доставки, сохраните в своей базе.
Верните статус 200 OK с телом {"result": true}.
Подробно
Создание вебхука в Ozon для rFBS
Перейдите в личный кабинет Ozon → Настройки → API. Выберите 'Вебхуки' и нажмите 'Создать вебхук'. Укажите URL вашего обработчика (например, https://your-server.com/webhook/ozon) и выберите событие 'Новый заказ'. Для rFBS также подпишитесь на событие 'Отмена заказа'. Сохраните.
Обработка входящих уведомлений на сервере
На сервере создайте эндпоинт, принимающий POST-запросы. Проверяйте подпись (заголовок X-Ozon-Signature) для безопасности. Пример JSON: {"order_id": 123456, "items": [{"sku": 789, "quantity": 2}], "delivery": {"address": "Москва..."}}. После получения обновите статус в вашей системе и запустите сборку.
Словарь терминов
Отзывы
Вебхуки сэкономили время — заказы вижу мгновенно, успеваю упаковать быстрее.
Настроила вебхуки для клиента. Теперь система сама загружает заказы в WMS, ошибок нет.
Частые вопросы
Какие события вебхуков доступны для rFBS?
Новый заказ, отмена заказа, изменение статуса доставки.
Что делать, если вебхук не приходит?
Проверьте логи сервера, убедитесь, что URL доступен извне, и подпись верна.
Как часто Ozon переотправляет вебхуки?
При ошибке (код не 200) Ozon повторяет отправку до 10 раз с интервалом.
Настройте вебхуки для rFBS и получайте заказы автоматически. Создайте URL-обработчик и подключите его в ЛК Ozon.
