Conversion
Change formats with immutable previews and explicit confirmation.
On this page
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.
{
"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:
{
"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.