Налоги через CLI 2026: подача отчётности из терминала

Если вы разработчик или технический фаундер с GmbH или ИП в Германии, проблема знакома: бухгалтерия живёт в браузере, код — в терминале. Norman CLI переносит налоговые задачи туда, где вы и так работаете: UStVA, EÜR и авансовые платежи по корпоративному налогу. Norman — один из первых бухгалтерских сервисов с полноценной tax CLI для немецкого рынка.

Что такое tax CLI?

Tax CLI — это инструмент командной строки, которым вы выполняете налоговые задачи скриптами: без кликов по UI, без сессий, без логина. Norman tax CLI — это расширение бухгалтерской CLI Norman с налоговыми модулями; работает с теми же данными, что и веб-приложение и MCP-сервер.

Какие налоговые процессы покрывает

Tax CLI закрывает основные регулярные обязательства фрилансеров и GmbH:

• UStVA (предварительная декларация по НДС) — формирование, проверка и отправка ежемесячных или ежеквартальных отчётов в ELSTER
• Zusammenfassende Meldung (ZM) — подача сводной декларации по внутрисоюзным поставкам
• Подготовка EÜR — экспорт всех счетов плана SKR в JSON
• Авансовые налоговые платежи — получение начислений по Körperschaftsteuer и Gewerbesteuer для планирования ликвидности
• Поиск чеков — выборка отдельных документов по ID, дате или счёту

Установка и первые шаги

Norman CLI устанавливается через npm или Homebrew, авторизация — один раз с personal access token из вашего аккаунта Norman. После этого доступна команда norman с подкомандами tax, bookkeeping, invoice. Запускать можно локально или встраивать в Docker-образы для CI/CD.

Подача UStVA из терминала

norman tax ustva submit --period 2026-Q1 формирует UStVA за указанный квартал, запускает превью и отправляет отчёт в ELSTER — всё из командной строки. CLI использует тот же ELSTER-бэкенд, что и веб-приложение: те же валидации, проверки правдоподобия и квитанции о приёме. Подробнее о UStVA для GmbH — в отдельном гайде.

Подготовка EÜR и годового отчёта

Для годового EÜR используйте norman tax eur export --year 2026 --format json — получите полный набор данных по всем нужным счетам. Результат можно закоммитить в репозиторий, передать налоговому консультанту или подключить в собственную аналитику. Для GmbH есть norman tax balance для соответствующих HGB-отчётов.

Скрипты, CI и автоматизация

Главный смысл tax CLI — автоматизация. Несколько типовых сценариев:

• Pre-deadline-проверка в CI — ночной job вызывает norman tax ustva preview и постит результат в Slack, чтобы не было сюрпризов в день подачи.
• Синхронизация со складом данных — еженедельный экспорт оборота и входного НДС в BigQuery или Snowflake.
• Регресс-тесты бухгалтерской логики — после каждого деплоя EÜR пересчитывается и сравнивается с предыдущим днём.

Безопасность и audit trail

Каждый вызов CLI логируется в вашем аккаунте Norman: хеш токена, команда, метка времени. Токены можно отозвать в любой момент или ограничить scope-ами (tax:submit, tax:read, bookkeeping:write). Отправка в ELSTER по умолчанию требует подтверждения по почте или MFA.

Дополнение к веб-интерфейсу и MCP

CLI не заменяет веб-приложение, а дополняет его. Веб удобен для дашбордов, аналитики и ручных корректировок; CLI — для повторяющихся задач и автоматизации. Третья опора — Norman MCP-сервер, который даёт те же операции ИИ-агентам. Три интерфейса, один источник истины.

Итог

Norman tax CLI — один из немногих инструментов, который позволяет закрывать немецкие налоговые обязанности прямо из терминала: без кликов, без браузера, без двойного ввода данных. Если вы и так живёте в скриптах, CI/CD и DevOps-процессах — налоговая автоматизация должна быть в той же toolchain. Norman CLI бесплатна и работает на macOS, Linux и Windows.