API-Dokumentation
Was ist eunormia?
eunormia erzeugt, liest und validiert elektronische Rechnungen nach ZUGFeRD/Factur-X (PDF/A-3 mit eingebettetem CII-XML, EN 16931) und XRechnung. Ausgeliefert wird nur, was die Validierung besteht — jede erzeugte Rechnung durchläuft veraPDF (PDF/A-3) und das EN-16931-Schematron. Rechnungsdaten und PDFs werden ausschließlich im Arbeitsspeicher verarbeitet und nie gespeichert.
Authentifizierung
Alle Endpunkte funktionieren anonym (Ergebnisse tragen dann
ein Muster-Wasserzeichen, Tageslimit pro IP). Mit einem Konto erzeugen Sie unter
API-Tokens einen Bearer-Token
(Authorization: Bearer eun_live_…) für produktive, wasserzeichenfreie
Ergebnisse im Rahmen Ihres Kontingents.
Gehostet oder offline
| Online-API | Offline-SDK (Eunormia.Sdk) | |
|---|---|---|
| Einsatz | HTTP-Aufrufe an eunormia.com | .NET-Bibliothek in Ihrer Anwendung |
| Infrastruktur | keine (wir betreiben) | keine (alles im NuGet-Paket) |
| Datenfluss | Rechnung geht über unsere Server (nur RAM) | verlässt Ihr Haus nie |
| Funktionsumfang | identisch: erzeugen, lesen, validieren — gleiche Gates | |
Endpunkte
POST /v1/convert— Rechnung erzeugen (JSON/CII-XML + PDF → validiertes ZUGFeRD)POST /v1/read— eingehende Rechnung als strukturiertes JSON lesenPOST /v1/validate— eingehende Rechnung prüfen (inkl. optionaler amtlicher Prüfungen)
Maschinenlesbare Spezifikation: openapi.json. Zum Ausprobieren ohne Code: Konverter und Validierung im Browser.