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.

POSTRequest
terminal
# 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.

200Response
application/json
{
  "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 lesen

ERP & Branchensoftware

E-Rechnungsfähigkeit nachrüsten ohne Eigenentwicklung. Kunden liefern PDFs, Ihre Software gibt ZUGFeRD oder XRechnung aus.

Anleitung lesen

Workflow-Automatisierung

PDFs aus E-Mail-Postfächern oder Scannern direkt konvertieren. Validiertes ZUGFeRD für nachgelagerte Systeme — ohne manuellen Schritt.

Anleitung lesen

Excel → 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 lesen

E-Mail-Postfach automatisieren

Eingangsrechnungen aus IMAP-Postfächern automatisch verarbeiten — mit n8n, Make oder einem Python-Script.

Anleitung lesen

Steuerberater & Kanzleisoftware

Mandanten-Belege per Batch-Script verarbeiten und DATEV-kompatibel aufbereiten. Hunderte Belege über Nacht.

Anleitung lesen

Compliance & 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
oder anmelden mit

Mit der Registrierung akzeptieren Sie unsere AGB und Datenschutzerklärung.