PDF-zu-ZUGFeRDAPI
Die API, der ein PDF reicht.
PDF rein — ZUGFeRD 2.4 plus strukturierte Rechnungsdaten als JSON raus. Kein Vorverarbeiten, kein Mapping, kein XML-Bauen.
So funktioniert's
Ein POST-Request mit Bearer-Auth. PDF als Multipart. Mehrere Formate in einer Anfrage.
# Organisationen abrufen
curl https://vellonode.de/api/v1/organizations \
-H "Authorization: Bearer vk_live_abc123..."
# Rechnung konvertieren
curl -X POST "https://vellonode.de/api/v1/invoices/convert?organizationId=org_123" \
-H "Authorization: Bearer vk_live_abc123..." \
-F "[email protected]" \
-F "format=zugferd,json" \
-F "direction=incoming"Formate kommagetrennt: zugferd xrechnung json datev · Optional: direction=incoming oder outgoing
Jede konvertierte Rechnung wird zusätzlich in Ihrer Organisation abgelegt und erscheint unter „Rechnungen“ – die IDs stehen in der Antwort unter stored. Die ausgelieferte ZUGFeRD-PDF wird samt XML archiviert; die Download-URLs verfallen nach 24 Stunden. Mit persist=false wird nur konvertiert.
{
"id": "conv_a1b2c3d4e5f6...",
"data": {
"invoiceNumber": "RE-2026-0042",
"invoiceDate": "2026-05-15",
"currency": "EUR",
"seller": {
"name": "Muster GmbH",
"vatId": "DE123456789",
"address": {
"street": "Musterstraße 1",
"postalCode": "10115",
"city": "Berlin",
"country": "DE"
}
},
"buyer": {
"name": "Beispiel AG",
"vatId": "DE987654321"
},
"lines": [
{
"description": "Softwarelizenz Enterprise",
"quantity": 1,
"unit": "C62",
"unitPrice": 2500.00,
"vatRate": 19,
"netAmount": 2500.00
},
{
"description": "Technischer Support",
"quantity": 10,
"unit": "HUR",
"unitPrice": 150.00,
"vatRate": 19,
"netAmount": 1500.00
}
],
"taxBreakdown": [
{ "rate": 19, "taxableAmount": 4000.00, "taxAmount": 760.00 }
],
"totals": {
"netTotal": 4000.00,
"vatAmount": 760.00,
"grossTotal": 4760.00
}
},
"validation": {
"valid": true,
"profile": "EN16931",
"errors": []
},
"files": {
"zugferd": {
"url": "https://vellonode.de/api/v1/files/d4e5f6..."
},
"json": {
"url": "https://vellonode.de/api/v1/files/f6g7h8..."
}
},
"stored": {
"status": "saved",
"documentId": "clx1234567890",
"invoiceIds": ["clx0987654321"],
"archived": true
},
"usage": { "used": 42, "limit": 500 }
}Output-Formate
ZUGFeRD 2.4
PDF/A-3 mit eingebettetem XML. EN16931-konform.
XRechnung
Reines XML für den öffentlichen Sektor (Bund, Länder, Kommunen).
Strukturiertes JSON
Alle Rechnungsfelder als typisiertes JSON. Direkt weiterverarbeitbar.
DATEV-Export
Schnittstelle-online-kompatibel (v060). Für den Steuerberater.
Use Cases
DMS & Archiv-Software
Eingehende PDF-Rechnungen automatisch strukturiert ablegen. Rechnungsdaten direkt als JSON für Indexierung und Suche.
Anleitung lesenERP & Branchensoftware
E-Rechnungsfähigkeit nachrüsten ohne Eigenentwicklung. Kunden liefern PDFs, Ihre Software gibt ZUGFeRD oder XRechnung aus.
Anleitung lesenWorkflow-Automatisierung
PDFs aus E-Mail-Postfächern oder Scannern direkt konvertieren. Validiertes ZUGFeRD für nachgelagerte Systeme — ohne manuellen Schritt.
Anleitung lesenExcel → ZUGFeRD per Makro
Rechnungen in Excel erstellen, per VBA-Makro als PDF exportieren und über die API in ZUGFeRD konvertieren. Kein Systemwechsel nötig.
Anleitung lesenE-Mail-Postfach automatisieren
Eingangsrechnungen aus IMAP-Postfächern automatisch verarbeiten — mit n8n, Make oder einem Python-Script.
Anleitung lesenSteuerberater & Kanzleisoftware
Mandanten-Belege per Batch-Script verarbeiten und DATEV-kompatibel aufbereiten. Hunderte Belege über Nacht.
Anleitung lesenCompliance & Sicherheit
EN16931-validiert
Jede Ausgabe wird gegen den europäischen Standard validiert. Validierungsergebnis direkt in der Response.
Standards-Updates inklusive
ZUGFeRD- und XRechnung-Versionspflege übernehmen wir.
EU-Hosting
Server in Deutschland. Keine Datenübertragung in Drittländer.
DSGVO-konform
Verarbeitung auf Basis eines Auftragsverarbeitungsvertrags (AVV).
Keine Datenspeicherung
PDFs und Ergebnisse werden nach der Verarbeitung gelöscht.
Kein KI-Training
Kundendaten werden nicht für das Training von KI-Modellen verwendet.
Häufige Fragen
Wie bekomme ich Zugang?
Kostenloses Konto erstellen, API-Key unter Einstellungen → API generieren, loslegen. Keys beginnen mit vk_live_ und werden als Bearer-Token übergeben.
Was kostet die API?
Die API nutzt das bestehende Kontingent Ihres Plans. Volumenbasierte Pakete ab dem Starter-Plan. Details auf der Preisseite.
Gibt es Self-Hosting?
Nein. Die API läuft als SaaS mit EU-Hosting (Deutschland).
Welche Eingaben werden unterstützt?
PDF-Rechnungen (auch Scans), Excel-Dateien (.xlsx) und Word-Dokumente (.docx). Maximal 10 MB pro Datei. Office-Dateien werden serverseitig zu PDF konvertiert. Die KI erkennt Rechnungsdaten unabhängig vom Layout.
Gibt es Ratenlimits?
30 Requests pro Minute pro API-Key. Enterprise-Kunden erhalten dedizierte Kapazitäten.
Gibt es eine OpenAPI-Spezifikation?
Ja. Die vollständige OpenAPI 3.1 Spec ist unter /api/v1/openapi abrufbar.
Welche weiteren Endpoints gibt es?
GET /api/v1/organizations listet verfügbare Organisationen. GET /api/v1/me gibt das Benutzerprofil inkl. zuletzt genutztem Login-Provider zurück. GET /api/v1/files/{token} liefert konvertierte Dateien (24 Stunden gültig).
Kann ich den Login-Provider vorwählen?
Ja. Über /oauth/authorize?idp_hint=google (oder microsoft, vellonode) wird der Login direkt zum gewählten Provider weitergeleitet. Nützlich für Add-ins und integrierte Anwendungen.
Jetzt kostenlos starten
Konto erstellen, API-Key im Dashboard generieren, loslegen.
- PDF → ZUGFeRD 2.4 / XRechnung
- Strukturiertes JSON
- DATEV-Export
- EN16931-validiert
Mit der Registrierung akzeptieren Sie unsere AGB und Datenschutzerklärung.