Фото в карточки Ozon через API

Что умеет Solistra с Ozon

Solistra работает с Ozon напрямую через API продавца. Вы подключаете кабинет, находите товары и отправляете в них новые фото из Фотостудии, генерации или своих загрузок. Те же фото можно отправить и в карточки Wildberries, если вы продаёте на обеих площадках.

• Подключение кабинета по Client-Id и Api-Key
• Поиск товара по артикулу продавца offer_id или по SKU
• Три режима · заменить все, добавить в конец, заменить только главное
• Статус загрузки по каждому товару
• История прежних фото и откат
• Путь через шаблон категории без ключей

Как подключить кабинет Ozon

Для работы по API нужны два значения из настроек API в кабинете продавца Ozon: Client-Id, он же идентификатор клиента, и Api-Key. Создайте отдельный ключ для Solistra и выберите для него роль, которая разрешает работу с товарами.

В Solistra откройте «Карточки», добавьте кабинет Ozon, вставьте Client-Id и Api-Key и нажмите «Проверить». Проверка делает безопасный запрос чтения и не меняет ничего в магазине.

offer_id и SKU

У товара на Ozon есть ваш артикул продавца, в API он называется offer_id, и номер SKU, который присваивает площадка. Искать можно по любому из них. Solistra показывает текущие изображения товара и рядом набор, который получится после отправки.

Первое фото в списке становится главным, остальные идут дополнительными. Порядок меняется перетаскиванием.

Как фото попадают на Ozon

Ozon принимает изображения товара ссылками. Solistra кладёт каждое фото в хранилище в России, убирает EXIF и передаёт площадке постоянную HTTPS ссылку с неугадываемым адресом. Ozon скачивает файл по ссылке сам.

Перед записью Solistra читает текущие изображения и собирает итоговый список по выбранному режиму, поэтому в режимах «добавить в конец» и «заменить только главное» существующие фото не теряются.

Статус загрузки и обратная проверка

Загрузка изображений на Ozon идёт не мгновенно, поэтому Solistra запрашивает у площадки статус по каждому товару и показывает его: отправлено, принято, ошибка с причиной.

Когда загрузка завершена, Solistra читает товар обратно и сравнивает изображения с отправленными. Успех показывается только после этой проверки. Прежний набор лежит в истории и возвращается одной кнопкой.

Через шаблон категории без ключей

Если API подключать не хочется, скачайте в кабинете Ozon пустой шаблон нужной категории и загрузите его в Solistra вместе с фото. Сервис заполнит лист «Шаблон»: первое фото попадёт в колонку со ссылкой на главное фото, остальные в колонку дополнительных фото.

Остальные части файла сохраняются как есть. Шаблон, где уже заполнены товары, Solistra не принимает, чтобы не перезаписать ваш ассортимент. На выходе заполненный шаблон, архив с фото, отчёт проверки и список ссылок.

Статус «готово частично» явно показывает недостающие фото и несовпадения со справочником. Готовность файла не означает прохождение модерации Ozon.

Требования Ozon к фото

Форматы, разрешение, вес файла и соотношение сторон для изображений Ozon сверяйте в базе знаний для продавцов в личном кабинете, требования различаются по категориям и меняются. Solistra готовит фото в формате карточек 3:4 и меняет размер под площадку одной кнопкой.

Если на фото есть человек, например модель в вашей одежде, нужно его согласие на использование изображения. Это правило Гражданского кодекса, а не только площадки.

Ключи и данные

Client-Id и Api-Key хранятся зашифрованными на сервере в России и не попадают в браузер, логи и ответы API. Запросы к Ozon идут из России напрямую, без зарубежных серверов. Отключение кабинета удаляет ключ.

Закон о персональных данных требует хранить данные граждан России в базах на территории страны. База, файлы и резервные копии Solistra находятся в России. Цены, остатки, описания, характеристики и заказы Solistra не меняет.