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

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, договор, отгрузочные формы
  • Блок факсимиле на странице просмотра контрагента

Связанные материалы​