Generator-API: E-Rechnungen automatisiert erzeugen

Moderne REST-Schnittstelle für ZUGFeRD-PDF und XRechnung (CII) — direkt aus Ihren Systemdaten, standardkonform und skalierbar.

Was ist die Generator-API?

Mit der Generator-API binden Sie die Rechnungserzeugung des E-Rechnungs-Generators in ERP-, Buchhaltungs- oder eigene Anwendungen ein — ohne manuelles Ausfüllen des Browser-Formulars. Sie übergeben strukturierte Rechnungsdaten (JSON); der Dienst liefert ein konformes ZUGFeRD-PDF oder XRechnung-XML zurück, passend zu den im Generator genutzten Profilen und Regeln (u. a. XRechnung 3.0 / KoSIT-orientiert, Factur-X Basic für ZUGFeRD).

Die API folgt dem gleichen Muster wie unsere Validator-API: tokenbasierte Authentifizierung, klare OpenAPI-Dokumentation und eine Swagger-Oberfläche zum Ausprobieren.

Besonderheit: Ist der Demo-Modus aktiviert, können Sie die komplette Kette (Token → Erzeugen → Download) direkt in der Swagger UI durchspielen — mit öffentlich bereitgestellten Demo-Zugangsdaten und festen Demo-Limits (ohne eigenes API-Konto). Für den Produktivbetrieb erhalten Sie ein persönliches API-Konto (Client-ID und Secret) über den Shop bzw. den Administrator; Nutzung und Kontingente werden dort verwaltet.

Sie können die API 👉 sofort live testen – direkt über unsere Swagger-UI, ohne Registrierung oder Einrichtung.
(Der produktive Einsatz der API erfolgt kostenpflichtig über API-Zugänge)

Für Entscheider: Warum sich die API lohnt

• Weniger Medienbruch: Keine Doppelpflege zwischen Fakturierungssystem und Generator-Oberfläche — Daten fließen maschinell.
• Schnellere Prozesse: Rechnungen entstehen im gleichen Schritt wie Ihre Buchungs- oder Versandlogik — ideal für wiederkehrende oder hohe Volumina.
• Normkonforme Ausgabe: Einheitliche Erzeugung über die gleiche Engine wie im bewährten Web-Generator — weniger Konflikte bei Annahme durch Kunden oder Behörden.
• Skalierbar: Von Pilotprojekt bis Produktion — Kontingente (z. B. Monatslimits), Raten und Parallelität sind pro API-Konto steuerbar.
• Planbare Kosten: API-Nutzung läuft über API-Kontingente, nicht über Shop-Credits des Browser-Formulars — klare Trennung zwischen „manuell im Formular“ und „maschinell per API“.

Für Techies: Was Sie bekommen

• REST-API unter WordPress REST (/wp-json/erechnungs-generator/v1/), beschrieben in OpenAPI 3.0 (GET /openapi).
• Authentifizierung: POST /auth/token mit grant_type=client_credentials, Antwort enthält JWT als Bearer-Token.
• Erzeugung: POST /generate mit JSON-Body (u. a. Pflichtfeld e_invoice_type: zugferd oder xrechnung); weiter Felder wie im Web-Generator nach Normalizer (Seller, Kunde, Positionen, Zahlungsdaten, …).
• Liefermodell (zwei Schritte): Antwort von POST /generate liefert Metadaten inkl. download_token / download_url und Ablaufzeit; das eigentliche PDF oder XML holen Sie mit GET /download/{token} — ebenfalls mit Bearer; der Download-Token ist einmalig (kein Retry mit demselben Token bei Fehler — erneut über POST /generate anstoßen).
• Swagger UI zum Live-Test der Endpunkte inkl. Autorisierung mit Bearer.
• Health: GET /health für Monitoring.
• Demo (optional): GET /demo-status für Status, Limits und Demo-Zugangsdaten — analog zum Validator (Tageslimit, Cooldown, Secret-Rotation nach erfolgreichem Abruf).

So funktioniert die Integration

1. API-Zugang: Produktiv ein API-Client anlegen bzw. vom Betreiber zuweisen lassen (Client-ID, Secret, optional Verknüpfung mit WooCommerce-Benutzer für Kontingent-Anzeige unter Mein Konto → Generator-API, sofern freigeschaltet).
2. Token holen: POST …/auth/token (application/x-www-form-urlencoded) mit client_id und client_secret → access_token speichern (TTL beachten).
3. Rechnung erzeugen: POST …/generate mit Header Authorization: Bearer <access_token> und JSON-Body → JSON mit download_token, download_url, expires_at, filename, content_type auswerten.
4. Datei abrufen: GET …/download/{download_token} mit dem gleichen Bearer → Binärantwort (PDF oder XML). Anschließend in Ihrem System speichern, weiterleiten oder archivieren.

Alternativ können Sie alle Schritte 👉 direkt über die Swagger-UI nachvollziehen und testen – ohne eigene Implementierung.
Für den produktiven Einsatz stellen wir individuelle API-Zugänge mit passenden Limits und Abrechnung bereit.

Typische Einsatzszenarien

• ERP-/WaWi-Ausgang: Nach Auftrag/Lieferschein automatisch PDF-Rechnung oder XRechnung erzeugen und an E-Mail, Archiv oder Portal übergeben.
• Webshops / SaaS: Backend erzeugt konforme E-Rechnungen für B2B-Kunden ohne manuelle Nachbearbeitung.
• Portale: Nutzer oder Partner triggern Erzeugung über Ihre Middleware; der Generator liefert nur das normkonforme Dateiformat.
• Batch-/Nachtläufe: Geplante Jobs erzeugen periodische Rechnungen über dieselbe Schnittstelle.

Sicherheit und Betrieb

• Zugriff nur mit gültigem Bearer-Token auf geschützten Routen; Secrets werden serverseitig gehasht verwaltet.
• Limits pro Konto (z. B. Requests pro Minute, Parallelität, Monatskontingent für erfolgreiche Erzeugungen, optional IP-Allowlist) — Transparenz über Admin und ggf. Mein Konto.
• Kein Mailversand über die API — Ergebnis ausschließlich über das beschriebene Download-Modell; Versand organisieren Sie in Ihrer Infrastruktur.
• Demo ist bewusst begrenzt (Limits, Cooldown, Token-/Secret-Rotation), um Missbrauch zu begrenzen und Live-Tests zu ermöglichen.

Ergebnis: Technik, die im Alltag hilft

Die Generator-API ergänzt den klassischen Browser-Generator um einen maschinellen Kanal mit gleicher fachlicher Tiefe: Sie behalten die Kontrolle über Daten und Architektur, der Generator liefert stabile, prüfbare E-Rechnungsdateien für Ihre Prozesse.

👉 Swagger-UI öffnen und die API direkt live testen – ohne Anmeldung