Developers
OpenAPI ↗
Zur App
Dokumentation / Integrationen
API v1 · Integrationen

.NET SDK & Beispiele

Mit dem .NET-Client starten und einen vollständigen Webhook-Receiver ausführen.

Auf dieser Seite

Erste Rechnung mit .NET

Konsolenbeispiel mit SDK, Contracts und invoice.json herunterladen. Entpacken Sie das ZIP, installieren Sie das .NET 10 SDK und setzen Sie REBILIX_API_KEY lokal auf einen Sandbox-Schlüssel mit den Rechten Erzeugen und Lesen.

PowerShell · im entpackten Verzeichnis
$env:REBILIX_API_URL = "https://app.rebilix.de"
$requestId = [guid]::NewGuid().ToString()
dotnet run --project examples/Rebilix.Sdk.Example -- examples/invoice.json $requestId

Der Client erzeugt TEST-RE-000001, zeigt die Dokument-ID und lädt die verfügbaren Artefakte unter rebilix-sandbox-output herunter. Die Dateinamen enthalten dieselbe ID sowie original oder report. Für einen erneuten Aufruf mit identischen Daten behalten Sie $requestId bei.

Dieselben Dateien in Rebilix öffnen →

Client einrichten

Rebilix.Sdk und Rebilix.Api.Contracts 0.3.0 unterstützen .NET 8+. Das Receiver-Beispiel verwendet ASP.NET Core 10 und SQL Server.

Die SDK-Quellen sind im Download enthalten und werden per Projektreferenz gebaut. Eine Veröffentlichung auf NuGet wird nicht vorausgesetzt. Bereits lokal erzeugte 0.3.0-Pakete können alternativ über Ihren eigenen Paketfeed eingebunden werden.

C# · Client
using Rebilix.Sdk;

using var handler = new HttpClientHandler { AllowAutoRedirect = false };
using var http = new HttpClient(handler) {
    Timeout = TimeSpan.FromMinutes(5)
};
var client = new RebilixClient(http, new Uri(baseUrl), apiKey);
var job = await client.QueueGenerationAsync(invoice, stableRequestId, ct);
// job.Id bei Ihrem ERP-Datensatz speichern.
// Nach Webhook / Polling aktuellen Job und Ergebnis abrufen.

HttpClient wiederverwenden, Redirects deaktivieren und Schlüssel serverseitig aus einem Secret Store beziehen. Der Client besitzt HttpClient nicht und führt keine stillen Wiederholungen aus. Bei Downloadfehlern die unvollständige Zieldatei verwerfen.

Methoden nach Aufgabe

AufgabeSDK-Methoden
DokumenteGenerateAsync, ParseAsync, ValidateAsync, GetDocumentAsync, DownloadAsync
KonvertierungReviewConversionAsync, GetConversionReviewAsync, DownloadConversionReviewAsync, ConfirmConversionAsync
HintergrundQueueGenerationAsync, QueueParsingAsync, QueueValidationAsync, QueueConversionReviewAsync, GetJobAsync, GetJobsAsync, DownloadJobInputAsync, RetryJobAsync
WebhooksRebilixWebhook.Verify, GetWebhookDeliveriesAsync, GetWebhookDeliveryAsync, RetryWebhookDeliveryAsync

RebilixApiException enthält StatusCode, Problem, RequestId und RetryAfter. Konvertierungen werden erst nach ausdrücklicher Durchsicht bestätigt.

Vollständigen Receiver herunterladen

ASP.NET Core Webhook Receiver ↓Quellcode · SQL Server Inbox · SDK & Contracts · deutsche Schritt-für-Schritt-Anleitung

Das Beispiel verifiziert Originalbytes und Signatur, prüft Arbeitsbereich/Umgebung und speichert das Ereignis vor HTTP 200. Ein Worker liest den aktuellen Rebilix-Jobstatus und aktualisiert eine lokale Statusprojektion zusammen mit der Verarbeitet-Markierung in einer Transaktion.

Ein eindeutiger Ereignisschlüssel verhindert Duplikate. SQL-Leases erlauben Wiederaufnahme nach Neustart. Fünf lokale Verarbeitungsversuche; fehlgeschlagene Inbox-Einträge bleiben zur Diagnose erhalten. Es werden keine Rechnungen ausgestellt, bestätigt, bezahlt oder per E-Mail versendet.

Beispiel ausführen

  1. ZIP entpacken. .NET 10 SDK und SQL Server bereitstellen; unter Windows ist LocalDB voreingestellt.
  2. In das Verzeichnis examples/Rebilix.WebhookReceiver wechseln. Eine eigene Beispieldatenbank verwenden.
  3. Workspace-ID, Umgebung, Signaturgeheimnis und API-Schlüssel mit Leserecht konfigurieren. Für lokale Geheimnisse User Secrets verwenden; produktiv Ihren Secret Store.
  4. Datenbank explizit initialisieren und Receiver starten. Die folgenden Befehle gelten für PowerShell.
PowerShell · Einrichtung
cd examples/Rebilix.WebhookReceiver
$env:ASPNETCORE_ENVIRONMENT = "Development"
dotnet user-secrets set "Receiver:WorkspaceId" "<Workspace-UUID>"
dotnet user-secrets set "Receiver:SigningSecret" "<whsec_...>"
dotnet user-secrets set "Receiver:ApiKey" "<rbx_test_...>"
dotnet run -- --initialize-db
dotnet run -- --urls http://localhost:5305

Die Platzhalter müssen durch Ihre Werte ersetzt werden. User Secrets sind ein lokaler Entwicklungsspeicher, kein verschlüsselter Produktions-Secret-Store. Bei Bedarf ConnectionStrings:Receiver und Receiver:ApiOrigin überschreiben.

Lokaler Port ist nicht die Webhook-URL.

Registrieren Sie einen öffentlichen HTTPS-Host auf Port 443, der an den Receiver weiterleitet. http://localhost:5305 dient nur zum lokalen Start; Rebilix ruft keine privaten Netzwerkziele auf.

Nach einem Sandbox-Auftrag zeigen die SQL-Tabellen Inbox und Jobs Empfang und Verarbeitung. Die README enthält Diagnoseabfragen, Wiederaufnahme und Hinweise zur Einbindung in eine echte ERP-Transaktion.

Verbindung wird wiederhergestellt …

Neuer Verbindungsversuch in Sekunden.

Die Verbindung konnte nicht wiederhergestellt werden.
Bitte versuchen Sie es erneut oder laden Sie die Seite neu.

Ihre Sitzung wurde pausiert.

Die Sitzung konnte nicht fortgesetzt werden.
Bitte versuchen Sie es erneut oder laden Sie die Seite neu.