REST API Cert4U для интеграции с 1С

Аутентификация

Все запросы к API требуют передачи ключа api_key в GET-параметре. Ключ настраивается в панели администратора (Настройки → 1С API).

Параметр	Значение
Базовый URL	`https://cert4u.ru/api.php`
Аутентификация	GET-параметр `api_key`
Формат ответа	JSON (UTF-8)
Лимит запросов	60 запросов в минуту

// Пример запроса GET https://cert4u.ru/api.php?action=api_1c_documents&api_key=ВАШ_КЛЮЧ

Важно: API должен быть включён в настройках (параметр onec_api_enabled). Если API отключён, все запросы вернут ошибку 403.

Типовой сценарий подписания

Полный цикл работы с документом через API:

1

Загрузка документа
api_1c_upload — загрузить PDF/DOCX файл в систему

2

Подписание администратором
api_1c_sign_admin — серверная подпись (OpenSSL SHA-256)

3

Отправка клиенту
api_1c_send — отправить ссылку на подписание (SMS/email)

4

Клиент подписывает
УКЭП (КриптоПро в браузере) или ПЭП (код из SMS/email)

5

Проверка и скачивание
api_1c_verify + api_1c_download_zip — проверить подписи, получить архив

1С:Предприятие Cert4U Клиент | | | |--- api_1c_upload (PDF) --------->| | |<-- { document_id } -------------| | | | | |--- api_1c_sign_admin ----------->| | |<-- { signed } ------------------| | | | | |--- api_1c_send ----------------->|--- SMS/Email (ссылка) ------>| |<-- { sign_url, pep_code } ------| | | | | | |<-- Подпись (УКЭП/ПЭП) ------| | | | |--- api_1c_verify --------------->| | |<-- { valid: true, cert_info } --| | | | | |--- api_1c_download_zip --------->| | |<-- (ZIP: документ + подписи) ---| |

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

GET api.php?action=api_1c_documents

Возвращает список всех документов в системе.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ

Пример запроса

GET https://cert4u.ru/api.php?action=api_1c_documents&api_key=ваш_ключ...

Пример ответа

{ "success": true, "documents": [ { "id": "abc123def4567890", "name": "Договор ипотеки", "original_name": "ИПОТЕКА.pdf", "status": "completed", "client_name": "Иванов Иван Иванович", "created_at": "2026-03-12 17:10:01", "admin_signed_at": "2026-03-12 17:10:14", "client_signed_at": "2026-03-12 17:46:46", "client_sign_type": "ukep" } ] }

Статусы документа

Статус	Описание
`new`	Загружен, не подписан
`signed_admin`	Подписан администратором
`sent`	Отправлен клиенту на подписание
`completed`	Подписан обеими сторонами

Получить документ

GET api.php?action=api_1c_document

Возвращает подробную информацию об одном документе.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ
`id`	string	обяз.	ID документа

Пример запроса

GET https://cert4u.ru/api.php?action=api_1c_document&id=abc123def4567890&api_key=...

Пример ответа

{ "success": true, "document": { "id": "abc123def4567890", "name": "Договор ипотеки", "original_name": "ИПОТЕКА.pdf", "status": "completed", "description": "", "client_id": "client001abc2345", "client_name": "Иванов Иван Иванович", "created_at": "2026-03-12 17:10:01", "admin_signed_at": "2026-03-12 17:10:14", "client_signed_at": "2026-03-12 17:46:46", "client_sign_type": "ukep" } }

Загрузить документ

POST api.php?action=api_1c_upload

Загружает новый документ в систему. Используйте multipart/form-data.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)
`document`	file	обяз.	Файл документа (pdf, doc, docx, txt, rtf, odt, xls, xlsx, png, jpg)
`doc_name`	string	обяз.	Название документа
`description`	string	опц.	Описание документа
`client_id`	string	опц.	ID клиента (привязка)

Пример запроса (cURL)

curl -X POST "https://cert4u.ru/api.php?action=api_1c_upload&api_key=ВАШ_КЛЮЧ" \ -F "document=@/path/to/contract.pdf" \ -F "doc_name=Договор поставки №123" \ -F "description=Договор от 01.03.2026" \ -F "client_id=client001abc2345"

Пример ответа

{ "success": true, "document": { "id": "a1b2c3d4e5f67890", "name": "Договор поставки №123", "original_name": "contract.pdf", "status": "new", "client_id": "client001abc2345", "created_at": "2026-03-27 14:30:00" }, "message": "Документ загружен через API 1С" }

Максимальный размер файла: определяется настройками PHP на сервере (обычно 20 МБ). Допустимые расширения: pdf, doc, docx, txt, rtf, odt, xls, xlsx, png, jpg, jpeg.

Подписать администратором

POST api.php?action=api_1c_sign_admin

Подписывает документ серверным ключом (OpenSSL SHA-256 RSA). Документ должен быть в статусе new.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)
`doc_id`	string	обяз.	ID документа (JSON body или GET)

Пример запроса

curl -X POST "https://cert4u.ru/api.php?action=api_1c_sign_admin&api_key=ВАШ_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{"doc_id": "a1b2c3d4e5f67890"}'

Пример ответа

{ "success": true, "document": { "id": "a1b2c3d4e5f67890", "status": "signed_admin", "admin_signed_at": "2026-03-27 14:31:00", "admin_sign_method": "openssl" }, "message": "Документ подписан серверным ключом" }

Отправить клиенту

POST api.php?action=api_1c_send

Отправляет клиенту ссылку для подписания по SMS и/или email. Документ должен быть в статусе signed_admin.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)
`doc_id`	string	обяз.	ID документа
`client_id`	string	опц.	Переопределить клиента
`sign_type`	string	опц.	`ukep_only`, `pep_only` или пусто (оба варианта)

Пример запроса

curl -X POST "https://cert4u.ru/api.php?action=api_1c_send&api_key=ВАШ_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{"doc_id": "a1b2c3d4e5f67890", "sign_type": "ukep_only"}'

Пример ответа

{ "success": true, "document": { ... }, "sign_url": "https://cert4u.ru/client.html?token=a1b2c3d4...", "pep_code": "384729", "message": "Документ отправлен клиенту", "notifications": { "sms": true, "email": true } }

ukep_only
Клиент сможет подписать только УКЭП (КриптоПро)

pep_only
Только ПЭП (код из SMS/email)

Проверить подписи

GET api.php?action=api_1c_verify

Полная криптографическая проверка подписей документа. Для УКЭП используется КриптоПро CSP (ГОСТ Р 34.10-2012). Возвращает данные сертификата: ИНН, СНИЛС, ОГРН и другие реквизиты.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ
`id`	string	обяз.	ID документа

Пример запроса

GET https://cert4u.ru/api.php?action=api_1c_verify&id=abc123def4567890&api_key=...

Пример ответа (УКЭП)

{ "success": true, "document_id": "abc123def4567890", "document_name": "ИПОТЕКА.pdf", "status": "completed", "admin_signature": { "type": "CAdES-BES (УКЭП)", "signed_at": "2026-03-12 17:10:14", "valid": true, "crypto_verify": true, "crypto_method": "CryptoPro CSP 5.0 (cryptcp)", "stored_cert_info": { "subject_cn": "ООО Ваша Компания", "subject_inn": "771234567890", "subject_snils": "98765432100", "subject_ogrn": "1027700000001", "subject_org": "ООО Ваша Компания", "subject_title": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР", "issuer_cn": "Центральный банк РФ", "serial": "0123456789ABCDEF0123456789ABCDEF", "valid_from": "2025-12-17 09:23:22", "valid_to": "2039-06-26 12:10:31" } }, "client_signature": { "type": "CAdES-BES (УКЭП)", "signed_at": "2026-03-12 17:46:46", "client_name": "Иванов Иван Иванович", "valid": true, "crypto_verify": true, "stored_cert_info": { "subject_cn": "Иванов Иван Иванович", "subject_inn": "770312345678", "subject_snils": "12345678901", "subject_email": "ivanov@example.ru", "issuer_cn": "ООО Удостоверяющий Центр", "serial": "FEDCBA9876543210AB...", "thumbprint": "AABB0011CCDD2233..." } }, "download_zip_url": "https://cert4u.ru/api.php?action=api_1c_download_zip&..." }

Поля stored_cert_info

Поле	Описание
`subject_cn`	ФИО / наименование организации
`subject_inn`	ИНН подписанта
`subject_snils`	СНИЛС подписанта
`subject_ogrn`	ОГРН организации
`subject_org`	Организация
`subject_title`	Должность
`subject_email`	Email
`issuer_cn`	Удостоверяющий центр
`serial`	Серийный номер сертификата
`thumbprint`	Отпечаток (SHA1)
`valid_from` / `valid_to`	Срок действия сертификата

Валидация подписи (63-ФЗ)

Для каждой УКЭП-подписи в ответе api_1c_verify и в поле cert_validation документа возвращается юридический статус:

Поле	Описание
`legal_status`	`UKEP_OK` — соответствует УКЭП по 63-ФЗ `UKEP_SUSPECT` — УКЭП, но есть поведенческие маркеры `UNEP` — не соответствует УКЭП (УНЭП)
`problems[]`	Критические проблемы (влияют на legal_status)
`warnings[]`	Предупреждения (не влияют на статус)
`manual_review[]`	Маркеры, требующие ручной проверки
`codes[]`	Коды всех сработавших проверок
`auc`	Информация об аккредитации УЦ (реестр Минцифры)
`revocation`	Статус отзыва сертификата (CRL)

Проверки при подписании (блокировка)

Настраиваются в кабинете оператора → Настройки → Валидация подписей. При включении — клиент получит отказ при попытке подписать:

Параметр (validation_checks)	Описание
`REQUIRE_INN_MATCH`	ЭЦП должна совпадать со стороной договора. Блокирует если ИНН в сертификате ≠ ИНН контрагента в системе
`REQUIRE_TRUSTED_CA`	УКЭП только из доверенного УЦ. Блокирует если УЦ не в реестре аккредитованных УЦ Минцифры РФ
`KEY_USAGE_NON_REPUDIATION`	Требовать атрибут nonRepudiation в сертификате
`REQUIRE_KC2_PLUS`	Требовать аппаратное СКЗИ (класс KC2+)
`require_ukep_strict`	Глобально блокировать все УНЭП-подписи

Список клиентов

GET api.php?action=api_1c_clients

Возвращает список всех клиентов (контрагентов) в системе.

Пример ответа

{ "success": true, "clients": [ { "id": "client002def6789", "name": "Петров Пётр Петрович", "email": "petrov@example.ru", "phone": "+79001234567", "company": "ИП Петров Пётр Петрович", "inn": "770000000001", "ogrn": "3050000000001" } ] }

Скачать ZIP-архив

GET api.php?action=api_1c_download_zip

Скачивает полный комплект документов в ZIP-архиве.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ
`id`	string	обяз.	ID документа

Содержимое архива

Файл	Описание
`Документ.pdf`	Оригинал документа
`Документ_server.sig`	Подпись администратора (CAdES-BES или OpenSSL)
`server.crt`	Сертификат сервера
`Документ_client.sig`	Подпись клиента (УКЭП) или .pep.txt (ПЭП)
`protocol.txt`	Текстовый протокол подписания
`protocol.pdf`	PDF-протокол со штампом «Подписано ЭП»

Пример запроса

curl -o signed.zip "https://cert4u.ru/api.php?action=api_1c_download_zip&id=abc123def4567890&api_key=..."

Отозвать документ

POST api.php?action=api_1c_revoke

Отзывает документ — ссылка для подписания деактивируется, клиент видит сообщение об отзыве с причиной. Нельзя отозвать уже подписанный (completed) документ.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)
`doc_id`	string	обяз.	ID документа
`reason`	string	опц.	Причина отзыва (видна клиенту)

Пример запроса

curl -X POST "https://cert4u.ru/api.php?action=api_1c_revoke&api_key=ВАШ_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{"doc_id": "a1b2c3d4e5f67890", "reason": "Ошибка в документе, будет загружена новая версия"}'

Пример ответа

{ "success": true, "message": "Документ отозван", "document": { "id": "a1b2c3d4e5f67890", "status": "revoked", "revoked_at": "2026-04-27 10:30:00", "revoke_reason": "Ошибка в документе" } }

Статусы документа

Статус	Можно отозвать?	Описание
`new`	Да	Новый, не подписан сервером
`signed_admin`	Да	Подписан сервером, не отправлен
`sent`	Да	Отправлен клиенту, ожидает подписи
`completed`	Нет	Подписан обеими сторонами
`rejected`	Да	Отклонён клиентом
`revoked`	—	Уже отозван

Серверная подпись (УКЭП из 1С без браузера)

Позволяет загрузить контейнер закрытого ключа на сервер и подписывать документы УКЭП через API — без КриптоПро Browser plug-in. Контейнер шифруется вашим PIN-кодом (AES-256-CBC), сервер PIN не хранит.

Загрузить контейнер УКЭП

POST api.php?action=api_1c_upload_container

Загружает контейнер закрытого ключа КриптоПро для серверной подписи. Контейнер шифруется вашим PIN и хранится в зашифрованном виде. Только для тенантных ключей (не admin).

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)
`pin`	string	обяз.	PIN-код (мин. 4 символа) для шифрования контейнера
`container`	file	опц.*	Файл контейнера (multipart upload)
`container_base64`	string	опц.*	Контейнер в base64 (JSON body)

* Укажите container или container_base64

Пример запроса

curl -X POST "https://cert4u.ru/api.php?action=api_1c_upload_container&api_key=ВАШ_КЛЮЧ" \ -F "pin=MySecretPin123" \ -F "container=@/path/to/container.000"

Пример ответа

{ "success": true, "message": "Контейнер загружен и зашифрован вашим PIN. Сервер НЕ хранит PIN.", "has_container": true }

Безопасность: контейнер шифруется AES-256-CBC с ключом = SHA-256(PIN + user_id). Сервер не хранит PIN. Для подписания нужно передавать PIN в каждом запросе api_1c_sign_admin.

Удалить контейнер УКЭП

POST api.php?action=api_1c_delete_container

Удаляет загруженный контейнер закрытого ключа с сервера. Только для тенантных ключей.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)

Пример запроса

curl -X POST "https://cert4u.ru/api.php?action=api_1c_delete_container&api_key=ВАШ_КЛЮЧ"

Пример ответа

{ "success": true, "message": "Контейнер удалён" }

Загрузить подписанный документ

POST api.php?action=api_1c_upload_signed

Загружает документ вместе с готовой открепленной подписью (.sig). Используется когда документ уже подписан на стороне клиента (например, в КриптоАРМ). Сервер верифицирует подпись через КриптоПро CSP и извлекает данные сертификата.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)
`document`	file	обяз.	Файл документа (PDF, DOCX и др.)
`signature`	file	обяз.	Файл подписи (.sig)
`doc_name`	string	обяз.	Название документа
`description`	string	опц.	Описание
`client_id`	string	опц.	ID клиента
`cert_info`	JSON string	опц.	Данные сертификата (если не указан — извлекаются из .sig)

Пример запроса

curl -X POST "https://cert4u.ru/api.php?action=api_1c_upload_signed&api_key=ВАШ_КЛЮЧ" \ -F "document=@/path/to/contract.pdf" \ -F "signature=@/path/to/contract.pdf.sig" \ -F "doc_name=Договор поручительства №123"

Пример ответа

{ "success": true, "document": { "id": "f1e2d3c4b5a69870", "name": "Договор поручительства №123", "status": "signed_admin", "admin_signed_at": "2026-04-22 10:30:00", "admin_cert_info": { "subject_cn": "Иванов Иван Иванович", "subject_inn": "7701234567", "issuer_cn": "Сертум-Про", "valid_to": "2027-03-15" } }, "verification": { "status": "valid", "method": "cryptcp" }, "message": "Документ загружен, подпись верифицирована" }

API для ПЭП (простая электронная подпись)

Упрощённый набор методов для работы с простой электронной подписью. Позволяет отправить документ на подписание ПЭП в один запрос.

ПЭП: отправить документ

POST api.php?action=api_1c_pep_send

Комбинированный метод: загружает документ (или использует существующий) + подписывает сервером + отправляет клиенту на ПЭП. Весь цикл за один запрос.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)
`client_id`	string	обяз.	ID клиента
`doc_id`	string	опц.	Использовать существующий документ
`document`	file	опц.	Загрузить новый файл
`doc_name`	string	опц.	Название (при загрузке нового)
`description`	string	опц.	Описание

Пример запроса (новый документ)

curl -X POST "https://cert4u.ru/api.php?action=api_1c_pep_send&api_key=ВАШ_КЛЮЧ" \ -F "client_id=client002def6789" \ -F "document=@/path/to/agreement.pdf" \ -F "doc_name=Согласие на обработку ПД"

Пример запроса (существующий документ)

curl -X POST "https://cert4u.ru/api.php?action=api_1c_pep_send&api_key=ВАШ_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{"client_id": "client002def6789", "doc_id": "a1b2c3d4e5f67890"}'

Пример ответа

{ "success": true, "document": { ... }, "sign_url": "https://cert4u.ru/client.html?token=...", "pep_code": "482917", "message": "Документ отправлен на ПЭП-подписание", "pep_send_results": { "sms": true }, "notifications": { "bitrix24": true, "telegram": true } }

ПЭП: переотправить код

POST api.php?action=api_1c_pep_send_code

Генерирует новый 6-значный код и отправляет его повторно клиенту. Документ должен быть в статусе sent.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)
`doc_id`	string	обяз.	ID документа
`method`	string	опц.	`sms`, `email` или `both` (по умолч. `sms`)

Пример ответа

{ "success": true, "pep_code": "739284", "message": "Код отправлен повторно", "send_results": { "sms": true } }

ПЭП: проверить статус

GET api.php?action=api_1c_pep_status

Возвращает текущий статус ПЭП-документа и данные клиента.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ
`doc_id`	string	обяз.	ID документа

Пример ответа

{ "success": true, "document_id": "a1b2c3d4e5f67890", "document_name": "Согласие на обработку ПД", "status": "completed", "sign_type": "pep_only", "pep_code": "482917", "client": { "id": "client002def6789", "name": "Петров Пётр Петрович", "email": "petrov@example.ru", "phone": "+79001234567" }, "created_at": "2026-03-27 14:30:00", "sent_at": "2026-03-27 14:31:00", "signed_at": "2026-03-27 15:12:00" }

ПЭП: массовая отправка

POST api.php?action=api_1c_pep_bulk

Отправляет один документ на ПЭП-подписание сразу нескольким клиентам. Для каждого клиента создаётся копия документа.

Параметры

Параметр	Тип		Описание
`api_key`	string	обяз.	API ключ (GET)
`doc_id`	string	обяз.	ID исходного документа
`client_ids`	array/string	обяз.	Массив ID клиентов или строка через запятую

Пример запроса

curl -X POST "https://cert4u.ru/api.php?action=api_1c_pep_bulk&api_key=ВАШ_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{ "doc_id": "a1b2c3d4e5f67890", "client_ids": ["client002def6789", "client003ghi0123", "client001abc2345"] }'

Пример ответа

{ "success": true, "results": [ { "client_id": "client002def6789", "client_name": "Петров Пётр Петрович", "doc_id": "f1e2d3c4b5a69870", "sign_url": "https://cert4u.ru/client.html?token=...", "pep_code": "194738" }, { "client_id": "client003ghi0123", "client_name": "Сидоров Алексей Сергеевич", "doc_id": "e2d3c4b5a6987012", "sign_url": "https://cert4u.ru/client.html?token=...", "pep_code": "582641" } ], "message": "Отправлено 2 из 3 клиентов" }

Коды ошибок

HTTP код	Сообщение	Причина
`401`	Неверный API ключ	Неправильный или отсутствующий `api_key`
`403`	API для 1С отключен	Не включён параметр `onec_api_enabled` в настройках
`404`	Документ не найден	Неправильный `doc_id` или `id`
`400`	Не указан id документа	Пропущен обязательный параметр
`400`	Документ уже подписан	Попытка повторной подписи или отправки
`429`	Превышен лимит запросов	Более 60 запросов за минуту

Формат ошибки

{ "success": false, "message": "Описание ошибки" }

Примеры кода для 1С:Предприятие

Функция HTTP-запроса (базовая)

// Общая функция для GET-запросов к API Функция ВыполнитьЗапросAPI(Действие, Параметры = "") АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; // Из настроек URL = "https://cert4u.ru/api.php?action=" + Действие + "&api_key=" + КлючAPI; Если ЗначениеЗаполнено(Параметры) Тогда URL = URL + "&" + Параметры; КонецЕсли; SSL = Новый ЗащищенноеСоединениеOpenSSL(); Соединение = Новый HTTPСоединение(АдресСервера, 443, , , , , SSL); Запрос = Новый HTTPЗапрос(URL); Ответ = Соединение.Получить(Запрос); Если Ответ.КодСостояния = 200 Тогда ЧтениеJSON = Новый ЧтениеJSON; ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку("UTF-8")); Результат = ПрочитатьJSON(ЧтениеJSON); ЧтениеJSON.Закрыть(); Возврат Результат; Иначе ВызватьИсключение "Ошибка API: " + Ответ.КодСостояния; КонецЕсли; КонецФункции

Функция POST-запроса (JSON)

// POST-запрос с JSON-телом Функция ВыполнитьPOSTЗапросAPI(Действие, ДанныеJSON) АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; URL = "https://cert4u.ru/api.php?action=" + Действие + "&api_key=" + КлючAPI; SSL = Новый ЗащищенноеСоединениеOpenSSL(); Соединение = Новый HTTPСоединение(АдресСервера, 443, , , , , SSL); Запрос = Новый HTTPЗапрос(URL); Запрос.Заголовки.Вставить("Content-Type", "application/json"); // Формируем JSON ЗаписьJSON = Новый ЗаписьJSON; ЗаписьJSON.УстановитьСтроку(); ЗаписатьJSON(ЗаписьJSON, ДанныеJSON); ТелоJSON = ЗаписьJSON.Закрыть(); Запрос.УстановитьТелоИзСтроки(ТелоJSON, "UTF-8"); Ответ = Соединение.ОтправитьДляОбработки(Запрос); ЧтениеJSON = Новый ЧтениеJSON; ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку("UTF-8")); Результат = ПрочитатьJSON(ЧтениеJSON); ЧтениеJSON.Закрыть(); Возврат Результат; КонецФункции

Загрузка файла (multipart/form-data)

// Загрузка документа через multipart/form-data Функция ЗагрузитьДокумент(ПутьКФайлу, НазваниеДокумента, IDКлиента = "") АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; URL = "https://cert4u.ru/api.php?action=api_1c_upload&api_key=" + КлючAPI; SSL = Новый ЗащищенноеСоединениеOpenSSL(); Соединение = Новый HTTPСоединение(АдресСервера, 443, , , , , SSL); Запрос = Новый HTTPЗапрос(URL); Граница = "----Boundary" + Строка(Новый УникальныйИдентификатор); Запрос.Заголовки.Вставить("Content-Type", "multipart/form-data; boundary=" + Граница); // Читаем файл ДД = Новый ДвоичныеДанные(ПутьКФайлу); ИмяФайла = Сред(ПутьКФайлу, СтрДлина(ПутьКФайлу) - СтрНайти(ПутьКФайлу, "\") + 2); // Собираем multipart body Тело = "--" + Граница + Символы.ПС; Тело = Тело + "Content-Disposition: form-data; name=""doc_name""" + Символы.ПС + Символы.ПС; Тело = Тело + НазваниеДокумента + Символы.ПС; Если ЗначениеЗаполнено(IDКлиента) Тогда Тело = Тело + "--" + Граница + Символы.ПС; Тело = Тело + "Content-Disposition: form-data; name=""client_id""" + Символы.ПС + Символы.ПС; Тело = Тело + IDКлиента + Символы.ПС; КонецЕсли; Тело = Тело + "--" + Граница + Символы.ПС; Тело = Тело + "Content-Disposition: form-data; name=""document""; filename=""" + ИмяФайла + """" + Символы.ПС; Тело = Тело + "Content-Type: application/pdf" + Символы.ПС + Символы.ПС; // Записываем через поток Поток = Новый ПотокВПамяти; ЗаписьТекста = Новый ЗаписьДанных(Поток); ЗаписьТекста.ЗаписатьСтроку(Тело, "UTF-8"); ЗаписьТекста.Записать(ДД); ЗаписьТекста.ЗаписатьСтроку(Символы.ПС + "--" + Граница + "--" + Символы.ПС, "UTF-8"); ЗаписьТекста.Закрыть(); Запрос.УстановитьТелоИзДвоичныхДанных(Поток.ЗакрытьИПолучитьДвоичныеДанные()); Ответ = Соединение.ОтправитьДляОбработки(Запрос); ЧтениеJSON = Новый ЧтениеJSON; ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку("UTF-8")); Результат = ПрочитатьJSON(ЧтениеJSON); ЧтениеJSON.Закрыть(); Возврат Результат; КонецФункции

Полный цикл: загрузка → подпись → отправка

// Полный цикл подписания документа Процедура ОтправитьДокументНаПодпись(ПутьКФайлу, НазваниеДокумента, IDКлиента) // 1. Загрузить документ РезультатЗагрузки = ЗагрузитьДокумент(ПутьКФайлу, НазваниеДокумента, IDКлиента); Если НЕ РезультатЗагрузки.success Тогда Сообщить("Ошибка загрузки: " + РезультатЗагрузки.message); Возврат; КонецЕсли; IDДокумента = РезультатЗагрузки.document.id; Сообщить("Документ загружен: " + IDДокумента); // 2. Подписать администратором ДанныеПодписи = Новый Структура("doc_id", IDДокумента); РезультатПодписи = ВыполнитьPOSTЗапросAPI("api_1c_sign_admin", ДанныеПодписи); Если НЕ РезультатПодписи.success Тогда Сообщить("Ошибка подписания: " + РезультатПодписи.message); Возврат; КонецЕсли; Сообщить("Документ подписан администратором"); // 3. Отправить клиенту ДанныеОтправки = Новый Структура; ДанныеОтправки.Вставить("doc_id", IDДокумента); ДанныеОтправки.Вставить("sign_type", "ukep_only"); // или "pep_only" РезультатОтправки = ВыполнитьPOSTЗапросAPI("api_1c_send", ДанныеОтправки); Если РезультатОтправки.success Тогда Сообщить("Отправлено! Ссылка: " + РезультатОтправки.sign_url); КонецЕсли; КонецПроцедуры

Проверка подписи и получение ИНН/СНИЛС

// Проверить подписи и получить данные сертификата Функция ПроверитьПодпись(IDДокумента) Результат = ВыполнитьЗапросAPI("api_1c_verify", "id=" + IDДокумента); Если Результат.success Тогда // Данные подписи клиента ПодписьКлиента = Результат.client_signature; Если ПодписьКлиента.valid Тогда Сообщить("Подпись клиента: ВЕРНА"); Сообщить("Тип: " + ПодписьКлиента.type); // Данные из сертификата УКЭП Если ПодписьКлиента.Свойство("stored_cert_info") Тогда Серт = ПодписьКлиента.stored_cert_info; Сообщить("ФИО: " + Серт.subject_cn); Сообщить("ИНН: " + Серт.subject_inn); Сообщить("СНИЛС: " + Серт.subject_snils); Сообщить("ОГРН: " + Серт.subject_ogrn); Сообщить("Орг.: " + Серт.subject_org); Сообщить("УЦ: " + Серт.issuer_cn); КонецЕсли; Иначе Сообщить("Подпись клиента: НЕ ВЕРНА"); КонецЕсли; КонецЕсли; Возврат Результат; КонецФункции

Скачать ZIP-архив

// Скачать подписанный комплект документов Процедура СкачатьАрхив(IDДокумента, ПутьСохранения) АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; URL = "https://cert4u.ru/api.php?action=api_1c_download_zip&id=" + IDДокумента + "&api_key=" + КлючAPI; SSL = Новый ЗащищенноеСоединениеOpenSSL(); Соединение = Новый HTTPСоединение(АдресСервера, 443, , , , , SSL); Запрос = Новый HTTPЗапрос(URL); Ответ = Соединение.Получить(Запрос); Если Ответ.КодСостояния = 200 Тогда Ответ.ПолучитьТелоКакДвоичныеДанные().Записать(ПутьСохранения); Сообщить("Архив сохранён: " + ПутьСохранения); Иначе Сообщить("Ошибка скачивания: HTTP " + Ответ.КодСостояния); КонецЕсли; КонецПроцедуры

Быстрая ПЭП-отправка (один запрос)

// ПЭП за один запрос: загрузка + подпись + отправка Функция БыстраяОтправкаПЭП(ПутьКФайлу, НазваниеДокумента, IDКлиента) АдресСервера = "cert4u.ru"; КлючAPI = "ВАШ_API_КЛЮЧ"; URL = "https://cert4u.ru/api.php?action=api_1c_pep_send&api_key=" + КлючAPI; // Аналогично ЗагрузитьДокумент(), но с action=api_1c_pep_send // Добавляем client_id в multipart form // ... (код multipart как в ЗагрузитьДокумент) // Результат содержит sign_url и pep_code Возврат Результат; КонецФункции

Массовая отправка ПЭП

// Отправить один документ нескольким клиентам Процедура МассоваяОтправкаПЭП(IDДокумента, МассивIDКлиентов) Данные = Новый Структура; Данные.Вставить("doc_id", IDДокумента); Данные.Вставить("client_ids", МассивIDКлиентов); Результат = ВыполнитьPOSTЗапросAPI("api_1c_pep_bulk", Данные); Если Результат.success Тогда Для Каждого Элемент Из Результат.results Цикл Сообщить(Элемент.client_name + ": " + Элемент.sign_url); КонецЦикла; КонецЕсли; КонецПроцедуры

Готовая обработка для 1С:Предприятие

Скачайте готовые файлы для сборки внешней обработки (.epf). Внутри — полный исходный код модулей и пошаговая инструкция по сборке в Конфигураторе 1С.

Модуль объекта

Регистрация обработки, сведения для справочника дополнительных обработок

Module_ObjectModule.bsl

Модуль формы

Вся бизнес-логика: загрузка, подпись, отправка, проверка, скачивание ZIP

Form_MainForm_Module.bsl

Инструкция

Пошаговая сборка .epf в Конфигураторе: реквизиты, формы, команды

Инструкция по сборке

Что умеет обработка

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

Загрузка документов (PDF, DOCX, XLSX)

Подписание администратором

Отправка клиенту (УКЭП / ПЭП)

Полный цикл за 1 клик

Проверка подписей (КриптоПро)

ИНН, СНИЛС, ОГРН из сертификата

Скачивание ZIP-архива

Валидация сертификата (срок, УЦ)

Массовая ПЭП-отправка

Совместимость: 1С:Бухгалтерия, 1С:УНФ, 1С:Управление торговлей, 1С:ERP, 1С:ЗУП и любая конфигурация на управляемых формах (платформа 8.3.14+).

REST API для интеграции с 1С

list Оглавление

vpn_key Аутентификация

account_tree Типовой сценарий подписания

folder Список документов

Параметры

Пример запроса

Пример ответа

Статусы документа

description Получить документ

Параметры

Пример запроса

Пример ответа

upload_file Загрузить документ

Параметры

Пример запроса (cURL)

Пример ответа

draw Подписать администратором

Параметры

Пример запроса

Пример ответа

send Отправить клиенту

Параметры

Пример запроса

Пример ответа

verified_user Проверить подписи

Параметры

Пример запроса

Пример ответа (УКЭП)

Поля stored_cert_info

Валидация подписи (63-ФЗ)

Проверки при подписании (блокировка)

people Список клиентов

Пример ответа

archive Скачать ZIP-архив

Параметры

Содержимое архива

Пример запроса

block Отозвать документ

Параметры

Пример запроса

Пример ответа

Статусы документа

key Серверная подпись (УКЭП из 1С без браузера)

upload Загрузить контейнер УКЭП

Параметры

Пример запроса

Пример ответа

delete Удалить контейнер УКЭП

Параметры

Пример запроса

Пример ответа

verified Загрузить подписанный документ

Параметры

Пример запроса

Пример ответа

sms API для ПЭП (простая электронная подпись)

sms ПЭП: отправить документ

Параметры

Пример запроса (новый документ)

Пример запроса (существующий документ)

Пример ответа

refresh ПЭП: переотправить код

Параметры

Пример ответа

info ПЭП: проверить статус

Параметры

Пример ответа

group_add ПЭП: массовая отправка

Параметры

Пример запроса

Пример ответа

error Коды ошибок

Формат ошибки

code Примеры кода для 1С:Предприятие

Функция HTTP-запроса (базовая)

Функция POST-запроса (JSON)

Загрузка файла (multipart/form-data)

Полный цикл: загрузка → подпись → отправка

Проверка подписи и получение ИНН/СНИЛС

Оглавление

Аутентификация

Типовой сценарий подписания

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

Получить документ

Загрузить документ

Подписать администратором

Отправить клиенту

Проверить подписи

Список клиентов

Скачать ZIP-архив

Отозвать документ

Серверная подпись (УКЭП из 1С без браузера)

Загрузить контейнер УКЭП

Удалить контейнер УКЭП

Загрузить подписанный документ

API для ПЭП (простая электронная подпись)

ПЭП: отправить документ

ПЭП: переотправить код

ПЭП: проверить статус

ПЭП: массовая отправка

Коды ошибок

Примеры кода для 1С:Предприятие

Готовая обработка для 1С:Предприятие

Что умеет обработка