ТЗ на систему расчётов и КП: структура, вопросы и примеры для производства

ТЗ на «систему расчётов и КП» часто превращается в список экранов: «ввести параметры», «показать цену», «сформировать PDF».
Проблема: экраны не гарантируют одинаковый расчёт. И тем более не гарантируют, что маржа будет защищена, а процессы — управляемы.

Ниже — структура ТЗ, которая помогает получить систему, а не «красивый Excel».

0) Что считается «готовым» (критерии результата)

Сразу фиксируем 3–5 метрик, по которым проект вообще имеет смысл:

Время подготовки КП: было → стало
Доля КП с ошибками: было → стало
Доля продаж ниже минимальной маржи: было → стало
Время согласований: было → стало
Количество ручных правок в КП: было → стало

Без этого ТЗ становится «про разработку», а не «про бизнес».

1) Объект расчёта: что мы считаем

Опишите доменный объект так, как его понимает инженер:

изделие/комплектация/опция
параметры (геометрия, материалы, нормы, допуски)
ограничения (совместимость, диапазоны, исключения)
варианты (типовые конфигурации)

Вопросы, которые надо закрыть:

Что такое «одно и то же изделие»? (параметры → идентичность)
Какие параметры влияют на спецификацию? какие — только на цену?
Где граница между «конфигурацией» и «индивидуальным проектом»?

2) Расчётное ядро: правила, шаги, версии

Это главный раздел.

2.1. Логика расчёта (по шагам)

Опишите последовательность:

Валидация параметров
Выбор материалов/замен
Расчёт массы/площадей/объёмов
Нормирование (расходы, отходы, коэффициенты)
Трудоёмкость/операции
Накладные/логистика
Итоговая себестоимость (структура)
Цена и маржа (правила)
Выходные документы (КП/спецификация/PDF)

2.2. Источники данных («источник правды»)

Таблица минимального уровня:

Данные	Откуда берём	Кто владелец	Как обновляется	Версионируется?
Нормы расхода	техкарта/справочник	технолог	регламент	да
Прайсы материалов	закупки/ERP	закупки	импорт/интеграция	да
Ставки операций	ERP/план	производство	регламент	да
Коэффициенты	правила	техдир/технолог	согласование	да

Если нет владельца — данных «нет».

2.3. Версионирование и воспроизводимость

ТЗ должно требовать:

хранить версии норм/коэффициентов/прайсов/курсов,
уметь воспроизвести расчёт КП по дате/версии,
иметь журнал изменений (кто/что/почему).

Если вам важно «почему цена такая» — без версий это невозможно.

3) Правила маржинальности и исключения

Опишите:

минимальную маржу по группам изделий/клиентам,
уровни скидок (кто может/кто согласует),
блокировку «ниже себестоимости» (жёстко или через исключение),
обязательность причины для ручных правок.

Хорошее правило: любое исключение должно быть видимо (в журнале и в отчёте).

4) Документы и выходные артефакты

Список, что система обязана выдавать:

КП (PDF + версия в системе)
спецификация (BOM)
расчётный лист (разложение себестоимости) — хотя бы для внутреннего использования
данные для интеграции (структура, формат)

Важно: документ — это представление данных.
ТЗ должно запрещать «дописать руками критичное» без фиксации.

5) Согласования и статусы (как часть системы)

Опишите статусы:

черновик → на согласовании → согласовано → отправлено → выиграно/проиграно (опционально).

И роли:

кто согласует скидку,
кто согласует исключение по марже,
кто утверждает изменения норм/коэффициентов.

6) Интеграции (границы ответственности)

В ТЗ фиксируем, что где живёт:

CPQ/система расчётов: параметры, правила, расчёт, спецификации, КП
1С/ERP: учёт, склад, фактические затраты, производство
CRM: сделки и коммуникации

И минимальный обмен на 1‑й релиз:

выгрузка спецификации + атрибутов,
выгрузка итоговой цены/условий,
загрузка прайсов/курсов (если нужно).

Подробнее про «как сделать без боли»:
/blog/integraciya-cpq-s-1c-erp-kak-sdelat-bez-boli

7) Тест‑кейсы и «контрольные расчёты»

ТЗ должно содержать минимум 10–20 контрольных примеров:

типовые изделия,
«крайние» параметры,
сложные исключения,
разные курсы/прайсы,
скидки и согласования.

И требование: результат должен совпадать с эталоном (или объяснимо отличаться по версии правил).

8) Что приложить к ТЗ (чтобы ускориться в 2 раза)

2–3 текущих шаблона КП
5–10 реальных расчётов (обезличенных)
список коэффициентов и исключений
прайсы/источники цен
список ролей и «кто принимает решение»

Если нужен короткий старт

Если у вас пока нет ТЗ, но есть ощущение «надо срочно», начните с двух статей:

про переход с Excel на CPQ и архитектуру расчётов:
/blog/cpq-dlya-proizvodstva-kak-pereyti-s-excel
про версии и аудит себестоимости:
/blog/raschet-sebestoimosti-versii-audit-istochniki-dannyh

Они дают каркас требований, который потом превращается в нормальное ТЗ.