Интеграция с Подпислон позволяет отправлять договоры клиентам на подпись по SMS, отслеживать статус подписания и получать подписанную версию документа в карточке договора.
Сервис Подпислон принимает документы только в формате PDF. ClubIS формирует договор из шаблона и автоматически конвертирует его в PDF перед отправкой.
- Аккаунт в Подпислон.
- API-ключ из личного кабинета Подпислон.
- Доступный из интернета адрес web-сервиса ClubIS (параметр Внешний URL в настройках).
- (Рекомендуется) Секрет webhook — одинаковый в ClubIS и в личном кабинете Подпислон.
- На компьютере, с которого работают в Менеджере, установлен Microsoft Word или LibreOffice — без одной из этих программ автоматическая конвертация договора в PDF не выполнится. На Windows сначала используется Word; если он недоступен — LibreOffice.
- В анкете клиента указан телефон для отправки ссылки на подписание.
Откройте Администратор → Параметры → Web и укажите Внешний URL — публичный адрес web-сервиса ClubIS без пути /podpislon.
Примеры:
https://club.example.ruhttp://95.171.1.201:8081 — если используется HTTP на отдельном порту
Откройте Администратор → Интеграции → Прочее → Подпислон и заполните:
- Включено — включает интеграцию.
- API-ключ (заголовок X-Api-Key) — ключ из личного кабинета Подпислон.
- Секрет webhook — если используется подписка на входящие события (рекомендуется).
- URL редиректа после подписания (redirect_url) — необязательно; страница, куда перейдёт клиент после подписания.
Кнопка Синхронизировать статусы договоров — массовое обновление статусов и повторная загрузка подписанных файлов, если webhook не сработал.
В личном кабинете Подпислон укажите URL webhook:
<ваш Внешний URL>/podpislon
Пример: http://95.171.1.201:8081/podpislon
Если в ClubIS заполнен Секрет webhook, укажите тот же секрет в настройках webhook в Подпислон.
- Для webhook рекомендуется HTTP на выделенном порту, проброшенном на web-сервис ClubIS.
- URL с самоподписным SSL-сертификатом при сохранении в личном кабинете Подпислон может давать ошибку — Подпислон не принимает такой адрес.
- Если нужен HTTPS, используйте доверенный сертификат (Let's Encrypt и т.п.) на отдельном hostname.
Основной способ — из карточки договора в Менеджер.
- Откройте договор клиента.
- В блоке Договор нажмите кнопку Отправить на подпись (рядом с кнопкой печати договора). Кнопка видна, если интеграция Подпислон включена в настройках.
- Выберите шаблон договора (как при печати).
- ClubIS сформирует документ, преобразует его в PDF и предложит выбрать телефон клиента из анкеты.
- После подтверждения договор отправляется в Подпислон, PDF сохраняется во вкладке Файлы договора.
Подсказка на кнопке меняется по состоянию: Отправить на подпись → Ожидает подписи в Подпислон → Документ подписан в Подпислон (иконка с отметкой об успехе).
Дополнительные действия — на вкладке Файлы в карточке договора в Менеджер:
- Подпислон — отправка уже добавленного файла на подпись (с выбором телефона). Если файл не в формате PDF, ClubIS конвертирует его перед отправкой (нужны Word или LibreOffice на этом компьютере).
- Подпислон: переотправить ссылку — повторная отправка ссылки на подписание.
- Проверить статус — ручное обновление статуса и загрузка подписанного PDF, если автоматическая загрузка не произошла.
-
Подпислон отправляет уведомление о подписании на адрес /podpislon web-сервиса ClubIS.
-
ClubIS обновляет статус документа на «Подписан».
-
ClubIS автоматически скачивает подписанный PDF из Подпислон и добавляет его в список файлов договора как новую версию (отдельная строка с признаком «Содержит подпись»).
-
ClubIS автоматически заполняет Дата подписания в окне Правка договора (кнопка изменения номера и даты договора в карточке контракта) и добавляет запись в историю контракта. Уже указанная вручную дата подписания не изменяется.
Повторная доставка одного и того же события не создаёт дубликат подписанного файла.
Если подписанный файл не появился в течение нескольких минут:
- нажмите Проверить статус по исходному документу в карточке договора, или
- выполните Синхронизировать статусы договоров в настройках интеграции.
- Отправлен
- Просмотрен
- Подписан
- Аннулирован
Проверьте:
- включена ли интеграция в Администратор → Интеграции → Прочее → Подпислон;
- корректен ли API-ключ;
- совпадает ли Внешний URL в Администратор → Параметры → Web с адресом, доступным Подпислон из интернета;
- сохраняется ли URL webhook в личном кабинете Подпислон;
- совпадает ли секрет webhook на обеих сторонах (если используется);
- установлены ли на компьютере с Менеджером Microsoft Word или LibreOffice (при ошибке конвертации в PDF);
- заполнены ли ФИО и телефон в анкете клиента;
- есть ли в логах web-service обращения к
/podpislon при подписании.
При обращении в поддержку укажите ID договора, время отправки/подписания и используемый URL webhook.