2026-10-22 — Один счёт: предоплата и оплата перед отгрузкой
Статус: Задачи созданы
Источник: Максим Марченко
Эпик: ITR-3375
Цель
Выставлять клиенту один счёт на оплату с двумя блоками внутри (предоплата и оплата перед отгрузкой), чтобы клиент не путался между двумя номерами и не доплачивал «не туда». Логику плана этапов (% и суммы предоплаты / перед отгрузкой / окончательной) не менять: запуск по-прежнему после набора суммы предоплаты, ожидание оплаты перед отгрузкой — по своему этапу.
Контекст
Как сейчас
- По заказу строится план оплат: этапы предоплата, перед отгрузкой, окончательная (по %).
- На каждый этап менеджер выставляет отдельный счёт со своим номером и печатной формой. В БД у счёта одна привязка к этапу плана.
- У счёта одна сумма, опционально один % в печати, поле «срок оплаты» — число дней (по умолчанию 10) от даты счёта, одно на весь документ.
- Клиент получает два счёта → путает номера / доплачивает по предоплатному → сложно разнести платежи.
- Запуск «после предоплаты» смотрит оплату счетов этапа предоплаты.
- Путь счёт-договор: авто-счёт только на предоплату; печать предоплаты — через файл счёт-договора; этап перед отгрузкой — обычный второй счёт со своим номером (см. invoice-contract.md).
Как должно быть
- Если в заказе заданы и % предоплаты, и % перед отгрузкой — клиенту выставляется один счёт на сумму обоих этапов, с одним номером и двумя блоками в печатной форме.
- Старый способ (отдельный счёт на предоплату и отдельный на «перед отгрузкой») для таких заказов закрываем: создать второй номер на эту пару этапов нельзя.
- Уже выставленные отдельные счета на живых заказах не трогаем (не мигрируем, не отменяем автоматически). Новая возможность — для новых выставлений.
- Платежи приходят на один номер; система относит их к этапам по порогам сумм (сначала предоплата, затем перед отгрузкой).
- Для запуска достаточно оплаты ≥ сумма блока/этапа предоплаты, а не Paid всего счёта.
- Окончательная — по-прежнему отдельный счёт.
- Если только один из двух этапов — как сейчас, без объединения.
Сейчас Цель (новые выставления)
───── ────────────────────────
Счёт №A — предоплата Счёт №A — предоплата + перед отгрузкой
Счёт №B — перед отгрузкой (два блока, один номер)
Счёт №C — окончательная (если есть) Счёт №C — окончательная (если есть)
Уже выставленные A+B на старых заказах — без изменений
Сценарии
- Обычный заказ 50% / 50%. Создают один объединённый счёт. Клиенту — один документ с двумя блоками. Первая оплата закрывает предоплату → запуск. Дальше — этап перед отгрузкой по порогу.
- Счёт-договор. При появлении плана автосоздаётся объединённый счёт (сумма обоих этапов). Отдельный второй номер на «перед отгрузкой» не создаётся. Печать — см. раздел про счёт-договор.
- Только предоплата 100% / только перед отгрузкой. Без объединения, как сейчас.
- Корректировка заказа. Суммы блоков в форме счёта редактируемые (как сейчас сумма счёта) — можно скорректировать после изменения заказа; с предупреждением при отклонении от рекомендации.
- Старый заказ с двумя счетами. Работает как раньше; новый объединённый на ту же пару не навязываем миграцией. Когда оба этапа ещё без «старой пары» / менеджер выставляет впервые при двух % — только новый способ.
UI (ожидание)
| Место | Поведение |
|---|---|
| Финансы / план / счета | На предоплате и «перед отгрузкой» — один номер. Создать отдельный счёт на второй этап пары — нельзя. |
| Форма счёта | Два блока (суммы редактируемые), итог, ориентиры сроков (см. ниже). |
| Печать обычного счёта | Один номер, два блока условий оплаты, одни реквизиты. |
| Запуск / счёт-договор | Согласованы с единым счётом; без второго номера на «перед отгрузкой». |
| Разбор платежей | Привязка к этому счёту; по этапам — закрытие по порогам. |
Принятые решения
| Тема | Решение |
|---|---|
| Номер | Один номер у объединённого счёта — обязательно |
| Когда объединять | Оба % > 0 (предоплата и перед отгрузкой) |
| Старый способ | Для таких заказов закрываем (нельзя выставить два независимых счёта на эту пару) |
| Уже выставленные | Не трогаем |
| Суммы блоков | Редактируемые (как сейчас сумма счёта), рекомендация из плана; коррекция после изменения заказа |
| План этапов | % и логика этапов не меняем; меняется выставление и учёт оплаты по порогам |
| Запуск | По порогу предоплаты по объединённому счёту, не по Paid всего счёта |
| Окончательная | Отдельный счёт |
Хранение и работа с привязкой к этапу (к проработке)
Сейчас у счёта обязательная привязка к одному этапу плана (PaymentSchedule). Прямой ссылки на заказ нет (заказ — через этап). Объединённый счёт должен закрывать два этапа при одном номере.
Вариант C — ссылка на заказ + тип счёта (предложение к обсуждению)
Идея: у счёта явная ссылка на заказ и поле тип счёта, а не «обязательно один этап».
| Тип счёта | Смысл | Какие этапы плана закрывает |
|---|---|---|
| Предоплата | Как сейчас для одного этапа | Только предоплата |
| Перед отгрузкой | Как сейчас | Только перед отгрузкой |
| Предоплата + перед отгрузкой | Новый объединённый | Оба (пороги по суммам блоков) |
| Окончательная | Как сейчас | Только окончательная |
| Другое | Как сейчас (в т.ч. импорт) | Этап «Другое» / вне стандартной пары |
Дополнительно для типа «Предоплата + перед отгрузкой»: две редактируемые суммы блоков; итог счёта = сумма блоков.
Старые счета: не мигрируем принудительно; тип можно вывести из текущего этапа плана при чтении или один раз проставить в БД без смены сумм/номеров. Старый способ создания пары «два типа по одному этапу» при обоих % > 0 — закрываем в пользу объединённого типа.
План этапов остаётся отдельной сущностью (даты, %, суммы плана). Счёт больше не «принадлежит» одному этапу как единственный ключ; UI/financials: этап видит счета заказа, чей тип покрывает этот этап.
Плюсы: язык ближе к продукту («какой счёт выставили»); объединённый тип без костыля «основной этап = предоплата»; проще запретить второй номер на пару. Минусы: миграция смысла PaymentScheduleId (ослабить / убрать / оставить необязательным для совместимости); все места «счета этапа» перевести на «счета заказа по типу»; запуск и счёт-договор завязать на тип + порог блока предоплаты.
Вариант A — основной этап + суммы блоков
Счёт по-прежнему FK на этап предоплаты + две суммы блоков; «перед отгрузкой» видит счёт по признаку. Меньше смены схемы, больше спец-логики.
Вариант B — M:N счёт ↔ этапы
Явные связи с суммами на каждый этап. Гибко, дороже во внедрении.
Несколько счетов на «долю»
В v1: на пару этапов — один активный счёт типа «Предоплата + перед отгрузкой»; правка сумм или отмена + перевыставление. Несколько активных объединённых снова дают несколько номеров.
Рабочая гипотеза: вариант C предпочтительнее A/B для цели эпика; на оценке бека — судьба PaymentScheduleId (nullable / deprecate) и справочник типов.
Сроки в двух блоках печати — подробнее
Как сейчас (один этап → один счёт)
| Что | Откуда |
|---|---|
| Дата счёта | Дата выставления |
| «Срок оплаты» в документе | Поле счёта — число дней (обычно 10), одно на весь счёт |
| % в печати | Опционально один %, если сумма = рекомендации этапа и этап не 100% |
| Дата этапа плана | В печати счёта не как отдельный второй срок; живёт в плане оплат |
То есть клиент по обычному счёту видит в основном: сумму, реквизиты, срок в днях от даты счёта — не «оплатить предоплату до D1, остаток до D2».
Что нужно для двух блоков
В каждом блоке как минимум: название этапа, %, сумма. Вопрос — какой ориентир срока писать во втором блоке (и в первом), чтобы клиент понимал, когда что платить, и чтобы это не спорило с полем «срок оплаты» в шапке.
| Вариант | Блок «Предоплата» | Блок «Перед отгрузкой» | Плюсы / минусы |
|---|---|---|---|
| 1. Даты этапов плана | Дата этапа предоплаты | Дата этапа перед отгрузкой | Близко к cashflow; даты могут быть пустыми / сдвигаться до отгрузки |
| 2. Один срок счёта на оба | Одинаково: «в течение N дней с даты счёта» | То же | Просто; плохо для «перед отгрузкой» (срок далеко в будущем) |
| 3. Смешанный (предложение) | «В течение N дней с даты счёта» (текущее поле DueDate) | Плановая дата этапа перед отгрузкой (или «перед отгрузкой» без календарной даты, если даты ещё нет) | Честно отражает практику: предоплату ждут сразу, вторую — к отгрузке |
| 4. Два поля дней на счёте | Свои N дней | Свои M дней | Гибко; сложнее форма и смысл для клиента |
Предложение в ТЗ (к подтверждению): вариант 3 — в шапке/первом блоке сохранить привычный срок в днях для предоплаты; во втором блоке — ориентир по дате этапа «перед отгрузкой» (или формулировка без даты, если этап ещё без даты). Поле DueDate счёта одно, как сейчас.
Счёт-договор — подробнее
Как сейчас (ITR-3252)
- Договор типа «Счёт-договор» на этот заказ; один печатный файл договора (шаблон счёт-договора) вместо договора + спеки + счёта предоплаты.
- При появлении плана оплат авто создаётся счёт на этап предоплаты (сумма только предоплаты), с привязкой к договору; ручной init/add предоплаты и обычный docx предоплаты — запрещены; отмена автосчёта — запрещена.
- Условия оплаты (предоплата / перед отгрузкой) уже могут быть в тексте счёт-договора.
- Когда подходит «перед отгрузкой» — менеджер выставляет обычный второй счёт со своим номером и своим docx. Именно это снова даёт клиенту два платёжных документа/номера.
Что меняем в рамках ITR-3375
| Тема | Предложение |
|---|---|
| Авто-счёт | Сразу объединённый: сумма предоплаты + перед отгрузкой (оба % > 0), с двумя суммами блоков |
| Второй номер | На этапе «перед отгрузкой» не создавать отдельный счёт (старый способ закрыт и на этом пути) |
| Печать для клиента | Клиент уже получает условия в файле счёт-договора. Нужно согласовать: (а) в шаблоне счёт-договора явно два блока сумм/сроков под новый смысл; (б) нужен ли ещё скачиваемый «счёт» как сейчас запрещённый docx предоплаты — скорее нет, если договор закрывает предоплату; для «перед отгрузкой» раньше качали обычный счёт — его больше нет → либо доп. блок только в договоре, либо одна печатная форма объединённого счёта без второго номера |
| Запреты | Ручной «только предоплата» / «только перед отгрузкой» как два номера — как на обычном пути |
Открытый уточняющий вопрос по счёт-договору: достаточно ли клиенту одного файла счёт-договора с двумя блоками условий (без отдельной печатной формы «счёта» на остаток), или бухгалтерия/клиент всё же ждут отдельный лист «счёт на оплату» с тем же номером, что у автосчёта в системе?
Задачи эпика
Эпик: ITR-3375. Рабочая гипотеза хранения — вариант C (заказ + тип счёта); сроки печати — смешанный вариант 3; открытые уточнения по счёт-договору и 1С — в карточках / приёмке.
| # | Задача | Слой |
|---|---|---|
| 1 | Задача 1. Бек. Модель объединённого счёта, пороги, закрытие старого способа | Бек |
| 2 | Задача 2. Бек. Печать двух блоков и счёт-договор | Бек |
| 3 | Задача 3. Фронт. Финансы, форма счёта, план и запуск | Фронт |
| 4 | Задача 4. Документация. User docs и карта | Документация |
Критерии приёмки
- При обоих % > 0 новый выставляемый счёт — один номер, два блока; отдельный счёт только на предоплату или только на «перед отгрузкой» для этой пары создать нельзя.
- Уже выставленные пары отдельных счетов на старых заказах не меняются автоматически.
- Суммы блоков в форме редактируемые; рекомендация из плана; отклонение — с предупреждением (как сейчас по сумме).
- Платежи на счёт закрывают сначала порог предоплаты, затем «перед отгрузкой»; запуск после порога предоплаты без полной оплаты счёта.
- Окончательная — отдельный счёт.
- Счёт-договор: авто на оба этапа; второго номера на «перед отгрузкой» нет; печать согласована с решением по шаблону.
- Заказы с одним этапом из пары — без регресса.
- User docs обновлены.
Вне scope
- Миграция / автозамена уже выставленных двух счетов на один
- Объединение окончательной оплаты в тот же счёт
- Поле «Вероятность» и взвешенный cashflow
- Доработка дат плана без счёта (отдельная задача)
- Полный редизайн выгрузки в 1С без ответа заказчика
- Несколько активных частичных объединённых счетов (несколько номеров) — не v1 без отдельного решения
Открытые вопросы
Нужно закрыть до оценки / карточек
- Хранение: берём вариант C (заказ + тип счёта)? Если да —
PaymentScheduleIdоставляем nullable для старых/совместимости или убираем после вывода типа? - Сроки в печати: подтверждаем смешанный вариант 3 (предоплата — срок в днях счёта; перед отгрузкой — дата этапа / формулировка к отгрузке)?
- Счёт-договор: достаточно файла договора с двумя блоками или нужен ещё лист «счёт» с тем же номером?
Желательно у бухгалтерии
- 1С: один документ на полную сумму объединённого счёта — ок?