Настройка OData в 1С
Для работы бота требуется доступ к данным базы 1С через интерфейс OData (Open Data Protocol). Это специальный интерфейс, который делает доступным получение данных через интернет.
Для работы бота не требуется устанавливать дополнительные расширения в 1С и следить за их обновлениями.
Как проверить, работает ли у вас OData
Если вы можете заходить в вашу 1С через браузер, то очень вероятно, что OData уже включена или её можно несложно включить.
Пример проверки
Допустим, адрес вашей базы:
https://msk1.1cfresh.com/a/sbm/3540752
Попробуйте открыть в браузере:
https://msk1.1cfresh.com/a/sbm/3540752/odata/standard.odata
Браузер попросит ввести логин и пароль — введите свои учетные данные 1С (нужны права администратора).
Если увидите XML с перечнем объектов — OData работает!
Включение OData
Для пользователей 1С:ФРЕШ
В сервисе 1С:ФРЕШ интерфейс OData автоматически опубликован для всех баз.
Нужно только:
- Зайти в настройки
- Загрузить метаданные
- Включить доступ к нужным объектам
После этого связь будет работать.
Для локальных баз 1С (файловых и серверных)
Для локальных баз требуется публикация на веб-сервере с доступом по OData.
Данные настройки лучше поручить администратору или специалисту 1С.
Полезные ссылки для администраторов:
Если у вас настроен сервис 1С-Линк — такой вариант тоже подойдет.
Настройка доступа к данным
После включения OData необходимо разрешить доступ к нужным объектам.
Как открыть настройки
Способ 1: Введите в командной строке 1С:
e1cib/command/Обработка.НастройкаСтандартногоИнтерфейсаOData.Команда.НастройкиСтандартногоИнтерфейсаOData
Способ 2: Через интерфейс:
Настройки → Синхронизация данных → Настройки стандартного интерфейса OData
Объекты для включения
Для 1С:УНФ (Управление нашей фирмой)
Включите доступ к следующим объектам:
| Тип объекта | Название |
|---|---|
| Константа | Компания |
| Константа | Учет по компании |
| Справочник | Контрагенты |
| Справочник | Контакты |
| Справочник | Валюты |
| Справочник | Номенклатура |
| Справочник | Организации |
| Документ | ЗаказПокупателя |
| Документ | РеализацияТоваровУслуг |
| Регистр сведений | Связи контрагент контакт |
| Регистр сведений | Остатки товаров |
| Регистр сведений | Цены номенклатуры |
| Регистр накопления | Денежные средства |
| Регистр накопления | Продажи |
| Регистр накопления | ЗаказыПоставщикам |
| Регистр накопления | РазмещениеЗаказов |
| Регистр сведений | ГрафикДвиженияЗапасов |
При включении объектов включайте связанные данные — система предложит это автоматически.
Для 1С:УТ11 (Управление торговлей 11)
Включите доступ к следующим объектам:
| Тип объекта | Название |
|---|---|
| Справочник | Организации |
| Справочник | Контрагенты |
| Справочник | Номенклатура |
| Регистр сведений | РаспределениеЗапасов |
| Регистр накопления | Продажи |
| Регистр накопления | Денежные средства |
Формат URL для подключения
После настройки OData, URL для подключения к боту имеет формат:
https://ваш-сервер/имя-базы/odata/standard.odata/
Примеры:
| Тип размещения | Пример URL |
|---|---|
| 1С:ФРЕШ | https://msk1.1cfresh.com/a/company/database/odata/standard.odata/ |
| Локальный сервер | http://192.168.1.100/unf/odata/standard.odata/ |
| Облачный сервер | https://1c.yourcompany.ru/unf/odata/standard.odata/ |
| 1С-Линк | https://link.1c.ru/ваша-база/odata/standard.odata/ |
Безопасность
Рекомендации по безопасности:
- Создайте отдельного пользователя для бота
- Выдайте только права на чтение (не на запись)
- Не используйте учетную запись администратора
- Регулярно меняйте пароль
Все пароли в боте хранятся в зашифрованном виде с использованием алгоритма Fernet.
Частые ошибки
Ошибка: “Не удалось подключиться”
Возможные причины:
- Неверный URL (проверьте, что заканчивается на
/odata/standard.odata/) - Сервер недоступен из интернета
- Брандмауэр блокирует подключение
Ошибка: “Доступ запрещен (401)”
Возможные причины:
- Неверный логин или пароль
- Пользователь заблокирован в 1С
- Истек срок действия пароля
Ошибка: “Не найдено (404)”
Возможные причины:
- Неверный URL базы
- OData не включен в настройках 1С
- База не опубликована на веб-сервере
Ошибка: “Метаданные не найдены”
Возможные причины:
- Не включен доступ к нужным объектам в настройках OData
- Недостаточно прав у пользователя
Нужна помощь?
Если у вас свой сервер и требуется помощь с настройкой — напишите нам:
- Email: mors@1eska.ru
- Telegram: @unf_tg_1eska_bot (команда
/help)