DynaPDF Manual - Page 183

Previous Page 182   Index   Next Page 184

Function Reference
Page 183 of 787
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.
Notice:
Although ist would be technically no problem to create one large PDF file for multiple invoices, this
is not allowed in these standards. A valid ZUGFeRD or Factur-X invoice file can contain one invoice
only.
PDF/A conversion and normalization with enabled font embedding depends strongly on the
availability of fonts. The ability to convert standard fonts to Type3 was mainly added for the font
ZapfDingbats because this font is not available on most systems.
Return values
If the PDF file is compatible to PDF/A 1b the function returns one of the following values:
0 -> The PDF file is fully compatible to PDF/A 1b. Close the file with CloseFile(), finished.
1 -> A RGB ICC profile must be added to the document with AddOutputIntent().
2 -> A CMYK ICC profile must be added to the document with AddOutputIntent().
3 -> A Gray, RGB, or CMYK ICC profile must be added to the document with
AddOutputIntent() or AddOutputIntentEx(). DeviceGray compatible ICC profiles are rarely
available since this is mostly just a gamma table. However, you can use a RGB or CMYK
profile instead (a sRGB profile is preferred due to the smaller size).
< 0 -> A negative return value indicates that an error occurred during conversion to PDF/A.
Note that the function raises always fatal exceptions, there is no PDF file in memory if the
conversion fails.
 

Previous topic: ZUGFeRD, ZUGFeRD 2.0, Factur-X / ZUGFeRD 2.1, XRechnung

Next topic: CheckFieldNames

Start Chat