План оплат
План оплат описывает, когда и в каком размере ожидаются оплаты по заказам покупателей. По этапам создаются счета на оплату; по счетам учитываются фактические платежи.
Эпик переработки финансов: finance-redesign.md.
Где открыть
| Место | Маршрут / параметр | Назначение |
|---|---|---|
| Финансы → План оплат | /payment-schedules | Компактная таблица этапов с финансовой сводкой |
| Финансы → Счета на оплату | /invoices | Детальная таблица: план + счета + платежи (основной инструмент менеджеров) |
| Заказ покупателя | ?sideTab=finance | Этапы, счета и платежи по заказу |
| Контрагент | ?sideTab=paymentSchedule | Классическая таблица плана по заказам контрагента |
| Контрагент | ?sideTab=finance | Агрегированные финансы по заказам |
| Задачи процесса | формы предоплаты / спецификации | Создание счёта по этапу |
| Задача сопровождения | статусы ожидания оплаты перед отгрузкой / окончательной оплаты и далее | Таблица плана оплат по заказу (если этапы есть) |
Отдельной вкладки План оплат в заказе нет — финансы собраны на вкладке Финансы.
Два экрана в меню «Финансы»
Экраны дополняют друг друга; /invoices не удаляется.
Компактная таблица (/payment-schedules)
Данные: GET /Order/PaymentSchedule/PaymentStage/financials.
Одна строка = один этап оплаты (планируемая оплата). Колонки:
| Колонка | Описание |
|---|---|
| Подробная информация | Tooltip (PaymentInfoTooltip) |
| Плановая дата | Дата этапа |
| Покупатель, Заказ, Ответственный | Ссылки в карточки |
| Этап оплаты | Предоплата, перед отгрузкой и т.д. |
| Плановая сумма | Сумма этапа |
| Выставлено по счетам | Сумма неотменённых счетов |
| Оплачено | Привязанные платежи |
| Остаток / Переплата | Вычисляемые поля |
| Комментарий | Комментарий к этапу |
| Есть ошибки | Иконка, если есть платежи на разбор |
| Действия | Редактирование планируемой оплаты |
Фильтр периода: по умолчанию −7 / +30 дней от текущей даты. Кнопка Скачать платежи (xlsx по фактическим платежам за период) — начальник менеджеров по продажам, бухгалтер.
Скачать CSV (тулбар таблицы, обе таблицы — compact и /invoices): выгружает отфильтрованные строки, все колонки включая скрытые; разделитель ;, UTF-8 с BOM; имя план-оплат_дд.мм.гггг. Кнопка скрыта, если строк нет.
Группировка строк из ТЗ эпика не реализована (ограничение лицензии MUI). Большая модалка заменена tooltip.
Детальная таблица (/invoices)
Данные: GET /Order/PaymentSchedule/table с фильтром StartDate / EndDate.
Классическая таблица план + счета: одна планируемая оплата может дать несколько строк, если счетов несколько. Раскрытие строки показывает платежи по счёту. Здесь доступны Создать счёт, редактирование счёта, скачивание docx, работа с платежами.
Состояние оплаты этапа (EnPaymentStageState)
Вычисляемый показатель (в API — поле paymentState), не хранится в БД отдельно:
| Значение | Когда |
|---|---|
| Счёт не выставлен | InvoicedAmount = 0 |
| Счёт частично выставлен | выставлено меньше плана |
| Счёт выставлен | выставлено ≥ плана, оплаты нет |
| Частично оплачен | есть оплата, но меньше плана |
| Оплачен | оплачено = плану |
| Есть переплата | оплачено > плана |
| Требуется разбор | есть платежи с ошибками / need-review |
Логика расчёта — в PaymentScheduleService.GetPaymentStageFinancials. Поле доступно в API и на вкладках Финансы заказа/контрагента; в compact-таблице вместо отдельной колонки — иконка Есть ошибки и tooltip.
Детальная таблица: колонки и действия
Блок «Оплата»
Сумма, % оплаты, дата, этап, покупатель, заказ, ответственный, комментарий.
Блок «Счёт»
Номер, наша организация, дата выставления, статус, автор, оплачено, есть ошибки.
Действия
- Создать счёт — если счёта нет и этап редактируем;
- Редактировать / просмотреть счёт, Скачать счёт;
- Редактировать оплату — дата и комментарий (сумма и % только для просмотра);
- Скачать фейковую выгрузку — роль тестировщика.
Двойной клик — основное действие по счёту или создание счёта.
Платежи по счёту
Раскрытие строки — таблица платежей (см. invoicePayment.md). Редактирование привязки — бухгалтер, начальник менеджеров по продажам (по actions с бекенда).
Создание плана по заказу
План строится из товаров заказа с заполненной итоговой ценой. Стандартные этапы:
| Этап | Условие | Сумма | Дата |
|---|---|---|---|
| Предоплата | указан % предоплаты | сумма заказа × % / 100 | плановая дата запуска |
| Перед отгрузкой | указан % перед отгрузкой | сумма заказа × % / 100 | плановая дата отгрузки |
| Окончательная | сумма % < 100% | остаток | дата запуска + срок поставки (календарные/рабочие дни) |
Плановые даты этапов «перед отгрузкой» и «окончательная» пересчитываются, если изменились фактическая дата запуска или срок изготовления заказа.
POST /Order/BuyerOrder/{id}/PaymentSchedule — создать или пересоздать план (роли: менеджер, помощник).
План не создаётся, если нет товаров, не заполнены обязательные даты/срок, нет доступа к заказу, или уже есть неотменённые счета (при пересоздании — архивация старых строк, если счетов нет).
Редактирование планируемой оплаты
PUT /Order/PaymentSchedule/{scheduleId} — меняются только дата и комментарий. Сумма и процент отображаются read-only (рассчитываются при создании плана).
Признак isEditable: этап редактируем, если все связанные счета в статусах, допускающих редактирование (не Оплачен, Частично оплачен, Переплачен).
Права доступа
| Действие | Роли |
|---|---|
Compact /payment-schedules, детальная /invoices | нач. продаж, менеджер, помощник, менеджер производства, бухгалтер (compact), admin |
| План по заказу / контрагенту | те же (без бухгалтера в API таблицы по заказу) |
| Создать план | менеджер, помощник |
| Редактировать дату/комментарий этапа | API: нач. продаж, менеджер, помощник, менеджер производства. UI: в меню «Финансы» — нач. продаж, менеджер, помощник; во вкладке «Финансы» заказа — только нач. продаж |
| Счета из плана | менеджер, помощник, менеджер производства |
| Скачать xlsx платежей | нач. продаж, admin; в UI также бухгалтер |
Связь с процессами
При подписании спецификации и запуске в производство система проверяет предоплату / создаёт этапы Перед отгрузкой и Окончательная по условиям заказа.
API
| Метод | Адрес | Назначение |
|---|---|---|
| GET | /Order/PaymentSchedule/PaymentStage/financials | Compact-таблица этапов |
| GET | /Order/PaymentSchedule/table | Детальная таблица (StartDate, EndDate) |
| GET | /Order/BuyerOrder/{id}/PaymentSchedule/table | План по заказу |
| GET | /Order/Partner/{id}/PaymentSchedule/table | План по контрагенту |
| POST | /Order/BuyerOrder/{id}/PaymentSchedule | Создать/пересоздать план |
| PUT | /Order/PaymentSchedule/{id} | Обновить дату и комментарий |
| GET | /Order/InvoicePayment/xlsx | Выгрузка платежей (StartDate, EndDate) |
Фильтры financials: BuyerOrderId, BuyerId, PaymentStageId, ResponsibleId, PaymentStateId, StartDate, EndDate.