Skip to main content
Skip table of contents

Create ZUGFeRD template


If you want to create a ZUGFeRD PDF template, you need a Jaspersoft Report Template in the *.jasper format. You can easily create the Templates over Jaspersoft Studio.

We provide you with 3 demo templates during the installation, you only have to adjust the provided Templates according to your wishes or you appoint us for the adjust of the Templates.

How do I change the Demo Templates?

Start Jaspersoft Studio with your workspace, if you do not have a workspace yet, create one at any position.

Create a new JasperReports Project by right-clicking on Project Explorer new → Project → Jaspersoft Studio → JasperReports Project and give the Project a random name.

Go now under /home/ieffect/zugferd/templates and select one of the Demo Reports. You can find an Sample ZUGFeRD PDF in the Sample Folder in each Template Folder. With the Menten Template we provide you with SQL test data.

Now copy the Folders resources, subreports and the Files of your main folder in your Jasper Report Project

Create now a new DataSource Adapter with the name ZUGFeRD Adapter under Repository Explorer.

To do this, press Create DataAdapter.

From the Data Adapters list, select Database JDBC Connection and press Next.

Now set the Name of the Data Adapter to ZUGFeRD Adapter

Go now under Driver Classpath and press add.  Then go to Jaspersoft Studio's installation folder and select jt400.jar.

In my Case that would be → jaspersoftstudio → jt400.jar.

Now go back to Database Location and enter the following Information.

JDBC URLjdbc:as400://SystemName/ieffect270
UsernameYour Username on your AS400
PasswordYour Password on your AS400

Now test if you have successfully set up the connection,  press Test, if the message Successful appears, you successfully set up the DataAdapter.

Now you can start editing the Jaspersoft Templates. If you have never worked with Jaspersoft Studio I recommend the Getting Started Guide from Jaspersoft.

When you have made changes to the Jaspersoft Templates then copy all changed templates back to your System. Its necessary that the Templates are precompiled because the *ZUGFeRD module requires the precompiled report files (.jasper).

If you want to update the logo, replace the logo.png and logo_footer.png image in the resource folder.


Notes for creating a ZUGFeRD template

Please use the following ZUGFeRD Tables for the creation of the ZUGFeRD Templates.

Libary: IEFFECT270.










Where should I place my Report Templates?

Please put your templates in / home / ieffect / zugferd / templates in a separate folder. Note that there is a maximum of one .jasper file in the main folder.



Where do I select which template is used for the ZUGFeRD generation?

You can do this in the RUNMAP call of the ZUGFeRD generationFor more information, see ZUGFeRD Tutorial 1 , Creating an ZUGFeRD PDF in greenscreen or ZUGFeRD Tutorial 1 , Creating an ZUGFeRD PDF in Webcontrol.

How should my Resource_Bundle be named and where should these placed?

The naming of a Resource_Bundle must be as follows:

Your Resource_Bundles must be placed under /home/ieffect/zugferd/templates/"Your Template Folder"/resources.

Important parameters for creating the report

Parameter nameParameter definitionParameter decription
RESOURCE_PATHSTRING(Text based value)Path to .jasper File
HTKEYSTRING(Text based value)Invoice number of the current order



JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.