12 KiB
Диадок
Описание
Диадок — это система юридически значимого электронного документооборота. Пользователи сервиса подписывают документы квалифицированной электронной подписью и обмениваются ими с контрагентами без дублирования на бумаге.
Настройка работы Диадока
Для интеграции системы с сервисом Диадок необходимо настроить следующие библиотеки:
- Диадок
- диадок-Сервис
Подключение библиотек
В настройках конфигурации сайта (конфиги) прописываются настройки сервиса Диадок для каждой организации. Прописываются такие параметры как:
- путь
- логин
- пароль
- ключ который предоставляется Контур.Диадок при заключении договора организации с диадоком (API-ключ для интеграции с Контур.Диадок)
Ниже приведен скрин с примером:
Работа Диадока
Для работы Диадока необходимо настроить задания планировщика:
- Загрузка boxid - это идентификаторы на которые будут отправляться и приниматься контрагенты.
- Обновление статусов - считывает текущие статусы контрагента (принятые, подписанные, аннулированные и т.д).
- Загрузка новых событий - факты подписания документов контрагентов и загрузка файла.
Для работы с Диадоком в Лексеме необходимо иметь определенную роль, подробнее можно ознакомиться в разделе Технические роли.
В системе имеется 2 формы Диадока:
Документы Диадока - форма документа которая хранит все данные о том что отправляли или принимали по Диадоку.
Реестр документа Диадока - аналитическая форма, она необходима для оптимизированной работы документов по Диадоку.
Создание документа Диадока происходит автоматически в процессе отправки документа в Диадок. Система автоматически заполняет всю информацию по документу.
Имеется 2 вида документов Диадока:
- Входящие документы - формируются по задачи шедулера по проверке новых событий в ящике "Диадок".
- Исходящие документы - формируются из формы документа "Договор" и "Доп. Соглашения" к договору.
При отправке договора или доп. соглашения в Диадок, система определяет кем был подписан докумен подписью КЭП и вместе с файлом во вложении отправляется в диадок. Если на сотрудника подписавшего документ, существует действующая МЧД, ЭДО то в диадок отправляется идентификатор доверенности.
После того как договор был подписан, в документ вкладывается скан-файл с типом вложения "Оригинал PDF". На каждое вложение формируется новый документ Диадок. Ему присваивается Messageid и Entityid.
??? Информация
Messageid — уникальный идентификатор, который используется для идентификации сообщений.
Entityid - это уникальный идентификатор, который используется для однозначного представления сущности (объекта) в системе или контексте, где она существует.
Чтобы отправить договор в Диадок необходимо по кнопке "Операции" в панели управления выбрать строку "Отправить документ в Диадок". Подробнее о данных строках можно ознакомиться в разделе Работа Диадока.
После выбора действия "Отправить документ в Диадок" в реестре "Документы Диадок" формируется новый исходящий документ, в котором автоматически заполняются информация:
- от имени какой организации отправился документ и какой организации отправился (строка идентификатор ящика отправителя)
- с какого ящика диадок отправился и на какой ящик другой организации (строка идентификатор ящика получателя)
- строка с именем файла отправленного с документом (строка файл)
Так же по кнопке "Перейти" есть возможность перейти в договор или Доп. Соглашение отправленного в Диадок.
Настройка интеграции с Диадок
Система автоматически загрузит в раздел "Реквизиты Диадока" реквизиты контрагента по задачам загрузки boxid, Guid и таблицу с информацией о том с каким юридическим лицом интегрированы по Диадоку. Проще говоря, это те контрагенты которые приняли приглашение для обмена по Диадоку с указанным контрагентом в строке "Идентификатор участника ЭДО".
В карточке контрагента на вкладке "Настройка интеграции с Диадок" указана информация по данному контрагенту в системе Диадока:
Если необходимо указать инедтификатор участника ЭДО, отличный от того который загружен автоматически, то необходимо заполнить поле "Идентификатора" участника ЭДО. Для редактирования этого поля у пользователя должна быть роль responsible_accountant_diadoc.
- Идентификатор участника ЭДО - поле с запросом которое выводит реквизиты по контрагенту из Диадока
- идентификатор участника ЭДО сверен - чекбокс признак необходимый для того чтобы другой идентификатор не загружался в систему.
Далее необходимо нажать кнопку "Загрузить реквизиты из Диадока".
boxid (ручной ввод) - заполняется в ручную в случае если необходим для работы с ним один конкретный ящик, а у контрагента имеется разное множество ящиков.
boxid (загруженный) - строка которая заполняется автоматически при работе задачи "Загрузка boxid ящиков Диадок контрагентов"
??? Пример "Пример JSON формата данных контрагента"
```json
"OrgIdGuid": "0581-JHY-862",
"OrgId": "0581-JHY-8620", --Guid
"Inn": "1234567890",
"Kpp": "1234567890",
"FullName": "Акционерное общество \"Радуга\"",
"ShortName": "АО \"Радуга\"",
"JoinedDiadocTreaty": true,
"Boxes": [
{
"BoxId": "111abc654@diadoc.ru", --boxId
"BoxIdGuid": "111abc-654",
"Title": "АО \"Радуга\"",
"InvoiceFormatVersion": "v5_02",
"EncryptedDocumentsAllowed": false
}
],
"Ogrn": "1234567890",
"FnsParticipantId": "2BH47rDA", --Идентификатор учатсника ЭДО
```
При нажатии на кнопку "Операции" в документе договор или доп. соглашение, имеются две операции:
- Отправить в Диадок - документ направляется в систему Диадока c помощью сервиса API, где его при необходимости возможно отредактировать.
- Отправить в Диадок шаблон - отправляется шаблон документа который не возможно редактировать.
В окне "История" в панели управления документа Диадока показывается история документа, например "Ожидается подпись контрагентом", "Подписан контрагентом", "Аннулирован контрагентом" и т.п.
Также во вложении будет файл, который имеет подписание с двух сторон с водяным знаком.
При каждой новой отправке в Диадок система отправляет те файлы, которые не были отправлены ранее, с последней подписью КЭП.