DynaPDF Manual - Page 195

Previous Page 194   Index   Next Page 196

Function Reference
Page 195 of 818
ZUGFeRD 1.0:
"ZUGFeRD-invoice.xml"
ZUGFeRD 2.0:
"zugferd-invoice.xml"
Factur-X / ZUGFeRD 2.1:
"factur-x.xml"
XRechnung:
"xrechnung.xml"
Note that ZUGFeRD 2.1 and Factur-X are indentically defined in PDF. Therefore, both formats share
the same version constants!
The invoice can be attached with AttachFile() or AttachFileEx(). The embedded file must also be
associated with the global catalog object with AssociateEmbFile(). This step is optional. If the file
was not already associated with the catalog object then it will be associated automatically.
However, if set, the parameter Relationship must be set to arAlternative, arData, or arSource depending
on the output version:
Profile
Relationship
ctZUGFeRD_Basic
arAlternative
ctZUGFeRD_Comfort
arAlternative
ctZUGFeRD_Extended
arAlternative
ctZUGFeRD2_Minimum
arData or arSource
ctZUGFeRD2_Basic
arAlternative
ctZUGFeRD2_Basic_WL
arData or arSource
ctZUGFeRD2_Comfort
arAlternative
ctZUGFeRD2_Extended
arAlternative
ctFacturX_Minimum
arData or arSource
ctFacturX_Basic
arAlternative
ctFacturX_Basic_WL
arData or arSource
ctFacturX_Comfort
arAlternative
ctFacturX_Extended
arAlternative
ctFacturX_XRechnung
arSource
Note that the relationship for the profiles Basic, Comfort (EN 16931), and Extended must be set
differently depending on the country for which an invoice will be created. An invoice created for a
German recipient must set the relationship to arAlternative while the same invoice created for a
recipient in France must set it to arSource.
CheckConformance() sets the relationship to arAlternate or arData for the MINIMUM and BASIC WL
profiles for ZUGFeRD 2.0 or Factur-X / ZUGFeRD 2.1 if it was not already set. If arSource should be
used then call AssociateEmbFile() for the emdedded file (the attached XML invoice). Set the
parameter DestObject to adCatalog in this case.
If the embedded invoice cannot be found then a fatal error will be raised and no PDF file will be
created. If the file was found then the remaining settings will be applied if not already present.
ZUGFeRD, and Factur-X are permanently growing standards. Minor changes in a standard do often
not affect the PDF container. For example, the FacturX constants are compatible with at least
ZUGFeRD 2.1, ZUGFeRD 2.1.1, and with Factur-X up to version 1.05. Please send us an email if
you're unsure whether a specific version is supported by DynaPDF.
 

Previous topic: PDF/A 2b or 3b, ZUGFeRD, ZUGFeRD 2.0, Factur-X / ZUGFeRD 2.1, XRechnung

Next topic: Return values


Start Chat