Advertisementtop - development preview

← Indietro

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:

xml
<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:

xml
<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:

FieldUBL 2.1Facture-X (CII)
Invoice Numbercbc:IDExchangedDocumentContext/ID
Invoice Datecbc:IssueDateExchangedDocumentContext/IssueDateTime
Customer VATcbc:EndpointID/PartyIdentificationBuyerTradeParty/GlobalID
Supplier VATcbc:EndpointID/PartyIdentificationSellerTradeParty/GlobalID
Line Itemscac:InvoiceLineSupplyLineTradeTransaction

2. Tax Code Mapping

International and French tax systems have different requirements:

International CategoryDescriptionFrench Equivalent
SStandard rateStandard rate (20%)
ZZero ratedZero rate (0%)
EExemptExempt (non-taxable)
AEReverse chargeReverse 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
Last modified: 2025
Advertisementbottom - development preview