1С через OData: как достать данные учётной базы без единой строки кода на встроенном языке

Обзор

У большинства сервисов в этом блоге есть API одного поставщика: набор методов, документация, ключи из личного кабинета. У 1С:Предприятие всё устроено иначе — есть протокол, стандартный интерфейс OData, а набор данных, который через него доступен, у каждой базы свой. Одна база — это склад и продажи, другая — зарплата и кадры, третья — управленческий учёт с десятками собственных документов и регистров, придуманных конкретной компанией. Заранее список сущностей не знает никто, включая нас: его показывает сама база при обращении.

Это и делает 1С особым коннектором. Вместо таблицы фиксированных методов Mira работает с базой в два шага: сначала спрашивает, что вообще опубликовано, — а дальше читает и меняет ровно то, что нашла.

Как устроен протокол

Публикация 1С через веб-сервер отдаёт адрес вида https://host/base/odata/standard.odata/. За этим адресом стоит стандартный OData v3: справочники как Catalog_Номенклатура, документы как Document_РасходТоваров, регистры накопления и сведений — AccumulationRegister_*, InformationRegister_*. Имя каждой сущности — то, как объект называется в конфигурации конкретной базы, и совпадений между разными компаниями почти нет.

Протокол даёт на этом наборе стандартный набор действий:

Ловушка, которую легко не заметить: запись документа — это не проведение

В большинстве систем сохранить объект значит применить его последствия. В 1С это не так. Документ, созданный через OData, появляется в базе, но остаётся непроведённым: движений по регистрам — то есть реальных изменений остатков, взаиморасчётов, себестоимости — не будет, пока документ не проведён отдельно.

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

Виртуальные таблицы — не то же самое, что выборка записей

Регистр накопления в 1С хранит не остаток, а поток движений: пришло, ушло. Спросить «сколько на складе сейчас» напрямую нельзя — это агрегат, а не запись. Для этого у регистров есть виртуальные таблицы: Balance считает остаток на момент времени, Turnovers — обороты за период, SliceLast (у регистров сведений) — последнее актуальное значение. Обращение к ним — не обычный $filter по коллекции, а вызов с параметрами периода и условия внутри самого адреса.

Отказ поставщика — один формат на весь протокол

В отличие от большинства сервисов в этом блоге, где форма отказа у каждого раздела API своя, у OData она задана самим стандартом: {"odata.error": {"code", "message": {"value"}}}. Ошибка платформы 1С — недостаточно прав, нарушение уникальности, попытка провести документ с ошибкой контроля — приходит в этом же конверте с человекочитаемым текстом, который 1С формирует сама, на языке информационной базы.

Что защищено от случайного действия

Создание, изменение, удаление записи, проведение и отмена проведения документа — под барьером записи: источник, подключённый на чтение, не может изменить ни одной записи в базе, запрос физически не уходит. Признак «меняет данные» хранится рядом с описанием самого действия, а не отдельным списком, — расходиться им негде.

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

Как это выглядит через MCP

MCP — открытый протокол, по которому Claude подключается к внешним данным и действиям. Вместо разбора конфигурации 1С и написания клиента вы подключаете базу в кабинете Mira тремя полями и спрашиваете обычными словами.

Что вообще опубликовано в этой базе 1С?

Claude получает список коллекций и группирует их по виду — справочники, документы, регистры, — прежде чем идти дальше.

Какие остатки товаров на складе сейчас?

Это обращение к виртуальной таблице остатков регистра накопления, а не к самим движениям, — Claude сам выбирает нужное действие вместо построчного суммирования истории.

Проведи документ реализации номер такой-то.

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

Как подключить

1. В конфигураторе 1С включите публикацию OData: Администрирование → Публикация на веб-сервере, отметьте нужную базу и стандартный интерфейс OData.
2. Скопируйте адрес публикации — обычно он заканчивается на /odata/standard.odata.
3. В Mira: проект → источники → 1С (OData) → адрес, логин и пароль пользователя с правом на веб-сервисы (обычно роль «Полные права»).

Дальше 1С доступна и в чате Mira, и через MCP-сервер в Claude, Cursor или другом клиенте с поддержкой протокола — без единой строки кода на встроенном языке.