Как включить OData в 1С
Обновлено 20 ноября 2026
OData это стандартный интерфейс 1С для интеграций: через него читают данные в отчёты, боты и ИИ-ассистенты. Ниже вся настройка для облачной, серверной и файловой базы.
Найдите свой вариант
Тип хранилища (файловая база или SQL) почти не влияет на настройку: публикация делается одинаково. Важнее, есть ли у вас веб-сервер и доступ к конфигуратору.
| Как у вас работает 1С | Что делать | Сложность |
|---|---|---|
| Облако (Scloud, 1cFresh, «1С:Готовое рабочее место», аренда 1С) | OData включает провайдер: часто галочкой в личном кабинете или заявкой в поддержку. Дальше нужно только настроить состав. | Низкая |
| Сервер с SQL (PostgreSQL, MS SQL) | Опубликовать базу на Apache или IIS, включить OData, настроить состав. | Средняя |
| Локальная файловая база (.1CD) | То же и выдать веб-серверу права на папку базы. | Средняя |
| Закрытая среда без веб-сервера и конфигуратора | OData недоступен. Понадобится другой способ связи. | Высокая |
Облако и хостинг
Если вы заходите в 1С через браузер по адресу провайдера, веб-публикация, скорее всего, уже есть, и OData
нужно только включить. В Scloud он доступен, а адрес выглядит как https://<сервер>.scloud.ru/<код>/<база>/odata/standard.odata/, авторизация идёт
облачной учётной записью. В 1cFresh OData может быть выключен политикой провайдера, тогда запросите
включение в поддержке. При аренде 1С или RDP-хостинге попросите администратора опубликовать базу на
веб-сервере с включённым OData.
Сервер с SQL
Это обычный рабочий сценарий, и он проще файлового: не нужно возиться с правами на файл. Установите или включите веб-сервер (Apache или IIS), отметьте при установке платформы компоненту «Модули расширения веб-сервера» и опубликуйте базу по шагам ниже.
Файловая база
OData работает и с файловой базой: на этом же компьютере поднимается веб-сервер, который её
публикует. Главный подводный камень в правах. Пользователь, под которым работает веб-сервер
(у Apache это часто служебный аккаунт, у IIS пользователь пула приложений), должен иметь полный доступ к
папке с файлом .1CD. Иначе будут ошибки 500 и «нет доступа», особенно при записи.
Публикация по шагам
Нужна платформа 1С:Предприятие 8.3.5 или новее и компонента «Модули расширения веб-сервера» из дистрибутива платформы.
- Опубликуйте базу на веб-сервере. Откройте базу в Конфигураторе, выберите
«Администрирование», «Публикация на веб-сервере». Задайте имя публикации латиницей (например,
buh), выберите Apache или IIS и каталог, нажмите «Опубликовать». Конфигуратор сам создаст файлdefault.vrdи настройки веб-сервера. Без Конфигуратора (например, на Linux) публикацию делают утилитойwebinstили правкой настроек Apache, принцип тот же. - Включите OData в публикации. В том же диалоге поставьте галочку «Публиковать стандартный интерфейс OData» (название может немного отличаться в разных версиях платформы) и опубликуйте базу заново.
- Настройте состав объектов. Подробности в следующем разделе.
Состав объектов
По умолчанию через OData не виден ни один объект: состав задаётся вручную. Запустите базу в режиме «Предприятие», откройте «Все функции», затем обработку «Настройка стандартного интерфейса OData», добавьте нужные объекты и сохраните. Не нашли пункт «Все функции»? Включите его в «Сервис», «Параметры», галочка «Отображать команду Все функции».
Добавляйте только то, что нужно для ваших задач: это ещё и защита, потому что внешняя программа не увидит объект, которого нет в составе. Для Бухгалтерии 3.0 обязательны план счетов и регистр бухгалтерии «Хозрасчётный», из них считаются долги и остатки. Для Управления торговлей нужны регистры накопления остатков и продаж и справочники ключей аналитики. Полные списки есть в документе «Подключение и настройка».
Как проверить, что OData работает
Откройте в браузере адрес публикации и добавьте в конец ?$format=json:
http://localhost/buh/odata/standard.odata/?$format=json Браузер спросит логин и пароль. Введите данные пользователя 1С, у которого есть право на OData. Что вы увидите:
- JSON со списком объектов: OData работает.
- Пустой список
value: []: публикация есть, но состав не настроен.
Если не получилось
| Что видите | Что это значит |
|---|---|
| 404 | Неверный адрес или имя публикации, либо OData не включён в публикации (шаг 2). |
| 401 | Неверный логин или пароль, либо у пользователя нет права на OData. На некоторых облачных площадках нужна учётная запись облачного аккаунта, а не пользователь внутри базы. |
| 500 или «нет доступа» | Чаще всего у файловой базы: веб-серверу не хватает прав на папку базы. |
| Пустой список | Не настроен состав объектов. |
А если веб-сервер поднять нельзя?
Тогда понадобится другой способ связи: COM-соединение (только Windows, локально) или собственные HTTP-сервисы в расширении конфигурации, которые требуют кода. Прямой SQL к базе 1С и чтение файла базы напрямую не рекомендуются: схема там запутанная, а после обновления всё ломается. В большинстве случаев проще поднять публикацию OData. Наш коннектор работает только через OData.
Что дальше
Когда OData отвечает, подключите к нему ИИ-ассистента: инструкция в статье «Как подключить ИИ к 1С». Коннектор по умолчанию только читает данные и защищён от лишних действий, подробности на странице «Безопасность».
Вопросы об OData в 1С
Что такое OData в 1С?
Это стандартный интерфейс, через который внешние программы читают и записывают данные 1С по HTTP: справочники, документы, регистры. Он нужен для интеграций, отчётов, ботов и подключения ИИ-ассистентов.
Какая версия платформы нужна?
1С:Предприятие 8.3.5 и новее. На актуальных платформах OData поддерживает и чтение, и запись. Ещё нужна компонента «Модули расширения веб-сервера», она ставится из дистрибутива платформы.
Работает ли OData с файловой базой?
Да. На том же компьютере поднимается веб-сервер, который публикует базу. Главное условие: у пользователя, под которым работает веб-сервер, должны быть права на папку с файлом базы.
Можно ли обойтись без OData?
Можно, но это другие способы: COM-соединение, собственные HTTP-сервисы в расширении конфигурации или прямой SQL. Первые два требуют отдельной разработки, а прямой SQL и чтение файла базы не рекомендуются: они хрупкие и ломаются при обновлении. Коннектор 1c-odata-mcp работает только через OData.
Сколько времени занимает публикация?
Обычно 30–45 минут, если веб-сервер уже есть. В облаке чаще всего достаточно включить OData у провайдера.
Нужна помощь с публикацией OData? Настроим
Расскажите, что вы хотите получать от своей 1С. Мы предложим вариант и назовём стоимость: она всегда считается под вашу задачу.
- Вы звоните или пишете. Достаточно сказать, какая у вас 1С, где она размещена и какие вопросы хочется ей задавать.
- Мы разбираем задачу. Предлагаем, что нужно сделать, за какое время и сколько это будет стоить.
- Если вариант подходит, начинаем. Пробы на рабочей базе мы советуем начинать с её копии.
HomeIO, Рыбинск. Работаем удалённо по всей России. Код коннектора открыт: GitHub.