Aller au contenu principal
API PDF4meIntégrationsBase de connaissancesExtensionsTesteur d'APIBlog

Créer une facture électronique ZUGFeRD 2.0+ dans Make : un flux de travail Dropbox en 4 modules

· 22 minutes de lecture
Sankalp Mishra
SEO and Content Writer

ZUGFeRD 2.0+ (également connu sous le nom de Factur-X en France et XRechnung (dans le secteur public allemand) est un facture hybride PDF/A3 avec le XML lisible par machine intégré au PDF. Un seul fichier utilisable par les humains et les systèmes ERP. Ce guide décrit précisément le processus illustré dans les captures d'écran : une facture PDF de base et un fichier XML ZUGFeRD 2.0+ dans Dropbox sont transformés en une facture électronique hybride conforme à la norme EN16931. /pdf4meoutput/, dans 4. Créez des modules, sans coder..

Aperçu du scénario
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 version courte

Quatre modules Make de bout en bout. Deux Dropbox Télécharger un fichier Les étapes extraient le PDF de base et le XML ZUGFeRD 2.0+ (les captures d'écran le montrent). YnooxTestone connexion plus chemins /pdf4metest/Facture de Zugfred/SimplePdf.pdf et /pdf4metest/Facture de Zugfred/version2.xmlPDF4me Créer une facture ZUGFeRD intègre le XML dans le PDF avec Mode de sortie XML avec PDF, Version ZUGFeRD 2+, Niveau de conformité EN16931, Générer la facture au format PDF Oui, Langue deDropbox Téléverser un fichier écrit le résultat PDF hybride/A3 à /pdf4meoutput/ avec le fichier défini sur Carte, Nom de fichier 15. Nom, Données 15. DocumentLe fichier de sortie s'ouvre dans n'importe quel lecteur PDF et s'analyse correctement dans n'importe quel ERP prenant en charge ZUGFeRD / Factur-X / XRechnung.

Deux éléments déterminent si votre ERP accepte la facture.

Premièrement, le Niveau de conformité doit correspondre aux attentes de votre acheteur ou destinataire ERP. EN16931 (Comfort) est la norme légale allemande par défaut et le choix sûr pour les transactions B2B dans l'UE ; XRECH est requis pour la facturation B2G (secteur public) en Allemagne ; BASIQUE Cela fonctionne pour la plupart des autres acheteurs. Deuxièmement, le Version ZUGFeRD doit être 2+ Pour tout ce qui est conforme à la norme EN 16931. Héritage 1.0 Utilise les modes BASIC / COMFORT / EXTENDED et est incompatible avec les récepteurs EN 16931. Choisissez 2+ sauf si le destinataire demande explicitement la version 1.0.

Ce produit répond à des questions courantes du monde réel​

Les internautes recherchent précisément ce problème en utilisant des expressions comme :

  • « Comment créer une facture ZUGFeRD avec du XML intégré dans Make ? » Ce scénario en 4 modules le fait de bout en bout : modèle PDF plus facture XML en entrée, PDF/A3 hybride en sortie.
  • « ZUGFeRD est-il identique à Factur-X ? » Oui. Même format technique sous des noms différents. Un fichier ZUGFeRD 2.x est accepté par les systèmes qui attendent Factur-X et vice versa.
  • « Quel niveau de conformité dois-je choisir ? » EN16931 pour le B2B (correspond à la norme juridique allemande par défaut et à la norme européenne EN 16931), XRECHNUNG pour le secteur public allemand (B2G), BASIC pour une compatibilité avec les systèmes existants la plus étendue.
  • « Dois-je écrire moi-même le XML ? » Non, mais pour ce cas précis, les captures d'écran utilisent une facture XML existante. Le module accepte également les formats JSON ou CSV et génère le fichier XML automatiquement.
  • « Et si mon acheteur n'a besoin que du fichier XML, et pas du PDF ? » Réglez le mode de sortie sur XML Only et le module renvoie uniquement le fichier de facture XML au lieu du fichier hybride.

Ce que vous êtes en train de construire​

Un scénario Make réutilisable qui génère une facture électronique hybride entièrement conforme à la norme ZUGFeRD 2.0+ à partir d'un fichier PDF et d'un fichier XML. Le déclenchement peut être manuel, programmé (comme illustré), par surveillance de fichiers Dropbox ou via un webhook HTTP. Le résultat est un fichier unique répondant aux exigences de l'UE en matière de facturation électronique : format PDF lisible par l'homme et format XML lisible par machine.

Création d'un canevas de scénario : un téléchargement de fichier Dropbox (PDF, avec un badge d'horloge programmé) connecté à un second téléchargement de fichier Dropbox (XML), connecté à PDF4me ; la création d'une facture ZUGFeRD, connectée à un chargement de fichier Dropbox. Chaque module affiche un compteur d'itérations et une coche verte indiquant une exécution réussie.

Quatre modules de bout en bout. Deux téléchargements, une action PDF4me, un chargement. Le badge d'horloge du module 1 indique un déclenchement programmé ; basculez entre le mode manuel, la surveillance de fichiers et le webhook selon vos besoins.

Ce dont vous avez besoin​

  • Faire compte avec un scénario ouvert. Créer un compte si vous en avez besoin.
  • Clé API PDF4me. Obtenez votre clé API et connectez-vous au premier module PDF4me. Voir Connectez-vous à PDF4me pour créer.
  • Dropbox avec un dossier source (par exemple, /pdf4metest/Facture de Zugfred/) contenant le modèle PDF et la facture XML, ainsi qu'un dossier de sortie (/pdf4meoutput/).
  • Un PDF de base (les captures d'écran utilisent SimplePdf.pdfIl ne nécessite aucune mise en page. Le module intègre le fichier XML sous forme de pièce jointe PDF/A3.
  • Facture XML ZUGFeRD 2.0+Utilisez le vôtre, ou prenez-en un Exemple XML 2.0 pour suivre.

Guide rapide : rôle de chaque paramètre​

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.

Élaborez le scénario​

Module 1 : Téléchargement d’un fichier Dropbox (PDF de base)​

Extrayez le PDF source où le fichier XML ZUGFeRD sera intégré en tant que pièce jointe PDF/A-3.

ChampValeur utilisée dans cette exécution
ConnectionYnooxTestone (ynoox.test...). your Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/SimplePdf.pdf
Configurer Dropbox pour télécharger un fichier PDF de base. Connexion : YnooxTestone. Sélection du fichier : sélectionnez un fichier. Chemin d'accès : /pdf4metest/Zugfred Invoice/SimplePdf.pdf.

Module 2 : Téléchargement d’un fichier Dropbox (ZUGFeRD 2.0+ XML)​

Récupérez le fichier XML de la facture ZUGFeRD. Le fichier XML contient tous les détails de la facture ; le PDF n’est que le format visuel.

ChampValeur utilisée dans cette exécution
ConnectionYnooxTestone (ynoox.test...). same Dropbox connection
Way of selecting filesSelect a file
File/pdf4metest/Zugfred Invoice/version2.xml
Configurer Dropbox pour télécharger un fichier XML ZUGFeRD 2.0+. Connexion : YnooxTestone. Sélection du fichier : sélectionnez un fichier. Chemin d'accès : /pdf4metest/Zugfred Invoice/version2.xml.

Module 3 : PDF4me Créer une facture ZUGFeRD​

L'action qui effectue l'intégration proprement dite. Associez les deux fichiers téléchargés comme entrées, choisissez vos paramètres de conformité et exécutez.

GroupeChampValeur
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

Module 4 : Téléchargement d’un fichier via Dropbox​

Enregistrez la facture électronique hybride PDF/A3 dans le dossier de sortie.

ChampValeur utilisée dans cette exécution
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)
Configurer le chargement de fichiers Dropbox. Connexion : YnooxTestone. Dossier : /pdf4meoutput/. Fichier : Mapper. Nom du fichier : lié à 15. Nom (provenant de PDF4me : Créer une facture ZUGFeRD). Données : liées à 15. Document.

Enregistrer et cliquer Exécuter une foisLe PDF/A-3 hybride atterrit à /pdf4meoutput/ en quelques secondes.

Get your API KeyFull action reference

Exemples de fichiers (XML, JSON, CSV)​

Vous pouvez remplacer n'importe laquelle de ces entrées par le module 2 (XML) et modifier Format d'entrée par conséquent.

Dépannage​

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.

Quand utiliser ce modèle​

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.

Que lire ensuite ?​

FAQ​

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.

Commencer​

Get your API KeyPDF4me on MakeAction reference