1С
Об инструменте
Инструмент «1С» позволяет агенту читать данные из 1С:Предприятие: справочники, документы, регистры — через штатный OData-интерфейс 1С. Поддерживается поиск нужных данных по фильтру, сортировке и выбору полей.
Версия инструмента — только чтение: агент может получать данные, но не может создавать или изменять записи в 1С.
Настройка
1. Авторизация в Evo
На платформе откройте: Инструменты > 1С > Конфигурация авторизации ключа API и заполните поля.
Пример заполнения формы
Поле в Evo | Что вписать | Откуда брать |
Имя авторизации | Произвольный текст, например «1С Фреш» | — |
URL интерфейса OData | Адрес вашей базы в браузере (без языкового кода) + /odata/standard.odata Пример: https://1cfresh.com/a/sbm/12345/odata/standard.odata | Возьмите URL, по которому вы обычно заходите в свою базу 1С:Фреш в браузере, и добавьте в конец /odata/standard.odata. Пример: если адрес базы https://1cfresh.com/a/sbm/12345, то итоговый URL для Evo — https://1cfresh.com/a/sbm/12345/odata/standard.odata. Подробнее: инструкция от 1С:Фреш. |
Логин | Отдельный пользователь для OData | Создаётся в 1С:Фреш на той же странице настройки (см. ниже). Использовать личный логин сотрудника не рекомендуется. |
Пароль | Пароль этого пользователя | Задаётся автоматически при создании пользователя для OData. |
Как включить OData и создать пользователя (1С:Фреш):
В 1С перейдите в Администрирование → Синхронизация данных → Настройки стандартного интерфейса OData → вкладка «Авторизация» (логин/пароль) и вкладка «Состав» (какие справочники и документы будут доступны через OData).
Эта настройка доступна только пользователю с ролью «Полные права» — в сервисе 1С:Фреш такие права по умолчанию есть у владельца. Если у вас нет доступа к этому разделу, попросите включить OData и создать пользователя владельца аккаунта 1С или вашего администратора 1С.
Рекомендация по безопасности: заводить отдельного пользователя с минимально необходимыми правами и публиковать только те справочники/документы, которые нужны агенту.
Агент увидит только те справочники и документы, которые администратор 1С явно выбрал на вкладке «Состав» при настройке OData. Если нужный справочник там не отмечен, агент не получит к нему доступ, даже если он есть в базе. Подробнее: инструкция от 1С:Фреш.
2. Использование инструмента
Добавьте инструмент 1С агенту. Агент сам решает, когда обратиться к 1С: сначала уточняет доступные названия данных (например, «покажи справочники про контрагентов»), затем читает нужные записи с фильтром.
Пример задачи агенту: «Найди счета за март».