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.

Starten Sie mit RE-000001

Beispiel Studio Berlin berechnet der Musterfirma GmbH acht Stunden Softwareentwicklung: 776,00 € netto + 147,44 € Umsatzsteuer = 923,44 €.

Rebilix-Anfrageverlauf mit der Sandbox-Rechnung TEST-RE-000001 und Downloads für XML-Original, PDF-Ansicht und Prüfbericht
Echte Sandbox-Ansicht · dieselben fiktiven Daten wie im Postman- und .NET-Beispiel.

Eine Schnittstelle für den Dokumentenablauf

API v1 · Endpunkte relativ zu /api/v1/sandbox oder /api/v1/live
AufgabeEndpunktErgebnis
ErzeugenPOST /documents/generateXRechnung oder ZUGFeRD aus strukturierten Rechnungsdaten.
AuslesenPOST /documents/parseStrukturierte Rechnungsdaten und archiviertes Original.
PrüfenPOST /documents/validateTechnischer Status, Befunde und verfügbarer Prüfbericht.
HerunterladenGET /documents/{id}/original
GET /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.

Eingaben, Formate und Antworten im Detail

Mit der Beispielrechnung in der Sandbox starten

  1. 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. 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-Key je Vorgang.

  3. 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 integrieren

Kontrollierte 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 lesen

Berechtigungen 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 Wiederholungen

Fragen 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