ZUGFeRD

Mit diesem Adapter können Sie ZUGFeRD 2-/Factur-X-, ZUGFeRD 1- und XRechnung-PDF-Dateien auslesen, erstellen und validieren.

Hinweis:

Der ZUGFeRD Adapter ist aktuell nicht im Standard der X4 BPMS enthalten und ist ggf. mit weiteren Kosten verbunden. Für weitere Informationen zum Adapter wenden Sie sich an das SoftProject-Support-Team.

Weitere Informationen zu den Parametern, Inputs und Outputs der jeweiligen Operationen finden Sie auf den entsprechenden Unterseiten.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt.

Weitere Informationen zu den Parametern, Statuswerten sowie Input und Output der einzelnen Operationen finden Sie auf den entsprechenden Unterseiten.

Mögliche Werte:

Detect XML: Erkennt elektronische Rechnungs-XMLs in der Input-PDF-Datei.
Extract XML: Erkennt elektronische Rechnungs-XMLs in der Input-PDF-Datei und gibt diese aus falls vorhanden.
Get Version: Gibt eine XML-Datei aus mit Daten zu Version, Profil und Standard des XMLs, das als Input-Datei angegeben oder in einer PDF-Datei integriert ist.
Validate: Validiert die Input-PDF- oder XML-Datei und gibt eine XML-Datei aus, die Daten zur Validierung enthält.
Embed XML: Gibt einen Bytestream einer neuen PDF-Datei aus, in die das gewünschte XML integriert ist.

Fehlerbehebung: Fehlermeldung im Server Log

Wenn Sie Versionen der X4 BPMS ab 7.3.0 und 7.4.0 einsetzen, kann abhängig von der verwendeten Java-Version beim Einsatz des Adapters ein Fehler auftreten:

CODE

ERROR [org.apache.pdfbox.io.IOUtils] (Debug-Thread-1) Unmapping is not supported.: java.lang.IllegalAccessException: symbolic reference class is not accessible: class jdk.internal.ref.Cleaner, from org.apache.pdfbox.io.IOUtils (unnamed module @4788efb3)

So beheben Sie den Fehler

Öffnen Sie die Datei startX4.bat im Serververzeichnis der X4 BPMS in einem beliebigen Editor.

Fügen Sie folgende Zeilen zur Datei startX4.bat hinzu:

CODE

rem ==== for Zugferd Adapter ====
@set JAVA_OPTS=%JAVA_OPTS% --add-opens=java.base/jdk.internal.ref=ALL-UNNAMED

Hinweis:

Wir empfehlen, dass Sie die JAVA_OPTS mit entsprechendem Kommentar an der Stelle der Datei startX4.bat einfügen, an der bereits andere JAVA_OPTS definiert sind, z. B.:

CODE

[...]
rem ===== Configure path to the x4config.xml =====
@set JAVA_OPTS=%JAVA_OPTS% -Dx4.config.file=X4config.xml
@set JAVA_OPTS=%JAVA_OPTS% -Dx4.directory="\"%CD%\""
@set JAVA_OPTS=%JAVA_OPTS% -Dx4.version="X.X.X-SNAPSHOT_1597bc7"

rem ===== Surpress some messages about not finding native implementations and falling back to a pure java implementation =====
@set JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.media.jai.disableMediaLib=true

rem ==== for Zugferd Adapter ====
@set JAVA_OPTS=%JAVA_OPTS% --add-opens=java.base/jdk.internal.ref=ALL-UNNAMED

rem ===== enable custom URL handlers for wildfly
@set JAVA_OPTS=%JAVA_OPTS% -Djboss.protocol.handler.modules=de.softproject.x4.client
[...]

Speichern Sie die Datei.