Validierung automatisieren
Eigene Systeme können Rechnungen prüfen, ohne den Browser-Upload zu verwenden.
Business
Business-Funktion
E-Rechnungen serverseitig per API prüfen
Die Business API ist für Systeme gedacht, die XML-, ZUGFeRD- oder Factur-X-Dateien serverseitig einreichen und strukturierte JSON-Ergebnisse mit kurzlebigen PDF-Artefakten zurückbekommen wollen.
Warum die API nützlich ist
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 an den Validierungsendpunkt senden.
- 4JSON-Ergebnis auswerten 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, Fehlerkatalog und PDF-Artefakte.
- 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.
- Artefakt-Links sind kurzlebig und dienen der Ergebnisrückgabe.
- API-Zugriff ist nur mit Business-API-Schlüssel möglich.