Crear ZUGFeRD Factura en Make
Crear ZUGFeRD Factura es un Make módulo por PDF4me que genera híbrido ZUGFeRD/Factur-X facturas electrónicas de CSV, JSON, o XML datos de factura. Úselo para producir un PDF/A-3 documento con legible por máquina XML incrustado en el interior, alineado con el EN 16931 Estándar europeo de facturación electrónica. Elija el nivel de conformidad y la versión de especificación que coincidan con lo que su comprador o ERP El sistema lo requiere.
Lo que hace este módulo
PDF4me. Crear un ZUGFeRD factura genera facturas electrónicas híbridas directamente dentro de su Make escenario. Proporcione datos de factura como CSV, JSON, o XML. el módulo produce un PDF/A-3 documento con un formato legible por máquina ZUGFeRD XML archivo incrustado en su interior, o un XML-solo salida para ERP sistemas que gestionan su propio renderizado. El resultado se alinea con el EN 16931 Estándar europeo de facturación electrónica y es aceptado como Factur-X En Francia y en todos los mercados de la UE. Los niveles de conformidad y la versión de las especificaciones son configurables para adaptarse exactamente a los requisitos de su comprador o destinatario del sector público.
Autenticando su API Pedido
Cada PDF4me módulo en Make requiere un válido Conexión. Crea o selecciona uno que contenga tu PDF4me API clave para que el escenario pueda llamar al servicio de generación de facturas de forma segura.
Datos importantes que no debes perderte
La salida híbrida es una PDF/A-3 documento. el ZUGFeRD XML se inserta como un archivo adjunto compatible dentro del archivo. ERP Los sistemas extraen el XML automáticamente; los humanos aún pueden abrir y leer el PDF en cualquier visor estándar. Configurar Generar factura en PDF Sí, para que los detalles de la factura se muestren visualmente en la página.
La versión 1.0 es compatible BÁSICO, COMODIDAD, EXTENDIDO. La versión 2+ se expande a MÍNIMO, BÁSICOWL, BÁSICO, EN16931, EXTENDIDO, XRECHNUNG. XRECHNUNG y EN16931 Son necesarios para la facturación del sector público en Alemania. Asegúrese siempre de que la versión y el nivel coincidan con los requisitos del sistema del comprador.
Seleccionar XML muestra el Datos XML de la factura campo; JSON muestra los datos JSON de la factura; CSV Muestra los datos CSV de la factura. Solo complete el campo que coincida con el formato elegido. Al usar XML formato, el módulo también expone un Archivo radio para que puedas tirar de la XML directamente desde Dropbox o mapeándolo desde un módulo anterior.
Cual ZUGFeRD ¿Qué versión debo usar?
El módulo admite dos versiones de especificación. La mayoría de las nuevas integraciones deberían usar la versión 2.0 o superior; la versión 1.0 se mantiene para la interoperabilidad con versiones anteriores.
ZUGFeRD 2.0+ RECOMENDADO
Especificaciones actuales. Niveles de conformidad: MÍNIMO, BASICWL, BÁSICO, EN16931 (Comodidad, la opción legal por defecto en Alemania), EXTENDIDO, XRECHARGE. Compatible con múltiples plataformas Factur-X. Emparejar con el 2.0 XML muestra, 2.0 EN16931 JSON muestra, o 2.0 CSV muestraLas capturas de pantalla que aparecen a continuación muestran la interfaz de usuario 2.0+ exactamente como se ve actualmente.
ZUGFeRD 1.0 LEGADO
Pre-EN 16931 Especificación. Niveles de conformidad: BÁSICO, COMODIDAD, EXTENDIDOÚselo solo cuando un destinatario ERP o el sistema del comprador requiere explícitamente 1.0 (raro después de 2022). Emparejar con el 1.0 XML muestra, el básico JSON muestra, o el 1.0 CSV muestraTodos los demás campos funcionan igual; solo cambia el menú desplegable del nivel de conformidad.
Comience con Conexión, luego mapea la base PDF (Nombre del archivo, Documento) y establecer Formato de entrada (aquí XML).
Con Archivo = Mapa, mapa Datos XML de la factura, colocar Modo de salida (XML con PDF o Solo XML), luego elige zugferd Versión (aquí 1.0).
Parámetros
Requerido: Conexión, Formato de entrada, Modo de salida, ZUGFeRD Versión. El campo de datos de la factura (Datos XML de la factura, Datos JSON de la factura, o Datos CSV de facturasAparecerá dinámicamente en función de la selección del formato de entrada. Solo es necesario rellenar el campo correspondiente.
¿Por qué? Archivo ¿Aparece dos veces en las capturas de pantalla de la versión 2.0+? Cuando el formato de entrada es XML y el archivo está configurado en Mapa, el módulo renderiza un segundo selector de archivos para que pueda asignar ambos (a) la base PDF el ZUGFeRD La factura debe estar integrada en, y (b) la fuente ZUGFeRD XML archivo. Ambos selectores muestran las mismas opciones de radio. Cuando el formato de entrada es JSON o CSV El segundo selector es reemplazado por el correspondiente Datos JSON de la factura o Datos CSV de facturas campo de texto.
| Parámetro | Requerido | Lo que hace | Ejemplo / Opciones |
|---|---|---|---|
| Connection | Required | PDF4me API connection used to authenticate invoice generation requests. Click Add and paste your API key if connecting for the first time. | Your PDF4me connection |
| File | Conditional | Source of the base PDF where the ZUGFeRD invoice will be embedded (when Output Mode is XmlWithPdf). Radio button with two options: Dropbox - Download a File (pulls directly from a Dropbox account without a prior download step) or Map (supplies the PDF from a prior module. Dropbox, Google Drive, OneDrive, HTTP, etc.). Choose Map for the most flexible workflow. When Map is selected, the two sub-fields below appear. | Map |
| File → File Name | Conditional | Sub-field of File (visible when Map is selected). Filename of the base PDF including the .pdf extension. Map from the prior module's filename output. for example, the File Name field of a Dropbox or Google Drive Download module. | 1. File Name |
| File → Document | Conditional | Sub-field of File (visible when Map is selected). Binary PDF content where the ZUGFeRD XML will be embedded. Map from the prior module's binary data field. typically the Data field of Dropbox, Google Drive, or OneDrive download modules. Hint shown in module: "PDF file where Zugferd invoice should be added". | 1. Data |
| Input Format | Required | Format of the invoice data being supplied. Use XML for existing ZUGFeRD XML; JSON or CSV for structured data. Hint: "Format of the invoice data being supplied. Use XML for existing ZUGFeRD XML, JSON or CSV for structured data." | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample |
| Invoice XML Data | Conditional | The ZUGFeRD XML invoice content to embed. Appears when Input Format = XML and File = Map. Hint: "Use when inputFormat is XML, please refer to our Create a ZUGFeRD invoice for guidelines." Map from a prior Dropbox download or HTTP module output. | XML sampleXML 2.0 sample3. Data (mapped) |
| Invoice JSON Data | Conditional | Structured invoice data in JSON format. Appears when Input Format = JSON. Map a JSON string from a Google Sheets, Airtable, or HTTP module. See sample JSON below. | JSON 2.0 EN16931 sampleJSON (basic)(mapped JSON string) |
| Invoice CSV Data | Conditional | Invoice row data in CSV format. Appears when Input Format = CSV. Map a CSV row from an iterator, Google Sheets, or file download module. See sample CSV below. | CSV sampleCSV 2.0 sample(mapped CSV row) |
| Output Mode | Required | XML With PDF (a.k.a XmlWithPdf in API requests) returns a PDF/A-3 file with the ZUGFeRD XML embedded inside, the standard hybrid e-invoice. XML Only (XmlOnly) returns just the XML invoice file without a PDF wrapper. Hint shown in module: "XML with PDF returns a PDF with embedded ZUGFeRD XML. XML only returns only the XML invoice file." | XML With PDF |
| ZUGFeRD Version | Required | ZUGFeRD specification version. Set to match what the recipient ERP or buyer system expects. Latest is 2+; legacy 1.0 also supported. The two have different conformance level sets (see table below). | 2+ |
| Conformance Level | Optional | ZUGFeRD conformance profile. Available levels differ by version. For 2+, EN16931 (Comfort) is the default for German legal e-invoicing compliance. See the Conformance Level Reference table below. Defaults to BASIC if not specified. | EN16931 |
| Render Invoice on PDF | Optional | When set to Yes, invoice line items are drawn visually on the PDF pages. Applies only when Output Mode is XmlWithPdf. Options: Yes, No, Empty. Hint: "Render invoice data visually on PDF pages. Applies only when outputMode is XmlWithPdf." | Yes |
| language | Optional | Two-letter locale code for invoice label localisation. Supported: de, en, fr, it, es, nl, pl, pt, cs. Hint: "Language code for invoice localisation (e.g. de, en, fr, it, es, nl, pl, pt, cs). Defaults to de if not specified." | de |
Referencia del nivel de conformidad
Los niveles de conformidad disponibles difieren por zugferd VersiónSiempre adapte el nivel a lo que su comprador o ERP El sistema lo requiere.
| Nivel | Utilizar cuando |
|---|---|
BASIC | Mandatory EN 16931 fields only. Widest compatibility, safe default. |
COMFORT | Adds optional fields for line-item detail and additional references. |
EXTENDED | Full field set for complex B2B invoices with delivery, allowances, and charges. |
| Nivel | Utilizar cuando |
|---|---|
MINIMUM | Absolute minimum fields. Buyer reference and totals only. |
BASICWL | BASIC without line items. Header-level data only. |
BASIC | Mandatory EN 16931 fields. Recommended starting point. |
EN16931 | Full EN 16931 compliance for cross-border and public sector. |
EXTENDED | Full field set including German-specific extensions. |
XRECHNUNG | German public-sector e-invoice mandate (XRechnung profile). |
Archivos de facturas de muestra
Utilice estos archivos de muestra para probar el módulo 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).
Ejemplo de factura ZUGFeRD.xmlZUGFeRD-invoice-sample-2.0.xmlsample-invoice-zugferd-2.0-en16931.jsonsample-invoice.jsonfactura-de-prueba.csvzugferd-invoice-2.0.csvCSV Referencia de columna
El CSV Los datos introducidos deben seguir este orden exacto de columnas. Cada fila genera una factura.
| Columna | Descripción | Ejemplo |
|---|---|---|
InvoiceId | Unique invoice identifier | INV-2025-001 |
IssueDate | Invoice issue date (YYYY-MM-DD) | 2025-01-15 |
SellerName | Seller company name | Test Company |
SellerStreet | Seller street address | 123 Main St |
SellerCity | Seller city | Test City |
SellerPostalCode | Seller postal / ZIP code | 12345 |
SellerCountry | ISO 3166-1 alpha-2 country code | DE |
SellerVatId | Seller VAT registration number | DE123456789 |
BuyerName | Buyer company or person name | Customer Inc |
BuyerStreet | Buyer street address | 456 Oak Ave |
BuyerCity | Buyer city | Customer City |
BuyerPostalCode | Buyer postal / ZIP code | 67890 |
BuyerCountry | ISO 3166-1 alpha-2 country code | DE |
ProductName | Line item product or service name | Test Product |
Quantity | Quantity of the line item | 10.0 |
UnitPrice | Net unit price | 9.90 |
TaxPercent | VAT / tax percentage | 19.0 |
Currency | ISO 4217 currency code | EUR |
PaymentReference | Payment reference string | PAY-REF-001 |
IBAN | Payee IBAN for bank transfer | DE08700901001234567890 |
BIC | Payee bank BIC / SWIFT code | GENODEF1M04 |
JSON Estructura de la factura
Al usar Formato de entrada: JSONLa carga útil debe incluir las siguientes claves de nivel superior. Todos los objetos y matrices anidados siguen la estructura que se muestra en el archivo de ejemplo.
| Llave | Tipo | Descripción |
|---|---|---|
InvoiceId | String | Unique invoice number, e.g. "471102" |
IssueDate | String (ISO 8601) | Invoice date, e.g. "2013-03-05T00:00:00" |
InvoiceType | String | Document type label, e.g. "RECHNUNG" |
TypeCode | String | UN/EDIFACT document type code. 380 for standard invoice |
IsTest | Boolean | true for test runs, false / omit for production |
Notes | Array of strings | Free-text notes shown in the invoice header (payment terms, GLN, etc.) |
Seller | Object | Seller party: Name, Address (Street, City, PostalCode, Country), TaxId, VatId, GLN |
Buyer | Object | Buyer party: Name, Address (Street, City, PostalCode, Country, LineTwo), GLN |
Payment | Object | Payment details: PaymentReference, Currency, IBAN, BIC |
DeliveryDate | String (ISO 8601) | Actual delivery date, e.g. "2013-03-05T00:00:00" |
LineItems | Array of objects | Invoice lines. each with Quantity, UnitCode, UnitPrice, LineTotal, ProductName, GTIN, SellerProductId |
Totals | Object | Monetary totals: LineTotal, ChargeTotal, AllowanceTotal, TaxBasisTotal, TaxTotal, GrandTotal, TaxPercent, Currency |
¿Cómo creo un? ZUGFeRD factura en Make¿
- Agregar PDF4me → Crear un ZUGFeRD factura a tu escenario.
- Seleccionar Conexión (o haga clic Agregar para crear uno con tu API llave).
- Elegir Formato de entrada. XML, JSON, o CSVEl campo de datos que aparece depende de esta selección.
- Colocar Archivo a Mapa y conecte el campo de datos de la factura (Datos XML de la factura / Datos JSON / Datos CSV) de la salida del módulo anterior. O bien, elija Dropbox - Descargar un archivo para descargar el archivo directamente desde Dropbox.
- Colocar Modo de salida a XML con PDF para un híbrido PDF/A-3 factura o Solo XML para XML solo.
- Colocar zugferd Versión (1.0 o 2+) luego elige Nivel de conformidad del conjunto apropiado para la versión. empezar con BÁSICO.
- Si utiliza XmlWithPdf: configure Generar factura en PDF a Sí para dibujar elementos de línea visualmente y establecer idioma a su ubicación de destino (por ejemplo,
de,en,fr). - Ahorrar y haga clic Correr una vez. Enrutar el Datos del documento salida a Dropbox, Google Drive, un ERP webhook o un módulo de correo electrónico.
Campos de salida
| Campo | Tipo | Lo que contiene |
|---|---|---|
Document Name | String | Filename of the generated invoice file. e.g. invoice-471102.pdf or invoice-471102.xml. |
Document Data | Buffer | Binary content of the ZUGFeRD hybrid PDF/A-3 or XML file. Map into an upload, email attachment, or ERP HTTP module for the next step in your scenario. |
Ejemplos de flujo de trabajo
Ejemplos de flujo de trabajoCommon Make scenario patterns using Create ZUGFeRD Invoice for automated e-invoicing.
- Un pedido se marca como enviado en su ERP o Airtable. El escenario se activa.
- Los artículos, los precios, la dirección del comprador y los datos fiscales se obtienen y se ensamblan en un JSON carga útil.
- Crear ZUGFeRD factura funciona con formato de entrada JSONModo de salida XML con PDF, versión 2+, Nivel de conformidad BÁSICO, idioma
de. - El híbrido PDF Se envía un correo electrónico al comprador a través de Gmail y se sube una copia al archivo de facturas en Google Drive.
- Contabilidad deja caer un CSV Archivo de facturas mensuales en Dropbox.
- Un disparador de tipo Watch Files detecta el nuevo archivo y un iterador procesa cada fila.
- Crear ZUGFeRD factura carreras por fila con formato de entrada CSV, generando un híbrido PDF por factura.
- Todo PDFs Los archivos se cargan en una carpeta de archivo estructurada y se envía un correo electrónico de resumen de la finalización al equipo de finanzas.
- La facturación de un contrato gubernamental se genera a partir de un registro de Airtable.
- Crear ZUGFeRD factura funciona con formato de entrada JSONModo de salida Solo XML, versión 2+Nivel de conformidad XRECH.
- El XML El archivo se envía mediante POST directamente al dispositivo compatible con Peppol del comprador. ERP API a través de un HTTP módulo.
- La respuesta, ya sea de éxito o de error, se registra en una hoja de cálculo de Google para que el equipo de finanzas la revise.