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

2026-10-22 — Один счёт: предоплата и оплата перед отгрузкой

Статус: Задачи созданы

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

Эпик: ITR-3375

Цель​

Выставлять клиенту один счёт на оплату с двумя блоками внутри (предоплата и оплата перед отгрузкой), чтобы клиент не путался между двумя номерами и не доплачивал «не туда». Логику плана этапов (% и суммы предоплаты / перед отгрузкой / окончательной) не менять: запуск по-прежнему после набора суммы предоплаты, ожидание оплаты перед отгрузкой — по своему этапу.

Контекст​

Как сейчас​

  1. По заказу строится план оплат: этапы предоплата, перед отгрузкой, окончательная (по %).
  2. На каждый этап менеджер выставляет отдельный счёт со своим номером и печатной формой. В БД у счёта одна привязка к этапу плана.
  3. У счёта одна сумма, опционально один % в печати, поле «срок оплаты» — число дней (по умолчанию 10) от даты счёта, одно на весь документ.
  4. Клиент получает два счёта → путает номера / доплачивает по предоплатному → сложно разнести платежи.
  5. Запуск «после предоплаты» смотрит оплату счетов этапа предоплаты.
  6. Путь счёт-договор: авто-счёт только на предоплату; печать предоплаты — через файл счёт-договора; этап перед отгрузкой — обычный второй счёт со своим номером (см. invoice-contract.md).

Как должно быть​

  1. Если в заказе заданы и % предоплаты, и % перед отгрузкой — клиенту выставляется один счёт на сумму обоих этапов, с одним номером и двумя блоками в печатной форме.
  2. Старый способ (отдельный счёт на предоплату и отдельный на «перед отгрузкой») для таких заказов закрываем: создать второй номер на эту пару этапов нельзя.
  3. Уже выставленные отдельные счета на живых заказах не трогаем (не мигрируем, не отменяем автоматически). Новая возможность — для новых выставлений.
  4. Платежи приходят на один номер; система относит их к этапам по порогам сумм (сначала предоплата, затем перед отгрузкой).
  5. Для запуска достаточно оплаты ≥ сумма блока/этапа предоплаты, а не Paid всего счёта.
  6. Окончательная — по-прежнему отдельный счёт.
  7. Если только один из двух этапов — как сейчас, без объединения.
Сейчас                                      Цель (новые выставления)
───── ────────────────────────
Счёт №A — предоплата Счёт №A — предоплата + перед отгрузкой
Счёт №B — перед отгрузкой (два блока, один номер)
Счёт №C — окончательная (если есть) Счёт №C — окончательная (если есть)

Уже выставленные A+B на старых заказах — без изменений

Сценарии​

  1. Обычный заказ 50% / 50%. Создают один объединённый счёт. Клиенту — один документ с двумя блоками. Первая оплата закрывает предоплату → запуск. Дальше — этап перед отгрузкой по порогу.
  2. Счёт-договор. При появлении плана автосоздаётся объединённый счёт (сумма обоих этапов). Отдельный второй номер на «перед отгрузкой» не создаётся. Печать — см. раздел про счёт-договор.
  3. Только предоплата 100% / только перед отгрузкой. Без объединения, как сейчас.
  4. Корректировка заказа. Суммы блоков в форме счёта редактируемые (как сейчас сумма счёта) — можно скорректировать после изменения заказа; с предупреждением при отклонении от рекомендации.
  5. Старый заказ с двумя счетами. Работает как раньше; новый объединённый на ту же пару не навязываем миграцией. Когда оба этапа ещё без «старой пары» / менеджер выставляет впервые при двух % — только новый способ.

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)​

  1. Договор типа «Счёт-договор» на этот заказ; один печатный файл договора (шаблон счёт-договора) вместо договора + спеки + счёта предоплаты.
  2. При появлении плана оплат авто создаётся счёт на этап предоплаты (сумма только предоплаты), с привязкой к договору; ручной init/add предоплаты и обычный docx предоплаты — запрещены; отмена автосчёта — запрещена.
  3. Условия оплаты (предоплата / перед отгрузкой) уже могут быть в тексте счёт-договора.
  4. Когда подходит «перед отгрузкой» — менеджер выставляет обычный второй счёт со своим номером и своим 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 без отдельного решения

Открытые вопросы​

Нужно закрыть до оценки / карточек​

  1. Хранение: берём вариант C (заказ + тип счёта)? Если да — PaymentScheduleId оставляем nullable для старых/совместимости или убираем после вывода типа?
  2. Сроки в печати: подтверждаем смешанный вариант 3 (предоплата — срок в днях счёта; перед отгрузкой — дата этапа / формулировка к отгрузке)?
  3. Счёт-договор: достаточно файла договора с двумя блоками или нужен ещё лист «счёт» с тем же номером?

Желательно у бухгалтерии​

  1. 1С: один документ на полную сумму объединённого счёта — ок?

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