Transform API | eConnect

Mit der Transform API konvertieren Sie ein Dokument von einem E-Rechnungsformat in ein anderes, ohne es im PSB zu versenden oder zu speichern. Das ist nützlich, um Transformationen zu testen, bevor Sie live gehen, oder um Dokumente manuell für Partner umzuwandeln, die ein bestimmtes Format benötigen.

Endpoint

POST /api/v1/generic/transform?targetFormat={URN}

Senden Sie das Quelldokument als Body mit Content-Type application/xml. Der targetFormat-Parameter enthält die URN des gewünschten Zielformats.

Wie funktioniert es?

Upload: Senden Sie das XML-Dokument an den Endpoint mit dem gewünschten Zielformat
Erkennung: Der PSB erkennt automatisch das Quellformat anhand des XML-Inhalts
Transformation: Das Dokument wird in das angegebene Zielformat konvertiert
Response: Das konvertierte Dokument wird direkt als XML zurückgegeben

Wenn die automatische Erkennung des Quellformats nicht gelingt, können Sie es explizit über den sourceFormat-Parameter angeben:

POST /api/v1/generic/transform?targetFormat={URN}&sourceFormat={URN}

Beispiele

Von NLCIUS nach Peppol BIS Billing V3:

POST /api/v1/generic/transform?targetFormat=urn:cen.eu:en16931:2017%23compliant%23urn:fdc:peppol.eu:2017:poacc:billing:3.0

Von UBL nach CII (Cross Industry Invoice):

POST /api/v1/generic/transform?targetFormat=urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100

Wichtig: URL-kodieren Sie die URN-Werte in den Queryparametern. Das #-Zeichen muss als %23 kodiert werden.

Unterstützte Transformationen

Nicht alle Transformationen sind verfügbar. Der PSB unterstützt dieselben Transformationen wie beim Senden und Empfangen von Dokumenten. Die am häufigsten verwendeten Transformationen umfassen Konvertierungen zwischen UBL und CII sowie zwischen verschiedenen regionalen Varianten (NLCIUS, XRechnung, Factur-X).

Welche Transformationen genau verfügbar sind, hängt von der aktuellen Transformationstabelle des PSB ab. Unter psb.econnect.eu finden Sie die aktuellste Übersicht.

Fehlerbehandlung

Statuscode

Bedeutung

200 OK

Transformation erfolgreich, konvertiertes Dokument im Response-Body

400 Bad Request

Quellformat nicht erkannt oder Transformation nicht unterstützt

422 Unprocessable

Dokument kann nicht konvertiert werden (fehlende oder ungültige Daten)

Wann verwenden?

Testen vor Produktionsgang: Prüfen Sie, ob Ihre Dokumente korrekt transformiert werden, bevor Sie die Integration live schalten
Manuelle Konvertierung: Konvertieren Sie Dokumente für Partner, die ein anderes Format benötigen
Vergleich: Generieren Sie dasselbe Dokument in mehreren Formaten, um das Mapping zu verifizieren

Technisch: Die Transform API speichert das Dokument nicht und löst keine Webhooks aus. Das Dokument wird im Arbeitsspeicher transformiert und direkt zurückgegeben.

Die vollständige API-Spezifikation finden Sie unter psb.econnect.eu mit allen unterstützten Formaten und URN-Werten.

In der API ausprobieren

Verwandt