Créer une facture ZUGFeRD dans 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.

Que fait ce nœud ?

PDF4me Créer une facture Zugferd génère entièrement conforme Factures électroniques hybrides ZUGFeRD (Documents PDF/A3 avec structure XML (données de facture intégrées) directement dans votre n8n Flux de travail. Convertir XML, JSON, ou CSV Les données de facturation dans un seul fichier hybride prêt pour Obligation de facturation électronique B2B en AllemagneConforme à la norme européenne EN 16931 ou au profil allemand XRECHNUNG pour le secteur public. Prend en charge toutes les versions de ZUGFeRD (de 1.0 à 2.4) et les six niveaux de conformité sur un seul nœud.

Articles de blog connexes(1)

Comment créer une facture ZUGFeRD dans n8n\_? Un flux de travail Dropbox + JSON, étape par étape\_!

Flux de travail n8n\_: importer la facture au format JSON dans PDF4me, créer une facture ZUGFeRD/Factur-X, puis importer le PDF généré dans Dropbox. Inclut des captures d’écran, des exemples de correspondance et des vérifications du résultat.

Lire l'article →

Authentification de votre API Demande

Chaque PDF4me nœud dans n8n nécessite un numéro valide Identifiant pour se connecter avecCréez ou sélectionnez-en un qui contient votre PDF4me API clé permettant au flux de travail d'authentifier en toute sécurité les demandes de génération de factures ZUGFeRD.

Get your API Key

Informations importantes à ne pas manquer

ZUGFeRD est un format hybride PDF/A3 + XML format, pas un format pur XML standard

Le résultat est un fichier PDF unique au format A3 de qualité archivistique. PDF avec la structure XML La facture est jointe à l'intérieur. Les humains la lisent. PDF, les machines analysent le XMLAucun fichier séparé à envoyer. Pour générer du pur XML sans le PDF Pour générer un fichier hybride, définissez le mode de sortie sur XML uniquement ; définissez-le sur XML avec PDF (valeur par défaut).

ZUGFeRD 2.0+ est requis pour le mandat B2B allemand 2025-2028

La loi allemande Wachstumschancengesetz (loi sur les opportunités de croissance) rend obligatoire la réception des factures électroniques pour toutes les transactions B2B à compter du 1er janvier 2025, l'obligation d'envoi complet étant progressivement mise en œuvre d'ici 2028. La version 2.0 ou supérieure de ZUGFeRD, conforme aux normes EN16931 ou XRECHNUNG, répond à cette obligation. La version 1.0 de ZUGFeRD n'est pas conforme.

Contrôles du niveau de conformité : la norme EN16931 est la norme par défaut la plus sûre.

Choisissez la norme EN 16931 pour la facturation B2B générale au sein de l'UE (norme européenne), XRECHNUNG pour la facturation des entités du secteur public allemand et EXTENDED pour les champs spécifiques à un secteur d'activité, au-delà des exigences de base de la norme EN 16931. Les options MINIMUM et BASICWL omettent des lignes de facturation et ne peuvent être utilisées pour une facturation complète ; elles sont réservées aux transferts comptables internes.

Paramètres

Requis dans le n8n Interface utilisateur : Identifiants de connexion, Type de données d'entrée, Nom du document (toujours requis même lorsque le type de données d'entrée est Aucun, utilisé comme nom de document par défaut), Mode de sortie, Version de Zugferd, Afficher la facture au format PDF, Langue, Format d'entrée et Type d'entrée des données de facture. Niveau de conformité est affiché et requis en fonction de la branche de version de Zugferd, avec un nom de champ et un ensemble d'options différents pour 1.0 vs 2.0/2.1/2.2/2.4 vs Personnalisé. Le champ de données de facture correspondant (Facture XML/JSON/CSV Données, Propriété binaire, Base64 Le contenu (ou l'URL des données) est obligatoire selon le type de données de facturation. La validation à l'exécution exige un contenu non vide sur le chemin choisi et génère des erreurs telles que « Les données de la facture… sont requises » ou « Le contenu base64 de la facture est requis ».

Paramètre	Requis	Ce que cela fait	Exemple
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`

Exemples de fichiers de factures

Utilisez ces exemples de fichiers pour tester le nœud avec chaque format d'entrée avant de connecter votre source de données réelle. Pour les flux de production B2B allemands, commencez par sample-invoice-zugferd-2.0-en16931.json (ZUGFeRD 2.0, EN16931 conformité).

MENOTTÉ XML Échantillon

ZOGFeRD 1.0 BASIC XMLÀ utiliser avec Format d'entrée : XML. Coller ou mapper dans Facture XML Données.

Exemple de facture ZUGFeRD.xml

ZUGFeRD 2.0

ZUGFeRD 2.0 XML Échantillon (EN16931)

ZOGFeRD 2.0 EN16931 XML avec les parties vendeur/acheteur, les lignes de commande, la TVA et le total monétaire au format CrossIndustryInvoice. À utiliser avec Format d'entrée : XML, Version ZUGFeRD : 2.0, Conformité : EN16931.

Exemple de facture ZUGFeRD-2.0.xml

Recommandé

JSON 2.0 EN16931 Échantillon

Facture structurée complète pour ZUGFeRD 2.0 avec EN16931 conformité. À utiliser avec Format d'entrée : JSON, Version Zugferd : 2.0, Niveau de conformité : EN16931. Coller ou mapper dans Facture JSON Données.

sample-invoice-zugferd-2.0-en16931.json

JSON Exemple de facture (basique)

Plus simple JSON pour les tests de fumée avec ZUGFeRD 1.0 et BASIQUE conformité.

exemple-facture.json

CSV Exemple de facture

Plat CSV ligne pour Format d'entrée : CSV. Coller ou mapper dans Facture CSV Données.

test-facture.csv

ZUGFeRD 2.0

CSV Exemple de facture 2.0

Étendu à 22 colonnes CSV: Numéro de facture, Date d'émission, champs adresse vendeur/acheteur, Numéro de TVA du vendeur, Numéro de produit, Devise, Référence de paiement, IBAN, BIC. À utiliser avec Format d'entrée : CSV, ZUGFeRD 2.0.

facture zugferd-2.0.csv

Options avancées

Tous les champs à l'intérieur du Options avancées Les collections sont facultatives. Ajoutez-les via Ajouter une option dans l'interface utilisateur du nœud.

profils

Coutume PDF4me Profils de traitement. Appliquez des ensembles d'options préconfigurés pour la génération de factures ZUGFeRD avancées ou spécialisées (par exemple, des règles de validation personnalisées, des mappages de schémas alternatifs ou un réglage de la sortie spécifique au secteur).

Options de type de données d'entrée

Contrôle le fonctionnement du arrière-plan PDF document (la couche visuelle de la facture hybride) est fournie au nœud.

Menu déroulant « Type de données d'entrée » dans le nœud « Créer une facture Zugferd » de n8n PDF4me : quatre options sont proposées : « Aucun » (aucune entrée de document requise, formats XML, JSON et CSV uniquement), « Données binaires » (utiliser le fichier du nœud précédent), « Chaîne Base64 » (fournir le contenu du fichier sous forme de chaîne encodée en base64) et « URL » (fournir l'URL du fichier). — Liste déroulante Type de données d'entrée : détermine la manière dont l'arrière-plan est traité. PDF atteint le nœud

AucunXML/JSON/CSV uniquement, pas de PDF en arrière-plan

Aucune saisie de document n'est requise. PDF4me génère à la fois le visuel PDF couche et la structure XML à partir des seules données de la facture. Utilisez cette méthode lorsque seules les données de la facture existent et que vous souhaitez PDF4me pour générer le fichier hybride complet.

Données binairesFichier du nœud précédent (le plus courant)

Lit le contexte PDF binaire directement à partir de la sortie d'un précédent n8n nœud : Téléchargement Google Drive, HTTP Demander ou lire un fichier binaire. Le champ Propriété binaire spécifie le champ de sortie à lire (par défaut). données).

Chaîne Base64Contenu du fichier encodé en Base64

Accepte le contexte PDF sous forme de chaîne encodée en base64. Utilisez-la lorsque le fichier arrive d'un API réponse, charge utile de webhook ou colonne de base de données stockant des documents au format base64.

URLTélécharger à partir d'un lien public

Fournir un accès public URL au fond PDF. PDF4me télécharge le fichier directement avant de générer la facture hybride. URL Ne doit pas nécessiter d'authentification.

Options du mode de sortie

Contrôle si le nœud produit un signal pur XML fichier ou le fichier hybride complet ZUGFeRD (PDF/A3 + intégré) XML).

Dans le nœud « Créer une facture Zugferd » de n8n PDF4me, le menu déroulant « Mode de sortie » propose deux options : « XML uniquement » (avec description) pour générer uniquement le fichier XML, et « XML avec PDF » (avec description) pour générer le fichier XML intégré au PDF. — Menu déroulant Mode de sortie avec deux options : pur XML ou hybride PDF/A-3 avec XML intégré

XML uniquementPur XML, Non PDF emballage

Ne produit que les données structurées XML Données de facturation. À utiliser lorsque le système de réception traite les XML supprime directement le contenu visuel, pour les soumissions XRechnung en XML pur ou pour tester la couche de données de manière isolée. Définissez l'extension du nom du fichier de sortie sur .xml.

XML avec PDFPar défaut : fichier hybride ZUGFeRD complet

Génère la facture hybride standard ZUGFeRD : un document PDF/A3 de qualité archivistique PDF avec la structure XML Les données de la facture sont intégrées en pièce jointe. Elles sont lues par des humains. PDF, les machines analysent le XML. Il s'agit du résultat ZUGFeRD standard pour la facturation électronique B2B en production.

Options de version ZUGFeRD

La version de la spécification ZUGFeRD est intégrée à la facture générée.

Menu déroulant « Version Zugferd » dans le nœud « Créer une facture Zugferd » de n8n PDF4me : options : 1.0, 2.0 (en surbrillance), 2.1, 2.2, 2.4 et Personnalisé, avec une infobulle indiquant le paramètre : zugferdVersion — Menu déroulant ZUGFeRD Version avec six options, dont l'ancienne version 1.0 et la dernière version 2.4.

1.0Héritage : ne satisfait pas au mandat de 2025

Spécifications originales de 2014. Compatible uniquement avec les anciens systèmes de réception. pas Se conformer à la réglementation allemande sur la facturation électronique B2B, applicable à partir de 2025. À éviter pour les nouveaux flux de travail.

2.0Par défaut : compatibilité étendue

Première version conforme à la norme EN 16931 (2019). Répond aux exigences allemandes en matière de facturation B2B et constitue la solution par défaut sécurisée pour la facturation B2B courante. Entièrement compatible avec Factur-X 1.0.

2.1Améliorations mineures

Ajoute des améliorations et des clarifications mineures au schéma par rapport à la version 2.0. À utiliser lorsque votre système de réception requiert spécifiquement la version 2.1.

2.2Profil XRECHNUNG mis à jour

Conforme à la version 2.x du profil XRECHNUNG mis à jour. À choisir lors de la facturation des entités du secteur public allemand qui exigent le profil le plus récent.

2.4Dernières nouvelles : prise en charge la plus récente de XRECHNUNG

Dernière spécification publiée. Prend en charge les dernières améliorations apportées au profil et au schéma XRECHNUNG. À sélectionner si le destinataire exige la dernière version.

CoutumeGestion avancée des versions

Permet la gestion personnalisée des versions lorsqu'un identifiant de version non standard est requis par un système de réception spécifique. À utiliser uniquement sur instruction explicite de votre contrepartie de facturation.

Options de niveau de conformité

Le profil de conformité détermine quels champs de facture sont obligatoires et validés ; il s’agit du choix le plus important pour la conformité.

Menu déroulant Niveau de conformité dans le nœud Créer une facture Zugferd de n8n PDF4me affichant six options : MINIMUM, BASICWL, BASIC, EN16931 (en surbrillance), EXTENDED et XRECHNUNG — Menu déroulant Niveau de conformité avec six profils, de MINIMUM à EXRECHNUNG, permettant de contrôler les exigences sur le terrain et le périmètre de conformité

MINIMUMEn-tête uniquement, ne constitue pas une facture valide

Données d'en-tête uniquement : parties, totaux, références des documents. Aucun article supplémentaire. Ne peut être utilisé comme facture légale ; uniquement pour les dépôts comptables internes ou les notifications de statut.

BASICWLBasique sans lignes : TVA uniquement

Ajoute le détail de la TVA/des taxes en plus du MINIMUM. Aucune ligne de commande. Utilisées uniquement dans le cadre de réservations où les factures sont rapprochées des commandes, et non comme factures légales autonomes.

BASIQUEFacture légale minimale

Ajoute des lignes de facturation supplémentaires au format BASICWL. Conforme aux exigences minimales de la directive européenne sur la facturation électronique. Acceptable pour les factures simples, mais la norme EN16931 est la norme par défaut la plus sûre pour une conformité B2B totale.

EN16931Par défaut : norme européenne

Profil complet de la norme européenne EN 16931. Modèle par défaut recommandé pour la facturation B2B dans l'UE et le niveau de conformité auquel fait référence le mandat allemand de 2025. Comprend tous les champs nécessaires à une facturation commerciale conforme.

ÉTENDUSuppléments spécifiques à l'industrie

Ajoute des champs spécifiques à l'industrie en plus de ceux prévus par la norme EN 16931, par exemple des références supplémentaires relatives à la logistique, au transport de marchandises ou à des secteurs d'activité particuliers. À utiliser lorsque votre accord sectoriel ou votre partenaire commercial exige les champs ÉTENDUES.

XRECHARGEle secteur public allemand obligatoire

Le profil allemand XRechnung CIUS, obligatoire pour les factures adressées aux autorités fédérales, régionales et municipales allemandes. Validation plus stricte que la norme EN16931. À utiliser lorsque le destinataire est une entité du secteur public allemand.

Options linguistiques

Langue d'affichage des libellés de facture dans le rendu PDF couche. La XML Les données elles-mêmes sont indépendantes de la langue.

Menu déroulant Langue dans n8n Créer une facture Zugferd : allemand, français, italien, anglais, espagnol, néerlandais, polonais et portugais — **Langue**: étiquettes localisées pour le rendu PDF (L'allemand est typique des transactions B2B et B2G en Allemagne).

AllemandPar défaut, B2B/B2G allemand

AnglaisFacturation internationale

FrançaisFlux de travail Factur-X

italienB2B italien

EspagnolB2B espagnol

NéerlandaisPays-Bas/Belgique

polonaisPologne B2B

portugaisPortugal/Brésil

Options de format d'entrée

Format des données de facturation que vous fournissez au nœud.

Menu déroulant Format d'entrée dans n8n Créer une facture Zugferd affichant les options XML, JSON et CSV, avec JSON sélectionné — **Format d'entrée**: choisir `XML`, `JSON`, ou `CSV` pour correspondre à la charge utile de votre facture.

XMLPré-assemblé XML facture

Fournir des fichiers déjà formatés et conformes à la norme ZUGFeRD XML ou UBL XML données. À utiliser lorsque vos ERP produit déjà des standards XML factures qui nécessitent simplement d'être enveloppées dans l'hybride PDF.

JSONPar défaut : moderne API source

Fournir les données de facturation sous forme structurée JSON objet. Le choix le plus courant lorsque les données de facturation proviennent d'un webhook, REST APIou des logiciels de comptabilité modernes. PDF4me cartes JSON champs au ZUGFeRD XML schéma automatiquement.

CSVDonnées de facturation par lots tabulaires

Fournir les données de facturation comme CSV, utile pour les exportations par lots de factures à partir de feuilles de calcul, de systèmes existants ou dans des scénarios de facturation en masse. PDF4me cartes CSV colonnes du schéma ZUGFeRD.

Options de type de saisie des données de facturation

Contrôle la manière dont les données de facturation (les XML, JSON, ou CSV le contenu) atteint le nœud.

Menu déroulant « Type de saisie des données de facturation » dans n8n : Créer une facture Zugferd, proposant les options Texte direct, Données binaires, Chaîne Base64 et URL — **Type de saisie des données de facturation**: comment le XML, JSON, ou CSV La charge utile est fournie (en ligne, binaire provenant d'un nœud précédent, base64 ou URL).

Texte directPar défaut : coller ou insérer la carte en ligne

Collez ou associez directement les données de la facture dans le champ « Données de la facture ». Idéal pour JSON ou plus petits CSV charges utiles provenant des nœuds en amont. Utiliser n8n Syntaxe d'expression pour construire dynamiquement les données.

Données binairesFichier du nœud précédent

Lit le fichier de données de la facture (XML, JSON, ou CSV) directement à partir de la sortie binaire d'un précédent n8n nœud : Téléchargement Google Drive, lecture de fichier binaire ou HTTP Demande. Idéal pour les grands XML fichiers.

Chaîne Base64Données encodées en Base64

Accepte les données de la facture sous forme de chaîne encodée en base64. À utiliser lorsque le contenu de la facture provient d'un API champ de réponse ou de base de données qui stocke les fichiers au format base64.

URLTélécharger à partir d'un lien public

Fournir un accès public URL au fichier de données de facturation. PDF4me télécharge le fichier et analyse son contenu en fonction du format d'entrée sélectionné.

Champs de sortie

Champ	Taper	Ce qu'il contient
`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.

Configuration rapide

Ajouter PDF4me à votre n8n Flux de travail. Définir Ressource à Facture et Opérations de facturation à Créer une facture Zugferd.
Dans Identifiant pour se connecter avec, sélectionnez votre PDF4me identifiant ou cliquez Créer un nouveau compte et collez votre API clé.
Ensemble Type de données d'entrée: connecter un nœud précédent (données binaires), fournir un Base64 chaîne ou URL pour le contexte PDF, ou sélectionnez Aucun lorsque PDF4me devrait rendre le PDF à partir des seules données de facturation.
Entrer Nom du document (Par exemple invoice.pdf).
Ensemble Mode de sortie: XML avec PDF pour la sortie hybride standard ZUGFeRD, ou XML uniquement pour pur XML.
Choisir Version Zugferd (utiliser 2.0 comme valeur par défaut sûre ; 2.4 (pour le profil XRECHNUNG le plus récent).
Choisir Niveau de conformité: EN16931 pour le B2B en général, XRECHARGE pour la facturation du secteur public allemand, ÉTENDU pour des domaines spécifiques à l'industrie.
Ensemble Langue pour le rendu PDF étiquettes (allemand par défaut).
Activer Générer une facture au format PDF si tu veux PDF4me Afficher visuellement le contenu de la facture ; désactiver cette option lorsqu'un arrière-plan prédéfini est fourni. PDF.
Choisir Format d'entrée (JSON, XML, ou CSV) et Type de saisie des données de facturation (Texte direct, données binaires, chaîne Base64 ou URL). Collez ou mappez les données de la facture dans le champ « Données de la facture ».
Ensemble Nom du fichier de sortie à zugferd_invoice.pdf et Nom du champ binaire de sortie à data.
Connectez la sortie à votre prochain nœud (expéditeur d'e-mails, téléchargement vers un stockage cloud, portail gouvernemental). HTTP POST) et exécuter le flux de travail.

Exemples de flux de travail

Exemples de flux de travailCommon n8n workflow patterns using Create Zugferd Invoice.

Logiciel de comptabilité → Facture ZUGFeRD 2.0 EN16931 → Courriel au client

Un déclencheur Webhook s'active lorsqu'une facture est finalisée dans la plateforme comptable (DATEV, sevDesk, lexoffice).
La charge utile du webhook contient les données de facturation sous forme structurée. JSON objet.
PDF4me Créer une facture Zugferd génère la facture hybride. Le type de données d'entrée est Aucun (PDF4me rend le PDF de la JSONMode de sortie : XML avec PDF, version de Zugferd : 2.0, niveau de conformité : EN16931, langue : allemand, format d'entrée : JSONLe type de données de facturation saisi est du texte direct mappé à partir de la charge utile du webhook.
Un nœud Gmail envoie des e-mails au ZUGFeRD PDF à l'adresse de facturation du client, conformément aux exigences allemandes en matière de mandat de réception B2B.
Un nœud PostgreSQL enregistre le numéro de facture, la version ZUGFeRD et le niveau de conformité à des fins d'audit et de rapports de conformité.

ERP XML facture → ZUGFeRD XRECHNUNG → télécharger sur le portail du secteur public

Un déclencheur de planification s'active chaque jour ouvrable à 16h00 pour traiter les factures du secteur public.
Un nœud SFTP récupère les données nouvellement générées ERP XML fichiers de factures du dossier d'exportation.
PDF4me La fonction « Créer une facture Zugferd » génère une facture conforme à la norme XRECHNUNG. Type de données d'entrée : Aucun ; Mode de sortie : XML avec PDF ; Version de Zugferd : 2.4 (dernier profil XRECHNUNG) ; Niveau de conformité : XRECHNUNG ; Langue : Allemand ; Format d'entrée : XMLLe type de données d'entrée de la facture est constitué de données binaires mappées à partir du contenu du fichier SFTP.
Un HTTP Le nœud de requête télécharge la facture XRECHNUNG sur la plateforme fédérale ZRE (Central Invoict Receipt Platform of the Federal Government) ou sur le portail d'État concerné.
Un Microsoft Outlook Le nœud envoie une confirmation à l'équipe d'approvisionnement et un nœud PostgreSQL enregistre la référence de la soumission.

Mensuel CSV Lot de facturation → Factures ZUGFeRD → archive vers SharePoint

Un déclencheur de planification s'active le 1er de chaque mois pour traiter la facturation mensuelle.
Un nœud Google Drive télécharge les données consolidées CSV Exportation des factures, une ligne par facture client.
Un nœud Split In Batches itère sur chaque CSV rangée. PDF4me La fonction « Créer une facture Zugferd » génère une facture ZUGFeRD par client. Le type de données d'entrée est « Aucun », le mode de sortie est XML avec PDF, la version de Zugferd est 2.0, le niveau de conformité est EN16931, la langue varie selon les paramètres régionaux du client et le format d'entrée est… CSVLe type de saisie des données de facturation est du texte direct avec le contenu CSV par ligne.
Un Microsoft SharePoint Le nœud télécharge chaque ZUGFeRD PDF dans le dossier d'archivage de facturation du client.
Un nœud Gmail envoie à chaque client sa facture hybride ; une ligne de synthèse finale PostgreSQL enregistre l’exécution par lots avec le nombre de factures et le montant total.

Foire aux questions

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.