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

2026-10-08 — Счёт-договор

Статус: Реализовано

Источник: Максим

Эпик: ITR-3252

Обновлено: 2026-11-10 (синхрон суммы автосчёта предоплаты ITR-3434; банковские реквизиты счёта при смене счёт-договора ITR-3427).

Цель​

Дать менеджеру продаж путь «счёт-договор» для заказа покупателя: один печатный документ вместо договора + спецификации + счёта на предоплату.

В системе: договор типа «Счёт-договор» на этот заказ; счёт на предоплату — при появлении плана оплат (авто, с привязкой к договору). Печать предоплаты — через файл счёт-договора. Обычный путь не ломаем.

Контекст​

Как сейчас (после реализации)​

  1. В задачах процесса (в т.ч. создание спецификации, начало заказа, КП) можно создать счёт-договор для текущего заказа или выбрать обычный договор.
  2. Путь недоступен при отсрочке (бек). Предоплата и/или оплата перед отгрузкой — допустимы; сумма предоплаты + перед отгрузкой = 100%.
  3. Договор типа «Счёт-договор» с общей нумерацией, привязан к заказу. Счёт на предоплату создаётся автоматически при появлении плана оплат.
  4. На пути: не требуют файл спецификации; генерация файла договора → docx счёт-договора (тот же сценарий, шаблон Resources/ContractInvoice.docx).
  5. Согласование / запуск — по файлу счёт-договора.
  6. Этап перед отгрузкой — обычный второй счёт (свой docx).
  7. В таблице договоров — колонка тип; в модалке — баннер со ссылкой на заказ только у счёт-договора.
Обычный путь                         Путь счёт-договор
───────────────── ─────────────────
Выбрать/создать договор Создать счёт-договор
«С покупателем» только для этого заказа
+ файл спецификации + один docx «договор–счёт»
+ счёт предоплаты (docx счёта) + счёт предоплаты — авто
при появлении плана
(+ позже обычный счёт
«перед отгрузкой», если %)

UX и списки договоров​

МестоПоведение
Создание спецификации (и др. задачи с договором)Создать счёт-договор для этого заказа или обычный договор. Чужой счёт-договор в списке не предлагать (buyerOrderId)
Уже привязан счёт-договорПоказать его; спецификацию скрыть; генерация файла договора = счёт-договор
СогласованиеФайл счёт-договора
Запуск / план оплатАвто-счёт на предоплату; в плане обычный docx предоплаты скрыт по linkedToInvoiceContract
Вкладка договоров контрагентаОба типа; колонка тип; в модалке баннер/ссылка на заказ — только у счёт-договора
Список для выбора (с id заказа)Обычные договоры + счёт-договор только этого заказа
Привязка / обновление на бекеНельзя привязать чужой счёт-договор; нельзя при отсрочке; проценты = 100%

Принятые решения​

ТемаРешение
ПривязкаОдин счёт-договор — один заказ
Счета (вариант 3)При создании — только договор; предоплата — авто при плане; перед отгрузкой — обычный счёт
Генерация docxТот же эндпоинт генерации договора; ветка по типу + шаблон из Resources
Признак для UIlinkedToInvoiceContract на заказе / счетах / payment-summary / schedule
ШаблонResources/ContractInvoice.docx
МодалкаТип и заказ — баннер «Счёт-договор привязан к заказу (№ …)» (отдельное поле «Тип» не требуется)

Задачи эпика​

#ЗадачаСтатус
1Задача 1. Бек. Договор «Счёт-договор», счёт предоплаты, правила (ITR-3305)Сделано
2Задача 2. Бек. Генерация docx и поведение запуска (ITR-3306)Сделано
3Задача 3. Фронт. Путь счёт-договор в задачах и договорах (ITR-3307)Сделано
4Задача 4. Документация. User docs и картаСделано
—ITR-3372 Остатки UI (финансы / запуск / заголовки)Сделано
—ITR-3381 / 3399 / 3400 — суммы в docx, автоскачивание, сохранение файла в облакоСделано

Критерии приёмки​

  • Счёт-договор создаётся для текущего заказа; чужой привязать нельзя. Счёт на предоплату появляется автоматически с планом оплат и связан с договором.
  • Нумерация единая с договорами нашей организации.
  • На пути: нет обязательной спецификации; печать предоплаты — через файл договора (шаблон из Resources).
  • В таблице договоров — колонка тип; в модалке — баннер/ссылка на заказ у счёт-договора.
  • Согласование — по файлу счёт-договора.
  • Отсрочка блокирует путь (бек); перед отгрузкой — обычный второй счёт.
  • Обычный путь не сломан; user docs и карта обновлены.
  • UI финансов / запуска: create и обычный download docx предоплаты скрыты на пути счёт-договор; у этапа «перед отгрузкой» обычный счёт доступен; заголовки модалок учитывают тип.
  • После генерации файл счёт-договора сохраняется в облако (ссылка на договоре) и скачивается; в docx подставляются суммы заказа.

Доработки после v1 (закрыто)​

  1. Финансы / запуск (ITR-3372) — скрытие создания и обычного скачивания docx предоплаты при linkedToInvoiceContract; скачивание обычного счёта «перед отгрузкой» не ломается; подписи модалок для счёт-договора.
  2. Генерация (ITR-3381) — в шаблон счёт-договора подставляются цены / суммы.
  3. Файл (ITR-3400 / 3399) — после генерации документ кладётся в облачную папку, ссылка пишется в договор, docx скачивается в браузер. Выбор шаблона договора для счёт-договора недоступен (фиксированный шаблон).
  4. Сумма автосчёта предоплаты (ITR-3434) — при пересчёте плана оплат сумма счёта синхронизируется с суммой этапа; при уже привязанных платежах и расхождении сумм — отказ.
  5. Банковские реквизиты (ITR-3427) — при создании/изменении счёт-договора реквизиты и договор проставляются на существующий счёт предоплаты; смена реквизитов при уже привязанных платежах запрещена.

Вне scope​

  • Договор с поставщиком
  • Новая ветка / новые типы задач процесса
  • Выписка / архивация платежей
  • Печать счёт-договора без заказа
  • Выбор счёт-договора другого заказа
  • Удаление счёт-договора / смена пути на обычный договор после старта
  • Авто-отмена счёта при отмене заказа
  • Полный дизайн выгрузки в 1С без ответа заказчика
  • Отдельный эндпоинт генерации счёт-договора

Открытые вопросы (к заказчику)​

  1. Заказ с 0% предоплаты и только оплатой перед отгрузкой: путь запретить или авто-счёт на этап «перед отгрузкой»? (сейчас бек требует сумму % = 100%, автосчёт — только на предоплату при % > 0)
  2. Якоря факсимиле в шаблоне счёт-договора?
  3. Выгрузка в 1С?

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