Интеграция МойСклад с OpenCowork: остатки, документы и операции

Интеграция МойСклад с OpenCowork уже доступна. Агент может читать товары, ассортимент, контрагентов, склады, договоры, сотрудников, документы, позиции, остатки и движения. Для создания или изменения данных используется отдельный операционный контур: перед записью OpenCowork показывает предлагаемое действие и ждёт подтверждение пользователя.

Это не фоновая синхронизация двух баз и не универсальный доступ ко всему API. Интеграция построена вокруг рабочих задач. Менеджер может попросить проверить наличие товара и подготовить заказ покупателя. Закупщик — сверить счёт поставщика и подготовить приёмку. Руководитель склада — найти расхождение и предложить перемещение между складами. Результат остаётся проверяемым, а запись выполняется только в разрешённом проекте.

Короткий ответ

В OpenCowork есть два связанных подключения к МойСклад:

Разделение нужно для безопасности. Агент может свободно собрать факты для ответа, но не должен создавать документ только потому, что пользователь упомянул такую возможность в сообщении. Для конкретной записи появляется отдельное согласование с понятными аргументами.

Почему не стоит конкурировать за запрос «мой склад вход»

По срезу Wordstat запрос мой склад получает около 137 тысяч показов в месяц, однако большая часть спроса навигационная. мой склад вход имеет 19 740, а мой склад личный кабинет — 14 302. Эти пользователи хотят попасть в уже известный сервис, а не выбрать интеграцию.

Для OpenCowork важнее продуктовые запросы: интеграция мой склад — 967, настройка мой склад — 976, мой склад отчёты — 416 и мой склад API — 273 в текущем срезе. Они отражают потребность связать складскую систему с реальной работой команды.

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

Что агент может читать из МоегоСклада

Read-only подключение использует одобренные GET-операции JSON API 1.2. Оно покрывает основные справочники и операционные документы, необходимые для анализа.

• Контрагенты с поиском и фильтрами.
• Товары и общий ассортимент, включая услуги, модификации и комплекты.
• Собственные организации, склады, договоры и сотрудников.
• Заказы, счета, отгрузки, приёмки, перемещения, списания и другие разрешённые типы документов.
• Позиции конкретного документа.
• Текущие остатки в целом и по складам.
• Документы движения товаров за выбранный период.

Результаты выдаются с ограничением количества строк и пагинацией. Это защищает чат от огромных ответов и позволяет агенту сначала найти нужные сущности, а затем работать с их точными идентификаторами.

Какие операции доступны после подтверждения

Операционный коннектор не принимает произвольные URL или сырой JSON от модели. Backend собирает ограниченный payload и обращается только к одобренным endpoint МоегоСклада.

Перед созданием агент должен найти собственную организацию, контрагента, склад и позиции ассортимента. Затем он показывает пользователю предлагаемое действие. Пользователь может подтвердить его, изменить аргументы или отклонить. Отклонённый вызов не обращается к API.

Как подключить МойСклад к OpenCowork

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

1. В МойСклад создайте токен с правами, достаточными для выбранного сценария.
2. Откройте плагины проекта OpenCowork и выберите МойСклад.
3. Сохраните токен в защищённом поле подключения.
4. Проверьте read-only доступ: найдите несколько складов или товаров.
5. Подключайте «МойСклад: операции» только если команде действительно нужны записи.
6. Выполните тест на отдельном документе и проверьте результат в интерфейсе МоегоСклада.

Токен хранится в backend как зашифрованный secret reference. Он не должен возвращаться в frontend, попадать в сообщения агента или сохраняться в его памяти.

Пример: заказ покупателя из письма

Менеджер получает письмо с перечнем товаров. Обычно ему приходится искать контрагента, сверять артикулы, проверять остатки, переносить количество и цену, а затем создавать заказ.

В OpenCowork задачу можно сформулировать так:

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

Агент читает заявку, использует read-инструменты, сопоставляет позиции и возвращает таблицу проверки. Если данных достаточно, он готовит вызов создания заказа. Пользователь видит организацию, контрагента, позиции, количество и цены, после чего принимает решение.

Пример: приёмка от поставщика

Для закупки процесс похож, но источником может быть счёт или накладная поставщика. Агент:

1. Извлекает реквизиты и позиции из файла.
2. Находит поставщика и товары в МойСклад.
3. Проверяет единицы измерения, количество, цену и НДС.
4. Показывает расхождения и недостающие связи.
5. После подтверждения создаёт заказ поставщику, входящий счёт или приёмку — только тот документ, который запросил пользователь.

Если товар не найден, агент не должен молча создавать новый справочник. Создание товара является отдельным согласуемым действием.

Пример: контроль остатков и движений

Read-only режим полезен даже без операционного подключения. Руководитель может попросить:

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

Предложение и факт — разные вещи. Агент может посчитать, что на склад B стоит перевезти 20 единиц, но само перемещение создаётся только после проверки человеком.

Что интеграция не делает

OpenCowork не заменяет интерфейс МоегоСклада и не открывает модели произвольный доступ к API. Интеграция также не устанавливает кассовые драйверы, не настраивает ККТ и не подключает ТС ПИОТ на устройстве. Для ПИОТ нужна отдельная настройка компонентов ЕСП и точки продаж; этому посвящена статья «ПИОТ в МойСклад: настройка и ошибки».

Не следует обещать автоматическое проведение, удаление или массовое изменение документов без отдельного разрешённого действия и проверки. Человек остаётся владельцем складской и финансовой операции.

Что проверить перед внедрением

• Токен принадлежит нужному проекту и имеет минимальные необходимые права.
• В МойСклад однозначно определены организации и склады.
• Артикулы и контрагенты не создают дубли.
• Команда согласовала, какие документы можно только читать, а какие создавать.
• Для каждой записи понятен экран подтверждения и ответственный сотрудник.
• Первый тест выполняется на небольшом наборе данных.

Следующий шаг

Начните с безопасной задачи: подключите МойСклад, попросите OpenCowork найти остатки по пяти артикулам и объяснить расхождения между складами. Когда чтение проверено, можно добавить отдельный операционный сценарий с подтверждением. Перейти к проекту можно в OpenCowork, а больше примеров собрано в разделе бизнес-задач.

Технической основой подключения служит официальный JSON API 1.2 МоегоСклада.