X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

ZUGFeRD (Version 1.0.1)

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.

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:

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

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

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

    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.:

[...]
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
[...]

  1. Speichern Sie die Datei.