Как настроить API Ozon для получения списка заказов по модели FBS?
Настройка API Ozon для получения списка заказов по модели FBS (Fulfillment by Seller) требует выполнения нескольких последовательных шагов. Прежде всего, необходимо получить API-ключ в личном кабинете продавца на платформе Ozon. Для этого войдите в раздел «Настройки», затем перейдите в «Seller API» и сгенерируйте новый ключ. Обязательно сохраните Client-ID и API-ключ в надёжном месте — они понадобятся для авторизации всех запросов.
Для получения списка заказов FBS используется метод POST /v3/posting/fbs/list. Этот эндпоинт позволяет получать информацию о заказах с различными фильтрами по статусам, датам и другим параметрам. В заголовках запроса необходимо передать Client-Id и Api-Key. Тело запроса должно содержать параметры фильтрации: dir (направление сортировки), filter (объект с условиями отбора, включая since и to для временного диапазона, status для статуса заказа), limit (количество возвращаемых записей, максимум 1000) и offset (смещение для пагинации).
Пример запроса включает указание временного интервала в формате ISO 8601, выбор статуса заказа (например, awaiting_packaging, awaiting_deliver) и количество записей на странице. API возвращает массив заказов с детальной информацией: номер отправления, статус, список товаров, адрес доставки, стоимость и другие данные. Важно учитывать лимиты API — не более 1000 заказов за один запрос, поэтому для больших объёмов данных необходимо реализовать пагинацию через параметр offset.
Для автоматизации процесса рекомендуется использовать библиотеки для работы с HTTP-запросами в вашем языке программирования (requests в Python, axios в JavaScript). Обработка ошибок критически важна: проверяйте коды ответов (200 — успех, 401 — ошибка авторизации, 429 — превышение лимита запросов) и реализуйте механизмы повторных попыток. Также полезно настроить логирование всех запросов и ответов для отладки и мониторинга работы интеграции. Регулярно обновляйте документацию API на официальном сайте Ozon, так как методы и параметры могут изменяться.