Aller au contenu principal

Créer une facture ZUGFeRD dans Zapier

Que fait cette action ?

PDF4me Créer une facture ZUGFeRD génère entièrement conforme Factures électroniques hybrides ZUGFeRD, un PDFDocument A3 structuré XML Les données de facturation sont intégrées directement dans votre Zapier 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 Allemagne (2025+)Conforme à la norme européenne EN 16931 ou au profil allemand XRECHNUNG pour le secteur public. Compatible avec les versions 1.0 à 2.x de ZUGFeRD et tous les niveaux de conformité (BASIC, COMFORT, EXTENDED, EN 16931 et XRECHNUNG) en une seule action Zap. Remplace avantageusement les flux de travail manuels d'Adobe Acrobat, JustOn ou ZUGFeRD Manager.

Articles de blog connexes(1)

Authentification de votre API Demande

Pour accéder au PDF4me Web API à travers Zapier, chaque action doit être authentifiée. Cliquez Créer un nouveau compte La première fois, collez votre PDF4me API clé, les Zaps suivants réutilisent automatiquement la connexion.

Informations importantes à ne pas manquer

ZUGFeRD 2.0+ requis pour le mandat B2B allemand de 2025
Le décret relatif à l'échelonnement des paiements (Wachstumschancengesetz) rend obligatoire la réception des factures électroniques à compter du 1er janvier 2025, avec une obligation d'envoi complète d'ici 2028. ZUGFeRD 2.0 ou une version supérieure conforme aux normes EN16931 ou XRECHNUNG répond à cette exigence ; ZUGFeRD 1.0 n'est pas conforme. La version 1.0 est activée par défaut dans certaines installations ; il est impératif de passer explicitement à la version 2.0 ou supérieure en production.
Remplissez un seul champ de données par exécution, jamais deux.
Carte seulement le champ de données de facture correspondant à votre format d'entrée, données XML de facture pour XML, Données JSON de la facture pour JSONDonnées CSV de la facture pour CSVRemplir plusieurs champs « au cas où » invalide la validation et fait échouer l'étape Zap lors de l'exécution.
Niveau de conformité : la norme EN16931 est la valeur par défaut sûre pour la version 2.x.
Prendre EN16931 pour la facturation B2B générale de l'UE (ZUGFeRD 2.x), XRECHARGE pour les entités du secteur public allemand, ÉTENDU pour les secteurs d'activité spécifiques. Pour ZUGFeRD 1.0, BASIC correspond au niveau minimal de facturation légale. MINIMUM et BASICWL omettent les lignes de facturation et ne constituent pas des factures légales en soi.
Action « Créer une facture ZUGFeRD » de Zapier PDF4me à l'étape « Configurer » : Fichier et nom de fichier issus des étapes précédentes, Format d'entrée : XML, Données XML de la facture mappées à partir d'une étape précédente, Mode de sortie : XML uniquement, Version de Zugferd : 1.0, Niveau de conformité : BASIC, Afficher la facture sur PDF : Oui, Langue : de

Zapier action Configure onglet, carte Déposer / Nom de fichier, ensemble Format d'entrée et le champ de données de facture correspondant, puis Mode de sortie, Version Zugferd, Niveau de conformité, Générer une facture au format PDF, et Langue.

Paramètres

Requis dans le Zapier UI (avec astérisque) : Format d'entrée, mode de sortie, version de Zugferd et niveau de conformité. Conditionnel: le champ de données de facture correspondant (données XML de facture, données JSON de facture ou données CSV de facture) en fonction du format d'entrée. Pour la sortie XmlWithPdf : Le fichier et son nom (le modèle PDF) sont généralement requis par le connecteur, même s'ils ne sont pas marqués d'un astérisque dans toutes les mises en page. Facultatif: Générer une facture au format PDF, langue.

ParamètreRequisCe que cela faitExemple
FileConditionalTemplate/layout PDF that will hold the embedded XML in XmlWithPdf output. Map from a previous step (Dropbox, Google Drive, HTTP). Not required when Output Mode is XmlOnly.3. File: (Exists but not shown)
File NameConditionalFilename of the template PDF (filename + extension). Required alongside File for XmlWithPdf output. Map both `File Name` and `File Ext` from the prior step.3. File Name: 10 page + 3. File Ext: .pdf
Input FormatYesFormat of the invoice payload: XML, JSON, or CSV. Determines which invoice data field below must be filled. Asterisked in the Zapier UI.XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample
Invoice Xml DataConditionalXML invoice payload. Required when Input Format is XML. Map from a previous file step that produced XML content. Leave empty for JSON/CSV inputs.XML sampleXML 2.0 sample4. File: (Exists but not shown)
Invoice Json DataConditionalJSON invoice payload. Required when Input Format is JSON. Best for webhook-driven or API-driven invoice data.JSON 2.0 EN16931 sampleJSON (basic)4. Body
Invoice Csv DataConditionalCSV invoice payload. Required when Input Format is CSV. Best for batch invoice exports from spreadsheets or legacy ERP exports.CSV sampleCSV 2.0 sample4. File
Output ModeYesXmlWithPdf produces the hybrid PDF/A-3 + embedded XML (canonical ZUGFeRD). XmlOnly produces pure XML with no PDF wrapper. Asterisked.XmlOnly
Zugferd VersionYesZUGFeRD specification version. 1.0 is legacy. 2.0+ aligns with EN 16931 and satisfies the German B2B mandate. Asterisked.1.0
Conformance LevelYesProfile controlling required invoice fields. For 1.0: BASIC, COMFORT, EXTENDED. For 2.x: MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNG. Asterisked.BASIC
Render Invoice On PdfNoToggle (True / False). When True, PDF4me visually renders invoice content on the PDF. When False, only the XML is embedded: useful when the template PDF already shows the invoice layout.True
LanguageNoTwo-letter locale code for printed invoice labels: de (German, default), en (English), fr (French), it (Italian), es (Spanish), nl (Dutch), pl (Polish), pt (Portuguese). The XML data itself remains language-neutral.de

Options de format d'entrée

Contrôle le format des données utilisées par votre facture et le champ de données de facture que vous devez remplir ci-dessous.

XMLPré-assemblé XML facture
Idéal lorsque votre ERP produit déjà conforme à la norme ZUGFeRD XML ou UBL XML Il suffit de l'envelopper dans l'hybride PDFAssociez le fichier à Données XML de la facture.
JSONModerne API-données issues de sources
Idéal pour les flux de travail pilotés par webhook ou SaaS systèmes de facturation qui émettent JSON. PDF4me cartes JSON champs au ZUGFeRD XML schéma automatiquement. Mapper dans Données JSON de la facture.
CSVExportation par feuille de calcul ou par lots
Idéal pour l'exportation par lots de factures depuis Google Sheets, Excel, les systèmes existants ou les scénarios de facturation ligne par ligne. PDF4me cartes CSV colonnes du schéma. Mapper dans Données CSV de la facture.

Options du mode de sortie

Contrôle si vous produisez le fichier hybride ZUGFeRD canonique ou du XML pur.

XML avec PDFFichier hybride ZUGFeRD complet par défaut
Produit l'hybride ZUGFeRD standard : PDF/A-3 archives PDF avec la structure XML La facture est jointe en pièce jointe. Les humains la lisent. PDF, les machines analysent le XMLFormat de sortie standard pour la facturation électronique B2B. Nécessite la configuration du fichier et de son nom.
XmlOnlyPur XML, Non PDF emballage
Produit uniquement les structures XML facture. À utiliser pour XRechnung pure-XML soumissions du secteur public, pipelines EDI, tests de la couche de données ou systèmes qui n'ingèrent que XML sans représentation visuelle.

Options de version Zugferd

La version de la spécification ZUGFeRD intégrée à la facture générée détermine les options de niveau de conformité affichées dans le menu déroulant.

1.0Héritage, pré-EN 16931
Spécifications d'origine de 2014. Options de conformité : BASIQUE, CONFORT, PROLONGÉNe répond PAS à la réglementation allemande sur la facturation électronique B2B à compter de 2025. À utiliser uniquement avec les systèmes existants qui exigent explicitement la version 1.0.
2.0+Recommandé, conforme à la norme EN 16931
Conforme à la norme européenne EN 16931 et satisfait aux exigences allemandes en matière de transactions B2B. Options de conformité : MINIMUM, BASICWL, BASIC, EN16931, EXTENDED, XRECHNUNGLe choix idéal pour la facturation de production à partir de 2025 et l'interopérabilité Factur-X.

Options de niveau de conformité

Le profil de conformité détermine quels champs de facture sont obligatoires et validés. Les options disponibles dépendent de la version Zugferd choisie.

MINIMUMVersion 2.x uniquement, en-tête uniquement
Données d'en-tête uniquement, sans détails de ligne. Ceci ne constitue pas une facture légale. Réservé à la comptabilité interne.
BASICWL2.x uniquement, TVA uniquement
Ajoute le détail de la TVA, mais pas les lignes de commande. Pour les réservations uniquement, rapprochées des commandes.
BASIQUELes deux versions, facture légale minimale
Ajoute des lignes de facturation. Conforme aux exigences minimales de la directive européenne sur la facturation électronique. Disponible en versions 1.0 et 2.x.
CONFORTVersion 1.0 uniquement, références étendues
Ajoute des données de référence et des champs supplémentaires à la norme BASIC. Uniquement pour ZUGFeRD 1.0, équivalent à la norme EN16931 dans les versions 2.x modernes.
EN169312.x, valeur par défaut recommandée pour les B2B
Profil complet de la norme européenne EN 16931. Norme par défaut recommandée pour la facturation B2B au sein de l'UE et niveau de référence du mandat allemand. Compatible uniquement avec ZUGFeRD 2.x.
ÉTENDULes deux versions, suppléments industriels
Ajoute des champs spécifiques à l'industrie en plus des champs de base (logistique, fret, références sectorielles). Disponible en versions 1.0 et 2.x.
XRECHARGE2.x, obligatoire pour le secteur public allemand
Le profil allemand XRechnung CIUS est obligatoire pour les factures adressées aux administrations fédérales, régionales et municipales. Il exige une validation plus stricte que la norme EN16931. Compatible uniquement avec ZUGFeRD 2.x.

Champs de sortie

ChampTaperCe qu'il contient
File ContentBinaryGenerated ZUGFeRD invoice file: hybrid PDF/A-3 for XmlWithPdf output or pure XML for XmlOnly output. Map into the next Zap step (upload, email, ERP POST).
File UrlStringDirect URL to access the generated file: useful for sharing or downstream HTTP processing.
File NameStringOutput filename without extension.
Full File NameStringComplete output filename with extension (.pdf for hybrid, .xml for XmlOnly).

Exemples de fichiers de factures

Utilisez ces exemples de fichiers pour tester l'action 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é).

Exemple XML ZUGFeRD
ZOGFeRD 1.0 BASIC XMLÀ utiliser avec Format d'entrée : XML. Cartographier dans Données XML de la facture.
Exemple de facture ZUGFeRD.xml
ZUGFeRD 2.0
Exemple XML ZUGFeRD 2.0 (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é
Exemple JSON 2.0 EN16931
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. Cartographier dans Données JSON de la facture.
sample-invoice-zugferd-2.0-en16931.json
Exemple de facture JSON (basique)
Plus simple JSON pour les tests de fumée avec ZUGFeRD 1.0 et BASIQUE conformité.
exemple-facture.json
Exemple de facture CSV
Plat CSV ligne pour Format d'entrée : CSV. Cartographier dans Données CSV de la facture.
test-facture.csv
ZUGFeRD 2.0
Exemple de facture CSV 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

Configuration rapide

  1. Dans Zapier, cliquez + pour ajouter une nouvelle action et sélectionner PDF4me.
  2. Choisir Créer une facture ZUGFeRD comme événement d'action.
  3. Connectez votre PDF4me compte ou collez votre API appuyez sur la touche lorsque vous y êtes invité.
  4. Pour XML avec PDF sortie, carte Déposer et Nom de fichier à votre mise en page PDF (souvent une étape de téléchargement préalable depuis Dropbox ou Google Drive). XmlOnlyCes cases peuvent rester vides.
  5. Ensemble Format d'entrée à XML, JSON, ou CSV en fonction de votre source de données.
  6. Remplir seulement Champ de données de facture correspondant : Données XML de la facture, Données JSON de la facture ou Données CSV de la facture. Laissez les deux autres champs vides.
  7. Ensemble Mode de sortie à XML avec PDF (fichier hybride, ZUGFeRD canonique) ou XmlOnly (pur XML).
  8. Choisir Version Zugferd: 2.0+ pour la conformité au mandat B2B allemand à partir de 2025, 1.0 Uniquement pour les récepteurs anciens.
  9. Choisir Niveau de conformité: EN16931 pour le B2B général (2.x), XRECHARGE pour le secteur public allemand, BASIQUE pour la version héritée de ZUGFeRD 1.0.
  10. Basculer Générer une facture au format PDF à Vrai si tu veux PDF4me pour afficher visuellement le contenu de la facture sur le PDF; FAUX si votre modèle PDF La mise en page est déjà affichée.
  11. Ensemble Langue au code de localisation correspondant à la région de votre acheteur (de, en, fr, it, es, nl, pl, pt).
  12. Cliquez Action de testVérifiez le résultat et allumez le Zap.

Exemples de flux de travail

Exemples de flux de travailCommon Zapier workflow patterns using Create ZUGFeRD Invoice.
Webhook SaaS JSON → ZUGFeRD 2.x EN16931 → e-mail client
  1. Ton SaaS Le système de facturation déclenche un webhook vers Zapier lorsqu'un client B2B allemand est facturé.
  2. PDF4me Création des cycles de facturation ZUGFeRD : Format d’entrée = JSON, Données JSON de la facture mappées à partir de la charge utile du webhook, Mode de sortie = XmlWithPdf, Version Zugferd = 2.0, Conformité = EN16931, Langue = de.
  3. L'hybride PDF (lisible par l'homme + analysable par la machine) est joint à une étape Gmail et envoyé à l'adresse de facturation du client, satisfaisant ainsi au mandat de facturation électronique B2B 2025+.
  4. Une ligne de Google Sheets enregistre l'identifiant de la facture, le client, le montant et l'horodatage à des fins d'audit.
  5. UN SharePoint télécharger les archives d'une copie du ZUGFeRD PDF pour la conservation des données de conformité.
Exportation CSV ERP → XRECHNUNG → Portail du secteur public allemand
  1. Un processus Zap programmé s'exécute chaque jour ouvrable à 16h00 pour traiter les factures du secteur public en attente.
  2. Un déclencheur Dropbox récupère les dernières informations. ERP CSV l'exportation et la mise en page PDF.
  3. PDF4me Création des cycles de facturation ZUGFeRD : Format d’entrée = CSV, Données CSV de la facture = le CSV fichier, Mode de sortie = XmlWithPdf, Version Zugferd = 2.0, Conformité = XRECHNUNG, Langue = de.
  4. L'hybride XRECHNUNG conforme PDF est envoyé par la méthode POST via une étape Webhook au portail fédéral ZRE ou au point de terminaison de facturation électronique de l'État concerné.
  5. Un courriel de confirmation contenant la référence de la soumission est envoyé à l'équipe AR ; un journal PostgreSQL enregistre l'historique d'audit.
XML préconfiguré → XmlOnly → Intégration des partenaires EDI
  1. Ton ERP génère déjà des données conformes à la norme ZUGFeRD XML Il exporte les factures via son module d'exportation et les dépose dans un dossier Google Drive.
  2. Zapier déclencheurs sur chaque nouveau XML déposer. PDF4me Création des cycles de facturation ZUGFeRD : Format d’entrée = XML, Données XML de la facture = le XML fichier, Mode de sortie = XmlOnly, Version Zugferd = 2.0, Conformité = EN16931.
  3. Le pur validé-XML La facture est envoyée via SFTP au point de terminaison EDI du partenaire commercial, sans PDF Enveloppe nécessaire pour le transfert de système à système.
  4. Une notification Slack confirme la livraison EDI ; un enregistrement Airtable est mis à jour avec le partenaire et l’horodatage de la soumission.

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 can read the PDF in any viewer; ERP systems and accounting software extract and process the XML automatically without manual data entry. 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 for cross-border French-German invoicing. Use ZUGFeRD 2.x with EN16931 for general EU B2B, XRECHNUNG conformance for German public sector, and ZUGFeRD/Factur-X for international DACH-FR workflows.
Which ZUGFeRD Version should I choose in Zapier for the 2025 German B2B e-invoicing mandate?+
The German Wachstumschancengesetz (Growth Opportunities Act) made e-invoice receipt mandatory for all B2B transactions from 1 January 2025, with full sending obligations phasing in through 2028. ZUGFeRD 2.0 or higher with EN16931 or XRECHNUNG conformance is required to satisfy the mandate. ZUGFeRD 1.0 is legacy and does not comply. The Zapier action exposes 1.0 as a default in some installations: explicitly switch to 2.0+ for compliant production workflows. Confirm the exact version your trading partner or invoicing portal accepts; some larger enterprises and government portals may require version 2.2 or 2.4 specifically.
What is the difference between XmlWithPdf and XmlOnly output modes?+
XmlWithPdf generates the standard ZUGFeRD hybrid invoice: a PDF/A-3 archival document with the structured XML invoice data embedded as an attachment inside the PDF. Humans read the PDF, machines parse the XML: one file serves both audiences and is the canonical ZUGFeRD format for B2B. XmlOnly generates a pure XML file with no PDF wrapper, used when the receiving system only ingests XML, typical for XRechnung pure-XML public-sector portals, EDI pipelines, or data-layer integration testing. Choose XmlWithPdf for production B2B invoicing; XmlOnly for pure-XML system integration or compliance submissions that explicitly require XML-only delivery.
Which Conformance Level should I pick: BASIC, COMFORT, EXTENDED, EN16931, or XRECHNUNG?+
Conformance levels differ by ZUGFeRD version. For ZUGFeRD 1.0: BASIC (minimum legal invoice with line items), COMFORT (additional reference data on top of BASIC), and EXTENDED (industry-specific fields beyond the baseline) are available. For ZUGFeRD 2.x: MINIMUM (header only, not a legal invoice: for internal use only), BASICWL (Basic Without Lines, adds VAT but no line items, for booking-only), BASIC (line items, minimum EU directive), EN16931 (European Standard full profile, recommended default for EU B2B), EXTENDED (industry-specific fields), and XRECHNUNG (German public-sector mandatory profile with stricter validation). Start with BASIC for ZUGFeRD 1.0 workflows and EN16931 for ZUGFeRD 2.x B2B. Switch to XRECHNUNG when invoicing German federal, state, or municipal authorities.
Can I generate ZUGFeRD invoices from CSV data, and how do CSV, JSON, and XML inputs compare?+
Yes. The Input Format parameter supports XML, JSON, and CSV: pick the format matching your data source. CSV is ideal for batch invoice exports from spreadsheets (Google Sheets, Excel), legacy ERP exports, or per-row billing workflows where each row represents one invoice. JSON is the modern choice when invoice data arrives from a webhook, REST API, or SaaS billing system that emits structured JSON payloads. XML is best when your ERP already produces ZUGFeRD or UBL XML that just needs wrapping in the hybrid PDF. The action automatically maps CSV columns or JSON fields to the ZUGFeRD XML schema before embedding in the output PDF, no manual XML construction is required for CSV or JSON paths. Critical: fill ONLY the data field matching your chosen Input Format. Mapping both Invoice Xml Data and Invoice Csv Data in the same run will fail the validation step.

Actions connexes

Même tâche sur d'autres plateformes

Obtenez de l'aide