Créer ZUGFeRD Facture dans Make
Créer ZUGFeRD Facture est un Make module par PDF4me qui génère des hybrides ZUGFeRD/Factur-X factures électroniques de CSV, JSON, ou XML Données de facturation. Utilisez-les pour produire un PDF/A-3 document avec lecture automatique XML intégré à l'intérieur, aligné sur le EN 16931 Norme européenne de facturation électronique. Choisissez le niveau de conformité et la version des spécifications correspondant aux exigences de votre acheteur ou ERP le système requiert.
Que fait ce module ?
PDF4meCréez un ZUGFeRD facture génère des factures électroniques hybrides directement dans votre Make scénario. Fournir les données de facturation comme CSV, JSON, ou XML.le module produit un PDF/A-3 document avec un lisible par machine ZUGFeRD XML fichier intégré à l'intérieur, ou un XML-sortie uniquement pour ERP systèmes qui gèrent leur propre rendu. Le résultat est conforme à EN 16931 La facturation électronique est une norme européenne et est acceptée comme Factur-X En France et sur l'ensemble des marchés de l'UE, les niveaux de conformité et la version des spécifications sont configurables pour répondre précisément aux exigences de votre acheteur ou du bénéficiaire du secteur public.
Authentification de votre API Demande
Chaque PDF4me module dans Make nécessite un numéro valide ConnexionCréez ou sélectionnez-en un qui contient votre PDF4me API clé permettant au scénario d'appeler le service de génération de factures en toute sécurité.
Informations importantes à ne pas manquer
La sortie hybride est une PDF/A-3 document. le ZUGFeRD XML est intégré en tant que pièce jointe conforme au sein du fichier. ERP Les systèmes extraient les XML automatiquement ; les humains peuvent toujours ouvrir et lire le PDF dans n'importe quelle visionneuse standard. Définir Générer la facture au format PDF Répondre à Oui pour que les lignes de facture soient affichées visuellement sur la page.
La version 1.0 prend en charge BASIQUE, CONFORT, PROLONGÉLa version 2+ s'étend à MINIMUM, BASICWL, BASIC, EN16931, ÉTENDU, XRECHNUNG. XRECHNUNG et EN16931 Ces documents sont obligatoires pour la facturation du secteur public en Allemagne. Veillez à toujours utiliser la version et le niveau requis par le système de l'acheteur.
Sélectionner XML montre Données XML de la facture champ; JSON affiche les données JSON de la facture ; CSV Affiche les données CSV de la facture. Ne remplissez que le champ correspondant au format choisi. XML au format, le module expose également un Déposer radio pour que vous puissiez tirer le XML directement depuis Dropbox ou en l'important à partir d'un module précédent.
Lequel ZUGFeRD La version que je dois utiliser ?
Ce module prend en charge deux versions de spécification. La plupart des nouvelles intégrations devraient utiliser la version 2.0 ou supérieure ; la version 1.0 est conservée pour l’interopérabilité avec les systèmes existants.
ZUGFeRD 2.0+ RECOMMANDÉ
Niveaux de conformité aux spécifications actuelles : MINIMUM, BASICWL, BASIQUE, EN16931 (Confort, le régime légal par défaut en Allemagne), ÉTENDU, XRECH. Compatible avec Factur-X. Associez-le à 2.0 XML échantillon, 2.0 EN16931 JSON échantillon, ou 2.0 CSV échantillonLes captures d'écran ci-dessous montrent l'interface utilisateur de la version 2.0+ telle qu'elle s'affiche aujourd'hui.
ZUGFeRD 1.0 HÉRITAGE
Pré-EN 16931 Niveaux de conformité aux spécifications : BASIQUE, CONFORT, ÉTENDUÀ utiliser uniquement lorsqu'un destinataire ERP ou le système d'achat exige explicitement la version 1.0 (rare après 2022). À associer avec le 1.0 XML échantillon, le basique JSON échantillon, ou le 1.0 CSV échantillonTous les autres champs fonctionnent de la même manière ; seule la liste déroulante du niveau de conformité change.
Commencez par Connexion, puis cartographier la base PDF (Nom de fichier, Document) et ensemble Format d'entrée (ici XML).
Avec Déposer = Carte, carte Données XML de la facture, ensemble Mode de sortie (XML avec PDF ou XmlOnly), puis choisissez zugferd Version (ici 1.0).
Paramètres
Requis: Connexion, Format d'entrée, Mode de sortie, ZUGFeRD Version. Le champ de données de la facture (Données XML de la facture, Données JSON de la facture, ou Données CSV de la facture) s'affiche dynamiquement en fonction du format de saisie sélectionné. Seul le champ correspondant doit être rempli.
Pourquoi Déposer apparaissent-ils deux fois dans les captures d'écran de la version 2.0+ ? Lorsque le format d'entrée est XML et le fichier est défini sur CarteLe module affiche un second sélecteur de fichiers afin que vous puissiez mapper à la fois (a) le sélecteur de base PDF le ZUGFeRD La facture doit être intégrée à, et (b) la source ZUGFeRD XML fichier. Les deux sélecteurs proposent les mêmes options radio. Lorsque le format d'entrée est JSON ou CSV le deuxième sélecteur est remplacé par le sélecteur correspondant Données JSON de la facture ou Données CSV de la facture champ de texte.
| Paramètre | Requis | Ce que cela fait | Exemple / Options |
|---|---|---|---|
| Connection | Required | PDF4me API connection used to authenticate invoice generation requests. Click Add and paste your API key if connecting for the first time. | Your PDF4me connection |
| File | Conditional | Source of the base PDF where the ZUGFeRD invoice will be embedded (when Output Mode is XmlWithPdf). Radio button with two options: Dropbox - Download a File (pulls directly from a Dropbox account without a prior download step) or Map (supplies the PDF from a prior module. Dropbox, Google Drive, OneDrive, HTTP, etc.). Choose Map for the most flexible workflow. When Map is selected, the two sub-fields below appear. | Map |
| File → File Name | Conditional | Sub-field of File (visible when Map is selected). Filename of the base PDF including the .pdf extension. Map from the prior module's filename output. for example, the File Name field of a Dropbox or Google Drive Download module. | 1. File Name |
| File → Document | Conditional | Sub-field of File (visible when Map is selected). Binary PDF content where the ZUGFeRD XML will be embedded. Map from the prior module's binary data field. typically the Data field of Dropbox, Google Drive, or OneDrive download modules. Hint shown in module: "PDF file where Zugferd invoice should be added". | 1. Data |
| Input Format | Required | Format of the invoice data being supplied. Use XML for existing ZUGFeRD XML; JSON or CSV for structured data. Hint: "Format of the invoice data being supplied. Use XML for existing ZUGFeRD XML, JSON or CSV for structured data." | XML sampleXML 2.0 sampleJSON 2.0 EN16931 sampleJSON (basic)CSV sampleCSV 2.0 sample |
| Invoice XML Data | Conditional | The ZUGFeRD XML invoice content to embed. Appears when Input Format = XML and File = Map. Hint: "Use when inputFormat is XML, please refer to our Create a ZUGFeRD invoice for guidelines." Map from a prior Dropbox download or HTTP module output. | XML sampleXML 2.0 sample3. Data (mapped) |
| Invoice JSON Data | Conditional | Structured invoice data in JSON format. Appears when Input Format = JSON. Map a JSON string from a Google Sheets, Airtable, or HTTP module. See sample JSON below. | JSON 2.0 EN16931 sampleJSON (basic)(mapped JSON string) |
| Invoice CSV Data | Conditional | Invoice row data in CSV format. Appears when Input Format = CSV. Map a CSV row from an iterator, Google Sheets, or file download module. See sample CSV below. | CSV sampleCSV 2.0 sample(mapped CSV row) |
| Output Mode | Required | XML With PDF (a.k.a XmlWithPdf in API requests) returns a PDF/A-3 file with the ZUGFeRD XML embedded inside, the standard hybrid e-invoice. XML Only (XmlOnly) returns just the XML invoice file without a PDF wrapper. Hint shown in module: "XML with PDF returns a PDF with embedded ZUGFeRD XML. XML only returns only the XML invoice file." | XML With PDF |
| ZUGFeRD Version | Required | ZUGFeRD specification version. Set to match what the recipient ERP or buyer system expects. Latest is 2+; legacy 1.0 also supported. The two have different conformance level sets (see table below). | 2+ |
| Conformance Level | Optional | ZUGFeRD conformance profile. Available levels differ by version. For 2+, EN16931 (Comfort) is the default for German legal e-invoicing compliance. See the Conformance Level Reference table below. Defaults to BASIC if not specified. | EN16931 |
| Render Invoice on PDF | Optional | When set to Yes, invoice line items are drawn visually on the PDF pages. Applies only when Output Mode is XmlWithPdf. Options: Yes, No, Empty. Hint: "Render invoice data visually on PDF pages. Applies only when outputMode is XmlWithPdf." | Yes |
| language | Optional | Two-letter locale code for invoice label localisation. Supported: de, en, fr, it, es, nl, pl, pt, cs. Hint: "Language code for invoice localisation (e.g. de, en, fr, it, es, nl, pl, pt, cs). Defaults to de if not specified." | de |
Référence au niveau de conformité
Les niveaux de conformité disponibles diffèrent par zugferd VersionAdaptez toujours le niveau à celui de votre acheteur ou ERP le système requiert.
| Niveau | À utiliser lorsque |
|---|---|
BASIC | Mandatory EN 16931 fields only. Widest compatibility, safe default. |
COMFORT | Adds optional fields for line-item detail and additional references. |
EXTENDED | Full field set for complex B2B invoices with delivery, allowances, and charges. |
| Niveau | À utiliser lorsque |
|---|---|
MINIMUM | Absolute minimum fields. Buyer reference and totals only. |
BASICWL | BASIC without line items. Header-level data only. |
BASIC | Mandatory EN 16931 fields. Recommended starting point. |
EN16931 | Full EN 16931 compliance for cross-border and public sector. |
EXTENDED | Full field set including German-specific extensions. |
XRECHNUNG | German public-sector e-invoice mandate (XRechnung profile). |
Exemples de fichiers de factures
Utilisez ces exemples de fichiers pour tester le module 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 de facture ZUGFeRD.xmlExemple de facture ZUGFeRD-2.0.xmlsample-invoice-zugferd-2.0-en16931.jsonexemple-facture.jsontest-facture.csvfacture zugferd-2.0.csvCSV Référence de colonne
Le CSV Les données saisies doivent respecter exactement l'ordre des colonnes indiqué. Chaque ligne correspond à une facture.
| Colonne | Description | Exemple |
|---|---|---|
InvoiceId | Unique invoice identifier | INV-2025-001 |
IssueDate | Invoice issue date (YYYY-MM-DD) | 2025-01-15 |
SellerName | Seller company name | Test Company |
SellerStreet | Seller street address | 123 Main St |
SellerCity | Seller city | Test City |
SellerPostalCode | Seller postal / ZIP code | 12345 |
SellerCountry | ISO 3166-1 alpha-2 country code | DE |
SellerVatId | Seller VAT registration number | DE123456789 |
BuyerName | Buyer company or person name | Customer Inc |
BuyerStreet | Buyer street address | 456 Oak Ave |
BuyerCity | Buyer city | Customer City |
BuyerPostalCode | Buyer postal / ZIP code | 67890 |
BuyerCountry | ISO 3166-1 alpha-2 country code | DE |
ProductName | Line item product or service name | Test Product |
Quantity | Quantity of the line item | 10.0 |
UnitPrice | Net unit price | 9.90 |
TaxPercent | VAT / tax percentage | 19.0 |
Currency | ISO 4217 currency code | EUR |
PaymentReference | Payment reference string | PAY-REF-001 |
IBAN | Payee IBAN for bank transfer | DE08700901001234567890 |
BIC | Payee bank BIC / SWIFT code | GENODEF1M04 |
JSON Structure de la facture
Lors de l'utilisation Format d'entrée : JSONLa charge utile doit inclure les clés de premier niveau suivantes. Tous les objets et tableaux imbriqués respectent la structure indiquée dans le fichier d'exemple.
| Clé | Taper | Description |
|---|---|---|
InvoiceId | String | Unique invoice number, e.g. "471102" |
IssueDate | String (ISO 8601) | Invoice date, e.g. "2013-03-05T00:00:00" |
InvoiceType | String | Document type label, e.g. "RECHNUNG" |
TypeCode | String | UN/EDIFACT document type code. 380 for standard invoice |
IsTest | Boolean | true for test runs, false / omit for production |
Notes | Array of strings | Free-text notes shown in the invoice header (payment terms, GLN, etc.) |
Seller | Object | Seller party: Name, Address (Street, City, PostalCode, Country), TaxId, VatId, GLN |
Buyer | Object | Buyer party: Name, Address (Street, City, PostalCode, Country, LineTwo), GLN |
Payment | Object | Payment details: PaymentReference, Currency, IBAN, BIC |
DeliveryDate | String (ISO 8601) | Actual delivery date, e.g. "2013-03-05T00:00:00" |
LineItems | Array of objects | Invoice lines. each with Quantity, UnitCode, UnitPrice, LineTotal, ProductName, GTIN, SellerProductId |
Totals | Object | Monetary totals: LineTotal, ChargeTotal, AllowanceTotal, TaxBasisTotal, TaxTotal, GrandTotal, TaxPercent, Currency |
Comment créer un ZUGFeRD facture dans Make?
- Ajouter PDF4me → Créer un ZUGFeRD facture à votre situation.
- Sélectionner Connexion (ou cliquez Ajouter pour en créer un avec votre API clé).
- Choisir Format d'entrée. XML, JSON, ou CSVLe champ de données qui apparaît dépend de cette sélection.
- Ensemble Déposer à Carte et connectez le champ de données de la facture (données XML / JSON / CSV) issu du module précédent. Ou choisissez Dropbox - Télécharger un fichier pour récupérer le fichier directement depuis Dropbox.
- Ensemble Mode de sortie à XML avec PDF pour un hybride PDF/A-3 facture, ou XmlOnly pour XML seulement.
- Ensemble zugferd Version (1.0 ou 2+) puis choisissez Niveau de conformité de l'ensemble approprié à la version. Commencez par BASIQUE.
- Si vous utilisez XmlWithPdf : définissez Générer la facture au format PDF à Oui dessiner visuellement les éléments de ligne et définir langue à votre langue cible (par exemple,
de,en,fr). - Sauvegarder et cliquez Exécuter une fois. Itinéraire Données du document exportation vers Dropbox, Google Drive, un ERP webhook ou module de messagerie.
Champs de sortie
| Champ | Taper | Ce qu'il contient |
|---|---|---|
Document Name | String | Filename of the generated invoice file. e.g. invoice-471102.pdf or invoice-471102.xml. |
Document Data | Buffer | Binary content of the ZUGFeRD hybrid PDF/A-3 or XML file. Map into an upload, email attachment, or ERP HTTP module for the next step in your scenario. |
Exemples de flux de travail
Exemples de flux de travailCommon Make scenario patterns using Create ZUGFeRD Invoice for automated e-invoicing.
- Une commande est marquée comme expédiée dans votre ERP ou Airtable. Le scénario se déclenche.
- Les articles, les prix, l'adresse de l'acheteur et les données fiscales sont extraits et assemblés dans un JSON charge utile.
- Créer ZUGFeRD facture s'exécute avec le format d'entrée JSON, Mode de sortie XML avec PDF, version 2+, Niveau de conformité BASIQUE, langue
de. - L'hybride PDF La facture est envoyée par courriel à l'acheteur via Gmail et une copie est téléchargée dans les archives des factures sur Google Drive.
- La comptabilité perd un CSV Fichier de factures mensuelles dans Dropbox.
- Un déclencheur « Surveillance des fichiers » détecte le nouveau fichier et un itérateur traite chaque ligne.
- Créer ZUGFeRD facture exécutions par ligne avec format d'entrée CSV, générant un hybride PDF par facture.
- Tous PDFs sont téléchargées dans un dossier d'archivage structuré et un courriel récapitulatif de la finalisation est envoyé à l'équipe financière.
- Une facture de contrat gouvernemental est générée à partir d'un enregistrement Airtable.
- Créer ZUGFeRD facture s'exécute avec le format d'entrée JSON, Mode de sortie XmlOnly, version 2+, Niveau de conformité XRECHARGE.
- Le XML Le fichier est envoyé directement par la méthode POST au client, compatible avec Peppol. ERP API via un HTTP module.
- Une réponse, qu'il s'agisse de succès ou d'erreur, est consignée dans une feuille Google Sheets pour que l'équipe financière puisse l'examiner.