DynaPDF Manual - Page 217

Previous Page 216   Index   Next Page 218

Function Reference
Page 217 of 860
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 the 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.2, and with Factur-X up to version 1.0.0.6. Factur-X 1.0.0.6 and ZUGFeRD 2.2 are
technically identically defined. The name ZUGFeRD is used for historical reasons.
Please send us an email if you're unsure whether a specific version is supported by DynaPDF.
Notice:
Although it 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, CircleAnnot