ZUGFeRD

webPDF supports the embedding of XML data according to the ZUGFeRD 1.0, ZUGFeRD 2.0 and ZUGFeRD 2.1.1 specification or the Factur-X compatible with ZUGFeRD 2.1 for PDF/A conversion.

 

You can use the parameters to specify the XML data for the ZUGFeRD file when calling the “Pdfa” web service.

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<operation xmlns="http://schema.webpdf.de/1.0/operation">
<pdfa>
  <convert errorReport="message" level="3u" imageQuality="75" successReport="linked">
    <zugferd>
      <xmlFile version="v10Comfort">
         PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4NCg0KPHBy
         ...
         dD4=
      </xmlFile>
    </zugferd>
  </convert>
</pdfa>
</operation>

 

If the "<zugferd>" element is defined, the web service will embed the "<xmlFile>" file (Base64-encoded) during the PDF/A conversion. Before being embedded, the XML data will be validated against the relevant schema and will only be embedded if valid. The schema version can be defined with the "version" attribute in the parameters.

 

Validation against the following schemas is supported:

 

Version 1.0 - Comfort

Version 2.0 - Minimum profile

Version 2.0 - Basic WL profile

Version 2.0 - Basic profile

Version 2.0 - EN16931 (Comfort) profile

Version 2.0 - Extended profile

Version 2.1 - Profil Minimum*

Version 2.1 - Profil Basic WL*

Version 2.1 - Profil Basic*

Version 2.1 - Profil EN16931 (Comfort)*

Version 2.1 - Profil Extended*

Version 2.1 - Profil X-Rechnung*

 

* currently corresponds to version 2.1.1 from 01.07.2020

 

Since version 2.1.1 the profile "X-Invoice" is also supported. For more information on ZUGFeRD and the structure of the XML file and its use, please visit https://www.ferd-net.de.

 

hint

The ZUGFeRD 2.0 standard also supports the XRechnung standard, as well asFactur-X 1.0 with the corresponding interaction.

 

hint

ZUGFeRD 2.1.x and Factur-X 1.0 continue to be fully compatible and technically identical formats, which will already share the Factur-X identifier as of March 24, 2020.