E-Rechnung für Softwarehersteller: XRechnung und ZUGFeRD per API
Softwarehersteller binden E-Rechnung über eine REST-API ein, statt XRechnung- und ZUGFeRD-Erzeugung, Validierung und PDF/A-3 selbst zu pflegen. Endpunkte: Rechnung anlegen (PDF, XML oder JSON), Daten korrigieren, validieren, konvertieren, Dateien abrufen; Webhooks melden Zustandswechsel. Alle Beträge sind Dezimal-Strings, Fehler folgen RFC 9457.
Fristen: Ausstellungspflicht für E-Rechnungen ab 01.01.2027 bei Vorjahresumsatz über 800.000 €, ab 01.01.2028 für alle inländischen B2B-Umsätze. Empfangspflicht seit 01.01.2025. Stand 06.09.2026.
Was die API übernimmt
- Formaterkennung: UBL, CII, ZUGFeRD-Profile, PDF mit oder ohne Textebene.
- Extraktion: PDF → Rechnungsmodell (regelbasiert, OCR, optional KI) oder direkt JSON nach EN 16931 einliefern.
- Validierung: interne deterministische Regeln plus KoSIT-Validator und Mustangproject; Bericht mit Codes, Regeln und Feldern.
- Erzeugung: XRechnung UBL/CII, ZUGFeRD (BASIC, EN 16931, EXTENDED, XRECHNUNG) inklusive PDF/A-3-Konvertierung und Round-Trip-Prüfung.
- Zustellung: Download, Webhooks (HMAC-signiert, Wiederholung mit Backoff), E-Mail-Versand in Vorbereitung.
Technische Eckdaten
| Thema | Umsetzung |
|---|---|
| Authentifizierung | API-Keys mit Scopes (invoices:read, invoices:write, invoices:convert, webhooks:manage), Live- und Test-Präfix, IP-Allowlist optional |
| Idempotenz | Idempotency-Key bei Uploads; If-Match/ETag bei Korrekturen |
| Fehler | application/problem+json (RFC 9457) mit Code, Feld und deutschem Klartext |
| Beträge | Strings mit Dezimalpunkt, nie Fließkommazahlen |
| Mandantentrennung | Zugriff auf fremde Daten liefert 404, nie 403 |
| Rate Limits | Header RateLimit-Limit, RateLimit-Remaining, Retry-After |
| Doku | OpenAPI 3 unter /api/openapi.json, interaktive Doku |
Partnerprogramm
Für Hersteller von Branchen- und ERP-Software gibt es Volumenpreise, White-Label-Optionen und einen technischen Ansprechpartner. Die Prüfwerkzeuge werden von uns aktualisiert, wenn KoSIT oder FeRD neue Versionen veröffentlichen; Versionswechsel kündigen wir mindestens 4 Wochen vorher an.
Häufige Fragen
- Ja, Test-API-Keys (Präfix erb_test_) arbeiten gegen dieselbe API ohne Abrechnung.
- Ja. Wenn Ihre Software die Rechnungsdaten strukturiert hat, liefern Sie das Modell nach EN 16931 direkt als JSON und erhalten validierte XRechnung/ZUGFeRD zurück.
- XML-Eingang: wenige hundert Millisekunden. PDF-Extraktion: Sekunden. Externe Validierung mit KoSIT: typischerweise unter 2 Sekunden. Verarbeitung ist asynchron mit Job-Status und Webhook.
Gibt es eine Sandbox?
Kann ich JSON statt PDF einliefern?
Wie schnell ist eine Konvertierung?
Quellen
- RFC 9457 Problem Details for HTTP APIs
- EN 16931-1, Standard XRechnung, ZUGFeRD/Factur-X Spezifikation
Weiterlesen
Ihre Software bleibt. Ihre Rechnungen werden E-Rechnungen.
Kostenloses Konto mit 5 Rechnungen im Monat, Validator und Viewer unbegrenzt. Upgrade erst, wenn Sie mehr brauchen.
Kein Zahlungsmittel nötig. 5 Rechnungen im Monat kostenlos.