Enterprise · API · Beta
E-Rechnungen per API.
Automatisch erzeugt, offiziell geprüft.
Ihre Software liefert die Rechnungsdaten als CSV oder XML, TaxLayer gibt fertige ZUGFeRD-, XRechnung- oder PEPPOL-Dateien zurück. Jede Datei hat vorher die Prüfung mit dem KoSIT-Regelwerk bestanden. Ohne eigenen E-Rechnungs-Code, ohne Validator-Betrieb.
So funktioniert es
Was die API kann
CSV umwandeln
Eine CSV-Datei im TaxLayer-Format mit einer oder vielen Rechnungen wird zu ZUGFeRD-PDF, XRechnung oder PEPPOL. Ideal für ERP, Warenwirtschaft und eigene Software mit Tabellenexport.
XML umwandeln
Vorhandene E-Rechnungen in UBL oder CII werden in ein anderes Format übertragen, zum Beispiel XRechnung zu ZUGFeRD-PDF oder ZUGFeRD zu PEPPOL. Regelbasiert, Werte werden exakt übernommen.
Rechnungen prüfen
XML oder ZUGFeRD-PDF senden, Prüfergebnis mit Regelcodes zurückbekommen. Geeignet für eingehende Lieferantenrechnungen und für Ausgaben der eigenen Software.
Status abfragen
Tarif, verbrauchte und freie Konvertierungen und die Limits auf einen Blick. Gut als Verbindungstest und vor großen Stapeln.
So einfach sieht ein Aufruf aus
curl -X POST "https://europe-west3-taxlayer-4d586.cloudfunctions.net/api/v1/convert/csv?format=xrechnung" \
-H "Authorization: Bearer tlk_IhrSchluessel" \
-H "Content-Type: text/csv" \
--data-binary @rechnungen.csvEinsatz
Typische Einsätze
ERP ohne E-Rechnungsmodul
Das System exportiert Rechnungen als CSV. Ein kleines Skript schickt die Datei nachts an die API und legt die E-Rechnungen im Ausgangsordner ab.
Eigene Rechnungssoftware
Sie bauen keinen eigenen ZUGFeRD- und XRechnung-Generator und keinen Validator. Ihre Software ruft die API auf und erhält geprüfte Dateien.
Öffentliche Auftraggeber
Aus Ihren ZUGFeRD-Rechnungen werden XRechnungen für Behörden, sofern die Quelle bereits Leitweg-ID sowie Telefon und E-Mail des Verkäufers enthält. Fehlt etwas, nennt die API die fehlenden Angaben, statt eine Datei auszugeben.
Eingangsrechnungen prüfen
Bevor eine Lieferantenrechnung in die Buchhaltung geht, prüft die API sie gegen EN 16931 und meldet konkrete Fehler mit Regelcode.
Sicherheit
Sicher für Ihren Betrieb
- Fail-closed: Ist der Prüfdienst kurz nicht erreichbar, gibt die API keine ungeprüfte Datei aus, sondern bittet um Wiederholung. Berechnet wird dann nichts.
- Alle Prüfungen laufen automatisiert, TaxLayer prüft Rechnungen nicht manuell. Ein gültiges Ergebnis bestätigt die Form, nicht den Inhalt; den prüfen Sie wie bisher selbst.
- API-Schlüssel speichern wir nur als Hash. Sie sehen ihn einmal und widerrufen ihn mit einem Klick, er ist dann sofort ungültig.
- Keine Speicherung der Rechnungsdateien; das Zugriffsprotokoll enthält nur technische Daten.
- Kontingent, Tarif und Teamzugehörigkeit prüfen wir bei jeder Anfrage. Ein Stapel wird nur gestartet, wenn das Kontingent für alle Rechnungen reicht.
Und PDF?
PDF-Rechnungen wandeln Sie weiterhin in der Web-App um, auch im Stapel. Dort liest unsere KI die Daten aus und Sie prüfen sie vor der Ausgabe. Eine PDF-API ohne diesen Prüfschritt bieten wir bewusst nicht an: Rechtsverbindliche Rechnungen sollen nicht auf ungeprüften Daten beruhen.
FAQ
Häufige Fragen
Welche Tarife enthalten die API?
Enterprise und Enterprise Plus. Konvertierungen über die API zählen auf dasselbe Kontingent wie die Web-App (800 bzw. 5.000 im Monat). Prüfungen haben ein eigenes Tageslimit und kosten keine Konvertierung.
Was bedeutet Beta?
Die API ist neu und voll nutzbar. Die Pfade unter /v1 bleiben stabil, neue Felder können hinzukommen. Änderungen kündigen wir per E-Mail an.
Welche Formate nimmt die API an?
CSV im TaxLayer-Format sowie XML als UBL 2.1 (XRechnung, PEPPOL BIS) oder UN/CEFACT CII (ZUGFeRD, Factur-X). Zum Prüfen zusätzlich ZUGFeRD- und Factur-X-PDFs.
Wird beim Umwandeln KI eingesetzt?
Nein. CSV und XML werden regelbasiert gelesen, die Werte exakt übernommen. KI setzen wir nur in der Web-App beim Auslesen von PDFs ein, dort mit Prüfschritt.
Was passiert, wenn eine Rechnung fehlerhaft ist?
Sie erhalten keine Datei, sondern eine verständliche Fehlermeldung mit Regelcode, zum Beispiel die fehlende Telefonnummer des Verkäufers für die XRechnung (BR-DE-6). Fehlerhafte Rechnungen zählen nicht als Konvertierung.
Wo finde ich die Dokumentation?
Unter taxlayer.de/api-doku, mit Beschreibung jedes Endpunkts, Beispielen in curl, Node.js und Python und allen Fehlercodes.
Bereit für die Automatisierung?
Schlüssel im Konto erstellen, Dokumentation lesen, erste Rechnung senden.