Über NormAPI
Wer NormAPI baut — und woher die Regeln kommen
Ein Produkt, das verspricht, die Spezifikation gelesen zu haben, sollte sagen, wer sie gelesen hat. Diese Seite tut das, und sie nennt nur Dinge, die Sie nachprüfen können.
Eine Person
NormAPI wird von Dmytro Yalanskyi gebaut. Der Code, die Regel-Erklärungen und dieser Text stammen von derselben Person — jede Regelseite trägt deshalb eine Zeile mit Namen und dem Datum, an dem sie zuletzt gegen das Regelwerk geprüft wurde.
Support läuft schriftlich auf Deutsch und Englisch, Telefonate auf Englisch. Das steht hier, weil es beim ersten Kontakt sonst überrascht.
Woher die Prüfung kommt
NormAPI implementiert das Regelwerk nicht nach. Geprüft wird mit dem Validierungswerkzeug der KoSIT selbst, gegen die offizielle Validator-Konfiguration zur XRechnung — dieselbe Software, die auch hinter den Prüfstellen der Verwaltung steht.
Die Konfiguration ist im Build mit ihrer SHA-256-Prüfsumme festgenagelt. Ein stiller Austausch der Regeln ist damit nicht möglich: entweder es ist die veröffentlichte Fassung, oder der Build schlägt fehl.
Welche Fassung gerade aktiv ist, steht auf jeder Seite und in jeder API-Antwort — derzeit v2026-08-31. Was sich mit einer neuen Fassung ändert, steht im Regelwerk-Changelog. Ein Prüfergebnis ohne die Fassung, gegen die geprüft wurde, ist in zwei Jahren nicht mehr einzuordnen.
Die Erklärungen zu den einzelnen Regeln sind offen: github.com/normapi-de/xrechnung-rules-explained. Wer widersprechen will, kann das an der Quelle tun.
Was wir gemessen haben
Zwei Fragen, über die in diesem Markt viel geschrieben und wenig gemessen wird, haben wir gemessen und die Daten mitveröffentlicht — unter CC BY 4.0, damit jemand widersprechen kann, ohne uns glauben zu müssen.
- Elf Online-Validatoren, dieselbe Rechnung, ein Tag — drei verarbeiteten eine XRechnung in UBL überhaupt nicht, drei weitere prüften gegen ein Regelwerk von vor dem 2. September 2026.
- Validator-Vergleich: 29 Dokumente, zwei Prüfer — zwei unabhängige Implementierungen desselben Regelwerks, einig bei 22 Dokumenten und uneinig bei 7.
Was NormAPI nicht tut
- Dokumente speichern. Der Validator prüft und verwirft; die Antwort ist der Bericht, und Ihr Archiv bleibt Ihres.
- Steuer- oder Rechtsberatung leisten. Eine technisch fehlerfreie Rechnung kann inhaltlich falsch sein, und das erkennt kein Prüfprogramm.
- Raten. Wenn die offizielle Konfiguration für ein Profil kein Szenario kennt, sagt der Bericht „nicht geprüft“ und nicht „keine Fehler“.
Kontakt
Fragen zur Prüfung, zu einem konkreten Regelcode oder zur Integration: kontakt@normapi.de. Wenn Sie eine Rechnung haben, die abgelehnt wurde, schicken Sie sie mit — das beantwortet die meisten Fragen schneller als eine Beschreibung.