Kpakfar/german-tax-return

독일 세금 신고

면책 조항: 이는 템플릿이지 세무 조언이 아닙니다. 이는 한 가구의 경험을 바탕으로 구축되고 references/thresholds.json에 명시된 날짜의 법률 텍스트와 대조하여 확인된, 여러분의 신고를 위한 시작 구조입니다. 세법은 매년 변경되며 모든 사례가 다릅니다. 이 스킬은 잘못되었거나 불완전하거나 구식일 수 있습니다. 여러분이 제출하는 내용에 대한 책임은 여러분에게 있습니다. 모든 숫자를 직접 확인하고, 복잡한 경우 Steuerberater(세무사) 또는 Lohnsteuerhilfeverein(임금세 지원 협회)에 문의하십시오. 보증은 없습니다(LICENSE 참조). 의존하기 전에 규칙, 질문 및 한도를 자신의 상황에 맞게 조정하십시오.

모델이 제안하고 설명합니다. 스크립트가 확인할 수 있는 것은 확인합니다. 사람이 서명하고 제출합니다.

어떤 숫자도 모델이 믿는다는 이유만으로 신고서에 들어가지 않습니다. scripts/check_receipts.py가 해당 출처 문서에서 찾고 scripts/limits.py가 해당 스크립트가 적용하는 한도를 적용했을 때만 입력됩니다. 스크립트는 일반적인 규칙 세트를 다루며, 전체 세법을 다루지는 않습니다. 그 외의 사항은 사용자에게 질문으로 남겨집니다. 판단이 필요한 사항(이 구독이 업무 관련인가?)은 인간을 위한 질문으로 기록되며, 조용히 결정되지 않습니다.

범위 및 한계 (먼저 읽으십시오)

• 사용자 본인의 신고 또는 배우자와의 공동 신고용입니다. 사업으로서 제3자의 세금 신고를 돕는 것은 독일에서 면허를 가진 전문가에게만 허용됩니다(§§ 2, 5 StBerG; § 6은 친척을 위한 무급 지원과 같은 좁은 예외를 나열합니다). 제공하지 마십시오.
• 이는 템플릿이지 세무 조언이 아닙니다. 사용자가 시작할 때, 인터뷰 전에 한 번 명확히 말하십시오.
• 연도별 숫자는 references/thresholds.json에서 가져오며, 각각 공식 출처가 있습니다. 해당 연도가 없으면 중단하고 공식 출처(references/official-sources.md 참조)에서 확인한 후 추가하십시오.
• 절대 제출하지 마십시오. 에이전트는 사용자가 요청할 경우 ELSTER 또는 세무 소프트웨어에서 양식을 작성할 수 있지만, 전송은 항상 사용자의 클릭입니다.

모드

1. 연간 신고: 아래의 전체 워크플로우.
2. 월별 스캔: references/monthly.md 참조. 매월 첫 며칠 동안 전월의 지불, 인보이스 및 이메일에 대해 실행합니다.
3. 평가 확인: Steuerbescheid를 제출된 내용과 비교하고, 모든 차이점과 이의 제기 기한(Einspruch: 평가가 전달된 것으로 간주된 후 1개월, § 355 AO)을 나열합니다. references/workflow.md, 6단계 참조.

연간 워크플로우 (게이트, 순서대로)

각 단계에는 게이트가 있습니다. 모델의 판단만으로 게이트를 통과하지 마십시오.

0. 인터뷰. references/interview.json에 있는 12개의 스크리닝 질문을 한 번에 하나 또는 두 개씩, 평이한 말로 물어보십시오. 대답은 예, 아니오 또는 확실하지 않음(확실하지 않음은 예로 간주)입니다. 그런 다음 python3 scripts/interview.py --answers answers.json(또는 터미널에서 --ask)을 실행하십시오. 출력은 열린 영역별로 후속 질문, 수집할 문서, 비용에 대한 원장 범주 및 필요한 양식을 나열합니다. 사용자가 언급하지 않았다고 해서 영역을 건너뛰지 마십시오. 게이트: 12개 모두 답변됨.
1. 수집. 먼저 과세 연도를 물어보십시오. 작년 신고서와 평가, 모든 증명서, 인보이스, 은행 거래 내역 및 세무서에서 온 편지를 하나의 로컬 폴더에 모으십시오. references/intake-checklist.md 사용. 게이트: 모든 체크리스트 섹션에 명시적인 답변(값, 예/아니오, 없음)이 있음.
2. 보안. 사용자의 로컬 폴더에서 작업하십시오. 비밀번호를 요청하거나 저장하지 마십시오. 사용자가 로그인합니다. 세금 ID, IBAN 및 이름을 동기화되거나 공유되는 파일에 보관하지 마십시오. 게이트: 사용자가 데이터가 있는 위치와 누가 볼 수 있는지 확인함.
3. 테스트 작업(에이전트 고용). 새해가 되기 전에 작년 평가를 읽고 누락되거나 삭감된 항목을 찾으십시오. 페이지와 줄과 함께 보고하십시오. 게이트: 사용자가 서류와 대조하여 결과를 확인함.
4. 원장 구축. ledger-YYYY.csv(열은 scripts/limits.py --help 참조)에 청구된 비용당 한 행. references/deduction-guide.md로 행 정렬. 혼합 사용 항목은 work_share와 서면 이유를 받습니다.
5. 확인 (의견이 아닌 스크립트).
   • python3 scripts/check_receipts.py ledger-YYYY.csv --root FOLDER 모든 금액은 해당 문서에서 찾을 수 있어야 합니다. 스캔은 tesseract가 설치된 경우 OCR로 읽힙니다. 실패한 행은 수정되거나, 파생된 수치로 표시되고 계산식이 옆에 기록됩니다.
   • python3 scripts/limits.py ledger-YYYY.csv --year YYYY 지분, 상한, 정액공제, 저가 자산 한도 및 지급 연도 규칙을 적용합니다. 플래그가 지정된 행은 사용자에게 질문으로 전달됩니다.
   • 임대 아파트: python3 scripts/afa.py split|eligible|schedule ... 게이트: 두 스크립트 모두 종료 코드 0(limits.py에서는 상태가 approved인 행만 통과), 또는 남아 있는 모든 플래그에 서면 답변이 있음.
6. 작성, 검토, 제출. 확인된 합계를 양식에 매핑합니다(references/output-template.md). 사용자가 모든 필드를 검토하고 제출합니다. 평가가 도착하면 평가 확인을 실행합니다.

출력 규칙

• 결과를 먼저 제시: 환급액 또는 납부액, 그리고 이를 막고 있는 사항.
• 스크립트 출력을 보여주고, 의역하지 마십시오.
• 모든 추정치는 추정치로 표시하십시오.
• 독일어 용어의 경우 처음 나올 때 영어(괄호)를 함께 제공하십시오.

파일

• scripts/interview.py + references/interview.json: 12개의 스크리닝 질문 -> 수집 목록
• scripts/check_receipts.py: 금액이 해당 출처 문서에 나타나야 함
• scripts/limits.py: 연간, 개인별 법적 한도
• scripts/afa.py: 건물 지분, 5% 감가상각 자격, 감가상각 계획
• scripts/monthly_scan.py: 은행 CSV + 인보이스 + .eml -> 월별 보고서
• references/thresholds.json: 공식 출처가 있는 연도 값
• references/deduction-guide.md: 무엇이 포함되고 어떻게 결정하는지
• references/workflow.md: 게이트에 대한 상세 설명, 평가 확인
• references/monthly.md: 월별 루틴 및 예약 방법
• references/intake-checklist.md, references/output-template.md
• references/official-sources.md
• examples/: 두 검사를 1분 안에 시도할 수 있도록 만들어진 원장 및 영수증 예제
• tests/: python3 -m unittest discover -s tests