Генератор документов по шаблону
Программа или сервис, который подставляет данные в заранее подготовленный шаблон и выдает готовый документ: договор, заявление, справку или отчет в формате Word, Excel или PDF.
Генератор документов по шаблону — программа или сервис, который берет заранее подготовленный шаблон документа и подставляет в него данные: ФИО и реквизиты клиента, суммы, даты, таблицы платежей. На выходе получается готовый файл — договор, заявление, справка или отчет в формате Word, Excel или PDF. Шаблон один, документов по нему — тысячи, и все они оформлены одинаково.
Онлайн-генератор и генератор в информационной системе
Под этим названием ищут две разные вещи. Онлайн-генераторы — сайты, где человек заполняет форму и скачивает один документ: доверенность, расписку, акт. Генератор в информационной системе работает без участия человека: банковская или учетная система сама передает ему данные, и документ формируется в тот момент, когда он нужен, — например, кредитный договор при выдаче кредита. Дальше речь о втором варианте.
Как это работает
- Шаблон. Сотрудник готовит документ в Word или Excel и отмечает места для данных — поля с именами вроде
ClientNameилиLoanAmount. Для повторяющихся строк, например графика платежей, в шаблоне размечают строку таблицы, которую генератор размножит. - Данные. Система, которой нужен документ, отправляет генератору идентификатор шаблона и набор значений — обычно через REST API.
- Сборка. Генератор открывает копию шаблона, заменяет поля значениями, заполняет таблицы и при необходимости конвертирует результат в PDF.
- Выдача. Готовый файл возвращается системе, сохраняется в архив или сразу скачивается на компьютер сотрудника.
Так выглядит HTTP-запрос к генератору с данными в формате JSON:
POST /api/documents
{
"templateId": "credit-agreement",
"data": {
"ClientName": "Иванов Иван Иванович",
"LoanAmount": "1 500 000,00",
"Schedule": [
{ "date": "15.12.2026", "payment": "31 250,00" },
{ "date": "15.01.2027", "payment": "31 250,00" }
]
}
}
Как это выглядит в коде
Документы Word и Excel — это архивы с XML-файлами внутри (формат Office Open XML), поэтому генератору не нужен установленный Microsoft Office: с файлами работают библиотеки. Пример на C# с библиотекой Open XML SDK — найти в документе поле ClientName и вписать в него значение:
// C#
using System.Linq;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
using var doc = WordprocessingDocument.Open("dogovor-12345.docx", true);
var field = doc.MainDocumentPart.Document.Body
.Descendants<SdtElement>()
.First(f => f.SdtProperties.GetFirstChild<Tag>()?.Val?.Value
== "ClientName");
field.Descendants<Text>().First().Text = "Иванов Иван Иванович";
Для таблиц Excel в .NET используют, например, EPPlus или ClosedXML, в Java для обоих форматов — Apache POI.
Что важно предусмотреть
- Управление шаблонами. Шаблоны меняются чаще кода: юристы правят формулировки, меняются реквизиты. Удобно, когда новую версию шаблона загружают через отдельный метод или интерфейс, без выпуска новой версии программы, а прежние версии сохраняются — чтобы при споре можно было показать, по какому шаблону собран документ.
- Форматирование. Длинные ФИО и суммы прописью не должны ломать верстку; числа, даты и суммы форматируются по одним правилам.
- Нагрузка. В пиковые дни документов становится в разы больше. Генератор, вынесенный в отдельный сервис в духе микросервисов, масштабируют отдельно от основной системы.
- Журнал. Каждый запрос и каждая ошибка записываются: какой шаблон, какие данные, кто запросил.
- Безопасность. В документах — персональные данные, поэтому доступ к API генератора ограничивают, а соединение шифруют.
Генератор документов в банке: пример КПР
КПР разработала и внедрила сервис генерации документов для Банка Зенит. Генератор работает на отдельном сервере. Система банка на платформе Diasoft Flextera вызывает его через REST API и передает параметры в JSON, сервис подставляет их в шаблон договора Word (.dotx) или таблицы Excel (.xlsx), а готовый документ скачивается на компьютер сотрудника. Второй метод API добавляет, обновляет и удаляет шаблоны. Сервис написан на .NET (ASP.NET Core) с библиотеками Open XML SDK, Open-Xml-PowerTools и EPPlus, работает с базой данных банка в Oracle через ORM Entity Framework Core, ведет журнал в базе и описан в Swagger. Он не заменяет другие способы формирования документов, которые есть в банке, а работает рядом с ними.
Другие проекты КПР для Банка Зенит — в кейсах. О работе КПР с банковскими системами — на странице «Внедрение и сопровождение АБС ЦФТ и Диасофт», а что такое АБС, объясняет отдельный термин.