Files
estimator/docs/adr/0002-vat-layer.md
T
2026-11-09 08:43:30 +03:00

68 lines
9.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ADR-0002: НДС как слой показа поверх цен без НДС
**Дата:** 31 октября 2026 · **Статус:** принято и реализовано; режим налогообложения продавца не уточнён (см. «Открыто»)
**Основание:** вопрос владельца «нужны ли net и gross»; ответ: счёт выставляет компания, зарегистрированная в РФ
**Затрагивает:** `pricing/quote.py`, `market/check.py`, `domain/models.py`, API оценок, интерфейс, миграция `0003_vat_rate`
**Связано:** [ADR-0001](0001-reserve-policy-and-engagement.md)
## Контекст
Калькулятор считает стоимость работ, наценку и резерв. НДС не часть стоимости работ: его ставка зависит от того, кто выставляет счёт, кому и в каком налоговом режиме. При этом клиент платит сумму с НДС, а ориентиры рынка в источниках нередко приведены с НДС без пометки. Если сравнивать нашу цену без НДС с ориентиром с НДС 22%, ошибка почти равна допуску сверки (±25%), и вердикт «выше» или «ниже рынка» может быть ложным.
## Решение
1. **Всё считается без НДС (net):** ставки, наценка, резерв, сверка с рынком, история. Калькулятор НДС не знает.
2. **НДС это слой показа** над итоговыми суммами. Режимов два: «без НДС» (ставка 0) и «НДС сверху» (ставка из списка). Режима «цена уже включает НДС» нет: цена называется без НДС, к оплате получается `net × (1 + ставка)`.
3. **Ставка выбирается на каждую оценку** и хранится в версии (колонка `vat_rate`, как дробь: 0,22 = 22%). Значение по умолчанию берётся из настроек по региону клиента **в момент создания** и дальше не меняется вместе с настройками.
4. **Допустимые ставки ограничены списком** из конфигурации (`[pricing.vat] choices` плюс 0 и значения по умолчанию), чтобы опечатка вроде 0,2 вместо 0,22 не попадала в договор. Остальные ставки добавляются правкой конфигурации.
5. **Смена ставки у готовой оценки** (`POST /api/estimates/{id}/vat`) это новая версия `reprice` без обращения к модели и без пересчёта, так же как смена модели оплаты. Запрос на то, что уже стоит, версию не создаёт. Модель оплаты и НДС меняются независимо друг от друга через один общий механизм.
6. **Сверка с рынком приводит ориентиры к цене без НДС.** У ориентира есть признак `includes_vat` и `vat_rate`; ориентир с НДС делится на `1 + vat_rate`, результат помечается `normalized_from_gross`. Сравнивается всегда цена с резервом без НДС.
### Значения по умолчанию (настройка `[pricing.vat]`)
| Клиент | Ставка | Почему |
|---|---|---|
| РФ | 22% | продавец в РФ, плательщик НДС, общая ставка с 2026 года |
| ЕС | 0% (без НДС) | услуга иностранному заказчику не облагается российским НДС |
Это умолчание, а не правило: правильная ставка зависит от режима продавца. Значения «по региону» меняются в конфигурации (например, `ru = 0.0` для продавца, который НДС не платит).
### Что проверено на дату решения
| Факт | Источник |
|---|---|
| Общая ставка НДС в РФ с 1 января 2026 года 22%; порог дохода для освобождения от НДС на УСН снижен | [buh.ru](https://buh.ru/articles/chto-budet-s-nds-v-2026-godu-povyshenie-stavki-umenshenie-limita-dokhodov-dlya-usn-lgoty-osvobozhden.html) |
| На УСН со специальными ставками 5% и 7% входной НДС к вычету не принимается | [ppt.ru, позиция Минфина](https://ppt.ru/obzory/minfin/pozitsiya-minfina-rf-o-nds-dlya-usn-v-2026-godu-kogda-platit-kakie-stavki-i-kto-osvobozhden) |
| Место реализации услуг иностранному заказчику за пределами РФ, российский НДС не возникает | [Хабр](https://habr.com/ru/posts/1019948) |
Ставки НДС страны ЕС для продавцов не из РФ и налоговые льготы для ИТ-компаний не проверялись и не моделируются.
## Числа (пример из документа с рыночными данными, РФ, шаг округления 1 000 ₽)
| | Без НДС | НДС 22% | С НДС |
|---|---|---|---|
| Фиксированная цена | 370 000 ₽ | 81 400 ₽ | **451 400 ₽** |
| T&M, ожидаемая стоимость | 336 000 ₽ | 73 920 ₽ | **409 920 ₽** |
| T&M, потолок бюджета | 370 000 ₽ | 81 400 ₽ | **451 400 ₽** |
Ориентир рынка 400–600 тыс. ₽ без НДС. Если бы источник дал 488–732 тыс. ₽ с НДС 22%, то после приведения это те же 400–600 тыс. ₽ без НДС; цена без НДС 340 000 ₽ при этом попадает в рынок (коридор 300–750 тыс. ₽), тогда как без приведения она выглядела бы «ниже рынка» (нижняя граница 366 тыс. ₽).
## Что намеренно не делается
- **Налоги самого продавца:** налог на прибыль, УСН, страховые взносы, налоги на зарплату. Взносы уже входят в себестоимость часа, если ставка выведена из зарплаты. Остальное не меняет цену клиента, а лишь определяет, какая наценка нужна продавцу.
- **Определение льгот и режима** (освобождения для ИТ, реестр отечественного ПО, УСН с НДС или без): это зависит от предмета договора и статуса компании, решает бухгалтер или юрист. Сервис только позволяет выбрать «Без НДС» или ставку.
- **Валюта и расчёты с иностранным клиентом:** в сервис это не входит.
## Последствия
- Миграция `0003_vat_rate` добавляет колонку `estimate_versions.vat_rate` (по умолчанию 0). Позже, до первой установки, миграция схлопнута в `0001_initial` (см. раздел 13.9 архитектуры).
- В ответе API: `vat_rate` у оценки, `quote.vat_rate`, `quote.amount_gross`, `quote.cap_gross`; в бенчмарке `includes_vat`, `vat_rate`; в сверке `normalized_from_gross`.
- В справочнике рынка у ориентиров `includes_vat = false` с пометкой: источники не уточняют, считаем без НДС. **Это допущение нужно проверить**, пока оно не подтверждено.
- В интерфейсе: поле «НДС» в форме, строка «К оплате с НДС», переключатель ставки на странице оценки, пояснение в карточке сверки.
## Открыто
1. **Режим налогообложения продавца** (ОСНО, УСН с НДС 22%, УСН со ставками 5% или 7%, УСН без НДС). От него зависят умолчание «по региону» и то, нужно ли учитывать невозвращаемый входной НДС в себестоимости.
2. **Режим «цена фиксирована с НДС».** Если у клиента бюджет задан с НДС, выручка продавца равна `gross / (1 + ставка)`, и наценка фактически падает. Это ограничение стоит показывать как предупреждение (сколько остаётся наценки), но пока не сделано.
3. **НДС в ориентирах рынка:** по каждому источнику выяснить, с НДС или без, и проставить флаги.