GitCover Symbol GCBoKGitCover Body of Knowledge

ED20 - Thực tiễn giao diện với cơ quan nhà nước: ELSTER, DE-Mail, eXTra - Trung gian qua GitCover

Vấn đề

Nhiều giao diện với cơ quan nhà nước được quy định bởi pháp luật, nhưng trong thực tế hầu như không thể sử dụng đối với người không chuyên:

Thông điệp cốt lõi

Harness GitCover đóng vai trò trung gian giữa các hệ thống bên ngoài và các quy định gắn với rủi ro:

  1. Trung gian ELSTER - LStA, UStA, LSt-Bescheinigung qua giao diện ELSTER; biên nhận làm chứng từ kèm Sidecar
  2. DE-Mail: đã ngừng - cần di chuyển dữ liệu - các DE-Mail lịch sử phải được di chuyển vào repo dưới dạng EML + SHA-256 + Sidecar trước khi ngừng dịch vụ; email được lưu trữ trong các hệ thống đã ngừng không còn truy cập được - vấn đề lưu trữ GoBD
  3. Xuất eXTra/euBP - dữ liệu SV ở định dạng eXTra có thể xuất cho các cuộc kiểm tra DRV
  4. Xuất vật mang dữ liệu Z3 - xuất Z3 tuân thủ GoBD cho các cuộc kiểm tra bên ngoài của FA (git bundle như một kho lưu trữ tự chứa)
  5. Ghi log lỗi giao diện - lỗi/gián đoạn của các hệ thống bên ngoài được ghi nhận như một sự kiện trong repo
  6. Liên kết quy định - mỗi quy trình giao diện được ánh xạ tới quy định gắn với rủi ro

Tuân thủ by Design: Harness không che giấu sự phức tạp của các giao diện với cơ quan nhà nước - nó ghi nhận chúng. Mỗi lần truyền, mỗi biên nhận, mỗi lỗi đều được ghi lại trong repo theo cách có thể truy vết.

Bức tranh các giao diện với cơ quan nhà nước

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart TD U["Unternehmer E1"] U --> H["GitCover-Harness"] H --> EL["ELSTER"] H --> DM["DE-Mail (eingestellt)"] H --> EX["eXTra/euBP"] H --> Z3["Z3-Datenträger"] EL --> FA["Finanzamt"] DM --> BH["Behörden (diverse)"] EX --> DRV["DRV (SV-Prüfung)"] Z3 --> AP["Finanzamt (Außenprüfung)"] style U fill:#0F1B33,stroke:#0F1B33,color:#FBFAF7 style H fill:#10A987,stroke:#0A7F5C,color:#FBFAF7 style EL fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style DM fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style EX fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style Z3 fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style FA fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style BH fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style DRV fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style AP fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33
Giao diện Mục đích Độ phức tạp Trung gian qua GitCover
ELSTER LStA, UStA, LSt-Bescheinigung, trình xem hóa đơn điện tử cao (chứng thư, XML, máy khách) Biên nhận làm chứng từ kèm Sidecar
DE-Mail Liên lạc an toàn với cơ quan nhà nước đã ngừng (nhà cung cấp cuối cùng 31.12.2026) Di chuyển: EML + Sidecar vào repo; cảnh báo
eXTra/euBP Dữ liệu SV cho các cuộc kiểm tra DRV cao (định dạng chuyên dụng) Xuất từ dữ liệu repo
Z3-Datenträger Xuất tuân thủ GoBD cho kiểm tra bên ngoài của FA cao (phần mềm chuyên dụng) git bundle như kho lưu trữ tự chứa

Trung gian ELSTER

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart TD L["LStA/UStA berechnet"] L --> E["ELSTER-Übermittlung"] E --> Q["ELSTER-Quittung"] Q --> S["Quittung als Beleg mit Sidecar"] S --> R["Repo: LStA-Eintrag mit source_sha256"] R --> V["Vorschriften-Binding: § 41a EStG"] E -->|Fehler| F["Fehler-Logging im Repo"] F --> FR["Repo-Ereignis: ELSTER-Fehler"] style L fill:#0F1B33,stroke:#0F1B33,color:#FBFAF7 style E fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style Q fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style S fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style R fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style V fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style F fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style FR fill:#FDBA74,stroke:#C2410C,color:#0F1B33
Bước Hành động Triển khai GitCover
LStA được tính Khai báo thuế tiền lương từ bảng lương Tạo phẩm JSON trong repo (xem ED14)
Truyền qua ELSTER Điện tử qua ELSTER (cần chứng thư) Harness gọi ELSTER
Biên nhận ELSTER xác nhận việc truyền Biên nhận làm chứng từ kèm Sidecar
Mục nhập repo LStA với source_sha256 trỏ tới biên nhận tags: ["lsta", "§41a-estg"]
Liên kết quy định LStA → § 41a EStG vorschrift: "§41a-estg" trong tạo phẩm
Ghi log lỗi Lỗi ELSTER được ghi nhận Sự kiện repo kèm mô tả lỗi

Liên kết quy định: Mỗi quy trình giao diện được ánh xạ tới quy định gắn với rủi ro - ví dụ LStA → § 41a EStG, UStA → § 18 UStG, LSt-Bescheinigung → § 41b EStG. Nhờ đó có thể truy vết quy định nào đã được đáp ứng thông qua lần truyền nào.

DE-Mail - Đã ngừng: Di chuyển và hệ quả lưu trữ

DE-Mail đã chính thức ngừng. Dự án được coi là thất bại. Nhà cung cấp cuối cùng (FP Digital Business Solutions GmbH) ngừng dịch vụ vào 31.12.2026 - sau đó DE-Mail không còn sử dụng được và email được lưu trữ trong các hệ thống này không còn truy cập được.

Sự kiện Ngày Nguồn
Telekom ngừng De-Mail 31.08.2022 "vì thiếu hiệu quả kinh tế"
1&1 De-Mail GmbH ngừng 07.02.2025 Dịch vụ không còn truy cập được
§ 130a ZPO bị bãi bỏ 22.12.2025 DE-Mail với tư cách kênh truyền an toàn bị bãi bỏ (BGBl. 2025 I Nr. 349)
Chính quyền liên bang ngừng Tháng 7 năm 2024 chấm dứt việc sử dụng bắt buộc
Nhà cung cấp cuối cùng (FP Digital) ngừng 31.12.2026 "Đến đây DE-Mail trở thành lịch sử"
Bundesrechnungshof 2021 2021 2011-2020: ~6.000 De-Mail từ cơ quan nhà nước, tiết kiệm ~3.500 EUR, chi phí >= 6,5 triệu EUR
Phê bình của CCC 2013 Linus Neumann (30C3): "Bullshit made in Germany - được xây dựng cố ý không an toàn"

DE-Mail đã trở thành lịch sử: Nhà cung cấp cuối cùng (FP Digital Business Solutions GmbH) ngừng dịch vụ vào 31.12.2026. Sự công nhận pháp lý là kênh truyền an toàn (§ 130a Abs. 4 Nr. 1 ZPO) đã bị bãi bỏ vào 22.12.2025. Chính quyền liên bang đã chấm dứt việc sử dụng bắt buộc vào tháng 7 năm 2024. Bundesrechnungshof đã tổng kết năm 2021: 6,5 triệu EUR chi phí cho ~3.500 EUR tiết kiệm. Như một sự kế nhiệm, một "European Business Wallet (EBW)" được dự kiến.

Hệ quả của email được lưu trữ trong các hệ thống đã ngừng

Khi một nhà cung cấp DE-Mail ngừng dịch vụ, sẽ phát sinh các vấn đề lưu trữ liên quan trực tiếp đến GoBD:

Vấn đề Hệ quả Liên quan GoBD
Hộp thư không còn truy cập được Không thể truy xuất email nữa § 146 Abs. 5 AO ("jederzeit verfügbar")
Xóa từ phía nhà cung cấp Sau khi ngừng, dữ liệu sẽ bị xóa § 147 Abs. 1 AO (nghĩa vụ lưu trữ 6 năm)
Không thể xuất dữ liệu Nếu nhà cung cấp không cung cấp chức năng xuất, dữ liệu sẽ mất không thể khôi phục GoBD Rz. 146 (khả năng truy vết)
Mất giá trị chứng cứ Các xác nhận đặc thù của DE-Mail (xác nhận gửi/xác nhận nhận được) không còn có thể xác minh Mất chứng cứ khi tranh chấp với cơ quan nhà nước
Không có bảo toàn chứng cứ pháp y Người không chuyên khó có thể bổ sung tính xác thực của email cũ bằng phương pháp pháp y sau đó - nếu không có hạ tầng của nhà cung cấp thì thiếu dữ liệu xác minh (kiểm tra chữ ký, máy chủ dấu thời gian, sổ log của nhà cung cấp) Hạ thấp giá trị chứng cứ xuống "bản sao PDF đơn thuần"
Thời hạn lưu trữ vẫn còn Email từ 2024 phải được lưu trữ đến 31.12.2030 - nhưng hệ thống đã biến mất vào 2026 Vi phạm GoBD do không thể truy cập dữ liệu lưu trữ

Bảo toàn chứng cứ pháp y - hầu như không thể bổ sung về sau: Các đặc điểm chứng cứ đặc thù của DE-Mail (chữ ký điện tử đủ điều kiện của xác nhận gửi và xác nhận nhận, dấu thời gian của nhà cung cấp, giá trị băm toàn vẹn) có thể chỉ được xác minh trong hạ tầng nhà cung cấp đang vận hành. Sau khi ngừng dịch vụ, các dữ liệu xác minh này không còn khả dụng. Người không chuyên sau đó không thể kiểm tra một tệp EML đã xuất về tính xác thực đặc thù DE-Mail của nó nữa - việc kiểm tra chữ ký thất bại do thiếu chứng thư của nhà cung cấp, máy chủ dấu thời gian ngoại tuyến, sổ log của nhà cung cấp đã bị xóa. Email mất trạng thái là "giao tiếp DE-Mail có hiệu lực pháp lý" và suy thoái thành một bản sao PDF đơn thuần với giá trị chứng cứ bị giảm mạnh. Về lý thuyết, việc bảo toàn chứng cứ pháp y bổ sung sau đó bởi một chuyên gia giám định là có thể, nhưng trên thực tế hầu như không thể thực hiện - dữ liệu hạ tầng nhà cung cấp cần thiết không còn tồn tại.

Cảnh báo quan trọng - Di chuyển trước khi ngừng dịch vụ: Các doanh nhân vẫn còn hộp thư DE-Mail phải trước khi ngừng dịch vụ xuất tất cả email liên quan dưới dạng tệp EML và di chuyển vào repo Git (EML + SHA-256 + Sidecar). Sau khi ngừng dịch vụ, việc xuất không còn khả thi - dữ liệu bị mất không thể khôi phục. Đó là vi phạm GoBD nếu thời hạn lưu trữ vẫn đang chạy (6 năm kể từ cuối năm, § 147 Abs. 1 Nr. 2/3 AO).

Di chuyển bằng GitCover: DE-Mail -> Repo

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart LR D["DE-Mail-Postfach (eingestellt)"] D --> EX["Export vor Abschaltung"] EX --> EML["EML-Dateien"] EML --> SH["SHA-256 pro EML"] SH --> SC["Sidecar .gc.md pro EML"] SC --> R["Repo: sources/korrespondenz/"] R --> OK["GoBD-konform archiviert"] D -->|nach Abschaltung| LOST["Daten unwiederbringlich verloren"] LOST --> V["GoBD-Verstoß"] style D fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style EX fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style EML fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style SH fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style SC fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style R fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style OK fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style LOST fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style V fill:#FDBA74,stroke:#C2410C,color:#0F1B33
Bước Hành động Thời hạn
Xuất Xuất tất cả email liên quan dưới dạng EML trước khi ngừng dịch vụ (muộn nhất 31.12.2026)
SHA-256 Tính hash cho mỗi tệp EML khi di chuyển
Sidecar .gc.md cho mỗi EML kèm phân loại khi di chuyển
Lưu trữ EML + Sidecar trong sources/korrespondenz/ khi di chuyển
Xác minh Kiểm tra tính đầy đủ (số lượng email) sau khi di chuyển

Mẹo thực tiễn: Việc di chuyển nên được thực hiện ngay lập tức, không phải chỉ ngay trước khi ngừng dịch vụ. Nhà cung cấp có thể hạn chế dịch vụ sớm (ví dụ: không cho đăng ký mới, xuất bị hạn chế). Ai chờ đợi sẽ có nguy cơ mất dữ liệu.

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart LR D["DE-Mail (eingestellt)"] D --> P["Gescheitert: 6,5 Mio EUR Kosten, ~3500 EUR Nutzen"] P --> W["Warnung: DE-Mail nicht nutzen"] W --> A["Alternative: ELSTER-Postfach"] D --> E["Eingehende Behörden-E-Mail (historisch)"] E --> AR["EML archiviert + Sidecar"] AR --> V["Absender-Verifikation (DKIM/SPF)"] style D fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style P fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style W fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style A fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style E fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style AR fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style V fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33
Khía cạnh Vấn đề Giải pháp GitCover
Trạng thái DE-Mail chính thức ngừng (nhà cung cấp cuối cùng 31.12.2026) Cảnh báo: không sử dụng; cần di chuyển dữ liệu
Chi phí/lợi ích 6,5 triệu EUR chi phí, ~3.500 EUR tiết kiệm (Bundesrechnungshof) git bundle và hộp thư ELSTER là miễn phí
Bảo mật "được xây dựng cố ý không an toàn" (CCC, Linus Neumann 2013) Git + GPG + SHA-256
Công nhận pháp lý § 130a ZPO bị bãi bỏ vào 22.12.2025 không còn liên quan
Lưu trữ email được lưu trữ trong các hệ thống đã ngừng không còn truy cập được Di chuyển: EML + SHA-256 + Sidecar vào repo
Thời hạn lưu trữ Email từ 2024 phải được lưu trữ đến 2030 - hệ thống đã biến mất vào 2026 Vi phạm GoBD đối với dữ liệu chưa được di chuyển
Kế nhiệm European Business Wallet (EBW) được dự kiến còn ngỏ; GitCover độc lập

Giảm thiểu thảm họa DE-Mail: Harness cảnh báo khi sử dụng DE-Mail (nếu các hộp thư lịch sử vẫn còn tồn tại) và khuyến nghị di chuyển ngay lập tức tất cả email liên quan dưới dạng EML + Sidecar vào repo. Sau khi ngừng dịch vụ (muộn nhất 31.12.2026), dữ liệu bị mất không thể khôi phục - một vi phạm GoBD nếu thời hạn lưu trữ vẫn đang chạy. Như một giải pháp thay thế cho liên lạc trong tương lai: hộp thư ELSTER cho các chủ đề thuế, email thông thường + lưu trữ Sidecar cho thư từ.

Xuất eXTra/euBP và vật mang dữ liệu Z3

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart TD R["Repo-Daten (JSON, Sidecars)"] R --> EX["eXTra-Export"] R --> Z3["Z3-Export (git bundle)"] EX --> DRV["DRV-Prüfung: SV-Daten"] Z3 --> FA["FA-Außenprüfung: GoBD-Daten"] EX --> F1["Format: eXTra V3.4.0"] Z3 --> F2["Format: git bundle + Manifest"] style R fill:#0F1B33,stroke:#0F1B33,color:#FBFAF7 style EX fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style Z3 fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style DRV fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style FA fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style F1 fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style F2 fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33
Xuất Mục đích Định dạng Người nhận
eXTra/euBP Dữ liệu SV cho kiểm tra DRV eXTra V3.4.0 (XML) DRV
Z3 (git bundle) Dữ liệu GoBD cho kiểm tra bên ngoài của FA git bundle + Manifest + Static-Web (Z3+) FA

Ví dụ thực tiễn: DRV yêu cầu dữ liệu SV ở định dạng eXTra trong một cuộc kiểm tra doanh nghiệp. Harness xuất dữ liệu tiền lương và dữ liệu SV liên quan từ repo dưới dạng eXTra-XML. FA yêu cầu dữ liệu tuân thủ GoBD (Z3) trong một cuộc kiểm tra bên ngoài - Harness tạo một git bundle + Static-Web (Z3+, xem ED05). Cả hai lần xuất đều có thể được tạo từ dữ liệu repo có cấu trúc (JSON, Sidecars) - không cần xử lý thủ công.

Ghi log lỗi giao diện

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart TD S["Schnittstellen-Aufruf (ELSTER, DE-Mail)"] S --> OK["Erfolg: Quittung + Sidecar"] S --> ERR["Fehler: Abbruch, Timeout, Formatfehler"] ERR --> L["Fehler-Logging im Repo"] L --> E["Repo-Ereignis: Schnittstellen-Fehler"] E --> N["Nachweis: Fehler nicht verschuldet"] style S fill:#0F1B33,stroke:#0F1B33,color:#FBFAF7 style OK fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style ERR fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style L fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style E fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style N fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33
Sự kiện Hành động Triển khai GitCover
Thành công Biên nhận được lưu trữ Chứng từ kèm Sidecar, source_sha256 trong tạo phẩm
Lỗi Lỗi được ghi nhận Sự kiện repo kèm mô tả lỗi, dấu thời gian, quy định
Bằng chứng "Lỗi không do mình gây ra" Sự kiện repo làm bằng chứng khi kiểm tra

Quan trọng - Chuyển dịch trách nhiệm: Khi một giao diện thất bại (ví dụ: ELSTER hết thời gian chờ vào ngày 10 hàng tháng), việc ghi log lỗi trong repo ghi nhận rằng doanh nhân đã cố gắng truyền đúng hạn. Đây là một bằng chứng trong § 152 AO (phạt chậm nộp) - doanh nhân có thể lập luận rằng lỗi không nằm trong phạm vi trách nhiệm của mình.

Đòn bẩy rủi ro

Hôm nay (chi phí thấp) Ngày mai (có thể kiểm toán) Rủi ro được giảm thiểu
Biên nhận ELSTER làm chứng từ kèm Sidecar Có thể chứng minh việc truyền Phạt chậm nộp § 152 AO
Cảnh báo DE-Mail + giải pháp thay thế Kênh phù hợp được chọn Mất liên lạc
Xuất eXTra từ dữ liệu repo Dữ liệu SV có sẵn cho kiểm tra DRV Vi phạm GoBD khi kiểm tra DRV
Xuất Z3 dưới dạng git bundle Dữ liệu GoBD có sẵn cho kiểm tra FA Vi phạm GoBD khi kiểm tra FA
Ghi log lỗi giao diện Bằng chứng "đã thử" Chuyển dịch trách nhiệm khi giao diện gặp sự cố
Liên kết quy định Quy định được ghi nhận cho từng lần truyền Tranh cãi về việc đáp ứng quy định

Yêu cầu đối với Harness (xem trước)

Có thể suy ra từ ED20:

ID Yêu cầu Ưu tiên
FA-12.1 Trung gian ELSTER: LStA, UStA, LSt-Bescheinigung; biên nhận làm chứng từ kèm Sidecar MUST
FA-12.2 Cầu nối DE-Mail/De-Mail: EML + SHA-256 + Sidecar; xác minh người gửi SHOULD
FA-12.3 Xuất eXTra/euBP: dữ liệu SV ở định dạng eXTra cho các cuộc kiểm tra DRV SHOULD
FA-12.4 Xuất vật mang dữ liệu Z3: xuất Z3 tuân thủ GoBD (git bundle) SHOULD
FA-12.5 Ghi log lỗi giao diện: lỗi như sự kiện repo MUST
FA-12.6 Liên kết quy định: mỗi quy trình được ánh xạ tới quy định gắn với rủi ro SHOULD
FA-12.7 Giảm thiểu thảm họa DE-Mail: cảnh báo khi kênh không phù hợp NICE
FA-12.8 Sổ đăng ký định danh cơ quan nhà nước MUST

Danh sách yêu cầu đầy đủ trong Harness-Anforderungen.md.

Nguồn

Cấu trúc nguồn và liên kết tham chiếu CDN

Vai trò Vị trí Mục đích
Primary / SSoT git.gitcover.org/GCC Kho lưu trữ chuẩn (được ký GPG, được phiên bản hóa)
Bản sao OSS công khai / CDN codeberg.org/gitcover-commons Bản sao chỉ đọc; khám phá FLOSS
Trung tâm cộng đồng github.com/gitcover-commons Issues & Discussions; tham chiếu mã nguồn trên Codeberg

Lưu ý: Việc phân loại nguồn, bản sao và trung tâm cộng đồng này phản ánh trạng thái hiện tại và có thể thay đổi. Vui lòng kiểm tra nguồn chuẩn tương ứng trên gitcover.org để biết trạng thái hiện tại.