В данном разделе мы расскажем, как можно автоматизировать электронный документооборот на Вашем корпоративном портале Битрикс24. Покажем сценарии автоматизации внешнего и внутреннего (кадрового) электронного документооборота. И для начала рассмотрим функционал робота SIGNX бизнес-процессы.

Для того, чтобы Вы могли использовать робот SIGNX бизнес-процессы, его нужно активировать в настройках приложения. Заходим в приложение SIGNX Электронная подпись в боковом меню.

На странице настройки включаем двух роботов:
1. Отправить документ на подпись
2. Проверить статус документа

Теперь роботы SIGNX бизнес процессы отображаются в редакторе бизнес процессов Битрикс24.

Пример json-массива подписей:
{
   "1":
   {
        "p1_{{Ответственный}}": {"x":"120", "y":"0"},
        "p2_{{Контакт: ID}}": {"x":"220", "y":"0"}
   },
   "4":
   {
        "p1_{{Ответственный}}": {"x":"120", "y":"0"},
        "p2_{{Контакт: ID}}": {"x":"220", "y":"0"}
   }
}

Здесь:
"1", "4" - номер страницы документа, где расположены подписи.
"p1_{{Ответственный}}", "p2_{{Контакт: ID}}" - id подписанта документа, также может быть представлен просто числовым строковым значением.
"x" - координата блока подписи от левого нижнего края страницы по оси x.
"y" - координата блока подписи от левого нижнего края страницы по оси y.

Важные моменты, о которых необходимо помнить:
- все ключи и значения оборачивать в двойные кавычки;
- подписантов можно указывать в любом порядке, как в формате численного значения, так и переменными, как в примере;
- не оставлять лишних запятых и других символов;
- в json-массиве подписей номера страниц не должны повторяться (иначе будет происходить перезапись местоположения подписей);
- если страница не существует в документе (например, в нём всего 2 страницы, а мы подпись хотим поставить на страницу 3), то данные по этой странице не обрабатываются;
- проверять, чтобы на всех страницах с подписями было одинаковое число подписантов, и чтобы все эти подписанты совпадали между собой;
- поля “Документ”, “Ответственный сотрудник”, “Подписи” являются ОБЯЗАТЕЛЬНЫМИ для заполнения. В противном случае могут возникнуть ошибки в корректной работе робота;

success = 'Успешно',
no_domain = 'Не активен домен',
no_signature = 'Недостаточно подписей',
no_document = 'Документ не найден',
no_transaction_id = 'Не указан id транзакции',
ready_to_send = 'Документ готов к отправке',
error_transaction_id = 'Неверный id транзакции',
error_signs_json = 'Невозможно распарсить JSON поля подписей',
error_signs_data = 'Неверно заполнено поле подписей',
error_signs_pages = 'Неверно указаны страницы подписей',
error_signs_user_count = 'Не совпадает количество подписантов на страницах',
error_signs_user_info = 'Не совпадают подписанты на страницах',
error_signs_user_subscr = 'Некорректно указаны подписанты'

"document-status-draft": "Черновик",
"document-status-queue": "В очереди",
"document-status-sendError": "Ошибка при отправке",
"document-status-AwaitingPayment": "Ожидает оплаты",
"document-status-AwaitingFinalization": "Ожидает завершения",
"document-status-AwaitingSignatures": "Ожидает подписания",
"document-status-Created": "Создание",
"document-status-Opened": "Первое открытие (просмотр)",
"document-status-Signed": "Подписание сторонами",
"document-status-Denied": "Отказ",
"document-status-Cancelled": "Отмена",
"document-status-Completed": "Завершение",
"document-status-EmailToActorSended": "Отправка уведомления получателю",
"document-status-EmailToAuthorSended": "Отправка уведомления отправителю",
"document-status-RegisteredInAvisHash": "Регистрация в avishash",
"document-status-EmailComplitedDoc": "Документооборот завершен".

При достижении финального статуса электронного документооборота, бизнес-процесс возвращает.

• ID подписанного сторонами документа.
• ID документа доп. соглашения.
• ID документа отчета о подписании.
• Текст статуса документа.
• Код статус документа.
• Текст ответа приложения
• Код ответа приложения
• Ошибка

Если документ идет как файл сгенерированный в сделке:
В робот необходимо передавать ID документа, который возвращает блок "Создание документа CRM"

В блоке Cоздание документа в CRM, выбираем из шаблонов нужный нам документ, который мы будем подписывать.

Так же важно в данном конструкторе указать.
Ожидать конвертации PDF файла: Да

Выбор подписанта со стороны Вашей компании и со второй стороны клиента, контрагента или сотрудника.
В поле "Подписи" подставляем следующие значения.
Подписант №1: Подставляем ID сотрудника; Создаем пользовательское поле "Привязка к пользователю"
Подписант №2: Подставляем значение переменной {{Контакт: ID}}

Если выбрали метод подстановки по ID Пользователя, указываем номер ID в поле Подписант №1

Если выбрали метод подстановки пользовательского поля, например: Подписант №1 (Вашей компании), то делаем следующие действия. Нажимаем создать поле----дополнительные поля----тип поля привязка к пользователю.

Созданный тип поля добавляем в карточку сделки. И после можно выбрать Подписанта №1, подпись данного пользователя будет участвовать в подписании документа.

Созданный тип поля добавляем в карточку сделки. И после можно выбрать Подписанта №1, подпись данного пользователя будет участвовать в подписании документа.

Если документ подгружается из созданного шаблона в "Сделка", необходимо обязательно указать ID текущей сделки. Если документ подгружается из диска, то указывать ID не нужно.

Необходимо, чтобы в поле "Ожидать ответа" была установлена галочка "Да". Это настройка выставляется по умолчанию, при добавлении робота в бизнес процесс и не следует её убирать.

В робот необходимо передавать ID документ диска. Для этого создадим блок "Загрузить в Диск".

В поле "Файл для загрузки" , выберите поле созданное в сделке для загрузки файла.

В данном примере поле "Документ на подпись" является полем для загрузки файлов.

Далее в блоке робота SIGNX, в поле "Документ", выбираем в Доп. результатах "ID файлов Диска".

Итоговый вариант настройки робота в данном примере выглядит так:

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

1. Поле "№ дополнительного соглашения"
2. Поле "Дата дополнительного соглашения"

В нашем примере мы создали 2 поля в сделке. Первое поле тип список и назвали "Тип подписываемого документа" и в роботе оно соответствует значению "№ дополнительного соглашения" и второе поле тип дата "Дата доп. соглашения". Таким образом заполнив данные поля в сделке они отобразятся в документе.