General configurations

Interface ZF23INVHT - Header table

When filling the database fields, the following fields in the header table ZF23INVHT in particular must be filled as described here.

Field	Sample content	Explanation
HTNAPPREF	ZUGFERD XRECHNUNG	This is interface data from or for the ZUGFeRD format. This is interface data from or for the XRECHNUNG format.
HTNAPPVER	2.3.2 2.3.3 3.0.2 3.0.1 2.3.1 2.2.0 2.1.1	ZUGFeRD Version 2.3.2 ZUGFeRD Version 2.3.3 XRECHNUNG Version 3.0.2 XRECHNUNG Version 3.0.1 XRECHNUNG Version 2.3.1 XRECHNUNG Version 2.2.0 XRECHNUNG Version 2.1.1
HTNAPPFMT	UBL CII COMFORT EXTENDED	Data originates from or is intended for the presentation of an XRECHNUNG invoice in Universal Business Language (UBL) format. Data originates from or is intended for the presentation of an XRECHNUNG invoice in CII (Cross Industry Invoice) format. Data originates from or is intended for the presentation of a ZUGFeRD invoice in COMFORT profile. Data originates from or is intended for the presentation of a ZUGFeRD invoice in EXTENDED profile.
MANDANT	01	The field can be used to select or mark data records for different organisations. When processing output data, only data records that correspond to the specified value in the transferred variable MANDANT are selected. If the parameter is omitted, all data records are selected.
HTDIRECT	OUT IN	Data for generating files Imported data
HTSTATE		empty = to be processed (HTDIRECT='OUT') or has been read in and not yet processed (HTDIRECT='IN') 1 = successfully processed 2 = processing error
EXTERNAL_ORIGINATOR		Name of a different sender identification defined in the master data of i-effect and to be used for sending this data. See Send ZUGFeRD or xRechnung invoices with SNDFILE
EXTERNAL_RECIPIENT		Name of a different recipient identification defined in the master data of i-effect and to be used for sending this data. See Send ZUGFeRD or xRechnung invoices with SNDFILE

PDF template and existing PDF files

It is possible to create a PDF, which is combined with the generated XML during mapping, using a template or to use an existing PDF file for the ZUGFeRD PDF. Which method is chosen depends on the content of the database fields HTTEMPLDIR and HTPDF:

Field

Contents

Function

HTTEMPLDIR

extended
comfort

The folder name of the template to be used to generate a PDF. The folder must be located under /home/ieffect/zugferd/templates. If the field is empty, the template folder matching the mapping is used automatically.

This parameter is used to access your own templates in a separate folder.

HTPDF

/home/ieffect/pdf/zugferd.pdf

zugferd.pdf

The path to an existing PDF file or the name of the PDF to be created.

If a complete path (with a leading / ) is specified, no PDF is created, but an attempt is made to use the specified PDF for combining XML and PDF.

If only a file name (including file extension) is specified, the PDF is created using a template and is given the specified name. The file is created in the output directory specified in the RUNMAP command.

If the field is empty, a name is automatically generated according to this pattern:
ZUGFeRD_<COMFORT|EXTENDED><DOCUMENT NUMBER><UNIQUE>.pdf
In this case, the file is created in the directory specified in the RUNMAP parameter.