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

Conversion

Change formats with immutable previews and explicit confirmation.

On this page
Prepare → check → expressly confirm

Rebilix does not block fully mapped conversions, and a preview that is provided will never automatically become the confirmed output.

Archiving the original

Use them POST /documents/parse or /documents/validateThe returned document ID becomes the starting point of the conversion.

Check conversion preview

POST /documents/conversion-review requires all three rights and an Idempotency key. Optionally, missing routing and contact details can be provided via supplements It can be supplemented; existing values cannot be overwritten.

JSON · Prüfung vorbereiten
{
  "sourceDocumentId": "11111111-1111-4111-8111-111111111111",
  "targetFormat": "zugferd"
}

Read: GET /conversion-reviews/{id}. ready means ready for viewing, blocked Locks the confirmation. Compare Original, Target Preview, Supplements, and both reports.

test artifacts under /conversion-reviews/{id}/: source-report, target-report, xml, pdf and review-report.

Confirm audited edition

Only after human inspection POST /documents/convert Send with your own Idempotency key:

JSON · ausdrückliche Bestätigung
{
  "reviewId": "22222222-2222-4222-8222-222222222222",
  "reviewHash": "<Hash aus der geprüften Vorschau>",
  "confirm": true
}

The output uses exactly the tested bytes and refers to the original and the test, and then produces at most one confirmed output for each test, even for different confirmation keys. GET /conversion-reviews/{id} Provides the current convertedDocumentId.

Limitations and errors

Support is provided for XRechnung-UBL ↔ ZUGFeRD EN16931, type 380/381, EUR, 0/7/19 % and up to 100 positions. Unrepresentable XML content, modified declared amounts, PDF signature data or additional embedded files block the conversion.

422 conversion_blocked contains findings. A false hash results 409 review_changed; requires a rule/mapping change 409 review_stale Old originals and reports remain unchanged.

No issuance, numbering or sending. Sandbox conversions get the original numbers; the new PDF display is marked as a test.

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.