Fünf Funktionen · eine API · ein Token

Funktionen der API

Fünf Funktionen, einzeln und in beliebiger Reihenfolge aufrufbar. xml-rechnung.eu nutzt dieselben.

Jetzt kostenlos starten API-Dokumentation

Im Überblick

Input, Output und Kosten je Funktion. Abgerechnet wird nur die Archivierung, ein Credit je Dokument, zu diesen Preisen.

Funktion	Input	Output	Credits
Validieren	XML oder ZUGFeRD-PDF	Ergebnis, Fehler, Warnungen, Prüfbericht	nein
Rendern	XML oder ZUGFeRD-PDF	HTML oder PDF	nein
Auslesen	XML oder ZUGFeRD-PDF	Business Terms der EN 16931	nein
Erzeugen	Rechnungsdaten als JSON	XRechnung (XML) oder ZUGFeRD (PDF)	nein
Archivieren	das geprüfte Dokument	Belegnummer, Ablageort, Aufbewahrungsfrist	ja

Validieren

Validierung mit dem KoSIT-Validator, dem offiziellen Prüfwerkzeug für EN 16931, XRechnung und Peppol BIS Billing. Format und Standard werden automatisch erkannt.

Response

Ergebnis (accept oder reject), Anzahl der Fehler und Warnungen, jede Meldung einzeln und der vollständige KoSIT-Prüfbericht.

ZUGFeRD-PDF

Das eingebettete XML wird extrahiert und validiert. Derselbe Endpoint für XML und PDF, ohne vorherige Formaterkennung.

Alternativ: selbst betreiben

Der Validator ist auch als Docker-Image verfügbar, ohne Konto. Die Prüfung ist identisch, der Unterschied liegt im Betrieb.
Zu den Docker-Images ›

Rendern und auslesen

Rendering des XML als HTML für die Anzeige oder als PDF für den Druck. Der Inhalt entspricht exakt den Daten im XML.

Auslesen liefert strukturierte Daten. Die Felder der EN 16931 kommen einzeln und benannt zurück, etwa BT-1 Rechnungsnummer und BT-2 Rechnungsdatum, unabhängig davon, ob die Rechnung als UBL oder CII vorliegt.

Das ist das Format für die Übernahme in eine Warenwirtschaft: Felder statt Dokumente.

Keine Credits Beides sind lesende Requests. Abgerechnet wird erst die Archivierung.

Erzeugen

Aus Rechnungsdaten im JSON-Format entsteht eine normkonforme E-Rechnung: XRechnung als XML oder ZUGFeRD als PDF mit eingebettetem XML. Die Felder sind nach den Business Terms der EN 16931 benannt.

CII oder UBL per Parameter

Die Syntax wählt ein Parameter, kein eigener Endpoint. Ändert sich die Anforderung des Empfängers, ändert sich ein Wert, nicht die Integration.

Validierung vor dem Versand

Die erzeugte Rechnung lässt sich im selben Durchlauf validieren. Fehler fallen vor dem Versand auf, nicht beim Empfänger.

Ein Request, ein Dokument

API=https://api.xml-invoice.io

curl -X POST "$API/v2/invoice/xml?cius=xrechnung" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @invoice.json

invoice.json trägt die Rechnungsdaten als Business Terms; gut vierzig Felder genügen für eine einzeilige XRechnung. Zurück kommt das Dokument mit dem Prüfergebnis in derselben Antwort.
Alle Parameter ›

Archivieren

Unveränderbare Ablage im Objektspeicher mit Prüfsumme, Eingangszeitpunkt und Aufbewahrungsfrist nach § 147 Abs. 4 AO: acht Jahre ab dem Schluss des Kalenderjahres des Belegdatums.

Der einzige kostenpflichtige Request: ein Credit je Dokument, gleich ob Eingangs- oder Ausgangsrechnung. Validieren, Rendern und Erzeugen bleiben frei.

Der Prüfbericht wird mit archiviert. Das Validierungsergebnis bleibt so für die gesamte Aufbewahrungsfrist am Beleg nachweisbar.

Ihr Archiv gehört Ihnen Zugriff auf alle Dokumente während der gesamten Aufbewahrungsfrist, per API und in der Anwendung.

Erster Request in wenigen Minuten.

Kostenloses Konto mit 10 Credits zum Start. Der API-Zugang gehört zum Abo Plus: 12,00 € im Monat, monatlich kündbar.

Konto anlegen und E-Mail bestätigen. Keine Kreditkarte nötig.
API-Token kopieren und Abo buchen. Beides unter „Mein Konto“.
Ersten Request senden. Validieren kostet keine Credits.

Jetzt kostenlos starten API-Dokumentation

Fair & transparent

Abgerechnet wird nur die Archivierung. Validieren, Auslesen und Erzeugen kosten keine Credits.
Gekaufte Credits verfallen nicht. Auch beim Wechsel ins Abo bleiben sie erhalten.
Ihr Archiv gehört Ihnen. Zugriff per API und Anwendung während der gesamten Aufbewahrungsfrist.

Alle Preise netto zuzüglich Umsatzsteuer.

Keine Steuer- oder Rechtsberatung: Wir beraten weder steuerlich noch rechtlich. Bitte wenden Sie sich für solche Fragen an einen Steuerberater oder ein Steuerbüro.

Angebot für Unternehmer: Unser Angebot richtet sich ausschließlich an Unternehmer im Sinne des § 14 BGB — an Gewerbetreibende, Freiberufler und juristische Personen. Ein Vertragsschluss mit Verbrauchern ist nicht vorgesehen. Alle genannten Preise sind Nettopreise und verstehen sich zuzüglich der gesetzlichen Umsatzsteuer.

Compliance: Wir prüfen mit dem offiziellen KoSIT-Validator 1.6.3 und den Konfigurationen für XRechnung 3.0.2 und Peppol BIS 3.0.21. Die Images sind auf Docker Hub verfügbar.

Haftungsausschluss: Die auf dieser Website veröffentlichten Informationen wurden teilweise mit Unterstützung von KI recherchiert und aufbereitet. Trotz sorgfältiger Kontrolle und regelmäßiger Überprüfung können wir keine Haftung für die Richtigkeit, Vollständigkeit oder Aktualität der bereitgestellten Inhalte übernehmen. Wenn Sie Fehler finden oder Verbesserungsvorschläge haben, freuen wir uns über einen Hinweis.