1
0
Files
asv-format-validator/README.md
T
marcus cd6e5221aa docs: Review-Korrekturen aus Peer-Review anwenden
- UNZ_0010 -> UNZ_0036 (meilensteine.md, technik-und-architektur.md)
- FEHLER_MASSNAHME -> FEHLER_MAßNAHME (meilensteine.md, technik-und-architektur.md)
- Exit-Code-Kommentar bereinigt (CLAUDE.md)
- V1-K-Nachrangigkeit ergaenzt (CLAUDE.md)
- Zielbild-Anmerkung in README
- Spec-Tippfehler DATUM_ERSTELLUNG dokumentiert (technik-und-architektur.md)
- R-CROSS-KKS-SPEZ-NACHRICHTENTYP-001 ergaenzt (fachliche-anforderungen.md)
- R-IFA-OVER-002 Quelle praezisiert, V1-V bestaetigt (fachliche-anforderungen.md)
- R-FHL-2.13-001 Feldart K, Regeltext angepasst (fachliche-anforderungen.md)
- R-GLOBAL-MIN-NACHRICHTEN-001 ergaenzt (fachliche-anforderungen.md)
- RSA-Schluessellaengen-Hinweis ergaenzt (technik-und-architektur.md)
2026-04-20 07:56:46 +02:00

3.0 KiB

ASV-Format-Validator

Lokale CLI-Anwendung zur Validierung von ASV-Abrechnungsdateien (ambulante spezialfachärztliche Versorgung gemäß § 116b Abs. 6 Satz 12 SGB V) gegen die Technische Anlage ASV 1.09 (Stand 09.10.2025, anzuwenden ab Leistungserbringungsquartal 2/2026).

Status

🚧 In Entwicklung — Version 1 (V1)

Die Implementierung folgt einem Meilenstein-Modell (siehe docs/specs/meilensteine.md). Aktuell in Arbeit: Meilenstein 1 — Projektfundament.

Was macht das Tool?

Der Validator prüft lokal vorliegende ASV-Artefakte gegen die Technische Anlage ASV 1.09. Unterstützte Artefakte in V1:

(Zielbild V1 — noch nicht vollständig implementiert, siehe Meilensteinplan)

  • ASV-Nutzdatendateien mit ASVREC (Abrechnung)
  • ASV-Fehlernachrichten mit ASVFEH
  • Storno-Nachrichten als Sonderausprägung von ASVREC
  • Auftragsdateien (.AUF, KKS-Auftragssatz)
  • verschlüsselte bzw. transportnahe PKCS#7-Artefakte

Pro Lauf wird genau eine Datei validiert. Ausgabe: ein deutscher Textbericht (Konsole + Berichtdatei) und eine technische Log-Datei.

Nutzung (geplant, noch nicht vollständig implementiert)

java -jar asv-format-validator.jar <pfad-zur-datei>

Exit-Codes:

Code Bedeutung
0 gültig, keine Fehler-Befunde
1 ungültig, mindestens ein Spec-Fehler
2 Bedienfehler (z.B. Datei nicht lesbar, falsches Argument)

Technisches Zielbild

  • Java 21, Maven
  • Hexagonale Architektur, manuelle Constructor Injection, kein DI-Framework
  • SLF4J + Log4j2 für Logging
  • ISO 8859-15 als Eingabe-Encoding, UTF-8 für Ausgabeartefakte
  • Nicht Server, nicht Container, nicht Batch — bewusst schlank

Details siehe docs/specs/technik-und-architektur.md.

Dokumentation

Alle normativen Dokumente liegen unter docs/specs/:

Arbeitspakete und Berichte pro Meilenstein unter docs/arbeitspakete/m<n>/.

Preview-Code

Das Repository enthält eine frühere, noch unvollständige Implementierung aus einer Sondierungsphase (u.a. Parser und Validator-Gerüst). Diese Teile werden in den Meilensteinen M1 bis M2 evolutionär in die neue hexagonale Struktur überführt bzw. als Vorbau für spätere Meilensteine eingefroren. Details dazu in docs/arbeitspakete/m1/AP09-altlogik-einfrieren.md.

Build

mvn clean verify

Nicht-Ziele von Version 1

Siehe technik-und-architektur.md, Abschnitt „Nicht-Ziele". Insbesondere: keine GUI, keine Batch-Verarbeitung, keine Referenzdatenbestände, keine Stufe-4-Prüfungen, kein Mehrversionssupport.