Ozon

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

Подключение

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

Ключ 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. До подтверждения агент должен:

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

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 и укажи, если ключу не хватает роли.