# Возможности подключённой базы
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Get Capabilities** · Resource: `operation` · Operation: `capabilities`
Получить разрешённые типы объектов, поля чтения и записи, формы и профили процессов.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Включённый профиль доступа.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- object_types
- process_profiles
- Другие опубликованные расширением признаки возможностей.
## Пример workflow
Manual Trigger → Get Capabilities → выбор типов и полей в настройках следующих нод.
## Ограничения
- В своей очереди возвращается снимок, переданный при сопряжении или синхронизации; это не проверка исполнения команды в 1С.
- В прямом HTTP читается текущий каталог; в MSRV выполняется команда через Relay.
- Каталог не содержит список всех экземпляров документов.
## Ошибки и отказы
- Профиль отключён, операция или объект не разрешены локальной политикой; недостаточно штатных прав 1С.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.capabilities.get`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Чтение документа
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Get Document Fields** · Resource: `operation` · Operation: `documentGet`
Прочитать выбранные разрешённые поля существующего документа.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Тип документа и поля чтения включены в профиле; штатное Чтение и RLS.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| Document Type Name or ID / `documentType` | options · нет | `""` | Динамический список из подключённой базы: getDocumentTypes; Своя очередь, Прямой HTTP, MSRV |
| Document ID / `documentId` | string · да | `""` | Своя очередь, Прямой HTTP, MSRV |
| Field Names or IDs / `fields` | multiOptions · да | `[]` | Динамический список из подключённой базы: getDocumentFields; Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- object: type, id
- revision: строковая версия объекта
- approval_state; approval_cycle при наличии доверенного снимка
- values: выбранные поля
- _ldo: command_id, operation
## Пример workflow
Событие 1С → Document ID из payload → Get Document Fields. В ноде 0.4.0 и ядре 6.8 также Search Documents → object.id → Get Document Fields.
## Ограничения
- В текущем контракте чтения документа предусмотрены number и date.
- Нужен Document ID. Ручной UUID в демонстрации не является способом поиска документа для пользователей.
## Ошибки и отказы
- access_denied / field_not_allowed: объект или поле не разрешены.
- object_not_found: объект отсутствует либо недоступен текущему пользователю.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.document.get`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Изменение полей документа
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Update Document Fields** · Resource: `operation` · Operation: `documentFieldsUpdate`
Изменить разрешённые поля существующего непроведённого документа с контролем версии.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Поля записи опубликованы в профиле; штатные права записи и RLS.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| Document Type Name or ID / `writeDocumentType` | options · да | `""` | Динамический список из подключённой базы: getWritableDocumentTypes; Своя очередь, Прямой HTTP, MSRV |
| Document ID / `writeDocumentId` | string · да | `""` | Своя очередь, Прямой HTTP, MSRV |
| Expected Document Revision / `expectedDocumentRevision` | string · да | `"={{$json.revision}}"` | Своя очередь, Прямой HTTP, MSRV |
| Changes (JSON) / `documentChanges` | json · да | `"{}"` | Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- object
- revision: новая версия
- changes: old/new по ID полей
- _ldo: command_id, operation
## Пример workflow
Get Document Fields → проверка workflow → Update Document Fields с revision первого шага и JSON разрешённых изменений.
## Ограничения
- Проведённый документ отклоняется: document_not_editable.
- Табличные части, проведение и произвольные реквизиты не поддерживаются.
- Ключи Changes — ID из write_fields, а не произвольные имена реквизитов.
## Ошибки и отказы
- access_denied / field_not_allowed: объект или поле не разрешены.
- object_not_found: объект отсутствует либо недоступен текущему пользователю.
- revision_conflict: документ изменился после чтения; прочитайте его снова и пересмотрите изменение.
- field_value_invalid: значение не соответствует разрешённому типу.
- document_not_editable: документ проведён.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.document.fields.update`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Чтение элемента справочника
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Get Catalog Fields** · Resource: `operation` · Operation: `catalogGet`
Прочитать разрешённые поля существующего элемента справочника.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Тип справочника и поля чтения разрешены; штатное Чтение и RLS.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| Catalog Type Name or ID / `catalogType` | options · да | `""` | Динамический список из подключённой базы: getCatalogTypes; Своя очередь, Прямой HTTP, MSRV |
| Catalog Item ID / `catalogId` | string · да | `""` | Своя очередь, Прямой HTTP, MSRV |
| Field Names or IDs / `catalogFields` | multiOptions · да | `[]` | Динамический список из подключённой базы: getCatalogFields; Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- object
- revision
- values
- _ldo: command_id, operation
## Пример workflow
ID из предыдущего шага → Get Catalog Fields → обработка name/code.
## Ограничения
- Чтение принимает ID; его можно получить из Search Catalog Items.
- Текущий контракт чтения содержит name и code.
## Ошибки и отказы
- access_denied / field_not_allowed: объект или поле не разрешены.
- object_not_found: объект отсутствует либо недоступен текущему пользователю.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.catalog.get`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Изменение элемента справочника
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Update Catalog Fields** · Resource: `operation` · Operation: `catalogFieldsUpdate`
Записать разрешённые поля существующего элемента с ожидаемой версией.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Поля записи разрешены; штатные права записи и RLS.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| Catalog Type Name or ID / `writeCatalogType` | options · да | `""` | Динамический список из подключённой базы: getWritableCatalogTypes; Своя очередь, Прямой HTTP, MSRV |
| Catalog Item ID / `writeCatalogId` | string · да | `""` | Своя очередь, Прямой HTTP, MSRV |
| Expected Revision / `expectedCatalogRevision` | string · да | `"={{$json.revision}}"` | Своя очередь, Прямой HTTP, MSRV |
| Changes (JSON) / `catalogChanges` | json · да | `"{}"` | Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- object
- revision
- changes: old/new
- _ldo: command_id, operation
## Пример workflow
Get Catalog Fields → проверка → Update Catalog Fields с ожидаемой revision.
## Ограничения
- Не создаёт элементы справочников.
- Changes принимает ID опубликованных полей.
## Ошибки и отказы
- access_denied / field_not_allowed: объект или поле не разрешены.
- object_not_found: объект отсутствует либо недоступен текущему пользователю.
- revision_conflict: документ изменился после чтения; прочитайте его снова и пересмотрите изменение.
- field_value_invalid: значение не соответствует разрешённому типу.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.catalog.fields.update`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Поиск значений ссылочного поля
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Search Reference Values** · Resource: `operation` · Operation: `referenceSearch`
Найти подходящие значения для конкретного разрешённого поля записи.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Ссылочное поле и режим live-поиска разрешены локальной политикой.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| Object Type Name or ID / `referenceObjectType` | options · да | `""` | Динамический список из подключённой базы: getReferenceWritableObjectTypes; Своя очередь, Прямой HTTP, MSRV |
| Reference Field Name or ID / `referenceFieldId` | options · да | `""` | Динамический список из подключённой базы: getReferenceWriteFields; Своя очередь, Прямой HTTP, MSRV |
| Search Query / `referenceQuery` | string · да | `""` | Своя очередь, Прямой HTTP, MSRV |
| Limit / `referenceLimit` | number · нет | `20` | Границы: {"min": 1, "max": 50}; Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- object_type
- field_id
- reference: kind, metadata_name
- items: id, presentation
- truncated
- _ldo: command_id, operation
## Пример workflow
Выбрать ссылочное поле «Ответственный» → Search Reference Values → уточнить запрос → передать выбранный ID в запись.
## Ограничения
- Запрос от двух символов; Limit 1–50, по умолчанию 20.
- Целевой тип берётся из политики поля. Это может быть ссылка на справочник или документ, но не общий поиск документов по номеру, дате и организации.
## Ошибки и отказы
- Профиль отключён, операция или объект не разрешены локальной политикой; недостаточно штатных прав 1С.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.reference.search`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Изменение ссылочного поля
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Update Reference Field** · Resource: `operation` · Operation: `referenceFieldUpdate`
Выбрать ссылочное значение по ID, через live-поиск или кэш и записать его в существующий объект.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Ссылочное write-поле и соответствующий selection mode разрешены; штатные права записи.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Object Type Name or ID / `referenceObjectType` | options · да | `""` | Динамический список из подключённой базы: getReferenceWritableObjectTypes; Своя очередь, Прямой HTTP, MSRV |
| Reference Field Name or ID / `referenceFieldId` | options · да | `""` | Динамический список из подключённой базы: getReferenceWriteFields; Своя очередь, Прямой HTTP, MSRV |
| Object ID / `referenceOwnerId` | string · да | `""` | Своя очередь, Прямой HTTP, MSRV |
| Expected Object Revision / `referenceOwnerRevision` | string · да | `"={{$json.revision}}"` | Своя очередь, Прямой HTTP, MSRV |
| Value Source / `referenceValueMode` | options · да | `"id"` | ID: id; Search at Execution: live; From Cache: cache; Своя очередь, Прямой HTTP, MSRV |
| Reference Value ID / `referenceValueId` | string · да | `""` | Показывается при {"referenceValueMode": ["id"]}; Своя очередь, Прямой HTTP, MSRV |
| Reference Search Query / `referenceLiveQuery` | string · да | `""` | Показывается при {"referenceValueMode": ["live"]}; Своя очередь, Прямой HTTP, MSRV |
| Cached Reference Value Name or ID / `referenceCachedId` | options · да | `""` | Показывается при {"referenceValueMode": ["cache"]}; Динамический список из подключённой базы: getReferenceCacheValues; Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- object
- revision
- changes
- _ldo.reference: mode, id, presentation при наличии
## Пример workflow
Get Document Fields → Update Reference Field: Search at Execution → единственное разрешённое значение → запись.
## Ограничения
- Live-поиск должен вернуть ровно одно совпадение.
- Кэш ограничен политикой и повторно проверяется в 1С при записи.
- Операция синхронная; Wait for Result и пользовательский Command ID не управляют её составными шагами.
## Ошибки и отказы
- access_denied / field_not_allowed: объект или поле не разрешены.
- object_not_found: объект отсутствует либо недоступен текущему пользователю.
- revision_conflict: документ изменился после чтения; прочитайте его снова и пересмотрите изменение.
- field_value_invalid: значение не соответствует разрешённому типу.
- Ноль или несколько совпадений; выбранное значение отсутствует в текущем кэше.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.reference.search (только live)`, `n8n.document.fields.update или n8n.catalog.fields.update`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# PDF документа
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Prepare Document PDF** · Resource: `operation` · Operation: `documentFilePrepare`
Сформировать разрешённую печатную форму согласованного документа.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Разрешены документ и form_id; проверены согласованный цикл и версия документа.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| Document Type Name or ID / `documentType` | options · нет | `""` | Динамический список из подключённой базы: getDocumentTypes; Своя очередь, Прямой HTTP, MSRV |
| Document ID / `documentId` | string · да | `""` | Своя очередь, Прямой HTTP, MSRV |
| Print Form Name or ID / `formId` | options · да | `""` | Динамический список из подключённой базы: getPrintForms; Своя очередь, Прямой HTTP, MSRV |
| Document Revision / `revision` | string · да | `""` | Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- binary.data: PDF
- filename, size_bytes, sha256
- _ldo: command_id; в MSRV также event_id, file_id, sha256
## Пример workflow
Prepare Document PDF → Send Email/S3. Для MSRV после успешной доставки добавить Confirm PDF Delivery.
## Ограничения
- Standalone: до 7 MiB; base64 занимает место в Data Tables.
- Проверяются размер, PDF-заголовок и SHA-256.
- Standalone возвращает PDF с результатом; MSRV скачивает временный файл из Relay.
## Ошибки и отказы
- Форма не разрешена; устарела версия или согласованный цикл; неверный PDF/хэш; превышен лимит.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.document.file.prepare`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Запуск внешнего процесса
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Start External Process** · Resource: `operation` · Operation: `processStart`
Создать экземпляр разрешённого профиля процесса для существующего документа.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Профиль процесса и операция разрешены; переход/поля проверяются по локальной политике.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| External Process Profile Name or ID / `processProfileId` | options · да | `""` | Динамический список из подключённой базы: getProcessProfiles; Своя очередь, Прямой HTTP, MSRV |
| Document Type Name or ID / `processDocumentType` | options · да | `""` | Динамический список из подключённой базы: getProcessDocumentTypes; Своя очередь, Прямой HTTP, MSRV |
| Document ID / `processDocumentId` | string · да | `""` | Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- process_id, process_profile_id
- object: type, id
- status, revision (число), active
- values, updated_at
- _ldo: command_id, operation
## Пример workflow
Document ID → Start External Process → сохранить process_id и revision.
## Ограничения
- Поля и статус принадлежат экземпляру внешнего процесса; исходный документ не изменяется.
## Ошибки и отказы
- Профиль, переход или поле недоступны; версия не совпадает; процесс отсутствует или неактивен.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.process.start`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Состояние внешнего процесса
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Get External Process** · Resource: `operation` · Operation: `processGet`
Прочитать состояние и значения существующего экземпляра.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Профиль процесса и операция разрешены; переход/поля проверяются по локальной политике.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| External Process ID / `processId` | string · да | `"={{$json.process_id}}"` | Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- process_id, process_profile_id
- object: type, id
- status, revision (число), active
- values, updated_at
- _ldo: command_id, operation
## Пример workflow
process_id из предыдущего шага → Get External Process → IF по статусу.
## Ограничения
- Поля и статус принадлежат экземпляру внешнего процесса; исходный документ не изменяется.
## Ошибки и отказы
- Профиль, переход или поле недоступны; версия не совпадает; процесс отсутствует или неактивен.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.process.get`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Переход внешнего процесса
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Transition External Process** · Resource: `operation` · Operation: `processTransition`
Выполнить разрешённый переход с ожидаемой версией и необязательными значениями полей.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Профиль процесса и операция разрешены; переход/поля проверяются по локальной политике.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| External Process Profile Name or ID / `processProfileId` | options · да | `""` | Динамический список из подключённой базы: getProcessProfiles; Своя очередь, Прямой HTTP, MSRV |
| External Process ID / `processId` | string · да | `"={{$json.process_id}}"` | Своя очередь, Прямой HTTP, MSRV |
| Expected Revision / `expectedRevision` | number · да | `0` | Границы: {"min": 1}; Своя очередь, Прямой HTTP, MSRV |
| Transition Name or ID / `transitionId` | options · да | `""` | Динамический список из подключённой базы: getProcessTransitions; Своя очередь, Прямой HTTP, MSRV |
| Process Field Values (JSON) / `processValues` | json · нет | `"{}"` | Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- process_id, process_profile_id
- object: type, id
- status, revision (число), active
- values, updated_at
- _ldo: command_id, operation
## Пример workflow
Результат внешней проверки → Transition External Process с разрешённым transition_id.
## Ограничения
- Поля и статус принадлежат экземпляру внешнего процесса; исходный документ не изменяется.
## Ошибки и отказы
- Профиль, переход или поле недоступны; версия не совпадает; процесс отсутствует или неактивен.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.process.transition`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Поля внешнего процесса
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Update External Process Fields** · Resource: `operation` · Operation: `processFieldsUpdate`
Изменить разрешённые поля экземпляра с ожидаемой версией.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Профиль процесса и операция разрешены; переход/поля проверяются по локальной политике.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| External Process Profile Name or ID / `processProfileId` | options · да | `""` | Динамический список из подключённой базы: getProcessProfiles; Своя очередь, Прямой HTTP, MSRV |
| External Process ID / `processId` | string · да | `"={{$json.process_id}}"` | Своя очередь, Прямой HTTP, MSRV |
| Expected Revision / `expectedRevision` | number · да | `0` | Границы: {"min": 1}; Своя очередь, Прямой HTTP, MSRV |
| Process Field Values (JSON) / `processValues` | json · нет | `"{}"` | Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- process_id, process_profile_id
- object: type, id
- status, revision (число), active
- values, updated_at
- _ldo: command_id, operation
## Пример workflow
Get External Process → Update External Process Fields → Get External Process.
## Ограничения
- Поля и статус принадлежат экземпляру внешнего процесса; исходный документ не изменяется.
## Ошибки и отказы
- Профиль, переход или поле недоступны; версия не совпадает; процесс отсутствует или неактивен.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.process.fields.update`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Отмена внешнего процесса
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Cancel External Process** · Resource: `operation` · Operation: `processCancel`
Отменить активный экземпляр с ожидаемой версией.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Профиль процесса и операция разрешены; переход/поля проверяются по локальной политике.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Wait for Result / `waitForResult` | boolean · нет | `true` | Своя очередь |
| Command ID / `commandId` | string · нет | `""` | Своя очередь |
| External Process ID / `processId` | string · да | `"={{$json.process_id}}"` | Своя очередь, Прямой HTTP, MSRV |
| Expected Revision / `expectedRevision` | number · да | `0` | Границы: {"min": 1}; Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- process_id, process_profile_id
- object: type, id
- status, revision (число), active
- values, updated_at
- _ldo: command_id, operation
## Пример workflow
Get External Process → проверка active/revision → Cancel External Process.
## Ограничения
- Поля и статус принадлежат экземпляру внешнего процесса; исходный документ не изменяется.
## Ошибки и отказы
- Профиль, переход или поле недоступны; версия не совпадает; процесс отсутствует или неактивен.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.process.cancel`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Получение событий
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Lease Events** · Resource: `events`
Взять события approval.started, document.approved или document.rejected в обработку.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Активная локальная подписка и разрешённые типы событий.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Event Types / `eventTypes` | multiOptions · да | `["approval.started"]` | Approval Started: approval.started; Document Approved: document.approved; Document Rejected: document.rejected; Своя очередь, MSRV |
| Limit / `limit` | number · нет | `50` | Границы: {"min": 1, "max": 100}; Своя очередь, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- id, item_type, payload
- _ldo.event_id
- Standalone: external_id и _ldo.lease_token
## Пример workflow
Schedule Trigger → Event → Switch → действие → Acknowledge Event.
## Ограничения
- Это действие по расписанию, а не отдельный бизнес-триггер.
- Limit 1–100, по умолчанию 50.
- Прямой HTTP отправляет события через отдельно настроенный исходящий webhook.
## Ошибки и отказы
- События и подтверждения очереди недоступны в прямом HTTP.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Подтверждение события
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Acknowledge Event** · Resource: `finalize` · Operation: `event`
Подтвердить успешное выполнение прикладного действия.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Доступ к событию своей очереди; в standalone нужен текущий lease_token.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Event Lease Token / `leaseToken` | string · да | `""` | Своя очередь |
| Event ID / `eventId` | number · да | `0` | Своя очередь, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- Standalone: id, status=acknowledged
- MSRV: ответ Relay на ack
## Пример workflow
Event → Send Email → Acknowledge Event.
## Ограничения
- Подтверждать после бизнес-действия, сохранив event_id и lease_token.
## Ошибки и отказы
- Устаревшая аренда или событие недоступно.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Подтверждение доставки PDF
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Confirm PDF Delivery** · Resource: `finalize` · Operation: `file`
Подтвердить временный файл Relay и затем исходное событие.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Scoped Relay credential и доступ к файлу/событию.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Event ID / `eventId` | number · да | `0` | MSRV |
| PDF ID / `fileId` | string · да | `"={{$json._ldo?.file_id \|\| $json.file_id}}"` | MSRV |
| PDF SHA-256 / `sha256` | string · да | `"={{$json._ldo?.sha256 \|\| $json.sha256}}"` | MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- Ответ Relay на подтверждение события
## Пример workflow
Prepare Document PDF → успешная доставка → Confirm PDF Delivery с file_id, sha256 и event_id.
## Ограничения
- Только MSRV. Для standalone доставку контролирует workflow назначения.
## Ошибки и отказы
- Некорректный ID/хэш; файл или событие недоступны; standalone/direct отклоняются.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Повтор события
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Retry Event** · Resource: `finalize` · Operation: `fail`
Вернуть событие на повтор после временной ошибки.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Доступ к событию; standalone требует текущую аренду.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Event Lease Token / `leaseToken` | string · да | `""` | Своя очередь |
| Event ID / `eventId` | number · да | `0` | Своя очередь, MSRV |
| Failure Description / `error` | string · да | `""` | Своя очередь, MSRV |
| Retry Delay (Seconds) / `retryAfterSeconds` | number · нет | `60` | Границы: {"min": 0, "max": 86400}; Своя очередь, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- Standalone: id, status=retry_scheduled
- MSRV: ответ Relay на fail
## Пример workflow
Ошибка доставки → Retry Event → следующая аренда события.
## Ограничения
- Задержка 0–86400 секунд, по умолчанию 60.
- В standalone Failure Description показано в UI, но этот текст не передаётся finishEvent; в MSRV передаётся.
## Ошибки и отказы
- Устаревшая аренда или событие недоступно.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Создание своей очереди
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Create Connection** · Resource: `connection` · Operation: `createConnection`
Создать Data Table и активный gateway workflow, выдать код сопряжения.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/).
- n8n API key с необходимыми правами; для сопряжения — администратор 1С.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name / `connectionName` | string · да | `"1C"` | Своя очередь |
| Public N8n URL / `publicN8nUrl` | string · нет | `""` | Своя очередь |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- connection_id, name, pairing_code, expires_at, gateway_url, workflow_id
## Пример workflow
Create Connection → код в 1С → Подключить очередь по коду.
## Ограничения
- Код действует 15 минут и является секретом; API key остаётся в n8n.
- Нужны права Data Tables и создания/активации workflows.
## Ошибки и отказы
- Недостаточно прав n8n API; неверное состояние; настройка шлюза завершилась setup_failed.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Состояние подключения
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Get Status** · Resource: `connection` · Operation: `connectionStatus`
Прочитать сохранённые параметры и состояние подключения.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/).
- n8n API key с необходимыми правами; для сопряжения — администратор 1С.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- connection_id, name, status, database_id, profile_id, policy_revision, gateway_url, workflow_id
## Пример workflow
Get Status → проверить paired и адрес шлюза.
## Ограничения
- Состояние подключения не доказывает исполнение команды или запуск опроса 1С.
## Ошибки и отказы
- Недостаточно прав n8n API; неверное состояние; настройка шлюза завершилась setup_failed.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Новый код сопряжения
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Renew Pairing Code** · Resource: `connection` · Operation: `renewPairing`
Обновить код неиспользованного или отключённого подключения.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/).
- n8n API key с необходимыми правами; для сопряжения — администратор 1С.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- connection_id, pairing_code, expires_at
## Пример workflow
Disconnect → Renew Pairing Code → сопряжение новой базы.
## Ограничения
- Допускаются состояния pending и disabled; действующее подключение сначала отключить.
## Ошибки и отказы
- Недостаточно прав n8n API; неверное состояние; настройка шлюза завершилась setup_failed.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Отключение очереди
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Disconnect** · Resource: `connection` · Operation: `disconnectConnection`
Отключить ключи сопряжения/обмена и деактивировать gateway.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/).
- n8n API key с необходимыми правами; для сопряжения — администратор 1С.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- connection_id, status=disabled
## Пример workflow
Get Status → Disconnect → проверить disabled.
## Ограничения
- Data Table и накопленные данные не удаляются.
## Ошибки и отказы
- Недостаточно прав n8n API; неверное состояние; настройка шлюза завершилась setup_failed.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Сохранённый результат команды
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Get Result** · Resource: `queue` · Operation: `getResult`
Получить состояние/результат ранее поставленной команды без создания новой.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/).
- Доступ к своему подключению и исходному scope команды.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Command ID / `queuedCommandId` | string · да | `""` | Своя очередь |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- command_id, status: pending/leased/dead/succeeded/failed
- data либо error при завершении
- Для успешного PDF — binary.data
- _ldo.command_id
## Пример workflow
Wait for Result=false → Wait → Get Result → если pending/leased, повторить только ожидание.
## Ограничения
- Чтение результата не повторяет запись.
- После timeout первоначальная команда может оставаться в очереди.
## Ошибки и отказы
- Результат отсутствует, недоступен или срок хранения истёк.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Очистка завершённых записей
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Clean Completed Entries** · Resource: `queue` · Operation: `cleanup`
Удалить старые завершённые команды и подтверждённые события текущего scope.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/).
- n8n API key с правами изменения Data Tables.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Retention (Days) / `retentionDays` | number · нет | `30` | Границы: {"min": 1, "max": 365}; Своя очередь |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
## Результат
- removed, retention_days
## Пример workflow
Schedule Trigger → Clean Completed Entries.
## Ограничения
- Retention 1–365 дней, по умолчанию 30.
- Pending, leased и dead не удаляются; старые policy revisions рассматриваются отдельно.
- Хранение executions n8n и квитанций 1С настраивается отдельно.
## Ошибки и отказы
- Недостаточно прав Data Tables или некорректное подключение.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
Служебное действие транспорта; отдельной бизнес-команды обработчика 1С нет.
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Поиск документов
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Search Documents** · Resource: `operation` · Operation: `documentSearch`
Найти разрешённые объекты по фильтрам локальной политики без ручного UUID.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Отдельный search-grant; штатное Чтение и RLS. Запись ссылочного поля не требуется.
- Имена реквизитов задаются только в локальной политике; клиент выбирает опубликованный ID фильтра.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Document Type Name or ID / `searchObjectType` | options · да | `""` | Динамический список из подключённой базы: getSearchDocumentTypes; Своя очередь, Прямой HTTP, MSRV |
| Filters / `searchFilters` | fixedCollection · да | `{}` | Своя очередь, Прямой HTTP, MSRV |
| Result Mode / `searchResultMode` | options · нет | `"list"` | List: list; Single Match: single; Своя очередь, Прямой HTTP, MSRV |
| Return All / `searchReturnAll` | boolean · нет | `false` | Показывается при {"searchResultMode": ["list"]}; Своя очередь, Прямой HTTP, MSRV |
| Limit / `searchLimit` | number · нет | `20` | Показывается при {"searchResultMode": ["list"], "searchReturnAll": [false]}; Границы: {"min": 1, "max": 50}; Своя очередь, Прямой HTTP, MSRV |
| Cursor / `searchCursor` | string · нет | `""` | Показывается при {"searchResultMode": ["list"]}; Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
### Вложенные параметры
Поля коллекции и варианты Match из описания ноды:
```json
{
"searchFilters": [
{
"name": "conditions",
"displayName": "Filter",
"values": [
{
"displayName": "Filter Name or ID",
"name": "field",
"type": "options",
"default": "",
"required": true,
"description": "Choose from the list, or specify an ID using an expression",
"typeOptions": {
"loadOptionsMethod": "getSearchFilters",
"loadOptionsDependsOn": [
"searchObjectType"
]
}
},
{
"displayName": "Match",
"name": "match",
"type": "options",
"default": "exact",
"options": [
{
"name": "Between Dates",
"value": "between"
},
{
"name": "Contains",
"value": "contains"
},
{
"name": "Exact",
"value": "exact"
},
{
"name": "Starts With",
"value": "startsWith"
}
],
"description": "Only modes permitted by the selected local filter are accepted"
},
{
"displayName": "Value",
"name": "value",
"type": "string",
"default": "",
"required": true,
"description": "Text, reference ID, or calendar date YYYY-MM-DD; for Between Dates this is the first day"
},
{
"displayName": "Last Day",
"name": "to",
"type": "string",
"default": "",
"description": "Inclusive last calendar day YYYY-MM-DD for Between Dates"
}
]
}
]
}
```
## Результат
- Отдельный output item на объект: object.type/id, revision, values
- _ldo.command_id и _ldo.search.has_more/next_cursor
## Пример workflow
Search → Get Fields с выражениями object.type/id из результата.
```text
Входной номер/наименование → Search (Single Match) → Get Fields
```
ID следующего шага: `={{$json.object.id}}`; тип: `={{$json.object.type}}`.
[Полное руководство по универсальному поиску](https://ldo.msrv.tech/docs/n8n/search/).
## Ограничения
- Single Match требует ровно один результат; пустой List возвращает ноль items.
- Return All ограничен локальной политикой (не более 200); размер страницы 1–50.
- Курсор связан с профилем, ревизией и фильтрами; политика проверяется при каждой странице.
- Документы: номер и календарная дата/период. Справочники: наименование/код; дополнительные поля (например ИНН) задаются локальным отображением метаданных.
## Ошибки и отказы
- access_denied, invalid_filter, filter_not_allowed, search_too_broad, object_not_found, ambiguous_match, cursor_invalid, search_limit_exceeded
## Совместимость
Доступно с нодой **0.4.0** и ядром **6.8** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.document.search`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Поиск элементов справочников
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
**Search Catalog Items** · Resource: `operation` · Operation: `catalogSearch`
Найти разрешённые объекты по фильтрам локальной политики без ручного UUID.
**Нода 0.4.1 · Ядро ЛДО 6.9**.
## Подключение и разрешения
Транспорты: [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/), [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/), [MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
- Отдельный search-grant; штатное Чтение и RLS. Запись ссылочного поля не требуется.
- Имена реквизитов задаются только в локальной политике; клиент выбирает опубликованный ID фильтра.
## Настройка в n8n
Выберите **LDO 1C**, нужный транспорт и credential, затем Resource и действие, указанные выше. Динамические списки используют capabilities выбранного подключения.
| Параметр интерфейса / код | Тип · обязательно | По умолчанию | Варианты, условия, транспорт |
| --- | --- | --- | --- |
| Connection Name or ID / `connectionId` | options · да | `""` | Динамический список из подключённой базы: getConnections; Своя очередь |
| Catalog Type Name or ID / `searchObjectType` | options · да | `""` | Динамический список из подключённой базы: getSearchCatalogTypes; Своя очередь, Прямой HTTP, MSRV |
| Filters / `searchFilters` | fixedCollection · да | `{}` | Своя очередь, Прямой HTTP, MSRV |
| Result Mode / `searchResultMode` | options · нет | `"list"` | List: list; Single Match: single; Своя очередь, Прямой HTTP, MSRV |
| Return All / `searchReturnAll` | boolean · нет | `false` | Показывается при {"searchResultMode": ["list"]}; Своя очередь, Прямой HTTP, MSRV |
| Limit / `searchLimit` | number · нет | `20` | Показывается при {"searchResultMode": ["list"], "searchReturnAll": [false]}; Границы: {"min": 1, "max": 50}; Своя очередь, Прямой HTTP, MSRV |
| Cursor / `searchCursor` | string · нет | `""` | Показывается при {"searchResultMode": ["list"]}; Своя очередь, Прямой HTTP, MSRV |
| Timeout (Seconds) / `timeoutSeconds` | number · нет | `900` | Границы: {"min": 1, "max": 1800}; Своя очередь, Прямой HTTP, MSRV |
| Poll Interval (Seconds) / `pollSeconds` | number · нет | `2` | Границы: {"min": 1, "max": 30}; Своя очередь, Прямой HTTP, MSRV |
Обязательность отражает интерфейс; дополнительные проверки выполняются расширением 1С. Пустое значение не отменяет локальные разрешения.
### Вложенные параметры
Поля коллекции и варианты Match из описания ноды:
```json
{
"searchFilters": [
{
"name": "conditions",
"displayName": "Filter",
"values": [
{
"displayName": "Filter Name or ID",
"name": "field",
"type": "options",
"default": "",
"required": true,
"description": "Choose from the list, or specify an ID using an expression",
"typeOptions": {
"loadOptionsMethod": "getSearchFilters",
"loadOptionsDependsOn": [
"searchObjectType"
]
}
},
{
"displayName": "Match",
"name": "match",
"type": "options",
"default": "exact",
"options": [
{
"name": "Between Dates",
"value": "between"
},
{
"name": "Contains",
"value": "contains"
},
{
"name": "Exact",
"value": "exact"
},
{
"name": "Starts With",
"value": "startsWith"
}
],
"description": "Only modes permitted by the selected local filter are accepted"
},
{
"displayName": "Value",
"name": "value",
"type": "string",
"default": "",
"required": true,
"description": "Text, reference ID, or calendar date YYYY-MM-DD; for Between Dates this is the first day"
},
{
"displayName": "Last Day",
"name": "to",
"type": "string",
"default": "",
"description": "Inclusive last calendar day YYYY-MM-DD for Between Dates"
}
]
}
]
}
```
## Результат
- Отдельный output item на объект: object.type/id, revision, values
- _ldo.command_id и _ldo.search.has_more/next_cursor
## Пример workflow
Search → Get Fields с выражениями object.type/id из результата.
```text
Входной номер/наименование → Search (Single Match) → Get Fields
```
ID следующего шага: `={{$json.object.id}}`; тип: `={{$json.object.type}}`.
[Полное руководство по универсальному поиску](https://ldo.msrv.tech/docs/n8n/search/).
## Ограничения
- Single Match требует ровно один результат; пустой List возвращает ноль items.
- Return All ограничен локальной политикой (не более 200); размер страницы 1–50.
- Курсор связан с профилем, ревизией и фильтрами; политика проверяется при каждой странице.
- Документы: номер и календарная дата/период. Справочники: наименование/код; дополнительные поля (например ИНН) задаются локальным отображением метаданных.
## Ошибки и отказы
- access_denied, invalid_filter, filter_not_allowed, search_too_broad, object_not_found, ambiguous_match, cursor_invalid, search_limit_exceeded
## Совместимость
Доступно с нодой **0.4.0** и ядром **6.8** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Команды контракта
`n8n.catalog.search`
Это справочные идентификаторы, а не публичные HTTP endpoints.
## Связанные материалы
[Все операции](https://ldo.msrv.tech/docs/n8n/) · [Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Другие возможности](https://ldo.msrv.tech/docs/n8n/features/)
---
# Начало работы с нодой 1С для n8n
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Нода **LDO 1C** связывает workflow n8n с совместимым расширением ЛДО в 1С.
Пакет называется `n8n-nodes-ldo-1c-relay`. Расширение устанавливается отдельно
под вашу конфигурацию; наличие ноды в n8n само по себе не открывает доступ к базе.
## Выберите способ подключения
**MSRV — рекомендуемый вариант, если важна простота настройки.** Вы получаете
обслуживаемую среду и подключаете расширение ключом. База забирает команды
исходящими запросами. Настройка и сервисы доступны после подключения к MSRV.
[Запросить подключение](https://ldo.msrv.tech/#request) · [Как работает MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/).
**Своя очередь — самостоятельная настройка для администратора или интегратора.**
Вы управляете self-hosted n8n. Публиковать базу 1С для входящих команд не требуется:
она опрашивает шлюз вашего n8n по расписанию. [Настройка очереди](https://ldo.msrv.tech/docs/n8n/transports/queue/).
**Прямой HTTP — для опубликованного сервиса 1С.** n8n обращается к расширению
под штатным пользователем базы. [Настройка Direct HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/).
В самостоятельных режимах запросы не направляются в API MSRV. Общие боты ЛДО
и обслуживаемая инфраструктура подключаются отдельно.
## Установите совместимые компоненты
1. Для собственного n8n откройте **Settings → Community Nodes → Install** и
установите `n8n-nodes-ldo-1c-relay` из npm.
2. Получите [расширение ЛДО под вашу конфигурацию](https://gitsell.ru/msrv-tech/ldo).
Проверьте поддержку выбранного транспорта и операций в вашей поставке.
3. В 1С откройте **ЛДО Интеграции → Подключение** и выберите свой режим.
4. На вкладке **Доступ к данным** разрешите необходимые объекты и действия.
5. Настройте соответствующий credential в n8n и выполните его тест.
[Подробная установка n8n, Docker, HTTPS и расширения](https://ldo.msrv.tech/articles/ustanovka-n8n-1c-self-hosted.html).
Для n8n Cloud доступность community-пакета определяется его верификацией
и правилами Cloud; установка в self-hosted не подтверждает доступность в Cloud.
## Первое чтение
Создайте workflow `Manual Trigger → LDO 1C → Get Capabilities`.
Полученный каталог показывает доступные типы и поля именно вашей базы.
После изменения разрешений для очереди дождитесь синхронизации расширения.
Далее используйте **Get Document Fields** с разрешённым типом и ID из события
или вашей системы. ID также можно получить через **Search Documents**,
затем передать следующему шагу выражением n8n.
## Как читать эту базу знаний
- Русское название объясняет назначение; английское соответствует интерфейсу n8n.
- На странице операции перечислены транспорты, параметры, результат и ограничения.
- На сайте представлены возможности опубликованного пакета; их наличие
не заменяет разрешение в вашей базе.
- Текущая нода — **0.4.1**, ядро ЛДО — **6.9**. Сверяйте обе версии.
- В сведениях о совместимости указаны проверенные версии и ограничения.
[Каталог операций](https://ldo.msrv.tech/docs/n8n/) · [Совместимость](https://ldo.msrv.tech/docs/n8n/compatibility/).
---
# Использование справочника ИИ-агентом
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Это документация опубликованного npm-пакета LDO 1C, а не endpoint управления
базой. Справочник не предоставляет credentials, права или подключение к MSRV.
## Точки входа
- [Manifest](https://ldo.msrv.tech/docs/n8n/manifest.json): опубликованная версия пакета, версия ядра и ссылки.
- [Catalog JSON](https://ldo.msrv.tech/docs/n8n/catalog.json): операции, параметры интерфейса, транспорты,
разрешения, ограничения и совместимость.
- [Releases JSON](https://ldo.msrv.tech/docs/n8n/releases.json): выпуски каждого компонента и поддерживаемые пары.
- [Обновления](https://ldo.msrv.tech/docs/n8n/updates/): пользовательская история изменений и порядок обновления.
- [llms.txt](https://ldo.msrv.tech/docs/n8n/llms.txt): короткий указатель на материалы раздела.
- [Полная текстовая справка](https://ldo.msrv.tech/docs/n8n/llms-full.txt): Markdown для чтения или RAG.
- У каждой HTML-страницы есть Markdown-копия, указанная в `rel="alternate"`.
## Версия ноды и версия ядра
Текущая нода: **0.4.1**. Требуемое ядро ЛДО: **6.9**.
`publication.publishedVersion` — версия опубликованного npm-пакета.
`coreVersion` — версия общей части расширения, без привязки к конфигурации.
`supportedReleases` описывает опубликованные пары версий.
У операций `compatibility.nodeVersion` и `compatibility.coreVersion`
задают соответствующую пару. Будущие версии и операции в каталоге отсутствуют.
`introducedIn.nodeVersion` и `introducedIn.coreVersion` задают нижнюю границу
описанной возможности. `compatibility.supportedPairs` перечисляет применимые
поддерживаемые пары; не выводите совместимость только из сравнения номеров.
`requiredCoreVersion` — требование npm-пакета, а `coreVersion` — текущее
рекомендуемое совместимое ядро. Они могут различаться при отдельном выпуске ядра.
Версию ядра определяют первые два компонента версии расширения ЛДО.
Настройка конкретной конфигурации и среда установки описываются отдельно.
Технические отчёты разработчиков в публичный каталог не включаются.
## Как выбрать действие
1. Сверьте установленную версию ноды и ядра с [таблицей совместимости](https://ldo.msrv.tech/docs/n8n/compatibility/).
2. Выберите явно настроенный транспорт. Queue и Direct не используют MSRV;
для MSRV требуется отдельное подключение и поддержка операции сервисом.
3. Получите **Get Capabilities** из подключённой базы: общий каталог сайта
не заменяет разрешённые типы, поля и профили этой базы.
4. Используйте `uiName`, `resource`, `operation` и параметры карточки.
5. Передайте ID и revision из результата предыдущего шага выражениями n8n.
Не выбирайте первый объект из неоднозначного поиска автоматически.
6. Различайте чтение, поиск и запись: найденный ID не даёт права изменять объект.
`commands` — справочные идентификаторы внутренних команд, а не готовые tool calls.
`parameters` описывает параметры ноды n8n и условия их видимости.
Для вызова как инструмента AI Agent нужны настроенный credential и разрешения 1С.
## Устойчивые ссылки и происхождение данных
Страницы `/docs/n8n/operations//` имеют постоянные ID.
HTML, Markdown и JSON создаются из опубликованного пакета, полученного из npm.
Manifest фиксирует исходный релиз и целостность каталога. Локальное рабочее дерево
не используется как источник публичных возможностей.
---
# Универсальный поиск документов и справочников
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Нода **0.4.1**, ядро ЛДО **6.9**.
Поиск использует общие возможности ядра и локальные разрешения вашей базы.
[Совместимость ноды и ядра](https://ldo.msrv.tech/docs/n8n/compatibility/).
## Как устроен поиск
Два действия основной ноды: **Search Documents** и **Search Catalog Items**.
Типы объектов и фильтры нода получает из capabilities подключённой базы.
Общий обработчик не содержит имён документов, справочников или реквизитов
конкретной конфигурации. Стандартные поля берутся из метаданных 1С; дополнительные
фильтры задаются локальной политикой администратора.
| Тип | Стандартные фильтры | Дополнительные фильтры |
| --- | --- | --- |
| Документ | Номер, календарная дата или период | Например организация: явное отображение на ссылочный реквизит |
| Справочник | Наименование, код | Например ИНН: явное отображение на строковый реквизит |
Поддерживаются string/date/number/reference. Для числового номера или кода
используется точное числовое сравнение; для строкового сохраняются префикс
и ведущие нули. Даты — календарные дни в часовом поясе сеанса 1С.
## Разрешение в 1С
В настройках «ЛДО Интеграции → Доступ к данным» есть таблица с колонками
**«Разрешить поиск», «Объект», «Тип объекта»**. Разрешение устанавливается
отдельно для каждого типа и применяется общей командой обновления доступа n8n.
По умолчанию поиск выключен. Сам выбор типа или просмотр метаданных доступа
не предоставляют.
Search-grant независим от записи и от чтения по известному ID. Например,
можно разрешить поиск и его минимальный результат, не разрешая Update Fields.
Для следующего Get Fields нужно отдельно разрешить обычное чтение.
Штатные права текущего пользователя и RLS продолжают действовать.
Дополнительные фильтры настраиваются в JSON-профиле режима интегратора.
Пример **с заменяемыми именами метаданных**, не готовый профиль конфигурации:
```json
{
"object_type": "catalog.YourDirectory",
"metadata_kind": "catalog",
"metadata_name": "YourDirectory",
"read_fields": ["name", "code"],
"search": {
"filters": [
{"id": "name", "attribute": "Наименование", "value_type": "string", "match_modes": ["exact", "contains", "startsWith"]},
{"id": "tax_number", "attribute": "YourTaxAttribute", "value_type": "string", "match_modes": ["exact"]}
],
"max_results": 200,
"max_period_days": 31
}
}
```
`YourDirectory` и `YourTaxAttribute` заменить реальными именами вашей базы.
Для ссылочного фильтра дополнительно задать `reference.kind` (catalog/document)
и `reference.metadata_name`. Сервер проверяет наличие реквизита и совместимость
типа. Клиент n8n получает ID фильтра, тип и разрешённые режимы; имена реквизитов
и локальный секрет курсора в capabilities не передаются.
JSON экспорт учитывает выбор в таблице поиска; изменение разрешений сохраняется
только при явном применении доступа. Новая policy revision инвалидирует старые
курсоры. Перезапуск исходного поиска получает новую политику автоматически.
## Настройка ноды
1. Выбрать транспорт и credential; для очереди — своё подключение.
2. Выбрать Search Documents или Search Catalog Items и разрешённый тип.
3. Добавить Filters: Filter Name or ID, Match, Value; для Between Dates — Last Day.
4. Выбрать Result Mode: List либо Single Match.
5. Для List указать Limit или включить Return All.
Для ссылочного фильтра Value — ID из предыдущего шага/внешней системы.
Организацию также можно сначала найти отдельным Search Catalog Items, если
такой тип и фильтры разрешены политикой.
## Workflow без копирования UUID
```text
Номер/дата из входного запроса
→ Search Documents (Single Match)
→ Get Document Fields
```
В следующей ноде:
```javascript
// Document Type / Catalog Type
={{$json.object.type}}
// Document ID / Catalog Item ID
={{$json.object.id}}
// Expected Revision для записи
={{$json.revision}}
```
List возвращает отдельный output item на каждый объект; Split Out не нужен.
Результат содержит `object`, `revision`, разрешённые `values` и `_ldo`.
Найденный ID не предоставляет новых прав записи: следующая операция отдельно
проверяет разрешения и ожидаемую revision.
## Пустые и неоднозначные результаты
- List без совпадений возвращает ноль items. Downstream шаги не запускаются.
- При необходимости отдельной ветки «не найдено» использовать Always Output Data
и IF; пустой item без object.id не передавать в запись/PDF.
- Single Match при отсутствии объекта выдаёт object_not_found; при двух и более
совпадениях — ambiguous_match. Первый результат автоматически не выбирается.
- Webhook с ответом от последней ноды требует отдельной настройки ответа на
пустой результат; поведение HTTP webhook не меняет успешность самого поиска.
## Лимиты и страницы
Размер страницы — 1–50, по умолчанию 20. Локальная политика ограничивает общий
Return All максимумом до 200 объектов. Нода собирает страницы до выдачи результата;
при превышении лимита возвращает search_limit_exceeded вместо частичного списка.
Общее ожидание ограничено Timeout, включая последующие страницы.
`_ldo.search.next_cursor` позволяет продолжить List с теми же фильтрами.
Порядок документов: дата и ссылка; справочников: ссылка. Используется seek,
без OFFSET. Курсор проверяется по целостности и контексту профиля/политики/фильтров.
Single Match не использует курсор предыдущей страницы.
Для документов требуется точный строковый/числовой фильтр либо ограниченный
период; префикс от трёх символов требует дополнительного селективного ограничения.
Для справочников текстовый поиск от двух символов. Период ограничен политикой.
Поиск не является снимком базы: между страницами объекты могут измениться.
## Подключение и совместимость
Поиск использует те же настройки подключения, что и остальные операции ноды.
Самостоятельная очередь и прямой HTTP не обращаются к MSRV.
Для поиска требуется совместимая пара ноды и ядра, указанная выше.
Доступные фильтры определяются метаданными базы и разрешениями администратора.
Через MSRV дополнительно нужна поддержка поисковых операций сервисом.
[Подробнее о совместимости](https://ldo.msrv.tech/docs/n8n/compatibility/).
---
# Своя очередь: подключение 1С к n8n
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
## Когда выбрать
Самостоятельный режим для администратора или интегратора на вашей инфраструктуре.
## Требования
Self-hosted n8n с Public API/Data Tables; исходящая доступность gateway из 1С; работающий опрос расширения.
## Авторизация
Credential: **LDO 1C Standalone Queue API**.
URL своего n8n, API key; одноразовый код в 1С. API key не передаётся в 1С.
## Настройка
1. Установите ноду в self-hosted n8n и создайте Queue credential с корневым URL n8n и API key.
2. Выполните **Create Connection**. Проверьте публичный адрес шлюза: он должен быть доступен с сервера 1С.
3. В 1С выберите самостоятельную настройку → **Очередь**, вставьте одноразовый код и подключите очередь. Адрес передаётся внутри кода.
4. Разрешите нужные данные и проверьте регламентный опрос. **Connection Status** и синхронизация capabilities помогают диагностировать связь.
5. Выполните разрешённую операцию и подтвердите результат.
Очередь хранится в Data Tables вашего n8n. 1С забирает команды исходящими запросами. Gateway Trigger обслуживает обмен, а события бизнеса выдаёт **Lease Events** по расписанию. API key n8n не передаётся в 1С.
## Роль MSRV
Не требуется; автоматического fallback в MSRV нет.
## Инструкции и доступные действия
[Подробная установка self-hosted n8n](https://ldo.msrv.tech/articles/ustanovka-n8n-1c-self-hosted.html) · [Каталог операций](https://ldo.msrv.tech/docs/n8n/) · [Совместимость](https://ldo.msrv.tech/docs/n8n/compatibility/)
---
# Прямой HTTP: подключение 1С к n8n
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
## Когда выбрать
Самостоятельный режим для администратора или интегратора на вашей инфраструктуре.
## Требования
Публикация ldo_n8n и доступность из n8n; разрешён прямой доступ пользователя.
## Авторизация
Credential: **LDO 1C Direct API**.
URL опубликованного сервиса 1С, логин и пароль штатного пользователя. Профиль определяется автоматически.
## Настройка
1. Опубликуйте сервис расширения `ldo_n8n`.
2. В 1С включите прямой HTTP-доступ для штатного пользователя и разрешите нужные данные.
3. Создайте **LDO 1C Direct API** с URL вида `https://onec.example.com/base/hs/ldo_n8n`, логином и паролем пользователя. Профиль определяется автоматически.
4. Проверьте credential из n8n и выполните Get Capabilities.
1С не нужен адрес n8n для обработки входящих команд Direct. Исходящие события на webhook настраиваются отдельно. Публикация должна быть доступна из контейнера n8n; просмотр URL в браузере этого не доказывает.
## Роль MSRV
Не требуется.
## Инструкции и доступные действия
[Подробная установка self-hosted n8n](https://ldo.msrv.tech/articles/ustanovka-n8n-1c-self-hosted.html) · [Каталог операций](https://ldo.msrv.tech/docs/n8n/) · [Совместимость](https://ldo.msrv.tech/docs/n8n/compatibility/)
---
# Сервис MSRV: подключение 1С к n8n
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
## Когда выбрать
Рекомендуемый режим для простой настройки и обслуживаемой инфраструктуры. Запросите подключение и активируйте выданный ключ в расширении. Среда n8n и сервисы предоставляются по условиям подключения.
## Требования
Явное подключение к сервису MSRV; исходящий опрос 1С и локальная политика.
## Авторизация
Credential: **LDO Relay API**.
Relay URL и scoped token, database/profile/policy identifiers от оператора.
## Настройка
1. [Запросите подключение ЛДО Интеграций](https://ldo.msrv.tech/#request).
2. Активируйте выданный ключ на вкладке подключения расширения.
3. Разрешите объекты и операции, проверьте исходящий обмен и откройте выделенную среду n8n.
4. Используйте настройки Relay credential и идентификаторы, выданные оператором.
MSRV — отдельный транспорт и отдельная авторизация. Подключение публичной ноды к собственной очереди или Direct автоматически не предоставляет услуги MSRV.
## Роль MSRV
Только по отдельному подключению и серверной авторизации.
## Инструкции и доступные действия
[Подробная установка self-hosted n8n](https://ldo.msrv.tech/articles/ustanovka-n8n-1c-self-hosted.html) · [Каталог операций](https://ldo.msrv.tech/docs/n8n/) · [Совместимость](https://ldo.msrv.tech/docs/n8n/compatibility/)
---
# Способы подключения 1С к n8n
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
MSRV — для простой настройки и обслуживаемых сервисов. Собственная очередь — для закрытой базы. Direct HTTP — для опубликованного сервиса.
- [Своя очередь](https://ldo.msrv.tech/docs/n8n/transports/queue/): Self-hosted n8n с Public API/Data Tables; исходящая доступность gateway из 1С; работающий опрос расширения.
- [Прямой HTTP](https://ldo.msrv.tech/docs/n8n/transports/direct/): Публикация ldo_n8n и доступность из n8n; разрешён прямой доступ пользователя.
- [Сервис MSRV](https://ldo.msrv.tech/docs/n8n/transports/msrv/): Явное подключение к сервису MSRV; исходящий опрос 1С и локальная политика.
---
# LDO 1C Queue Gateway Trigger
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Отдельная служебная нода POST 1c-queue для pair/sync/poll/result/event. Возвращает ответ напрямую, без бизнес-executions для опроса. Создаётся Create Connection.
## Ограничения
Не является триггером бизнес-событий. Активность workflow не доказывает работу регламентного задания 1С.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
[Каталог операций](https://ldo.msrv.tech/docs/n8n/)
---
# Динамические разрешения
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Типы объектов, поля, печатные формы и процессы выбираются из capabilities конкретной базы. Изменения политики своей очереди синхронизируются опросом.
## Ограничения
Локальная политика, native permissions/RLS и ревизия повторно проверяются в 1С; capabilities не выдаёт новые права.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
[Каталог операций](https://ldo.msrv.tech/docs/n8n/)
---
# Использование как инструмента AI-агента
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Основная нода объявлена usableAsTool=true; разрешённую операцию можно подключить к AI Agent.
## Ограничения
Не включает модель и не даёт произвольный доступ к 1С. Gateway инструментом агента не является.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
[Каталог операций](https://ldo.msrv.tech/docs/n8n/)
---
# Ожидание и восстановление
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Timeout 1–1800 секунд; Poll Interval 1–30. Для очереди эффективный timeout не меньше Minimum Wait credential (по умолчанию 900). Можно использовать Wait/Get Result.
## Ограничения
Синхронное ожидание занимает worker. Command ID + исходный payload восстанавливают результат; новый ID — новая операция. Для составного Update Reference Field отдельные ограничения.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
[Каталог операций](https://ldo.msrv.tech/docs/n8n/)
---
# Повторы записи и версии
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Expected revision защищает от параллельных изменений; квитанции 1С сохраняют результат вместе с записью. Точный повтор не применяет запись второй раз.
## Ограничения
Доставка at least once; транспортные дубли возможны. Иной payload с тем же ID отклоняется. После result_expired запись не повторяется.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
[Каталог операций](https://ldo.msrv.tech/docs/n8n/)
---
# Отдельная поставка расширения 1С
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Пакет npm содержит ноду n8n. Расширение ЛДО устанавливается отдельно: выберите поставку для своей конфигурации с совместимой версией ядра.
## Ограничения
Для обычной базы и Фреша используются соответствующие варианты установки и фонового обмена. Номер ядра не заменяет выбор подходящей поставки расширения.
## Совместимость
Доступно с нодой **0.3.0** и ядром **6.7** в поддерживаемых парах версий. Доступно в ноде 0.4.1 с ядром ЛДО 6.9. Объекты и действия должны быть разрешены в настройках базы. Для транспорта MSRV требуется поддержка операции подключённым сервисом. [Совместимость и ограничения](https://ldo.msrv.tech/docs/n8n/compatibility/).
[Каталог операций](https://ldo.msrv.tech/docs/n8n/)
---
# Дополнительные возможности ноды LDO 1C
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
- [LDO 1C Queue Gateway Trigger](https://ldo.msrv.tech/docs/n8n/features/queue-gateway/): Отдельная служебная нода POST 1c-queue для pair/sync/poll/result/event. Возвращает ответ напрямую, без бизнес-executions для опроса. Создаётся Create Connection.
- [Динамические разрешения](https://ldo.msrv.tech/docs/n8n/features/dynamic-policy/): Типы объектов, поля, печатные формы и процессы выбираются из capabilities конкретной базы. Изменения политики своей очереди синхронизируются опросом.
- [Использование как инструмента AI-агента](https://ldo.msrv.tech/docs/n8n/features/ai-tool/): Основная нода объявлена usableAsTool=true; разрешённую операцию можно подключить к AI Agent.
- [Ожидание и восстановление](https://ldo.msrv.tech/docs/n8n/features/wait-recovery/): Timeout 1–1800 секунд; Poll Interval 1–30. Для очереди эффективный timeout не меньше Minimum Wait credential (по умолчанию 900). Можно использовать Wait/Get Result.
- [Повторы записи и версии](https://ldo.msrv.tech/docs/n8n/features/write-receipts/): Expected revision защищает от параллельных изменений; квитанции 1С сохраняют результат вместе с записью. Точный повтор не применяет запись второй раз.
- [Отдельная поставка расширения 1С](https://ldo.msrv.tech/docs/n8n/features/extension-distribution/): Пакет npm содержит ноду n8n. Расширение ЛДО устанавливается отдельно: выберите поставку для своей конфигурации с совместимой версией ядра.
---
# Совместимость ноды и ядра ЛДО
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
## Какие версии использовать вместе
Для текущего релиза используйте **ноду 0.4.1** и расширение на
**ядре ЛДО 6.9**. Справочник показывает только опубликованные версии
ноды и доступные в них возможности.
| Нода n8n | Ядро ЛДО | Возможности |
| --- | --- | --- |
| 0.4.1 | 6.9 | Понятное описание возможностей и инструкции подключения |
| 0.4.0 | 6.9 | Поиск документов и справочников по реквизитам |
| 0.4.1 | 6.8 | Понятное описание возможностей и инструкции подключения |
| 0.4.0 | 6.8 | Поиск документов и справочников по реквизитам |
| 0.3.0 | 6.7 | Проще подключить собственный n8n |
Нода отвечает за действия в n8n, а ядро ЛДО — за выполнение команд в 1С.
Совместимость определяется этой парой версий и общим контрактом обмена,
независимо от названий документов и справочников конфигурации.
Это явно поддерживаемые пары, а не правило «любая более новая версия подходит».
Ядро может обновляться независимо от ноды. Список изменений каждого компонента
смотрите на странице [обновлений](https://ldo.msrv.tech/docs/n8n/updates/).
## Где посмотреть версию ядра
Версия ядра — первые два числа версии расширения ЛДО.
Например, расширение `6.8.2.0` использует ядро **6.8**.
Оставшиеся числа обозначают адаптацию и её исправления.
Версию установленного расширения можно посмотреть в списке расширений 1С.
Расширение должно соответствовать вашей конфигурации и содержать нужную
версию ядра. Ядро — общая часть продукта, а не отдельный универсальный файл,
который устанавливается в любую базу.
## Возможности текущего релиза
| Возможность | Что можно сделать |
| --- | --- |
| Документы и справочники | Читать разрешённые данные и изменять разрешённые поля существующих объектов |
| Поиск | Находить документы по номеру и дате, элементы справочников — по наименованию и другим разрешённым реквизитам; использовать найденный объект в следующем шаге |
| PDF | Получать разрешённую печатную форму согласованного документа |
| События через очередь | Запускать обработку события согласования, подтверждать завершение или возвращать событие на повтор |
| Внешние процессы | Запускать настроенный процесс, получать его состояние и выполнять разрешённые действия |
| Инструмент ИИ-агента | Использовать разрешённые операции 1С в workflow с AI Agent |
Конкретные объекты, поля, формы и процессы определяются настройками доступа
в базе. После изменения разрешений обновите каталог возможностей подключения.
## Выбор подключения
- **Своя очередь:** база забирает команды исходящими запросами. Требуются
доступный из 1С адрес шлюза n8n и обработка очереди по расписанию.
- **Прямой HTTP:** сервис расширения должен быть опубликован и доступен из n8n.
Передача исходящих событий на webhook настраивается отдельно.
- **MSRV:** требуется отдельное подключение и поддержка выбранной операции
сервисом. Номер ноды сам по себе не предоставляет доступ к услугам MSRV.
Установку для конкретной конфигурации, особенности Фреша и фонового обмена
смотрите в [инструкциях подключения](https://ldo.msrv.tech/docs/n8n/transports/).
Доступность пакета в n8n Cloud зависит от его верификации и условий Cloud.
## Возможности, которых пока нет
- Создание новых документов и элементов справочников.
- Проведение, отмена проведения и удаление документов.
- Универсальное чтение и изменение строк табличных частей.
[Обновить ноду в n8n](https://ldo.msrv.tech/docs/n8n/start/) · [Каталог операций](https://ldo.msrv.tech/docs/n8n/).
---
# Обновления ноды n8n и ядра ЛДО
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
Текущая опубликованная нода — **0.4.1**, рекомендуемое совместимое
ядро ЛДО — **6.9**.
Нода и ядро выпускаются независимо. Если новое ядро поддерживает установленную
ноду, достаточно обновить расширение. Для новой операции может потребоваться
обновление обоих компонентов — сверяйте версии в её карточке.
## Перед обновлением
1. Посмотрите версии установленной ноды и ядра расширения.
2. Выберите [поддерживаемую пару](https://ldo.msrv.tech/docs/n8n/compatibility/).
3. Сохраните резервную копию и обновите нужные компоненты. Ноду обновляют
в разделе Community nodes своего n8n; расширение — подходящей поставкой
для вашей конфигурации и среды установки.
4. Проверьте подключение и обновите каталог разрешённых возможностей в n8n.
Релиз общего ядра не означает одновременный выпуск всех адаптаций расширения.
Доступность через сервис MSRV и установка обновлений в обслуживаемой среде
определяются отдельно. Версия npm сама по себе не означает верификацию n8n Cloud.
История начинается с ноды 0.3.0 и ядра 6.7 — базовой пары этого справочника.
Более ранние публикации здесь не перечислены. Версии «доступно с» в карточках
задают нижнюю границу для описанного способа работы в поддерживаемых парах.
## Нода n8n 0.4.1 · 2026-10-23
Понятное описание возможностей и инструкции подключения.
- Описание нод в поиске n8n раскрывает задачи: документы, справочники, PDF и согласование.
- Документация из нод и credentials ведёт к инструкциям ЛДО на сайте.
- Обновлены английский и русский README: возможности, установка и помощь с внедрением.
[Пакет npm](https://www.npmjs.com/package/n8n-nodes-ldo-1c-relay/v/0.4.1)
## Ядро ЛДО 6.9 · 2026-10-15
Единый интерфейс подключения MSRV и самостоятельного n8n.
- Рекомендуемое подключение MSRV с отдельной самостоятельной настройкой.
- Переключатель своей очереди и прямого HTTP, адрес очереди из кода подключения.
- Разделение подключения, доступа к данным, событий и диагностики.
- Исправлено открытие настроек и редактора печатных форм.
Совместимые версии ноды: **0.4.1, 0.4.0**. Нужна соответствующая поставка расширения для вашей конфигурации.
## Ядро ЛДО 6.8 · 2026-10-15
Универсальный поиск по метаданным 1С.
- Обработка поиска документов и элементов справочников с учётом локальных разрешений.
- Отдельное разрешение на поиск и ограничение размера выдачи.
Совместимые версии ноды: **0.4.1, 0.4.0**. Нужна соответствующая поставка расширения для вашей конфигурации.
## Нода n8n 0.4.0 · 2026-10-15
Поиск документов и справочников по реквизитам.
- Поиск документов по номеру, дате и другим разрешённым реквизитам.
- Поиск элементов справочников по наименованию и разрешённым полям.
- Постраничная выдача и передача найденного объекта в следующий шаг workflow.
[Пакет npm](https://www.npmjs.com/package/n8n-nodes-ldo-1c-relay/v/0.4.0)
## Ядро ЛДО 6.7 · 2026-10-14
Самостоятельное подключение очереди и прямого HTTP.
- Подключение собственной очереди n8n по одноразовому коду.
- Авторизация прямого HTTP штатным пользователем 1С.
Совместимые версии ноды: **0.3.0**. Нужна соответствующая поставка расширения для вашей конфигурации.
## Нода n8n 0.3.0 · 2026-10-14
Проще подключить собственный n8n.
- Подключение очереди одноразовым кодом без ручного переноса адреса и токена.
- Прямой HTTP с логином и паролем пользователя 1С.
- Чтение и разрешённые изменения, PDF, события и внешние процессы.
[Пакет npm](https://www.npmjs.com/package/n8n-nodes-ldo-1c-relay/v/0.3.0)
[Каталог операций](https://ldo.msrv.tech/docs/n8n/) · [Совместимость](https://ldo.msrv.tech/docs/n8n/compatibility/)
---
# Возможности ноды 1С для n8n
> Опубликован npm 0.4.1; ядро ЛДО 6.9. Только опубликованные возможности. Возможности зависят от локальной политики базы.
25 действий и 6 дополнительных возможностей.
[Начало работы](https://ldo.msrv.tech/docs/n8n/start/) · [Подключение](https://ldo.msrv.tech/docs/n8n/transports/) · [Совместимость](https://ldo.msrv.tech/docs/n8n/compatibility/) · [Для ИИ-агентов](https://ldo.msrv.tech/docs/n8n/agents/)
## Операции
- [Возможности подключённой базы · Get Capabilities](https://ldo.msrv.tech/docs/n8n/operations/get-capabilities/): Получить разрешённые типы объектов, поля чтения и записи, формы и профили процессов. Нода 0.4.1 · Ядро 6.9.
- [Чтение документа · Get Document Fields](https://ldo.msrv.tech/docs/n8n/operations/get-document-fields/): Прочитать выбранные разрешённые поля существующего документа. Нода 0.4.1 · Ядро 6.9.
- [Изменение полей документа · Update Document Fields](https://ldo.msrv.tech/docs/n8n/operations/update-document-fields/): Изменить разрешённые поля существующего непроведённого документа с контролем версии. Нода 0.4.1 · Ядро 6.9.
- [Чтение элемента справочника · Get Catalog Fields](https://ldo.msrv.tech/docs/n8n/operations/get-catalog-fields/): Прочитать разрешённые поля существующего элемента справочника. Нода 0.4.1 · Ядро 6.9.
- [Изменение элемента справочника · Update Catalog Fields](https://ldo.msrv.tech/docs/n8n/operations/update-catalog-fields/): Записать разрешённые поля существующего элемента с ожидаемой версией. Нода 0.4.1 · Ядро 6.9.
- [Поиск значений ссылочного поля · Search Reference Values](https://ldo.msrv.tech/docs/n8n/operations/search-reference-values/): Найти подходящие значения для конкретного разрешённого поля записи. Нода 0.4.1 · Ядро 6.9.
- [Изменение ссылочного поля · Update Reference Field](https://ldo.msrv.tech/docs/n8n/operations/update-reference-field/): Выбрать ссылочное значение по ID, через live-поиск или кэш и записать его в существующий объект. Нода 0.4.1 · Ядро 6.9.
- [PDF документа · Prepare Document PDF](https://ldo.msrv.tech/docs/n8n/operations/prepare-document-pdf/): Сформировать разрешённую печатную форму согласованного документа. Нода 0.4.1 · Ядро 6.9.
- [Запуск внешнего процесса · Start External Process](https://ldo.msrv.tech/docs/n8n/operations/start-external-process/): Создать экземпляр разрешённого профиля процесса для существующего документа. Нода 0.4.1 · Ядро 6.9.
- [Состояние внешнего процесса · Get External Process](https://ldo.msrv.tech/docs/n8n/operations/get-external-process/): Прочитать состояние и значения существующего экземпляра. Нода 0.4.1 · Ядро 6.9.
- [Переход внешнего процесса · Transition External Process](https://ldo.msrv.tech/docs/n8n/operations/transition-external-process/): Выполнить разрешённый переход с ожидаемой версией и необязательными значениями полей. Нода 0.4.1 · Ядро 6.9.
- [Поля внешнего процесса · Update External Process Fields](https://ldo.msrv.tech/docs/n8n/operations/update-external-process-fields/): Изменить разрешённые поля экземпляра с ожидаемой версией. Нода 0.4.1 · Ядро 6.9.
- [Отмена внешнего процесса · Cancel External Process](https://ldo.msrv.tech/docs/n8n/operations/cancel-external-process/): Отменить активный экземпляр с ожидаемой версией. Нода 0.4.1 · Ядро 6.9.
- [Получение событий · Lease Events](https://ldo.msrv.tech/docs/n8n/operations/lease-events/): Взять события approval.started, document.approved или document.rejected в обработку. Нода 0.4.1 · Ядро 6.9.
- [Подтверждение события · Acknowledge Event](https://ldo.msrv.tech/docs/n8n/operations/acknowledge-event/): Подтвердить успешное выполнение прикладного действия. Нода 0.4.1 · Ядро 6.9.
- [Подтверждение доставки PDF · Confirm PDF Delivery](https://ldo.msrv.tech/docs/n8n/operations/confirm-pdf-delivery/): Подтвердить временный файл Relay и затем исходное событие. Нода 0.4.1 · Ядро 6.9.
- [Повтор события · Retry Event](https://ldo.msrv.tech/docs/n8n/operations/retry-event/): Вернуть событие на повтор после временной ошибки. Нода 0.4.1 · Ядро 6.9.
- [Создание своей очереди · Create Connection](https://ldo.msrv.tech/docs/n8n/operations/create-connection/): Создать Data Table и активный gateway workflow, выдать код сопряжения. Нода 0.4.1 · Ядро 6.9.
- [Состояние подключения · Get Status](https://ldo.msrv.tech/docs/n8n/operations/connection-status/): Прочитать сохранённые параметры и состояние подключения. Нода 0.4.1 · Ядро 6.9.
- [Новый код сопряжения · Renew Pairing Code](https://ldo.msrv.tech/docs/n8n/operations/renew-pairing/): Обновить код неиспользованного или отключённого подключения. Нода 0.4.1 · Ядро 6.9.
- [Отключение очереди · Disconnect](https://ldo.msrv.tech/docs/n8n/operations/disconnect-connection/): Отключить ключи сопряжения/обмена и деактивировать gateway. Нода 0.4.1 · Ядро 6.9.
- [Сохранённый результат команды · Get Result](https://ldo.msrv.tech/docs/n8n/operations/get-queue-result/): Получить состояние/результат ранее поставленной команды без создания новой. Нода 0.4.1 · Ядро 6.9.
- [Очистка завершённых записей · Clean Completed Entries](https://ldo.msrv.tech/docs/n8n/operations/clean-completed-entries/): Удалить старые завершённые команды и подтверждённые события текущего scope. Нода 0.4.1 · Ядро 6.9.
- [Поиск документов · Search Documents](https://ldo.msrv.tech/docs/n8n/operations/search-documents/): Найти разрешённые объекты по фильтрам локальной политики без ручного UUID. Нода 0.4.1 · Ядро 6.9.
- [Поиск элементов справочников · Search Catalog Items](https://ldo.msrv.tech/docs/n8n/operations/search-catalog-items/): Найти разрешённые объекты по фильтрам локальной политики без ручного UUID. Нода 0.4.1 · Ядро 6.9.