.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.
$env:REBILIX_API_URL = "https://app.rebilix.de"
$requestId = [guid]::NewGuid().ToString()
dotnet run --project examples/Rebilix.Sdk.Example -- examples/invoice.json $requestIdDer 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.
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
| Aufgabe | SDK-Methoden |
|---|---|
| Dokumente | GenerateAsync, ParseAsync, ValidateAsync, GetDocumentAsync, DownloadAsync |
| Konvertierung | ReviewConversionAsync, GetConversionReviewAsync, DownloadConversionReviewAsync, ConfirmConversionAsync |
| Hintergrund | QueueGenerationAsync, QueueParsingAsync, QueueValidationAsync, QueueConversionReviewAsync, GetJobAsync, GetJobsAsync, DownloadJobInputAsync, RetryJobAsync |
| Webhooks | RebilixWebhook.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-AnleitungDas 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
- ZIP entpacken. .NET 10 SDK und SQL Server bereitstellen; unter Windows ist LocalDB voreingestellt.
- In das Verzeichnis
examples/Rebilix.WebhookReceiverwechseln. Eine eigene Beispieldatenbank verwenden. - Workspace-ID, Umgebung, Signaturgeheimnis und API-Schlüssel mit Leserecht konfigurieren. Für lokale Geheimnisse User Secrets verwenden; produktiv Ihren Secret Store.
- Datenbank explizit initialisieren und Receiver starten. Die folgenden Befehle gelten für PowerShell.
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:5305Die 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.
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.