1С
Коннектор 1С
Подключение: https://mcp.legalstack.ru/mcp/onec или в составе агрегированного сервера https://mcp.legalstack.ru/mcp.
Имя сервера: legalstack-onec. Инструментов: 14.
onec_create_kontragent
⚠ Outward-facing: создаёт контрагента в справочнике Catalog_Контрагенты внешней базы 1С. Перед созданием проверь дубль через onec_find_kontragent. Возвращает: объект { refKey, code, description, inn }.
{
"type": "object",
"properties": {
"description": {
"type": "string",
"description": "Наименование (например: ЛЕГАЛСТЕК ООО)"
},
"inn": {
"description": "ИНН",
"type": "string"
},
"kpp": {
"description": "КПП",
"type": "string"
},
"fullName": {
"description": "Полное наименование",
"type": "string"
},
"parentKey": {
"description": "Ref_Key родительской группы (по умолчанию: Покупатели и заказчики)",
"type": "string"
},
"isLegal": {
"description": "Юридическое лицо (true) или физическое (false). По умолчанию true",
"type": "boolean"
}
},
"required": [
"description"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_create_realizaciya
⚠ Outward-facing: создаёт документ «Реализация товаров и услуг» во внешней базе 1С (шапка + табличная часть Услуги). Документ создаётся непроведённым. Ключи берутся из onec_find_organization/kontragent/nomenklatura. Возвращает: объект { refKey, number, date, sum, servicesCount, status }.
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Дата документа (ISO 8601, например 2026-03-11T12:00:00)"
},
"organization_Key": {
"type": "string",
"description": "Ref_Key организации из Catalog_Организации"
},
"kontragent_Key": {
"type": "string",
"description": "Ref_Key контрагента из Catalog_Контрагенты"
},
"currency_Key": {
"description": "Ref_Key валюты (по умолчанию рубли: 42a77a6c-ba37-11e3-967d-6cf049df7344)",
"type": "string"
},
"bankAccount_Key": {
"description": "Ref_Key банковского счёта организации",
"type": "string"
},
"sumIncludesVat": {
"description": "Сумма включает НДС (по умолчанию true)",
"type": "boolean"
},
"documentBezNds": {
"description": "Документ без НДС (по умолчанию false)",
"type": "boolean"
},
"comment": {
"description": "Комментарий к документу",
"type": "string"
},
"services": {
"description": "Строки табличной части Услуги",
"type": "array",
"items": {
"type": "object",
"properties": {
"lineNumber": {
"type": "string",
"description": "Номер строки (1, 2, 3...)"
},
"nomenklatura_Key": {
"type": "string",
"description": "Ref_Key номенклатуры"
},
"content": {
"type": "string",
"description": "Описание услуги"
},
"quantity": {
"type": "number",
"description": "Количество"
},
"price": {
"type": "number",
"description": "Цена"
},
"sum": {
"type": "number",
"description": "Сумма"
},
"vatRate": {
"type": "string",
"enum": [
"НДС20",
"НДС10",
"НДС0",
"БезНДС"
],
"description": "Ставка НДС"
},
"vatSum": {
"type": "number",
"description": "Сумма НДС"
},
"incomeAccount_Key": {
"description": "Ref_Key счёта доходов",
"type": "string"
},
"vatAccount_Key": {
"description": "Ref_Key счёта учёта НДС по реализации",
"type": "string"
}
},
"required": [
"lineNumber",
"nomenklatura_Key",
"content",
"quantity",
"price",
"sum",
"vatRate",
"vatSum"
]
}
},
"operationType": {
"description": "Вид операции (по умолчанию Услуги)",
"type": "string",
"enum": [
"Услуги",
"Товары",
"ТоварыУслуги",
"Комиссия"
]
}
},
"required": [
"date",
"organization_Key",
"kontragent_Key"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_delete
⚠ Outward-facing: удаляет запись во внешней базе 1С. Возвращает: текст «Запись удалена».
{
"type": "object",
"properties": {
"resource": {
"type": "string",
"description": "Имя ресурса 1С"
},
"refKey": {
"type": "string",
"description": "Ref_Key (GUID) записи"
}
},
"required": [
"resource",
"refKey"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_find_dogovor
Поиск договора контрагента в Catalog_ДоговорыКонтрагентов. Только чтение. Можно фильтровать по kontragent_Key. Возвращает: массив договоров или текст «Договоры не найдены».
{
"type": "object",
"properties": {
"kontragent_Key": {
"description": "Ref_Key контрагента для фильтрации",
"type": "string"
},
"search": {
"description": "Строка поиска по наименованию",
"type": "string"
},
"top": {
"description": "Количество результатов (по умолчанию 20)",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_find_kontragent
Поиск контрагента в 1С по наименованию или ИНН. Только чтение. Возвращает: массив контрагентов или текст «Контрагент не найден».
{
"type": "object",
"properties": {
"search": {
"type": "string",
"description": "Строка поиска (наименование или ИНН)"
},
"byInn": {
"description": "Искать по ИНН (true) или по наименованию (false, по умолчанию)",
"type": "boolean"
},
"top": {
"description": "Количество результатов (по умолчанию 20)",
"type": "number"
}
},
"required": [
"search"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_find_nomenklatura
Поиск номенклатуры (товары/услуги) в Catalog_Номенклатура. Только чтение. Возвращает: массив позиций или текст «Номенклатура не найдена».
{
"type": "object",
"properties": {
"search": {
"description": "Строка поиска по наименованию",
"type": "string"
},
"top": {
"description": "Количество результатов (по умолчанию 20)",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_find_organization
Поиск собственной организации (владельца базы 1С) в Catalog_Организации. Только чтение. Без search возвращает все организации. Возвращает: массив организаций или текст «Организации не найдены».
{
"type": "object",
"properties": {
"search": {
"description": "Строка поиска по наименованию. Если не указана — вернёт все организации",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_get
Одна запись 1С по Ref_Key. Только чтение. Возвращает: объект записи.
{
"type": "object",
"properties": {
"resource": {
"type": "string",
"description": "Имя ресурса"
},
"refKey": {
"type": "string",
"description": "Ref_Key (GUID)"
}
},
"required": [
"resource",
"refKey"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_get_resource_schema
Метаданные 1С ($metadata, XML) — структура полей всех ресурсов. Только чтение. Вызывай перед первой записью в незнакомый ресурс (onec_write/onec_update). Возвращает: текст XML-метаданных.
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_list_resources
Список доступных ресурсов 1С (справочники, документы, регистры). Только чтение. Стартовая точка для обнаружения сущностей; структуру полей — onec_get_resource_schema. Возвращает: массив ресурсов или текст «Ресурсы не найдены».
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_read
Универсальное чтение записей любого ресурса 1С с OData-фильтрами. Только чтение. Одна запись по Ref_Key — onec_get; для частых сущностей есть onec_find_*. Возвращает: объект { items, count } или текст «Записи не найдены».
{
"type": "object",
"properties": {
"resource": {
"type": "string",
"description": "Имя ресурса (Catalog_Контрагенты, Document_РеализацияТоваровУслуг и т.д.)"
},
"top": {
"description": "Количество записей",
"type": "number"
},
"skip": {
"description": "Пропустить N записей",
"type": "number"
},
"filter": {
"description": "OData $filter (например: Description eq 'ООО Рога')",
"type": "string"
},
"select": {
"description": "Поля через запятую",
"type": "string"
},
"orderby": {
"description": "Сортировка (например: Date desc)",
"type": "string"
}
},
"required": [
"resource"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_status
Статус подключения интеграции 1С. Только чтение. Возвращает: текст «подключена» / «не подключена».
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_update
⚠ Outward-facing: обновляет поля или табличные части записи во внешней базе 1С. Возвращает: текст «Запись обновлена».
{
"type": "object",
"properties": {
"resource": {
"type": "string",
"description": "Имя ресурса 1С"
},
"refKey": {
"type": "string",
"description": "Ref_Key (GUID) записи"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Обновляемые поля"
}
},
"required": [
"resource",
"refKey",
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}onec_write
⚠ Outward-facing: создаёт произвольную запись в любом ресурсе внешней базы 1С. Для частых сущностей есть специализированные onec_create_*; формат полей — onec_get_resource_schema. Возвращает: объект созданной записи.
{
"type": "object",
"properties": {
"resource": {
"type": "string",
"description": "Имя ресурса 1С"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Данные записи в формате OData"
}
},
"required": [
"resource",
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}