SellerAgent

Тема

Подключение Ozon ​

Как привязать Ozon Seller к SellerAgent: получить пару Client-Id + Api-Key в личном кабинете Ozon и ввести их в карточке подключения.

Что вам понадобится ​

  • Доступ владельца / администратора к личному кабинету Ozon Seller.
  • 5 минут на выпуск API-ключа.
  • Роль «Владелец» в SellerAgent (сотрудник подключать магазины не может — см. Подключения).

Шаг 1. Выпустить ключ в Ozon Seller ​

  1. Зайдите в Ozon Seller: https://seller.ozon.ru/

  2. Откройте Настройки → API-ключи: https://seller.ozon.ru/app/settings/api-keys. На этой же странице сверху виден Client-Id — он одинаков для всех ключей кабинета.

  3. Нажмите «Сгенерировать ключ».

  4. Заполните название (например, SellerAgent).

  5. Выберите роль ключа. Ozon не даёт галочек «аналитика», «финансы», «остатки» — он даёт готовые роли, и называются они в кабинете по-английски. SellerAgent'у нужна одна:

    Admin read only — в описании Ozon: «Позволяет оперировать всеми информационными методами Seller API без внесения изменений».

    Этого достаточно для всей аналитики: товары, остатки, заказы FBO и FBS, начисления и удержания, возвраты, заявки на поставку. Роль — только на чтение: SellerAgent не меняет ваши товары, цены, остатки и статусы заказов.

    Более узкие роли Ozon (Product read-only, Posting FBO, Returns read-only, Report, Warehouse) по отдельности нужный набор не закрывают — часть данных, без которых не считается прибыль (начисления, остатки, возвраты, заявки на поставку), отдаётся только роли Admin read only. Выбирать их вместо неё не нужно.

  6. Если вы будете бронировать поставки прямо из SellerAgent (раздел «Поставки» → мастер брони Ozon), одной read-only-роли мало: бронь создаёт и изменяет заявку на поставку в вашем кабинете, а Admin read only любые изменения запрещает. Тогда к ключу нужна ещё и роль на управление поставками FBO — Supply order; если мастер брони всё равно отвечает, что не хватает прав, выпустите ключ с полной ролью Admin. Для отчётов и «Прогноза поставок» это не требуется — там всё работает на Admin read only.

  7. Нажмите «Создать ключ» и скопируйте Api-Key в безопасное место. Api-Key показывается только один раз — если потеряете, придётся выпустить новый ключ.

У ключа Ozon есть срок действия. SellerAgent показывает его в карточке подключения и подсвечивает, когда срок подходит к концу, — тогда выпустите новый ключ и сохраните его кнопкой «Заменить ключ».

Подробная справка Ozon: https://docs.ozon.ru/api/seller/#section/Avtorizaciya (ссылка «Где получить ключи» есть и в самой форме подключения).

Шаг 2. Ввести ключи в SellerAgent ​

  1. В SellerAgent откройте Подключения (левое меню).
  2. Если это первый Ozon-магазин, заполните стартовую форму в блоке Ozon. Если Ozon-магазины уже есть, нажмите «Добавить магазин» в заголовке блока Ozon.
  3. В карточке Ozon заполните форму:
    • Client-Id — числовое значение, скопированное на предыдущем шаге.
    • Api-Key — длинная строка с дефисами. Поле — типа «пароль», содержимое скрыто.
    • Название магазина — обязательное короткое имя магазина, например Основной, ИП Иванов, B2C (по умолчанию — «Основной»). Название уникально внутри Ozon; такое же название в WB или Яндекс.Маркете допустимо.
  4. Нажмите «Подключить».

Ключи проверяются прямо при сохранении: SellerAgent обращается к Ozon и убеждается, что они действуют. Если ключи приняты — карточка перерисуется в «подключённое» состояние: зелёный бейдж «Подключено» в шапке, маска Client-Id — и сразу начнётся первая загрузка данных (см. шаг 3). Если Ozon ключи не принял — увидите понятное сообщение об ошибке, и ключи не сохранятся.

Что именно проверяется при сохранении ​

Полезно понимать границу — она объясняет, почему ключ может сохраниться, а данные всё равно не пойти:

  • При сохранении SellerAgent делает два запроса в Ozon: за карточкой вашего кабинета продавца («ключ рабочий или нет») и за списком доступных ключу методов. Если Ozon отвечает отказом (ключ неверный, удалён, выпущен для другого Client-Id) — ключ не сохраняется. Права ключа теперь тоже проверяются: если не хватает чего-то из «Товары, Заказы, Финансы, Возвраты, Аналитика», ключ не сохранится и SellerAgent покажет, чего именно не хватает. Единственное исключение — поставки: их методы SellerAgent вызывает на запись (бронь заявки в вашем кабинете), поэтому требовать их ради необязательного раздела мы не станем — ключ без них подключается нормально, просто мастер брони не заработает. Если Ozon в этот момент недоступен, права выяснить не удаётся — тогда ключ сохранится, а нехватку прав вы увидите в строке прав и в ошибке синхронизации.
  • Сразу после сохранения под шапкой карточки появляется строка прав — SellerAgent спрашивает у Ozon, какие роли и методы доступны ключу, и показывает ✓ или ⚠ напротив: Товары, Заказы, Финансы, Возвраты, Аналитика, а рядом — срок действия ключа. Это названия наших разделов, а не ролей Ozon: строка отвечает на вопрос «хватит ли ключа для этих данных». Если хоть один пункт жёлтый — роль выбрана не та, вернитесь к шагу 1 (пункт «Поставки» серый — это нормально, он не обязателен). Кнопка «Обновить» перепроверяет права после замены ключа.
  • Если роли всё-таки не хватило, синхронизация не падает целиком: недоступный кусок помечается ошибкой на своей стадии, остальное загружается. В карточке появится красный баннер с текстом «Нет доступа к API Ozon: API-ключ недействителен или не хватает прав».

Шаг 3. Проверить, что данные потекли ​

Сразу после подключения SellerAgent автоматически запускает первую загрузку данных — нажимать ничего не нужно. Ход виден в карточке магазина: блок «Синхронизация в процессе» с текущей стадией и прогрессом (товары → остатки → заказы → финансы).

Глубина первой загрузки зависит от тарифа: на бесплатном — заказы и финансы за последние ~4 месяца (120 дней), на платных — вся история, которую отдаёт Ozon (до 4 лет). Первый прогон на средний каталог — 1–5 минут; полная история — дольше, иногда 10–30 минут. Можно закрыть вкладку, загрузка продолжится в фоне.

Когда в карточке обновится время «Последняя синхронизация» — можно открывать ABC-отчёт.

Налоговая ставка и историческая глубина ​

После первой загрузки:

  1. Проверьте налог — он задаётся не здесь, а один раз на всё пространство (ИП) в «Финансы» → «Налоговые ставки»: режим налогообложения на год и ставки основного налога и НДС по месяцам (по умолчанию УСН «Доходы» 6 %, без НДС). Подробности — в Финансы → Налоговые ставки.
  2. Если нужна глубокая история (например, для сравнения год к году в ABC-отчёте) — она загружается автоматически на платных тарифах: при подключении магазина сразу подтягивается вся доступная история (до 4 лет), а при переходе с бесплатного тарифа на платный она догружается сама — ничего нажимать не нужно. Ozon отдаёт глубокую историю по FBO.

Что SellerAgent получает из Ozon ​

Всё перечисленное покрывается ролью Admin read only — отдельно доразрешать ничего не нужно.

  • Каталог товаров — название, артикул, штрихкод, бренд, категория. Бренд и категория берутся отдельно: бренд — из характеристик товара, категория — из справочника категорий Ozon. Архивные товары тоже загружаются, иначе их продажи остались бы без названия.
  • Остатки FBO — по складам Ozon. Также синхронизируются остатки FBS — по вашим складам отгрузки.
  • Заказы FBO — со всеми статусами, включая доставленные, в пути и отменённые. Также синхронизируются заказы FBS и rFBS (со склада продавца); rFBS учитывается как FBS. Стадии FBS не блокируют FBO и финансы: если ключ до них не достаёт, эти стадии просто пропускаются, а остальная загрузка проходит.
  • Начисления и удержания — комиссия, эквайринг, логистика, хранение, продвижение. Нужны для расчёта чистой прибыли в ABC и ОПиУ.
  • Возвраты — без них не посчитать процент выкупа.
  • Заявки на поставку FBO — питают раздел «Поставки». Стадия тоже не блокирующая: не хватило прав — заявки не подтянутся, остальное загрузится.

Частые вопросы ​

Я не вижу «API-ключи» в настройках Ozon Seller. Раздел доступен только владельцу личного кабинета (или сотруднику с правами администратора). Попросите владельца ЛК создать ключ или пригласить вас с нужными правами.

Какую роль выбрать, если в списке ролей Ozon её не видно? Роли в кабинете Ozon подписаны по-английски и лежат одним списком. Нужная называется Admin read only — она отдаёт все данные и запрещает любые изменения. Роль Admin тоже подойдёт, но она даёт и право менять товары, цены и заказы: для отчётов это лишнее.

Где найти Client-Id, если я случайно закрыл окно? Зайдите снова в Настройки → API-ключи — Client-Id виден на этой странице всегда и одинаков для всех ключей кабинета. А вот Api-Key показывается только при создании — если его потеряли, выпустите новый ключ и введите его в SellerAgent.

В карточке подключения жёлтая метка напротив «Финансы» (или другого пункта). Ключ выпущен с ролью, которая этих данных не отдаёт. Выпустите новый ключ с ролью Admin read only и сохраните его кнопкой «Заменить ключ» — история не потеряется. После замены нажмите «Обновить» в строке прав, чтобы метки перечитались.

Мастер брони поставки пишет, что у API-ключа нет прав на методы поставок. Так и должно быть, если ключ выпущен только с ролью Admin read only: она запрещает изменения, а бронь создаёт и меняет заявку на поставку в вашем кабинете. Выпустите ключ с ролью на управление поставками FBO (Supply order), а если не помогло — с полной ролью Admin, и сохраните его кнопкой «Заменить ключ». Отчёты и «Прогноз поставок» этой роли не требуют.

Перевыпустил ключ в Ozon — что делать в SellerAgent? В карточке Ozon нажмите «Заменить ключ», введите Client-Id и новый Api-Key — магазин не отключается, история сохраняется, а сразу после замены автоматически пройдёт проверочная синхронизация. Новый ключ должен быть из того же кабинета Ozon (Client-Id остаётся прежним) — ключ другого кабинета сервис отклонит; другой кабинет подключайте отдельным магазином.

Хочу подключить два кабинета Ozon (разные ИП). Можно подключить несколько Ozon-магазинов в одном рабочем пространстве. В блоке Ozon нажмите «Добавить магазин» и сохраните ключи второго кабинета с отдельным названием. Каждый магазин будет отдельной карточкой со своими ключами, состоянием синхронизации и данными. Налоговая ставка при этом общая на всё пространство (ИП).

Связанные разделы ​