МегаМаркет

Приложение МегаМаркет подключает токен продавца к Promto. Агент может читать отправления и возвраты, а после явного подтверждения — проводить отправления по этапам, обновлять остатки и задавать ручные цены.

Подключение

1. Откройте кабинет партнёра МегаМаркета.
2. Перейдите в настройки API и скопируйте токен продавца.
3. В Promto откройте МегаМаркет и нажмите Подключить.
4. Вставьте токен и выберите контур:

• рабочий — api.megamarket.tech;
• тестовый — api-test.megamarket.tech.

1. Дождитесь проверки безопасным поиском отправлений за один день.

Рабочий и тестовый токены не взаимозаменяемы: тестовый токен на рабочем хосте обычно возвращает 401. Подключать и отключать интеграцию может только владелец рабочего пространства. Токен хранится на сервере.

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

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

Сценарий	Что делает
Новые заказы	Находит отправления со статусом NEW и сроки сборки
Провести отправление	Последовательно подтверждает, упаковывает и передаёт в доставку
Обновить остатки	Отправляет значения по offerId партиями до 300 позиций
Поменять цены	Устанавливает ручную цену или возвращает цену из фида

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

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

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

Область	Действия инструмента
Отправления	list_orders, get_order
Возвраты	list_returns
Этапы заказа	confirm_order, pack_order, ship_order, reject_order, close_order, confirm_cancellation
Остатки	update_stocks
Цены	update_prices
Дополнительный метод API	request

list_orders возвращает не более 100 отправлений за запрос. Если результат упирается в потолок, агент должен сдвигать или уменьшать окно дат.

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

Найти новые отправления

Агент вызывает list_orders со статусом NEW, раскрывает нужные отправления через get_order и сортирует их по сроку сборки.

Провести отправление

Обычная последовательность: get_order → confirm_order → pack_order → ship_order. Каждый переход выполняется отдельно и только после того, как вы увидели состав и подтвердили конкретный шаг.

Обновить остатки

Передайте массив вида [{"offerId": "7", "quantity": 798}]. Прокси делит набор на партии до 300 позиций. Если кабинет управляет остатками через фид, API-запись недоступна: фид и ручное API-управление взаимоисключающие.

Установить ручные цены

Формат: [{"offerId": "10002179", "price": 2000, "isDeleted": false}]. isDeleted: true удаляет ручную цену и возвращает товар к значению из фида.

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

• Все этапы заказа, обновление остатков и цен требуют params.confirm=true после явного согласия.
• Для цен и остатков нет отдельного метода чтения в этой интеграции. Поэтому она не может автоматически подтвердить новое значение повторным чтением; заранее сохраните исходный реестр и внимательно проверьте ответ.
• Партия может выполниться частично: успешные элементы не откатываются, если следующий элемент завершился ошибкой.
• API не предоставляет загрузку товаров, управление поставками FBO и формирование отчётов.
• Бизнес-ошибка может прийти с HTTP 200 и success: 0.
• Токен не нужно и нельзя добавлять в тело request: сервер подставляет его сам.

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

Симптом	Что проверить
401 при верном токене	Совпадает ли токен с рабочим или тестовым контуром
HTTP 200, но операции нет	Проверить success, текст и ошибки отдельных элементов ответа
megamarket_stock_feed_mode	Остатками управляет фид; измените источник в кабинете, если это осознанное решение
Найдено ровно 100 отправлений	Уменьшить период и продолжить выборку по соседнему окну дат
Часть партии обновилась	Зафиксировать успешные элементы и повторить только неуспешные после исправления
Нельзя проверить новую цену	Сверить ответ API и затем проверить значение в кабинете продавца

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

• Настройки рабочего пространства
• Файлы — подготовка партий цен и остатков
• Как получать лучший результат

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

Через promto_megamarket найди отправления NEW за последние сутки и покажи номер, состав и срок сборки. Ничего не меняй. Если ответ содержит 100 строк, продолжи по меньшим окнам дат. Проверяй success в теле каждого ответа, даже если HTTP-код равен 200.