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 ключи.
  3. Нажмите «Создать ключ».
  4. Заполните название (например, SellerAgent).
  5. Включите права (галочки), которые нужны SellerAgent:
    • Аналитика
    • Финансы
    • Товары
    • Заказы
    • Остатки
  6. Сохраните ключ. Ozon покажет Client-Id и Api-Key — скопируйте оба в безопасное место. Api-Key показывается только один раз — если потеряете, нужно будет создать новый ключ.

Подробная справка 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. Нажмите «Подключить».

Если форма приняла ключи — карточка перерисуется в «подключённое» состояние: зелёный бейдж «Подключено» в шапке, маска Client-Id, кнопка «Синхронизировать». Если ключи невалидные — увидите красный тост с описанием ошибки.

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

Сразу после подключения SellerAgent не запускает синхронизацию автоматически. Нажмите «Синхронизировать» в той же карточке. В верхней панели появится индикатор стадии:

Ozon: синхронизация · товары → остатки → заказы → транзакции → связка дат

Первый прогон — 1–5 минут на средний каталог. Можно закрыть вкладку, синхронизация продолжится в фоне.

Когда индикатор станет зелёным («Синхронизировано N мин назад») — можно открывать ABC-отчёт.

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

После первого синка:

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

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

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

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

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

Где найти Client-Id, если я случайно закрыл окно? Зайдите снова в Настройки → API ключи — Client-Id остаётся видимым в списке ключей. А вот Api-Key показывается только при создании — если его потеряли, придётся нажать «Создать ключ» ещё раз и ввести новый в SellerAgent.

Перевыпустил ключ в Ozon — что делать в SellerAgent? В карточке Ozon в SellerAgent нажмите «Отключить», затем введите новые Client-Id + Api-Key. Исторические данные остаются — после повторного подключения они никуда не пропадают.

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

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