# НДС (Käibemaks)

# НДС (Käibemaks)

Раздел описывает работу с налогом на добавленную стоимость (НДС / käibemaks) в системе:
как включить налоговую функцию, создать ставки и применять их к курсам, сборам и строкам
счёта.

> **Важно:** Налоги нужны не каждой организации. Поэтому НДС вынесен в **отдельный модуль
> «Käibemaks»**, который по умолчанию выключен. Если ваша организация работает без НДС
> (`Maksuvaba 0%`) — ничего включать не нужно, налоговые поля просто не появятся.

## Когда включать модуль

Включайте модуль «Käibemaks», если организация является плательщиком НДС (есть номер KMKR)
и должна выставлять облагаемые счета. Если все услуги освобождены от НДС — модуль не нужен.

## Шаг 1. Включить модуль «Käibemaks»

Модуль НДС **зависит от модуля счетов (Arved)** — сначала должен быть включён он.

1. Перейдите в **Настройки → Организации**.
2. Откройте карточку нужной организации.
3. Перейдите на вкладку **Модули** (Moodulid).
4. Убедитесь, что включён модуль **Arved** (счета).
5. Включите модуль **Käibemaks**.
6. Нажмите **Сохранить**.

> Если модуль **Arved** выключен, **Käibemaks** не будет работать, даже если отмечен —
> налоговый интерфейс не появится.

После включения в меню **Настройки** появится пункт **Käibemaksumäärad** (ставки НДС), а в
формах курса, сбора и на странице счёта — поля выбора ставки.

## Шаг 2. Завести ставки НДС

1. Перейдите в **Настройки → Käibemaksumäärad** (ставки НДС).
2. Нажмите **Создать**.
3. Заполните:
   - **Название** — например, «Standardmäär 24%», «Vähendatud 9%», «Maksuvaba 0%».
   - **Процент** — например, `24`, `9`, `0`.
   - **По умолчанию** (опционально) — ставка, которая будет автоматически подставляться в формы.
   - **Активна** — неактивные ставки не предлагаются в списках выбора.
4. Нажмите **Сохранить**.

> **Для интеграции с Merit Aktiva:** после создания ненулевой ставки запустите синхронизацию
> налогов (`merit:sync-taxes`) или попросите администратора — иначе облагаемая строка уйдёт в
> Merit без идентификатора налога. Освобождённые/0%-ставки этого не требуют.

## Шаг 3. Назначить ставку курсу

Цена курса хранится **без НДС** (нетто) — НДС добавляется к этой сумме.

1. Откройте **мастер создания или редактирования курса**.
2. На шаге **Цены** найдите поле **Käibemaks** (ставка НДС).
3. Выберите нужную ставку (по умолчанию — `Maksuvaba 0%`).
4. Сохраните курс.

После этого вновь выставляемые счета по курсу будут содержать строку НДС, а итоговая сумма
будет равна сумме нетто и НДС.

## Шаг 4. Ставка на дополнительном начислении

У дополнительного начисления (сбора) есть **своя** ставка, не обязательно совпадающая со ставкой курса.

1. Откройте заявление → **Добавить начисление**.
2. В форме выберите **ставку НДС** для начисления: сначала подставляется ставка курса, а если её
   нет — ставка организации по умолчанию.
3. Сохраните.

## Шаг 5. Правка НДС на строке счёта

На **черновике счёта** (статусы PLANNED / READY, не кредитный счёт) можно изменить ставку
отдельной строки прямо на странице счёта.

1. Откройте счёт (`/invoices/{...}`).
2. В таблице позиций у каждой строки (**Kirjeldus**) есть поле выбора ставки.
3. Выберите ставку — суммы строки и итог счёта пересчитаются автоматически.
4. В нижней части таблицы видны **Vahesumma** (без НДС), **Käibemaks** (НДС) и **Maksmisele**
   (к оплате).

> На **выставленных** счетах правка ставки заблокирована (счёт зафиксирован). Чтобы изменить
> НДС на выставленном счёте, оформите кредитный счёт и перевыпустите счёт.

## Что видно в счёте и PDF

- Блок **Arvutusvalem** (формула расчёта) показывает шаг **+ käibemaks** для облагаемых строк.
- Подвал таблицы позиций: Vahesumma → Käibemaks → Maksmisele.
- В PDF-счёте по каждой позиции выводятся нетто, НДС и итог; внизу — сумма без НДС, сумма НДС
  и общая сумма.

## Если НДС не нужен

- Не включайте модуль «Käibemaks» — налоговые поля не появятся, счета считаются как раньше
  (сумма = нетто, без строки НДС).
- Если модуль выключить позже, уже выставленные счета не изменятся.

## Частые вопросы

**Включил «Käibemaks», но пункта меню/полей нет.**
Проверьте, что включён модуль **Arved** — без него «Käibemaks» не действует.

**Изменил ставку в каталоге — изменились ли старые счета?**
Нет. Ставка фиксируется в строке счёта при выставлении. Правка каталога влияет
только на вновь выставляемые/пересчитываемые счета.

**Цена с НДС или без?**
Цены вводятся **без НДС** (нетто). НДС добавляется к этой сумме.

---

> См. также: [05-invoices.md](https://docs.huvis.ee/link/144) — счета и оплата, [13-settings.md](https://docs.huvis.ee/link/152) —
> настройки и модули организации, [21-general-ledger.md](https://docs.huvis.ee/link/159) — бухгалтерские
> проводки НДС.