Menu
Получение данных из 1С:Предприятие через стандартный OData-интерфейс
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
MCP-инструменты агента-аналитика 1С: shared и per-agent серверы, conf-doc, SearXNG web-search и document-reader.
Аналитик метаданных 1С: определяет объекты конфигурации для OData-запросов. Используй MCP conf-doc, profile конфигурации и skills analyst-conf-doc, analyst-domain, analyst-mcp. Standalone: /analyze или [analyze].
Анализ структуры конфигурации 1С:Предприятие — по XML-файлам выгрузки или через OData $metadata. Если Configuration.xml недоступен, автоматически использует OData.
Использование MCP conf-doc агентом-аналитиком: keyword-поиск, приоритет типов, drill-down Report → СКД. Фокус на выборе объектов, не на OData-синтаксисе.
Доменные модели и decision trees для аналитика 1С: чтение profile MD, anti-patterns, типовые связки объектов по темам (ЗУП и др.).
Семантический поиск и drill-down по документации конфигурации 1С через MCP 1c-conf-doc или HTTP API. Используй для метаданных (реквизиты, регистры, связи) и источников данных отчётов (запросы СКД) перед OData-запросами. Короткие keyword-запросы; odata_fields на top-1; финальные имена полей — из OData $metadata.
| name | odata |
| description | Получение данных из 1С:Предприятие через стандартный OData-интерфейс |
Скилл для получения данных из 1С:Предприятие через стандартный REST OData-интерфейс.
1С реализует OData версии 3.0 (протокол odata/standard.odata).
Работает с любой конфигурацией 1С, где опубликована база через веб-сервер.
Если подключён MCP 1c-conf-doc, перед построением OData-запроса уточни структуру метаданных:
conf_doc_search(query="...") — найти объект по смыслу запроса пользователяconf_doc_get_object + conf_doc_get_object_chunk — прочитать реквизиты и типы полейDocument → Document_, Catalog → Catalog_, …)fetch с корректным entity, $filter, $selectПодробнее — skills/conf-doc/SKILL.md.
Пример: вопрос «отпуска сотрудника Иванова за май»:
Document.Отпуск, реквизиты Сотрудник, ДатаНачала, ДатаОкончанияDocument_Отпуск?$filter=...&$select=...Для запросов к 1С OData используется MCP-инструмент fetch (пакет @modelcontextprotocol/server-fetch).
Все запросы выполняются через вызов:
fetch(
url="полный_URL_запроса",
method="GET",
headers={
"Authorization": "Basic <base64>",
"Accept": "application/json"
}
)
Credentials хранятся в файле env.json (вне репозитория, в .gitignore):
{
"default": {
"odata_url": "http://localhost/your_base/odata/standard.odata",
"odata_user": "Администратор",
"odata_password": "пароль"
}
}
Заголовок Authorization формируется один раз — Base64-кодировка строки логин:пароль:
"Authorization": "Basic " + Base64Encode(odata_user + ":" + odata_password)
Важно: Используйте только заголовок
Authorization: Basic. Кодировка кириллических паролей корректно работает через Base64 в UTF-8.
Базовый URL берётся из env.json → odata_url, например:
http://localhost/your_base/odata/standard.odata
Все пути ресурсов добавляются после него через /.
fetch(
url="http://localhost/your_base/odata/standard.odata/",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
Каждый тип объекта 1С имеет свой префикс в URL-имени ресурса:
| Тип 1С | Префикс OData | Пример ресурса |
|---|---|---|
| Справочник | Catalog_ | Catalog_Сотрудники |
| Документ | Document_ | Document_Отпуск |
| Журнал документов | DocumentJournal_ | DocumentJournal_ДокументыОплата |
| План видов характеристик | ChartOfCharacteristicTypes_ | ChartOfCharacteristicTypes_ВидыСубконто |
| План счетов | ChartOfAccounts_ | ChartOfAccounts_Основной |
| План видов расчета | ChartOfCalculationTypes_ | ChartOfCalculationTypes_Начисления |
| План обмена | ExchangePlan_ | ExchangePlan_ОбменСБухгалтерией |
| Константа | Constant_ | Constant_АдресПубликации |
| Регистр сведений | InformationRegister_ | InformationRegister_Цены |
| Регистр накопления | AccumulationRegister_ | AccumulationRegister_Продажи |
| Регистр расчёта | CalculationRegister_ | CalculationRegister_Начисления |
| Регистр бухгалтерии | AccountingRegister_ | AccountingRegister_Хозрасчетный |
| Бизнес-процесс | BusinessProcess_ | BusinessProcess_ЗаявкаНаСогласование |
| Задача | Task_ | Task_ЗадачаИсполнителя |
| Перечисление | Enum_ | Enum_ПолФизическогоЛица |
Регистры имеют несколько вариантов ресурса в зависимости от типа выборки:
| Суффикс | Назначение | Пример |
|---|---|---|
_RecordType | Записи регистра | InformationRegister_Цены_RecordType |
_СрезПоследних | Срез последних (только периодические) | InformationRegister_Цены_СрезПоследних |
| Суффикс | Назначение | Пример |
|---|---|---|
_RecordType | Записи регистра | AccumulationRegister_Продажи_RecordType |
Табличные части объектов доступны как отдельные ресурсы.
Имя ресурса: ИмяРесурсаОбъекта_ИмяТабличнойЧасти.
Например, табличная часть Адреса справочника Сотрудники:
Catalog_Сотрудники_Адреса
Стандартные поля табличной части:
LineNumber — номер строки_Key / _Type суффиксы для ссылочных и составных полей| Поле OData | Описание |
|---|---|
Ref_Key | UUID элемента (ссылка) |
DeletionMark | Пометка удаления |
Predefined | Предопределённый элемент |
IsFolder | Является ли папкой (иерархический справочник) |
Parent_Key | UUID родителя (иерархия) |
Code | Код элемента |
Description | Наименование элемента |
| Поле OData | Описание |
|---|---|
Ref_Key | UUID документа |
DeletionMark | Пометка удаления |
Date | Дата документа |
Number | Номер документа |
Posted | Проведён |
| Поле OData | Описание |
|---|---|
RecordKey | Ключ записи |
Period | Период (если регистр периодический) |
Для регистров сведений (срез последних) доступны: Period, измерения и ресурсы.
| Поле OData | Описание |
|---|---|
LineNumber | Номер строки |
1С добавляет специальные суффиксы к именам реквизитов в OData:
| Суффикс | Когда появляется | Описание | Пример |
|---|---|---|---|
_Key | Реквизит ссылочного типа | UUID связанного объекта | Организация_Key |
_Type | Реквизит составного типа (несколько типов) | Тип значения | Владелец_Type |
Используйте _Key для фильтрации по ссылке, _Type — для определения типа в составных полях.
| Параметр | Описание | Пример |
|---|---|---|
$top | Ограничить кол-во записей | $top=10 |
$skip | Пропустить N записей | $skip=20 |
$filter | Фильтрация | $filter=DeletionMark eq false |
$select | Выбрать конкретные поля | $select=Ref_Key,Description |
$orderby | Сортировка | $orderby=Description asc |
$expand | Раскрыть связанные объекты | $expand=Организация |
$format | Формат ответа | $format=json |
| Оператор | Описание | Пример |
|---|---|---|
eq | Равно | $filter=DeletionMark eq false |
ne | Не равно | $filter=Code ne '000' |
gt | Больше | $filter=Date gt datetime'2024-01-01T00:00:00' |
ge | Больше или равно | $filter=Date ge datetime'2024-01-01T00:00:00' |
lt | Меньше | $filter=Date lt datetime'2024-12-31T23:59:59' |
le | Меньше или равно | $filter=Code le '000100' |
| Функция | Описание | Пример |
|---|---|---|
substringof | Содержит подстроку | $filter=substringof('Иванов', Description) eq true |
startswith | Начинается с | $filter=startswith(Code, '000') |
endswith | Заканчивается на | $filter=endswith(Description, 'ов') |
Важно: 1С использует OData v3. Синтаксис
substringofотличается от OData v4:
- v3:
substringof('значение', Поле) eq true- v4:
contains(Поле, 'значение')— не работает в 1С!
| Оператор | Описание | Пример |
|---|---|---|
and | Логическое И | $filter=DeletionMark eq false and Date gt datetime'2024-01-01T00:00:00' |
or | Логическое ИЛИ | $filter=Code eq '001' or Code eq '002' |
not | Отрицание | $filter=not(DeletionMark eq true) |
| Тип значения | Синтаксис | Пример |
|---|---|---|
| Строка | Одинарные кавычки | 'Иванов' |
| Число | Без кавычек | 100 |
| Булево | true / false | eq true |
| Дата | datetime'YYYY-MM-DDTHH:MM:SS' | datetime'2024-01-01T00:00:00' |
| UUID (Ref_Key) | guid'uuid' | guid'aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee' |
Имена объектов 1С (на русском) нужно URL-кодировать перед подстановкой в URL.
Используйте функцию encodeURIComponent() — это стандарт URL-кодировки UTF-8.
Примеры закодированных имён:
| Имя 1С | URL-encoded |
|---|---|
Сотрудники | %D0%A1%D0%BE%D1%82%D1%80%D1%83%D0%B4%D0%BD%D0%B8%D0%BA%D0%B8 |
ФизическиеЛица | %D0%A4%D0%B8%D0%B7%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5%D0%9B%D0%B8%D1%86%D0%B0 |
Организации | %D0%9E%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8 |
fetch(
url="http://localhost/your_base/odata/standard.odata/Catalog_%D0%A1%D0%BE%D1%82%D1%80%D1%83%D0%B4%D0%BD%D0%B8%D0%BA%D0%B8?$top=10&$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
fetch(
url="http://localhost/your_base/odata/standard.odata/Document_%D0%9E%D1%82%D0%BF%D1%83%D1%81%D0%BA?$top=5&$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
fetch(
url="http://localhost/your_base/odata/standard.odata/Catalog_%D0%A1%D0%BE%D1%82%D1%80%D1%83%D0%B4%D0%BD%D0%B8%D0%BA%D0%B8(guid'aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee')?$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
$count)fetch(
url="http://localhost/your_base/odata/standard.odata/Catalog_%D0%A1%D0%BE%D1%82%D1%80%D1%83%D0%B4%D0%BD%D0%B8%D0%BA%D0%B8/$count",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
$select)fetch(
url="http://localhost/your_base/odata/standard.odata/Catalog_%D0%A1%D0%BE%D1%82%D1%80%D1%83%D0%B4%D0%BD%D0%B8%D0%BA%D0%B8?$select=Ref_Key,Description,Code&$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
$expand)fetch(
url="http://localhost/your_base/odata/standard.odata/Document_%D0%9E%D1%82%D0%BF%D1%83%D1%81%D0%BA?$expand=Организация&$top=5&$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
fetch(
url="http://localhost/your_base/odata/standard.odata/Document_%D0%9E%D1%82%D0%BF%D1%83%D1%81%D0%BA?$filter=Date ge datetime'2024-01-01T00:00:00' and Date le datetime'2024-12-31T23:59:59'&$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
fetch(
url="http://localhost/your_base/odata/standard.odata/Catalog_%D0%A1%D0%BE%D1%82%D1%80%D1%83%D0%B4%D0%BD%D0%B8%D0%BA%D0%B8?$filter=substringof('Иванов', Description) eq true&$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
fetch(
url="http://localhost/your_base/odata/standard.odata/InformationRegister_%D0%A6%D0%B5%D0%BD%D1%8B_RecordType?$top=10&$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
fetch(
url="http://localhost/your_base/odata/standard.odata/InformationRegister_%D0%A6%D0%B5%D0%BD%D1%8B_%D0%A1%D1%80%D0%B5%D0%B7%D0%9F%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BD%D0%B8%D1%85?$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
fetch(
url="http://localhost/your_base/odata/standard.odata/Constant_%D0%90%D0%B4%D1%80%D0%B5%D1%81%D0%9F%D1%83%D0%B1%D0%BB%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D0%B8/$value",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
fetch(
url="http://localhost/your_base/odata/standard.odata/Enum_%D0%9F%D0%BE%D0%BB%D0%A4%D0%B8%D0%B7%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%BE%D0%B3%D0%BE%D0%9B%D0%B8%D1%86%D0%B0?$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
fetch(
url="http://localhost/your_base/odata/standard.odata/Catalog_%D0%A1%D0%BE%D1%82%D1%80%D1%83%D0%B4%D0%BD%D0%B8%D0%BA%D0%B8_%D0%90%D0%B4%D1%80%D0%B5%D1%81%D0%B0?$format=json",
method="GET",
headers={"Authorization": "Basic <base64>", "Accept": "application/json"}
)
{
"odata.metadata": "...",
"value": [
{
"Ref_Key": "uuid",
"DataVersion": "...",
"DeletionMark": false,
"Code": "000000001",
"Description": "Название элемента",
"Предопределенный": false
}
]
}
Если объект не появляется в списке сущностей, он не опубликован. Выполните в 1С (режим Сервер / Внешнее соединение / Интеграция):
МассивОбъектов = Новый Массив();
МассивОбъектов.Добавить(Метаданные.Справочники.ИмяСправочника);
УстановитьСоставСтандартногоИнтерфейсаOData(МассивОбъектов);
Неверная кодировка credentials. Убедитесь, что используете заголовок Authorization: Basic
с корректной Base64-кодировкой строки логин:пароль в UTF-8.
Объект не опубликован через OData. Выполните enable-odata.bsl или используйте обработку EnableODataInterface.epf.
contains не работает1С использует OData v3, где вместо contains(Поле, 'значение') нужно использовать
substringof('значение', Поле) eq true.
Помимо fetch, сервер mcp_servers/odata_server.py предоставляет:
Загрузить таблицу из одной сущности в CSV или JSON:
fetch_table(
entity="Catalog_Контрагенты",
filter="DeletionMark eq false",
select="Description,Code,ИНН",
top=200,
format="csv"
)
Multi-query analytics с join в pandas и опциональным графиком:
analyze_data(
queries=[
{"alias": "sales", "entity": "Document_Реализация", "filter": "...", "select": "...", "top": 200}
],
aggregate={"group_by": ["Контрагент"], "agg": {"СуммаДокумента": "sum"}},
chart={"type": "bar", "x": "Контрагент", "y": "СуммаДокумента", "title": "Продажи"},
explanation="..."
)
Ответ JSON: rows, columns, csv_preview, chart_png_base64, chart_html.