Перейти к содержанию

Смарт-действия — ЭДО и подписи

⚠️ Символом * помечены обязательные параметры. Часть Справочника смарт-действий; как вызывать действия из SmartScript и типы параметров — там же (Типы данных).

Действия работы с операторами ЭДО (Диадок, СБИС, Контур.КЭДО) и действия подписей/ЭЦП (запрос, резолюция, отзыв, сессии подписания, PKCS#7).

Работа с операторами ЭДО

Диадок

Соответствие подразделов и кодовых имён:

Подраздел Enum ID
Ответить на электронный документ AttachSignature 117
Ответить титулом на электронный документ AttachTitleSignature 133
Отправить подписанное извещение о получении AttachInvoiceReceiptSignature 149
Отправить подписанный отказ от подписи AttachRejectionSignature 118
Отправить подписанный отказ от аннулирования AttachRevocationRejectionSignature 146
Отправить подписанный файл об аннулировании AttachRevocationSignature 128
Отправить подписанный файл соглашения об аннулировании AttachRevocationRequestedSignature 144
Отправить электронный документ SendEdocument 113
Сохранить содержимое документа по ссылке SaveEdocumentContentByLink 114
Получить печатную форму по ссылке SaveEdocumentPrintFormByLink 115
Получить архивную форму по ссылке SaveEdocumentArchiveFormByLink 127
Получить идентификатор МЧД GetUserMCHDDiadoc 165
Получить контрагентов GetCounteragents 164
Получить статус МЧД GetMCHDStatusDiadoc 171
Получить тэги документа GetTagsFromDocument 142
Получить файлы МЧД GetMCHDFilesDiadoc 166
Получить пропущенные документы ReceiveMissedDocDiadoc 150
Сгенерировать xml титул для документа GenerateXmlTitle 132
Сгенерировать пустой xml титул покупателя GenerateXmlBuyerTitle 131
Создать файл аннулирования подписи SaveRevocationFile 143
Создать файл извещения о получении GenerateInvoiceReceiptXml 148
Создать файл отказа от подписи GenerateRejectionSignature 119
Создать файл аннулирования (генерация) GenerateRevocationSignature 129
Создать файл отклонения аннулирования подписи GenerateRejectRevocationSignature 145
Синхронизировать статусы документов в сообщении SyncMessageStatus 163
Universal-сообщения (новый канал):
Отправить подписанный отказ от подписи (Universal) AttachRejectionSignatureUniversal 202
Отправить подписанный отказ от запроса аннулирования (Universal) AttachRevocationRejectionSignatureUniversal 203
Отправить подписанный файл извещения о получении (Universal) AttachInvoiceReceiptSignatureUniversal 204
Создать файл отклонения аннулирования подписи (Universal) GenerateRevocationRejectionSignatureUniversal 205
Создать файл отказа от подписи (Universal) GenerateRejectionSignatureUniversal 206

Диадок - Ответить на электронный документ

Отправка положительного ответа (подписание) без титула

Параметр Тип Описание
ID файла* 1F.File ID файла
ID сервиса* Integer ID сервиса
Подпись* String Подпись (необязательна для серверной подписи в Lua)
МЧД* String МЧД

Диадок - Ответить титулом на электронный документ

Отправка положительного ответа (подписание) с титулом

Параметр Тип Описание
ID файла* 1F.File ID файла
ID xml файла титула* 1F.File ID xml файла титула
ID сервиса* Integer ID сервиса
Подпись* String Подпись
МЧД* String МЧД

Диадок - Отправить подписанное извещение о получении

Отправляет подписанное извещение о получении документа

Параметр Тип Описание
ID файла* 1F.File ID файла с документом
ID файла извещения* 1F.File ID файла извещения
ID сервиса* Integer ID сервиса
Подпись* String Подпись
МЧД* String МЧД

Диадок - Отправить подписанный отказ от аннулирования

Отправляет подписанный файл отказа от аннулирования

Параметр Тип Описание
ID файла* 1F.File ID файла с документом
ID файла отказа* 1F.File ID файла отказа
ID сервиса* Integer ID сервиса
Подпись* String Подпись
МЧД* String МЧД

Диадок - Отправить подписанный отказ от подписи

В ответ на запрошенную подпись отправляет документ с отказом

Параметр Тип Описание
ID файла* 1F.File ID файла
ID файла отказа* 1F.File ID файла отказа
ID сервиса* Integer ID сервиса
Подпись* String Подпись
МЧД* String МЧД

Диадок - Отправить подписанный файл об аннулировании

Отправляет подписанный файл об аннулировании

Параметр Тип Описание
ID файла* 1F.File ID файла
ID файла отказа* 1F.File ID файла аннулирования
ID сервиса* Integer ID сервиса
Подпись* String Подпись
МЧД* String МЧД

Диадок - Отправить подписанный файл соглашения об аннулировании

Отправляет подписанный файл исходящего запроса на аннулирование

Параметр Тип Описание
ID файла* 1F.File ID файла
ID файла отказа* 1F.File ID файла аннулирования
ID сервиса* Integer ID сервиса
Подпись* String Подпись
МЧД* String МЧД

Диадок - Отправить электронный документ

Отправляет документ в Диадок

Параметр Тип Описание
ID файла* 1F.File ID файла
ИНН контрагента* String ИНН
КПП контрагента* String КПП
Нужна ли ответная подпись Boolean Запрос подписи
Тип документа String —
Сумма Money Сумма документа
ID сервиса* Integer ID сервиса
Уникальный идентификатор организации String ID организации
Подпись* String Подпись
МЧД* String JSON: {registerNumber, issuerInn, useDefault}
Номер договора* String ID договора
К договору* String К договору
От (к договору)* String От
Исходный ящик* String Исходный ящик
Дата документа* String Дата
Код валюты* String ISO 4217 строкой (643=RUB, 840=USD, 978=EUR)

Диадок - Получить пропущенные документы

Загрузка пропущенных входящих документов из Диадока (ReceiveMissedDocDiadoc, ID 150). Отображаемое имя действия в конструкторе — «Диадок - Получить документ».

Параметр Тип Описание
MessageId* String ID сообщения
EntityId* String ID сущности
ServiceId Integer ID сервиса (необязательный)

Диадок - Сохранить содержимое документа по ссылке

Сохраняет содержимое электронного документа по ID ссылки (SaveEdocumentContentByLink, ID 114; возвращает FileStorageFileInfo — сохранённый файл 1F.File)

Параметр Тип Описание
ID ссылки на электронный документ* Integer ID ссылки (EdocumentLinks)
ID сервиса* Integer ID сервиса

Диадок - Получить идентификатор МЧД

Получает идентификатор МЧД (возвращает String — идентификатор МЧД)

Параметр Тип Описание
ID пользователя* String UserID в Диадок
ID сервиса* Integer ID сервиса

Диадок - Получить контрагентов

Получает контрагентов (возвращает String — JSON со списком контрагентов)

Параметр Тип Описание
ID сервиса* Integer ID сервиса

Диадок - Получить статус МЧД

Получает статус МЧД (возвращает String — статус МЧД)

Параметр Тип Описание
MessageId* String ID сообщения (поле MessageId в EdocumentLinks)
EntityId* String ID сущности (поле ContentId в EdocumentLinks)
ID сервиса* Integer ID сервиса

Диадок - Получить тэги документа

Получает тэги документа (возвращает String — тэги документа, JSON)

Параметр Тип Описание
ID ссылки на электронный документ* Integer ID ссылки
ID сервиса* Integer ID сервиса

Диадок - Получить файлы МЧД

Получает файлы МЧД (возвращает String — JSON со списком файлов)

Параметр Тип Описание
ID МЧД* String ID МЧД
ID сообщения* String ID сообщения
ID сервиса* Integer ID сервиса

Диадок - Сгенерировать пустой xml титул покупателя

Генерирует пустой xml титул покупателя (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
ID сервиса* Integer ID сервиса
Параметры для титула в формате JSON String —
Параметры для титула в формате JSON в 970 String —

Диадок - Сгенерировать xml титул для документа

Генерирует титульный лист (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
ID xml файла* 1F.File ID xml файла титула
ID сервиса* Integer ID сервиса

Диадок - Синхронизировать статусы документов в сообщении

Актуализация статуса (возвращает JSON, с версии 2.260 Пегас)

Параметр Тип Описание
Список ID сообщений* String Список MessageId
ID сервиса* Integer ID сервиса

Диадок - Создать файл аннулирования (генерация)

Генерирует файл аннулирования из исходного файла и причины (GenerateRevocationSignature, ID 129; возвращает FileStorageFileInfo — файл 1F.File)

Параметр Тип Описание
ID файла* 1F.File ID файла
Причина аннулирования* String Причина
ID сервиса* Integer ID сервиса

Диадок - Создать файл аннулирования подписи

Сохраняет файл аннулирования по ID ссылки на электронный документ (SaveRevocationFile, ID 143; возвращает FileStorageFileInfo — файл 1F.File)

Параметр Тип Описание
ID ссылки на электронный документ* Integer ID ссылки (EdocumentLinks)
ID сервиса* Integer ID сервиса

Диадок - Создать файл извещения о получении

Создает файл извещения (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
ID сервиса* Integer ID сервиса

Диадок - Создать файл отказа от подписи

Создает файл отказа от подписи (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
Причина отказа* String Причина
ID сервиса* Integer ID сервиса

Диадок - Создать файл отклонения аннулирования подписи

Создает файл отклонения аннулирования (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
Причина аннулирования* String Причина
ID сервиса* Integer ID сервиса

Диадок - Создать файл отказа от подписи (Universal)

Расширенная версия с явным отпечатком сертификата (возвращает FileStorageFileInfo). Enum: 206.

Параметр Тип Описание
ID файла* 1F.File ID файла документа контрагента
Причина отказа String Причина отказа (необязательна)
Отпечаток сертификата* String Thumbprint сертификата ЭП в формате HEX
ID сервиса Integer ID сервиса

Диадок - Отправить подписанный отказ от подписи (Universal)

Подписывает и отправляет отказ от подписи с возможностью передать причину напрямую. Enum: 202.

Параметр Тип Описание
ID файла* 1F.File ID исходного документа контрагента
ID файла отказа* 1F.File ID XML-файла отказа (из «Создать файл отказа от подписи (Universal)»)
ID сервиса Integer ID сервиса
Подпись String Подпись в формате Base64
Причина отказа String Текстовая причина отказа
МЧД String МЧД

Диадок - Создать файл отклонения аннулирования подписи (Universal)

Расширенная версия с явным отпечатком сертификата. Enum: 205.

Параметр Тип Описание
ID файла* 1F.File ID документа, по которому пришёл запрос аннулирования
Причина отказа String Причина отклонения аннулирования
Отпечаток сертификата* String Thumbprint сертификата ЭП в формате HEX
ID сервиса Integer ID сервиса

Диадок - Отправить подписанный отказ от запроса аннулирования (Universal)

Подписывает и отправляет отклонение запроса аннулирования. Enum: 203.

Параметр Тип Описание
ID файла* 1F.File ID исходного документа
ID файла отказа* 1F.File ID XML-файла отклонения аннулирования
ID сервиса Integer ID сервиса
Подпись String Подпись в формате Base64
Причина отказа String Текстовая причина отклонения
МЧД String МЧД

Диадок - Отправить подписанный файл извещения о получении (Universal)

Подписывает и отправляет извещение о получении счёта-фактуры. Enum: 204.

Параметр Тип Описание
ID файла* 1F.File ID исходного счёта-фактуры от контрагента
ID файла извещения* 1F.File ID XML-файла извещения (из «Создать файл извещения о получении»)
ID сервиса Integer ID сервиса
Подпись String Подпись в формате Base64
Комментарий String Комментарий к извещению
МЧД String МЧД

Диадок - Пакетная отправка подписей (AttachBatchSignature, ID 207)

Пакетно отправляет подписи/отклонения/аннулирования по массиву документов. Исполняется через очередь событий ЭДО (AddNewEventToEdocumentsQueue).

Параметр Тип Описание
Документы* JSON массив DiadocBatchItem Массив элементов пакета
ID сервиса Integer ID сервиса ЭДО

Диадок - Получить маршруты согласования (GetResolutionRoutes, ID 208)

Возвращает (String, JSON) маршруты согласования из Диадок.

Параметр Тип Описание
ID сервиса Integer ID сервиса ЭДО

Диадок - Создать файл извещения о получении, Universal (GenerateInvoiceReceiptUniversalXml, ID 212)

Создаёт XML-файл извещения о получении по Universal-схеме, возвращает FileStorageFileInfo.

Параметр Тип Описание
ID файла* 1F.File Файл-основание
Отпечаток сертификата* String Хеш сертификата
ID сервиса Integer ID сервиса ЭДО

СБИС

Соответствие подразделов и кодовых имён:

Подраздел Enum ID
Приложить подпись SbisAttachSignature 154
Приложить подпись отказа SbisAttachRejectSignature 155
Приложить подпись аннулирования SbisAttachRevocationSignature 159
Приложить подпись отказа от аннулирования SbisAttachRevocationRejectionSignature 160
Приложить запрошенную подпись аннулирования SbisAttachRevocationRequestedSignature 167
Приложить подпись к счёту-фактуре SbisAttachInvoiceSignature 175
Сохранить содержимое документа SbisSaveDocumentContent 156
Сохранить печатную форму по ссылке SbisSavePrintFormByLink 157
Сохранить архив по ссылке SbisSaveArchiveByLink 158
Получить теги документа SbisGetDocumentTags 161
Отправить электронный документ SbisSendEdocument 162
Сгенерировать подпись отказа GenerateRejectionSbisSignature 168
Сгенерировать титул аннулирования SbisGenerateRevocationTitle 169
Сгенерировать подпись отказа от аннулирования GenerateRevocationRejectionSbisSignature 170
Получить статус МЧД GetMCHDStatusSbis 172
Получить архив МЧД GetMCHDArchiveSbis 173
Сгенерировать счёт-фактуру GenerateInvoiceSbis 174
Получить сертификаты SbisGetCertificates 176
Сгенерировать подпись подтверждения SbisGenerateConfirmSignature 177
Синхронизировать статус сообщения SyncMessageStatusSbis 188

СБИС - Отправить отказ от аннулирования

Отправляет отказ от аннулирования

Параметр Тип Описание
Файлы* Array<{FileId, VersionId, AttachmentId, DocumentId}> Массив объектов
ID сервиса* Integer ID сервиса
Подпись* String Подпись
Комментарий* String Комментарий
МЧД* String МЧД

СБИС - Отправить подписание

Отправляет ответ на электронный документ

Параметр Тип Описание
ID файла* String ID файла
ID сервиса* Integer ID сервиса
Подпись* String Подпись
МЧД* String МЧД

СБИС - Отправить подписанное извещение о получении

Отправляет подписанное извещение

Параметр Тип Описание
ID файла* 1F.File ID файла
ID файла извещения* 1F.File ID файла извещения
ID сервиса* Integer ID сервиса
Подпись* String Подпись
МЧД* String МЧД

СБИС - Отправить подписанные соглашения об аннулировании

Отправляет подписанные соглашения (входящее)

Параметр Тип Описание
Файлы* Array<{FileId, VersionId, AttachmentId, DocumentId}> Массив для вложений со статусом 27
ID сервиса* Integer ID сервиса
Подпись* String Подпись
Комментарий* String Комментарий
МЧД* String МЧД

СБИС - Отправить подписанный отказ от подписи

Отправляет подписанный отказ

Параметр Тип Описание
Файлы (id, versionId, attachmentId)* String Массив объектов
ID сервиса* Integer ID сервиса
Подпись* String Подпись
Комментарий* String Комментарий
МЧД* String МЧД

СБИС - Отправить соглашение об аннулировании

Отправляет соглашение (исходящее)

Параметр Тип Описание
Файлы* Array<{FileId, VersionId, AttachmentId, DocumentId}> Массив для вложений со статусом 27
ID сервиса* Integer ID сервиса
Подпись* String Подпись
Комментарий* String Комментарий
МЧД* String МЧД

СБИС - Отправить электронный документ

Отправляет документ в СБИС

Параметр Тип Описание
ID файла* 1F.File ID файла
ИНН контрагента* String ИНН
КПП контрагента* String КПП
Уникальное ID контрагента* String ID контрагента
Нужна ли ответная подпись Boolean Запрос подписи
Тип документа — —
Сумма Money Сумма
ID сервиса* Integer ID сервиса

СБИС - Получить архив МЧД

Запрос архива МЧД (возвращает System.Int32)

Параметр Тип Описание
Идентификатор МЧД* String ID МЧД
ИНН доверителя* String ИНН доверителя
ИНН представителя* String ИНН представителя
ID сервиса* Integer ID сервиса

СБИС - Получить сертификаты

Запрос слепка сертификата (возвращает String — данные сертификатов)

Параметр Тип Описание
ID сервиса* Integer ID сервиса
Идентификатор String ID сотрудника в СБИС
Идентификатор в ИС String ID во внешней системе
ИНН String ИНН сотрудника
Телефон String Телефон
Email String Email
СНИЛС String СНИЛС
Серия документа String Серия
Номер документа String Номер

СБИС - Получить статус МЧД

Получает статус МЧД (возвращает String — статус МЧД)

Параметр Тип Описание
Идентификатор МЧД* String ID МЧД
ID сервиса* Integer ID сервиса

СБИС - Получить тэги документа

Получает тэги документа (возвращает String — тэги документа, JSON)

Параметр Тип Описание
ID ссылки на электронный документ* Integer ID ссылки
ID сервиса* Integer ID сервиса

СБИС - Синхронизировать статусы документов в сообщении

Актуализация статуса (с версии 2.262 Весы)

Параметр Тип Описание
Список ID сообщений* String Список DocumentId
ID сервиса* Integer ID сервиса

СБИС - Создать файл аннулирования подписи

Создает файл аннулирования (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
Причина аннулирования* String Причина
Отпечаток сертификата* String Хеш сертификата
ID сервиса* Integer ID сервиса
МЧД* String МЧД

СБИС - Создать файл извещения о получении

Создает файл извещения (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
Отпечаток сертификата* String Хеш сертификата
ID сервиса* Integer ID сервиса
МЧД* String МЧД

СБИС - Создать файлы отказа от аннулирования

Создает файлы отказа (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
Причина отказа* String Причина
Отпечаток сертификата* String Хеш сертификата
ID сервиса* Integer ID сервиса
МЧД* String МЧД

СБИС - Создать файлы отказа от подписи

Создает файлы отказа (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
Причина отказа* String Причина
Отпечаток сертификата* String Хеш сертификата
ID сервиса* Integer ID сервиса
МЧД* String МЧД

СБИС - Создать файлы подтверждения подписи

Создает файлы подтверждения (возвращает FileStorageFileInfo)

Параметр Тип Описание
ID файла* 1F.File ID файла
Причина* String Причина
Отпечаток сертификата* String Хеш сертификата
ID сервиса* Integer ID сервиса
МЧД* String МЧД

Контур.КЭДО

Контур.КЭДО - Получить список сотрудников (KonturKEDOGetUsersList, ID 209)

Возвращает (String, JSON) список сотрудников из Контур.КЭДО (KonturCloudService.GetUsersList). Параметров нет.


Подписи

Запросить динамическую подпись (RequestDynamicSignature, ID 13)

Запрашивает подпись (в любом непереходящем статусе задачи). Подпись становится в очередь акцептантам, задача ждёт резолюции.

Параметр Тип Описание
Задача* 1F.Task —
Запрашивающий пользователь* 1F.User От чьего имени запрашивается подпись
Подпись* 1F.Signature Шаблон подписи (Signatures) с разрешённой «Может быть динамической»
Причина String —
Срок Integer Дедлайн вынесения резолюции
Не дублировать подпись* Boolean Не запрашивать повторно, если подпись уже запрошена

Запросить динамическую пользовательскую подпись (RequestDynamicUserSignature, ID 51)

Динамическая подпись с явным списком акцептантов (вместо настроенных в шаблоне).

Изменить причину ЭЦП (DSignChangeReason, ID 46) / Изменить срок ЭЦП (DSignChangeDueDate, ID 47)

Редактирование уже запрошенной подписи (без отзыва).

Резолюция по подписи задачи (TaskSignatureResolution, ID 123)

Программно вынести резолюцию (от имени пользователя). Используется для автоматизации согласований по условиям.

Параметр Тип Описание
Подпись* 1F.TaskSignature Запрошенная подпись
Резолюция* 1F.SignatureResolution Тип резолюции (Согласовано / Отклонено / Возврат и т. п.)
Комментарий String —
От пользователя 1F.User —
Акцептанты Collection<1F.User> Делегаты/акцептанты для резолюции (опционально)

Не смешивать со служебным инструментом агента с тем же именем: выше описано смарт-действие автоматизации, а его " "агентский аналог работает с открытой карточкой задачи и в пользовательском хелпе не описывается.

Отозвать подписи (RevokeSignatures, ID 48) / Удалить запрошенную подпись (RemoveRequestedSignature, ID 73)

Отзывает все или одну запрошенную подпись задачи.

Параметры «Удалить запрошенную подпись» (RemoveRequestedSignature, 73):

Параметр Тип Описание
От чьего имени совершается действие* 1F.User Инициатор
Идентификатор подписи в задаче* Integer ID запрошенной подписи
Причина String Причина удаления

Добавить акцептанта ЭЦП (DSignAddAcceptant, ID 45)

Добавляет дополнительного акцептанта к уже запрошенной подписи.

Начать новую сессию подписания ЭЦП (StartNewEdsSession, ID 99)

Запускает сессию ЭЦП для группы подписей (используется при пакетном подписании в КриптоПро / DSS / PayControl / Контур.Облако).

Приложить подпись (AttachSignature, ID 117) / Приложить подпись отказа (AttachRejectionSignature, ID 118) / Приложить подпись аннулирования (AttachRevocationSignature, ID 128) / Приложить подпись отказа от аннулирования (AttachRevocationRejectionSignature, ID 146)

Прикрепляет соответствующую подпись к задаче. Используется в пайплайнах ЭДО (Диадок/СБИС) — см. отдельный раздел.

Сгенерировать подпись отказа (GenerateRejectionSignature, ID 119) / аннулирования (GenerateRevocationSignature, ID 129)

Создание PKCS#7-подписей отказа/аннулирования для последующей передачи в ЭДО.