2026-10-08 — Счёт-договор
Статус: Реализовано
Источник: Максим
Эпик: ITR-3252
Обновлено: 2026-11-10 (синхрон суммы автосчёта предоплаты ITR-3434; банковские реквизиты счёта при смене счёт-договора ITR-3427).
Цель
Дать менеджеру продаж путь «счёт-договор» для заказа покупателя: один печатный документ вместо договора + спецификации + счёта на предоплату.
В системе: договор типа «Счёт-договор» на этот заказ; счёт на предоплату — при появлении плана оплат (авто, с привязкой к договору). Печать предоплаты — через файл счёт-договора. Обычный путь не ломаем.
Контекст
Как сейчас (после реализации)
- В задачах процесса (в т.ч. создание спецификации, начало заказа, КП) можно создать счёт-договор для текущего заказа или выбрать обычный договор.
- Путь недоступен при отсрочке (бек). Предоплата и/или оплата перед отгрузкой — допустимы; сумма предоплаты + перед отгрузкой = 100%.
- Договор типа «Счёт-договор» с общей нумерацией, привязан к заказу. Счёт на предоплату создаётся автоматически при появлении плана оплат.
- На пути: не требуют файл спецификации; генерация файла договора → docx счёт-договора (тот же сценарий, шаблон
Resources/ContractInvoice.docx). - Согласование / запуск — по файлу счёт-договора.
- Этап перед отгрузкой — обычный второй счёт (свой docx).
- В таблице договоров — колонка тип; в модалке — баннер со ссылкой на заказ только у счёт-договора.
Обычный путь Путь счёт-договор
───────────────── ─────────────────
Выбрать/создать договор Создать счёт-договор
«С покупателем» только для этого заказа
+ файл спецификации + один docx «договор–счёт»
+ счёт предоплаты (docx счёта) + счёт предоплаты — авто
при появлении плана
(+ позже обычный счёт
«перед отгрузкой», если %)
UX и списки договоров
| Место | Поведение |
|---|---|
| Создание спецификации (и др. задачи с договором) | Создать счёт-договор для этого заказа или обычный договор. Чужой счёт-договор в списке не предлагать (buyerOrderId) |
| Уже привязан счёт-договор | Показать его; спецификацию скрыть; генерация файла договора = счёт-договор |
| Согласование | Файл счёт-договора |
| Запуск / план оплат | Авто-счёт на предоплату; в плане обычный docx предоплаты скрыт по linkedToInvoiceContract |
| Вкладка договоров контрагента | Оба типа; колонка тип; в модалке баннер/ссылка на заказ — только у счёт-договора |
| Список для выбора (с id заказа) | Обычные договоры + счёт-договор только этого заказа |
| Привязка / обновление на беке | Нельзя привязать чужой счёт-договор; нельзя при отсрочке; проценты = 100% |
Принятые решения
| Тема | Решение |
|---|---|
| Привязка | Один счёт-договор — один заказ |
| Счета (вариант 3) | При создании — только договор; предоплата — авто при плане; перед отгрузкой — обычный счёт |
| Генерация docx | Тот же эндпоинт генерации договора; ветка по типу + шаблон из Resources |
| Признак для UI | linkedToInvoiceContract на заказе / счетах / 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 (закрыто)
- Финансы / запуск (ITR-3372) — скрытие создания и обычного скачивания docx предоплаты при
linkedToInvoiceContract; скачивание обычного счёта «перед отгрузкой» не ломается; подписи модалок для счёт-договора. - Генерация (ITR-3381) — в шаблон счёт-договора подставляются цены / суммы.
- Файл (ITR-3400 / 3399) — после генерации документ кладётся в облачную папку, ссылка пишется в договор, docx скачивается в браузер. Выбор шаблона договора для счёт-договора недоступен (фиксированный шаблон).
- Сумма автосчёта предоплаты (ITR-3434) — при пересчёте плана оплат сумма счёта синхронизируется с суммой этапа; при уже привязанных платежах и расхождении сумм — отказ.
- Банковские реквизиты (ITR-3427) — при создании/изменении счёт-договора реквизиты и договор проставляются на существующий счёт предоплаты; смена реквизитов при уже привязанных платежах запрещена.
Вне scope
- Договор с поставщиком
- Новая ветка / новые типы задач процесса
- Выписка / архивация платежей
- Печать счёт-договора без заказа
- Выбор счёт-договора другого заказа
- Удаление счёт-договора / смена пути на обычный договор после старта
- Авто-отмена счёта при отмене заказа
- Полный дизайн выгрузки в 1С без ответа заказчика
- Отдельный эндпоинт генерации счёт-договора
Открытые вопросы (к заказчику)
- Заказ с 0% предоплаты и только оплатой перед отгрузкой: путь запретить или авто-счёт на этап «перед отгрузкой»? (сейчас бек требует сумму % = 100%, автосчёт — только на предоплату при % > 0)
- Якоря факсимиле в шаблоне счёт-договора?
- Выгрузка в 1С?