Class name | com.ebd.hub.datawizard.postexec.ZUGFerdPDF |
Description
This post-executor creates a ZUGFeRD PDF/A-3 file from a regular XML file created in the profile (see section XMLNoTemplateUnit) and a regular PDF file. The post-executor expects the path to the PDF file in the field "Config file".
It is also possible to define the Conformance Level after a colon in the parameter, i.e. the characteristics of the XML invoice data according to the specifications of ZUGFeRD (allowed values are BASIC, COMFORT, EXTENDED, EN16931, XRECHNUNG).
Separated by another colon, the ZUGFeRD version number is given at the end. Permitted values are 1 and 2. If no value is specified, the default value is 1.
NOTE
The Conformance Level XRECHNUNG requires ZUGFeRD version 2. The XRechnung profile is available only as of ZUGFeRD 2.1.1 and is not available for ZUGFeRD 1.0.
If version 2 is used, the path to a folder containing additional documents to be included can be specified after another colon (subfolders are ignored.). The files of the folder are deleted after inclusion. If the specified folder is empty, the folder itself will be deleted.
Syntax of the configuration string:
<PDF path>:<level>:<version>:<include path> |
IMPORTANT
The input PDF file must not be in the PDF/A format.
IMPORTANT
The encoding for the postexecuter in Phase 5 has to be UTF8. If the postexecuter is used in Phase 6, the content of a Response has to be set to Content of IU and the encoding has to be UTF8 here as well.
NOTE
Placeholders @VAR_NAME@ for variables and %CONST_NAME% for constants are allowed.
ZUGFeRD 1.0, ZUGFeRD 2.x, and XRechnung comparison
The following table illustrates the formats.
Format | Description | Use case |
ZUGFeRD 1.0 | First generation of the hybrid invoice format (PDF/A-3 with embedded XML file). | B2B. Not an equivalent substitute for XRechnung. |
ZUGFeRD 2.x | Second generation, compliant with EU standard EN 16931. As of version 2.1.1, includes a dedicated XRechnung profile. | B2B and B2G. With XRechnung profile suitable for invoices to government bodies. |
XRechnung | Standalone standard for public administration in Germany. Structured XML invoice without PDF. | B2G. Mandatory for invoices to public contracting authorities. |
Example
./temp/INVOICE/INV_12_150715.pdf:EXTENDED:2:./files/include |