Konvertierung
Formate mit unveränderlichen Vorschauen und ausdrücklicher Bestätigung wechseln.
Auf dieser Seite
Rebilix blockiert nicht vollständig abbildbare Konvertierungen. Eine bereitgestellte Vorschau wird niemals automatisch zur bestätigten Ausgabe.
1. Original archivieren
Verwenden Sie POST /documents/parse oder /documents/validate. Die zurückgegebene Dokument-ID wird zum Ausgangspunkt der Konvertierung.
2. Konvertierungsvorschau prüfen
POST /documents/conversion-review benötigt alle drei Rechte und einen Idempotency-Key. Optional können fehlende Routing- und Kontaktangaben über supplements ergänzt werden; vorhandene Werte lassen sich nicht überschreiben.
{
"sourceDocumentId": "11111111-1111-4111-8111-111111111111",
"targetFormat": "zugferd"
}Lesen Sie GET /conversion-reviews/{id}. ready bedeutet zur Durchsicht bereit, blocked sperrt die Bestätigung. Vergleichen Sie Original, Zielvorschau, Ergänzungen sowie beide Berichte.
Prüfartefakte unter /conversion-reviews/{id}/: source-report, target-report, xml, pdf und review-report.
3. Geprüfte Ausgabe bestätigen
Erst nach menschlicher Durchsicht POST /documents/convert mit eigenem Idempotency-Key senden:
{
"reviewId": "22222222-2222-4222-8222-222222222222",
"reviewHash": "<Hash aus der geprüften Vorschau>",
"confirm": true
}Die Ausgabe verwendet genau die geprüften Bytes und verweist auf Original und Prüfung. Pro Prüfung entsteht höchstens eine bestätigte Ausgabe, auch bei verschiedenen Bestätigungsschlüsseln. GET /conversion-reviews/{id} liefert die aktuelle convertedDocumentId.
Grenzen und Fehler
Unterstützt werden XRechnung-UBL ↔ ZUGFeRD EN16931, Typ 380/381, EUR, 0/7/19 % und bis zu 100 Positionen. Nicht abbildbare XML-Inhalte, veränderte deklarierte Beträge, PDF-Signaturdaten oder zusätzliche eingebettete Dateien blockieren die Konvertierung.
422 conversion_blocked enthält Befunde. Ein falscher Hash ergibt 409 review_changed; nach einer Regel-/Mappingänderung verlangt 409 review_stale eine neue Prüfung. Alte Originale und Berichte bleiben unverändert.
Keine Ausstellung, Nummernvergabe oder Versendung. Sandbox-Konvertierungen erhalten die ursprünglichen Nummern; die neue PDF-Darstellung ist als Test gekennzeichnet.