Advertisementtop - development preview

← Indietro

Facture-X to UBL 2.1

Learn how to transform your French electronic invoices (Facture-X) into Universal Business Language format for international business transactions.

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. Below is an example of how a supplier is defined in Facture-X:

xml
<ram:SellerTradeParty>
  <ram:Name>French Company SAS</ram:Name>
  <ram:SpecifiedLegalOrganization>
    <ram:ID schemeID="0002">12345678900012</ram:ID>
  </ram:SpecifiedLegalOrganization>
  <ram:PostalTradeAddress>
    <ram:PostcodeCode>75001</ram:PostcodeCode>
    <ram:LineOne>1 rue de Rivoli</ram:LineOne>
    <ram:CityName>Paris</ram:CityName>
    <ram:CountryID>FR</ram:CountryID>
  </ram:PostalTradeAddress>
  <ram:SpecifiedTaxRegistration>
    <ram:ID schemeID="VA">FR12123456789</ram:ID>
  </ram:SpecifiedTaxRegistration>
</ram:SellerTradeParty>

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. The same supplier information in UBL format:

xml
<cac:AccountingSupplierParty>
  <cbc:CustomerAssignedAccountID>CUST123</cbc:CustomerAssignedAccountID>
  <cac:Party>
    <cac:PartyName>
      <cbc:Name>French Company SAS</cbc:Name>
    </cac:PartyName>
    <cac:PartyLegalEntity>
      <cbc:CompanyID schemeID="0002">12345678900012</cbc:CompanyID>
    </cac:PartyLegalEntity>
    <cac:PostalAddress>
      <cbc:StreetName>1 rue de Rivoli</cbc:StreetName>
      <cbc:CityName>Paris</cbc:CityName>
      <cbc:PostalZone>75001</cbc:PostalZone>
      <cac:Country>
        <cbc:IdentificationCode>FR</cbc:IdentificationCode>
      </cac:Country>
    </cac:PostalAddress>
    <cac:PartyTaxScheme>
      <cbc:CompanyID>FR12123456789</cbc:CompanyID>
      <cac:TaxScheme>
        <cbc:ID>VAT</cbc:ID>
      </cac:TaxScheme>
    </cac:PartyTaxScheme>
  </cac:Party>
</cac:AccountingSupplierParty>

Why Convert Facture-X to UBL 2.1?

Converting between these formats is essential for:

  • International business: Selling to customers outside France
  • Global systems: Integration with international ERP systems
  • Peppol compliance: Meeting international e-invoicing standards
  • Multi-country operations: Companies with international presence
  • System compatibility: Working with global trading partners

Conversion Process

Converting your Facture-X to UBL 2.1 involves these key steps:

Step 1: Upload Your Invoice

Simply upload your Facture-X PDF file. The system automatically reads both the visual invoice and the embedded electronic data.

Step 2: Extract CII Data

First, extract the embedded CII XML from the Facture-X PDF:

  • System reads the PDF file structure
  • Locates and extracts the embedded XML attachment
  • Validates the CII data structure
  • Prepares data for conversion to UBL format

Step 3: Transform to UBL

Convert the extracted CII data to international UBL standard:

  • Maps CII elements to UBL standard names
  • Converts French tax categories to international codes
  • Transforms French address formats to global standards
  • Adjusts date and number formats for international use
  • Preserves all invoice data and calculations

Step 4: Quality Validation

Before generating the final file, the system performs thorough checks:

  • Validates XML structure against UBL schema
  • Ensures all required fields are present
  • Checks business rules and calculations
  • Verifies international formatting compliance
  • Tests compatibility with receiving systems

Step 5: Download Ready-to-Use File

You receive a properly formatted UBL 2.1 file ready for international business transactions and system integration.

Common Conversion Issues

Be aware of these challenges when converting Facture-X to UBL:

1. Hybrid Format Complexity

Facture-X's hybrid nature presents unique challenges:

  • PDF extraction may not capture all embedded data
  • Visual elements are lost in conversion to pure XML
  • File size may be larger due to PDF component
  • Processing time increases due to dual format handling
  • Quality of embedded XML affects conversion accuracy

2. Tax System Variations

French and international tax systems have different requirements:

AspectFacture-X (France)UBL 2.1 (International)
VAT RatesStandard French rates (20%, 10%, 5.5%, 2.1%)International rates (varies by country)
Tax CodesFrench tax categoriesInternational categories (S, Z, E, AE)
CurrencyEUR mandatoryVarious currencies supported
Decimal Places2 decimal places2 decimal places

3. Field Mapping Challenges

Converting between different XML structures requires careful mapping:

FieldFacture-X (CII)UBL 2.1
Invoice NumberExchangedDocumentContext/IDcbc:ID
Invoice DateExchangedDocumentContext/IssueDateTimecbc:IssueDate
Customer VATBuyerTradeParty/GlobalIDcbc:EndpointID/PartyIdentification
Supplier VATSellerTradeParty/GlobalIDcbc:EndpointID/PartyIdentification
Line ItemsSupplyLineTradeTransactioncac:InvoiceLine
Payment TermsPaymentTermscbc:PaymentTerms

Best Practices for Conversion

Follow these guidelines for successful conversion:

1. File Preparation

  • Validate Facture-X file before conversion
  • Check embedded XML quality and completeness
  • Ensure all required fields are present
  • Verify tax calculations and French tax codes

2. Testing

  • Test with sample invoices from your business
  • Validate against UBL 2.1 schema requirements
  • Check compatibility with target international systems
  • Verify international formatting compliance

3. Documentation

  • Keep conversion logs for audit purposes
  • Document any special handling requirements
  • Maintain mapping tables for consistency
  • Store validation rules and exceptions

Benefits of UBL Conversion

Converting to UBL 2.1 format offers several advantages:

For International Business

  • Global compatibility with trading partners
  • Compliance with international e-invoicing standards
  • Integration with global ERP and accounting systems
  • Support for multi-language and multi-currency transactions
  • Enhanced automation capabilities

For System Integration

  • Standardized format for system integration
  • Better compatibility with international partners
  • Reduced integration costs and complexity
  • Improved data exchange capabilities
  • Future-proof format for business growth
Last modified: 2025
Advertisementbottom - development preview