E-Rechnungs-API: erstellen, prüfen, umwandeln
XRechnung, ZUGFeRD und Factur-X mit je einem HTTP-Aufruf, für Shops, ERP-Systeme, Automatisierungen und KI-Agenten, die keine Java- oder Node-Bibliothek betreiben können.
| Erstellen | JSON hinein (Verkäufer, Käufer, Positionen, Steuersatz, IBAN), XRechnung-XML oder ein ZUGFeRD-/Factur-X-PDF heraus. Positionssummen, Umsatzsteueraufschlüsselung und Gesamtbeträge werden berechnet und vorab geprüft. |
|---|---|
| Prüfen | Jede verletzte Geschäftsregel mit ihrer Nummer (BR-DE-15, BR-CO-15), den Zahlen aus Ihrer Datei und der Lösung. 103 Regeln. |
| In JSON umwandeln | Eine eingehende E-Rechnung (XML oder das PDF mit eingebetteter XML) als JSON: Parteien, Positionen, Umsatzsteuer, Summen, Bankverbindung. Exakte Werte, ohne KI. |
Eine XRechnung aus JSON erstellen
curl -X POST "https://tools.funwords.eu/einvoice/create" \
-H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
-d '{
"format": "xrechnung",
"invoice": {
"number": "RE-2026-0042",
"issueDate": "2026-11-14",
"dueDate": "2026-12-14",
"buyerReference": "04011000-12345-06",
"seller": {
"name": "Muster Software GmbH",
"vatId": "DE123456789",
"street": "Hauptstrasse 1",
"postCode": "10115",
"city": "Berlin",
"country": "DE",
"contactName": "Erika Muster",
"phone": "+49 30 1234567",
"email": "rechnung@muster-software.example"
},
"buyer": {
"name": "Kunde AG",
"street": "Marktplatz 5",
"postCode": "20095",
"city": "Hamburg",
"country": "DE",
"email": "einkauf@kunde.example"
},
"lines": [
{
"name": "Beratung",
"quantity": 8,
"unit": "HUR",
"unitPrice": 120,
"vatRate": 19
},
{
"name": "Softwarelizenz",
"quantity": 1,
"unitPrice": 49.9,
"vatRate": 19
}
],
"payment": {
"iban": "DE02120300000000202051",
"terms": "Zahlbar innerhalb von 30 Tagen"
}
}
}'
format: xrechnung (CII), xrechnung-ubl, zugferd-pdf (eine lesbare PDF/A-3-Rechnung mit eingebetteter XML, zurückgegeben als pdfBase64), zugferd (nur die factur-x.xml) oder ubl. Daten, die gegen eine Regel verstoßen, werden mit den Regelnummern abgelehnt und nicht berechnet. buyerReference ist die Käuferreferenz, bei öffentlichen Auftraggebern die Leitweg-ID.
Eine Datei prüfen oder umwandeln
curl -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/xml" \
--data-binary @rechnung.xml "https://tools.funwords.eu/einvoice/validate"
curl -H "Authorization: Bearer $API_KEY" \
"https://tools.funwords.eu/einvoice/to-json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fitplr-kosit%2Fxrechnung-testsuite%2Fmaster%2Fsrc%2Ftest%2Fbusiness-cases%2Fstandard%2F01.01a-INVOICE_uncefact.xml"
Auch Papier- und PDF-Rechnungen lesen
Eine Rechnung, die nur als PDF oder Scan vorliegt, enthält keine XML zum Umwandeln. Die Rechnungsdaten-Extraktion (englische Seite) liest ihre Felder als JSON, und diese Felder können unverändert an „Erstellen“ übergeben werden.
Preise
Jeder Aufruf zählt als ein gewöhnlicher Aufruf Ihres Schlüssels. Schlüssel und Monatspläne: Preise (englisch). Ein fehlgeschlagener oder abgelehnter Aufruf wird nie berechnet.
Was die API nicht tut
- Das ZUGFeRD-/Factur-X-PDF hat ein schlichtes, festes Layout: kein Logo, kein eigenes Design, und keine Einbettung der XML in Ihr eigenes PDF.
- Kein Versand: keine Übermittlung an Peppol, an eine französische Plattform oder an ein Rechnungseingangsportal der Verwaltung.
- Nicht der offizielle KoSIT-Validator und keine Steuerberatung.
- Nachlässe und Zuschläge, Anhänge, Karten- und Lastschriftzahlungen werden nicht geschrieben, und ihre Regeln werden nicht geprüft.
Fragen
Welche Formate werden unterstützt?
XRechnung 3.0 in beiden Syntaxen (UN/CEFACT CII und UBL), die XML von ZUGFeRD 2.x und Factur-X im Profil EN 16931 sowie andere Rechnungen nach EN 16931 in UBL oder CII, etwa Peppol BIS Billing 3.0. Ein ZUGFeRD- oder Factur-X-PDF können Sie unverändert senden: Die eingebettete XML wird gelesen.
Wird auch das ZUGFeRD-PDF erzeugt?
Ja, mit dem Format zugferd-pdf: eine lesbare A4-Rechnung mit eingebetteter factur-x.xml, aufgebaut nach PDF/A-3b mit eingebetteten Schriften. Das Layout ist schlicht und fest vorgegeben (kein Logo, kein eigenes Design), und die Datei wurde nicht von einem PDF/A-Validator zertifiziert. Eine XML in ein von Ihnen erzeugtes PDF einzubetten ist nicht möglich.
Ist das der offizielle Validator?
Nein. Geprüft wird eine Teilmenge der Geschäftsregeln von EN 16931 und XRechnung 3.0, aufgelistet auf der Regelseite, und jeder Verstoß wird erklärt. Eine Datei, die hier besteht, kann beim offiziellen KoSIT-Validator trotzdem durchfallen, denn dieser prüft zusätzlich das XML-Schema und alle Codelisten.
Ab wann müssen Unternehmen in Deutschland E-Rechnungen ausstellen?
Nach dem Rechtsstand vom 14. November 2026: Unternehmen mit mehr als 800.000 Euro Vorjahresumsatz ab dem 1. Januar 2027, alle Unternehmen ab dem 1. Januar 2028, jeweils für Rechnungen zwischen inländischen Unternehmen. Der Empfang von E-Rechnungen ist seit dem 1. Januar 2025 Pflicht. Eine Verschiebung wurde vorgeschlagen; klären Sie den aktuellen Stand mit Ihrer Steuerberatung.
Werden meine Rechnungen gespeichert?
Nein. Eine Datei wird nur für die eine Anfrage im Arbeitsspeicher gelesen und weder gespeichert noch protokolliert.
In welcher Sprache antwortet die API?
Die Feldnamen und Meldungen der API sind englisch; die Regelnummern (BR-DE-15, BR-CO-15 …) sind dieselben wie in jedem anderen Validator. Jede Regel ist auf diesen Seiten auf Deutsch erklärt.