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.
| POST | Eingabe | Rechte |
|---|---|---|
| /jobs/generate | GenerateRequest (JSON) | Read + Generate |
| /jobs/parse | XML / PDF | Read + Process |
| /jobs/validate | XML / PDF | Read + Process |
| /jobs/conversion-review | ConversionReviewRequest (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.
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.
| state | Bedeutung |
|---|---|
| queued | Dauerhaft angenommen, wartet auf Verarbeitung. |
| processing | Worker verarbeitet den Auftrag. |
| retry_scheduled | Vorübergehender Fehler, nächste Wiederholung geplant. |
| succeeded | Ergebnis gespeichert. resultStatus und referenziertes Dokument / Review prüfen. |
| failed | Verarbeitung 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.
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