REST API · ZUGFeRD 2.x · Factur-X · PDF/A-3
ZUGFeRD API
Erstellen Sie ZUGFeRD-Rechnungen aus JSON oder aus Ihrem vorhandenen Rechnungs-PDF, prüfen Sie eingehende ZUGFeRD-Dateien und lesen Sie die Rechnungsdaten als JSON aus – über eine REST API mit Hosting in Deutschland.
Kurz erklärt
rechnungsapi.de ist eine ZUGFeRD API der Finbc GmbH aus Essenheim. Sie erzeugt ZUGFeRD 2.x / Factur-X als PDF/A-3 mit eingebetteter EN-16931-XML aus JSON, aus einer XRechnung oder aus einem vorhandenen PDF, validiert ZUGFeRD-Dateien und extrahiert die Rechnungsdaten als JSON. Die Verarbeitung findet in Deutschland statt.
Auf einen Blick
- Format
- ZUGFeRD 2.x / Factur-X, PDF/A-3 mit eingebetteter XML
- Inhalt
- Strukturierte Rechnungsdaten nach EN 16931
- Eingaben
- JSON, JSON + eigenes PDF, XRechnung-XML oder PDF/Scan
- Prüfung
- PDF/A-3, Einbettung, EN 16931 und BR-DE-Regeln
- Ohne Code
- n8n, Make, Zapier, Dashboard und E-Mail-Workflow
- Hosting
- Deutschland, AVV nach Art. 28 DSGVO inklusive
Was die ZUGFeRD API kann
- ZUGFeRD aus JSON + PDF: eigenes Layout behalten, XML einbetten (
createZugferdFromJson). - ZUGFeRD aus Vorlage: Rechnungs-PDF samt XML aus JSON und Ihrer Vorlage erzeugen (
createInvoicePdfFromJson). - ZUGFeRD aus XRechnung: eine XRechnung als lesbares PDF/A-3 ausgeben (
createZugferdPdfFromXinvoice). - PDF in ZUGFeRD umwandeln: aus einem normalen PDF oder Scan in einem Aufruf (
createZugferdFromPdf), siehe PDF in ZUGFeRD umwandeln. - ZUGFeRD validieren und auslesen: eingehende Rechnungen prüfen (
validateZugferdPdf) und als JSON übernehmen.
ZUGFeRD oder XRechnung?
Beide Formate erfüllen die E-Rechnungspflicht im B2B. ZUGFeRD ist praktisch, wenn Empfänger die Rechnung auch ansehen wollen, XRechnung ist bei Behörden Standard. Den Unterschied erklärt der Beitrag XRechnung vs. ZUGFeRD. Für reine XML-Workflows gibt es die XRechnung API.
Beispiel: ZUGFeRD-PDF prüfen
curl -X POST https://api.rechnungsapi.de/api/v1/zugferd/validateZugferdPdf \
-H "Authorization: Bearer $RECHNUNGSAPI_TOKEN" \
-H "Content-Type: application/json" \
-d "{\"zugferdFile64\": \"$(base64 -i rechnung.pdf)\", \"comparePDF2XML\": true}"Alle Felder und Antworten in der API-Dokumentation und als OpenAPI-Spezifikation.
Häufige Fragen
Was ist eine ZUGFeRD API?
Eine ZUGFeRD API erzeugt, prüft oder liest ZUGFeRD-Rechnungen automatisch. Eine ZUGFeRD-Rechnung ist ein PDF/A-3 mit eingebetteter XML nach EN 16931: Menschen lesen das PDF, Software liest die XML.
Welche ZUGFeRD-Profile werden unterstützt?
Die API erzeugt ZUGFeRD 2.x / Factur-X mit einer XML nach EN 16931. Rechnungen nach EN 16931 gelten in Deutschland als E-Rechnung im Sinne des § 14 UStG. Die Profile MINIMUM und BASIC WL erfüllen die Anforderungen dagegen nicht.
Kann ich mein bestehendes Rechnungs-PDF behalten?
Ja. Sie schicken Ihr vorhandenes PDF zusammen mit den Rechnungsdaten als JSON, die API bettet die XML ein und liefert ein PDF/A-3 zurück. Liegen nur PDFs ohne strukturierte Daten vor, liest die API die Daten aus dem PDF aus.
Ist ZUGFeRD dasselbe wie Factur-X?
ZUGFeRD 2.x und Factur-X sind technisch identisch. ZUGFeRD ist der deutsche, Factur-X der französische Name desselben Formats.
Wann brauche ich XRechnung statt ZUGFeRD?
Öffentliche Auftraggeber verlangen meist eine XRechnung. Im B2B-Verkehr sind beide Formate zulässig. Die API erzeugt beides aus denselben Daten.
Wo werden die Daten verarbeitet?
Ausschließlich auf Servern in Deutschland (Open Telekom Cloud). Ein Auftragsverarbeitungsvertrag nach Art. 28 DSGVO ist inklusive.
Weiterlesen
Kostenlos testen
Registrieren, API-Token im Dashboard abrufen und die ersten Rechnungen im Playground erzeugen. Keine Kreditkarte, keine Vertragsbindung.