МойСклад

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

Подключение

1. Войдите в МойСклад.
2. Перейдите в Настройки → Сотрудники, откройте нужного сотрудника и раздел доступа к API.
3. Скопируйте существующий токен сотрудника.
4. В Promto откройте МойСклад, нажмите Подключить и вставьте токен.
5. Дождитесь проверки чтением доступных организаций.

Права токена совпадают с ролью сотрудника. Подключать и отключать интеграцию может только владелец рабочего пространства. Токен хранится на сервере и не передаётся агенту.

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

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

• Ниже минимального остатка — товары, для которых запас ниже заданного порога по складу;
• Заказы за неделю — список и сводка заказов покупателя;
• Прибыль по товарам — отчёт по продуктам;
• Подключение — ввод или замена токена.

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

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

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

Область	Действия инструмента
Товары	list_products, get_product
Контрагенты	list_counterparties, get_counterparty
Заказы	list_orders, get_order, create_order
Складские документы	list_demands, list_supplies, list_moves, create_move
Остатки	get_stock, get_stock_by_store
Отчёты	get_profit_by_product, get_money
Справочники	list_stores, list_organizations, get_metadata
Дополнительный метод API	request

Все суммы API МойСклад передаёт в копейках. Агент должен преобразовывать их в рубли делением на 100 и указывать валюту. При создании документа обратное преобразование должно быть точным.

Ссылки на сущности передаются объектами meta.href. Надёжный порядок: сначала прочитать организацию, контрагента, товар или склад, затем повторно использовать фактическую ссылку из ответа, а не собирать URL вручную.

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

Найти товары ниже минимума

Передайте склад и порог. Агент использует серверный фильтр отчёта. Положительный остаток не означает, что товар выше минимального запаса конкретного склада.

Сверить продажи и прибыль

Агент получает заказы и отчёт по прибыли за одинаковый период, переводит суммы из копеек и отдельно указывает отменённые или незавершённые документы.

Создать заказ покупателя

Сначала агент находит организацию, контрагента и товары, показывает все meta.href, количества и суммы. create_order выполняется только после утверждения полного проекта документа.

Создать перемещение

Агент проверяет склад-источник, склад-получатель и доступный остаток, затем показывает позиции. После согласия вызывает create_move с params.confirm=true.

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

• Ошибка 403 обычно означает недостаточные права роли сотрудника, а не неверный токен.
• create_order, create_move и изменяющий вызов через request требуют явного подтверждения.
• Не создавайте новый токен, если можно безопасно использовать существующий: старый будет отозван.
• API ограничивает частоту и параллелизм. При 429 агент делает не более контролируемого повтора и не запускает бесконечный цикл.
• Складские отчёты расходуют больший бюджет API, чем обычное чтение.
• Не передавайте токен в чат, проект или тело request.
• Перед записью сохраняйте исходные ссылки сущностей и сверяйте фактический созданный документ.

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

Симптом	Что проверить
403 при рабочем токене	Роль сотрудника и права на нужный тип документа или отчёт
После выпуска токена сломалась другая система	Новый токен отозвал прежний; обновите зависимые подключения
Сумма в 100 раз больше	Значение API не переведено из копеек в рубли
Ссылка на сущность отклонена	Использовать точный meta.href из ответа API
429	Снизить параллелизм, выдержать паузу, не повторять запрос бесконечно
Товар с положительным остатком попал в дефицит	Проверить минимум и склад: остаток может быть ниже порога

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

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

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

Через promto_moysklad найди товары ниже минимального остатка на складе <СКЛАД> при пороге <ПОРОГ>. Используй серверный фильтр, переводи суммы из копеек в рубли и указывай валюту. Ничего не создавай и не меняй. Для ссылок на сущности используй фактические meta.href из ответов.