Créer une facture ZUGFeRD dans Power Automate
Créer une facture ZUGFeRD est un Power Automate action par PDF4me qui génère une facture électronique hybride conforme à la norme ZUGFeRD, une seule PDFFichier A-3 structuré XML Intégré à l'intérieur. Utilisez-le pour vous conformer à l'obligation de facturation électronique B2B en Allemagne et échanger des factures conformes à la norme EN 16931 avec n'importe quel système. ERPou archiver un fichier que les humains et les machines peuvent lire.
Que fait cette action ?
PDF4me Créer une facture ZUGFeRD construit un Facture électronique hybride conforme à la directive ZUGFeRD, un seul PDF/A-3 archives PDF avec facture structurée XML intégré à l'intérieur, directement dans un Power Automate flux. Les humains lisent le PDF; ERPLes plateformes de compensation et de compensation analysent le XMLL'action satisfait Obligation de facturation électronique B2B en Allemagne (entrée en vigueur le 1er janvier 2025 pour la réception, envoi intégral d'ici 2028) et le sous-jacent EN 16931 Norme européenne. Cartographier les données de facturation comme XML, JSON, ou CSV depuis SharePoint, OneDrive, Outlook, ou Dataverse, et acheminez la sortie hybride vers vos archives, votre ERP, ou votre client en une seule étape.
Comment authentifier mon flux Power Automate ?
Appeler PDF4me à travers Power Automate, le flux nécessite un valide PDF4me API clé sur la PDF4me Connecter Le connecteur permet une authentification sécurisée garantissant la sécurité des communications et validant votre identité en tant qu'utilisateur autorisé. Obtenez ou renouvelez votre clé depuis le tableau de bord développeur.
Informations importantes à ne pas manquer
XML avec PDF Le résultat est un seul fichier : une archive PDF/A-3 avec le ZUGFeRD structuré XML attaché à l'intérieur. Les humains ouvrent le PDF; Les systèmes AP analysent le XML. Ensemble XmlOnly seulement lorsque le système récepteur consomme du pur XML.Données XML de la facture, Données JSON de la facture, ou Données CSV de la facture En fonction du format sélectionné dans la liste déroulante combinée, ne conservez que l'élément correspondant. Le fait de renseigner deux champs de données simultanément est la cause la plus fréquente d'échecs de validation.
Principal Paramètres onglet. Version et format d'entrée de ZUGFeRD est un menu déroulant combiné (ici) 2.0-XML).
Paramètres avancés. Langue par défaut de; accepte également en, fr, it, es, nl, pl, pt, cs.
ZUGFeRD vs Factur-X vs XRechnung : choisissez le bon profil
| Format | Où il est utilisé | Type de sortie | Choisissez quand |
|---|---|---|---|
| ZUGFeRD | Germany, EU B2B, supplier-to-buyer invoicing | Hybrid PDF/A-3 + embedded XML | General B2B; you want one file for humans and machines. |
| Factur-X | France (sister format, technically identical to ZUGFeRD 2.x) | Hybrid PDF/A-3 + embedded XML | Cross-border FR<>DE invoicing; the same hybrid file works on both sides. |
| XRechnung | German public sector (federal, state, municipal) | Strict pure XML profile | You invoice a German public-sector authority; switch to an XRechnung-aligned profile when the receiver demands pure XML. |
Paramètres
Éléments requis pour l'action : Version ZUGFeRD et format d'entrée, mode de sortie, correspondance Facture XML / JSON / CSV Données domaine et niveau de conformité. PDF Contenu du fichier et Nom de fichier ne deviennent nécessaires que lorsque le mode de sortie est XML avec PDF. Nom du fichier de sortie définit le nom du fichier hybride généré. Facture rendue le PDF La valeur par défaut est « vrai ». Langue vies sous Paramètres avancés et par défaut à de.
| Paramètre | Requis | Ce que cela fait | Exemple |
|---|---|---|---|
| ZUGFeRD version and Input Format | Required | Combined dropdown that picks both the ZUGFeRD specification version (1.0, 2.0, etc.) and the shape of your invoice data (XML, JSON, CSV) in a single setting. The value drives which Invoice Data field appears below and which Conformance Level set is offered. | 2.0-XML |
| Output Mode | Required | XmlWithPdf returns the canonical hybrid PDF/A-3 file with the XML embedded inside. XmlOnly returns the XML invoice file alone. PDF File Content and File Name are only required for XmlWithPdf. | XmlWithPdf |
| Invoice XML Data | Conditional | Required when the Input Format part of the combined dropdown is XML. Map your ZUGFeRD XML payload from a previous action (Get file content, Compose, etc.). | File Content |
| Invoice JSON Data | Conditional | Required when the Input Format part is JSON. Map a structured invoice JSON object that PDF4me converts to the ZUGFeRD XML schema before embedding. | File Content |
| Invoice CSV Data | Conditional | Required when the Input Format part is CSV. Map a tabular CSV row that PDF4me converts to the ZUGFeRD XML schema before embedding. | File Content |
| Conformance Level | Required | Profile that controls how rich the invoice data must be. BASIC is the entry-level profile with line items, suitable for most B2B receivers. COMFORT adds additional fields for richer content. EXTENDED is the largest set, used for industry-specific scenarios beyond the EN 16931 baseline. | BASIC |
| Render Invoice on PDF | Required | When set to Yes (default), PDF4me visually renders the invoice content on the PDF pages using your invoice data. Set to No when you supply a pre-designed background PDF and only need the XML embedded without redrawing the content. | Yes |
| PDF File Content | Conditional | Required when Output Mode is XmlWithPdf. Map the background PDF bytes from a previous action (Get file content from SharePoint / OneDrive / Outlook / Dataverse). Skip for XmlOnly. | File Content |
| File Name | Conditional | Required when Output Mode is XmlWithPdf. The source PDF filename with extension. Used for trace and naming context. | abc.pdf |
| Output File Name | Optional | Filename of the generated hybrid file or XML. Use .pdf for XmlWithPdf and .xml for XmlOnly. Helps when the downstream Create file action expects an explicit name. | Zugferd-output.pdf |
| Language | Optional | Advanced parameter. Locale used for invoice labels in the rendered PDF. Default de. Accepted codes: de, en, fr, it, es, nl, pl, pt, cs. The XML data itself stays language-neutral. | de |
Options du mode de sortie
XML avec PDFPar défaut. Fichier hybride ZUGFeRD canoniqueXmlOnlyAutonome XML factureÉchelle de niveau de conformité
BASIQUEPar défaut. Compatibilité maximale avec les récepteursCONFORTContenu de facture plus richeÉTENDULe plus grand ensemble, spécifique à l'industrieOptions linguistiques (Avancé)
La section des paramètres avancés expose un seul champ, LangueIl contrôle uniquement les paramètres régionaux utilisés pour les étiquettes dessinées sur l'interface visuelle. PDF; le XML Les données restent neutres sur le plan linguistique. La valeur par défaut est de.
| Code | Langue | Utilisation typique |
|---|---|---|
de | German | Default. German domestic invoicing. |
en | English | Cross-border B2B in English-speaking markets. |
fr | French | France or French-speaking Switzerland (also pairs with Factur-X workflows). |
it | Italian | Italy or Italian-speaking Switzerland. |
es | Spanish | Spain and Spanish-speaking partners. |
nl | Dutch | Netherlands and Flemish Belgium. |
pl | Polish | Poland. |
pt | Portuguese | Portugal and Portuguese-speaking partners. |
cs | Czech | Czechia. |
Exemples de fichiers de factures
Utilisez ces outils pour tester le flux avec chaque format d'entrée avant de connecter votre source de données réelle. Pour les flux de production B2B allemands conformes au mandat de 2025, commencez par… JSON 2.0 EN16931 échantillon.
Exemple de facture ZUGFeRD.xmlExemple de facture ZUGFeRD-2.0.xmlsample-invoice-zugferd-2.0-en16931.jsonexemple-facture.jsontest-facture.csvfacture zugferd-2.0.csvMatrice de décision d'entrée et de sortie
| Si vous sélectionnez | Ensuite, la carte | Vous obtenez |
|---|---|---|
| ZUGFeRD version and Input Format = 2.0-XML | Invoice XML Data | ZUGFeRD 2.0 hybrid output (or XML-only) from your existing XML payload |
| ZUGFeRD version and Input Format = 2.0-JSON | Invoice JSON Data | ZUGFeRD 2.0 hybrid from a structured JSON object converted to the schema |
| ZUGFeRD version and Input Format = 2.0-CSV | Invoice CSV Data | ZUGFeRD 2.0 hybrid from a flat CSV row converted to the schema |
| Output Mode = XmlWithPdf | PDF File Content + File Name (background PDF) | PDF/A-3 hybrid file with embedded XML |
| Output Mode = XmlOnly | Invoice data only (no PDF bytes needed) | Standalone ZUGFeRD XML invoice |
Comment configurer la création de factures ZUGFeRD dans Power Automate ?
- Ajouter Créer une facture ZUGFeRD à votre flux comme une nouvelle étape.
- Connectez-vous à PDF4me Connectez-vous avec votre API clé.
- Prendre Version et format d'entrée de ZUGFeRD (Par exemple 2.0-XML, 2.0-JSON, ou 2.0-CSV).
- Ensemble Mode de sortie à XML avec PDF pour le fichier hybride ou XmlOnly pour pur XML.
- Carte seulement le champ de données de facture correspondant (XML, JSON, ou CSV) d'une action précédente.
- Ensemble Niveau de conformité (BASIQUE pour les tests de compatibilité, CONFORT ou ÉTENDU (lorsque votre récepteur confirme la prise en charge).
- Partir Générer la facture au format PDF comme Oui sauf si vous fournissez un arrière-plan prédéfini PDF.
- Pour XML avec PDF, carte Contenu du fichier PDF et Nom de fichier à partir d'une action précédente (Obtenir le contenu du fichier).
- Ensemble Nom du fichier de sortie (
Zugferd-output.pdfouZugferd-output.xml). - Sous Paramètres avancés, ensemble Langue si vous avez besoin d'étiquettes dans une langue autre que l'allemande.
- Itinéraire Contenu du fichier sortie dans SharePoint Créer un fichier, OneDrive Créer un fichier, Outlook Envoyez un e-mail ou un enregistrement Dataverse. Chaîne optionnelle. Valider PDF/UN avant l'archivage.
Sortir
Cette action renvoie le contenu du fichier généré ainsi que les métadonnées que votre flux peut transmettre en aval.
| Champ | Taper | Description |
|---|---|---|
| File Content | Binary | The generated PDF/A-3 hybrid file (XmlWithPdf) or the standalone XML invoice (XmlOnly). |
| FileName (header) | String | Suggested output filename returned in the response headers. |
| PageCount (header) | String | Page count of the generated PDF, returned when Output Mode is XmlWithPdf. |
Dépannage
Si la partie Format d'entrée de la liste déroulante combinée est CSVcarte uniquement Données CSV de la factureNe pas remplir XML / JSON Champs de la même exécution. Choisissez un seul format par appel.
Contenu du fichier PDF doit provenir d'une étape qui renvoie le contenu complet du fichier (Obtenir le contenu du fichier à partir de SharePoint / OneDrive / Outlook pièce jointe), et non des références ne contenant que des métadonnées, comme une requête GET sur un élément qui ne contient pas le fichier.
Commencez par BASIQUE Pour les tests de compatibilité, ne passez à la version supérieure qu'après confirmation de la prise en charge par le système récepteur. ÉTENDU en particulier, peuvent échouer à la validation sur les récepteurs réglés sur la ligne de base EN 16931.
ZUGFeRD 1.0 ne répond pas aux exigences du mandat B2B allemand de 2025. Choisissez la solution 2.0 famille (ou supérieure) dans la version ZUGFeRD et la liste déroulante Format d'entrée pour tout flux de travail sensible aux mandats.
Exemples de flux de travail
Exemples de flux de travailOpen by default. Four common ZUGFeRD automation patterns in a 2x2 grid.
- Déclenchement lorsqu'une ligne de facture est marquée comme approuvée dans Dataverse (ou ERP).
- Établissez la facture JSON à partir des colonnes de lignes et du tableau des éléments de ligne enfants.
- Obtenez la mise en page PDF d'un SharePoint Modèle de bibliothèque de documents.
- Courir Créer une facture ZUGFeRD avec
2.0-JSON,XML avec PDF,EN 16931-conformité alignée. - Enregistrez le contenu du fichier renvoyé dans la bibliothèque d'enregistrements ; chaîne Valider PDF/UN avant la rétention.
Impact: Un seul fichier pour les humains et les machines, parfaitement adapté à l'audit et à l'archivage à long terme.
- Déclencheur lors de l'arrivée d'un nouveau fichier dans un SharePoint mise en scène dossier.
- Lisez le CSV Contenu du fichier pour les lignes de facture.
- Prendre
2.0-CSVdans le menu déroulant combiné ; carteDonnées CSV de la facture. - Ensemble
XML avec PDF, acheminer le résultat vers un factures approuvées bibliothèque.
Impact: Génération par lots reproductible sans outils de bureau manuels.
- Le système en amont génère la facture JSON.
- Exécutez l'action avec
XmlOnly; sauter PDF Contenu du fichier. - POST le retour XML à SAP, à un courtier EDI ou à une chambre de compensation de facturation électronique.
- Identifiants de corrélation des journaux pour la traçabilité du support.
Impact: Passage de relais propre lorsque le PDF Le shell est généré ailleurs.
- Finalisez la facture dans votre système de facturation.
- Générer le fichier hybride ZUGFeRD (
XML avec PDF). - Outlook Envoyez un e-mail avec le PDF/A-3 joint au client.
- SharePoint Créer un fichier dans la bibliothèque d'archives avec des colonnes de métadonnées (numéro de facture, montant, date d'échéance).
Impact: Libre-service client et réduction du nombre de tickets d'assistance pour « mauvais format ».
Cas d'utilisation et applications industrielles
Cas d'utilisation et applications industriellesExpand to see manufacturing, finance, public sector, and SaaS scenarios.
- factures des fournisseurs. PDF hybride/A-3 + XML pour les acheteurs soumis à des règles AP strictes
- Du paiement à l'encaissementAutomatiser les packages de facturation à partir des événements ERP
- Piste d'auditun artefact par envoi ou étape importante
- Comptes débiteurs. des factures électroniques sortantes conformes qui satisfont au mandat de 2025
- Fin de mois. Sortie hybride par lots à partir de données de facturation consolidées
- ArchivesAssocier à une validation PDF/A avant la conservation des enregistrements
- Échange structuré.XmlOnly pour les canaux de compensation obligatoires
- TransparenceLe XML intégré prend en charge la vérification automatisée
- Rétention. se conformer aux politiques internes en matière de gestion des documents
- Exportations de facturation. Générez ZUGFeRD à partir du JSON/CSV que vous avez déjà émis
- Immeuble multi-locataires. Des factures JSON/XML/CSV ou des modèles distincts pour chaque client dans votre flux de travail
- Succès client. moins de boucles manuelles de « renvoi de facture »