Как включить OData в 1С: публикация, состав объектов, проверка
HomeIO 1С + ИИ

Как включить 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 или новее и компонента «Модули расширения веб-сервера» из дистрибутива платформы.

  1. Опубликуйте базу на веб-сервере. Откройте базу в Конфигураторе, выберите «Администрирование», «Публикация на веб-сервере». Задайте имя публикации латиницей (например, buh), выберите Apache или IIS и каталог, нажмите «Опубликовать». Конфигуратор сам создаст файл default.vrd и настройки веб-сервера. Без Конфигуратора (например, на Linux) публикацию делают утилитой webinst или правкой настроек Apache, принцип тот же.
  2. Включите OData в публикации. В том же диалоге поставьте галочку «Публиковать стандартный интерфейс OData» (название может немного отличаться в разных версиях платформы) и опубликуйте базу заново.
  3. Настройте состав объектов. Подробности в следующем разделе.

Состав объектов

По умолчанию через 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. Вы звоните или пишете. Достаточно сказать, какая у вас 1С, где она размещена и какие вопросы хочется ей задавать.
  2. Мы разбираем задачу. Предлагаем, что нужно сделать, за какое время и сколько это будет стоить.
  3. Если вариант подходит, начинаем. Пробы на рабочей базе мы советуем начинать с её копии.

HomeIO, Рыбинск. Работаем удалённо по всей России. Код коннектора открыт: GitHub.