Платформа
Яндекс Маркет
Кампании, заказы, остатки, цены и отчёты кабинета продавца.
Яндекс Маркет
Приложение Яндекс Маркет подключает партнёрский кабинет продавца к Promto. Агент может читать магазины и бизнесы, товары, заказы, цены и остатки, создавать асинхронные отчёты и после подтверждения обновлять цены или складские остатки.
Какие идентификаторы используются
В API Яндекс Маркета два уровня:
| Идентификатор | Где используется |
|---|---|
campaignId | Заказы, настройки и состояние конкретного магазина |
businessId | Товары, цены и остатки общего бизнеса |
Не подставляйте один идентификатор вместо другого. Начинайте работу с list_campaigns: ответ связывает кампании, бизнесы и модели работы FBS, FBY, DBS или экспресс-доставки.
Подключение
- Откройте кабинет партнёра Яндекс Маркета.
- Перейдите в Настройки → API и модули → Авторизационные токены.
- Создайте API-ключ и выдайте только нужные права: заказы и остатки, цены, товары и карточки, продвижение, финансы и отчётность.
- Скопируйте ключ.
- В Promto откройте Яндекс Маркет, нажмите Подключить и вставьте ключ.
- Дождитесь чтения доступных кампаний и бизнесов.
Изменение прав на стороне Маркета может применяться до десяти минут. Подключать и отключать интеграцию может только владелец рабочего пространства. Ключ остаётся на сервере и не показывается агенту.
Интерфейс приложения
На главном экране есть сценарии:
- Магазины и бизнесы — идентификаторы, модели работы и состояние API;
- Заказы — список за период и подробности заказа;
- Цены и остатки — расхождения и кандидаты на обновление;
- Отчёт — запуск и получение асинхронного отчёта.
В Настройках отображаются маска ключа, кампании, campaignId, businessId, модели работы, права и возможная блокировка доступа к API.
Работа с агентом
Основной агент использует инструмент promto_ymarket. Это встроенный инструмент чата, а не команда терминала.
| Область | Действия инструмента |
|---|---|
| Кабинеты | list_campaigns, get_campaign |
| Товары | list_offers, list_campaign_offers |
| Заказы | list_orders, get_order |
| Остатки | get_stocks, update_stocks |
| Цены | get_prices, update_prices |
| Отчёты | generate_report, get_report_info |
| Дополнительный метод API | request |
Цены и ставки API передаёт в копейках. Агент должен делить значение на 100 и всегда подписывать валюту, а при записи переводить рубли обратно в копейки без потери точности.
Практические сценарии
Разобрать заказы магазина
Выберите campaignId, период и статусы. Агент покажет заказы и при необходимости запросит детали каждого через get_order.
Проверить карточки и остатки бизнеса
Выберите businessId. Агент сопоставит предложения, цены и склады и выделит отсутствующие или подозрительные значения.
Сформировать отчёт
Отчёты создаются асинхронно: агент вызывает generate_report, сохраняет идентификатор задачи и опрашивает get_report_info до конечного состояния. Ссылка на готовый файл действует около 60 минут, поэтому скачайте его сразу в Файлы, если он понадобится позже.
Изменения в кабинете
update_stocks и update_prices требуют явного подтверждения и params.confirm=true. Массовая операция Маркета может отклонить всю партию из-за одной неверной позиции. Прокси делит большие наборы на части и возвращает результат каждой части, но перед повтором всё равно нужно перечитать фактическое состояние.
Ограничения и безопасность
- Пустой ответ не всегда означает ноль данных: причиной может быть отсутствующее право ключа.
campaignIdиbusinessIdне взаимозаменяемы.- Суммы API обычно указаны в копейках; проверяйте преобразование до записи.
- Ссылки на асинхронные отчёты ограничены по времени.
- Изменение прав токена может применяться не сразу.
- Доступ к API бывает заблокирован из-за неактивности магазина, отсутствующего договора или ручного ограничения. Причину смотрите в настройках.
- Не вставляйте API-ключ в чат, проект или параметры
request.
Если не работает
| Симптом | Что проверить |
|---|---|
| Кампании не найдены | Права ключа, активность магазина и время после изменения прав |
| Заказы есть, товары не читаются | Для товаров нужен businessId и соответствующее право |
| Цена в 100 раз больше или меньше | Преобразование копеек и рублей |
| Отчёт не скачивается | Повторно получить состояние и новую ссылку через get_report_info |
| Массовая запись отклонена | Найти ошибочную позицию, исправить её и перечитать всю затронутую часть |
| API заблокирован | Посмотреть статус кампании и причину блокировки в приложении и кабинете |
Связанные материалы
Готовый промпт
Через promto_ymarket сначала вызови list_campaigns и покажи связи campaignId, businessId и модели работы. После моего выбора собери заказы за <ПЕРИОД>. Ничего не меняй. Все денежные значения переведи из копеек в рубли и явно укажи выбранный campaignId.