Скилл 1С OData в Aizor: как подключить базу 1С и поручить агенту отчёты и документы

Что даёт скилл 1С OData в Aizor

По описанию Aizor, скилл читает и записывает справочники, документы и регистры 1С:Предприятие 8 через стандартный OData/REST-интерфейс. Вы пишете агенту в чате обычными словами, он обращается к базе и отвечает.

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

Что понадобится

• База 1С:Предприятие 8, у которой платформа поддерживает автоматический REST-интерфейс. Он появился в версии 8.3.5.1068.
• Веб-сервер, на котором опубликована база. Интерфейс OData публикуется на веб-сервере, после чего сторонние системы обращаются к нему через HTTP.
• Пользователь 1С для агента и права этого пользователя в базе.
• Адрес опубликованной базы, который будет доступен компьютеру с Aizor. Если база стоит у вас в локальной сети или в облаке, это нужно проверить заранее.

Заметка о правах: платформа при чтении и записи выполняет обычные проверки прав, поэтому агент увидит только то, что разрешено его пользователю.

Как получить доступ к базе: по шагам

В 1С нет раздела, где выпускается токен. Вместо него работает опубликованная база и логин с паролем пользователя. Документация 1С говорит, что способы аутентификации OData-клиентов полностью совпадают со способами, используемыми для веб-сервисов.

1. Обратитесь к администратору базы или обслуживающей организации. Публикацию выполняют на веб-сервере, это работа администратора.
2. При публикации базы установите флажок «Публиковать стандартный интерфейс OData».
3. Выберите, какие объекты нужны агенту (например, справочник контрагентов и документы продаж). Точный способ задания состава зависит от версии и режима совместимости, это описано в руководстве разработчика платформы, глава 17, раздел «Публикация стандартного интерфейса OData».
4. Создайте отдельного пользователя для агента и выдайте ему минимально нужные права. Для начала подойдёт роль только на чтение.
5. Запишите адрес опубликованной базы, логин и пароль.
6. Проверьте доступ: запрос к документу метаданных по адресу базы должен вернуть список доступных объектов.

Токена со сроком жизни здесь нет: доступ определяется логином и паролем пользователя. В Aizor установите скилл из каталога и вставьте адрес и данные пользователя в его настройки.

Проверка: первые запросы агенту

• «Покажи, какие справочники и документы доступны в базе.»
• «Выведи первые 20 контрагентов из справочника.»
• «Найди документы реализации за прошлую неделю и перечисли суммы.»
• «Покажи остатки по складу из регистра накопления.»

Платформа поддерживает стандартные условия фильтрации OData, например по цене или по дате. Агент составляет такие условия сам.

Сценарии автоматизации

Ежедневная сводка по остаткам

Агент по расписанию обращается к регистру остатков и присылает в Telegram список позиций, которые закончились. Планировщик задач есть в Aizor. Подробнее в описании тарифов.

Выгрузка данных в таблицу

По запросу агент читает документы за период и складывает их в таблицу. Если вы работаете с Google Таблицами, подойдёт скилл из инструкции Google Sheets в Aizor.

Создание справочных данных

Вы присылаете список новых контрагентов или номенклатуры, агент создаёт элементы справочника. Для таких действий включите ручное подтверждение, чтобы видеть каждую запись до отправки.

Подготовка документов

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

Частые ошибки

Что видите	Причина	Что делать
Ответ со статусом 4XX	Неверные действия клиента: адрес, объект, формат запроса или права. 1С может передать внутренний код и сообщение с причиной	Прочитайте сообщение в ответе и сверьте имя объекта с документом метаданных
Ответ со статусом 5XX	Ошибка на стороне сервера 1С	Обратитесь к администратору базы
Объект не находится	Объект не открыт через стандартный интерфейс или такого типа в OData нет (отчёты, обработки, пользователи недоступны)	Попросите администратора добавить объект в состав интерфейса
Нет данных или отказ при записи	У пользователя недостаточно прав, платформа проверяет права как обычно	Выдайте пользователю нужную роль
Запись не создаётся, хотя запрос прошёл	Сработал обработчик событий в конфигурации: платформа вызывает их при записи	Уточните у специалиста по 1С, что проверяет обработчик

Безопасность

• Заведите в 1С отдельного пользователя только для агента. Не используйте учётную запись директора или главного бухгалтера.
• Дайте минимально нужные права. Для сводок хватит чтения.
• Запись, создание и проведение документов оставьте под ручным подтверждением в Aizor.
• Публикуйте только нужные объекты. Не открывайте весь состав базы без необходимости.
• Если пароль мог стать известен посторонним, смените его или отключите пользователя в базе.
• Сделайте копию базы перед первыми записями через агента.

Инструкция написана по официальной документации 1С:Предприятие 8 (v8.1c.ru, раздел «REST интерфейс»; its.1c.ru, руководство разработчика, глава 17), состояние на октябрь 2026 года. Интерфейс и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.