Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Wie erstellt man eine ZUGFeRD-Rechnung in Power Automate? Ein Dropbox + JSON Schritt-für-Schritt-Workflow.

· 15 Minuten Lesezeit
Sankalp Mishra
SEO and Content Writer

Dieser Leitfaden zeigt eine vollständige Power Automate Workflow, der einen liest Basis-PDF Und Rechnung JSON von Dropbox, generiert eine ZUGFeRD/Factur-X Rechnung mit PDF4me erstellt ZUGFeRD-Rechnungund schreibt die endgültige Datei zurück in Dropbox.

Die Screenshot-Sequenz verwendet diese Beispielpfade:

  • Basis-PDF: /blog data/zugferd invoice/simplepdf.pdf
  • JSON: /blog data/zugferd invoice/sample-invoice.json
  • Ausgabeverzeichnis: /blog data/zugferd invoice/output
Downloads (Beispieldateien)
Die Kurzfassung

1. Ablauf manuell auslösen → 2. PDF-Basisdatei herunterladen (Dropbox) → 3. JSON-Datei abrufen (Dropbox) → 4. ZUGFeRD-Rechnung erstellen (PDF4me, Eingabeformat = JSON, Ausgabemodus = PDF mit XML) → 5. Datei erstellen (Dropbox-Ausgabeordner).

Denken Sie daran, wenn Sie Schritt 4 konfigurieren.

Satz Eingabeformat = JSONdann nur kartieren Rechnungs-JSON-Daten. Halten Rechnungs-XML-Daten Und Rechnungsdaten (CSV-Datei) In diesem Durchlauf leer. Für PDF mit XML, Inhalt der PDF-Datei ist erforderlich und muss aus dem Basis-PDF-Schritt stammen.

Was Sie aufbauen​

Sie produzieren ein Hybridrechnung (PDF) Aus einer PDF-Vorlage und strukturierten JSON-Daten. Die Ausgabe eignet sich für Teams, die lesbare PDF-Dateien mit maschinenlesbaren Rechnungsdaten benötigen, die gemäß den ZUGFeRD/Factur-X-Konventionen verpackt sind.

Auf einen Blick: alle fünf Schritte​

1Trigger
2Get PDF
3Get JSON
4Create ZUGFeRD
5Save output

Warum dieses Workflow-Layout funktioniert​

Getrennte Eingänge

PDF und JSON werden unabhängig voneinander abgerufen, sodass Sie Nutzdatendateien aktualisieren können, ohne den visuellen PDF-Vorlagenablauf zu beeinträchtigen.

Einzelgenerationsschritt

ZUGFeRD-Rechnung erstellen empfängt beide Inhaltsquellen an einem Ort und gibt eine direkt von Dropbox verwendbare Ausgabedatei zurück. Datei erstellenDie

Später lässt sich problemlos verzweigen.

Nach der Generierung können Sie Validierungen, Benachrichtigungen, ERP-/API-Bereitstellung oder Archivierungsrouting hinzufügen, ohne den Kernablauf umstrukturieren zu müssen.

Bevor Sie beginnen​

Checklist

In dieser Anleitung verwendete Eingabedateien​

Vorschau des Basis-PDF-Dokuments, das als PDF-Eingabe für die Aktion „ZUGFeRD-Rechnung erstellen“ verwendet wird.

Basis-PDF-Eingabedatei.

Rechnungs-JSON-Payload-Inhalt, der die der ZUGFeRD-Generation zugeordneten Rechnungsfelder anzeigt

Eingabe der JSON-Payload für Rechnungen.

Der Ablauf im Überblick (fünf Schritte)​

  1. Einen Ablauf manuell auslösen: Wird bei Bedarf während der Konfiguration ausgeführt.
  2. Basis-PDF-Datei herunterladen (Dropbox): Liest die PDF-Vorlagenbytes.
  3. JSON-Datei abrufen (Dropbox): Liest JSON-Bytes/Inhalt von Rechnungen.
  4. ZUGFeRD-Rechnung erstellen (PDF4me): Kombiniert Eingaben im JSON-Modus.
  5. Datei erstellen (Dropbox): Speichert die generierte Ausgabe im Zielordner.

Ablaufübersicht​

Power Automate-Flow: Flow manuell auslösen, Basis-PDF-Datei abrufen, JSON-Datei abrufen, ZUGFeRD-Rechnung erstellen, Datei erstellen

Vollständiger Ablauf, der für dieses ZUGFeRD-Generierungsmuster verwendet wurde.

Schritt 1: PDF-Basisdatei herunterladen (Dropbox)​

Bisheriger Ablauf: Auslöser → Basis-PDF-Datei abrufen.

  1. Hinzufügen Dropbox Aktion zum Abrufen von Dateiinhalten anhand des Pfades.
  2. Satz Dateipfad zur Basis-PDF-Vorlage (Beispiel: /blog data/zugferd invoice/simplepdf.pdf).
  3. In den erweiterten Optionen behalten Sie Folgendes bei: Inhaltstyp ableiten = JaDie
  4. Speichern und testen Sie diesen Schritt; stellen Sie sicher, dass er Dateiinhalt/Binärausgabe zurückgibt.
Dropbox-Aktion „Basis-PDF-Datei abrufen“ zeigt Dateipfad „blog data zugferd invoice simplepdf.pdf“ an und wählt „Inhaltstyp ableiten“: Ja

Screenshot aus Schritt 1: Basis-PDF-Pfad und Inhaltsinferenz konfiguriert.

Schritt 2: JSON-Datei abrufen (Dropbox)​

Bisheriger Ablauf: Auslöser → Basis-PDF abrufen → JSON-Datei abrufen.

  1. Füge eine weitere Dropbox-Dateiinhaltsaktion hinzu.
  2. Satz Dateipfad zu Ihren Rechnungsdaten im JSON-Format (Beispiel: /blog data/zugferd invoice/sample-invoice.json).
  3. Halten Inhaltstyp ableiten = JaDie
  4. Speichern und testen; überprüfen Sie, ob der JSON-Inhalt in Schritt 3 für das Mapping verfügbar ist.
Dropbox-Aktion „JSON-Datei abrufen“ zeigt Dateipfad an: Blogdaten, Zugferd-Rechnung, Beispiel-Rechnung.json. Inhaltstyp wird abgeleitet: Ja.

Schritt 2 (Screenshot): JSON-Quelldatei aus Dropbox.

Schritt 3: ZUGFeRD-Rechnung erstellen (PDF4me)​

Bisheriger Ablauf: Auslöser → Basis-PDF abrufen → JSON abrufen → ZUGFeRD erstellen.

Konfigurieren PDF4me, ZugFeRD-Rechnung erstellen wie abgebildet:

  1. Dateiname: Name der Quell-PDF (Beispiel: Test.pdf).
  2. Inhalt der PDF-Datei: Karte von Basis-PDF-Datei herunterladenDie
  3. Name der Ausgabedatei: gewünschter Ausgabedateiname (Beispiel: Zugferd Invoice.pdf).
  4. Eingabeformat: eingestellt auf JSONDie
  5. Ausgabemodus: eingestellt auf PDF mit XMLDie
  6. Rechnungs-JSON-Daten: Karte von JSON-Datei abrufenDie
  7. Konformitätsgrad: Beispiel: BASICDie
  8. ZUGFeRD Version: Beispiel: 1.0 (oder die von Ihnen benötigte Version).
  9. Rechnung als PDF ausgeben: Beispiel: JaDie
ZUGFeRD-Rechnungsaktion erstellen mit Anzeige von Dateiname, PDF-Dateiinhalt, Ausgabedateiname, Eingabeformat JSON, Ausgabemodus PDF mit XML, Rechnungsdaten (JSON), Konformität BASIC, ZUGFeRD-Version 1.0, Rechnung als PDF rendern: Ja

Screenshot aus Schritt 3: Vollständige Parameterzuordnung für die JSON-basierte ZUGFeRD-Generierung.

Schritt 4: Datei erstellen (Dropbox)​

Bisheriger Ablauf: Trigger → PDF + JSON lesen → ZUGFeRD generieren → Datei speichern.

  1. Hinzufügen Dropbox: Datei erstellenDie
  2. Ordnerpfad: Ausgabezielordner (Beispiel: /blog data/zugferd invoice/output).
  3. Dateiname: Ausgabedateiname zuordnen von ZUGFeRD-Rechnung erstellenDie
  4. Dateiinhalt: generierten Dateiinhalt zuordnen von ZUGFeRD-Rechnung erstellenDie
  5. Speichern und den gesamten Ablauf ausführen.
Dropbox-Aktion „Datei erstellen“ mit Ordnerpfad, Blogdaten, Zugferd-Rechnungsausgabe und zugeordnetem Dateinamen und Dateiinhalt aus „Zugferd-Rechnung erstellen“.

Screenshot aus Schritt 4: Ausgabedatei wird zurück in Dropbox geschrieben.

Ausgabeprüfung​

Beispiele für offene Ausgaben
Visuelle Ausgabe der generierten ZUGFeRD-Rechnungs-PDF nach der Aktion „ZUGFeRD-Rechnung erstellen“.

Generierte Rechnungs-PDF-Ausgabe.

Die Ausgabe wurde mit einem Anhangsfenster geöffnet, das die eingebetteten XML-Daten in der generierten ZUGFeRD-Rechnungs-PDF anzeigte.

Anhangansicht mit eingebetteten strukturierten Rechnungsdaten.

Kurzübersicht​

#SchrittTastenzuordnung
1Get Base PDF FileFile path to template PDF + Infer Content Type = Yes
2Get JSON FileFile path to invoice JSON + Infer Content Type = Yes
3Create ZUGFeRD InvoicePDF File Content from step 1, Input Format = JSON, Invoice JSON Data from step 2
4Create fileFile Name and File Content from Create ZUGFeRD Invoice output

Detaillierte Parameterreferenzen: ZUGFeRD-Rechnung erstellen, PDF validierenDie

Fehlerbehebung​

Die Generierung schlägt aufgrund der Eingabezuordnung fehl.

Wenn Eingabeformat = JSON, nur Karte Rechnungs-JSON-DatenLöschen Sie die XML/CSV-Felder für diesen Lauf.

Ausgabemodus stimmt nicht überein

Mit PDF mit XML, fehlen Inhalt der PDF-Datei verursacht Fehler. Map-Dateibytes aus dem Basis-PDF-Schritt.

401, 402 oder Verbindungsprobleme

Sehen PDF4me-Fehlerbehebung für API-Schlüssel, Guthaben und Connector-Autorisierungsprüfungen.

Was Sie als Nächstes versuchen sollten​

Optionale Härtung: hinzufügen Zustand Nach Schritt 3 wird geprüft, ob eine Ausgabe vorhanden ist. Anschließend erfolgt eine Verzweigung zu Erfolgs-/Fehlerbenachrichtigungen, bevor die Datei endgültig geschrieben wird.

Power Automate

API-Schlüssel abrufen

ZUGFeRD-Rechnung erstellen (Dokumente)

PDFA (Dokumente) validieren