← Indietro

UBL 2.1 to FatturaPA

Learn how to transform your Universal Business Language invoices (UBL 2.1) into Italian electronic invoice format (FatturaPA) for business transactions in Italy.

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 FatturaPA Format

FatturaPA (Fattura Elettronica) is the official Italian electronic invoice format mandated by the Agenzia delle Entrate. It's a pure XML format that contains all invoice data in a structured, machine-readable format designed for automatic processing by the Italian tax system (SDI).

Key characteristics of FatturaPA:

• Pure XML format with no visual representation
• Specific Italian tax fields and VAT codes
• Mandatory for all B2B and B2G transactions in Italy
• Requires digital signature for transmission
• Processed through the Sistema di Interscambio (SDI)
• Contains specific Italian fiscal requirements

FatturaPA Structure Example

FatturaPA uses a specific XML schema (SdiFatturaPA). The same supplier information in FatturaPA format:

<CedentePrestatore>
  <DatiAnagrafici>
    <IdFiscaleIVA>
      <IdPaese>US</IdPaese>
      <IdCodice>123456789</IdCodice>
    </IdFiscaleIVA>
    <Anagrafica>
      <Denominazione>Global Company Ltd</Denominazione>
    </Anagrafica>
  </DatiAnagrafici>
  <Sede>
    <Indirizzo>123 Business Street</Indirizzo>
    <CAP>10001</CAP>
    <Comune>New York</Comune>
    <Nazione>US</Nazione>
  </Sede>
</CedentePrestatore>

Why Convert UBL 2.1 to FatturaPA?

Converting between these formats is essential for:

• Italian business: Selling to Italian customers who require FatturaPA format
• Compliance requirements: Meeting Italian e-invoicing regulations
• Customer preference: Providing invoices in preferred Italian format
• System integration: Working with Italian business systems
• Multi-country operations: Companies with Italian market presence

Conversion Process

Converting your UBL 2.1 to FatturaPA involves these key steps:

Step 1: Upload Your Invoice

Simply upload your UBL 2.1 XML file. The system automatically reads all the structured international invoice data.

Step 2: Format Transformation

Our converter transforms international UBL to Italian format:

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

Step 3: Italian Compliance

The converted FatturaPA file meets Italian requirements:

• Follows Italian Ministry of Economy specifications
• Supports Italian VAT system and fiscal codes
• Includes proper currency and country codes
• Validates against FatturaPA schema requirements
• Compatible with Italian e-invoicing systems

Step 4: Quality Validation

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

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

Step 5: Download Ready-to-Use File

You receive a properly formatted FatturaPA file ready for Italian business transactions and system integration.

Common Conversion Issues

Be aware of these challenges when converting UBL 2.1 to FatturaPA:

1. Structural Differences

The formats have different XML structures and element names:

2. Tax System Differences

International and Italian tax systems have different requirements:

3. Address Format Conversion

International addresses need to be converted to Italian format:

• Province codes become part of address structure
• International postal codes integrate with Italian systems
• Country codes remain standard (IT)
• Street types follow Italian addressing standards
• Special characters are preserved according to Italian standards

Best Practices for Conversion

Follow these guidelines for successful conversion:

1. 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. Testing

• Test with sample invoices from your business
• Validate against FatturaPA schema requirements
• Check compatibility with target Italian systems
• Verify Italian 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 FatturaPA Conversion

Converting to FatturaPA format offers several advantages:

For Italian Market

• Compliance with Italian e-invoicing regulations
• Enhanced customer acceptance and satisfaction
• Improved business relationships with Italian partners
• Access to Italian government e-invoicing platforms
• Support for mandatory B2B transactions in Italy

For System Integration

• Standardized Italian format for system integration
• Better compatibility with Italian trading partners
• Reduced integration costs and complexity
• Improved data exchange capabilities
• Support for multi-country operations involving Italy