# Настроить модуль «Диадок 2.0»
> [HTML Version](configure-diadoc-solution.html)
````
Начало внимание
````
Для корректной работы **Диадок 2.0** выключите [предыдущую его версию](diadoc_main.md).
````
Конец внимание
````
Перейдите в раздел **Администрирование** **>** **Модули**. Вверху страницы в блоке **Пользовательские модули** найдите модуль **Диадок 2.0** и нажмите на него.
На открывшейся странице настройки задаются в блоках:
1. [Настройка ELMA365](#configure-elma365) — синхронизировать ELMA365 и Диадок.
2. [Настройки Диадок](#configure-diadoc) — подключиться к Диадок, активировать используемые опции и настроить сопоставление типов документов.
3. [Работа с пакетами документов](#package) — указать бизнес-процесс для автоматического запуска при получении входящего пакета документов из Диадок.
4. [Синхронизация](#synchronize) — определить параметры синхронизации данных между ELMA365 и Диадок.
Для применения заданных настроек [сохраните их](#save-settings).
## Шаг 1. Синхронизировать ELMA365 и Диадок
Заполните поля:
**(diadoc-solution-1.png)**
- **API ключ ELMA365\*** — вставьте в это поле токен. Предварительно создайте его и скопируйте в разделе **Администрирование** **>** **Токены**. Подробнее об этом читайте в статье [«Токены»](360016488452.md);
- **Адрес ELMA365\*** — укажите URL-адрес главной страницы ELMA365, куда вы установили **Диадок 2.0**.
## Шаг 2. Настроить Диадок
В блоке **Настройки Диадок**:
- укажите данные, чтобы [подключиться к аккаунту Диадок](#diadoc-login);
- включите [дополнительные опции](#options) для работы с документами;
- [синхронизируйте типы документов](#synchronize-documents) и создайте сопоставления для них;
- [проверьте соединение с Диадок](#check-diadoc-connection).
**(diadoc-solution-2.png)**
### Настроить авторизацию в Диадок
Чтобы предоставить пользователям право отправлять документы в Диадок, настройте авторизацию для их аккаунтов. Это можно сделать одним из способов:
1. **Использовать персональную авторизацию**.
В этом случае пользователи сами вносят данные своего аккаунта в Диадок, когда работают с документом в рамках бизнес-процесса или через виджет.
Авторизация действует три минуты. По истечении этого времени пользователь вводит логин и пароль повторно.
**Важно**: если вы используете персональную авторизацию, в таблице **Аккаунты пользователей** укажите для учётной записи в ELMA365 данные одного аккаунта в Диадок. При этом у такого аккаунта должен быть доступ ко всем документам организации. Без этого нельзя [синхронизировать типы документов](#synchronize-documents).
2. **Сопоставить учётные записи в ELMA365 c аккаунтами в Диадок**.
Внесите в таблицу **Аккаунты пользователей** логины и пароли в Диадок тех пользователей, которые смогут выполнять задачи в ELMA365 по обработке документов.
Для юридического лица, зарегистрированного в Диадок, можно создать несколько учётных записей. Каждую учётную запись в Диадок можно связать с конкретным пользователем, группой пользователей или элементом оргструктуры из ELMA365. Например, для группы пользователей **Руководители** можно настроить одну учётную запись в Диадок. Тогда все сотрудники, входящие в эту группу, смогут работать с документами в Диадок.
В таблице заполните поля:
- **Юридическое лицо** — выберите организацию из системного справочника **Мои юридические лица**, от имени которой будут выполняться действия в Диадок;
- **Логин** — введите логин учётной записи в Диадок;
- **Пароль** — укажите пароль учётной записи в Диадок;
- **Пользователи** — выберите пользователя, группу или элемент оргструктуры, которым предоставляете право подписывать и отправлять документы от данного аккаунта в Диадок.
Вы можете удалить строку таблицы, нажав значок корзины.
### Указать дополнительные настройки
После подключения аккаунта Диадок вы можете активировать опции:
- **Использовать трехстороннее подписание** — включите опцию, если в вашем аккаунте Диадок активировано [подписание документа тремя сторонами](https://support.kontur.ru/diadoc/40520-trexstoronnyaya_podpis). Тогда в карточке задачи, которая формируется с помощью блока **Диадок отправить документ**:
- в поле **Контрагент** выбирается основной получатель;
- дополнительно отображается опция **Использовать трехстороннее подписание**. Пользователь может включить её и [указать промежуточного контрагента](send-document-diadoc-2.md#three-signatures);
- **Сделать заполнение доверенностей обязательным** — включите опцию, если на стороне Диадок вы оформили доверенность для подписанта. В таком случае пользователю нужно [приложить свою доверенность](send-document-diadoc-2.md#power-of-attorney), чтобы отправить документ в Диадок.
Если опция выключена, пользователь может выполнить задачу по отправке без добавления доверенности;
- **Ограничить синхронизацию исходящих документов** — активируйте опцию, чтобы отключить загрузку в ELMA365 документов, которые созданы в Диадок.
При выключенной опции в приложение ELMA365 импортируются все документы, которые подходят его [сопоставлению](#conformity-of-documents), заданному в настройках модуля. Например, в кабинете Диадок пользователь создаёт исходящий договор. Если для документа настроено сопоставление, он автоматически добавится в приложение ELMA365;
- **Использовать только универсальные сообщения** — включите опцию, чтобы при отказе от подписания или аннулирования документа генерировалось универсальное сообщение — обязательный XML-файл, который содержит информацию об отказе. Универсальные сообщения планируются к вступлению в силу в июле 2026 г. До этого момента оставьте опцию выключенной, иначе пользователи увидят ошибку при попытке отказа от подписания или аннулирования документа.
Пока опция не активна, для операций аннулирования и отказа от подписания параллельно создаются два типа служебных документов:
- отказ от подписи — используется только до вступления в силу универсальных сообщений;
- универсальные сообщения — подробнее читайте на [официальном сайте Диадок](https://www.diadoc.ru/articles/84072-universalnye_soobshheniya).
### Синхронизировать типы документов
После заполнения данных в блоках **Настройка ELMA365** и **Настройки Диадок** нажмите **Синхронизировать типы документов**, чтобы получить данные из Диадок и ELMA365 для дальнейшей настройки.
### Настроить соответствие документов
Откройте блок **Соответствие документов**, нажав значок **(configure-diadoc-solution-1.png)**. В этом блоке:
- [выберите приложение типа Документ](#elma-app) из ELMA365 для участия в обмене документами с Диадок;
- укажите бизнес-процесс для [обработки входящего документа](#process) или для рассмотрения [запроса на аннулирование документа](#incoming-cancelation);
- [сопоставьте свойства](#attributes) выбранного приложения из ELMA365 и атрибуты в Диадок;
- [соотнесите статусы](#statuses) приложения типа **Документ** из ELMA365, которые отвечают за те же этапы жизненного цикла документа, что и статусы в Диадок.
Чтобы настроить соответствие документов:
1. Нажмите кнопку **Создать сопоставление**.
**(diadoc-solution-3.png)**
2. В открывшемся окне заполните поля:
**(diadoc-solution-4.png)**
- **Наименование для сопоставления** — рекомендуется давать наименование по названию приложения или документа, для которого создаётся сопоставление, чтобы упростить дальнейшую работу и поиск.
Это наименование отображается в задаче **Диадок отправить документ** в поле **Вид документа для отправки**, если в нескольких сопоставлениях вы [укажете](#elma-app) одно и то же приложение ELMA365;
- **Направление** — выберите документопоток в ELMA365, с которым будете работать:
- **Входящий** — документы, полученные от контрагента из Диадок;
- **Исходящий** — документы, загружаемые в Диадок для отправки контрагенту;
- **Тип документа** — выберите тип документа в Диадок. Подробнее с перечнем документов можно ознакомиться на [официальном сайте Диадок](https://www.diadoc.ru/docs/laws/doctypes).
Обратите внимание, для входящих документов доступен тип **Нераспознанный документ**. Используйте его в качестве универсального сопоставления, чтобы поступающие в Диадок документы создавались в ELMA365. Например, когда вы тестируете входящий документопоток без детальной [настройки атрибутов](#attributes);
- **Функция** — укажите функцию, которая соответствует выбранному типу документа. Например, для типа документа **Договор** выберите функцию **Contract\_default**.
Поле опционально при настройке сопоставления для исходящего документа;
- **Приложение ELMA** — выберите [приложение типа Документ](360009923631.md). Если в поле **Направление** установлено **Входящий**, в это приложение поступают документы от контрагента из Диадок. При выборе опции **Исходящий** — в приложении создаются документы, которые вы отправляете контрагентам через Диадок.
Для исходящего документопотока вы можете [ограничить синхронизацию](#options), чтобы в приложение ELMA365 сохранялись только документы, созданные в системе. Тогда исходящие документы, добавленные в кабинете Диадок, не будут автоматически импортироваться в приложение ELMA365, даже если для них настроено сопоставление.
Одно приложение из системы ELMA365 можно указать в настройках сопоставления нескольких исходящих документов. Например, договор и дополнительные соглашения к нему хранятся в приложении **Исходящие договоры**. Оно выбирается при настройке сопоставлений и для договора, и для дополнительного соглашения. В таком случае в карточке задачи в поле **Вид документа для отправки** отобразятся наименования подходящих сопоставлений. В зависимости от направляемого документа пользователь [выбирает нужный вариант](send-document-diadoc-2.md#doc-type);
- **Версия документа для создания** — укажите версию для выбранного типа документа. В Диадок может создаваться новая версия для любого типа документа. Чаще всего это связано с изменением законодательства в сфере документооборота. Пример смотрите на [официальном сайте Диадок](https://www.diadoc.ru/blog/7972).
Поле опционально при настройке сопоставления для исходящего документа.
3. Далее для входящего документа отобразятся дополнительные поля, где можно указать процесс его обработки:
(diadoc-solution-7.PNG)
- **Бизнес процесс для входящего документа** — для выбора доступны процессы, созданные на уровне приложения, указанного выше в поле **Приложение ELMA365**;
- **Поле для передачи документа** — укажите переменную процесса типа **Приложение**, связанную с приложением типа **Документ** в ELMA365, для которого вы настраиваете сопоставление.
Если настройки заданы, то выбранный процесс можно запустить для документа, полученного из Диадок.
Вы можете настроить получение, отправку и подписание документов в бизнес-процессах, используя [графические элементы](reject-document-diadoc-2.md), предназначенные для решения **Диадок версии 2.0**.
4. Вы можете настроить автоматический запуск бизнес-процесса в ELMA365 каждый раз, когда контрагент отправляет запрос на аннулирование документа в Диадок. Для этого заполните поля:
**(diadoc-solution-10.png)**
- **Бизнес процесс для входящего аннулирования** — выберите настроенный процесс для обработки входящего аннулирования из Диадок. Такой процесс создаётся на уровне приложения, указанного в поле [Приложение ELMA365](#elma-app);
- **Поле для передачи документа** — укажите переменную типа **Приложение** из контекста процесса. При создании этой переменной укажите приложение типа **Документ**, для которого вы настраиваете сопоставление.
5. Соотнесите свойства приложения типа **Документ** в ELMA365 и все атрибуты, использующиеся в Диадок. В противном случае работа с документами невозможна.
**Важно**: атрибуты в Диадок и свойства в ELMA365 должны соответствовать по типу данных. Например, если регистрационный номер хранится в ELMA365 как строка, его нельзя сопоставить с числовым полем Диадок.
Учитывайте особенности сопоставления атрибутов, в которых хранится денежная сумма. Атрибут в Диадок **Сумма (Деньги)** соответствует свойству типа **Деньги (Российский рубль)** из ELMA365. Для атрибутов с суммами в других валютах используются свойства **Строка** или **Число**.
Занесите в таблицу каждое свойство по отдельности:
**(diadoc-solution-5.png)**
- **Атрибут ELMA** — укажите свойство приложения типа **Документ**;
- **Атрибут Диадок** — выберите переменную, которая соответствует указанному выше свойству ELMA365.
Для сохранения записи в таблице нажмите **Добавить**. Чтобы удалить строку таблицы, нажмите значок корзины.
6. Соотнесите статусы приложения типа **Документ** в ELMA365 и документа в Диадок по такому же принципу, как на предыдущем шаге.
Например, статусу **Подписан** в Диадок может соответствовать статус **Подписан контрагентом** в приложении ELMA365. Если в Диадок статус изменится, также поменяется статус элемента приложения в системе.
**(diadoc-solution-8.png)**
7. После заполнения всех полей нажмите кнопку **Создать**.
8. В блоке **Соответствие документов** напротив поля **Сопоставление документов** нажмите на значок лупы. Выберите все приложения, для которых вы создали сопоставления. Они будут участвовать в обмене документами с Диадок.
9. В блоке **Соответствие документов** можно внести изменения в настроенные сопоставления. Для этого нажмите **Редактировать сопоставление**. В открывшемся окне выберите созданное ранее сравнение для структуры документа. Оно загрузится на странице.
### Проверить соединение с Диадок
Вы можете проверить подключение аккаунта к Диадок, доступность МЧД, а также корректную отправку настроенных сопоставлений документов. Для этого:
1. В блоке **Настройки Диадок** под таблицей** Аккаунты пользователей** нажмите **Проверить соединение с Диадок**.
2. В открывшемся окне выберите один из [аккаунтов пользователей](#diadoc-login) и нажмите **Проверить доступ**.
**(configure-diadoc-solution-2.png)**
3. В случае успешного соединения с Диадок вы увидите:
- название подключённой организации;
- типы документов, для которых [настроены сопоставления](#conformity-of-documents).
**(configure-diadoc-solution-3.png)**
4. Вы можете проверить отправку файлов в Диадок на одном из доступных неформализованных документов. Для этого в поле **Тип документа для отправки тестового черновика** выберите настроенное сопоставление и прикрепите файл черновика. Нажмите **Отправить тестовый черновик**.
5. Чтобы проверить доступность МЧД, в поле **Абонентский ящик** укажите идентификатор абонентского ящика на стороне Диадок, для которого настроена доверенность. Затем нажмите **Проверить доступные МЧД**.
## Шаг 3. Настроить работу с пакетами документов
В этом блоке можно указать бизнес-процесс для обработки входящего пакета документов из Диадок. Чтобы пользователь мог ознакомиться со всеми файлами пакета, убедитесь, что вы [настроили соответствия](#conformity-of-documents) для них. Когда поступит пакет документов из Диадок, процесс автоматически запустится. В ELMA365 создадутся элементы приложений типа **Документ**, которые сопоставлены с входящими файлами пакета.
**(diadoc-solution-9.PNG)**
- **Бизнес процесс для пакета документов** — для выбора доступны процессы, в контексте которых есть переменная типа **Произвольное приложение** с подтипом **Несколько**. Укажите процесс для обработки входящего пакета документов. Например, вы можете настроить подписание с помощью блока [Диадок подписать пакет документов](sign-document-diadoc-2.md).
**Важно**: чтобы с помощью этого блока пользователь мог разом подписать весь пакет, требуются настроенные сопоставления для каждого документа, входящего в его состав;
- **Атрибут бизнес процесса для передачи пакета документов** — выберите переменную типа **Произвольное приложение** с подтипом **Несколько**, в которую запишутся документы из полученного пакета. Обратите внимание, чтобы документы пакета сохранились в этой переменной, настройте для них соответствия. В результате:
1. Используя эту переменную, вы можете отобразить ссылки на документы пакета в рамках одного из этапов процесса, например на форме пользовательской задачи.
2. Если для рассмотрения входящего пакета используется блок **Диадок подписать пакет документов**, ссылки на сопоставленные файлы пакета автоматически отобразятся в задаче подписания.
Кроме того, пользователи могут посмотреть состав входящего пакета в [виджете Статус документа Диадок](work-in-diadoc-solution.md#package). Для этого разместите его в карточке документа.
Обратите внимание, если в виджете рядом с надписью **Состав пакета документов** отображается значок **(diadoc-solution-11.png)**, то видны не все файлы пакета. Чтобы пользователи могли ознакомиться с полным составом пакета, настройте сопоставления для необработанных файлов и повторно запустите синхронизацию данных.
## Шаг 4. Задать параметры синхронизации
Синхронизация позволяет своевременно обмениваться данными между ELMA365 и Диадок. В этом блоке доступны следующие настройки:
**(diadoc-solution-6.png)**
1. **Статус синхронизации **— можно включить синхронизацию данных в фоновом режиме, а также выполнить разовую загрузку выбранных документов. Для этого используйте действия:
- **Запустить фоновые задачи** — отправлять запросы в Диадок каждые три минуты и обновлять данные в ELMA365 для всех сопоставленных документов.
Чтобы не получать новые документы из Диадок, нажмите кнопку **Остановить фоновые задачи**;
- **Запустить частичную синхронизацию** — [обновить только выбранные документы](#partial-synchronization).
Частичную синхронизацию можно использовать одновременно с фоновой загрузкой данных. В задаче синхронизации вы можете задать условия отбора документов, что значительно сокращает время обновления данных. После загрузки подходящих документов процесс завершится.
2. **Логирование** — для диагностики проблем в работе модуля можно регистрировать возникающие ошибки. Данные сохранятся в разделе **Диадок Модуль > Логи** в виде элементов приложения. Вы можете включать логирование в модуле на 5-15 минут. Это позволит собрать нужные данные и не перегружать оперативную память.
Для этого активируйте опцию **Включить логирование синхронизации** и выберите, какие записи отслеживать: логирование синхронизации, внешних запросов или внутренних запросов.
3. **Дополнительные параметры **— вы можете управлять количеством событий, которые поступают из Диадок и обрабатываются в ELMA365 при синхронизации данных в рамках одного запроса. Это позволит стабилизировать нагрузку на ресурсы и предотвратить сбои в работе системы. Настройка доступна для всех поставок, но зачастую применяется при использовании модуля **Диадок 2.0** в поставках ELMA365 On-Premises.
Рекомендуемые значения параметров для синхронизации данных при использовании модуля Диадок 2.0
1. В поставках ELMA365 SaaS рекомендуется использовать стандартные значения параметров:
- **Максимальное количество получаемых событий** — 10;
- **Максимальное количество обрабатываемых событий** — 25;
- **Максимальное количество контрагентов** — 100.
2. В поставках ELMA365 On-Premises при стандартных мощностях и стабильной работе модуля **Диадок 2.0** можно применить следующие значения:
- **Максимальное количество получаемых событий** — 20;
- **Максимальное количество обрабатываемых событий** — 20;
- **Максимальное количество контрагентов** — 200.
3. Если в ELMA365 On-Premises при синхронизации возникают ошибки по таймауту, уменьшите значения в параметрах:
- **Максимальное количество получаемых событий** — 10;
- **Максимальное количество обрабатываемых событий** — 10;
- **Максимальное количество контрагентов** — 100.
4. **Задать дату повторного обновления** — если пропадёт связь, возникнет ошибка при обмене документами. Чтобы обновить данные:
1. Укажите дату обновления и нажмите кнопку **Запомнить дату**.
2. Нажмите **Запустить фоновые задачи**. Синхронизируются данные за период с даты обновления по текущее число.
3. После обновления данных в настройках отобразится информация об успешной синхронизации.
````
Начало внимание
````
Чем более раннюю дату вы выберете, тем больше времени может занять синхронизация. Вы можете продолжить работу с модулем, не дожидаясь окончания обновления данных.
````
Конец внимание
### ````
Запустить частичную синхронизацию данных
Вы можете получить актуальные значения атрибутов, статусов и файлов из Диадок только для выбранных документов. Для этого в блоке **Статус синхронизации** нажмите **Запустить частичную синхронизацию**. Вам поступит задача **Установить фильтр частичной синхронизации**, в которой:
1. Выберите тип синхронизации:
- **Синхронизация ранее загруженных документов** — обновить ранее загруженный документ и получить статусы или значения дополнительных полей, если вы [сопоставили их в настройках модуля](#attributes) после первичной загрузки документа;
- **Загрузка документа по атрибутам** — получить из Диадок определённый документ. Предварительно убедитесь, что в модуле вы [настроили для него сопоставление](#conformity-of-documents) по типу и направлению;
- **Загрузка документов по сопоставлениям** — получить из Диадок не загруженные ранее документы по определённым критериям отбора: сопоставлениям и дате документов.
Внесите информацию для выбора документов, которые будут обновляться. Поля для заполнения отличаются в зависимости от выбранного типа синхронизации.
2. Для типа **Синхронизация ранее загруженных документов** укажите:
**(diadoc-solution-12.png)**
- **Сопоставление документов\*** — выберите сопоставления, по которым нужно обновить документы;
- **Дата с**, **Дата по** — определите, документы с какой датой создания нужно обновить;
- **Синхронизировать статус?** — выберите **Да**, чтобы загрузить актуальные статусы синхронизируемых документов;
- **Обновить файл?** — выберите **Да**, чтобы загрузить актуальные печатные формы синхронизируемых документов;
- **Количество обрабатываемых элементов за раз** — определите, сколько элементов приложения обновится в одном запросе. Рекомендуем устанавливать значение не больше 20. Количество запросов зависит от общего числа документов, которые синхронизируются в рамках задачи. Запросы отправляются один раз в три минуты.
3. Для типа **Загрузка документа по атрибутам**:
1. В личном кабинете Диадок скопируйте ссылку на документ, который нужно загрузить.
2. Перейдите в ELMA365 и в карточке задачи синхронизации в поле **Ссылка Diadoc** добавьте скопированную ссылку.
После этого поля **Идентификатор абонентского ящика\***, **Идентификатор сообщения\*** и **Идентификатор документа\*** заполнятся автоматически.
4. Для типа **Загрузка документов по сопоставлениям** заполните поля:
- **Сопоставление документов\*** — выберите сопоставления, по которым добавятся документы в приложения ELMA365;
- **Дата с**, **Дата по** — определите, документы с какой датой создания загрузить.
5. Нажмите **Запустить синхронизацию**.
## Шаг 5. Сохранить заданные настройки
Когда вы установите параметры в блоках **Настройка ELMA365**, **Настройки Диадок**, **Работа с пакетами документов** и выполните настройку синхронизации, нажмите **Сохранить** внизу страницы.