Background jobs
Accept processing permanently, query progress and assign results.
On this page
Acceptance of the contract on a permanent basis
Background endpoints save your original input and respond with HTTP 202, a job ID and one Location-Header. The ERP process can continue while Rebilix processes.
| POST | Entry | Rights |
|---|---|---|
| /jobs/generate | GenerateRequest (JSON) | Read + Generates |
| /jobs/parse | XML/PDF | Read + Process |
| /jobs/validate | XML/PDF | Read + Process |
| /jobs/conversion-review | ConversionReviewRequest (JSON) | All three |
Use the same inputs as the corresponding document endpoints and a stable idempotency key, the same bytes return the same job, and Job idempotency is separate from synchronous document processing.
Arrange the returned jobId Your internal invoice ID, so a later webhook can update the correct ERP bill.
Track status
Read: GET /jobs/{id} with reading rights or subscribe to them Signed closing events.
| State | Significance |
|---|---|
| queued | Permanently accepted, waiting for processing. |
| Processing | Worker processes the order. |
| retry_scheduled | Temporary error, next repetition planned. |
| Successful | Result saved. resultStatus and referenced document / review check. |
| Failure to fail | Processing terminated. Evaluate error code and canRetry. |
resultStatus may be: valid, invalid, not_checked, ready or blocked A technically invalid document or a locked conversion preview can be the result of a successfully completed order.
Error and explicit repetition
Temporary errors are attempted again after 30 and 120 seconds, possibly later according to the retry-after. Three normal attempts per cycle; permanent input/authorization errors are terminated immediately. canRetry: true and a total of less than ten started attempts possible.
POST /api/v1/sandbox/jobs/{id}/retry
Authorization: Bearer <API-Schlüssel>
Content-Type: application/json
{ "expectedAttempts": 3 }Retry endpoints require all three rights, use the last-read trial counter instead of an idempotency key, repetitions of the unchanged counter during queue/processing do not change anything, and after another trial, the same counter delivers 409 retry_state_changed.
The original API key must still be valid. Changed inputs require a new job. Already stored results are reassigned after a process termination; old originals are retained.
History and original inputs
GET /jobs?limit=50&before=… Provides a page with nextCursor. GET /jobs/{id}/input Download the unchanged input with SHA-256. Jobs & webhooks Find status, results and delivery attempts.
Up to 50 open orders and active background processing per workspace/environment. An ongoing app process is required; paused workers or a sleeping hosting instance delay processing.
All workspaces and environments belonging to one owner can have up to 100 open jobs in total.
429 job_queue_full