Счёт на оплату
Счёт на оплату фиксирует сумму, которую нужно получить от покупателя по этапу плана оплат. Связан с заказом, покупателем, нашей организацией, договором, банковскими реквизитами и платежами.
Эпик: finance-redesign.md.
Где открыть
| Место | Назначение |
|---|---|
Финансы → Счета на оплату (/invoices) | Основная работа: план + счета + платежи |
Финансы → Реестр счетов (/invoices-registry) | Поиск счетов по всей системе (бухгалтер, нач. продаж, admin) |
| Заказ → Финансы | Этапы, счета, платежи по заказу |
| Контрагент → План оплат | Таблица плана со счетами |
| Контрагент → Финансы | Сводка по заказам со ссылками на счета |
| Задачи процесса | Создание/проверка предоплаты |
Отдельных вкладок Счета на оплату в карточке заказа нет — только вкладка Финансы.
Создание счёта
- Откройте строку этапа в
/invoices, вкладке Финансы заказа, План оплат контрагента или в задаче. - Создать счёт →
PUT /Order/PaymentInvoice/initсpaymentScheduleId. - В форме проверьте параметры и сохраните →
POST /Order/PaymentInvoice.
После создания автоматически скачивается docx.
Счёт-договор и предоплата
Если к заказу привязан счёт-договор, счёт на этап предоплаты создаётся автоматически при появлении плана оплат и связывается с этим договором. Ручное создание / init предоплаты и генерация обычного docx предоплаты на беке отклоняются; отмена такого автосчёта запрещена. Печать предоплаты — через файл счёт-договора.
В плане оплат create/download обычного docx предоплаты по признаку linkedToInvoiceContract уже скрыты. Во вкладке Финансы заказа и на задаче запуска отдельные UI-доработки — ITR-3372 (позже).
Этап перед отгрузкой остаётся обычным счётом со своим docx.
Рекомендуемая и фактическая сумма (ITR-2785–2789)
В init-response приходит recommendedAmount — недостающая сумма по этапу:
сумма этапа − сумма уже выставленных неотменённых счетов по этому этапу (не меньше 0).
В форме:
- поле Сумма редактируемое, по умолчанию =
recommendedAmount; - при отклонении от рекомендации показывается предупреждение;
- сумма не может превышать доступный остаток по заказу (с учётом уже выставленного и оплаченного);
- аккордеон Финансовая информация по заказу — сводка
payment-summaryдля контекста при выставлении.
При сохранении в счёт попадает amount из формы (не только рекомендуемая). Процент оплаты в печатную форму попадает только если сумма равна рекомендуемой и этап не 100%.
Редактирование счёта
Доступно в статусах Создан и Отправлен (пока нет автоматических оплатных статусов).
Можно менять:
- статус — только Создан, Отправлен, Отменён (ITR-2908);
- банковские реквизиты (если не зафиксированы договором);
- основание, дату, срок оплаты, примечание;
- сумму (с теми же ограничениями, что при создании);
- признак «Включать процент оплаты в счёт».
Нельзя менять: номер, покупателя, организацию, заказ, договор, этап, НДС (пересчитывается от суммы).
Оплатные статусы (Оплачен, Частично оплачен, Не оплачен, Переплачен) выставляет только система по платежам — вручную недоступны.
Просмотр и docx
Режим просмотра — read-only. Скачать счёт → GET .../docx. PDF не поддерживается.
Проверки перед docx: доступ к заказу, юр. адрес покупателя, цены товаров, шаблон печатной формы.
Факсимиле в печатной форме
Во встроенном шаблоне счёта размечен якорь печати с подписью. Если на карточке нашей организации загружен PNG «Печать с подписью», он подставляется в docx; если файла нет — документ формируется без картинки, без ошибки.
PNG хранятся на карточке нашей организации (редактирование → аккордеон Факсимиле). Подробнее: partner.md, эпик факсимиле.
Реестр счетов (/invoices-registry)
GET /Order/PaymentInvoice/table — все счета с фильтрацией в таблице.
Роли: бухгалтер, начальник менеджеров по продажам, admin.
Из реестра: просмотр счёта, платежи по счёту, переходы в заказ/контрагента.
Автозаполнение при init
| Поле | Источник |
|---|---|
| Номер | yy-n по организации и году |
| Статус | Создан |
| Дата выставления | текущая |
| Покупатель, организация, договор | из заказа |
| Реквизиты | из договора или выбор |
| Основание | «Договор: №… от …» |
recommendedAmount | расчёт по этапу |
| НДС | выделяется из суммы с НДС по ставке заказа |
| Срок оплаты | 10 дней по умолчанию |
Статусы и платежи
См. Статус счёта.
При привязке платежей система сравнивает сумму платежей с ожидаемой суммой счёта (с учётом PaymentPercentage, если указан).
Импорт из 1С
POST /Order/PaymentInvoice/1C — xlsx, роль начальник менеджеров по продажам (кнопка на странице заказов). Поиск покупателя по ИНН/КПП, для новых счетов — этап Другое и т.д. Пользовательский сценарий трёх импортов: Синхронизация с 1С.
Права доступа
| Действие | Роли (API) |
|---|---|
| Init / создать / редактировать | менеджер, помощник, менеджер производства |
| Просмотр формы | + нач. продаж, бухгалтер, admin |
| Таблица по заказу | нач. продаж, менеджер, помощник, admin |
| Таблица по покупателю | + менеджер производства |
Общий список ~/PaymentInvoice/table | нач. продаж, менеджер, помощник, admin |
Реестр ~/Order/PaymentInvoice/table | бухгалтер, нач. продаж, admin |
| Docx | менеджер, помощник, менеджер производства, нач. продаж, admin |
| Импорт 1С | нач. продаж |
Данные
Номер, даты, реквизиты, сумма, НДС, процент (опционально), покупатель, договор, статус, срок, этап (PaymentSchedule), примечание, связи с платежами.
API
| Метод | Адрес | Назначение |
|---|---|---|
| PUT | /Order/PaymentInvoice/init | Init формы (+ recommendedAmount, сводка заказа) |
| POST | /Order/PaymentInvoice | Создать |
| PUT | /Order/PaymentInvoice/{id} | Обновить |
| GET | /Order/BuyerOrder/{orderId}/PaymentInvoice/{id} | Форма просмотра/редактирования |
| GET | /Order/BuyerOrder/{orderId}/PaymentInvoice/table | Счета по заказу |
| GET | /Order/Buyer/{buyerId}/PaymentInvoice/table | Счета покупателя |
| GET | /PaymentInvoice/table | Общий список |
| GET | /Order/PaymentInvoice/table | Реестр |
| GET | .../docx | Печатная форма |
| POST | /Order/PaymentInvoice/1C | Импорт |
| GET | /Order/PaymentInvoice/{id}/fakeBankStatement | Тестовая выгрузка |