Esta guía está disponible en ruso

Как подключить Ozon к порталу: API-ключ, заказы, уведомления

Ozon подключается по паре «Client-Id и API-ключ». Портал ведёт полный цикл FBS: заказы в канбане, товары и карточки, цены, остатки, сборка и отмена, возвраты и финансы. Всё, что меняет данные в кабинете Ozon, по умолчанию выключено и включается переключателями в настройках подключения.

1. Что умеет интеграция

2. Что нужно заранее

• Аккаунт продавца на Ozon, прошедший проверку.
• Склад FBS в кабинете Ozon, если вы собираетесь выгружать остатки.
• Тариф Web Plus: раздел «Маркетплейсы» доступен на нём (сейчас в бете).
• Право «Подключения к площадкам» у вашей роли в мастерской.

3. Как получить ключ

1. Откройте seller.ozon.ru и войдите в кабинет.
2. Перейдите в «Настройки» → «API-ключи».
3. Нажмите «Создать ключ» и дайте ему понятное имя, например «Портал».
4. Отметьте роли под то, чем будете пользоваться. Только заказы — достаточно чтения отправлений и товаров. Полный цикл — роли на товары, цены, остатки, отправления FBS, возвраты, отмены и финансовые отчёты. Лишние роли не отмечайте.
5. Скопируйте ключ сразу. Client-Id виден в том же разделе.
6. Проверьте срок действия. Ozon показывает его рядом с ключом. Мы предупредим вас за 14 дней до окончания.

Точный список прав ключа портал проверяет сам и показывает в карточке подключения: чего не хватает и что добавить. Права можно перепроверить кнопкой «Проверить права».

4. Подключение у нас

1. Откройте раздел «Маркетплейсы» → «Подключения».
2. Нажмите «Подключить» у карточки Ozon.
3. Введите Client-Id и API-ключ.
4. Выберите среду: боевой кабинет или песочница. Для работы выбирайте боевой кабинет.
5. Портал проверит связь и права. Ключ сохраняется только после успешной проверки.
6. В «Настройках подключения» выберите склад FBS из списка и включите нужные виды записи: «Карточки товаров», «Цены», «Остатки», «Действия с заказами».

5. Уведомления площадки

Без уведомлений портал опрашивает Ozon по расписанию, и новый заказ появляется с задержкой в несколько минут. С push-уведомлениями заказ появляется за секунды.

1. В карточке подключения скопируйте наш URL уведомлений.
2. В кабинете Ozon откройте раздел push-уведомлений и вставьте URL.
3. Сохраните. Ozon отправит проверочный запрос, портал ответит сам.

Уведомления только ускоряют работу. Регулярный опрос остаётся, поэтому потерянное уведомление ничего не ломает.

Оповещения вам в Телеграм и браузер

Это другое, чем уведомления выше: те нужны порталу, а эти приходят вам. Портал сам пишет вам о важном, в Телеграм и в браузер (web-push). Присылаем:

• новый заказ;
• отмена заказа покупателем или Ozon (отмену, которую вы сделали из портала, мы не присылаем);
• запрос покупателя на отмену со сроком, до которого нужно ответить;
• возврат или невыкуп;
• «сегодня последний день отгрузки», если заказ ещё не собран (приходит днём);
• карточка отклонена (с причиной) или прошла модерацию;
• товар закончился: остаток на Ozon стал 0;
• ошибка отправки на Ozon;
• проблемы с подключением: ошибка или скорое окончание срока ключа.

Как настроить. Откройте «Профиль» → «Уведомления» → «Маркетплейсы». У каждого события свой переключатель. По умолчанию включено всё, кроме «Карточка прошла модерацию». Для оповещений нужен привязанный Телеграм: его привязывают в профиле.

У каждого сотрудника мастерской свои настройки. Сотрудники получают оповещения, если у них есть доступ к заказам площадок, а у владельца действует тариф Web Team.

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

6. Товары

Вкладка «Маркетплейсы» → «Товары». Товар мастерской — одна карточка на изделие, общая для всех площадок: название, описание, фото, размеры и вес упаковки, штрихкод, НДС, цены.

Уже торгуете на Ozon? Нажмите «Загрузить карточки с Ozon». Портал заберёт все карточки кабинета и свяжет их с вашими товарами по артикулу. Остальные карточки заведёт новыми товарами. Уже заполненное в портале не перезаписывается. Фото карточки остаются на серверах Ozon, а главное фото для изделия склада копируется к нам. Что происходит со складом при загрузке, описано ниже в подразделе «Изделия на складе для новых карточек». Если вы сняли там галочку, свяжите загруженный товар с изделием склада в редакторе, иначе его остаток не выгружается.

Выставить новый товар:

1. Добавьте товар: из изделия склада, из модели или с нуля.
2. Заполните фото, размеры и вес упаковки, цену.
3. Нажмите «Выставить на Ozon» и выберите категорию поиском.
4. Заполните характеристики. Обязательные идут первыми, справочные значения (бренд, цвет, материал) ищутся по Ozon. Название, аннотацию, тип и название модели портал заполнит сам, если вы их не задали.
5. При желании нажмите «Написать текст с ИИ»: ИИ предложит название и описание по данным товара. Текст можно поправить.
6. Шаг «Проверка» покажет, чего не хватает. Когда всё готово, нажмите «Выставить».

Ozon проверяет карточку асинхронно. Статус виден у товара: отправлена → на модерации → активна или отклонена. Если Ozon отклонил карточку, портал покажет его текст по каждой характеристике. Исправьте и отправьте снова. Артикул уже выставленного товара менять нельзя: Ozon связывает карточку по нему.

Изделия на складе для новых карточек

При загрузке карточек («Загрузить карточки с Ozon») есть галочка «Создать изделия на складе для новых карточек». Она включена по умолчанию. Для каждой новой карточки, у которой ещё нет связи со складом, портал создаёт изделие на складе готовой продукции. В него попадают:

• название и описание карточки;
• главное фото: оно скачивается к нам;
• цена;
• количество: столько, сколько осталось на Ozon в момент загрузки.

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

Товар сразу связан с изделием, поэтому дальше остаток на Ozon идёт со склада. Если тот же артикул есть на другой площадке, изделие будет тем же, дублей не появится. Если снять галочку, изделия не создаются, и товар нужно связать со складом в редакторе самому.

Выставить и следить за товаром со склада

На складе готовой продукции у изделия есть кнопка «Выставить на маркетплейс»: она открывает мастер выставления. Чтобы сделать товары для площадок сразу из нескольких изделий, нажмите «Создать товары для площадок». В колонке «Площадки» виден статус изделия по каждой площадке.

Панель «Подробнее» у изделия показывает:

• продажи по каналам;
• «хватит на N дней» или «пора допечатать»;
• где изделие выставлено;
• резерв;
• экономику одной штуки;
• кнопку «Допечатать».

7. Цены

У карточки на Ozon видно:

• себестоимость (указанная у товара или из склада готовой продукции);
• удержания Ozon по этому товару: комиссия и логистика (фактические, по данным Ozon, или по вашему справочнику «Каналы продаж», пока товар не создан);
• налог, «к выплате» и прибыль с одной штуки;
• минимальная цена и рекомендованная (по наценке из настроек калькулятора).

Защита от ошибок:

• цену ниже минимальной выгрузить нельзя;
• «цена до скидки» проверяется по правилам Ozon: при цене до 400 ₽ разница больше 20 ₽, до 10 000 ₽ — больше 5%, дороже — больше 500 ₽;
• изменение больше чем на 30% — только с подтверждением;
• без себестоимости защита не работает, портал об этом предупреждает.

«Пересчитать цены» меняет цены массово: по рекомендованной, на ±% или одной суммой. Сначала всегда показывается предпросмотр «было → станет».

8. Остатки

У каждого товара выберите режим:

Если остаток не определён (товар не связан со складом, поле пустое), портал не трогает остаток на Ozon. Ноль по ошибке не уйдёт.

Остаток уходит на Ozon по событию: примерно через 10–15 секунд после того, как изменилось количество изделия на складе (продажа, списание под заказ, правка, отмена). Если вы правите количество несколько раз подряд, всё уходит одной отправкой. Кроме того, раз в 5 минут и раз в сутки портал сверяет все остатки на всякий случай. Кнопка «Остатки» показывает, что уйдёт на Ozon и почему какой-то товар не выгружается. Если в ноль уходит больше 20 товаров сразу, портал попросит подтверждения: защита от массового обнуления работает по-прежнему.

9. Заказы

Если изделие есть на складе готовой продукции, заказ попадает в колонку «Сборка заказа», а остаток списывается автоматически. При отмене остаток возвращается. Если вы сами передвинули карточку, портал не вернёт её обратно. Чип статуса на карточке всегда показывает состояние на Ozon.

Действия на Ozon — на странице заказа, в блоке «Ozon · отправление»:

• «Собрать на Ozon» собирает отправление одной коробкой;
• «Этикетка PDF» появляется после сборки;
• «Отменить на Ozon» отменяет заказ с причиной из списка Ozon (отмена по вашей инициативе снижает рейтинг).

Из канбана то же самое: при переносе карточки в «В доставке» портал спросит, собрать ли отправление на Ozon, при переносе в «Отменён» — отменить ли его и там. Если включить в настройках подключения «Выполнять действия без подтверждения», сборка будет ставиться сама. Отмена всегда требует причины. Изменение статуса с телефона на Ozon ничего не делает.

Все действия идут через очередь. Результат и понятная подсказка при ошибке — во вкладке «Журнал».

Отгрузки — вкладка «Отгрузки»: куда и до скольких сдать посылки, сколько собрано. Для сдачи в пункт приёма Ozon отгрузку не требует — достаточно этикеток. Если нужен акт приёма-передачи: «Создать отгрузку» → «Подтвердить» → «Акт PDF».

Таблицы с фильтрами и журнал

Вкладки раздела «Маркетплейсы» — «Товары», «Отгрузки», «Возвраты», «Финансы» и «Журнал» — теперь таблицы с фильтрами (площадка, статус, период, поиск) и сортировкой. В «Журнале» видно дату, время и того, кто внёс изменение. Нажмите на запись, и откроется, что именно изменилось.

10. Запросы на отмену и возвраты

Если покупатель просит отменить заказ, карточка остаётся в своей колонке и получает красный чип «Просит отмену». Ответьте на странице заказа или во вкладке «Возвраты»: «Одобрить отмену» или «Отклонить». Ozon ждёт ответа ограниченное время, срок виден рядом. Если не ответить, Ozon решит сам.

Возвраты и невыкупы видны во вкладке «Возвраты». У выполненного заказа появляется чип «Возврат». Вернувшийся товар на склад автоматически не приходуется: сначала осмотрите его.

11. Финансы

Раз в 6 часов портал загружает с Ozon фактические начисления и удержания: по каждому заказу и общие (реклама, подписки, хранение; первый раз — за 30 дней). Вкладка «Финансы» показывает:

• продажи, удержания и сумму к выплате за период;
• разбивку по видам: комиссия, логистика, последняя миля, эквайринг, продвижение, штрафы и прочее;
• итоги по товарам и по заказам с прибылью.

«Комиссия площадки» у заказа с Ozon после загрузки финансов становится фактической, и прибыль заказа считается по реальным цифрам. Кнопка «Обновить сейчас» загружает данные, не дожидаясь расписания.

Юнит-экономика. Во вкладке «Финансы» → «Юнит-экономика» по каждому товару за период видно: сколько продано и возвращено, выручку, удержания площадки по видам (комиссия, логистика, хранение, эквайринг, прочее), себестоимость, прибыль, маржу и прибыль на штуку. Убыточные товары подсвечены красным, таблицу можно скачать в CSV. Себестоимость берётся из карточки заказа, а если её нет — из товара мастерской или склада готовой продукции. Возврат товара возвращает его себестоимость. Начисления, которые площадка не относит ни к товару, ни к заказу, показаны отдельной строкой «Без привязки к товару» и входят в итог. Выручку Ozon в начислениях не передаёт, поэтому она берётся из цены покупателя в заказе.

12. Что делается только в кабинете Ozon

• Регистрация и проверка продавца.
• Создание API-ключа и его перевыпуск.
• Создание склада FBS и настройка отгрузки.
• Коды маркировки «Честный знак»: заказы с маркировкой собирайте в кабинете Ozon.
• Разбиение отправления на несколько коробок.
• Акции, продвижение, платные опции для отзывов и чатов.

13. Частые ошибки

14. Безопасность

• Ключ хранится в зашифрованном виде и не показывается после сохранения.
• Условия работы портала с кабинетом продавца — раздел 12 оферты: портал действует в кабинете только по вашей команде или по правилам, которые вы включили сами.
• Каждый вид записи в кабинет Ozon выключен по умолчанию и включается отдельно.
• Подключение можно поставить на паузу. Очередь при этом сохраняется.
• Каждая операция с Ozon записывается в «Журнал»: что отправлено, чем кончилось, кто запустил.
• Права в мастерской: «Заказы площадок» — просмотр, сборка и отмена; «Товары на площадках» — товары и карточки, цены только с правом «финансовые поля»; «Финансы площадок» — выплаты и удержания. Настраиваются в ролях мастерской.

15. Изменения

• 01.10.2026 — первая версия инструкции.
• 01.10.2026 — полный цикл: товары и карточки, цены, остатки, сборка и отмена, запросы на отмену и возвраты, финансы.
• 30.09.2026 — связка склада и площадки, выгрузка остатков по событию, оповещения в Телеграм, таблицы с фильтрами.