ED20 - Thực hành 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 trong pháp luật, nhưng trên thực tế hầu như không thể sử dụng đối với người không chuyên:
- ELSTER: Phức tạp, dễ phát sinh lỗi - giao diện ELSTER yêu cầu chứng thư, định dạng XML, phần mềm client - là một rào cản đối với người không chuyên
- DE-Mail: Đã ngừng - DE-Mail được thiết kế làm kênh liên lạc an toàn với cơ quan nhà nước, nhưng đã chính thức ngừng hoạt động (nhà cung cấp cuối cùng vào ngày 31.12.2026). E-mail đã lưu trữ trong các hệ thống đã ngừng không còn truy cập được - đây là vấn đề lưu giữ liên quan đến GoBD
- eXTra: Không rõ - định dạng eXTra (dữ liệu SV) dành cho văn phòng tính lương, không dành cho doanh nghiệp - nhưng đột nhiên lại trở nên liên quan trong kiểm tra DRV
- Phương tiện lưu trữ Z3: Kiến thức chuyên môn - bản xuất Z3 tuân thủ GoBD đòi hỏi phần mềm chuyên dụng hoặc xử lý thủ công
- Lỗi giao diện: Không được ghi nhận - khi ELSTER hoặc DE-Mail thất bại, lỗi không được ghi vào Repo - thiếu bằng chứng "tôi đã thử"
- Liên kết quy định: Không được ánh xạ - mỗi lần gửi qua giao diện đều gắn với một quy định (ví dụ LStA → § 41a EStG), nhưng ánh xạ này không được ghi nhận
Thông điệp cốt lõi
GitCover-Harness làm trung gian giữa các hệ thống bên ngoài và các quy định liên quan đến rủi ro:
- Trung gian qua ELSTER - LStA, UStA, LSt-Bescheinigung qua giao diện ELSTER; biên nhận dưới dạng chứng từ kèm Sidecar
- DE-Mail: đã ngừng - cần chuyển đổi - DE-Mail lịch sử phải được chuyển vào Repo dưới dạng EML + SHA-256 + Sidecar trước khi ngừng; e-mail đã lưu trữ trong các hệ thống đã ngừng không còn truy cập được - vấn đề lưu giữ GoBD
- Xuất eXTra/euBP - có thể xuất dữ liệu SV theo định dạng eXTra cho các cuộc kiểm tra DRV
- Xuất phương tiện lưu trữ Z3 - bản xuất Z3 tuân thủ GoBD cho kiểm tra thực địa của FA (git bundle dưới dạng lưu trữ tự chứa)
- Ghi nhật 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 dưới dạng sự kiện Repo
- Liên kết quy định - mỗi thao tác giao diện được ánh xạ tới quy định liên quan đến rủi ro
Tuân thủ theo thiết kế: 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 gửi dữ liệu, mỗi biên nhận, mỗi lỗi đều được ghi lại trong Repo theo cách có thể kiểm chứng.
Bức tranh tổng thể các giao diện với cơ quan nhà nước
| Giao diện | Mục đích | Độ phức tạp | GitCover trung gian |
|---|---|---|---|
| ELSTER | LStA, UStA, chứng nhận LSt, trình xem hóa đơn điện tử | cao (chứng thư, XML, client) | Biên nhận dưới dạng 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) | Chuyển đổi: EML + Sidecar vào Repo; cảnh báo |
| eXTra/euBP | Dữ liệu SV cho kiểm tra DRV | cao (định dạng chuyên dụng) | Xuất từ dữ liệu Repo |
| Phương tiện lưu trữ Z3 | Bản xuất tuân thủ GoBD cho kiểm tra thực địa của FA | cao (phần mềm chuyên dụng) | git bundle dưới dạng lưu trữ tự chứa |
Trung gian qua ELSTER
| Bước | Hành động | Triển khai GitCover |
|---|---|---|
| LStA đã tính toán | Tờ khai thuế thu nhập cá nhân từ bảng tính lương | artifact JSON trong Repo (xem ED14) |
| Gửi qua ELSTER | Điện tử qua ELSTER (yêu cầu chứng thư) | Harness gọi ELSTER |
| Biên nhận | ELSTER xác nhận việc gửi dữ liệu | Biên nhận dưới dạng chứng từ kèm Sidecar |
| Bản ghi 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 artifact |
| Ghi nhật 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 thao tác giao diện được ánh xạ tới quy định liên quan đến rủi ro - ví dụ LStA → § 41a EStG, UStA → § 18 UStG, LSt-Bescheinigung → § 41b EStG. Nhờ đó có thể kiểm chứng quy định nào đã được tuân thủ bằng lần gửi dữ liệu nào.
DE-Mail - Đã ngừng: Chuyển đổi và hệ quả lưu trữ
DE-Mail đã chính thức ngừng hoạt động. Dự án được xem là thất bại. Nhà cung cấp cuối cùng (FP Digital Business Solutions GmbH) sẽ ngừng cung cấp dịch vụ vào ngày 31.12.2026 - sau đó DE-Mail không còn sử dụng được và e-mail đã 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ì không còn tính kinh tế" |
| 1&1 De-Mail GmbH ngừng hoạt động | 07.02.2025 | Dịch vụ không còn khả dụng |
| § 130a ZPO bị bãi bỏ | 22.12.2025 | De-Mail bị chấm dứt với tư cách là phương thức truyền tải an toàn (BGBl. 2025 I Nr. 349) |
| Cơ quan hành chính liên bang ngừng | Tháng 7 năm 2024 | Ngừng sử dụng bắt buộc |
| Nhà cung cấp cuối cùng (FP Digital) ngừng | 31.12.2026 | "Đó là kết cục của De-Mail" |
| Ban Kiểm toán Liên bang 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 |
| Chỉ trích của CCC | 2013 | Linus Neumann (30C3): "Bullshit made in Germany - được xây dựng không an toàn một cách cố ý" |
DE-Mail đã trở thành quá khứ: Nhà cung cấp cuối cùng (FP Digital Business Solutions GmbH) sẽ ngừng cung cấp dịch vụ vào ngày 31.12.2026. Việc được pháp luật công nhận với tư cách là phương thức truyền tải an toàn (§ 130a Abs. 4 Nr. 1 ZPO) đã bị bãi bỏ ngày 22.12.2025. Cơ quan hành chính liên bang đã ngừng sử dụng bắt buộc vào tháng 7 năm 2024. Ban Kiểm toán Liên bang ghi nhận năm 2021: chi phí 6,5 triệu EUR để tiết kiệm ~3.500 EUR. Phương án thay thế được dự kiến là "European Business Wallet (EBW)".
Hệ quả của e-mail đã lưu trữ trong các hệ thống đã ngừng
Khi một nhà cung cấp DE-Mail ngừng cung cấp dịch vụ, sẽ xảy ra ngay lập tức các vấn đề lưu giữ liên quan đến GoBD:
| Vấn đề | Hệ quả | Liên quan đến GoBD |
|---|---|---|
| Hộp thư không còn truy cập được | Không thể truy xuất e-mail nữa | § 146 Abs. 5 AO ("luôn sẵn có") |
| Nhà cung cấp tự xóa | Dữ liệu bị xóa sau khi ngừng hoạt động | § 147 Abs. 1 AO (nghĩa vụ lưu giữ 6 năm) |
| Không thể xuất | Nếu nhà cung cấp không cung cấp chức năng xuất, dữ liệu sẽ mất vĩnh viễn | GoBD Rz. 146 (khả năng truy xuất) |
| Mất giá trị chứng minh | Không thể xác minh các xác nhận riêng của DE-Mail (xác nhận gửi/nhận) nữa | Mất bằng chứng trong tranh chấp với cơ quan nhà nước |
| Không thực hiện giám định pháp y chứng cứ | Sau đó, người không chuyên gần như không thể kiểm tra tính xác thực của các e-mail cũ theo phương pháp pháp y - thiếu dữ liệu xác minh (kiểm tra chữ ký, máy chủ dấu thời gian, sổ nhật ký của nhà cung cấp) khi không có hạ tầng của nhà cung cấp | Hạ giá trị chứng cứ xuống mức "chỉ là bản sao PDF" |
| Thời hạn lưu giữ vẫn còn hiệu lực | E-mail từ năm 2024 phải được lưu giữ đến ngày 31.12.2030 - nhưng hệ thống sẽ biến mất vào năm 2026 | Vi phạm GoBD do không thể lưu giữ |
Xác minh chứng cứ pháp y - gần như không thể thực hiện sau: Các đặc trưng chứng cứ riêng 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) chỉ có thể được xác minh trong hạ tầng của nhà cung cấp đang hoạt động. Sau khi ngừng, dữ liệu xác minh không còn khả dụng. Sau đó, người không chuyên gần như không thể kiểm tra tính xác thực DE-Mail của tệp EML đã xuất - 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 và sổ nhật ký của nhà cung cấp đã bị xóa. E-mail mất tư cách là "giao tiếp DE-Mail có hiệu lực ràng buộc pháp lý" và suy giảm thành chỉ là bản sao PDF với giá trị chứng minh bị giảm mạnh. Việc thực hiện giám định pháp y chứng cứ sau đó bởi chuyên gia về lý thuyết là có thể, nhưng thực tế hầu như không thể thực hiện - dữ liệu hạ tầng của nhà cung cấp cần thiết không còn tồn tại.
Cảnh báo nghiêm trọng - Chuyển đổi trước khi ngừng: Doanh nghiệp vẫn còn hộp thư DE-Mail phải trước khi ngừng xuất tất cả e-mail liên quan dưới dạng tệp EML và chuyển vào Git-Repo (EML + SHA-256 + Sidecar). Sau khi ngừng, việc xuất không còn khả thi - dữ liệu sẽ mất vĩnh viễn. Đây là vi phạm GoBD nếu thời hạn lưu giữ vẫn còn hiệu lực (6 năm kể từ cuối năm, § 147 Abs. 1 Nr. 2/3 AO).
Chuyển đổi GitCover: DE-Mail -> Repo
| Bước | Hành động | Thời hạn |
|---|---|---|
| Xuất | Xuất tất cả e-mail liên quan dưới dạng EML | trước khi ngừng (chậm nhất 31.12.2026) |
| SHA-256 | Tính hash cho từng tệp EML | khi chuyển đổi |
| Sidecar | .v7g.md cho từng EML kèm phân loại |
khi chuyển đổi |
| Lưu trữ | EML + Sidecar trong sources/korrespondenz/ |
khi chuyển đổi |
| Xác minh | Kiểm tra tính đầy đủ (số lượng e-mail) | sau khi chuyển đổi |
Mẹo thực hành: Việc chuyển đổi nên được thực hiện ngay lập tức, không phải chỉ ngay trước khi ngừng. Nhà cung cấp có thể giới hạn dịch vụ sớm (ví dụ không cho đăng ký mới, hạn chế xuất). Ai chờ thì có nguy cơ mất dữ liệu.
| 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 chuyển đổi |
| Chi phí/lợi ích | Chi phí 6,5 triệu EUR, tiết kiệm ~3.500 EUR (Ban Kiểm toán Liên bang) | git bundle và hộp thư ELSTER đều miễn phí |
| Bảo mật | "được xây dựng không an toàn một cách cố ý" (CCC, Linus Neumann 2013) | Git + GPG + SHA-256 |
| Công nhận pháp lý | § 130a ZPO bị bãi bỏ ngày 22.12.2025 | Không còn liên quan |
| Lưu trữ | E-mail đã lưu trữ trong các hệ thống đã ngừng không còn truy cập được | Chuyển đổi: EML + SHA-256 + Sidecar vào Repo |
| Thời hạn lưu giữ | E-mail từ năm 2024 phải được lưu giữ đến năm 2030 - hệ thống biến mất vào năm 2026 | Vi phạm GoBD đối với dữ liệu chưa chuyển đổi |
| Phương án thay thế | Đang dự kiến European Business Wallet (EBW) | Còn chưa rõ; GitCover độc lập |
Giảm thiểu rủi ro 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ị chuyển đổi ngay lập tức tất cả e-mail liên quan dưới dạng EML + Sidecar vào Repo. Sau khi ngừng (chậm nhất 31.12.2026), dữ liệu sẽ mất vĩnh viễn - vi phạm GoBD nếu thời hạn lưu giữ vẫn còn hiệu lực. Phương án thay thế cho giao tiếp trong tương lai: hộp thư ELSTER cho các vấn đề thuế, e-mail thông thường + lưu trữ Sidecar cho thư từ.
Xuất eXTra/euBP và phương tiện lưu trữ Z3
| Bản xuất | Mục đích | Định dạng | Bên 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 thực địa của FA | git bundle + Manifest + Static-Web (Z3+) | FA |
Ví dụ thực tế: DRV yêu cầu dữ liệu SV theo định dạng eXTra trong một cuộc kiểm tra hoạt động. Harness xuất dữ liệu lương và 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 thực địa - Harness tạo git bundle + Static-Web (Z3+, xem ED05). Cả hai bả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 nhật lỗi giao diện
| Sự kiện | Hành động | Triển khai GitCover |
|---|---|---|
| Thành công | Lưu trữ biên nhận | Chứng từ kèm Sidecar, source_sha256 trong artifact |
| Lỗi | Ghi nhận lỗi | 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 doanh nghiệp gây ra" | Sự kiện Repo làm bằng chứng khi kiểm tra |
Quan trọng - Chuyển gánh nặng trách nhiệm: Khi một giao diện thất bại (ví dụ, ELSTER timeout vào ngày 10 hàng tháng), việc ghi nhật lỗi trong Repo ghi lại rằng doanh nghiệp đã thử gửi đúng hạn. Đây là bằng chứng theo § 152 AO (phụ thu trễ) - doanh nghiệp có thể lập luận rằng lỗi không nằm trong phạm vi kiểm soát của mình.
Đòn bẩy rủi ro
| Hiện tại (rẻ) | Ngày mai (chống được kiểm toán) | Rủi ro được giảm thiểu |
|---|---|---|
| Biên nhận ELSTER dưới dạng chứng từ kèm Sidecar | Có thể chứng minh việc gửi dữ liệu | Phụ thu trễ § 152 AO |
| Cảnh báo DE-Mail + phương án thay thế | Đã chọn kênh phù hợp | Mất thông tin liên lạc |
| Xuất eXTra từ dữ liệu Repo | Dữ liệu SV khả dụng 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 khả dụng cho kiểm tra FA | Vi phạm GoBD khi kiểm tra FA |
| Ghi nhật lỗi giao diện | Bằng chứng "đã thử" | Chuyển gánh nặng trách nhiệm khi giao diện sập |
| Liên kết quy định | Quy định được ghi nhận cho từng lần gửi dữ liệu | Phủ nhận việc tuân thủ quy định |
Yêu cầu đối với Harness (xem trước)
Suy ra từ ED20:
| ID | Yêu cầu | Mức độ ưu tiên |
|---|---|---|
| FA-12.1 | Trung gian qua ELSTER: LStA, UStA, LSt-Bescheinigung; biên nhận dưới dạng 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 theo định dạng eXTra cho các cuộc kiểm tra DRV | SHOULD |
| FA-12.4 | Xuất phương tiện lưu trữ Z3: bản xuất Z3 tuân thủ GoBD (git bundle) | SHOULD |
| FA-12.5 | Ghi nhật lỗi giao diện: lỗi dưới dạng sự kiện Repo | MUST |
| FA-12.6 | Liên kết quy định: mỗi thao tác được ánh xạ tới quy định liên quan đến rủi ro | SHOULD |
| FA-12.7 | Giảm thiểu rủi ro thảm họa DE-Mail: cảnh báo khi dùng 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 đủ nằm trong Harness-Anforderungen.md.
Nguồn
- AO (§ 147 Abs. 6 - truy cập dữ liệu Z1/Z2/Z3, § 152 - phụ thu trễ)
- EStG (§ 41a - tờ khai thuế thu nhập cá nhân, § 41b - chứng nhận thuế thu nhập cá nhân)
- UStG (§ 18 - tờ khai thuế giá trị gia tăng, § 14 - hóa đơn điện tử)
- SGB IV (§ 28p - kiểm tra hoạt động DRV, § 28a - báo cáo DEÜV)
- GoBD (thông tư BMF, Rz. 147 - khả năng kiểm chứng, truy cập dữ liệu Z3)
- DE-Mail (Wikipedia, tại thời điểm 14.08.2026) - "Đó là kết cục của De-Mail": Telekom 31.08.2022, 1&1 07.02.2025, § 130a ZPO 22.12.2025 bị bãi bỏ, Cơ quan hành chính liên bang tháng 7 năm 2024, FP Digital 31.12.2026, Ban Kiểm toán Liên bang 2021
- BGBl. 2025 I Nr. 349 - Luật bãi bỏ § 130a Abs. 4 Nr. 1 ZPO (DE-Mail)
- Báo cáo thường niên 2021 của Ban Kiểm toán Liên bang - DE-Mail: chi phí 6,5 triệu EUR, tiết kiệm ~3.500 EUR
- CCC 30C3 2013 - Linus Neumann: "Bullshit made in Germany"
E1/agents/(ẩn danh) - Khái niệm SSoT với ELSTER, ghi nhật lỗi giao diện
Sơ đồ nguồn và liên kết CDN
| Vai trò | Vị trí | Mục đích |
|---|---|---|
| Nguồn chính / SSoT | git.gitcover.org/GCC | Kho lưu trữ chuẩn (có chữ 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; FLOSS-Discovery |
| Trung tâm cộng đồng | github.com/gitcover-commons | Vấn đề & Thảo luận; tham chiếu mã nguồn trên Codeberg |
Lưu ý: Sự phân công giữa 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 từng nguồn chuẩn trên gitcover.org để biết trạng thái hiện tại.