Developers
OpenAPI ↗
Go to the app
Documentation / API v1
API v1 · API v1

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.

POSTEntryRights
/jobs/generateGenerateRequest (JSON)Read + Generates
/jobs/parseXML/PDFRead + Process
/jobs/validateXML/PDFRead + Process
/jobs/conversion-reviewConversionReviewRequest (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.

Save linking in ERP

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.

StateSignificance
queuedPermanently accepted, waiting for processing.
ProcessingWorker processes the order.
retry_scheduledTemporary error, next repetition planned.
SuccessfulResult saved. resultStatus and referenced document / review check.
Failure to failProcessing 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.

HTTP · manueller Retry
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

The connection is restored...

New connection attempt in seconds.

The connection could not be restored.
Please try again or reload the page.

Your meeting was paused.

The sitting could not be continued.
Please try again or reload the page.