REST API v1 · .NET SDK · SANDBOX
E-Rechnung API.
Für Ihr ERP.
Erzeugen, lesen und prüfen Sie XRechnung und ZUGFeRD aus Ihrer Anwendung. Rebilix liefert strukturierte Ergebnisse und bewahrt Originale und Prüfberichte im Arbeitsbereich auf.
Eine Schnittstelle für den Dokumentenablauf
| Aufgabe | Endpunkt | Ergebnis |
|---|---|---|
| Erzeugen | POST /documents/generate | XRechnung oder ZUGFeRD aus strukturierten Rechnungsdaten. |
| Auslesen | POST /documents/parse | Strukturierte Rechnungsdaten und archiviertes Original. |
| Prüfen | POST /documents/validate | Technischer Status, Befunde und verfügbarer Prüfbericht. |
| Herunterladen | GET /documents/{id}/originalGET /documents/{id}/report | Die gespeicherten Dateien für Ihr System. |
Ein erfolgreicher HTTP-Aufruf allein bestätigt keine gültige Rechnung. Werten Sie validationStatus, Befunde und verfügbare Artefakte aus.
Mit der Beispielrechnung in der Sandbox starten
1. Sandbox-Schlüssel anlegen
Öffnen Sie „Integration → Entwickler · API & Sandbox“ im Arbeitsbereich. Erstellen Sie einen Sandbox-Schlüssel mit den benötigten Rechten. Live- und Sandbox-Schlüssel bleiben getrennt.
2. Beispiel ausführen
Verwenden Sie die vorhandene Beispielrechnung als JSON. Der Schnellstart führt durch Postman, cURL und das .NET-Beispiel. Senden Sie den Schlüssel als Bearer-Token und einen stabilen
Idempotency-Keyje Vorgang.3. Original und Bericht öffnen
Wählen Sie im Anfrageverlauf „Sandbox“ und öffnen Sie das Dokument. Dort finden Sie die gespeicherten Ergebnisse. Im Beispiel erscheint die Rechnung als TEST-RE-000001; Sandbox-Ausgaben sind zum Testen bestimmt.
VOM TEST ZUR INTEGRATION
Verarbeitung nachvollziehbar einbauen
Aufträge und Webhooks
Übergeben Sie längere Vorgänge als Hintergrundauftrag. Signierte Benachrichtigungen melden Erfolg oder Fehler; Ihr System lädt das Ergebnis anschließend über die API. Der Leitfaden erklärt Signaturprüfung, Empfangsbestätigung und Wiederholungen.
Webhooks im ERP integrierenKontrollierte Konvertierung
Vor dem Wechsel zwischen XRechnung und ZUGFeRD prüfen Sie die Konvertierungsvorschau. Nicht vollständig übernehmbare Angaben blockieren die Ausgabe. Die Bestätigung bleibt ein ausdrücklicher Schritt.
Konvertierungsablauf lesenBerechtigungen und Kontingente
API-Schlüssel gehören zu einem Arbeitsbereich und einer Umgebung. Definierte Rechte, monatliche Kontingente und Rate Limits begrenzen die Verarbeitung. Der Anfrageverlauf hilft bei der Fehlersuche.
Fehlercodes, Limits und WiederholungenFragen zur Integration
Brauche ich .NET, um die API zu nutzen?
Nein. Die REST API lässt sich aus jeder Anwendung mit HTTPS-Unterstützung ansprechen. Das .NET SDK und die Postman-Beispiele erleichtern den Einstieg.
Werden Rechnungen automatisch ausgestellt oder versendet?
Die API-Dokumentverarbeitung ist von der Ausstellung und dem E-Mail-Versand in der App getrennt. Eine erfolgreiche Verarbeitung ist keine Versandfreigabe.
Kann ich die Prüfung auch ohne Integration nutzen?
Ja. Im Browser können Sie Dokumente hochladen, Befunde prüfen und Originale herunterladen.
E-Rechnung im Browser prüfen