2026-08-31 — Факсимиле в печатных формах (счёт, КП, спецификация)
Статус: Реализовано
Источник: Максим
Эпик: ITR-2930
Связанные задачи: ITR-2939 (хранение и API), ITR-2940 (генерация docx), ITR-2941 (интерфейс).
Изменение после реализации (релиз 1.14.0): подстановка факсимиле из спецификации убрана. Сейчас факсимиле попадает только в счёт на оплату (встроенный шаблон, печать с подписью) и в КП (по якорям выбранного шаблона). Ниже описание спецификации оставлено как история решения.
Цель
При выгрузке Word-документов (счёт на оплату, коммерческое предложение, спецификация) автоматически подставлять факсимиле нашей организации — без ручной вставки картинок в Word после генерации.
Два варианта изображения (задаются шаблоном, не переключателем при скачивании):
- только подпись директора;
- печать с подписью (один PNG, где на изображении уже совмещены печать и подпись).
Что попадёт в конкретный документ, определяет только шаблон docx — какие из двух якорей в нём размечены.
Текстовые строки подписанта (ФИО, должность из договора) не меняются.
Контекст (как было)
Система формировала docx по шаблонам: реквизиты, товары, условия. В спецификации в блоке подписей — только текст. В счёте и КП блока с факсимиле не было. PNG подписи и печати нигде не хранились.
Поведение (как сейчас)
Настройка (один раз на организацию)
На карточке нашей организации (редактирование) блок Факсимиле — два необязательных PNG:
| Поле | Якорь в шаблоне | Смысл |
|---|---|---|
| Подпись директора | {OurOrganization.DirectorFacsimile} | Только подпись |
| Печать с подписью | {OurOrganization.Facsimile} | Печать и подпись на одном изображении |
Файлы готовятся заранее, вне системы. Не привязаны к записи подписанта в договоре.
Для обычных контрагентов блок не показывается. Можно загрузить оба файла, один или ни одного. На странице просмотра контрагента блок не отображается.
Права — как на реквизиты нашей организации (см. partner.md).
Что вставляется в документ — только через шаблон
При генерации система обходит якоря, присутствующие в используемом шаблоне. Для каждого якоря: если на организации есть соответствующий PNG — вставляет картинку; если нет или файл недоступен — место убирается (без ошибки, документ формируется дальше).
| Якорь | PNG на организации |
|---|---|
{OurOrganization.DirectorFacsimile} | Подпись директора |
{OurOrganization.Facsimile} | Печать с подписью |
Переключателя при скачивании нет. В шаблоне — один из якорей или ни одного.
Счёт — встроенный шаблон
В шаблоне счёта заранее размечен якорь {OurOrganization.Facsimile} (печать с подписью). Якорь только подписи во встроенном шаблоне счёта не используется.
В спецификации факсимиле изначально тоже подставлялось, но с релиза 1.14.0 эта подстановка убрана: спецификация формируется без картинки, блок подписей — только текстом.
КП — шаблон решает автор
КП собирается из выбранного шаблона (стандартного или своего в Google Drive). Автор шаблона сам решает, какой якорь добавить:
{OurOrganization.DirectorFacsimile}— только подпись;{OurOrganization.Facsimile}— печать с подписью;- ни одного — без факсимиле.
Ошибки при отсутствии якоря или файла быть не должно. Система загружает PNG с Drive только для якорей, реально присутствующих в выбранном шаблоне.
Общие правила генерации
- Источник PNG — «наша организация» заказа или счёта.
- Нет файла для якоря (или ошибка чтения из Drive) — якорь удаляется, документ формируется дальше.
- Текст подписанта — по прежним правилам.
Для авторов шаблонов КП
Справочник якорей доступен на странице шаблонов (кнопка просмотра якорей). Для факсимиле:
| Якорь | Что вставится |
|---|---|
{OurOrganization.DirectorFacsimile} | PNG «Подпись директора» с карточки нашей организации |
{OurOrganization.Facsimile} | PNG «Печать с подписью» |
Правила:
- в одном шаблоне — не более одного якоря факсимиле (или ни одного);
- файл на организации не загружен — место якоря в документе будет пустым (якорь убран);
- формат файлов на карточке организации — PNG.
Принятые решения
| Тема | Решение |
|---|---|
| Варианты факсимиле | Два якоря: только подпись или печать с подписью (отдельной печати без подписи нет) |
| Что и куда вставлять | Только якоря в шаблоне, без режима при скачивании |
| Счёт | Предвыбор: {OurOrganization.Facsimile} во встроенном шаблоне |
| Спецификация | Сначала как счёт; с 1.14.0 без факсимиле |
| КП | Набор якорей — на усмотрение автора шаблона |
| Чьи факсимиле | Только наши организации |
| Покупатель | Не делаем |
| Привязка | К организации, не к подписанту |
| Формат | PNG, docx |
| Просмотр карточки | Блок факсимиле только в редактировании |
Задачи эпика
| # | Задача | Содержание |
|---|---|---|
| 1 | Задача 1. Бек. Хранение факсимиле и API | Два поля, PNG в Drive, права |
| 2 | Задача 2. Бек. Подстановка факсимиле в docx | Два якоря; шаблоны счёта и спецификации; поддержка в шаблонах КП |
| 3 | Задача 3. Фронт. Блок «Факсимиле» на карточке нашей организации | Accordion на редактировании нашей организации |
| 4 | Задача 4. Документация. User docs и справочник якорей | User docs; инструкция по якорям для авторов шаблонов КП |
Критерии приёмки
- На карточке нашей организации (редактирование) — upload / preview / delete двух PNG (подпись; печать с подписью).
- Счёт и спецификация: при загруженном «печать с подписью» — картинка по
{OurOrganization.Facsimile}; без файла — без ошибки. (Для спецификации подстановка убрана в 1.14.0.) - КП: подстановка по якорю выбранного шаблона (только подпись, только печать с подписью или ни одного).
- После реализации обновлены user docs и карта системы.
Вне scope
- Факсимиле покупателя
- Отдельный якорь «только печать» без подписи
- Привязка PNG к записи подписанта
- Переключатель при скачивании docx
- PDF, договор, отгрузочные формы
- Блок факсимиле на странице просмотра контрагента