Ozon расширил Seller API для FBS-возвратов и курьерской доставки
15 октября 2026 года Ozon сообщил о новых параметрах Seller API, связанных с FBS-возвратами и настройкой первой мили возвратов.
Изменения в Seller API затрагивают не только получение списка возвратов, но и проверку доступных способов возвратной доставки. Разработчикам интеграций важно отличать новые поля ответа от новых параметров запроса.
- В списке возвратов появилось поле courier_delivery
- Для возвратной мили добавлены два признака доступности способов
- В двух методах управления FBS-складами появился courier_return_warehouse_info
- Необходимо проверить совместимость парсинга и бизнес-логики
Что добавлено в ответы API
Метод /v1/returns/list теперь может возвращать поле returns.courier_delivery. Метод /v1/warehouse/fbs/return-mile/check получил два признака: is_courier_return_mile_available и is_dropoff_return_mile_available. Они относятся к доступности курьерского способа возврата и возврата через точку приёма.
Что изменилось в настройках FBS-склада
В запросах /v1/warehouse/fbs/create и /v1/warehouse/fbs/first-mile/update появился параметр courier_return_warehouse_info. Это расширяет передаваемые сведения при создании склада и изменении настроек первой мили.
Кого касается обновление
Изменения важны продавцам, использующим собственную автоматизацию FBS-возвратов, и разработчикам сервисов, которые получают возвраты через Seller API или управляют настройками FBS-складов. Само добавление полей не означает, что все продавцы обязаны переключать способ возврата.
Что проверить в интеграции
- Убедиться, что разбор JSON-ответов не ломается при появлении дополнительных полей.
- Проверить значения признаков доступности способов возврата для своих складов.
- При использовании методов создания и изменения FBS-склада сверить структуру нового параметра с документацией.
- Не менять существующий маршрут возвратов автоматически без явных правил и подтверждённых возможностей склада.