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

Hintergrundaufträge

Verarbeitung dauerhaft annehmen, Fortschritt abfragen und Ergebnisse zuordnen.

Auf dieser Seite

Auftrag dauerhaft annehmen

Hintergrundendpunkte speichern Ihre Originaleingabe und antworten mit HTTP 202, einer Job-ID und einem Location-Header. Der ERP-Prozess kann fortfahren, während Rebilix verarbeitet.

POSTEingabeRechte
/jobs/generateGenerateRequest (JSON)Read + Generate
/jobs/parseXML / PDFRead + Process
/jobs/validateXML / PDFRead + Process
/jobs/conversion-reviewConversionReviewRequest (JSON)Alle drei

Verwenden Sie dieselben Eingaben wie bei den entsprechenden Dokumentendpunkten und einen stabilen Idempotency-Key. Dieselben Bytes geben denselben Auftrag zurück. Job-Idempotenz ist getrennt von synchroner Dokumentverarbeitung.

Verknüpfung im ERP speichern

Ordnen Sie die zurückgegebene jobId Ihrer internen Rechnungs-ID zu. So kann ein späterer Webhook die richtige ERP-Rechnung aktualisieren.

Status verfolgen

Lesen Sie GET /jobs/{id} mit Leserecht oder abonnieren Sie signierte Abschlussereignisse.

stateBedeutung
queuedDauerhaft angenommen, wartet auf Verarbeitung.
processingWorker verarbeitet den Auftrag.
retry_scheduledVorübergehender Fehler, nächste Wiederholung geplant.
succeededErgebnis gespeichert. resultStatus und referenziertes Dokument / Review prüfen.
failedVerarbeitung beendet. Fehlercode und canRetry auswerten.

resultStatus kann valid, invalid, not_checked, ready oder blocked sein. Ein technisch ungültiges Dokument oder eine gesperrte Konvertierungsvorschau kann das Ergebnis eines erfolgreich abgeschlossenen Auftrags sein.

Fehler und ausdrückliche Wiederholung

Vorübergehende Fehler werden nach 30 und 120 Sekunden erneut versucht, gegebenenfalls später gemäß Retry-After. Drei normale Versuche je Zyklus; permanente Eingabe-/Berechtigungsfehler werden sofort beendet. Eine manuelle Wiederholung ist nur bei canRetry: true und insgesamt weniger als zehn gestarteten Versuchen möglich.

HTTP · manueller Retry
POST /api/v1/sandbox/jobs/{id}/retry
Authorization: Bearer <API-Schlüssel>
Content-Type: application/json

{ "expectedAttempts": 3 }

Retry-Endpunkte benötigen alle drei Rechte. Sie verwenden den zuletzt gelesenen Versuchszähler statt eines Idempotency-Keys. Wiederholungen bei unverändertem Zähler während der Warteschlange/Verarbeitung ändern nichts. Nach einem weiteren Versuch liefert derselbe Zähler 409 retry_state_changed.

Der ursprüngliche API-Schlüssel muss weiterhin gültig sein. Geänderte Eingaben benötigen einen neuen Auftrag. Bereits gespeicherte Ergebnisse werden nach einem Prozessabbruch wieder zugeordnet; alte Originale bleiben erhalten.

Verlauf und Originaleingaben

GET /jobs?limit=50&before=… liefert eine Seite mit nextCursor. GET /jobs/{id}/input lädt die unveränderte Eingabe mit SHA-256 herunter. Im App-Menü Aufträge & Webhooks finden Sie Status, Ergebnisse und Zustellversuche.

Bis zu 50 offene Aufträge und eine aktive Hintergrundverarbeitung je Arbeitsbereich/Umgebung. Ein laufender App-Prozess ist erforderlich; pausierte Worker oder eine schlafende Hosting-Instanz verzögern die Verarbeitung.

Über alle Arbeitsbereiche und Umgebungen eines Inhabers sind insgesamt bis zu 100 offene Aufträge möglich. 429 job_queue_full

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.