Developers
OpenAPI ↗
Zur App
Dokumentation / API v1
API v1 · API v1

Konvertierung

Formate mit unveränderlichen Vorschauen und ausdrücklicher Bestätigung wechseln.

Auf dieser Seite
Vorbereiten → prüfen → ausdrücklich bestätigen

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.

JSON · Prüfung vorbereiten
{
  "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:

JSON · ausdrückliche Bestätigung
{
  "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.

Verbindung wird wiederhergestellt …

Neuer Verbindungsversuch in Sekunden.

Die Verbindung konnte nicht wiederhergestellt werden.
Bitte versuchen Sie es erneut oder laden Sie die Seite neu.

Ihre Sitzung wurde pausiert.

Die Sitzung konnte nicht fortgesetzt werden.
Bitte versuchen Sie es erneut oder laden Sie die Seite neu.