# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

НАЛОГОВАЯ ПОМОЩЬ
------------

Налоговый агент по учету хозяйственных расходов.

ОБЗОР
----------
Налоговый агент помогает в систематическом учете хозяйственных расходов.
Коммерческие расходы для налоговой декларации. Он поддерживает
несколько профилей пользователей и налоговые годы.

СТРУКТУРА ПАПКИ
--------------
пользователь/налог/
+-- профили/профили пользователей
+-- папки просмотра/Просмотренные (конфигурация)
+-- шаблоны/шаблоны на новый год
+-- [ГОД]/ За налоговый год
    +-- Расходы на рекламу/расходы на рекламу (основная категория)
    |   +-- чеки/хранилище квитанций
    |   |   +-- _bundles/ Пакеты текста для пакетной обработки
    |   |   +-- _Поездки и домашний офис/Бортовой журнал, AZN, timeGoat
    |   |   +-- _Ошибочные поступления/ Для проверки пользователем (неполучения)
    |   |   +-- _Корзина/подтвержденные неполучения
    |   |   +-- Дополнительные/входящие папки для новых квитанций
    |   |   +-- [Поставщик]/ За поставщика (amazon.de, eBay, ...)
    |   +-- экспорт/Сгенерированные отчеты и экспорт
    |   |   +-- экспорт в CSV/CSV
    |   |   +-- POSTEN_*.txt Списки сообщений
    |   |   +-- РАСХОДЫ НА РЕКЛАМУ_all.txt
    |   |   +-- BELEGE_all.txt
    |   |   +-- ПУТЕВЫЕ РАСХОДЫ_HOMEOFFICE_ГГГГ.*
    |   |   +-- FINANZAMT_YYYY.zip
    |   +-- TAX_README.txt
    |   +-- FINANZAMT.bat
    |   +-- SYNC.bat
    +-- Чрезвычайные нагрузки/
    +-- Хозяйственные услуги и мастера/
    +-- Специальные выпуски/
    +-- Страхование и пенсионное обеспечение/

КОМАНДЫ CLI
-----------

СТАТУС И ОБЗОР:
  bach steuer status              Показать общий статус
  bach steuer status --jahr 2025  Статус за год

НАЛОГОВЫЙ ГОД:
  bach steuer init 2026           Создать новый налоговый год
  bach steuer init 2026 --user X  С определенным профилем

СПИСКИ:
  bach steuer list                Показать все списки
  bach steuer list --jahr 2025    Списки за год
  bach steuer list --liste WERBUNGSKOSTEN
                                  Показать конкретный список

УПРАВЛЕНИЕ Квитанциями (НОВИНКА)
----------------------
Квитанции представляют собой PDF-файлы в папке квитанции/. Статус: ЗАХВАТ,
NOT_COVERED, DEPRECATED.

  bach steuer beleg list                    Перечислить все квитанции
  bach steuer beleg list --status ERFASST   Фильтровать по статусу
  bach steuer beleg list --status NICHT_ERFASST
  bach steuer beleg list --status DEPRECATED
  bach steuer beleg list --status ALL --limit 1000
                                            Все с высоким лимитом

  bach steuer beleg scan                    Найти новые поступления
  bach steuer beleg scan --dry-run          Показать только

  bach steuer beleg deprecate 215 466 "Grund"
                                            Пометить чеки как недействительные
                                            (Номера остаются зарезервированными)

  bach steuer beleg sync                    Восстановить файлы TXT из БД

УПРАВЛЕНИЕ ЭЛЕМЕНТАМИ (НОВОЕ)
-----------------------
Элементы — это отдельные элементы из документов. Квитанция может
содержать несколько предметов. Идентификатор позиции = Номер документа Номер позиции (например, 151-1).

  bach steuer posten list                   Показать все позиции
  bach steuer posten list --liste W         Фильтр по списку (W/G/V/Z)
  bach steuer posten list --belegnr 151     Фильтр по номеру документа
  bach steuer posten list --steller NAME    Фильтр по выставителю счета
  bach steuer posten list --rechnungsnr NR  Фильтр по номеру счета
  bach steuer posten list --limit 100       С лимитом

  bach steuer posten search BEGRIFF         Поиск по позициям
                                            (поиск по названию, россыпи,
                                            Комментарий, номер счета, идентификатор товара)

  bach steuer posten show 151-1             Показать отдельные позиции

  bach steuer posten add --belegnr 151 --bezeichnung "Produkt" --brutto 34.95 --liste W
                                            Создать новый пост
    Параметры:
    --document number NR номер документа (обязательно)
    --name Название продукта в формате TXT (обязательно)
    --gross VALUE Сумма брутто (обязательно)
    --list W|G|V|Z целевой список (по умолчанию: Z)
    --proportion 0,0-1,0 пропорция для смешанного типа (по умолчанию: 0,5)
    --remark TXT Необязательное примечание
    --date ГГГГ-ММ-ДД Дата
    --provider ИМЯ поставщика
    --номер счета NR номер счета (или --номер счета)

  bach steuer posten edit 151-1 --bezeichnung "Neuer Name"
                                            Редактировать сообщение
  bach steuer posten edit 151-1 --brutto 29.95
  bach steuer posten edit 151-1 --anteil 0.7
  bach steuer posten edit 151-1 --rechnungsnr "RE-12345"

  bach steuer posten move 151-1 W           Переместить в список
  bach steuer posten move 151-1 G --anteil 0.5
                                            С порцией для смешанного населения
    Ярлык списка:
    W = РАСХОДЫ НА РЕКЛАМУ (100% франшиза)
    G = СМЕШАННАЯ (пропорциональная франшиза)
    V = ОТКЛОНЕН (франшиза не вычитается)
    Z = СБРОС (нужно уточнить)

  bach steuer posten delete 151-1           Удалить (с подтверждением)
  bach steuer posten delete 151-1 --force   Без подтверждения

ПАКЕТНЫЙ ИМПОРТ (НОВАЯ версия 1.1.4)
-------------------------
Для быстрого ввода нескольких элементов или документов.

  bach steuer batch help                    Показать пакетную справку

  bach steuer batch posten --belegnr 42 --json '[...]'
                                            Несколько элементов в одном документе
    Формат JSON:
    [{"bez":"Статья","брутто":19.99,"list":"W"},
     {"bez":"Частный","брутто":5.00,"list":"V","bem":"частный"}]

  bach steuer batch posten --belegnr 42 --file posten.json
                                            Публикация из файла JSON

  bach steuer batch belege --inline "42:Artikel:19.99:W;43:Ware:5.00:V"
                                            Быстрый ввод нескольких документов
                                            Формат: НОМЕР ДОКУМЕНТА:DEZ:GROSS:LIST

  bach steuer batch belege --file import.json
                                            Множественные чеки с товарами
    Формат JSON:
    {"доказательства":[
      {"чек №":42,"item":[{"bez":"X","брутто":10,"list":"W"}]},
      {"чек №":43,"item":[{"bez":"Y","брутто":5,"list":"V"}]}
    ]}

  bach steuer batch delete --belegnr 42 --force
                                            Удалить все элементы в документе

  bach steuer batch delete --posten "42-1,42-2,43-1" --force
Удалить определенные элементы

  bach steuer batch delete --liste V --limit 100 --force
                                            Удалить все ОТМЕНЕННЫЕ (максимум 100)
                                            ВНИМАНИЕ: можно удалить много элементов!

  bach steuer batch move --posten "42-1,42-2" --liste W
                                            Переместить определенные предметы

  bach steuer batch move --belegnr 42 --liste W
                                            Переместить все элементы документа

  bach steuer batch move --von V --nach W --limit 50
                                            Перемещение между списками

НАЛОГОВЫЕ ИНСТРУМЕНТЫ (НОВАЯ версия 1.1.4)
-------------------------
Отдельные скрипты Python в Tools/tax/.

  bach steuer tools list                    Перечислить все инструменты
  bach steuer tools <name> [args]           Запустить инструмент (краткая форма)
  bach steuer tools run <name> [args]       Запустить инструмент (явный)
  bach steuer tools register                Зарегистрировать инструменты в bach.db

Важные инструменты:
  beleg_vorfilter Предварительная сортировка новых документов (НОВИНКА)
  make_bundle Создание пакетов текста из квитанций
  beleg_parser Извлечение текста из PDF-файлов (с помощью OCR)
  regenerate_txt Восстановить список TXT из БД
  scan_new_belege Найти и зарегистрировать новые квитанции
  temu_ocr_batch Пакетное распознавание текста для изображений PDF

Прямой доступ:
  bach steuer tools make_bundle amazon 11 67
  bach steuer tools regenerate_txt

ПРОФИЛИ:
  bach steuer profile list        Список профилей
  bach steuer profile show <name>  Показать профиль
  bach steuer profile create max  Создать новый профиль

ПАПКА ПРОСМОТРА:
  bach steuer watch list          Показать папку просмотра
  bach steuer watch add PFAD      Добавить папку
  bach steuer watch remove PFAD   Удалить папку
  bach steuer scan                Проверить папку просмотра

ЭКСПОРТ:
  bach steuer export              Экспорт (стандарт: txt)
  bach steuer export --jahr 2025 --format csv
  bach steuer export --format datev         Пакет резервирования DATEV CSV
                                            (для налоговых консультантов)
  bach steuer export --format csv           Простой CSV (совместим с Excel)
  bach steuer export --format vorsorge      Инвестиционные пенсионные расходы
                                            (Страховые взносы)

ПРОВЕРКА КОМПЛЕКТНОСТИ:
  bach steuer check                         Провести проверку
  bach steuer check --jahr 2025             За конкретный год
                                            Чеки: документы без предметов,
                                            Товар без чека, пробелы в
                                            Номера документов, недостающие месяцы,
                                            Товар без суммы НДС

ФОРМИРОВАНИЕ СОБСТВЕННОЙ Квитанции:
  bach steuer eigenbeleg --bezeichnung "Parkgebuehr" --brutto 5.00
                                            Создайте свою квитанцию
  bach steuer eigenbeleg --bezeichnung "..." --brutto 10.00 --mwst 7
                                            С другой ставкой НДС
  Опции: --list, --date, --VAT, --reason

BANK-IMPORT:
  bach steuer import camt <pfad>            CAMT.053 Импорт XML

FINANZAMT-EXPORT (планируется):
  bach steuer finanzamt           Создать ZIP со всеми расходами на рекламу
                                  Создает FINANZAMT_[YEAR].zip с помощью:
                                  - WERBUNGSKOSEN_alle.txt (обзор)
                                  - папка csv/ с файлами CSV
                                  - Все справочные документы (PDF)

  Непосредственно через скрипт:
    инструменты Python/tax/tax_sync.py налоговая инспекция

ЭКСПОРТ CSV (НОВАЯ версия 1.3.1):
  bach steuer export --format csv CSV-Dateien in csv/ Ordner exportieren
                                  Для импорта Excel/налогового программного обеспечения

  Формат: разделены точкой с запятой, UTF-8 со спецификацией, немецкий формат чисел

  Файлы CSV НЕ записываются автоматически во время синхронизации.
  только с: налоговая инспекция (автоматически) или экспорт --format csv (явный)

  Непосредственно через скрипт:
    python Tools/steuer/steuer_sync.py csv

ПРОФИЛИ
-------
Профили сохраняют пользовательские настройки:
- Профессиональный контекст (отрасль, деятельность)
- Правила провайдера (TEMU, Amazon,...)
- Автоматические назначения (ключевые слова)
- Стандартные акции смешанного использования

Создать профиль:
1. Налоговый профиль Баха создать MYNAME
2. Отредактируйте файл в папке user/tax/profile/

LIST TYPES (начиная с версии 1.3.0)
------------------------
Новые имена файлов в папке ADVERTISING COSTS/:

  Описание файла кода
  ---- ----------------------- -------------------------
  W POSTEN_reine.txt 100% франшиза
  G POSTEN_gemischt.txt Пропорционально франшиза (с долей)
  V POSTEN_verworfen.txt Не подлежит франшизе (частное)
  Z POSTEN_unsortiert.txt Редактировать позже / неясно
  - WERBUNGSKOSEN_alle.txt W + G комбинированный (для налоговой инспекции)

СТАТУС ВАУЧЕРА
------------
ЗАПИСАН Документ обработан, позиция создана
NOT_RECORDED Документ еще не обработан
УСТАРЕЛО Квитанция помечена как недействительная (например, дубликат)

ПРЕДВАРИТЕЛЬНЫЙ ФИЛЬТР ВАУЧЕРА (НОВЫЙ)
---------------------
Автоматическая предварительная сортировка новых квитанций в папки поставщика.

  инструменты Python/steuer/beleg_vorfilter.py [--dry-run] [--verbose]

Рабочий процесс:
1. Помещайте новые PDF-файлы из электронной почты/загрузки в папку «Документы/Другое/».
2. Запустите предварительный фильтр:
   инструменты Python/steuer/beleg_vorfilter.py --dry-run # Предварительный просмотр
   инструменты Python/steuer/beleg_vorfilter.py # Выполнить
3. Результат:
   - Чеки автоматически сортируются по папкам провайдера
   - Неполучения (отслеживание, статус доставки) -> _Ошибочные поступления/
4. Пользователь проверяет _Ошибочные квитанции/ -> действительно неправильные квитанции для _Корзины/

Методы обнаружения:
- Шаблон имени файла: RG64116 -> LingoPlay, 32xxxxxx -> TimeTEX.
- Содержимое PDF: «Антропный, PBC» -> Антропный, «TimeTEX» -> TimeTEX
- Отсутствует маркер квитанции: «Отслеживание доставки», «Отслеживание» -> _Ошибочные квитанции

Поддерживаемые поставщики:
  Anthropic, TimeTEX, LingoPlay, Autism Publishing, PayPal,
  eBay, Temu, Amazon, Apple, Google

BIDI-SYNC (ДВУСТОРОННЯЯ СИНХРОНИЗАЦИЯ TXT)
-------------------------------------
Записывайте расширенные действия непосредственно в файлы TXT.
Синхронизация анализирует их и выполняет в БД.

 ТИПЫ ДЕЙСТВИЙ:
  ДВИЖЕНИЕ:
    42-3 -> W Переход к расходам на рекламу
    42-3 -> G 0,5 In в смеси с 50% пропорцией
    42-3 -> V личное В Отклонено с комментарием
    B42 -> W Переместить все элементы документа

  РЕДАКТИРОВАТЬ:
    42-3 :: брутто=19,99 Изменение брутто-суммы
    42-3 :: label=Новое имя
    42-3 :: доля=0.7 Изменить долю

  УДАЛИТЬ:
    42-3 УДАЛЕНИЕ Удаление отдельного элемента
    42-3 DEL краткая форма

  УСТАРЕЛО (забронировать документ):
    B42 УСТАРЕЛО Пометить документ как недействительный
    B42 УСТАРЕЛО Дубликат с обоснованием

ОБЛАСТЬ ВВОДА:
  Записывайте действия в TXT-файлы в разделе «INPUT»:

  === ВХОДЫ (обрабатываются во время синхронизации) ===
  42-3 -> Вт
  43-1 :: брутто=25,50
  B44 УСТАРЕЛО Отменено
  === КОНЕЦ ВХОДОВ ===

ВЫПОЛНЕНИЕ СИНХРОНИЗАЦИИ:
  Синхронизация инструментов Python/tax/tax_sync.py
  или: синхронизация налоговых квитанций

ПРИМЕЧАНИЯ:
  - Действия обрабатываются при синхронизации, а затем удаляются.
  - О неправильных действиях сообщается в журнале ошибок.
  - Всегда сначала проверяйте --dry-run (если доступно)

ТИПИЧНЫЙ РАБОЧИЙ ПРОЦЕСС
------------------
0. Предварительная сортировка новых документов (beleg_vorfilter.py)

1. Проверьте статус:
   bach steuer beleg list --status NICHT_ERFASST

2. Просмотр открытых квитанций по поставщикам:
   bach steuer beleg list --status NICHT_ERFASST --limit 500

3. Введите квитанции в чат агента

4. Результат проверки:
   bach steuer posten list --liste W

ПАКЕТНАЯ ОБРАБОТКА ПАКЕТАМИ
------------------------------
При большом количестве документов индивидуальная проверка неэффективна. Вместо этого:

1. Создать пакет:
   агенты Python/_experts/steuer/make_bundle.py <источник> <начало> <конец>

   Примеры:
     Агенты Python/_experts/steuer/make_bundle.py PayPal 171 214
     Агенты Python/_experts/steuer/make_bundle.py ebay 77 128
     агенты Python/_experts/steuer/make_bundle.py google_play 129 170

   Источники: PayPal, ebay, google_play, amazon, другие, temu.
   Вывод: user/steuer/2025/bundles/<source>_B<start>-B<end>.txt

2. Анализируем пакет:
   Клод читает пачку и классифицирует все квитанции на:
   - W = расходы на рекламу (100% франшиза)
   - G = смешанный (пропорциональный, например 50%)
   - V = Отброшено (частное, дубликаты, статусные письма)
   - Z = Отложенный (нужно уточнить)

3. Элементы пакетного захвата:
   bach steuer posten add --belegnr 195 --bezeichnung "..." --brutto 55.85 --liste W ...

4. Обновите TXT-файлы:
   агенты Python/_experts/steuer/regenerate_txt.py

ПРИМЕЧАНИЯ ПО КЛАССИФИКАЦИИ
----------------------------
- PayPal: платежи Temu дублируются (оригиналы в папке Temu)
- eBay: много писем по электронной почте для каждой покупки (заказ, доставка, доставка, счет-фактура).
        -> Записывать только счет-фактуру/подтверждение заказа в качестве основного документа
        -> Записывать электронные письма со статусом как V с 0 евро (полнота)
- Терапевтический материал: LEGO, обучающие игры, специальная литература = W
- Программное обеспечение: Microsoft 365, Office = G с 50%
- Потоковое вещание: Netflix, Disney+ = V (частное)

БАЗА ДАННЫХ
---------
Все данные в: data/bach.db

Таблицы:
- Tax_documents Все документы со статусом
- Tax_posten Все элементы с присвоением

Профили сохраняются в виде файлов TXT в папке user/steuer/profile/.

ЧАТ-АГЕНТ
----------
Налоговый агент доступен в качестве чат-агента в разделе
агенты/steuer-agent.txt доступен.

Он может:
- Захват квитанций из PDF-файлов
- Автоматически классифицировать сообщения
- Обнаружение дубликатов
- Подтвердить с пользователем
- Создайте ZIP-файл налоговой инспекции со всеми документами

AREA READMES (справочник по ключевым словам работает)
---------------------------------------------
Каждая налоговая зона имеет README.txt с таблицей ключевых слов,
необходимые поступления и текущие суммы фиксированной ставки (по состоянию на 2025 год).

  Область файла/абзац
  ------------------------------------------------ ------------------------
  user/steuer/[JAHR]/STEUER_README.txt Общая процедура и синхронизация
  user/tax/[ГОД]/расходы на рекламу/README.txt Приложение N (пункт 9)
  пользователь/налог/[ГОД]/Чрезвычайные нагрузки/Раздел 33 EStG
    README.txt
  пользователь/налог/[ГОД]/Бытовые услуги Параграф 35a EStG
    И Мастера/README.txt
  user/steuer/[JAHR]/Special Editions/README.txt Параграф 10 EStG
  пользователь/налог/[ГОД]/расходы на страхование и инвестиционную пенсию
Положение об удалении/README.txt

Содержимое файлов README:
  - Определение территории с правовой основой
  - Таблица ключевых слов: Что можно подать + необходимые документы
  - Важные суммы фиксированной ставки и максимальные лимиты
  - Практические советы

СМОТРИТЕ ТАКЖЕ
----------
  bach --help tasks                    Общие задачи
  bach --help backup                   Система резервного копирования
  wiki/steuer/_index.txt Tax Wiki (основные знания)
  wiki/steuer/est_bereich.txt Обзор систем EStG
  wiki/steuer/versicherungen.txt Страхование франшизы
  wiki/steuer/sonderspenden.txt Вычесть специальные выпуски
  wiki/steuer/fortbildung.txt Дальнейшее обучение и обучение
  wiki/steuer/fahrtkosten_homeoffice.txt Транспортные расходы и домашний офис
  агенты/steuer-agent.txt налоговый агент (чат-агент)
