Advertisementtop - development preview

← Back

UBL 2.1 to ZUGFeRD

Learn how to transform your Universal Business Language invoices into ZUGFeRD — the German hybrid electronic invoice standard used for automated processing in Germany and across the EU.

Understanding UBL 2.1 Format

UBL (Universal Business Language) is an international XML standard for electronic business documents. It is widely used in cross-border transactions and is the foundation for many e-invoicing systems, including the Peppol network.

Key characteristics of UBL 2.1:

  • International ISO standard (ISO/IEC 19845)
  • Flexible structure supporting various document types
  • Widely adopted in global e-invoicing
  • Compatible with Peppol and other networks
  • Supports complex business rules and validations
  • Extensible for custom requirements

UBL 2.1 Structure Example

UBL uses a namespace-based XML structure. Below is an example of how a supplier party is defined in UBL:

xml

          <cac:AccountingSupplierParty>
            <cac:Party>
              <cac:PartyName>
                <cbc:Name>Mustermann GmbH</cbc:Name>
              </cac:PartyName>
              <cac:PartyLegalEntity>
                <cbc:CompanyID schemeID="0088">4012345678901</cbc:CompanyID>
              </cac:PartyLegalEntity>
              <cac:PostalAddress>
                <cbc:StreetName>Musterstrasse 1</cbc:StreetName>
                <cbc:CityName>Berlin</cbc:CityName>
                <cbc:PostalZone>10115</cbc:PostalZone>
                <cac:Country>
                  <cbc:IdentificationCode>DE</cbc:IdentificationCode>
                </cac:Country>
              </cac:PostalAddress>
              <cac:PartyTaxScheme>
                <cbc:CompanyID>DE123456789</cbc:CompanyID>
                <cac:TaxScheme>
                  <cbc:ID>VAT</cbc:ID>
                </cac:TaxScheme>
              </cac:PartyTaxScheme>
            </cac:Party>
          </cac:AccountingSupplierParty>

Understanding ZUGFeRD Format

ZUGFeRD (Zentraler User Guide des Forums elektronische Rechnung Deutschland) is the German electronic invoice standard. It is a hybrid PDF/XML format that embeds structured CII XML data inside a human-readable PDF — identical in technical specification to Factur-X 1.x, but named and branded for the German market.

Key characteristics of ZUGFeRD:

  • Hybrid format: human-readable PDF with embedded machine-readable XML
  • Based on UN/CEFACT CII (Cross Industry Invoice) syntax
  • Compliant with European standard EN 16931
  • Multiple profiles: MINIMUM, BASIC WL, BASIC, EN16931, EXTENDED
  • Technically identical to Factur-X 1.x (same XML schema, different branding)
  • The embedded XML attachment is named zugferd-invoice.xml
  • Recommended for B2B transactions in Germany

ZUGFeRD Embedded XML Example

ZUGFeRD uses the UN/CEFACT CII syntax embedded inside the PDF. The same supplier information in ZUGFeRD CII format:

xml

        <ram:SellerTradeParty>
          <ram:Name>Mustermann GmbH</ram:Name>
          <ram:SpecifiedLegalOrganization>
            <ram:ID schemeID="0088">4012345678901</ram:ID>
          </ram:SpecifiedLegalOrganization>
          <ram:PostalTradeAddress>
            <ram:PostcodeCode>10115</ram:PostcodeCode>
            <ram:LineOne>Musterstrasse 1</ram:LineOne>
            <ram:CityName>Berlin</ram:CityName>
            <ram:CountryID>DE</ram:CountryID>
          </ram:PostalTradeAddress>
          <ram:SpecifiedTaxRegistration>
            <ram:ID schemeID="VA">DE123456789</ram:ID>
          </ram:SpecifiedTaxRegistration>
        </ram:SellerTradeParty>

Why Convert UBL 2.1 to ZUGFeRD?

Converting from UBL to ZUGFeRD is essential for:

  • German market: Sending invoices to German partners who require a hybrid PDF format
  • B2B compliance: Meeting German e-invoicing expectations for supplier invoices
  • Archiving requirements: ZUGFeRD creates a self-contained, human-readable PDF with machine-readable data
  • ERP integration: German ERP systems such as SAP, DATEV, and Lexware natively process ZUGFeRD
  • Multi-country operations: Companies operating in both EU and German markets

Conversion Process

Converting your UBL 2.1 to ZUGFeRD is simple and fast:

Step 1: Upload Your Invoice

Upload your UBL XML file. The system reads your invoice data.

Step 2: Automatic Processing

Our tool validates and converts the invoice data directly into the ZUGFeRD standard. It generates a human-readable visual PDF and securely embeds the required XML data behind the scenes.

Step 3: Download Ready-to-Send File

You receive a ZUGFeRD-compliant PDF ready for transmission to German trading partners and ERP systems.

ZUGFeRD vs Factur-X

ZUGFeRD and Factur-X are the same technical standard with different national branding:

AspectZUGFeRD (Germany)Factur-X (France/EU)
XML SchemaUN/CEFACT CII EN16931UN/CEFACT CII EN16931
PDF embeddingPDF/A-3 with attachmentPDF/A-3 with attachment
Embedded filenamezugferd-invoice.xmlfactur-x.xml
ProfilesMINIMUM, BASIC WL, BASIC, EN16931, EXTENDEDMINIMUM, BASIC WL, BASIC, EN16931, EXTENDED
Version alignmentZUGFeRD 2.xFactur-X 1.x

Best Practices for Conversion

1. File Preparation

  • Validate UBL file before conversion
  • Ensure all required fields are present (seller VAT, invoice number, dates)
  • Verify tax calculations are correct
  • Check that party addresses are complete

2. Testing

  • Test with sample invoices from your business
  • Open the output PDF and verify the embedded XML is readable
  • Check compatibility with German ERP systems (SAP, DATEV)
  • Validate against ZUGFeRD schema if required

3. Documentation

  • Keep conversion logs for audit purposes
  • Document any special handling requirements
  • Store validation rules and exceptions
Last modified: 2025
Advertisementbottom - development preview