Ozon и Wildberries — документация Riders

Сначала сопоставьте варианты

Выберите вариант по названию, артикулу, цвету или размеру. Для него задайте идентификатор площадки, внешний и внутренний склад, прайс-лист и максимальное количество для передачи. Wildberries также требует штрихкод. Одинаковый внешний идентификатор нельзя привязать к двум вариантам.

Количество для площадки ограничивается доступным наличием за вычетом резервов и блокировок. Цены берутся из выбранного прайс-листа, не из свойств варианта. Для WB цена задается целыми рублями без автоматического округления. Если один nmID имеет несколько размеров, укажите sizeID каждого варианта; кабинет должен поддерживать размерные цены. Иначе исходящий обмен ценами останавливается до уточнения связей.

GET /api/v1/admin/connections/ozon/bindings
PUT /api/v1/admin/connections/ozon/bindings/{variant}

Открыть Ozon

Видно, что подтвердил сервис

Запуск создает задание очереди. Журнал показывает время, попытки, число обработанных позиций и причину остановки. Ограничения API и временные ошибки вызывают отложенный повтор. Задание Wildberries на цены считается завершенным только после проверки квитанции обработки.

Права инициатора и поколение проверяются перед каждой страницей обмена. После отзыва доступа старое задание не продолжит работу. Неизвестный вариант требует сопоставления, а не создания выдуманного товара.

POST /api/v1/admin/connections/{id}/sync/orders
POST /api/v1/admin/connections/{id}/sync/stock
POST /api/v1/admin/connections/{id}/sync/prices
GET /api/v1/admin/connections/{id}/jobs

Свой склад и склад площадки

Новый заказ FBS резервирует связанные варианты. Подтвержденная отгрузка проводит складское действие однократно. Исторические отгрузки и продажи FBO / FBW не списывают наше наличие повторно.

Возвраты Ozon читаются отдельно от списка отправлений; записи Wildberries поступают из отчета продаж. Каждый возврат имеет устойчивый идентификатор и привязан к строке заказа. Сведения о возврате не создают физическое наличие: приемка на наш склад выполняется отдельным действием.

Открыть Wildberries

Загрузка всех страниц Ozon

Получение отправлений использует текущие методы v4 для FBS и v3 для FBO. Следующая страница загружается по курсору площадки, даже если предыдущая содержит меньше 100 отправлений. Верхняя граница периода фиксируется на время задания.

Некорректная цена, валюта или зацикленный курсор останавливают обработку с ошибкой. Неполный ответ не считается успешным пустым импортом. Эти сценарии проверены на тестовых ответах; приемка с конкретным кабинетом выполняется при подключении.

Изменения API Ozon

Что нужно перед рабочим запуском

Адаптеры и защита от повторов проверены на автоматических сценариях и тестовых ответах провайдеров. Реальные кабинеты Ozon и Wildberries не подключены; успешная продажа через площадки здесь не заявляется. Публичный стенд блокирует внешние запросы.

При подключении проверяем права токенов, схемы исполнения, ограничения периода, конкретные форматы возвратов и подтверждение цен. Создание внешних карточек, поставки и этикетки в этот выпуск не входят.

Яндекс Маркет, VK Маркет, Мегамаркет и Lamoda — разработка под заказ. Подключим нужные площадки и системы; недостающие функции магазина разработаем вместе с интеграцией.