К содержимому
← Вернуться в блог

Сценарий подписания документов в DigiDoc: как спроектировать и проверить файлы

Сценарий подписания документов в DigiDoc — это не только кнопка «подписать» в DigiDoc4. Это последовательность действий, в которой есть стороны, роли, порядок шагов, точки проверки и правила поведения при сбое. Если продумать только техническую часть, документ может быть подписан, но не принят: не тот формат контейнера, не хватает подписи, неясно, кто и когда проверил файл. Ниже — практический разбор того, как спроектировать сценарий подписания документов и проверить файлы в DigiDoc так, чтобы результат принимали с первого раза. Общая логика одинакова и для одного договора, и для регулярного потока первичных документов, который описывается в материале об организации обработки первичных документов и подготовке отчётных материалов.

Что именно вы проектируете: два слоя одного сценария

У любого сценария подписания есть организационный слой и технический. Организационный отвечает на вопросы «кто, когда, в каком порядке, что делать при сбое». Технический — «какие файлы участвуют, в каком инструменте открываются, как выглядит корректный результат». Ошибки чаще возникают на стыке: например, порядок шагов описан, а критерий «документ принят» — нет.

DigiDoc в Эстонии — это контейнер, внутри которого лежат исходный документ или несколько документов и подписи. Встречаются контейнеры с расширением .ddoc и .asice; конкретный формат, который устроит принимающую сторону, лучше уточнить заранее, а не после подписания. Внутри контейнера могут быть также отметки времени — они фиксируют момент, когда подпись существовала. Нужна ли такая отметка в вашем случае, зависит от требований принимающей стороны, а не от привычки исполнителя.

Перед стартом полезно письменно ответить на набор вопросов. Это дешевле, чем переделывать поток документов.

  • Кто стороны и сколько всего подписантов — один, двое, несколько десятков?
  • Подписание последовательное или параллельное: второй подписант ждёт первого или подписывает независимо?
  • Подписывается один файл или пакет, и допустимо ли подписывать пакет одной подписью?
  • Нужна ли отметка времени и кто её ставит — отправитель, получатель или промежуточный сервис?
  • Что считается «готово»: полученный контейнер, подтверждение от второй стороны или запись в реестре?
  • Как контейнер передаётся: вложение в письме, файлообмен, внутренняя система — и есть ли ограничения на размер и способ передачи?
  • Кто проверяет файл, по какому чек-листу и где фиксирует результат?
  • Что происходит при отказе от подписания, порче файла, увольнении подписанта, истечении срока действия его сертификата?

Если ответы на эти вопросы не зафиксированы, сценарий будет работать «в среднем», а сбои придётся разбирать вручную. Хорошая практика — держать короткий документ на одну-две страницы, где перечислены шаги, ответственные и критерии приёмки. В нём же стоит указать, какие артефакты остаются после каждого шага: исходный файл, промежуточный контейнер, итоговый контейнер и запись о проверке. Такой перечень помогает понять, где именно возникла ошибка, если результат не совпал с ожиданием.

Как спроектировать сценарий подписания документов в DigiDoc: пошаговый разбор

Удобно идти от результата к шагам, а не наоборот. Ниже последовательность, которую можно адаптировать под договорной поток, кадровые документы или внутренние согласования.

  1. Зафиксируйте вход и выход. Вход — конкретный файл или пакет в понятном формате (например, PDF). Выход — контейнер DigiDoc с нужным набором подписей и, если требуется, отметкой времени, плюс запись о том, кто и когда его проверил.
  2. Разложите процесс на роли. Отправитель, подписант, проверяющий, хранитель. Один человек может совмещать роли, но лучше, чтобы проверка не совпадала с подписанием: так ошибки видны раньше.
  3. Определите порядок и точки ожидания. Для последовательного подписания важен вопрос, что делает второй участник, пока первый не подписал: ждёт, получает уведомление или работает с копией. Для параллельного — кто собирает подписи в один контейнер.
  4. Выберите способ подписания. На практике используют ID-карту, Mobile-ID, Smart-ID и другие поддерживаемые решения; актуальный перечень и требования к ним стоит сверять на официальных ресурсах, посвящённых ID-решениям в Эстонии, и у принимающей стороны. В сценарии важно указать не бренд, а требование: какой тип подписи считается приемлемым.
  5. Решите вопрос с отметкой времени. Если она нужна, определите, кто её добавляет и на каком шаге. Если не нужна — запишите это явно, чтобы исполнитель не добавлял её «на всякий случай» и не менял структуру контейнера.
  6. Спроектируйте проверку. Опишите, кто открывает контейнер, что смотрит и что делает при расхождении. Проверка должна быть отдельным шагом с понятным результатом, а не побочным эффектом подписания.
  7. Опишите исключения. Неверный файл, не тот подписант, устаревшая версия документа, повреждённая передача. Для каждого случая — одно действие и один ответственный.
  8. Согласуйте результат с получателем. Покажите принимающей стороне образец контейнера до запуска потока. Это снимает большую часть споров о формате позже.

Отдельно стоит продумать, как сценарий ведёт себя при повторном запуске. Если документ уже подписан, не должен ли поток создавать второй контейнер с тем же содержимым? Если подпись не появилась, сколько раз допустимо напомнить подписанту и кто это делает? Такие детали кажутся мелкими, но именно они определяют, будет ли процесс предсказуемым при регулярной работе.

Типы сценариев и что в них проверять

Разные схемы подписания ломаются по-разному, поэтому и точки контроля у них отличаются.

Сценарий Когда уместен Что проверить в первую очередь
Один подписант Внутренний документ, одностороннее заявление, простой договор Соответствие файла финальной версии и корректность данных подписанта
Последовательное подписание Договор, где важна очерёдность сторон Что в контейнере присутствуют все подписи, а не только последняя
Параллельное подписание Согласование с несколькими отделами или партнёрами Кто собирает подписи в один контейнер и не появилось ли несколько конкурирующих версий файла
Пакет документов Комплект: договор, приложение, акт Полнота комплекта и то, что подписан именно согласованный набор файлов
Массовое подписание Регулярный поток однотипных документов Именование файлов, журнал операций и выборочная проверка части контейнеров

Роли и права доступа

В сценарии стоит явно разделить, кто формирует документ, кто подписывает, кто проверяет и кто хранит. Это не бюрократия: если один человек делает всё, ошибка в исходном файле обнаруживается уже после подписания, и поток приходится запускать заново. Отдельно опишите, у кого есть доступ к исходникам и к журналу проверок, и как этот доступ прекращается при изменении состава участников.

Ещё один практический момент — версионность. Договоритесь, как называется финальный файл и как отличить его от предыдущих редакций. Простое правило вида «в имени файла — дата и номер версии, подписывается только версия с пометкой final» экономит много времени при разборе спорных ситуаций. Если в компании принято хранить промежуточные редакции, стоит заранее решить, попадают ли они в общий архив или остаются только у рабочей группы.

Как проверить файлы в DigiDoc: практический чек-лист

Проверка начинается с открытия контейнера в клиенте DigiDoc и просмотра его состава. Смысл шага — убедиться, что внутри именно тот документ, те подписанты и что подписи отображаются как действительные. Ниже — что смотреть по порядку.

Что проверяем Как выглядит норма Признак проблемы
Состав контейнера Ровно те файлы, которые согласованы, без лишних вложений Отсутствует приложение, есть черновик или файл с похожим названием
Количество подписей Столько, сколько сторон в сценарии Подписей меньше ожидаемого или одна подпись повторяется
Данные подписантов Имена и идентификаторы совпадают с согласованным списком Подписал не тот человек или не та роль
Статус подписи Клиент отображает подпись как действительную Предупреждение о проблеме с сертификатом или о невозможности проверки
Отметка времени Присутствует, если требуется сценарием Отметки нет, хотя она нужна принимающей стороне
Целостность Документ открывается, содержимое совпадает с согласованным Файл не открывается, содержимое отличается от исходника

Отдельно стоит договориться, что делать с результатом проверки. Минимальный вариант — короткая запись: дата, имя проверяющего, имя контейнера, итог. Такой журнал помогает и при передаче дел, и при разборе вопросов спустя месяцы. Если проверяющих несколько, полезно указать, кто именно отвечает за финальное подтверждение, чтобы не возникало ситуации, когда каждый посмотрел файл, но никто не зафиксировал результат.

Проверка файла в DigiDoc подтверждает техническое состояние контейнера и подписей, но не заменяет юридическую оценку документа. Вопросы о том, достаточно ли такой подписи для конкретной сделки или для конкретного госоргана, стоит адресовать принимающей стороне и сверять с актуальными официальными разъяснениями: требования и практика могут меняться.

Если проверка не прошла, не пытайтесь «починить» контейнер вручную. Правильнее вернуться на шаг назад: запросить у подписанта повторное подписание корректной версии файла или пересобрать контейнер из согласованных исходников. Ручное вмешательство в структуру файла почти всегда создаёт больше проблем, чем решает.

Автоматизация: где сценарий ломается чаще всего

Когда поток документов становится регулярным, появляется желание автоматизировать хотя бы часть шагов: формирование пакета, именование файлов, уведомления, выборочную проверку. Автоматизация полезна, но она же и умножает ошибки, если сценарий не описан. Типичный пример: скрипт формирует пакет и отправляет его на подпись, а проверка того, что в пакет попал именно финальный файл, не реализована. В результате ошибка тиражируется на весь поток.

Перед автоматизацией стоит описать проверяемые свойства результата: состав пакета, количество файлов, наличие нужных подписей, соответствие имён согласованному шаблону. Если часть шагов автоматизируется скриптами, пригодится подход из материала о том, что автоматизировать с помощью Python и как проверить работу скрипта: сначала тестовые данные, потом боевой поток.

Соберите небольшой «золотой набор» тестовых контейнеров: корректный, с недостающей подписью, с лишним вложением, с испорченным файлом. Прогоняйте на нём каждый новый сценарий и каждое изменение в автоматизации — так регрессии видны за минуты, а не на реальных документах.

Логирование в таких сценариях важнее, чем кажется. Записывайте, какой файл был взят на входе, какой контейнер получился на выходе, кто и когда его проверял. Если через полгода возникнет вопрос, почему в контейнере оказалась предыдущая редакция приложения, журнал даст ответ быстрее, чем переписка.

Ещё одна частая зона риска — ручные операции между автоматическими шагами. Например, сотрудник переименовывает файл перед отправкой, и скрипт перестаёт находить нужный документ. Если такие действия неизбежны, их стоит описать как часть сценария и предусмотреть проверку, которая заметит отклонение от ожидаемого шаблона.

Приёмка сценария и что закрепить в регламенте

Сценарий считается готовым не тогда, когда документ удалось подписать один раз, а когда он воспроизводится на типовых и нестандартных случаях. Перед передачей в работу полезно пройти короткую приёмку.

Проверьте, что описаны все роли и что у каждого есть понятная инструкция на случай, если он делает шаг впервые. Убедитесь, что зафиксирован критерий «документ принят» и что проверяющий знает, где смотреть состав контейнера и статус подписей. Проговорите, как передаются файлы и что делать, если передача не удалась. Отдельно закрепите правила хранения: где лежат финальные контейнеры, как долго, кто имеет доступ и как организовано резервное копирование.

Ещё один пункт, который часто забывают, — изменения. Кто имеет право менять шаблон документа, порядок подписания или список участников? Если ответ «кто угодно», через несколько месяцев в потоке появятся контейнеры, собранные по разным правилам. Простое правило согласования изменений и одна точка ответственности решают эту проблему.

Наконец, проведите пилот на небольшом объёме: несколько реальных документов с последующей проверкой по чек-листу. Это дешевле, чем обнаружить системную ошибку на всём массиве, и даёт материал для доработки инструкций.

Чем DigiDoc отличается от обычного PDF с подписью?

DigiDoc — это контейнер: внутри лежат исходный документ или несколько документов и подписи, а при необходимости и отметки времени. PDF с визуальной подписью — это один файл, где подпись является частью содержимого. Контейнер удобнее, когда нужно собрать подписи нескольких сторон или сохранить неизменным исходный документ, а подписи хранить отдельно от него.

Достаточно ли открыть контейнер в DigiDoc4, чтобы считать проверку выполненной?

Открытие — только первый шаг. Нужно сверить состав файлов с согласованным, проверить количество подписей и данные подписантов, убедиться, что подписи отображаются как действительные, и посмотреть, есть ли требуемая отметка времени. Результат проверки лучше зафиксировать письменно.

Что делать, если в контейнере не хватает одной подписи?

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

Нужна ли отметка времени в каждом сценарии?

Нет, это зависит от требований принимающей стороны и характера документа. Если отметка нужна, её добавление должно быть отдельным шагом с указанием ответственного. Если не нужна — зафиксируйте это в описании сценария, чтобы исполнители не меняли структуру контейнера по своему усмотрению.

Как проверить, что подписан именно финальный вариант документа?

Сравните содержимое контейнера с согласованным исходником и проверьте, что имя файла соответствует принятому шаблону версий. Помогает практика, при которой подписывается только файл с определённой пометкой, а черновики в поток не попадают. При массовом подписании имеет смысл выборочная проверка части контейнеров.

Можно ли автоматизировать проверку контейнеров?

Частично да: можно автоматизировать контроль состава пакета, именования, количества файлов и уведомления о готовности. Но решение о том, достаточно ли подписи для конкретного документа, остаётся за человеком и принимающей стороной. Перед запуском автоматизации её стоит прогнать на наборе тестовых контейнеров, включая заведомо проблемные.