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:
<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:
<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:
| Aspect | ZUGFeRD (Germany) | Factur-X (France/EU) |
|---|---|---|
| XML Schema | UN/CEFACT CII EN16931 | UN/CEFACT CII EN16931 |
| PDF embedding | PDF/A-3 with attachment | PDF/A-3 with attachment |
| Embedded filename | zugferd-invoice.xml | factur-x.xml |
| Profiles | MINIMUM, BASIC WL, BASIC, EN16931, EXTENDED | MINIMUM, BASIC WL, BASIC, EN16931, EXTENDED |
| Version alignment | ZUGFeRD 2.x | Factur-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