# Ozon Seller API Считайте юнит-экономику Ozon и отвечайте покупателям в чате Товары, заказы и аналитика Ozon — вход через аккаунт продавца, без копирования ключей ## Как агент работает с Ozon Seller API Агент ходит в Ozon Seller API напрямую — финансы, аналитика, товары, заказы FBS и FBO, отзывы и вопросы, поставки. Финансы здесь сильная сторона: помесячный P&L собирается одним запросом к финансовым транзакциям, а сумма строк сверяется с итогами Ozon — расхождение агент покажет, а не спрячет. Юнит-экономика считается по каждому SKU: выручка, комиссия, логистика, возвраты, налог, прибыль — с аллокацией сервисных списаний пропорционально отправлениям. Поверх ложатся ABC×XYZ-классификация портфеля, прогноз прибыли план/факт и сверка компенсаций по возвратам и потерям: агент прогоняет все классы претензий и честно помечает, что посчитать не удалось, вместо того чтобы молча занизить сумму. С отзывами и вопросами агент работает так, как Ozon устроен на самом деле: признак неотвеченного вопроса — счётчик ответов, а не статус, потому что статус в Ozon это ручная пометка продавца. Негативные отзывы фильтруются по оценке, рядом считается скорость вашей реакции, а ответы агент готовит в тоне бренда и поднимает наверх то, что бьёт по рейтингу карточки. Вопросы к карточкам и чаты с покупателями он ведёт одной лентой неотвеченного, чтобы ничего не терялось между разделами кабинета. В отгрузке FBS агент знает главную ловушку: HTTP 200 от Ozon не означает, что отгрузка прошла. После каждой отгрузки он проверяет фактический статус отправления и при сбое повторяет сборку, а маркировку «Честный ЗНАК» валидирует до отгрузки. Заявки на поставку FBO создаются по актуальному v2-процессу: черновик, таймслот, заявка и только затем подтверждённый номер заказа. Новые отправления, отмены, смену дедлайна сборки, перенос даты доставки и дефицит остатков Ozon присылает уведомлениями, так что агент узнаёт о них, не опрашивая кабинет по кругу. Про цены и карточки агент осторожен, потому что API Ozon перезаписывает, а не дополняет. Массовое обновление цен идёт с обязательной минимальной ценой, чтобы промо-акция не увезла цену ниже себестоимости. Импорт карточки — полная замена: агент собирает её целиком, проверяет статус модерации до правки и перечитывает карточку после. Фото заливаются только полным списком — старые плюс новые, иначе Ozon их сотрёт, а лимиты на создание товаров агент проверяет до массовой загрузки, а не узнаёт из ошибки после половины. Частоту запросов агент держит по каждой ручке Seller API отдельно: отчёты по размещению Ozon отдаёт считанные разы в сутки, аналитику и поисковые запросы — заметно чаще, и лимит не сжигается на повторных выгрузках. Тяжёлые отчёты приходят асинхронно: агент ставит задачу, дожидается готового файла и разбирает его сам. Даты он приводит к московскому времени, в котором Ozon считает свои сутки, чтобы граница периода не сдвигала выручку в соседний месяц. Если данных за период нет, он скажет об этом прямо, а не покажет пустую таблицу. ## Сценарии интеграции ### Разобрать падение продаж по SKU Агент сведёт заказы и воронку показов Ozon за период, найдёт категории и карточки, где просела выручка, и покажет причину: цена, остатки или показы. ### Ответить на отзывы и вопросы покупателей Агент разберёт новые отзывы и вопросы, подготовит ответы в тоне бренда и поднимет наверх негатив, который бьёт по рейтингу карточки. ### Поставка FBO по кластерам Агент посчитает, на сколько хватит остатков в каждом кластере, отберёт SKU с рекомендацией к отгрузке и соберёт заявку на поставку FBO: черновик, таймслот, заявка. ### Сводка по рекламе без кабинета Агент подтянет статистику Performance API, посчитает ДРР по кампаниям и скажет, где реклама окупается, а где сливает бюджет. ### Прибыль по каждому SKU Агент соберёт помесячный P&L из финансовых транзакций и разложит по SKU выручку, комиссию, логистику, возвраты и налог — до чистой прибыли. ### Дежурство по срокам отправлений Агент ловит уведомления Ozon об отменах, переносе даты доставки и смене дедлайна сборки и сразу говорит, по каким отправлениям горит срок. ## Как подключить **Перед подключением** - Роль «Администратор» или «Управляющий» в кабинете Ozon Seller - Продажи, финансы, заказы и остатки читаются на любом тарифе - Премиум-тариф нужен только для воронки показов, возвратов и разрезов - Отзывы по API — подписка «Управление отзывами» или Premium Pro - На части кабинетов раздел отзывов закрыт даже с подпиской ### Войдите на seller.ozon.ru Доступ приложению выдаёт только «Администратор» или «Управляющий». Курьеру, оператору склада и урезанным ролям окно подтверждения не покажут. ### Выберите нужную компанию Если на аккаунт заведено несколько магазинов, Ozon сначала попросит выбрать компанию: доступ выдаётся одному кабинету. Второй магазин подключается отдельно. ### Решите, какой объём прав выдать Ozon перечислит права перед кнопкой «Разрешить». Только чтение — товары, заказы, остатки, аналитика. Полный — чаты, вопросы, скидки, поставки. ### Проверьте доступ к Performance Статистика кампаний и ДРР идут из Performance API на performance.ozon.ru. Без доступа к рекламному кабинету отчётов по рекламе не будет. ### Запомните, где отозвать доступ Выданные приложениям права лежат в кабинете: Настройки → «Приложения и разрешения». Доступ отзывается там в один клик. ## Частые вопросы ### Нужен ли API-ключ, чтобы подключить Ozon? Обычно нет: подключение идёт входом в аккаунт Ozon Seller (OAuth) — вы подтверждаете доступ в кабинете продавца, копировать ключи не нужно. Доступ выдаётся под ролью «Администратор» или «Управляющий»: под остальными ролями окно подтверждения не появится, и тогда остаётся подключение по Client-Id и API-ключу. ### Какие данные Ozon видит агент? Товары, заказы, остатки, возвраты, отзывы и вопросы, аналитику продаж и статистику рекламы Performance API — ровно те разделы, на которые выданы права при входе. Можно выдать только read-only доступ. ### Может ли агент менять что-то в кабинете? Только если вы выдали права на запись: тогда агент сможет отвечать в чатах и на вопросы, работать с заявками на скидку и поставками. С read-only правами агент только читает и анализирует. ### Как быстро появляются данные после подключения? Сразу: агент ходит в Seller API напрямую по вашему запросу, без промежуточных выгрузок. Ограничения по частоте запросов Ozon соблюдаются автоматически. [Открыть Ozon Seller API](https://seller.ozon.ru)