Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Crea una factura electrónica ZUGFeRD 2.0+ en Make: un flujo de trabajo de Dropbox de 4 módulos.

· 22 min de lectura
Sankalp Mishra
SEO and Content Writer

ZUGFeRD 2.0+ (también conocido como Factura-X en Francia y XRechnung en el sector público alemán) es un Factura híbrida PDF/A-3 con el XML legible por máquina incrustado dentro del PDF. Un archivo que tanto los humanos como los sistemas ERP pueden consumir. Esta guía describe el proceso exacto que se muestra en las capturas de pantalla: una factura base en PDF y un XML ZUGFeRD 2.0+ en Dropbox se convierten en una factura electrónica híbrida compatible con EN16931 en /pdf4meoutput/, en 4. Crea módulos, sin código..

El panorama general
1. Dropbox Download (PDF)
Pulls the base invoice PDF (/pdf4metest/Zugfred Invoice/SimplePdf.pdf). Scheduled trigger shown.
2. Dropbox Download (XML)
Pulls the ZUGFeRD 2.0+ XML invoice data (/pdf4metest/Zugfred Invoice/version2.xml).
3. PDF4me Create a ZUGFeRD invoice
Input Format XML, Output Mode XML With PDF, ZUGFeRD Version 2+, Conformance EN16931, Render Yes, Language de.
4. Dropbox Upload
Writes the hybrid PDF/A-3 e-invoice to /pdf4meoutput/ using File set to Map.
La versión corta

Cuatro módulos Make de principio a fin. Dos Dropbox Descargar un archivo Los pasos extraen el PDF base y el XML ZUGFeRD 2.0+ (las capturas de pantalla muestran YnooxTestone conexión más caminos /pdf4metest/Factura de Zugfred/SimplePdf.pdf y /pdf4metest/Factura de Zugfred/versión2.xml). PDF4me Crear una factura ZUGFeRD incrusta el XML en el PDF con Modo de salida XML con PDF, Versión ZUGFeRD 2+, Nivel de conformidad EN16931, Generar factura en PDF Sí, Idioma deDropbox Subir un archivo escribe el resultado PDF híbrido/A-3 a /pdf4meoutput/ con el archivo configurado en Mapa, Nombre del archivo 15. Nombre, Datos 15. DocumentoEl resultado se abre en cualquier lector de PDF y se analiza correctamente en cualquier ERP que admita ZUGFeRD / Factur-X / XRechnung.

Dos cosas que determinan si su ERP acepta la factura

Primero, el Nivel de conformidad Debe coincidir con lo que espera el sistema ERP de su comprador o destinatario. EN16931 (Comfort) es la opción legal predeterminada en Alemania y la elección segura para las transacciones B2B en la UE; XRECHARGE Es un requisito para la facturación B2G (sector público) en Alemania; BÁSICO funciona para la mayoría de los demás compradores. En segundo lugar, el Versión ZUGFeRD debe ser 2+ para todo lo que se ajuste a la norma EN 16931. Legado 1.0 Utiliza BASIC / COMFORT / EXTENDED y es incompatible con receptores EN 16931. Seleccionar 2+ a menos que el destinatario solicite explícitamente 1.0.

Esto resuelve preguntas comunes del mundo real.​

La gente busca este problema exacto con frases como:

  • "¿Cómo puedo crear una factura ZUGFeRD con XML incrustado en Make?" Este escenario de 4 módulos lo hace de principio a fin: plantilla PDF más factura XML de entrada, PDF híbrido/A-3 de salida.
  • "¿Es ZUGFeRD lo mismo que Factur-X?" Sí. El mismo formato técnico con nombres diferentes. Los sistemas que esperan un archivo Factur-X aceptan un archivo ZUGFeRD 2.x y viceversa.
  • "¿Qué nivel de conformidad debo elegir?" EN16931 para B2B (coincide con la normativa legal alemana y la norma europea EN 16931), XRECHNUNG para el sector público alemán (B2G), BASIC para la mayor compatibilidad con sistemas heredados.
  • "¿Necesito escribir el XML yo mismo?" No, pero para este caso las capturas de pantalla utilizan una factura XML existente. El módulo también acepta entrada JSON o CSV y genera el XML automáticamente.
  • "¿Qué ocurre si mi comprador solo necesita el XML, no el PDF?" Establecer modo de salida en XML Only y el módulo devuelve solo el archivo de factura XML en lugar del híbrido.

Lo que estás construyendo​

Un escenario de Make reutilizable que genera una factura electrónica híbrida ZUGFeRD 2.0+ totalmente compatible a partir de un archivo PDF base y un archivo XML. El activador puede ser manual, programado (como se muestra), mediante la monitorización de archivos de Dropbox o mediante un webhook HTTP. El resultado es un único archivo que cumple con los requisitos de PDF legible para humanos y XML legible por máquina, conforme a las normativas de facturación electrónica de la UE.

Crear lienzo de escenario: Dropbox Descargar un archivo (PDF, con indicador de tiempo programado) conectado a un segundo Dropbox Descargar un archivo (XML), conectado a PDF4me Crear una factura ZUGFeRD, conectado a Dropbox Cargar un archivo. Cada módulo muestra un contador de 1 iteración y una marca de verificación verde que indica una ejecución exitosa.

Cuatro módulos completos. Dos descargas, una acción de PDF4me y una carga. El icono del reloj en el Módulo 1 indica una activación programada; cambie a manual, monitorización de archivos o webhook según sus necesidades.

Lo que necesitas​

  • Hacer cuenta con un escenario abierto. Crear una cuenta de Make Si necesitas uno.
  • Clave API de PDF4me. Obtén tu clave API y conéctese al primer módulo de PDF4me. Ver Conectar PDF4me para crear.
  • Dropbox con una carpeta de origen (por ejemplo, /pdf4metest/Factura de Zugfred/) que contiene la plantilla PDF y la factura XML, además de una carpeta de salida (/pdf4meoutput/).
  • Un PDF base (las capturas de pantalla usan SimplePdf.pdf). No necesita ningún marcado de diseño. El módulo inserta el XML como un archivo adjunto PDF/A-3.
  • Una factura XML de ZUGFeRD 2.0+. Usa el tuyo o toma uno Ejemplo XML 2.0 para seguir la conversación.

Referencia rápida: qué hace cada parámetro​

Input Format
XML for existing ZUGFeRD XML, JSON for structured JSON, CSV for tabular invoice rows.
Output Mode
XML With PDF returns the hybrid PDF/A-3 (recommended). XML Only returns just the XML invoice file.
ZUGFeRD Version
2+ for EN 16931 alignment (use this). 1.0 is legacy with BASIC / COMFORT / EXTENDED only.
Conformance Level
2+ supports MINIMUM, BASICWL, BASIC, EN16931 (Comfort, default), EXTENDED, XRECHNUNG (German B2G).
Render Invoice on PDF
Yes draws the invoice line items visually on the PDF. Only takes effect when Output Mode is XML With PDF.
Language
Two-letter ISO code: de (default), en, fr, it, es, nl, pl, pt, cs. Controls label localisation on the rendered PDF.

Construye el escenario​

Módulo 1: Descargar un archivo de Dropbox (PDF base)​

Descargue el PDF de origen donde se insertará el XML de ZUGFeRD como un archivo adjunto PDF/A-3.

CampoValor utilizado en esta ejecución
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/SimplePdf.pdf
Configurar Dropbox Download a File para el PDF base. Conexión YnooxTestone. Forma de seleccionar archivos Seleccionar un archivo. Ruta del archivo /pdf4metest/Zugfred Invoice/SimplePdf.pdf.

Módulo 2: Descarga de archivos en Dropbox (ZUGFeRD 2.0+ XML)​

Descargue el archivo XML de la factura de ZUGFeRD. El XML contiene todos los detalles de la factura; el PDF es solo la representación visual.

CampoValor utilizado en esta ejecución
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/version2.xml
Configurar Dropbox Download a File para ZUGFeRD 2.0+ XML. Conexión YnooxTestone. Forma de seleccionar archivos Seleccionar un archivo. Ruta del archivo /pdf4metest/Zugfred Invoice/version2.xml.

Módulo 3: PDF4me Crear una factura ZUGFeRD​

La acción que realiza la incrustación propiamente dicha. Asigne ambos archivos descargados como entradas, seleccione la configuración de conformidad y ejecute.

GrupoCampoValor
AuthConnectionClassify Documen (testva...). PDF4me connection
SourceFile (PDF template)Map → Module 1 File Name + Data
SourceInput FormatXML
SourceFile (XML invoice)Map → Module 2 File Name + Data (a second File picker appears when Input Format is XML)
OutputOutput ModeXML With PDF (hybrid PDF/A-3)
OutputZUGFeRD Version2+
OutputConformance LevelEN16931
OutputRender Invoice on PDFYes
OutputLanguagede

Módulo 4: Cargar un archivo en Dropbox​

Guarde la factura electrónica híbrida en formato PDF/A3 en la carpeta de salida.

CampoValor utilizado en esta ejecución
ConnectionYnooxTestone (ynoox.test...)
Folder/pdf4meoutput/
FileMap (so File Name and Data come from the PDF4me step)
File Name15. Name (dynamic content from PDF4me Module 3)
Data15. Document (dynamic content from PDF4me Module 3)
Configurar Dropbox Upload a File. Conexión YnooxTestone. Carpeta /pdf4meoutput/. Archivo configurado en Map. Nombre de archivo vinculado a 15. Nombre (de PDF4me Create a ZUGFeRD invoice). Datos vinculados a 15. Documento.

Guardar y hacer clic Correr una vez. El híbrido PDF/A-3 aterriza en /pdf4meoutput/ en un par de segundos.

Get your API KeyFull action reference

Archivos de ejemplo (XML, JSON, CSV)​

Puede sustituir el Módulo 2 (XML) por cualquiera de estas entradas y cambiar Formato de entrada respectivamente.

Solución de problemas​

Conformance Level dropdown shows different options than expected
You toggled between Versions. Version 1.0 has BASIC, COMFORT, EXTENDED. Version 2+ has Empty, MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Pick the version first; conformance levels follow.
Second File picker did not appear when Input Format is XML
It only appears when File is set to Map. Click the File radio and choose Map; the second File picker (for the XML invoice) renders below.
Buyer ERP rejects the hybrid PDF as non-compliant
Mismatched Conformance Level. Check what the receiver expects (commonly EN16931 for B2B EU, XRECHNUNG for German B2G). Re-run with the right value.
Output is XML only when you wanted the hybrid PDF
Output Mode is set to XML Only. Switch to XML With PDF.
Rendered invoice on PDF is missing line items
Render Invoice on PDF is set to No or Empty, or Output Mode is XML Only. Set both: Output Mode = XML With PDF AND Render Invoice on PDF = Yes.
Want JSON or CSV instead of XML as the input
Change Input Format. The Invoice XML Data / second File picker is replaced by an Invoice JSON Data or Invoice CSV Data text field, which you map from a Google Sheets, HTTP, or file-download module.

Cuándo utilizar este patrón​

B2B invoicing in the EU
EN16931 (Comfort) covers the legal default for German and EU business-to-business e-invoicing.
B2G (public-sector) Germany
XRECHNUNG is required for invoicing public authorities. Same flow, different conformance level.
Cross-border Factur-X
France and other EU markets accept ZUGFeRD 2.x as Factur-X. No format conversion needed.
ERP integration without code
Buyer ERP extracts the embedded XML automatically; no manual data entry in accounts payable.

¿Qué leer a continuación?​

Preguntas frecuentes​

What is ZUGFeRD 2.0+ and how does it differ from 1.0?+
ZUGFeRD 2.0+ aligns with the EU EN 16931 e-invoicing standard and supports the modern Conformance Level set (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG). ZUGFeRD 1.0 predates EN 16931 and uses BASIC / COMFORT / EXTENDED only. For any new integration in 2026 use 2+; 1.0 is kept for legacy buyer ERPs.
Is ZUGFeRD the same as Factur-X?+
Same technical format under different brand names. ZUGFeRD is the German designation; Factur-X is the French equivalent. Both align to EN 16931 and are cross-compatible: a ZUGFeRD 2.x invoice is accepted by Factur-X receivers and vice versa.
Which Conformance Level should I pick for a typical EU B2B invoice?+
EN16931 (also called Comfort). It is the German legal default and the safe choice for EU business-to-business invoicing. Use XRECHNUNG when invoicing German public authorities (B2G). Use BASIC only when a recipient ERP explicitly requires it.
Do I need to author the XML myself?+
No. The screenshots use an existing XML (Input Format = XML), but the module also accepts JSON or CSV. Choose Input Format = JSON or CSV and the XML is built for you. Sample JSON and CSV files are in the section above.
What if my buyer needs only the XML, no PDF?+
Set Output Mode to XML Only. The module returns just the XML invoice file without a PDF wrapper. Useful when the receiving ERP renders its own document and only consumes the structured data.
Can I render line items visually on the PDF page?+
Yes. Set Render Invoice on PDF = Yes (only effective when Output Mode is XML With PDF). The module draws the invoice items as a visual table on the PDF pages so human reviewers see the invoice content without opening the embedded XML.
Does this work in Power Automate, n8n, or Zapier?+
Yes. The PDF4me Create ZUGFeRD Invoice action is available on all four platforms with the same parameters. See the cross-platform comparison at the bottom of the Make action reference page.
Does the output PDF/A-3 work with every PDF viewer?+
Yes. PDF/A-3 is backward-compatible with all PDF readers. Human readers see the rendered invoice PDF; ZUGFeRD-aware ERPs extract the embedded XML automatically. Non-aware tools just see a normal PDF.

Comience​

Get your API KeyPDF4me on MakeAction reference