Обмен с 1С для MCP

Исследуйте базу, проверяйте настройки обмена и работайте с объектами 1С через MCP. Ассистент получает инструменты для диагностики и обмена с Shop-Script с учётом редакции вашей базы.

Пять редакций 1С

«Управление нашей фирмой» 3.0, «Розница» 3.0, «Управление торговлей» 11, «Комплексная автоматизация» 2 и «Бухгалтерия предприятия» 3.0. В этих редакциях по-разному называются склады, виды цен, регистры цен и остатков, документы заказа, статусы, ставки НДС и реквизиты номенклатуры.

Определение редакции, версии, версии БСП и функциональных опций подключения: ценообразование 2.5, характеристики, несколько складов, соглашения с клиентами. Запросы только читают данные; результат сохраняется для подключения.

Встроенный справочник по семействам: какие объекты, поля, значения перечислений и запросы использовать для складов, цен, остатков, заказов и счетов, статусов, НДС, контрагентов, номенклатуры, характеристик, единиц и файлов.

Подсказки в описаниях инструментов: 1С молча игнорирует неизвестные поля, отклоняет пустые ссылки и чужие значения перечислений, у подчинённых регистров сведений функции вызываются через _RecordType , составные поля передаются с _Type .

Справочник проверен запросами к облачным базам УНФ и Розницы 3.0.14, УТ 11.6, КА 2.6 и БП 3.0.208. Сведения, взятые только из метаданных, помечены отдельно. Другие релизы и конфигурации определяются по составу опубликованных объектов.

Настройка обмена под редакцию

Агент проверяет настройки приложения «Обмен с 1С» и его плагинов для подключения и помогает клиенту исправить их под свою редакцию.

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

Аудит: склады, регистры и документ заказа другой редакции, значения «Налогообложение НДС» другой конфигурации, пустые организация, склад, вид номенклатуры и соглашение, плагин статусов в Бухгалтерии предприятия, выключенные плагины. Учитываются объекты, которые плагины фактически используют, и совместимость с опубликованными объектами.

Исправление разрешённых настроек с предпросмотром разницы и подтверждением; значения других подключений не меняются.

Объекты, документы и регистры

Чтение опубликованных справочников, документов и регистров через OData: GUID и составные ключи, фильтры, выбор полей, сортировка, связанные данные и страницы результатов.

Создание, изменение и удаление сущностей, проведение документов и отмена проведения.

Индекс схемы базы: схема облачных баз 1С занимает 16–38 МБ, плагин разбирает её потоком и хранит компактно. По индексу агент узнаёт поля и ключи объектов, структуру табличных частей, перечисления, операции и типы параметров.

Проверка тела записи до отправки в 1С: неизвестные поля с подсказкой правильного имени, пустые ссылки, составные поля без типа, значения перечислений другой редакции, строки табличных частей. 1С сама такие поля молча отбрасывает.

Функции регистров, опубликованные базой: остатки, обороты, срезы, а также обороты Дт/Кт и движения с субконто регистра бухгалтерии. Функции подчинённого регистра сведений вызываются на нужном наборе автоматически.

Обмен с магазином без дополнительных плагинов обмена

Экспорт товаров, артикулов, категорий, складов и характеристик Shop-Script; полный состав заказа с покупателем и доставкой и подсказка, в какой документ 1С его выгружать: заказ покупателя (УНФ, Розница), заказ клиента (УТ, КА) или счёт на оплату (БП).

Импорт товаров, артикулов и категорий, обновление цен и частичных складских остатков через штатные API Shop-Script.

Собственные связи сущностей 1С с объектами магазина.

Штатные действия с заказом, назначение менеджера контакту в CRM, импорт фотографий товаров по ссылке и перенос картинок номенклатуры из 1С в товар на сервере: двоичные данные больше 64 КБ агенту не передаются.

Инструменты работают по запросу агента. Непрерывный автоматический обмен по расписанию не включается сам; изменение интервалов штатных плагинов не заменяет их таймеры и не включает выключенные плагины.

Диагностика и контроль записи

Подключения и счётчики очереди, метаданные заданий, результаты webhook и общие интервалы обмена. Завершённое задание не обязательно успешно: инструмент результатов показывает состояние и HTTP-статус.

Изменения требуют предварительной проверки, подтверждения и одноразового согласия MCP для точных параметров. Постоянные ключи запросов и операций защищают от повторной записи; при неизвестном исходе запись не повторяется автоматически. Поддерживается режим подключения «только чтение».

Пароли, токены подключения, исходные транспортные ошибки и заголовки агенту не выдаются. Данные объектов возвращаются только соответствующими инструментами. Для интервалов действует диапазон 60–86400 секунд; изменение интервала не очищает таймер и не запускает обмен немедленно.

Требования и совместимость

MCP версии 1.9.0 или выше и приложение «Обмен с 1С» версии 2.9.0 или выше. Требуются опубликованный OData-сервис и права пользователя 1С на нужные объекты. Облачный запрос отправляется через сервер; коробочная 1С использует свой клиент опроса.

Для каждого инструмента нужны отдельное право MCP и права администратора приложения 1С. Операции магазина требуют администратора Shop-Script, назначение менеджера — администратора CRM. Настроенные фильтры доступа Shop не обходятся; для видов объектов, где фильтр не поддержан, операция отклоняется. Штатные действия с заказом выполняют учёт остатков, обработчики событий и настроенные уведомления.

Для изменения настроек обмена нужно отдельное право MCP.

Встроенные навыки MCP содержат практические сценарии: определение редакции и справочник по ней, настройка обмена под редакцию, работа с документами, регистрами и составными ключами.

Нет своей 1С или нужна тестовая база? Мы проверяем плагины на облачной 1С от Scloud — её можно арендовать: scloud.ru .

Подключите своего ассистента

Для работы нужны приложение MCP, приложения и сервисы из требований выше, а также совместимый ИИ-клиент. Плагин предоставляет инструменты: подключённый ассистент использует их по вашим задачам и в пределах выданных прав.