Crear factura ZUGFeRD en n8n

Q: What is ZUGFeRD and how does it differ from XRechnung and Factur-X?

ZUGFeRD is the German hybrid e-invoicing standard, a PDF/A-3 document with embedded structured XML invoice data readable by both humans (the PDF) and machines (the XML). XRechnung is the German public sector profile, used for invoices to federal, state, and municipal authorities; it is a stricter pure-XML profile but is also available as a ZUGFeRD conformance level. Factur-X is the French sister format that uses the exact same hybrid PDF/A-3 + XML structure as ZUGFeRD 2.x and is fully compatible. Choose ZUGFeRD 2.x with EN16931 conformance for general B2B use, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for cross-border French-German invoicing.

Lo que hace este nodo

PDF4me Crear factura de Zugferd genera totalmente conforme Facturas electrónicas híbridas ZUGFeRD (Documentos PDF/A-3 con estructura XML datos de factura incrustados en su interior) directamente dentro de su n8n flujo de trabajo. Convertir XML, JSON, o CSV datos de factura en un único archivo híbrido listo para el Mandato alemán de facturación electrónica B2BCumple con la norma EN 16931 de la UE o con el perfil alemán XRECHNUNG para el sector público. Admite todas las versiones de ZUGFeRD, desde la 1.0 hasta la 2.4, y los seis niveles de conformidad en un solo nodo.

Entradas de blog relacionadas(1)

¿Cómo se crea una factura ZUGFeRD en n8n? ¡Un flujo de trabajo con Dropbox y JSON, paso a paso!

Flujo de trabajo de n8n: suba el JSON de la factura a PDF4me, cree una factura ZUGFeRD/Factur-X y, a continuación, suba el PDF generado a Dropbox. Incluye capturas de pantalla reales, mapeos y comprobaciones de salida.

Leer la publicación →

Autenticando su API Pedido

Cada PDF4me nodo en n8n requiere un válido Credencial para conectarse con. Crea o selecciona uno que contenga tu PDF4me API clave para que el flujo de trabajo pueda autenticar de forma segura las solicitudes de generación de facturas de ZUGFeRD.

Get your API Key

Datos importantes que no debes perderte

ZUGFeRD es un PDF/A-3 híbrido + XML formato, no un puro XML estándar

El resultado es un único archivo PDF/A3 de calidad de archivo. PDF con la estructurada XML factura adjunta en su interior. Los humanos leen la PDF, las máquinas analizan el XML. No hay archivos separados para enviar. Para generar puro XML sin el PDF Para encapsular, configure el Modo de salida en Solo XML; para generar el archivo híbrido, configúrelo en XML con PDF (el valor predeterminado).

La certificación ZUGFeRD 2.0+ es obligatoria para el mandato alemán B2B 2025-2028.

La Ley alemana de Oportunidades de Crecimiento (Wachstumschancengesetz) estableció la obligatoriedad de la recepción de facturas electrónicas para todas las transacciones B2B a partir del 1 de enero de 2025, con la implementación gradual de la obligación de envío completo para 2028. La versión 2.0 o superior de ZUGFeRD, conforme a la norma EN16931 o XRECHNUNG, cumple con este requisito. La versión anterior de ZUGFeRD 1.0 no lo cumple.

El nivel de conformidad controla el cumplimiento: EN16931 es el valor predeterminado seguro.

Seleccione EN16931 para la facturación B2B general en la UE (la norma europea), XRECHNUNG para facturar a entidades del sector público alemán y EXTENDED para campos específicos del sector que van más allá de la norma EN 16931. MINIMUM y BASICWL omiten las partidas y no se pueden usar para la facturación completa; solo para desgloses contables internos.

Parámetros

Requerido en el n8n Interfaz de usuario: Credenciales para conectarse, tipo de datos de entrada, nombre del documento (siempre requerido incluso cuando el tipo de datos de entrada es Ninguno, se usa como nombre de documento alternativo), modo de salida, versión de Zugferd, generar factura en PDF, idioma, formato de entrada y tipo de entrada de datos de factura. Nivel de conformidad Se muestra y se requiere en función de la rama de la versión de Zugferd, con un nombre de campo y un conjunto de opciones diferentes para 1.0 frente a 2.0/2.1/2.2/2.4 frente a Personalizado. El campo de datos de factura coincidente (Factura XML/JSON/CSV Datos, propiedad binaria, Base64 El contenido (o URL de datos) es obligatorio según el tipo de entrada de datos de la factura. La validación en tiempo de ejecución exige que el contenido de la ruta elegida no esté vacío, con errores como "Se requieren datos de la factura" o "Se requiere contenido base64 de la factura".

Parámetro	Requerido	Lo que hace	Ejemplo
Input Data Type	Conditional	How the background PDF (the visual layer of the hybrid invoice) is supplied. None creates the PDF from invoice data alone. Binary Data reads from a previous n8n node. Base64 String accepts encoded content. URL downloads from a public link.	`Binary Data`
Binary Property Name	Conditional	Name of the binary field from the previous node. Required when Input Data Type is Binary Data.	`data`
Base64 Content	Conditional	Base64-encoded PDF string. Required when Input Data Type is Base64 String.	`JVBERi0xLjQK...`
File URL	Conditional	Public URL to the source PDF. Required when Input Data Type is URL.	`https://example.com/invoice.pdf`
Document Name	Yes	Filename of the source PDF document. Always required in the UI, including when Input Data Type is None (used as document name fallback in the payload). Include the .pdf extension.	`invoice.pdf`
Output Mode	Yes	XML Only generates a pure XML file. XML With PDF generates the full hybrid ZUGFeRD file: a PDF/A-3 document with structured XML embedded inside. XML With PDF is the canonical ZUGFeRD output.	`XML With PDF`
Zugferd Version	Yes	ZUGFeRD specification version. 1.0 is legacy and does not satisfy the German B2B mandate. 2.0 through 2.4 all support EN 16931. 2.2 and 2.4 add the latest XRECHNUNG profile updates. Custom enables advanced version handling.	`2.0`
Zugferd Version Custom	Conditional	Custom ZUGFeRD version identifier. Shown and required only when Zugferd Version is Custom (the execute step throws if empty).	`2.3.1`
Conformance Level	Conditional	Profile controlling which invoice fields are required. Shown when Zugferd Version is 1.0 (legacy options). Switches to Conformance Level (Above 2) for versions 2.0/2.1/2.2/2.4 and Custom (MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG).	`EN16931`
Language	Yes	Display language for invoice labels in the rendered PDF. Options: German, French, Italian, English, Spanish, Dutch, Polish, Portuguese. The XML data itself remains language-neutral.	`German`
Render Invoice On PDF	Yes	Toggle (ON/OFF). When enabled, PDF4me visually renders the invoice content on the PDF using your invoice data. When disabled, only the structured XML is generated and embedded, useful when you supply a pre-designed background PDF.	`true`
Input Format	Yes	Format of the invoice data you are providing. XML for pre-built ZUGFeRD XML or UBL data. JSON for structured invoice objects. CSV for tabular batch exports.	XML sample XML 2.0 sample JSON 2.0 EN16931 sample JSON (basic)CSV sample CSV 2.0 sample
Invoice Data Input Type	Yes	How the invoice data reaches the node. Direct Text accepts pasted or mapped data inline. Binary Data reads from a previous file node. Base64 String for encoded payloads. URL downloads from a public link.	`Direct Text`
Invoice XML / JSON / CSV Data	Conditional	The actual invoice content. Appears as Invoice XML Data, Invoice JSON Data, or Invoice CSV Data, matching the chosen Input Format. Required when Invoice Data Input Type is Direct Text. Runtime also throws "Invoice … data is required" if empty.	XML sample XML 2.0 sample JSON 2.0 EN16931 sample JSON (basic)CSV sample CSV 2.0 sample`Paste, map, or load via Binary / Base64 / URL to match the format you chose above.`
Invoice Binary Property Name	Conditional	Name of the binary field holding the invoice data file. Required when Invoice Data Input Type is Binary Data.	`data`
Invoice Base64 Content	Conditional	Base64-encoded invoice data. Required when Invoice Data Input Type is Base64 String. Runtime also throws "Invoice base64 content is required" if empty.	`PGludm9pY2U+...`
Invoice Data URL	Conditional	Public URL to the invoice data file. Required when Invoice Data Input Type is URL.	`https://example.com/invoice.json`
Output File Name	No	Filename for the generated ZUGFeRD invoice. Default provided and normalized in execute (e.g. extension matched to Output Mode). Use .pdf for XML With PDF and .xml for XML Only.	`zugferd_invoice.pdf`
Output Binary Field Name	No	Name of the binary field holding the generated ZUGFeRD file. Defaults to data. Used to reference the file in subsequent workflow nodes.	`data`

Archivos de facturas de muestra

Utilice estos archivos de ejemplo para probar el nodo con cada formato de entrada antes de conectar su fuente de datos en vivo. Para flujos de trabajo de producción B2B alemanes, comience con sample-invoice-zugferd-2.0-en16931.json (ZUGFeRD 2.0, EN16931 conformidad).

ESPOSADO XML Muestra

ZUGFeRD 1.0 BÁSICO XML. Usar con Formato de entrada: XML. Pegar o mapear en Factura XML Datos.

Ejemplo de factura ZUGFeRD.xml

ZUGFeRD 2.0

ZUGFeRD 2.0 XML Muestra (EN16931)

ZUGFeRD 2.0 EN16931 XML con partes vendedor/comprador, partidas, IVA y suma monetaria en formato CrossIndustryInvoice. Utilizar con Formato de entrada: XML, Versión de ZUGFeRD: 2.0, Conformidad: EN16931.

ZUGFeRD-invoice-sample-2.0.xml

Recomendado

JSON 2.0 Muestra EN16931

Factura estructurada completa para ZUGFeRD 2.0 con EN16931 conformidad. Utilizar con Formato de entrada: JSON, Zugferd Versión: 2.0, Nivel de conformidad: EN16931. Pegar o mapear en Factura JSON Datos.

sample-invoice-zugferd-2.0-en16931.json

JSON Ejemplo de factura (básica)

Más sencillo JSON para pruebas de humo con ZUGFeRD 1.0 y BÁSICO conformidad.

factura de muestra.json

CSV Ejemplo de factura

Departamento CSV fila para Formato de entrada: CSV. Pegar o mapear en Factura CSV Datos.

factura-de-prueba.csv

ZUGFeRD 2.0

CSV 2.0 Ejemplo de factura

Extendido a 22 columnas CSV: InvoiceId, IssueDate, campos de dirección del vendedor/comprador, SellerVatId, ProductId, Currency, PaymentReference, IBAN, BIC. Usar con Formato de entrada: CSV, ZUGFeRD 2.0.

zugferd-invoice-2.0.csv

Opciones avanzadas

Todos los campos dentro del Opciones avanzadas Las colecciones son opcionales. Agréguelas a través de Agregar opción en la interfaz de usuario del nodo.

perfiles

Costumbre PDF4me Perfiles de procesamiento. Aplique conjuntos de opciones preconfiguradas para la generación de facturas ZUGFeRD avanzadas o especializadas (por ejemplo, reglas de validación personalizadas, asignaciones de esquemas alternativos o ajuste de salida específico del sector).

Opciones de tipo de datos de entrada

Controla cómo el fondo PDF documento (la capa visual de la factura híbrida) se proporciona al nodo.

Menú desplegable Tipo de datos de entrada en el nodo Crear factura Zugferd de n8n PDF4me que muestra cuatro opciones: Ninguno con la descripción No se requiere entrada de documento (solo XML/JSON/CSV), Datos binarios resaltados con la descripción Usar archivo del nodo anterior, Cadena Base64 con la descripción Proporcionar el contenido del archivo como una cadena codificada en base64 y URL con la descripción Proporcionar la URL del archivo — Menú desplegable Tipo de datos de entrada: controla cómo se muestra el fondo PDF llega al nodo

NingunoSolo XML/JSON/CSV, sin PDF de fondo

No es necesario introducir ningún documento. PDF4me genera tanto lo visual PDF capa y estructurada XML a partir únicamente de los datos de la factura. Utilice esto cuando solo existan los datos de la factura y desee PDF4me para renderizar el archivo híbrido completo.

Datos binariosArchivo del nodo anterior (lo más común)

Lee los antecedentes PDF binario directamente desde la salida de un programa anterior n8n nodo: Descarga de Google Drive, HTTP Solicitar o leer archivo binario. El campo Propiedad binaria especifica qué campo de salida leer (predeterminado) datos).

Cadena Base64Contenido del archivo codificado en Base64

Acepta el fondo PDF como una cadena codificada en base64. Utilice esto cuando el archivo llegue desde un API respuesta, carga útil del webhook o una columna de base de datos que almacena documentos como base64.

URLDescargar desde un enlace público

Proporcionar un acceso público URL al fondo PDF. PDF4me descarga el archivo directamente antes de generar la factura híbrida. URL No debe requerir autenticación.

Opciones de modo de salida

Controla si el nodo produce un puro XML archivo o el híbrido completo ZUGFeRD (PDF/A-3 + incrustado) XML).

Menú desplegable Modo de salida en el nodo Crear factura de Zugferd de n8n PDF4me que muestra dos opciones: XML Only with description Generar solo el archivo XML, y XML With PDF resaltado con la descripción Generar XML incrustado en el PDF. — Menú desplegable Modo de salida con dos opciones: puro XML o PDF/A-3 híbrido con XML incorporado

Solo XMLPuro XML, No PDF envoltorio

Solo genera la estructurada XML datos de factura. Utilizar cuando el sistema receptor procesa el XML directamente y descarta el contenido visual, para envíos XRechnung puro-XML, o para probar la capa de datos de forma aislada. Establezca la extensión del nombre del archivo de salida en .xml.

XML con PDFPredeterminado: archivo híbrido ZUGFeRD completo

Genera la factura híbrida estándar ZUGFeRD: un archivo PDF/A-3 de calidad de archivo. PDF con la estructurada XML Los datos de la factura están incrustados como un archivo adjunto. Los humanos leen el PDF, las máquinas analizan el XMLEste es el formato de salida canónico de ZUGFeRD para la facturación electrónica B2B de producción.

Opciones de versión de ZUGFeRD

La versión de la especificación ZUGFeRD integrada en la factura generada.

Menú desplegable de versión de Zugferd en el nodo Crear factura de Zugferd de n8n PDF4me que muestra las opciones: 1.0, 2.0 resaltadas, 2.1, 2.2, 2.4 y Personalizada, con información sobre herramientas que muestra el parámetro: zugferdVersion. — Menú desplegable de versiones de ZUGFeRD con seis opciones de versión, incluyendo la versión anterior 1.0 y la última versión 2.4.

1.0Legado: no cumple con el mandato de 2025.

Especificación original de 2014. Compatible solo con sistemas receptores heredados. no Cumplir con la normativa alemana de facturación electrónica B2B vigente a partir de 2025. Evitar su uso en nuevos flujos de trabajo.

2.0Predeterminado: amplia compatibilidad

La primera versión alineada con la norma EN 16931 (2019). Cumple con la normativa alemana B2B y es la opción predeterminada segura para la facturación B2B general. Totalmente compatible con Factur-X 1.0.

2.1Pequeños ajustes

Agrega pequeñas mejoras y aclaraciones al esquema con respecto a la versión 2.0. Úselo cuando su sistema receptor requiera específicamente la versión 2.1.

2.2Perfil XRECHNUNG actualizado

Compatible con la versión 2.x del perfil XRECHNUNG actualizado. Seleccione esta opción al facturar a entidades del sector público alemán que requieran el perfil más reciente.

2.4Últimas novedades: compatibilidad con XRECHNUNG.

Especificación más reciente. Incluye compatibilidad con las mejoras más recientes del perfil y el esquema XRECHNUNG. Seleccione esta opción cuando el destinatario requiera la última versión.

CostumbreManejo avanzado de versiones

Permite la gestión de versiones personalizadas cuando un sistema receptor específico requiere un identificador de versión no estándar. Úselo únicamente cuando su contraparte de facturación lo indique explícitamente.

Opciones de nivel de conformidad

El perfil de conformidad controla qué campos de la factura son obligatorios y se validan, siendo esta la decisión más importante para garantizar el cumplimiento normativo.

Menú desplegable Nivel de conformidad en el nodo Crear factura Zugferd de n8n PDF4me que muestra seis opciones: MÍNIMO, BÁSICOWL, BÁSICO, EN16931 resaltado, EXTENDIDO y XRECHNUNG. — Menú desplegable de nivel de conformidad con seis perfiles, desde MÍNIMO hasta EXRECHNUNG, que controla los requisitos de campo y el alcance del cumplimiento.

MÍNIMOSolo el encabezado, no es una factura válida.

Solo datos de cabecera: partes, totales, referencias de documentos. Sin partidas individuales. No puede utilizarse como factura legal; solo para registros contables internos o notificaciones de estado.

BASICWLBásico sin líneas: solo IVA

Agrega desgloses de IVA/impuestos además del MÍNIMO. Todavía Sin partidas individuales. Se utiliza para situaciones en las que las facturas se concilian con los pedidos, y no como facturas legales independientes.

BÁSICOFactura legal mínima

Agrega partidas adicionales a BASICWL. Cumple con los requisitos mínimos de la directiva europea de facturación electrónica. Es aceptable para facturas sencillas, pero la norma EN16931 es la opción más segura para garantizar el cumplimiento total en el ámbito B2B.

EN16931Predeterminado: Estándar europeo

Perfil completo de la norma europea EN 16931. Configuración predeterminada recomendada para la facturación B2B en toda la UE. y el nivel de conformidad al que hace referencia el mandato alemán de 2025. Incluye todos los campos necesarios para la facturación comercial conforme a la normativa.

EXTENDIDOExtras específicos del sector

Añade campos específicos del sector, más allá de la norma EN 16931, como referencias adicionales sobre logística, transporte o sectores. Úselo cuando su acuerdo sectorial o socio comercial requiera los campos AMPLIADOS.

XRECHARGEObligatorio para el sector público alemán

El perfil alemán XRechnung CIUS, Obligatorio para las facturas a las autoridades federales, estatales y municipales alemanas. Validación más estricta que la norma EN16931. Utilizar siempre que el receptor sea una entidad del sector público alemán.

Opciones de idioma

Idioma de visualización para las etiquetas de factura en la representación PDF capa. La XML Los datos en sí mismos son independientes del idioma.

Menú desplegable de idiomas en n8n Create Zugferd Invoice que muestra alemán, francés, italiano, inglés, español, neerlandés, polaco y portugués. — **Idioma**: etiquetas localizadas para el renderizado PDF (El alemán es típico para B2B y B2G en Alemania).

AlemánPredeterminado, alemán B2B/B2G

InglésFacturación internacional

FrancésFlujos de trabajo de Factur-X

italianoB2B italiano

EspañolB2B español

HolandésPaíses Bajos/Bélgica

PolacoPolonia B2B

portuguésPortugal/Brasil

Opciones de formato de entrada

Formato de los datos de la factura que usted proporciona al nodo.

Menú desplegable Formato de entrada en n8n Crear factura Zugferd que muestra las opciones XML, JSON y CSV con JSON seleccionado. — **Formato de entrada**: elegir `XML`, `JSON`, o `CSV` para que coincida con la carga útil de su factura.

XMLPrefabricado XML factura

Suministre documentos ya formateados que cumplan con el estándar ZUGFeRD. XML o UBL XML datos. Úselo cuando su ERP ya produce estándar XML facturas que solo necesitan envolverse en el híbrido PDF.

JSONPredeterminado: moderno API fuente

Datos de facturas de suministro como un formato estructurado JSON objeto. La opción más común cuando los datos de la factura llegan desde un webhook, REST APIo software de contabilidad moderno. PDF4me mapas JSON campos al ZUGFeRD XML esquema automáticamente.

CSVDatos tabulares de facturas por lotes

Suministrar datos de factura como CSV, útil para la exportación por lotes de facturas desde hojas de cálculo, sistemas heredados o escenarios de facturación masiva. PDF4me mapas CSV columnas al esquema ZUGFeRD.

Opciones de tipo de entrada de datos de factura

Controla cómo se procesan los datos de la factura (el XML, JSON, o CSV contenido) llega al nodo.

Menú desplegable Tipo de entrada de datos de factura en n8n Crear factura Zugferd que muestra las opciones Texto directo, Datos binarios, Cadena Base64 y URL. — **Tipo de entrada de datos de factura**: cómo el XML, JSON, o CSV La carga útil se proporciona (en línea, binario de un nodo anterior, base64 o URL).

Texto directoPredeterminado: pegar o mapear en línea

Pegue o asigne los datos de la factura directamente en el campo Datos de la factura. Ideal para JSON o más pequeño CSV cargas útiles de nodos ascendentes. Utilizar n8n Sintaxis de expresiones para construir los datos de forma dinámica.

Datos binariosArchivo del nodo anterior

Lee el archivo de datos de la factura (XML, JSON, o CSV) directamente desde la salida binaria de una anterior n8n nodo: Descarga de Google Drive, Leer archivo binario o HTTP Solicitud. Ideal para grandes XML archivos.

Cadena Base64Datos codificados en Base64

Acepta los datos de la factura como una cadena codificada en base64. Úselo cuando el contenido de la factura llegue desde un API Campo de respuesta o de base de datos que almacena archivos como base64.

URLDescargar desde un enlace público

Proporcionar un acceso público URL al archivo de datos de la factura. PDF4me Descarga el archivo y analiza su contenido según el formato de entrada seleccionado.

Campos de salida

Campo	Tipo	Lo que contiene
`fileName`	String	Filename of the generated ZUGFeRD invoice, for example zugferd_invoice.pdf for XML With PDF output or zugferd_invoice.xml for XML Only output.
`mimeType`	String	MIME type of the output file: application/pdf for hybrid output, application/xml for XML Only. Useful for content type validation in downstream HTTP or storage nodes.
`fileSize`	Number	Size of the generated ZUGFeRD file in bytes. Useful for storage planning, bandwidth monitoring, and conditional routing in the workflow.
`success`	Boolean	True when the ZUGFeRD invoice was generated successfully. False if validation failed or input data was malformed. Use this field to route error handling branches.
`message`	String	Human-readable status message confirming success or describing the validation/parsing error encountered. Useful for logging and error notification steps.

Configuración rápida

Agregar PDF4me a tu n8n flujo de trabajo. Establecer Recurso a Factura y Operaciones de facturación a Crear factura de Zugferd.
En Credencial para conectarse con, seleccione su PDF4me credenciales o haga clic Crear nueva credencial y pega tu API llave.
Colocar Tipo de datos de entrada: conectar un nodo anterior (datos binarios), proporcionar un Base64 cadena o URL para el fondo PDFo seleccione Ninguno cuando PDF4me debería hacer el PDF a partir únicamente de los datos de facturación.
Ingresar Nombre del documento (Por ejemplo invoice.pdf).
Colocar Modo de salida: XML con PDF para la salida híbrida estándar ZUGFeRD, o Solo XML para puro XML.
Elegir Versión Zugferd (usar 2.0 como opción predeterminada segura; 2.4 para el perfil XRECHNUNG más reciente).
Elegir Nivel de conformidad: EN16931 para B2B en general, XRECHARGE para la facturación del sector público alemán, EXTENDIDO para campos específicos de la industria.
Colocar Idioma para el renderizado PDF etiquetas (alemán por defecto).
Permitir Generar factura en PDF si quieres PDF4me para mostrar visualmente el contenido de la factura; desactive esta opción cuando proporcione un fondo prediseñado. PDF.
Elegir Formato de entrada (JSON, XML, o CSV) y Tipo de entrada de datos de factura (Texto directo, datos binarios, cadena Base64 o URL). Pegue o introduzca los datos de la factura en el campo Datos de la factura.
Colocar Nombre del archivo de salida a zugferd_invoice.pdf y Nombre del campo binario de salida a data.
Conecte la salida a su siguiente nodo (remitente de correo electrónico, carga de almacenamiento en la nube, portal gubernamental). HTTP POST) y ejecutar el flujo de trabajo.

Ejemplos de flujo de trabajo

Ejemplos de flujo de trabajoCommon n8n workflow patterns using Create Zugferd Invoice.

Software de contabilidad → ZUGFeRD 2.0 EN16931 factura → enviar correo electrónico al cliente

Un activador de webhook se dispara cuando se finaliza una factura en la plataforma de contabilidad (DATEV, sevDesk, lexoffice).
La carga útil del webhook contiene datos de factura como una estructura JSON objeto.
PDF4me Crear factura Zugferd genera la factura híbrida. El tipo de datos de entrada es Ninguno (PDF4me hace que el PDF del JSON). El modo de salida es XML con PDF, la versión de Zugferd es 2.0, el nivel de conformidad es EN16931, el idioma es alemán, el formato de entrada es JSONEl tipo de entrada de datos de la factura es Texto directo mapeado desde la carga útil del webhook.
Un nodo de Gmail envía un correo electrónico a ZUGFeRD. PDF a la dirección de cuentas por pagar del cliente, cumpliendo así con el requisito alemán de mandato de recepción B2B.
Un nodo PostgreSQL registra el número de factura, la versión de ZUGFeRD y el nivel de conformidad para la elaboración de informes de auditoría y cumplimiento.

ERP XML factura → ZUGFeRD XRECHNUNG → subir al portal del sector público

Un disparador programado se activa todos los días laborables a las 16:00 para procesar las facturas del sector público.
Un nodo SFTP extrae los datos recién generados. ERP XML Archivos de facturas de la carpeta de exportación.
PDF4me Crear factura Zugferd genera una factura XRECHNUNG conforme. El tipo de datos de entrada es Ninguno, el modo de salida es XML con PDF, la versión de Zugferd es 2.4 (último perfil XRECHNUNG), el nivel de conformidad es XRECHNUNG, el idioma es Alemán, el formato de entrada es XMLEl tipo de entrada de datos de factura es Datos binarios mapeados desde el contenido del archivo SFTP.
Un HTTP El nodo de solicitud carga la factura XRECHNUNG en la plataforma federal ZRE (Plataforma Central de Recepción de Facturas del Gobierno Federal) o en el portal estatal correspondiente.
Un Microsoft Outlook El nodo envía una confirmación al equipo de adquisiciones y un nodo PostgreSQL registra la referencia de la solicitud.

Mensual CSV lote de facturación → facturas ZUGFeRD → archivar en SharePoint

Un activador programado se ejecuta el primer día de cada mes para procesar la facturación mensual.
Un nodo de Google Drive descarga el archivo consolidado. CSV Exportación de facturación, una fila por factura de cliente.
Un nodo Split In Batches itera sobre cada CSV fila. PDF4me Crear factura Zugferd genera una factura ZUGFeRD por cliente. El tipo de datos de entrada es Ninguno, el modo de salida es XML con PDF, la versión de Zugferd es 2.0, el nivel de conformidad es EN16931, el idioma varía según la configuración regional del cliente, el formato de entrada es CSVEl tipo de entrada de datos de la factura es Texto directo con contenido CSV por fila.
Un Microsoft SharePoint El nodo sube cada ZUGFeRD PDF a la carpeta de archivo de facturación del cliente.
Un nodo de Gmail envía a cada cliente su factura híbrida; una fila de resumen final de PostgreSQL registra la ejecución del lote con el número de facturas y el importe total.

Preguntas frecuentes

What is ZUGFeRD and how does it differ from XRechnung and Factur-X?+

ZUGFeRD is the German hybrid e-invoicing standard: a PDF/A-3 archival-grade PDF with structured XML invoice data embedded inside as an attachment. Humans read the visual PDF and machines parse the embedded XML, so a single file serves both audiences. XRechnung is the German public-sector profile, mandatory when invoicing federal, state, or municipal authorities; it can be issued as pure XML or as a ZUGFeRD conformance level. Factur-X is the French sister format that uses the identical hybrid PDF/A-3 + XML structure as ZUGFeRD 2.x and is fully interoperable. Use ZUGFeRD 2.x with EN16931 for general B2B, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for cross-border French-German invoicing.

Which ZUGFeRD version should I use in 2025 for the German B2B e-invoicing mandate?+

ZUGFeRD 2.0 or higher is required to comply with the German B2B e-invoicing mandate. The mandate, enacted under the Wachstumschancengesetz (Growth Opportunities Act), made e-invoice receipt mandatory from 1 January 2025 and phases in full sending obligations by 2028. Versions 2.0 through 2.4 all comply with EN 16931, the European standard the mandate references. ZUGFeRD 2.2 and 2.4 add support for the newer XRECHNUNG profile updates. Legacy ZUGFeRD 1.0 does not satisfy the mandate. Default to 2.0 for broad compatibility across receiving systems, or 2.4 when the latest XRECHNUNG profile is required.

What is the difference between MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, and XRECHNUNG conformance levels?+

MINIMUM contains only the absolute minimum invoice header data (totals and parties) and cannot serve as a legal invoice; it is for internal accounting drop-offs only. BASICWL (Basic Without Lines) adds VAT and tax breakdowns but still has no line items. BASIC adds line items and meets the absolute minimum of the EU e-invoicing directive. EN16931 is the European Standard EN 16931 profile, recommended as the default for B2B invoicing across the EU and the level the German mandate references. EXTENDED adds industry-specific fields beyond EN 16931. XRECHNUNG is the German public-sector mandatory profile, required when invoicing federal, state, or municipal authorities. Use EN16931 for general B2B, XRECHNUNG for public sector, EXTENDED for industry-specific scenarios.

What is the difference between XML Only and XML With PDF output modes?+

XML Only generates a pure XML file containing the structured invoice data, useful when the receiving system processes only the XML and discards visual content, for XRechnung pure-XML submissions, or for testing the data layer in isolation. XML With PDF generates the full ZUGFeRD hybrid invoice: a PDF/A-3 archival document with the XML embedded as an attachment inside the PDF. The hybrid format is the canonical ZUGFeRD output and is required when both human readability and machine processing must be supported by a single file. Choose XML With PDF for production e-invoicing workflows and XML Only for data-layer integration testing or pure-XML public-sector submissions.

Can I generate ZUGFeRD invoices from CSV data, and what does Invoice Data Input Type control?+

Yes. The Input Format parameter supports XML, JSON, and CSV; pick the format matching your data source. Invoice Data Input Type then controls how the data reaches the node: Direct Text lets you paste or map the data inline (best for JSON or small CSV from upstream nodes), Binary Data reads from a previous file node (best for large XML files), Base64 String accepts encoded content (best for API payloads), and URL downloads the data file from a public link. CSV input is automatically mapped to the ZUGFeRD XML schema by PDF4me before being embedded in the output PDF; no manual XML construction is required.