Factura electrónica ZUGFeRD / Factur-X

Crea una factura electrónica ZUGFeRD / Factur-X -- un PDF híbrido que los humanos pueden leer y las máquinas pueden procesar automáticamente.

¿Qué es ZUGFeRD / Factur-X?

ZUGFeRD (Alemania) y Factur-X (Francia / UE) son el mismo estándar bajo dos nombres. Una factura conforme contiene:

PDF visual -- una factura legible para humanos renderizada como PDF/A-3 (o PDF/A-4f)
XML embebido -- datos de factura legibles por máquina en formato UN/CEFACT Cross Industry Invoice (CII), adjuntos dentro del PDF

Esto permite el procesamiento completamente automatizado mientras mantiene un documento visual familiar para contadores y auditores.

Perfiles

Perfil	Uso típico
Minimum	Número de factura, fecha, totales, impuesto
Basic WL	+ Líneas de detalle, condiciones de pago
Basic	+ Líneas de detalle detalladas
EN 16931 (Comfort)	Cumplimiento para contratación pública de la UE
Extended	Facturas complejas con múltiples impuestos
XRechnung	Facturación del sector público alemán

Requisito PDF/A

ZUGFeRD requiere que el PDF host sea PDF/A-3 o PDF/A-4f (ISO 19005). La variante "f" permite archivos embebidos. TCPDF-Next maneja los metadatos de conformidad, output intent y flags de adjuntos automáticamente.

Ejemplo de código completo

php

<?php

declare(strict_types=1);

require __DIR__ . '/vendor/autoload.php';

use TcpdfNext\Document;
use TcpdfNext\Enums\PdfALevel;
use TcpdfNext\Archive\OutputIntent;
use TcpdfNext\Archive\EmbeddedFile;
use TcpdfNext\Archive\AFRelationship;

// ── 1. Crear un documento PDF/A-4f ──────────────────────────────────────
$pdf = Document::create()
    ->setPdfALevel(PdfALevel::A4F)
    ->setOutputIntent(OutputIntent::sRGB())
    ->setTitle('Invoice INV-2026-0042')
    ->setAuthor('Acme GmbH')
    ->setSubject('Invoice for Order PO-2026-0815');

// ── 2. Renderizar la factura visual ───────────────────────────────────
$invoiceHtml = <<<'HTML'
<h1 style="color:#1a2634;">INVOICE</h1>
<table style="width:100%; margin-bottom:20px;">
    <tr>
        <td><strong>Acme GmbH</strong><br>Friedrichstr. 123<br>10117 Berlin, DE</td>
        <td style="text-align:right;"><strong>INV-2026-0042</strong><br>Date: 2026-02-15<br>Due: 2026-03-17</td>
    </tr>
</table>
<table border="1" cellpadding="6" style="width:100%; border-collapse:collapse;">
    <thead>
        <tr style="background:#1a2634; color:#fff;">
            <th>#</th><th>Description</th><th style="text-align:right;">Amount</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>1</td>
            <td>Professional Services -- February 2026</td>
            <td style="text-align:right;">EUR 1,000.00</td>
        </tr>
    </tbody>
    <tfoot>
        <tr><td colspan="2" style="text-align:right;">Net</td><td style="text-align:right;">EUR 1,000.00</td></tr>
        <tr><td colspan="2" style="text-align:right;">VAT 19%</td><td style="text-align:right;">EUR 190.00</td></tr>
        <tr style="font-weight:bold;">
            <td colspan="2" style="text-align:right;">Total</td>
            <td style="text-align:right;">EUR 1,190.00</td>
        </tr>
    </tfoot>
</table>
HTML;

$pdf->addPage()
    ->setFont('helvetica', size: 10)
    ->writeHtml($invoiceHtml);

// ── 3. Construir el XML Factur-X (perfil EN 16931) ───────────────────────
$xml = <<<'XML'
<?xml version="1.0" encoding="UTF-8"?>
<rsm:CrossIndustryInvoice
    xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
    xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"
    xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100">
  <rsm:ExchangedDocumentContext>
    <ram:GuidelineSpecifiedDocumentContextParameter>
      <ram:ID>urn:factur-x.eu:1p0:en16931</ram:ID>
    </ram:GuidelineSpecifiedDocumentContextParameter>
  </rsm:ExchangedDocumentContext>
  <rsm:ExchangedDocument>
    <ram:ID>INV-2026-0042</ram:ID>
    <ram:TypeCode>380</ram:TypeCode>
    <ram:IssueDateTime>
      <udt:DateTimeString format="102">20260215</udt:DateTimeString>
    </ram:IssueDateTime>
  </rsm:ExchangedDocument>
  <rsm:SupplyChainTradeTransaction>
    <ram:ApplicableHeaderTradeAgreement>
      <ram:SellerTradeParty>
        <ram:Name>Acme GmbH</ram:Name>
        <ram:SpecifiedTaxRegistration>
          <ram:ID schemeID="VA">DE123456789</ram:ID>
        </ram:SpecifiedTaxRegistration>
      </ram:SellerTradeParty>
      <ram:BuyerTradeParty>
        <ram:Name>Customer Corp</ram:Name>
      </ram:BuyerTradeParty>
    </ram:ApplicableHeaderTradeAgreement>
    <ram:ApplicableHeaderTradeSettlement>
      <ram:InvoiceCurrencyCode>EUR</ram:InvoiceCurrencyCode>
      <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
        <ram:LineTotalAmount>1000.00</ram:LineTotalAmount>
        <ram:TaxBasisTotalAmount>1000.00</ram:TaxBasisTotalAmount>
        <ram:TaxTotalAmount currencyID="EUR">190.00</ram:TaxTotalAmount>
        <ram:GrandTotalAmount>1190.00</ram:GrandTotalAmount>
        <ram:DuePayableAmount>1190.00</ram:DuePayableAmount>
      </ram:SpecifiedTradeSettlementHeaderMonetarySummation>
    </ram:ApplicableHeaderTradeSettlement>
  </rsm:SupplyChainTradeTransaction>
</rsm:CrossIndustryInvoice>
XML;

// ── 4. Embeber el XML como archivo asociado ─────────────────────────────
$pdf->addEmbeddedFile(
    EmbeddedFile::create()
        ->setFilename('factur-x.xml')
        ->setMimeType('text/xml')
        ->setContent($xml)
        ->setRelationship(AFRelationship::Alternative)
        ->setDescription('Factur-X EN 16931 invoice data')
);

// ── 5. Establecer metadatos XMP de ZUGFeRD ────────────────────────────────
$pdf->getMetadata()
    ->setXmpProperty('fx:DocumentType', 'INVOICE')
    ->setXmpProperty('fx:DocumentFileName', 'factur-x.xml')
    ->setXmpProperty('fx:Version', '1.0')
    ->setXmpProperty('fx:ConformanceLevel', 'EN 16931');

// ── 6. Guardar ────────────────────────────────────────────────────────────
$pdf->save(__DIR__ . '/INV-2026-0042.pdf');

echo 'ZUGFeRD invoice created.' . PHP_EOL;

Validación

bash

# Conformidad PDF/A
verapdf --flavour 4f INV-2026-0042.pdf

# Esquema XML Factur-X
java -jar Mustang-CLI.jar --action validate --source INV-2026-0042.pdf

TIP

Mustangproject es un validador gratuito de código abierto para facturas ZUGFeRD/Factur-X.

Diagrama de flujo de trabajo

Datos ERP / facturación
        |
        v
  TCPDF-Next genera
        |
        v
  PDF/A-4f + factur-x.xml embebido
        |
        v
  (opcional) Firma digital PAdES
        |
        +-------+-------+-------+
        |       |       |       |
      Email   Portal  PEPPOL  Archivo

Lectura adicional

PDF/A-4 Archival -- Detalles de cumplimiento ISO 19005-4
Flujo de trabajo PAdES B-LTA -- Firmar facturas digitalmente

Factura electrónica ZUGFeRD / Factur-X ​

¿Qué es ZUGFeRD / Factur-X? ​

Perfiles ​

Requisito PDF/A ​

Ejemplo de código completo ​

Validación ​

Diagrama de flujo de trabajo ​

Lectura adicional ​