Skip to main content
PDF4me APIIntegrationsKnowledge BaseExtensionsAPI TesterBlog

Create ZUGFeRD Invoice in Make

What this module does

PDF4me — Create a ZUGFeRD invoice (or equivalent invoice module in your scenario) produces ZUGFeRD / Factur‑X outputs from XML, JSON, or CSV invoice data. In the Make UI you will often see XmlWithPdf (hybrid PDF + embedded invoice XML) and XmlOnly (XML invoice only)—the same ideas as “PDF with XML” vs “XML only” in other PDF4me surfaces.

Authenticating Your API Request​

Select a Connection on the PDF4me module. Use an API key from your PDF4me dashboard so scenarios can call invoice generation securely.

Get your API Key

Module configuration (screenshot)​

Make PDF4me module Create a ZUGFeRD invoice showing Input Format CSV, Output Mode XmlWithPdf, Conformance Level BASIC, zugferd Version 1.0, Render Invoice on PDF Yes, language de

Example from the Make module: CSV input, XmlWithPdf, BASIC conformance, version 1.0, render on PDF Yes, language de.

Important Facts You Should Not Miss​

Output mode names in Make

XmlWithPdf = PDF with embedded ZUGFeRD XML. XmlOnly = invoice XML file only. Render Invoice on PDF applies when the output is the hybrid PDF mode.

One invoice payload format per run

When Input Format is CSV, map only the CSV invoice field the module exposes. Switching to JSON or XML shows different fields—do not populate multiple formats in the same execution.

Conformance and version

Start with BASIC for broad compatibility. Match zugferd Version and profile to what your buyer or ERP expects (often discussed with EN 16931 semantics).

Language: The module may accept a language code (e.g. de, en, fr) for invoice localization. If omitted, the connector may default (often German locales in ZUGFeRD contexts)—confirm in your scenario tests.

Core fields (reference)​

FieldWhat it controls
Input FormatInvoice payload shape: XML (existing ZUGFeRD XML), JSON, or CSV.
Output ModeXmlWithPdf = hybrid PDF; XmlOnly = XML invoice only.
Conformance LevelZUGFeRD profile (e.g. BASIC, COMFORT, EXTENDED).
zugferd VersionSpecification version in the module (e.g. 1.0).
Render Invoice on PDFWhether invoice data is drawn on PDF pages when using XmlWithPdf.
languageLocale for labels (e.g. de, en, fr).

You will also map base PDF and invoice data from prior modules (e.g. Dropbox Download a File, HTTP Get a file, or a buffer from an earlier PDF4me step), following the field labels shown in your installed PDF4me app version.

Quick Setup​

  1. Add PDF4me and choose Create a ZUGFeRD invoice (or the invoice action your app lists).
  2. Set Connection and Input Format (XML / JSON / CSV).
  3. Map invoice data from the correct prior module output.
  4. For hybrid PDF output, set Output Mode to XmlWithPdf and supply the template PDF / file fields the module requires.
  5. Set Conformance Level, zugferd Version, Render Invoice on PDF, and language as needed.
  6. Save the module and run the scenario; route the output buffer to Dropbox, Google Drive, or email.

Workflow Examples​

Workflow ExamplesOpens by default — typical Make scenarios around ZUGFeRD.
Dropbox PDF + JSON
  1. Download base PDF and JSON from Dropbox.
  2. Create ZUGFeRD with XmlWithPdf and JSON input.
  3. Upload result to an output folder or send to ERP.
CSV batch
  1. Trigger on new CSV in storage.
  2. Set Input Format = CSV and map only CSV invoice content.
  3. Write hybrid PDFs to archive; optional Validate PDF/A next.

Get Help​

Make + PDF4me HelpMake Documentation