UBL 2.1 to Facture-X
Learn how to transform your Universal Business Language invoices (UBL 2.1) into French electronic invoice format (Facture-X) for cross-border transactions.
Understanding UBL 2.1 Format
UBL (Universal Business Language) is an international XML standard for electronic business documents. It's 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 different XML structure. Below is an example of how a supplier is defined in UBL format:
<cac:AccountingSupplierParty>
<cbc:CustomerAssignedAccountID>CUST123</cbc:CustomerAssignedAccountID>
<cac:Party>
<cac:PartyName>
<cbc:Name>Global Company Ltd</cbc:Name>
</cac:PartyName>
<cac:PartyLegalEntity>
<cbc:CompanyID schemeID="0002">12345678900012</cbc:CompanyID>
</cac:PartyLegalEntity>
<cac:PostalAddress>
<cbc:StreetName>123 Business Street</cbc:StreetName>
<cbc:CityName>New York</cbc:CityName>
<cbc:PostalZone>10001</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>US</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>US123456789</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingSupplierParty>Understanding Facture-X Format
Facture-X is a Franco-German hybrid electronic invoice standard that combines a human-readable PDF with embedded structured XML data. It's based on the European standard EN 16931 and is one of the mandatory formats for electronic invoicing in France.
Key characteristics of Facture-X:
- Hybrid format: PDF for human reading + XML for machine processing
- Based on UN/CEFACT CII (Cross Industry Invoice) syntax
- Compliant with European standard EN 16931
- Multiple profiles: MINIMUM, BASIC WL, BASIC, EN16931, EXTENDED
- Contains visual representation identical to traditional paper invoices
- Mandatory for B2B transactions in France since 2024
Facture-X Structure Example
Facture-X uses the UN/CEFACT Cross Industry Invoice (CII) syntax. The same supplier information in Facture-X format:
<ram:SellerTradeParty>
<ram:Name>Global Company Ltd</ram:Name>
<ram:SpecifiedLegalOrganization>
<ram:ID schemeID="0002">12345678900012</ram:ID>
</ram:SpecifiedLegalOrganization>
<ram:PostalTradeAddress>
<ram:PostcodeCode>10001</ram:PostcodeCode>
<ram:LineOne>123 Business Street</ram:LineOne>
<ram:CityName>New York</ram:CityName>
<ram:CountryID>US</ram:CountryID>
</ram:PostalTradeAddress>
<ram:SpecifiedTaxRegistration>
<ram:ID schemeID="VA">US123456789</ram:ID>
</ram:SpecifiedTaxRegistration>
</ram:SellerTradeParty>Why Convert UBL 2.1 to Facture-X?
Converting between these formats is essential for:
- French business: Selling to French customers who require Facture-X format
- Compliance requirements: Meeting French e-invoicing regulations
- Customer preference: Providing invoices in the preferred French format
- System integration: Working with French business systems
- Multi-country operations: Companies with French market presence
Conversion Process
Converting your UBL 2.1 to Facture-X involves these key steps:
Step 1: Upload Your Invoice
Simply upload your UBL 2.1 XML file. The system reads all the structured international invoice data.
Step 2: Transform to CII
Convert UBL data to CII standard format:
- Maps UBL element names to CII standard elements
- Converts international tax categories to French codes
- Transforms global address formats to French standards
- Adjusts date and number formats for French use
- Preserves all invoice data and calculations
Step 3: Create Hybrid PDF
Generate Facture-X hybrid format with embedded CII data:
- Creates professional PDF layout with company branding
- Embeds converted CII XML as attachment in PDF
- Ensures compliance with Facture-X profile requirements
- Optimizes file size for electronic transmission
- Includes proper metadata for French systems
Step 4: Quality Validation
Before generating the final file, the system performs thorough checks:
- Validates CII XML structure against French requirements
- Ensures all required French fields are present
- Checks business rules and calculations
- Verifies PDF generation quality and readability
- Tests compatibility with French e-invoicing systems
Step 5: Download Ready-to-Use File
You receive a properly formatted Facture-X file ready for French business transactions and customer delivery.
Common Conversion Issues
Be aware of these challenges when converting UBL 2.1 to Facture-X:
1. Format Structure Differences
UBL and Facture-X have different XML structures:
| Field | UBL 2.1 | Facture-X (CII) |
|---|---|---|
| Invoice Number | cbc:ID | ExchangedDocumentContext/ID |
| Invoice Date | cbc:IssueDate | ExchangedDocumentContext/IssueDateTime |
| Customer VAT | cbc:EndpointID/PartyIdentification | BuyerTradeParty/GlobalID |
| Supplier VAT | cbc:EndpointID/PartyIdentification | SellerTradeParty/GlobalID |
| Line Items | cac:InvoiceLine | SupplyLineTradeTransaction |
2. Tax Code Mapping
International and French tax systems have different requirements:
| International Category | Description | French Equivalent |
|---|---|---|
| S | Standard rate | Standard rate (20%) |
| Z | Zero rated | Zero rate (0%) |
| E | Exempt | Exempt (non-taxable) |
| AE | Reverse charge | Reverse charge (autoliquidation) |
3. Profile Selection
Facture-X requires specific profile selection:
- Choose appropriate profile based on data complexity
- MINIMUM for basic invoice information
- BASIC WL for standard business requirements
- BASIC for complete line item details
- EN16931 for full European compliance
- EXTENDED for additional business rules
Best Practices for Conversion
Follow these guidelines for successful conversion:
1. Data Preparation
- Validate UBL 2.1 file before conversion
- Check all international tax codes and VAT numbers
- Ensure address formats are correct
- Verify payment terms and bank details
2. Profile Management
- Test different Facture-X profiles with sample data
- Validate against French schema requirements
- Choose profile based on recipient requirements
- Document profile selection for audit purposes
3. Quality Assurance
- Review generated Facture-X for accuracy and readability
- Check that all data transferred correctly
- Verify PDF quality and embedded XML structure
- Test with French e-invoicing systems
Benefits of Facture-X Conversion
Converting to Facture-X format offers several advantages:
For French Market
- Compliance with French e-invoicing regulations
- Enhanced customer acceptance and satisfaction
- Improved business relationships with French partners
- Access to French government e-invoicing platforms
- Support for mandatory B2B transactions in France
For International Integration
- Standardized hybrid format for French business systems
- Better compatibility with French trading partners
- Reduced integration costs and complexity
- Enhanced data exchange capabilities
- Support for multi-country operations involving France