Микросервис для автоматического формирования DOCX и PDF. Договоры, ваучеры, акты, счета — за сотни миллисекунд, прямо из вашей CRM, ERP или портала.
Заменяет ручное заполнение шаблонов, разрозненные офисные надстройки и тяжёлые монолитные генераторы. Один микросервис — все ваши документы.
docker compose up — и сервис готов к работе.Полный набор функций для промышленной генерации документов: от простых подстановок до сложных таблиц и многоформатного экспорта.
Готовите шаблон в Word / АльтерОфис, ставите плейсхолдеры:
{{ClientName}} — подстановка{{table.Items.Name}} — строки таблицы{{Table:Items,col=Услуга}} — динамическая таблицаПараметр "Format" в запросе. PDF — через headless АльтерОфис в Docker-образе. Шрифты DejaVu/Liberation в комплекте.
Табличные данные массивом — сервис клонирует строки и подставляет значения. Новые таблицы — по плейсхолдеру.
Модель «Приложение → Интеграция → Тип документа → Шаблон». Десятки клиентов в одной установке, у каждого свой API-ключ.
Уникальный X-API-Key у каждой системы. Логи Serilog, OpenTelemetry трейсы, health-checks с СУБД.
Машиночитаемая спецификация /openapi/v1.json. UI: Scalar /scalar/v1, Swagger /api-docs. Версионирование шаблонов и FluentValidation на входе.
{{ClientName}}, {{TotalAmount}}./Template/Upload (multipart, ≤ 20 МБ) или /Template/Create (Base64). Привязка к типу документа.POST /Builder/BuildDoc с DocumentTypeId, полями, таблицами и "Format".# Сборка PDF документа по типу "Договор реализации турпродукта" curl -X POST "https://docbuilder.local/Builder/BuildDoc" \ -H "X-API-Key:touroffice-default
" \ -H "Content-Type: application/json" \ -d '{ "DocumentTypeId": "e8a0c9e2-...-...-...", "Format": "Pdf", "Fields": { "ClientName": "ООО «Ромашка»", "OrderNumber": "TST-001", "OrderDate": "27.05.2026", "TotalAmount": 125400 }, "Tables": { "Items": [ {"Name":"Тур в Турцию", "Qty":2, "Price":55000}, {"Name":"Страховка", "Qty":2, "Price":7700} ] } }' \ --output ./contract.pdf # → 200 OK · application/pdf · 14 КБ · 380 мс
Спроектирован как универсальный backend-сервис документооборота. Подключается к любой бизнес-системе, работающей с типовыми деловыми документами.
Ваучеры, договоры реализации турпродукта, заявки.
Подстановка данных контрагентов, условий и реквизитов.
Первичные документы на основе данных из 1С и учётных систем.
Регулярные отчёты по расписанию — финансовые, операционные.
Массовая рассылка персонализированных DOCX/PDF приложений.
Bitrix24, 1С, собственная система — через стандартный REST API.
Сервис генерации в составе ECM/СЭД на шагах бизнес-процесса.
Изолированный микросервис для b2b: свои шаблоны и ключ у каждого клиента.
Отечественный стек (Linux, PostgreSQL, АльтерОфис) под импортозамещение.
Промышленная серверная архитектура: stateless API + PostgreSQL. Развёртывается одной
командой docker compose up --build -d на любом современном Linux-сервере.
| CPU | 2 vCPU (мин.) / 4–8 vCPU (рек.) |
| ОЗУ | 4 ГБ (мин.) / 8–16 ГБ (рек.) |
| Диск | 10 ГБ / 50 ГБ SSD |
| Сеть | 100 Мбит/с — 1 Гбит/с |
| Производительность | до 20 RPS на инстанс |
| ОС | Astra Linux SE, РЕД ОС, ALT Server, РОСА, Ubuntu 22.04+, Debian 12, Windows Server 2019/2022 |
| Среда | Docker Engine 24.x+, Compose v2 |
| СУБД | PostgreSQL 13+ (рек. 16) |
| АльтерОфис (в Docker-образе) | |
| Прокси | nginx 1.22+ / Angie / HAProxy / Apache |
| Платформа | ASP.NET Core 8 (.NET 8 LTS) |
| Архитектура | Clean Architecture / Onion |
| ORM | EF Core 8 + Npgsql |
| Шаблонизатор | Open XML SDK |
| Логи / Телеметрия | Serilog + OpenTelemetry (OTLP) |
| Поставка | Docker-образ + исходный код .NET 8 |
| Версия | 1.0 |
| Развёртывание | 5–15 минут |
| Лимит шаблона | 10 МБ JSON / 20 МБ multipart |
| Лицензии | MIT, Apache 2.0, MPL 2.0, PostgreSQL |
Чистый REST + JSON. Никаких клиентских SDK, библиотек или плагинов в офисных пакетах. Подключается к любой системе на любом языке программирования.
GET /health проверяет API и СУБД, отдаёт 200 Healthy.GET /Integration/Check POST /Integration/CreateIntegration GET /Application/GetApplications GET /DocumentType/GetDocumentTypes GET /Template/GetTemplateById GET /Template/GetTemplateByName GET /Template/GetTemplateByDocumentTypeId POST /Template/Create POST /Template/Upload POST /Builder/BuildDoc GET /health GET /openapi/v1.json GET /scalar/v1 GET /api-docs
Промышленные технологии Microsoft .NET и Open Source, развёрнутые на отечественной ОС и совместимом офисном пакете.
В составе дистрибутива поставляется техническая документация, оформленная по требованиям ЕСПД и Минцифры. Готовая для прохождения экспертизы.
Пошаговая установка через Docker, настройка nginx, резервное копирование.
Назначение, функции, архитектура, технологии, лицензии сторонних компонентов.
Работа с шаблонами, API-ключами, форматы плейсхолдеров и таблиц.
Конфигурация, мониторинг, резервное копирование, обновление.
Регламент устранения дефектов, версии, SLA, контактные данные.
Информационное письмо о хранилище кода и процессе сборки.
"Format"). PDF — через headless АльтерОфис, встроенный в Docker-образ. Шрифты DejaVu / Liberation в комплекте, кириллица гарантирована.X-API-Key (= ExternalClientId интеграции) в заголовке. Эндпоинты создания интеграций защищены отдельным «ключом регистрации» от правообладателя.Покажем работающий сервис на ваших шаблонах. Установка и демонстрация — за один рабочий день.
Оставьте заявку — наш специалист свяжется с вами, проведёт демонстрацию и подготовит коммерческое предложение под ваши задачи.