⭐ Заказ покупателя
Таблица на схеме

Схема основных связанных сущностей

📅 Задачи yougile
- 🟢 Реализовать веб-интерфейс для работы с заказами покупателя ITR-167
- 🔵🟢 Помощники могут менять ответственного через согласование с начальником
- 🔵🟢 Реализовать вкладку для отображения счетов
- 🔵🟢 Разрешить редактирование полей влияющих на сумму заказа после согласования начальника ITR-404
✏️ Общее описание
🔎 Уточнить
🖊️ Общие особенности
- Сопровождающий - это менеджер по производству
- Ответственный - это менеджер по продажам
- Суммы в заказе после первой оплаты можно менять только с согласованием с руководителем
- В первой версии для заказов по которым прошла хотя бы одна оплата запретить редактировать поля в заказе которые меняют сумму заказа
- В последующей версии для заказов по которым прошла хотя бы одна оплата разрешить редактировать поля в заказе которые меняют сумму заказа, но менять их только после согласования с начальником ITR-404
- Разделение заказа (часть товаров / количеств в новый заказ): кнопка в блоке «Товары» на карточке и в связанных задачах; см. user guide и эпик
📋 Предзаполненные данные
🔐 Доступ
- Менеджер по продажам (просмотр своих и редактирование своих)
- Помощник менеджера по продажам (просмотр и редактирование заказов, которые относятся к менеджеру по по продажам с которым он связан)
- Начальник менеджеров по продажам (просмотр, редактирование ответственного)
- Начальник производства (просмотр, редактирование сопровождающего)
- Менеджер производства (просмотр)
- Главный конструктор (просмотр)
- Конструктор (просмотр)
- Снабженец (просмотр)
- Бухгалтер (получение)
Доступ ролей по полям:
Поле\Роль | М. по продажам | Помощник | Начальник м. | Нач. произв. | М. произв. | Гл. констр. | Констр. | Снабженец |
|---|---|---|---|---|---|---|---|---|
| Номер заказа | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
| Дата заказа | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
| Дата следующего контакта | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Вероятность успешного | Просмотр* | Просмотр* | Просмотр | - | - | - | - | - |
| Ссылка на чат по заказу | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
| Ссылка на папку с док-ми | Просмотр* | Просмотр* | Просмотр | Просмотр | Просмотр | - | - | - |
| Номер договора | Просмотр | Просмотр | Просмотр | - | - | - | - | - |
| Примечание | Редактирование | Редактирование | Просмотр | Редактирование | Редактирование | Редактирование | Ред. | Ред. |
| Покупатель | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Наша организация | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Место производства | Редактирование* | Редактирование* | Просмотр | Просмотр | Просмотр | - | - | - |
| Контактное лицо покупателя | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Телефон | Просмотр* | Просмотр* | Просмотр | Просмотр | Просмотр | - | - | - |
| Почта | Просмотр* | Просмотр* | Просмотр | Просмотр | Просмотр | - | - | - |
| Валюта | Редактирование* | Редактирование* | Просмотр | - | - | - | - | - |
| Сопровождающий | Просмотр | Просмотр | Просмотр | Редактирование | Просмотр | Просмотр | Просмотр | Просмотр |
| Ответственный | Просмотр* | Редактирование* | Редактирование | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
| Заказчик | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Статус заказа | Авто через задачу | Авто через задачу | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
| Условие запуска | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | - |
| Спецификация | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
| Необходимые док-ты | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Комерческое предложение | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Идентификатор задачи | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
| Оплата: | ||||||||
| Доставка за наш счёт | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Доставка включена в цену | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Стоимость доставки | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Предоплата % | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Перед отгрузкой % | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Отсрочка фин. пл. в днях | Редактирование | Редактирование | Просмотр | - | - | - | - | - |
| Сумма заказа* | Высчитывается* | Высчитывается* | Просмотр | Просмотр | Просмотр | - | - | - |
| РРЦ* | Высчитывается* | Высчитывается* | Просмотр | - | - | - | - | - |
| НДС | Редактирование* | Редактирование* | Просмотр | - | - | - | - | - |
| Доставка заказа: | ||||||||
| Дата запуска планируемая | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | - |
| Транспортная компания | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Базис поставки | Редактирование* | Редактирование* | Просмотр | Просмотр | Просмотр | - | - | - |
| Состояние отгрузки | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
| Срок изготовления в днях | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Тип дней изготовления | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Срок приёмки в днях | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Тип дней приёмки | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Срок доставки в днях | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Тип дней доставки | Редактирование | Редактирование | Просмотр | Просмотр | Просмотр | - | - | - |
| Дата доставки план | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | - | - | Просмотр |
| Дата доставки факт | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | - | - | Редактирование |
| Адрес приемки товара | Редактирование* | Редактирование* | Просмотр | Просмотр | Просмотр | - | - | - |
| Адрес базиса поставки | Редактирование* | Редактирование* | Просмотр | Просмотр | Просмотр | - | - | - |
| Грузополучатель | Редактирование* | Редактирование* | Просмотр | Просмотр | Просмотр | - | - | - |
| Банк. рекв. грузополучателя | Редактирование* | Редактирование* | Просмотр | Просмотр | Просмотр | - | - | - |
| Дата отгрузки факт | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
| Дата отгрузки план | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр | Просмотр |
*максимально уменьшаю количество символов в ячейках, чтобы удобно отображалось в редакторе
Примечание:
- Ответственный. Менеджер создающий заказ автоматически назначается ответственным. Помощник менеджера может сам указывать ответственного при создании заказа (из тех, с которым он связан), но менять только через согласование с начальником
- Телефон (и Почта) показыватся первый у контактного лица, если у него его нет, то первый у контрагента. Или реализовать показ модального окна с информацией о контактном лице
- Сумма заказа высчитываются - суммируются суммы всех товаров в заказе
- РРЦ для заказа высчитываются - суммируются РРЦ всех товаров в заказе
- При галочке «Доставка включена в стоимость» на заказе выбирается режим ввода (см. ниже и эпик). По умолчанию — «Цена + доставка»: система считает итоговые цены, раскладывая доставку пропорционально сумме позиции (цена × количество). Сумма заказа считается по итоговым ценам.
- НДС подтягивается из параметров нашей организации. Но если покупатель - иностранная организация то 0%, с возможностью поменять вручную на НДС организации, то есть например продаем ин.орг., автоматом 0%, но менеджер может поменять на 20% (НДС нашей организации) 6a. Место производства (Рязань / Глазов) сохраняется на задаче «Создание КП». На «Сборе первоначальной информации» поле только для просмотра (дефолт организации или уже сохранённое). Дефолт: ЗМС → Глазов, остальные организации → Рязань. Адрес базиса для самовывоза и FCA ДЛ считается от места производства; возможен ручной режим адреса. Подробнее: эпик.
- Флаг «Доставка за наш счёт» = false — скрываются и обнуляются: доставка включена в стоимость, режим ввода стоимости, стоимость доставки, планируемая дата доставки, срок доставки и тип дней срока доставки
- Автозаполнение по умолчанию (если не заполнен): Адрес приемки товара, Адрес базиса поставки - адрес грузополучателя (или текущего контрагента), Грузополучатель - текущий контрагент. Валюта - руб. Условия зауска (Условия начала отсчёта срока) - После внесения предоплаты и согласования. Вероятность - 50. Ответственный - менеджер который создал заказ. НДС см. п.7. Тип дней - рабочие. Стандартная спецификация - да. Базис поставки - FCA
- Грузополучатель - любой контрагент с типом Покупатель, Заказчик или Прочие отношения
- Сумму заказа и РРЦ заказа в форме редактирования получаем отдельным запросом
- Ссылка на папку с документами: вручную не редактируется. На сборе данных папка создаётся кнопкой «Создать папку для заказа»; дальше — только просмотр. Для менеджера/помощника в матрице ролей — «Просмотр*» в этом смысле.
- Плановые даты отгрузки и доставки в задачах заказа не вводятся вручную: задают сроки в днях (и тип дней); даты считаются системой и на формах задач только для просмотра.
* Режимы ввода при «Доставка включена в стоимость» (поле видно только вместе с «Доставка за наш счёт»)
| Режим | Вводит пользователь | Считает система |
|---|---|---|
| Цена + доставка (по умолчанию) | Цена товара, стоимость доставки | Итоговая цена (раскладка доставки по сумме позиций) |
| Итоговая + доставка | Итоговая цена, стоимость доставки | Цена без доставки |
| Цена + итоговая | Цена и итоговая по товарам | Стоимость доставки = сумма (итоговая − цена) × количество |
Смена режима на сборе данных и создании КП — с подтверждением (суммы пересчитаются). На расчёте стоимости режим только для просмотра; править можно поля по матрице режима.
В режимах «Цена + доставка» и «Итоговая + доставка» после пересчёта стоимость доставки может измениться на несколько копеек из‑за округления.
Алгоритм режима «Цена + доставка» (раскладка): доля пропорциональна цене позиции относительно суммы (цена × количество); округление до копейки; расхождение закрывается на товаре с количеством 1 и наибольшей ценой, иначе — шагом на товаре с минимальным количеством (стоимость доставки при этом может чуть скорректироваться).
Заполение данных по процессу заказа покупателя
Какие данные на каком этапе редактируются. + есть возможность редактировать. - не отображается. * обязательно для заполнения. п просмотр.
Режим ввода стоимости и связанные поля цены/итоговой — только при «Доставка за наш счёт» и «Доставка включена в стоимость». В режиме «Цена + итоговая» стоимость доставки только для просмотра (даже где в таблице «+» / «*»).
Поле\Роль | Сбор п. инф. | Расчёт с.т. | Создание КП | Согл КП | Подп КП | Создание спец. | Согл спец. | Подп спец. |
|---|---|---|---|---|---|---|---|---|
| Номер заказа | - | - | - | - | - | - | - | - |
| Дата заказа | - | - | - | - | - | - | - | - |
| Дата следующего контакта | + | - | + | - | + | + | - | + |
| Вероятность успешного* | - | - | - | - | - | - | - | - |
| Ссылка на чат по заказу | + | - | + | - | + | + | - | + |
| Ссылка на папку с док-ми | * | - | * | п | п | п | - | - |
| Номер договора | + | - | + | - | + | + | - | - |
| Примечание | + | - | + | - | + | + | - | + |
| Покупатель | + | - | - | - | - | - | - | - |
| Наша организация | + | - | * | п | - | - | - | - |
| Место производства | п | - | * | п | - | п | п | - |
| Контактное лицо покупателя | * | - | - | - | - | - | - | - |
| Телефон | - | - | - | - | - | - | - | - |
| Почта | - | - | - | - | - | - | - | - |
| Валюта | * | - | - | - | - | - | - | - |
| Сопровождающий* | - | - | - | - | - | - | - | - |
| Ответственный* | - | - | - | - | - | - | - | - |
| Заказчик | + | - | + | - | + | + | - | + |
| Статус заказа | - | - | - | - | - | - | - | - |
| Условие запуска | + | - | * | п | - | - | - | - |
| Спецификация | - | - | - | - | - | * | п | * |
| Необходимые док-ты | + | - | + | + | + | * | п | - |
| Комерческое предложение | - | - | * | п | * | - | - | - |
| Идентификатор задачи | - | - | - | - | - | - | - | - |
| Оплата: | ||||||||
| Доставка за наш счёт | + | п | п | п | - | - | - | - |
| Доставка включена в цену | + | п | * | п | - | - | - | - |
| Режим ввода стоимости | + | п | + | п | - | - | - | - |
| Стоимость доставки | + | * | + | п | - | - | - | - |
| Предоплата % | + | п | * | п | - | - | - | - |
| Перед отгрузкой % | + | п | * | п | - | - | - | - |
| Отсрочка в днях | + | п | * | п | - | - | - | - |
| Сумма заказа* | п | п | п | - | - | - | - | - |
| РРЦ* | п | п | - | - | - | - | - | - |
| НДС | + | п | * | п | - | - | - | - |
| Доставка заказа: | ||||||||
| Дата запуска планируемая | + | - | + | - | + | + | - | + |
| Транспортная компания | + | - | + | - | + | + | - | + |
| Базис поставки | + | - | * | п | - | - | - | - |
| Состояние отгрузки | - | - | - | - | - | - | - | - |
| Срок изготовления в днях | + | - | * | п | - | - | - | - |
| Тип дней изготовления | + | - | * | п | - | - | - | - |
| Срок приёмки в днях | + | - | * | п | - | - | - | - |
| Тип дней приёмки | + | - | * | п | - | - | - | - |
| Срок доставки в днях | + | - | + | - | + | + | - | + |
| Тип дней доставки | + | - | + | - | + | + | - | + |
| Дата доставки план | п | - | п | - | п | п | - | п |
| Дата доставки факт | - | - | - | - | - | - | - | - |
| Адрес приемки товара | + | - | + | - | + | + | - | + |
| Адрес базиса поставки | + | - | + | - | + | * | - | - |
| Грузополучатель | + | - | + | - | + | + | - | - |
| Банк. рекв. грузополучателя | + | - | + | - | + | + | - | - |
| Дата отгрузки факт | - | - | - | - | - | - | - | - |
| Дата отгрузки план | п | - | п | - | п | п | - | п |
| Товары: | ||||||||
| Добавление новых | * | - | - | - | - | - | - | - |
| Редактирование добавленных | + | - | - | - | - | - | - | - |
| Изменение стоимости | + | * | - | - | - | - | - | - |
Примечание:
- Вероятность успешного заказа будет, но пока не реализовано
- Смена исполнителей выполняется в любое время на форме просмотра заказа покупателя
💻 Веб интерфейс
https://orders.regina.fvds.ru/buyer-orders или https://orders.regina.fvds.ru/partners/00000000-0000-0000-0000-000000000000/edit?sideTab=buyerOrders для конкретного контрагента
Таблица
Таблица
Колонки (если есть доступ):
- Основные
- Номер заказа
- Дата заказа
- Дата следующего контакта
- ФИО сопровождающего
- ФИО ответственного
- Покупатель
- Статус заказа
- Оплата
- Сумма заказа
- Доставка
- Состояние отгрузки
- Дата изг. план
- Дата изг. факт
- Базис поставки
- Технические:
- id
- isEditable (задача в статусе позволяющим редактировать и пользователь имеет право на редактирование)

Создание
Создание
Для создания заказа покупателя достаточно выбрать Покупателя и Контактное лицо. Перейти к их созданию можно из этой же формы. Для помощника необходимо так же выбрать ответственного менеджера по продажам.
Дальнейшее заполнение заказа покупателя происходит через задачи в процессе заказ покупателя

Просмотр
Просмотр
Левые вкладки:
- Заказ покупателя
- Финансы (
?sideTab=finance) — см. Финансы (v1) - Документы / Взаимодействия
- Заказы на производство
- Отгрузки
- Задачи
Отдельные вкладки План оплат и Счета на оплату в заказе убраны (v1). Redirect
sideTab=paymentSchedule|invoicesне реализован.
Доставка за наш счёт:

Доставка не за наш счёт:

Редактирование. Изменение исполнителя
Редактирование. Изменение исполнителя
На форме просмотра заказа покупателя около поля менеджер по продажам:
- У начальника менеджеров по продажам есть возможность сменить ответственного менеджера. В дальнейшем подобная возможность предполагается реализовать и помощнику менеджера по продажам
Редактирование. Изменение сопровождающего
Редактирование. Изменение сопровождающего
На форме просмотра заказа покупателя около поля менеджер по производству:
- У начальника производства есть возможность сменить сопровождающего. Если сопровождающий не выбран заранее, то перед тем как заказ дойдёт до главного конструктора сопровождающий назначается автоматически
Редактирование. Приостановка и отмена заказа
Редактирование. Приостановка и отмена заказа
На форме просмотра заказа покупателя около поля статуса заказа:
- У исполнителя есть возможность приостановить, возобновить или отменить данный заказ покупателя
Отмена. В диалоге нужно выбрать статус отмены (обязательно) и при желании указать причину текстом; после отмены они видны в карточке. Варианты статусов ведёт начальник менеджеров в справочнике «Причины отмены» (/cancel-reason). Если к неотменённым счетам привязаны платежи банковской выписки, отмена запрещена — сначала отвязать платежи. Если отмена проходит: неотменённые счета переводятся в «Отменён», активные этапы плана оплат архивируются (из финансового плана и сводки по оплатам пропадают).
Финансы (v1)
Эпик: finance-redesign.md.
Вкладка «Финансы»
Маршрут: /buyer-orders/{id}?sideTab=finance.
Данные: GET /Order/BuyerOrder/{id}/payment-summary.
Роли API: начальник менеджеров по продажам, менеджер, помощник, начальник производства, менеджер производства, бухгалтер, admin (с учётом доступа к заказу).
Видимость вкладки на фронте (finance.visible в контексте заказа): начальник менеджеров по продажам, менеджер, помощник, начальник производства, менеджер производства, admin. Бухгалтер карточку заказа не открывает (нет в ролях маршрута /buyer-orders/:id), данные payment-summary получает только через аккордеон в форме счёта.
Старые ссылки ?sideTab=paymentSchedule и ?sideTab=invoices перенаправляются на ?sideTab=finance (замена параметра в URL).
Финансовая сводка
KPI по заказу:
| Показатель | Смысл |
|---|---|
| Сумма заказа | Сумма товаров |
| Оплачено | Сумма привязанных платежей |
| К оплате / Переплата | Остаток или переплата (взаимоисключающие в UI) |
| Не выставлено | Сумма заказа минус выставленные счета |
Полоска прогресса: оплачено / выставлено, не оплачено / не выставлено.
Тот же response используется в аккордеоне Финансовая информация по заказу в форме счёта на оплату.
Этапы оплаты и счета
Блок Этапы оплаты и счета — список этапов (stages) с раскрытием:
- этап, плановая сумма, выставлено, оплачено, статус (chip);
- таблица счетов этапа и платежей по счёту;
- действия: создать/редактировать/просмотреть/скачать счёт (docx), редактировать дату/комментарий этапа, просмотр/смена привязки платежа.
Права на действия во вкладке (контекст заказа на фронте):
| Действие | Роли |
|---|---|
| Создать / редактировать счёт | менеджер, помощник, менеджер производства |
| Скачать / просмотреть счёт | все, кто видит вкладку |
| Редактировать планируемую оплату | только начальник менеджеров по продажам (в меню «Финансы» — также менеджер и помощник; API разрешает ещё менеджеру производства) |
| Смена привязки платежа | бухгалтер, начальник менеджеров по продажам |
Отменённые счета видны в списке, но не входят в суммы этапа и заказа. Список платежей в payment-summary не отдаётся — подгружается при раскрытии счёта.
Что не реализовано
- Financial indicator в шапке заказа (только вкладка Финансы).
Подробнее: paymentSchedule.md, paymentInvoice.md, invoicePayment.md.
🔗 Связанные сущности
- 🧾 Файлы к заказу покупателя
- 📕 Состояние заказа покупателя
- 📗 Транспортная компания
- 📗 Базис поставки
- 📕 Тип дней
- 📕 Статус состояния отгрузки
- 📕 Условия начала отсчёта срока
- 📕 Валюта
- 🧾 Товар
- 🧾 Счет на оплату
- План оплат
- Платёж по счёту
- 🧾 Отгрузка
👨🏽💻 API
/Order/BuyerOrder/ — Swagger - Order API
Финансы: GET /Order/BuyerOrder/{id}/payment-summary.