Платформа

Ozon

Товары, заказы FBS и FBO, остатки, цены, аналитика и финансы продавца.

9 мин чтения

Ozon

Приложение Ozon подключает кабинет продавца к рабочему пространству Promto. Агент может работать с каталогом, отправлениями FBS и FBO, остатками, ценами, аналитикой, транзакциями и возвратами. Изменение цен и остатков выполняется только после явного подтверждения.

Подключение

Откройте кабинет продавца Ozon и перейдите в Настройки → Seller API.
Создайте ключ с минимально необходимыми ролями.
Скопируйте числовой Client-Id и Api-Key. Ключ может отображаться только при создании.
В Promto откройте приложение Ozon, нажмите Подключить и вставьте оба значения.
Дождитесь проверки ролей и срока действия ключа.

Ключ Seller API действует шесть месяцев. Дата окончания показывается в настройках Promto; обновите подключение заранее, чтобы автоматические задачи не остановились в день истечения.

Интерфейс приложения

На главном экране доступны сценарии:

Сценарий	Результат
Каталог	Список товаров, статусы и атрибуты
Заказы FBS	Необработанные отправления и ближайшие сроки
Остатки	Товары с нулевым или низким запасом
Аналитика	Выручка и заказанные единицы за период
Финансы и возвраты	Транзакции, итоги и возвраты

Карточка сценария прикрепляет промпт к чату. В Настройках видны Client-Id, маска ключа, роли, срок действия и состояние подключения.

Работа с агентом

Основной агент использует инструмент promto_ozon. Это встроенный инструмент чата, а не команда терминала.

Область	Действия инструмента
Каталог	`list_products`, `get_product_info`, `get_product_attributes`
FBS	`list_postings_fbs`, `get_posting_fbs`, `list_unfulfilled_fbs`
FBO	`list_postings_fbo`
Остатки	`get_stocks`, `update_stocks`
Цены	`get_prices`, `update_prices`
Аналитика	`get_analytics`
Финансы	`list_transactions`, `get_transaction_totals`
Возвраты	`list_returns`
Дополнительный метод Seller API	`request`

В Ozon большинство методов вызываются через POST, даже когда только читают данные: фильтры передаются в теле запроса. Поэтому HTTP-метод сам по себе не означает изменение.

Практические сценарии

Проверить необработанные FBS-отправления

Агент вызовет list_unfulfilled_fbs, отсортирует отправления по сроку сборки и покажет номер, состав и дедлайн. Для подробностей конкретного отправления используется get_posting_fbs.

Найти риск дефицита

Передайте порог остатка или ожидаемый спрос. Агент соберёт остатки, отделит склады и подготовит проект новых значений. Запись выполняется только после просмотра полного списка изменений.

Сравнить продажи

Укажите период и группировку. Агент запросит аналитику, например revenue и ordered_units по SKU, а затем явно укажет диапазон дат и единицы измерения.

Сверить финансы и возвраты

Агент получит транзакции, агрегированные итоги и список возвратов. Для бухгалтерской сверки приложите собственный реестр через Файлы.

Изменение цен и остатков

update_stocks и update_prices требуют params.confirm=true. До подтверждения агент должен:

прочитать текущее состояние;
показать SKU, склад, прежнее и новое значение;
получить явное согласие;
выполнить запись;
перечитать данные и показать ошибки по каждой позиции.

Ozon может вернуть HTTP 200, но указать ошибку для отдельных элементов внутри ответа. Успех транспорта нельзя считать успехом всей партии.

Ограничения и безопасность

Доступ зависит от ролей ключа. Для отсутствующей роли создайте или обновите ключ в кабинете.
Ключ с IP-ограничением должен разрешать инфраструктуру, через которую Promto обращается к Ozon.
Рекламные кампании Ozon Performance используют отдельный API и отдельные ключи; эта интеграция их не подключает.
Порог API — до 50 запросов в секунду; при ограничении уменьшите параллелизм и повторяйте с паузой.
Не передавайте Api-Key в чат или request: сервер добавляет заголовки самостоятельно.
Перед массовой записью сохраняйте исходные значения и проверяйте каждую строку результата.

Если не работает

Симптом	Что проверить
Ошибка `Client-Id`	Значение должно быть числовым и относиться к тому же кабинету, что и ключ
`401`	Ключ неверен, отозван или истёк; создайте новый и переподключите
Не хватает прав	Добавьте нужную роль Seller API и повторите проверку
Ошибка IP	Проверьте ограничения ключа в кабинете Ozon
Часть партии не обновилась	Разберите ошибки каждого элемента, исправьте только неуспешные строки и перечитайте состояние
`429`	Снизьте частоту и параллелизм, выдержите паузу перед повтором

Связанные материалы

Готовый промпт

Через promto_ozon найди необработанные FBS-отправления и остатки по их товарам. Покажи таблицу с posting number, SKU, количеством и сроком сборки. Ничего не меняй. Учти ошибки внутри ответа даже при HTTP 200 и укажи, если ключу не хватает роли.

← Документация

Платформа

Ozon

Товары, заказы FBS и FBO, остатки, цены, аналитика и финансы продавца.

9 мин чтения

Ozon

Подключение

Откройте кабинет продавца Ozon и перейдите в Настройки → Seller API.
Создайте ключ с минимально необходимыми ролями.
Скопируйте числовой Client-Id и Api-Key. Ключ может отображаться только при создании.
В Promto откройте приложение Ozon, нажмите Подключить и вставьте оба значения.
Дождитесь проверки ролей и срока действия ключа.

Интерфейс приложения

На главном экране доступны сценарии:

Сценарий	Результат
Каталог	Список товаров, статусы и атрибуты
Заказы FBS	Необработанные отправления и ближайшие сроки
Остатки	Товары с нулевым или низким запасом
Аналитика	Выручка и заказанные единицы за период
Финансы и возвраты	Транзакции, итоги и возвраты

Работа с агентом

Основной агент использует инструмент promto_ozon. Это встроенный инструмент чата, а не команда терминала.

Область	Действия инструмента
Каталог	`list_products`, `get_product_info`, `get_product_attributes`
FBS	`list_postings_fbs`, `get_posting_fbs`, `list_unfulfilled_fbs`
FBO	`list_postings_fbo`
Остатки	`get_stocks`, `update_stocks`
Цены	`get_prices`, `update_prices`
Аналитика	`get_analytics`
Финансы	`list_transactions`, `get_transaction_totals`
Возвраты	`list_returns`
Дополнительный метод Seller API	`request`

Практические сценарии

Проверить необработанные FBS-отправления

Найти риск дефицита

Сравнить продажи

Сверить финансы и возвраты

Изменение цен и остатков

update_stocks и update_prices требуют params.confirm=true. До подтверждения агент должен:

прочитать текущее состояние;
показать SKU, склад, прежнее и новое значение;
получить явное согласие;
выполнить запись;
перечитать данные и показать ошибки по каждой позиции.

Ограничения и безопасность

Доступ зависит от ролей ключа. Для отсутствующей роли создайте или обновите ключ в кабинете.
Ключ с IP-ограничением должен разрешать инфраструктуру, через которую Promto обращается к Ozon.
Рекламные кампании Ozon Performance используют отдельный API и отдельные ключи; эта интеграция их не подключает.
Порог API — до 50 запросов в секунду; при ограничении уменьшите параллелизм и повторяйте с паузой.
Не передавайте Api-Key в чат или request: сервер добавляет заголовки самостоятельно.
Перед массовой записью сохраняйте исходные значения и проверяйте каждую строку результата.

Если не работает

Симптом	Что проверить
Ошибка `Client-Id`	Значение должно быть числовым и относиться к тому же кабинету, что и ключ
`401`	Ключ неверен, отозван или истёк; создайте новый и переподключите
Не хватает прав	Добавьте нужную роль Seller API и повторите проверку
Ошибка IP	Проверьте ограничения ключа в кабинете Ozon
Часть партии не обновилась	Разберите ошибки каждого элемента, исправьте только неуспешные строки и перечитайте состояние
`429`	Снизьте частоту и параллелизм, выдержите паузу перед повтором

Связанные материалы

Готовый промпт

Через promto_ozon найди необработанные FBS-отправления и остатки по их товарам. Покажи таблицу с posting number, SKU, количеством и сроком сборки. Ничего не меняй. Учти ошибки внутри ответа даже при HTTP 200 и укажи, если ключу не хватает роли.