Aller au contenu principal
API PDF4meIntégrationsBase de connaissancesExtensionsTesteur d'APIBlog

Comment créer une facture ZUGFeRD dans Power Automate ? Un flux de travail étape par étape avec Dropbox et JSON.

· 16 minutes de lecture
Sankalp Mishra
SEO and Content Writer

Ce guide présente un aperçu complet Power Automate flux de travail qui lit un PDF de base et facture JSON à partir de Dropbox, génère un ZUGFeRD/Factur-X facture utilisant PDF4me Créer une facture ZUGFeRDet réenregistre le fichier final sur Dropbox.

La séquence de captures d'écran utilise les chemins d'accès suivants :

  • PDF de base : /données du blog/facture zugferd/simplepdf.pdf
  • JSON : /données du blog/facture zugferd/exemple-de-facture.json
  • Dossier de sortie : /données du blog/facture Zugferd/sortie
Téléchargements (fichiers d'exemple)
La version courte

1. Déclencher manuellement le flux → 2. Télécharger le fichier PDF de base (Dropbox) → 3. Récupérer le fichier JSON (Dropbox) → 4. Créer une facture ZUGFeRD (PDF4me, Format d'entrée = JSON, Mode de sortie = PDF avec XML) → 5. Créer un fichier (dossier de sortie Dropbox).

N'oubliez pas cela lors de la configuration de l'étape 4.

Ensemble Format d'entrée = JSON, alors mapper uniquement Données JSON de la facture. Garder Données XML de la facture et Données CSV de la facture vide dans cette exécution. Pour PDF avec XML, Contenu du fichier PDF est requis et doit provenir de l'étape PDF de base.

Ce que vous êtes en train de construire​

Vous produisez un facture hybride PDF À partir d'un modèle PDF et de données JSON structurées, le résultat est adapté aux équipes qui ont besoin d'un PDF lisible contenant des données de facturation exploitables par machine et formatées selon les conventions ZUGFeRD/Factur-X.

En bref : les cinq étapes​

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

Pourquoi cette organisation du flux de travail fonctionne​

Entrées séparées

Les fichiers PDF et JSON sont récupérés indépendamment, vous pouvez donc mettre à jour les fichiers de charge utile sans modifier le flux du modèle PDF visuel.

Étape de génération unique

Créer une facture ZUGFeRD reçoit les deux sources de contenu en un seul endroit et renvoie un fichier de sortie directement utilisable par Dropbox. Créer un fichier.

Facile de créer des branches ultérieurement

Après la génération, vous pouvez ajouter la validation, les notifications, la distribution ERP/API ou le routage des archives sans restructurer le flux principal.

Avant de commencer​

Liste de contrôle
  • Power Automate environnement disposant des autorisations nécessaires pour créer des flux cloud.
  • Clé API PDF4me. Première configuration : Connectez PDF4me à Power Automate.
  • Connexion Dropbox avec accès en lecture aux fichiers sources et accès en écriture au dossier de sortie.
  • Un fichier JSON de facture valide et un fichier PDF de base disponibles sur Dropbox.

Fichiers d'entrée utilisés dans ce guide​

Aperçu du document PDF de base utilisé comme entrée PDF pour l'action Créer une facture ZUGFeRD

Fichier d'entrée PDF de base.

Contenu de la charge utile JSON de la facture montrant les champs de la facture mappés à la génération ZUGFeRD

Saisie de la charge utile JSON de la facture.

Aperçu du flux (cinq étapes)​

  1. Déclencher manuellement un fluxExécuter à la demande pendant la configuration.
  2. Obtenir le fichier PDF de base (Dropbox) : Lit les octets du modèle PDF.
  3. Récupérer le fichier JSON (Dropbox) : Lit les octets/le contenu JSON de la facture.
  4. Créer une facture ZUGFeRD (PDF4me) : Combine les entrées en utilisant le mode JSON.
  5. Créer un fichier (Dropbox) : Enregistre les données générées dans le dossier cible.

Aperçu du flux​

Flux Power Automate : Déclencher manuellement un flux, Obtenir le fichier PDF de base, Obtenir le fichier JSON, Créer une facture ZUGFeRD, Créer un fichier

Chaîne de flux complète utilisée pour ce modèle de génération ZUGFeRD.

Étape 1 : Obtenir le fichier PDF de base (Dropbox)​

Flux jusqu'à présent : Déclencheur → Obtenir le fichier PDF de base.

  1. Ajouter Dropbox action permettant de récupérer le contenu d'un fichier par son chemin d'accès.
  2. Ensemble Chemin du fichier au modèle PDF de base (exemple : /données du blog/facture zugferd/simplepdf.pdf).
  3. Dans les options avancées, conservez Déduire le type de contenu = Oui.
  4. Enregistrez et testez cette étape ; assurez-vous qu’elle renvoie le contenu du fichier/la sortie binaire.
Action Dropbox « Obtenir le fichier PDF de base » affichant le chemin d'accès au fichier, les données du blog, la facture Zugferd, simplepdf.pdf et le type de contenu déduit : Oui

Capture d'écran de l'étape 1 : chemin du PDF de base et inférence de contenu configurés.

Étape 2 : Obtenir le fichier JSON (Dropbox)​

Flux jusqu'à présent : Déclencheur → Obtenir le PDF de base → Obtenir le fichier JSON.

  1. Ajouter une autre action de contenu de fichier Dropbox.
  2. Ensemble Chemin du fichier à vos données de facture JSON (exemple : /données du blog/facture zugferd/exemple-de-facture.json).
  3. Garder Déduire le type de contenu = Oui.
  4. Enregistrez et testez ; vérifiez que le contenu JSON est disponible pour le mappage à l'étape 3.
Action Dropbox « Obtenir un fichier JSON » affichant le chemin d'accès au fichier, les données du blog, la facture Zugferd (exemple : sample-invoice.json) et l'option « Inférer le type de contenu » (Oui).

Capture d'écran de l'étape 2 : fichier source JSON provenant de Dropbox.

Étape 3 : Créer une facture ZUGFeRD (PDF4me)​

Flux jusqu'à présent : Déclencheur → Obtenir le PDF de base → Obtenir le JSON → Créer ZUGFeRD.

Configure PDF4me, Créer une facture ZUGFeRD comme indiqué :

  1. Nom de fichier: nom du PDF source (exemple : Test.pdf).
  2. Contenu du fichier PDF: carte de Obtenir le fichier PDF de base.
  3. Nom du fichier de sortie: nom du fichier de sortie souhaité (exemple : Facture Zugferd.pdf).
  4. Format d'entrée: défini sur JSON.
  5. Mode de sortie: défini sur PDF avec XML.
  6. Données JSON de la facture: carte de Récupérer le fichier JSON.
  7. Niveau de conformité: exemple: BASIQUE.
  8. Version ZUGFeRD: exemple: 1.0 (ou la version que vous souhaitez).
  9. Générer la facture au format PDF: exemple: Oui.
Création d'une facture ZUGFeRD : nom du fichier, contenu du fichier PDF, nom du fichier de sortie, format d'entrée JSON, mode de sortie PDF avec XML, données JSON de la facture, conformité BASIC, version ZUGFeRD 1.0, rendu de la facture au format PDF : oui

Capture d'écran de l'étape 3 : mappage complet des paramètres pour la génération de ZUGFeRD basée sur JSON.

Étape 4 : Créer un fichier (Dropbox)​

Flux jusqu'à présent : Déclencheur → Lire PDF + JSON → Générer ZUGFeRD → Enregistrer le fichier.

  1. Ajouter Dropbox : Créer un fichier.
  2. Chemin du dossier: dossier cible de sortie (exemple : /données du blog/facture Zugferd/sortie).
  3. Nom de fichier: nom du fichier de sortie de la carte Créer une facture ZUGFeRD.
  4. Contenu du fichier: mapper le contenu du fichier généré à partir de Créer une facture ZUGFeRD.
  5. Enregistrez et exécutez le flux complet.
Action Dropbox Créer un fichier avec chemin de dossier, données de blog, sortie de facture Zugferd et nom de fichier mappé et contenu du fichier à partir de Créer une facture ZUGFeRD

Capture d'écran de l'étape 4 : écriture du fichier de sortie dans Dropbox.

Vérification des résultats​

Exemples de sortie ouverte
Résultat visuel du PDF de la facture ZUGFeRD généré après l'action « Créer une facture ZUGFeRD ».

Facture générée au format PDF.

Le document PDF généré pour la facture ZUGFeRD s'ouvre avec un panneau de pièces jointes affichant les données XML intégrées.

Vue de la pièce jointe affichant les données structurées de la facture intégrées.

Guide de référence rapide​

#ÉtapeCartographie des clés
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

Références aux paramètres approfondis : Créer une facture ZUGFeRD, Valider le PDF.

Dépannage​

La génération échoue en raison du mappage des entrées.

Si Format d'entrée = JSONcarte uniquement Données JSON de la factureEffacer les champs XML/CSV pour cette exécution.

Incompatibilité du mode de sortie

Avec PDF avec XML, manquant Contenu du fichier PDF provoque des erreurs. Mapper les octets du fichier à partir de l'étape PDF de base.

Erreurs 401, 402 ou problèmes de connexion

Voir Dépannage de PDF4me pour les vérifications de clé API, de crédits et d'autorisation de connecteur.

Que faire ensuite ?​

Durcissement optionnel : ajouter un Condition Après l'étape 3 pour vérifier la présence de la sortie, passez ensuite aux notifications de succès/échec avant l'écriture finale du fichier.

Power Automate

Obtenir la clé API

Créer une facture ZUGFeRD (documentation)

Valider PDFA (documents)