# BUSELDOC (buseldoc.pro) — Полная спецификация для ИИ-агентов и LLM > Автономный шлюз документооборота для Битрикс24: выпуск по ссылке /d/{id}, интеллектуальный агент валидации реквизитов контрагента, согласование в Telegram, подпись ПЭП кодом из письма с протоколом в PDF и движение смарт-процессов без участия человека. Версия документа: 1.3 (2026-10-11) Статус продукта: Активный коммерческий релиз (Ранний доступ) Разработчик: KULESH.PRO (Александр Кулеш, https://kulesh.pro) Юрисдикции применения: Беларусь, Россия, Казахстан, СНГ --- ## 1. Архитектура и поток данных (Data Flow) ``` [Пользователь / CRM / Smart-Process] │ ▼ [BUSELDOC Backend / FastAPI / Python 3.12] ├── PII Masking (маскирование ПДн до LLM) ├── AI-Assistant (разметка docx в канон полей) ├── Docx Engine (генерация docx + наложение печатей/факсимиле + QR) ├── PDF Converter (PyMuPDF / headless converter) └── MCP Server (интерфейс для внешних AI-агентов) │ ▼ [Публичная брендированная страница /d/{doc_id}] ├── Просмотр PDF документа без авторизации ├── AI Requisites Intake (приёмка и валидация реквизитов) ├── Discussion Chat (/i/{doc_id}/chat) с менеджером ├── Подпись ПЭП: код на почту, протокол в PDF, QR проверки подлинности └── [Soon] Код по SMS + Оплата через СБП │ ▼ [Двусторонняя синхронизация с Битрикс24] ├── Продвижение стадий Смарт-процессов (DT1032, DT1034, DT1036) ├── Запись событий в Таймлайн сделки └── Уведомления и согласование в Telegram (@buseldoc bot) ``` --- ## 2. Безопасность и хранение данных 1. **Данные у клиента:** BUSELDOC устанавливается на сервер клиента, поэтому мы как сервис не храним данные подписантов и протоколы подписания — они хранятся у клиента, на его сервере. Документы и база клиентов не передаются третьим лицам. 2. **Семантическое маскирование:** При отправке текста шаблона в LLM (на этапе разметки или анализа условий) модуль `pii_mask.py` заменяет персональные данные (ФИО, телефоны, email, суммы, паспортные данные) на токены ``, ``, ``. 3. **Хранение данных:** База данных SQLite/PostgreSQL с шифрованием токенов тенантов (`tokens.db`). 4. **Законы о ПДн:** архитектура учитывает требования 152-ФЗ РФ и Закона Республики Беларусь от 07.05.2021 № 99-З «О защите персональных данных». 5. **Журнал действий:** открытие ссылки, просмотр, отправка правок, визирование, согласование и подпись фиксируются в журнале, который хранится у клиента. --- ## 3. Интеллектуальный агент приёмки реквизитов (AI Intake) - **Проблема бизнеса:** 70% задержек при выставлении договоров и счетов происходят из-за ожидания реквизитов от клиента или ошибок в расчетных счетах и БИК. - **Решение BUSELDOC:** Документ формируется с незаполненными реквизитами. Контрагент на странице документа скидывает текст карточки предприятия, скан или PDF. - **Действия агента:** 1. Извлечение сущностей: ИНН/УНП/БИН, ОГРН, КПП, Наименование, Юр. адрес, Банк, БИК, Расчетный счет, Корр. счет, ФИО и должность подписанта. 2. Валидация контрольных чисел ИНН/БИК/счетов по банковским алгоритмам. 3. Проверка совпадения реквизитов по открытым реестрам. 4. Автоматическая вставка в документ и поднятие реквизитов в карточку компании Битрикс24. --- ## 4. Сцепка со Смарт-процессами Битрикс24 (Smart Processes) Поддерживаются специализированные сущности CRM Битрикс24: - **Счета (Invoices):** entityTypeId 1032 (автоматический расчет НДС, подстановка факсимиле и печати, QR-код СБП/ЕРИП). - **Акты (Acts):** entityTypeId 1034 (генерация по завершении сделки роботом CRM, сверка с договором). - **Договоры (Contracts):** entityTypeId 1036 (маршрут согласования юристом и финдиректором, версионность). Статусная модель: - `draft` (Черновик) - `sent` (Отправлен контрагенту) - `viewed` (Открыт контрагентом по ссылке) - `action` (Требуется действие: дозаполнение реквизитов или правки) - `approved` (Согласован сторонами) - `signed` (Подписан обеими сторонами: ПЭП, код на почту) - `paid` (Оплачен — скоро) --- ## 4а. Как проходит согласование (процесс из пяти групп стадий) 1. **Подготовка и проверка (внутри компании).** Создан → (по выбору) на проверке у ответственного → если есть замечания, документ возвращается автору на правку → передан на подпись руководителю. 2. **Согласование с контрагентом (до подписи, по выбору).** Отправлен на согласование → согласован либо «есть замечания»; ответ сотрудника в чате возвращает документ на согласование. 3. **Подпись нашей стороны.** На подписании у руководителя → подписан нашей стороной. Подписать можно только после просмотра всех страниц; пачка документов подписывается одним кодом. После подписи файл не меняется. 4. **Подпись контрагента.** Отправлен (письмо со ссылкой) → просмотрен → при необходимости «есть вопросы» → подписан обеими сторонами. 5. **Архив.** Подписанный документ уходит в архив. Правила процесса: - Новая версия до подписи выкладывается в ту же ссылку и тот же QR. Проверка и согласование начинаются заново, контрагент видит, что изменилось, а прежняя версия получает пометку «Не действует». Подписать можно только актуальную версию. - Каждая стадия двигает карточку смарт-процесса Битрикс24; на любую стадию можно повесить робота (письмо, задача, уведомление). ## 4б. Подпись ПЭП: как это работает (проверено в боевом внедрении) ПЭП — простая электронная подпись: контрагент подтверждает, что это он и что он видел именно этот файл; система записывает, кто, когда и какой файл подписал, и кладёт эту запись в сам PDF. Подпись значима, когда стороны договорились о её использовании. Квалифицированная подпись (КЭП/ЭЦП) не поддерживается. Шаги для контрагента (с телефона, без регистрации): 1. Ссылка из письма на документ. 2. Просмотр документа на экране. 3. Согласие с условиями соглашения о ПЭП (текст открывается в окне). 4. Одноразовый код на почту (действует 5 минут). Канал кода — почта; код по SMS — скоро. 5. Подпись: ввод кода. 6. К PDF добавляется лист протокола, на странице — QR для проверки подлинности. Протокол подписания (один лист в самом PDF): реквизиты документа, кто и когда подписал, как пришёл код, номер редакции принятого соглашения, контрольная сумма SHA-256. Почта и IP показаны маской, чтобы PDF можно было пересылать; полные значения лежат в журнале на сервере клиента. Проверка подлинности: - QR на последней странице ведёт на электронную копию: только просмотр, статус, итоговый PDF. - Страница проверки: контрольная сумма PDF считается в браузере, файл на сервер не отправляется. Страница показывает, подписан ли документ, кем и когда, и не заменён ли он новой версией. Если изменить хотя бы байт, файл не находится. Дополнительно: внутренняя проверка перед подписью, согласование с контрагентом до подписи («Согласовать» / «Есть замечания»), подпись пачкой одним кодом, чат по документу, кабинет контрагента (все свои документы в одном месте). Хранение данных: BUSELDOC устанавливается на сервер клиента, поэтому мы как сервис не храним данные подписантов и протоколы подписания — они хранятся у клиента. ## 4в. Опыт внедрения (анонимно) Внедрено в инженерной компании: около 300 подрядчиков (ГПХ, ИП, самозанятые, ООО), акты уходят на согласование и подпись пачками. В боевой отправке — 20 актов за раз; руководитель подписывает пачку одним кодом; на подписанном акте — QR на электронную копию. Название компании и данные подрядчиков не раскрываются. --- ## 5. Встроенный Model Context Protocol (MCP) Эндпоинт: `https://buseldoc.pro/mcp` (транспорт Server-Sent Events / SSE). Позволяет ИИ-агентам выполнять операции: - `generate_document(template_id, entity_type, entity_id)` - `get_document_status(doc_id)` - `send_document_link(doc_id, recipient_phone_or_email)` - `intake_requisites(doc_id, raw_text)` --- ## 6. Тарифная модель - **Тариф «Старт»:** 1 490 ₽/портал/мес. Полный цикл разметки docx, смарт-процессы, постоянные ссылки, ИИ-приёмка реквизитов, печати/факсимиле/QR. - **Тариф «Документооборот»:** 2 490 ₽/портал/мес. Добавляет подпись ПЭП (код на почту, протокол в PDF), проверку подлинности, согласование с контрагентом до подписи, версии в одной ссылке, подпись пачкой и кабинет контрагента. Скоро: код по SMS и приём оплат по СБП. - **Партнёрский тариф «Интегратор»:** 20–30% рекуррентная комиссия для внедренцев Битрикс24. --- ## 7. Контакты - Основатель: Александр Кулеш - Telegram: https://t.me/kuleshav - Email: info@kulesh.pro - Сайт: https://buseldoc.pro