TaxLayer
Technik2026-11-138 Min. Lesezeitvon TaxLayer Team

E-Rechnung per API: CSV und XML automatisch in ZUGFeRD, XRechnung und PEPPOL umwandeln und prüfen

Die E-Rechnungspflicht trifft Unternehmen mit vielen Rechnungen am härtesten. Wer im Monat hunderte oder tausende Rechnungen schreibt, kann sie nicht einzeln hochladen, prüfen und herunterladen. Gleichzeitig hat nicht jedes ERP ein E-Rechnungsmodul, und eigene Software müsste ZUGFeRD, XRechnung und PEPPOL selbst erzeugen, aktuell halten und gegen die offiziellen Regeln prüfen. Eine API schließt diese Lücke: Ihre Software liefert die Daten, die Schnittstelle liefert geprüfte E-Rechnungen. Dieser Leitfaden zeigt, wie das funktioniert und worauf Sie bei der Auswahl achten sollten.

> Kurzantwort: Eine E-Rechnung-API nimmt Rechnungsdaten aus Ihrem System entgegen und gibt fertige Dateien in ZUGFeRD, XRechnung oder PEPPOL zurück. Am zuverlässigsten sind strukturierte Eingaben (CSV oder XML), weil keine Werte geraten werden. Entscheidend ist, dass jede Datei vor der Ausgabe gegen EN 16931 und die KoSIT-Regeln geprüft wird. Die TaxLayer-API bietet dafür vier Endpunkte (Status, CSV umwandeln, XML umwandeln, Prüfen) und ist in Enterprise enthalten.

Warum eine API statt Handarbeit

Eine E-Rechnung ist ein strukturierter Datensatz nach EN 16931. Ihn von Hand zu erzeugen, kostet je Rechnung nur wenige Minuten, bei großen Mengen aber Tage im Monat. Dazu kommen Fehlerquellen: falsche Einheiten-Codes, fehlende Pflichtangaben für die XRechnung, Rundungsdifferenzen in der Steueraufstellung. Eine API automatisiert den ganzen Weg:

  • Ihr System exportiert die Rechnungsdaten, etwa nachts als CSV-Datei.
  • Ein kleines Skript sendet die Datei an die Schnittstelle.
  • Die API erzeugt je Rechnung eine ZUGFeRD-PDF, XRechnung oder PEPPOL-Datei.
  • Jede Datei wird geprüft, bevor sie zurückkommt. Fehlerhafte Rechnungen kommen mit Begründung zurück statt als ungültige Datei.

So bleibt Ihr Rechnungsprozess wie er ist, nur am Ende steht eine gültige E-Rechnung.

Welche Eingabe: CSV, XML oder PDF

Die wichtigste Frage bei der Automatisierung ist, in welcher Form die Daten vorliegen.

EingabeTypische QuelleZuverlässigkeit
CSVERP-Export, Warenwirtschaft, Tabellesehr hoch, Werte werden exakt übernommen
XML (UBL, CII)vorhandene E-Rechnungen, moderne Systemesehr hoch, regelbasiert gelesen
PDFRechnungsdruck aus beliebigen Systemengut, aber nur mit menschlicher Prüfung

CSV ist der einfachste Weg für Systeme ohne E-Rechnungsmodul. Fast jedes ERP kann Rechnungen als Tabelle ausgeben. In der TaxLayer-Vorlage steht jede Position in einer Zeile, die Kopfdaten (Verkäufer, Käufer, Zahlung) werden je Zeile wiederholt. Eine Datei darf viele Rechnungen enthalten, gruppiert nach Rechnungsnummer.

XML lohnt sich, wenn bereits E-Rechnungen vorliegen und nur das Format wechseln soll. Typisch ist eine XRechnung für eine Behörde, die ein Kunde zusätzlich als lesbare ZUGFeRD-PDF möchte, oder eine ZUGFeRD-Rechnung, die über das PEPPOL-Netz verschickt werden soll. UBL (XRechnung, PEPPOL BIS) und CII (ZUGFeRD, Factur-X) werden regelbasiert gelesen, ohne KI.

PDF ist die Eingabe, die am meisten Komfort verspricht und am wenigsten Sicherheit bietet. Moderne KI liest Rechnungsdaten aus PDFs sehr gut, aber nicht fehlerfrei. Eine vertauschte Ziffer im Betrag oder ein falsch erkannter Steuersatz landet sonst ungeprüft in einer rechtsverbindlichen Rechnung. TaxLayer bietet PDF deshalb bewusst nur in der Web-App an, mit Prüfschritt vor der Ausgabe und im Stapel bis zu 50 Rechnungen (Enterprise Plus: 70). Warum eine PDF allein keine E-Rechnung ist, erklärt der Beitrag Excel und PDF sind keine E-Rechnung.

Prüfung: der Teil, den viele vergessen

Eine E-Rechnung ist erst dann eine E-Rechnung, wenn sie den Regeln entspricht. Für Deutschland sind das die EN 16931 und für die XRechnung zusätzlich die deutschen Geschäftsregeln (BR-DE), etwa die Telefonnummer und E-Mail-Adresse des Verkäufers. Diese Regeln prüft die Koordinierungsstelle für IT-Standards (KoSIT) mit einem offiziellen Regelwerk, das auch öffentliche Rechnungsempfänger einsetzen.

Achten Sie bei einer API auf drei Punkte:

  • Prüfung vor der Ausgabe: Jede erzeugte Datei sollte gegen das vollständige Regelwerk laufen, nicht nur gegen das XML-Schema.
  • Automatisch heißt automatisch: Auch die beste Prüfung bestätigt nur die Form. Bei TaxLayer laufen alle Prüfungen maschinell, es gibt keine manuelle Kontrolle; den Inhalt (Beträge, Steuersätze, Empfänger) verantworten Sie wie bisher selbst.
  • Fail-closed: Ist der Prüfdienst nicht erreichbar, darf die API keine ungeprüfte Datei ausgeben. Die TaxLayer-API antwortet dann mit 503 und berechnet nichts; Ihr Skript sendet die Anfrage einfach erneut.
  • Verständliche Fehler: Statt „ungültig“ brauchen Sie den Regelcode und eine Meldung, zum Beispiel BR-DE-6 für die fehlende Telefonnummer. Nachschlagen können Sie Codes im Verzeichnis XRechnung-Fehlercodes.

Der Prüf-Endpunkt ist auch für Eingangsrechnungen nützlich: Bevor eine Lieferantenrechnung in die Buchhaltung geht, zeigt er, ob sie den Regeln entspricht. Für einzelne Dateien gibt es zusätzlich den kostenlosen Validator im Browser.

Sicherheit und Datenschutz

Eine Rechnungs-API verarbeitet sensible Daten. Fragen Sie nach:

  • Schlüsselverwaltung: API-Schlüssel sollten nur als Hash gespeichert und jederzeit widerrufbar sein. Bei TaxLayer sehen Sie einen Schlüssel einmal beim Erstellen; ein widerrufener Schlüssel ist sofort ungültig.
  • Kein Browserzugriff: Schlüssel gehören auf den Server. Die TaxLayer-API sendet keine CORS-Header, Aufrufe aus Webseiten sind damit nicht möglich.
  • Speicherung: Rechnungsdateien sollten nicht gespeichert werden. Das Zugriffsprotokoll sollte nur technische Daten enthalten.
  • Standort: Verarbeitung in der EU, bei TaxLayer in Frankfurt.

So sieht ein Aufruf aus

Ein Aufruf ist eine einfache HTTP-Anfrage: Sie senden die CSV-Datei per POST an /v1/convert/csv?format=xrechnung und setzen Ihren Schlüssel in den Header Authorization: Bearer tlk_…. Mit curl ist das ein Einzeiler, in Python oder Node.js sind es rund zehn Zeilen.

Die Antwort ist JSON: je Rechnung die fertige Datei (XML als Text oder ZUGFeRD-PDF als Base64) und eine Liste der Rechnungen, die nicht erzeugt werden konnten, mit Grund. Nur erfolgreich erzeugte Rechnungen zählen auf Ihr Kontingent. Alle Endpunkte, Parameter, Fehlercodes und Beispiele in Node.js und Python stehen in der API-Dokumentation.

Checkliste für den Start

  1. Prüfen Sie, ob Ihr System Rechnungen als CSV oder XML exportieren kann.
  2. Laden Sie die CSV-Vorlage aus der Dokumentation und bilden Sie Ihre Spalten darauf ab.
  3. Ergänzen Sie für die XRechnung die Leitweg-ID bzw. Käuferreferenz, Telefon, E-Mail, PLZ und Ort des Verkäufers sowie PLZ, Ort und eine E-Mail-Adresse oder USt-IdNr. des Käufers.
  4. Erstellen Sie im Konto unter „API (Beta)“ einen Schlüssel und testen Sie mit dem Status-Aufruf.
  5. Senden Sie eine erste Datei und werten Sie das Feld errors aus, bevor Sie auf den Nachtlauf umstellen.

---

Die E-Rechnung muss kein Projekt mit eigener Entwicklung sein. Mit der TaxLayer-API liefert Ihr System die Daten, und Sie erhalten geprüfte ZUGFeRD-, XRechnung- und PEPPOL-Dateien zurück. Die API ist in Enterprise und Enterprise Plus enthalten und derzeit als Beta verfügbar. Fragen an info@taxlayer.de.

Häufig gestellte Fragen

Was ist eine E-Rechnung-API?

Eine Programmierschnittstelle, an die Ihre Software Rechnungsdaten sendet und die fertige E-Rechnungen im gewünschten Format zurückgibt, zum Beispiel ZUGFeRD, XRechnung oder PEPPOL. Sie sparen sich den eigenen Generator, die Pflege der Formatversionen und den Betrieb eines Validators.

Welche Eingabe eignet sich am besten für die Automatisierung?

Strukturierte Daten, also CSV oder XML. Die Werte werden exakt übernommen, nichts muss geraten werden. Aus PDFs lassen sich Daten zwar mit KI auslesen, das ist aber nicht fehlerfrei und braucht einen menschlichen Prüfschritt.

Wie stelle ich sicher, dass die erzeugte E-Rechnung gültig ist?

Jede Datei sollte vor der Ausgabe mit dem offiziellen Regelwerk geprüft werden, also EN 16931 und für XRechnung zusätzlich die deutschen BR-DE-Regeln. Die TaxLayer-API prüft jede Datei mit den KoSIT-Prüfregeln und gibt nur Dateien aus, die bestanden haben.

Kann ich mit der API auch Rechnungen von Lieferanten prüfen?

Ja. Der Prüf-Endpunkt nimmt XML (UBL oder CII) und ZUGFeRD-PDFs an und liefert das Ergebnis mit Regelcodes, etwa BR-CO-15 für eine falsche Gesamtsumme. So fallen fehlerhafte Eingangsrechnungen vor der Buchung auf.

Was kostet die TaxLayer-API?

Sie ist in den Tarifen Enterprise und Enterprise Plus enthalten. Konvertierungen zählen auf dasselbe Monatskontingent wie die Web-App, Prüfungen haben ein eigenes Tageslimit.

Brauche ich Programmierkenntnisse?

Ein wenig. Ein Aufruf ist eine einfache HTTP-Anfrage, die sich mit curl, einem kurzen Skript in Python oder Node.js oder aus vielen ERP-Systemen heraus absetzen lässt. Die Dokumentation enthält Beispiele zum Kopieren.

PDF-Rechnungen jetzt konvertieren

Testen Sie TaxLayer kostenlos – 2 Konvertierungen pro Monat, keine Kreditkarte.

Jetzt starten