Validierung automatisieren
Eigene Systeme können Rechnungen prüfen, ohne den Browser-Upload zu verwenden.
Business
Business-Funktion
E-Rechnungen serverseitig prüfen und aus JSON erstellen
Die Business API ist für Systeme gedacht, die XML-, ZUGFeRD- oder Factur-X-Dateien serverseitig prüfen oder einfache UBL/XRechnung-XML aus strukturiertem JSON erzeugen wollen. Ergebnisse kommen als JSON mit kurzlebigen PDF-Artefakten zurück.
Warum die API nützlich ist
UBL aus JSON erzeugen
Der Generate-Endpunkt rendert einen strukturierten Rechnungsentwurf als UBL-XML und validiert das Ergebnis sofort.
Maschinenlesbare Ergebnisse
JSON-Antworten liefern Status, Fehler, Warnungen, Rechnungszusammenfassung und Artefakt-Links.
Schlüssel kontrollieren
Business-Konten verwalten API-Schlüssel im Konto und können Zugänge widerrufen.
So funktioniert es
- 1API-Dokumentation öffentlich lesen und Endpunkte prüfen.
- 2Business aktivieren und im Konto einen API-Schlüssel erstellen.
- 3Dateien per Multipart-Request validieren oder Rechnungsentwürfe als JSON an den Generate-Endpunkt senden.
- 4JSON-Ergebnis, generierte XML und kurzlebige PDF-Links bei Bedarf abrufen.
- 5API-Schlüssel regelmäßig prüfen und nicht mehr benötigte Schlüssel widerrufen.
Endpunkte und Limits
- Die API unterstützt Einzelvalidierung, Batch-Validierung, UBL-Erstellung aus JSON, Schema-Abruf, Fehlerkatalog und PDF-Artefakte.
- Die Erstellung ist in der ersten Version bewusst auf UBL begrenzt; ZUGFeRD-/Factur-X-PDF/A-3-Erzeugung ist nicht live.
- Business API Batch verarbeitet aktuell bis zu 10 Dateien pro Request.
- Einzelne Uploads bleiben technisch auf 10 MB pro Datei begrenzt.
Bewusste Grenzen
- Die API ist kein Archiv, keine ERP-Implementierung und keine dauerhafte Dokumentenablage.
- Die API verwaltet keine Rechnungsnummern, Stammdaten, Entwürfe oder Freigabeprozesse.
- Artefakt-Links sind kurzlebig und dienen der Ergebnisrückgabe.
- API-Zugriff ist nur mit Business-API-Schlüssel möglich.