Интеграция электронной подписи с 1С

Cert4U предоставляет REST API и готовую обработку .epf для отправки документов на электронное подписание прямо из 1С:Предприятия. Автоматизируйте подписание договоров, актов и счетов — без ручной загрузки файлов в браузер. Подключение за 1 день.

Зачем интегрировать электронную подпись с 1С

Большинство российских компаний ведут учёт в 1С:Предприятии. Договоры, акты, счета, заявки — все эти документы создаются в 1С. Но когда приходит время подписать документ с контрагентом электронно, менеджер вынужден: выгрузить файл из 1С, открыть браузер, зайти в сервис подписания, загрузить файл, заполнить данные подписанта, отправить ссылку. Это занимает 5–10 минут на каждый документ.

Интеграция Cert4U с 1С устраняет ручные операции. Менеджер нажимает одну кнопку в 1С — и документ автоматически отправляется контрагенту на подписание. Статус подписания обновляется в 1С в реальном времени. Подписанный файл и протокол скачиваются обратно в 1С автоматически.

Экономия при объёме 100 документов в месяц составляет 8–16 часов рабочего времени ежемесячно. Для компаний с объёмом 500+ документов интеграция окупается в первый же месяц.

Поддерживаемые конфигурации 1С

REST API Cert4U работает с любой конфигурацией 1С:Предприятия, которая поддерживает HTTP-запросы (начиная с платформы 8.3.10). На практике это означает совместимость со всеми актуальными конфигурациями:

Готовая обработка .epf разработана для наиболее популярных конфигураций и может быть адаптирована для любой другой.

Архитектура интеграции

Интеграция построена на REST API — стандартном способе взаимодействия между системами через HTTP-протокол. 1С выступает в роли клиента, Cert4U — в роли сервера.

Все запросы передаются по защищённому каналу HTTPS. Аутентификация — по API-ключу, который генерируется в личном кабинете Cert4U. Формат данных — JSON. Файлы документов передаются в формате Base64.

Обзор REST API Cert4U

API Cert4U предоставляет полный набор эндпоинтов для управления жизненным циклом документа:

Также поддерживаются вебхуки (webhooks) — Cert4U может отправлять HTTP-уведомления на указанный URL при изменении статуса документа. Это позволяет 1С получать обновления в реальном времени, не опрашивая API постоянно.

Обработка .epf для 1С

Для быстрого подключения без привлечения программиста 1С мы предоставляем готовую внешнюю обработку (файл .epf). Она включает:

• Форму настроек. Ввод API-ключа, выбор типа подписи по умолчанию (УКЭП или ПЭП), настройка уведомлений.
• Кнопку «Отправить на подписание». Встраивается в форму документа 1С. Одно нажатие — и документ отправлен.
• Журнал отправленных документов. Статусы всех отправленных документов: ожидает, подписан, отклонён, истёк срок.
• Автоматическое скачивание. Подписанный документ и PDF-протокол автоматически прикрепляются к документу 1С.
• Печатную форму протокола. PDF-протокол подписания можно распечатать прямо из 1С.

Пошаговое подключение интеграции

Примеры кода на языке 1С

Если вы предпочитаете интегрировать Cert4U напрямую через API (без обработки .epf), ниже приведены примеры кода на встроенном языке 1С:Предприятия.

Создание документа и отправка на подписание

// Подготовка HTTP-соединения
HTTPСоединение = Новый HTTPСоединение(
    "cert4u.ru", 443, , , , ,
    Новый ЗащищенноеСоединениеOpenSSL());

// Чтение файла документа
ДвоичныеДанные = Новый ДвоичныеДанные(ПутьКФайлу);
Base64Строка = Base64Строка(ДвоичныеДанные);

// Формирование тела запроса
ТелоЗапроса = Новый Структура;
ТелоЗапроса.Вставить("title", "Договор оказания услуг");
ТелоЗапроса.Вставить("file_base64", Base64Строка);
ТелоЗапроса.Вставить("file_name", "dogovor.pdf");
ТелоЗапроса.Вставить("signer_name", "Иванов Иван Иванович");
ТелоЗапроса.Вставить("signer_phone", "+79001234567");
ТелоЗапроса.Вставить("sign_type", "pep"); // или "ukep"

ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписатьJSON(ЗаписьJSON, ТелоЗапроса);
ТелоJSON = ЗаписьJSON.Закрыть();

// Отправка запроса
HTTPЗапрос = Новый HTTPЗапрос("/api/documents");
HTTPЗапрос.Заголовки.Вставить("Content-Type", "application/json");
HTTPЗапрос.Заголовки.Вставить("Authorization", "Bearer " + APIКлюч);
HTTPЗапрос.УстановитьТелоИзСтроки(ТелоJSON);

Ответ = HTTPСоединение.ОтправитьДляОбработки(HTTPЗапрос);

Если Ответ.КодСостояния = 201 Тогда
    // Документ создан успешно
    ЧтениеJSON = Новый ЧтениеJSON;
    ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку());
    Результат = ПрочитатьJSON(ЧтениеJSON);
    ИдДокумента = Результат.id;
    Сообщить("Документ отправлен на подписание. ID: " + ИдДокумента);
КонецЕсли;

Проверка статуса документа

// Запрос статуса
HTTPЗапрос = Новый HTTPЗапрос("/api/documents/" + ИдДокумента);
HTTPЗапрос.Заголовки.Вставить("Authorization", "Bearer " + APIКлюч);

Ответ = HTTPСоединение.Получить(HTTPЗапрос);

Если Ответ.КодСостояния = 200 Тогда
    ЧтениеJSON = Новый ЧтениеJSON;
    ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку());
    Результат = ПрочитатьJSON(ЧтениеJSON);

    Если Результат.status = "signed" Тогда
        Сообщить("Документ подписан " + Результат.signed_at);
    ИначеЕсли Результат.status = "pending" Тогда
        Сообщить("Ожидает подписания");
    ИначеЕсли Результат.status = "rejected" Тогда
        Сообщить("Подписание отклонено");
    КонецЕсли;
КонецЕсли;

Безопасность интеграции

Безопасность данных при интеграции 1С с Cert4U обеспечивается на нескольких уровнях:

• HTTPS (TLS 1.2+). Все данные передаются по зашифрованному каналу. Перехват данных в транзите невозможен.
• API-ключи. Каждый ключ привязан к конкретному тенанту (организации) в Cert4U. Ключ можно отозвать в любой момент.
• IP-фильтрация. В настройках API можно ограничить доступ по IP-адресам — запросы с неизвестных IP будут отклонены.
• Ротация ключей. Рекомендуется менять API-ключ каждые 90 дней. Старый ключ продолжает работать 24 часа после генерации нового.
• Журнал API-запросов. Все запросы к API логируются с фиксацией IP-адреса, времени, метода и результата. Доступно в личном кабинете.
• Хранение данных в РФ. Серверы Cert4U расположены в России, что обеспечивает соответствие требованиям 63-ФЗ и 152-ФЗ.

Сценарии использования интеграции

Частые вопросы об интеграции с 1С