Автор документа — сотрудник или менеджер, инициирующий подписание документа на портале
Руководитель (подписант) со стороны владельца портала — человек обладающий правом подписи в вашей организации
Получатель документа — подписант на стороне контрагента с правом подписи
Автор документа — любой зарегистрированный на портале сотрудник — внутренний пользователь приложения.
Получатель документа — контакт или компания CRM Битрикс24, которым необходимо отправить документ на подпись.
Название Документа — имя документа, которое присваивается при создании документа.
Email — электронный ящик контрагента, который указывается в карточке контакта или компании в CRM
Страница приложения — доступна всем сотрудникам в виде ссылки меню Битрикс24.
Руководитель — сотрудник с правом подписи, обладающий сертификатом для подписи и необходимым ПО (КриптоАРМ ГОСТ), указывается в настройках приложения.
Публичная страница документа — доступна контрагентам по ссылке из письма с уведомлением, содержит пользовательский интерфейс контрагента по работе с документом.
Документ — запись в Реестре документов с одним или несколькими файлами для подписи и сопутствующими атрибутами.
Реестр документов — хранилище документов, с которыми работает приложение.
Сервер приложения
— реализует Страницу приложения. Обеспечивает работу Публичных страниц документа с REST API битрикс24 с учетом логики приложения и прав доступа;
— реализует активити приложения для встраивания в пользовательские бизнес-процессы Битрикс24;
— отправляет уведомления для контрагентов через пользовательский SMTP-сервер.
КриптоАРМ ГОСТ — программа для создания и проверки электронной подписи.
Устанавливается на компьютер Руководителя и Получателя, необходимо для формирования ЭП.
Электронная подпись (ЭП) — это реквизит электронного документа, полученный в результате криптографического преобразования информации с использованием закрытого ключа подписи и позволяющий проверить отсутствие искажения информации в электронном документе с момента формирования подписи (целостность), принадлежность подписи владельцу сертификата ключа подписи (авторство), а в случае успешной проверки подтвердить факт подписания электронного документа (неотказуемость).
КриптоПРО CSP — средство криптографической защиты информации, который шифрует электронную подпись. Он есть у 80% людей, у которых есть ЭП. Устанавливается на компьютер руководителя и контрагента.
Пакет подписей — это одноразовые лицензии КриптоАрм ГОСТ, которые списываются в момент подписания документа у лица, отправляющего подписанный документ — это первая подпись, вторая подпись — у лица, принявшего и ответно подписавшего документ. В случае, если у подписанта первой подписи есть приобретенная лицензия КриптоАРМ ГОСТ, при установке соответствующей галочки в настройках приложения, Пакет подписей не используется.
Установить приложение КликДок на вашем портале Б24.
Установить КриптоАРМ ГОСТ 2.5.13 — программа для создания и проверки электронной подписи файлов.
Рекомендуется использовать VMBitrix 7.x.
Можно развернуть сервер КликДок на одном хосте с коробочной версией Битрикс24 на отдельном одомене с валидным сертификатом ssl.
mbstring.func_overload=0 для работы в utf-8docker run --detach --restart always --name gotenberg -p 127.0.0.1:3000:3000 gotenberg/gotenberg:7.6.0
ALLOW-FROM <домен_битрикс24> В VMBitrix необходимо закомментировать строчку с этим заголовком в файле /etc/nginx/bx/conf/general-add_header.confУстановите и настройте сервер (см. Требования к хостингу)
Настройте cron на выполнение /local/php_interface/cron_events.php каждую минуту от имени пользователя, под которым работает веб-сервер
Настройте сервер для загрузки больших файлов
Разверните бекап проекта (см. Перенос продукта «1С-Битрикс»)
Установите и обеспечьте доступность Gotenberg по адресу http://localhost:3000
Если адрес отличается, его нужно вписать в файле /bitrix/.settings_extra.php
Добавьте в Битрикс24 локальное приложение по инструкции, указав вместо app.click-doc.ru домен сервера приложения
После создания приложения скопируйте Код и Ключ приложения (client_id и client_secret).
Укажите настройки bec_app в файле /bitrix/.settings_extra.php:
id — client_id локального приложенияsecret — client_secret локального приложенияoauth_server — для закрытого контура: домен Битрикс24, куда будет установлено приложение
Перейти в административную часть сервера на страницу /bitrix/admin/iblock_element_admin.php?IBLOCK_ID=3&type=LICENSES&lang=ru&apply_filter=Y
В разделе «Подключить пробную версию» настройках приложения КликДок в вашем Битрикс24 нажмите «Подключить пробную версию»
Повторите пункт 7 для нового элемента «Триал» с типом лицензии clickdoc_bp
Установите действие БП «Сформировать визуализацию подписи», если оно необходимо
В настройках сайта и настройках главного модуля укажите Доменное имя, URL сервера и URL сайта.
memory_limit = 4096M
post_max_size = 4096M
upload_max_filesize = 4096M
session.cookie_samesite = "None;Secure"
// 10-general.conf
server ... {
client_max_body_size 4096m;
}
LimitRequestBody 0
Для использования сервера лицензий вместо индивидуальных лицений Крипто АРМ ГОСТ на каждом рабочем месте, укажите ваш аккаунт в настройке cryptoarm_license_account в файле /bitrix/.settings_extra.php.
Предварительно устанавливаем yarn и выполняем yarn install в папке /local
(если есть ошибки установки - удалить папку /local/node_modules/)
Запускается в папке /local:
yarn run build:devyarn run build:prodyarn run watchнастроить шаблон сайта App в настройках сайта
после добавления приложения - выбрать пункт "Переустановить"
cd local && yarn lint:scriptscd local && composer lintyarnyarn build:prod (есть и другие варианты сборки, а также yarn watch для разработки, см. package.json)https://book.cakephp.org/phinx/0/en/migrations.html#creating-a-new-migration
В папке local/:
vendor/bin/phinx create MyNewMigration - созданиеvendor/bin/phinx migrate - выполнить все не примененныеvendor/bin/phinx status - список примененных миграцийvendor/bin/phinx migrate -t 20220512115100 - запуск выбранной миграцииcitrus_bec_installations найти запись нужной установки, добавить bizproc_stamp_activity в колонку FEATURES.Это enum поле, в админке битрикса оно не поддерживается — через SQL или какой-нибудь phpmyadmin/adminer.
UPDATE citrus_bec_installations SET FEATURES = 'bizproc_stamp_activity' WHERE DOMAIN = 'домен_вашего_битрикс24'
Важно: для установки необходимы права администратора портала.
Перейдите на страницу Разработчикам → Другое → Локальное приложение
Выберите вариант Серверное
Укажите:
Путь вашего обработчика*
https://<домен вашего сервера КликДок>/?version=8
Путь для первоначальной установки
https://<домен вашего сервера КликДок>/install.php?version=8
Название пункта меню Russian (ru) *
КликДок
Выберите в поле Настройка прав:
После успешного добавления, вы попадёте в диалог первоначальной настройки приложения. Закончите её, чтобы начать пользоваться приложением.
Раздел настроек доступен тем, кто обладает правами администратора портала.

Далее идут настройки для отправки почты:
Как определить параметры порт, хост, тип шифрования и аутентификации?
Например, вы корпоративную почту отправляете с сервиса mail.ru, то есть ваша почта выглядит kj@mail.ru или у вас есть корпоративная почта klili@pechka.ru, но чтобы попасть на нее, вы все равно заходите на страницу mail.ru. Тогда вы вводите например в google.com в поисковой строке запрос «SMTPmail» или «SMTPyandex» - если почта на Яндексе. И вводите данные, которые он вам предоставляет.
Данные настройки доступны при нажатии на шестеренку
с любой страницы приложения.
В этом разделе указывается индивидуальные настройки каждого пользователя.
Подпись для отправляемых писем. В этом поле указывается контактная информация сотрудника - создателя документа, в произвольной форме. Данная информация указывается в подвале письма, как контактные данные сотрудника, при отправке документа на подпись контрагенту.
По умолчанию стоит текст : С уважением, Должность, ФИ.
Где Должность - берется из поля должность из карточки сотрудника.
ФИ - это фамилия и имя пользователя из карточки сотрудника.
Загрузится список всех документов, созданных вами по всем проектам, отфильтрованных по умолчанию как «Мои документы»
2. Через сущность CRM: сделка, компания, контакт. Заходите в сущность и выбираете закладку КликДок.
Когда документ отправлен на подпись руководителю, ему приходит уведомление о том, что необходимо подписать документ.
При нажатии на название документа, можно перейти на сам документ. Откроется документ, который необходимо подписать.
Поля доступные для редактирования: название документа, сделка и компания.
Если руководитель отклоняет документ, сотруднику приходит уведомление о том, что «руководитель отклонил документ». Статус документа меняется на «Отклонен руководителем».
Если руководитель подписал документ, сотруднику приходит уведомление о том, что документ отправлен Контрагенту. Статус документа меняется на «Отправлен получателю».
Для того, чтобы подписать документ, необходимо нажать кнопку "Подписать".
Далее работать по инструкции «Как подписать документ через КриптоАрм ГОСТ»
Откроется форма документа.
Сохраняем документ- нажимаем кнопку «Добавить документ».
Документ переводится в статус Черновик.
Действия с документом, доступные в статусе “Черновик”:
При нажатии на "НазваниеДокумента", можно перейти на сам документ. Откроется документ, который необходимо подписать.
После того, как руководитель получает документ на подпись, ему доступны следующие действия с документом:
Поля доступные для редактирования: НазваниеДокумента, Сделка, Компания.
Если руководитель отклоняет документ, сотруднику приходит уведомление о том, что руководитель отклонил документ. Статус документа меняется на «Отклонен руководителем».
Если руководитель подписал документ, сотруднику приходит уведомление о том, что документ отправлен Контрагенту.
Для фильтрации доступны следующие поля:
Примечание: ПО данного раздела должны быть установлены непосредственно на рабочем месте руководителя (или подписанта, которому отправляется документ). Если же ПО установлено на терминальный сервер, значит подписание документов должно осуществляться там.
При нажатии на кнопку «Подписать» запустится приложение КриптоАрм ГОСТ. Если приложение не установлено, необходимо его установить, иначе процесс подписания не начнется.
Дальше появляется следующее окно:
Здесь необходимо поставить галочку о том, что документ просмотрен и нажать кнопку «Подписать». Далее идёт процесс загрузки подписанных документов в наше приложение.
Выходит уведомление о том, что файлы сохранены, «Документ подписан и успешно загружен».
В главе описана интеграция КликДок в Бизнес-процессы Битрикс24.
Начало работы:
Чтобы получить подпись от одного или нескольких сотрудников внутри Битрикс24, создайте свой бизнес процесс или добавьте в существующий действие Подписать файлы из Битрикс24.Диск:
Действие передаёт файл из Битрикс24.Диск на подпись выбранными пользователям в КриптоАРМ ГОСТ.
Обязательные параметры выделены полужирным.
Подписанты (users) множественное
Пользователи, которым предстоит поставить свою подпись.
— Можно передать произвольное количество пользователей без необходимости запускать действие по отдельности для каждого
Поддерживается выбор конкретных пользователей, групп пользователей, отделов и групп соц. сети.
Файлы (files)
множественное поле типа «Файл (Диск)», передаются идентификаторы файлов Битрикс24.Диск
Текст уведомления для Подписантов (notifyText)
Передав этот параметр можно переопределить стандартное уведомление.
signedFiles (множественное типа Файл (Диск))
Содержит идентификаторы файлов Битрикс24.Диск с присоединенными подписями.
Подписанные файлы хранятся на диске приложения КликДок.БП и должны быть скопированы в место их конечного размещения стандартными действиями БП для работы с файлами диска.
certificate (строка с json)
информацией о сертификате Подписанта (если он один)
signatures (строка с json)
описывает все имеющимися на данный момент подписи
В активити передаётся один или несколько файлов Битрикс24.Диск и один или несколько Подписантов — сотрудников Битрикс24
При запуске активити отправляет всем Подписантам уведомление с заданным в параметрах текстом и ссылкой «Приступить к подписанию».
Выполнение БП приостанавливается до получения подписей от всех Подписантов
При этом пользователь, от имени которого было запущено действие, видит уведомление о прогрессе выполнения:

Когда очередной Подписант переходит по ссылке из уведомления, в слайдере открывается страница, отображающая прогресс передачи файлов в КриптоАРМ ГОСТ, а после подписи — загрузки подписанных файлов обратно в Битрикс24.

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

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

Название документа (title)
Будет отображаться в Реестре документов КликДок и на странице, куда попадают Получатели документа по ссылке из письма.
Файлы (files) множественное поле типа «Файл (Диск)»,
передаются идентификаторы файлов Битрикс24.Диск
Сделка (deal) идентификатор сделки CRM.
Созданный документ будет отображаться на вкладке КликДок этой сделки.
Получатели документа (recipients) множественное поле типа Привязка к элементам CRM.
Контакты или компании CRM, от которых требуется подпись.
Документы уже подписаны руководителем (status)
Определяет статус или стадию, в которой будет создан документ КликДок.
signedFiles (множественное типа Файл (Диск))
Содержит идентификаторы файлов Битрикс24.Диск с прикрепленными подписями.
Хранятся на диске приложения и должны быть скопированы в место их конечного размещения.
certificate (строка с json)
информацией о сертификате Получателя документа
signatures (строка с json)
все имеющимися на данный момент подписи
При выполнении, на странице приложения вы сразу увидите созданный документ в его текущем статусе .

Документ проходит типовой процесс подписания внешним пользователем.
В конечном итоге, получатель переходит по ссылке из письма на почту, открывает документ в браузере, где ему предоставляется возможность подписать, скачать или выбрать «подпишу бумажный вариант» (см. Таблица по движению документа и статусам).
Результатом работы активити будет подписанный несколькими пользователями документ.