Ü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 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.