Facture électronique ZUGFeRD à partir d'une liste SharePoint : Convertissez un fichier JSON en XML EN 16931 et en PDF/A-3 dans Power Automate avec PDF4me

PDF4me Create ZUGFeRD Invoice est une action Power Automate qui transforme les données de facturation en une facture électronique hybride PDF/A-3. Associée à une liste SharePoint, elle utilise le JSON généré par une action Compose à partir de chaque ligne, écrit le XML EN 16931, intègre la facture lisible dans le PDF de base, archive le document et l'envoie par e-mail à l'acheteur.

Recherchez ZUGFeRD et vous trouverez trois solutions : une explication du format, un validateur vérifiant la conformité d'un fichier existant, ou une bibliothèque PHP, Java ou C# pour les développeurs de logiciels de facturation. Ces trois solutions supposent que la facture existe déjà. Or, aucune ne répond à la question que se pose réellement une équipe financière : les données de facturation se trouvent dans une liste, un tableur ou tout autre système enregistrant les ventes, et doivent être converties en facture électronique conforme. Ce processus, en sept étapes et sans code, représente l'étape manquante.

Questions et réponses basées sur le pourquoi​

Ce que vous obtiendrez​

Entrée : une ligne contenant le numéro de facture, les dates, la devise, le nom du vendeur, le nom de l’acheteur et un article. Sortie : une facture ZUGFeRD PDF/A-3 dans la bibliothèque ZUGFeRD Invoices, la ligne mise à jour avec son statut et un lien, et un courriel envoyé à l’acheteur avec la facture en pièce jointe.

Une ligne par facture. Chaque colonne de ce volet devient une clé dans le JSON généré par le flux.

Un fichier par numéro de facture, établi par le compte de flux.

La moitié lisible du même fichier, telle que l'acheteur la voit.

Ce dont vous avez besoin​

Aperçu du flux​

1. When an item is created (SharePoint) surveille la liste nommée ZUGFeRD Requests.
2. Compose génère le JSON de la facture à partir de la ligne.
3. Get file content using path d'accès /ZUGFeRD Templates/BaseInvoice.pdf.
4. Create ZUGFeRD Invoice (PDF4me PDF) convertit le JSON en XML EN 16931 et renvoie le PDF hybride.
5. Create file (SharePoint) l'enregistre sous le nom ZUGFeRD_<invoice number>.pdf.
6. Update item (SharePoint) définit Status sur Generated et remplit OutputLink.
7. Send an email (V2) (Office 365 Outlook) envoie la facture à l'acheteur.

Aperçu complet du flux​

Le processus complet prend environ quatre secondes, et la facture électronique elle-même environ une seconde. L'étape la plus lente est l'écriture du fichier par SharePoint.

Étape 1 : Comment déclencher l’émission d’une facture électronique lorsqu’une demande arrive ?​

Déroulement jusqu'à présent : rien pour l'instant, ceci est le déclencheur.

L'ajout d'une ligne correspond à la manière dont une facture est demandée ; c'est donc le signal.

1. Créez un Automated cloud flow et sélectionnez SharePoint > When an item is created.
2. Configurer :
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • List Name: ZUGFeRD Requests

When an item is created : configuration​

Chaque colonne de la nouvelle ligne devient un jeton que les six actions suivantes peuvent utiliser.

Étape 2 : Comment construire le JSON de la facture à partir des colonnes de la liste ?​

Déroulement jusqu'à présent : le déclencheur SharePoint.

Une seule action Compose suffit pour décrire la facture complète. C'est là que les noms de vos colonnes correspondent aux normes attendues, et le texte est suffisamment court pour être lu sur un seul écran.

1. Ajouter Data Operation > Compose.
2. Collez l'objet ci-dessous dans le champ Inputs et remplacez chaque valeur par le jeton correspondant.

{
  "InvoiceId": "@{triggerBody()?['InvoiceNumber']}",
  "TypeCode": "380",
  "InvoiceType": "RECHNUNG",
  "IssueDate": "@{triggerBody()?['InvoiceDate']}T00:00:00",
  "DeliveryDate": "@{triggerBody()?['InvoiceDate']}T00:00:00",
  "IsTest": false,
  "Seller": {
    "Name": "@{triggerBody()?['SellerName']}",
    "VatId": "@{triggerBody()?['SellerVATID']}",
    "Address": {
      "Street": "@{triggerBody()?['SellerStreet']}",
      "PostalCode": "@{triggerBody()?['SellerPostalCode']}",
      "City": "@{triggerBody()?['SellerCity']}",
      "Country": "@{triggerBody()?['SellerCountry']}"
    }
  },
  "Buyer": {
    "Name": "@{triggerBody()?['BuyerName']}",
    "Address": {
      "Street": "@{triggerBody()?['BuyerStreet']}",
      "PostalCode": "@{triggerBody()?['BuyerPostalCode']}",
      "City": "@{triggerBody()?['BuyerCity']}",
      "Country": "@{triggerBody()?['BuyerCountry']}"
    }
  },
  "LineItems": [
    {
      "ProductName": "@{triggerBody()?['ItemDescription']}",
      "Quantity": @{triggerBody()?['Quantity']},
      "UnitCode": "C62",
      "UnitPrice": @{triggerBody()?['UnitPrice']},
      "LineTotal": @{float(...)}
    }
  ],
  "Totals": {
    "Currency": "@{triggerBody()?['Currency']?['Value']}",
    "LineTotal": @{float(...)},
    "TaxBasisTotal": @{float(...)},
    "TaxPercent": @{triggerBody()?['VATRate']},
    "TaxTotal": @{float(...)},
    "GrandTotal": @{float(...)},
    "ChargeTotal": 0,
    "AllowanceTotal": 0
  },
  "Payment": {
    "Currency": "@{triggerBody()?['Currency']?['Value']}",
    "PaymentReference": "@{triggerBody()?['InvoiceNumber']}",
    "DueDate": "@{triggerBody()?['DueDate']}T00:00:00"
  }
}

Compose : configuration​

Les valeurs textuelles sont des jetons entre guillemets. Les montants et les quantités sont des nombres bruts, c'est pourquoi ils sont convertis en nombres à virgule float.

D'où provient chaque partie de la facture​

Étape 3 : D’où provient le PDF de base ?​

Déroulement jusqu'à présent : le déclencheur plus Compose.

Les fichiers ZUGFeRD possèdent une page lisible, et c'est là que ça commence.

1. Ajouter SharePoint > Get file content using path.
2. Configurer :
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • File Path: /ZUGFeRD Templates/BaseInvoice.pdf
   • Infer content type (avancé) : Yes

Get file content using path : configuration​

Conservez votre papier à en-tête dans ce dossier. Il est vérifié à chaque impression ; toute modification entraînera donc une modification de la facture suivante.

Étape 4 : Comment transformer le JSON en un PDF/A-3 ZUGFeRD ?​

Déroulement jusqu'à présent : le déclencheur, Compose et Get file content using path.

Cette action génère la facture électronique. Elle lit le JSON, écrit le XML EN 16931 et renvoie un fichier unique contenant les deux parties.

1. Ajouter Create ZUGFeRD Invoice à partir de la connexion PDF4me PDF.
2. Configurer :
   • ZUGFeRD version and Input Format: 2.0-JSON
   • Output Mode: XmlWithPdf
   • Invoice JSON Data : l'expression base64(outputs('Compose'))
   • Conformance Level: EN16931
   • Render Invoice on PDF: Yes
   • File Content : une expression base64() sur le contenu Get file content using path
   • File Name: BaseInvoice.pdf

Create ZUGFeRD Invoice : configuration​

Le format d'entrée détermine le champ de données affiché. Sélectionnez 2.0-JSON et l'action demandera Invoice JSON Data, et non Invoice XML Data.

Ce que chaque paramètre détermine​

Étape 5 : Où la facture est-elle classée ?​

Flux jusqu'à présent : tout passe par Create ZUGFeRD Invoice.

Le numéro de facture permet d'identifier le fichier, ce qui rend la bibliothèque consultable.

1. Ajouter SharePoint > Create file.
2. Configurer :
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • Folder Path: /ZUGFeRD Invoices
   • File Name : ZUGFeRD_ suivi du numéro InvoiceNumber et de l’extension .pdf
   • File Content : le jeton Body de Create ZUGFeRD Invoice

Create file : configuration​

Pour RE-2026-0007 cela écrit ZUGFeRD_RE-2026-0007.pdf.

Étape 6 : Comment enregistrez-vous le résultat sur la requête ?​

Déroulement jusqu'à présent : tout passe par Create file.

La ligne qui demandait la facture devait également indiquer ce qu'il était advenu de celle-ci.

1. Ajouter SharePoint > Update item.
2. Configurer :
   • Site Address: PDF4me Support - https://ynoox1.sharepoint.com/sites/PDF4meSupport
   • List Name: ZUGFeRD Requests
   • Id : le jeton ID du déclencheur
   • Title : le jeton Title du déclencheur
   • Status Value (avancée) : Generated
   • OutputLink (avancé) : l’URL de la bibliothèque suivie de ZUGFeRD_, du jeton InvoiceNumber et de .pdf

Update item : configuration​

Le lien est assemblé à partir de l'URL de la bibliothèque et du même modèle de nom utilisé Create file, l'espace dans le nom de la bibliothèque étant déjà encodé en %20.

Étape 7 : Comment envoyez-vous la facture à l'acheteur ?​

Flux jusqu'à présent : tout passe par Update item.

Une facture électronique qui reste dans une bibliothèque n'a pas été émise ; la dernière action permet donc de la délivrer.

1. Ajouter Office 365 Outlook > Send an email (V2).
2. Configurer :
   • À : le jeton Email du déclencheur
   • Objet : Your ZUGFeRD e-invoice suivie du numéro InvoiceNumber
   • Body : une ligne indiquant le nom de l’acheteur et la facture, et précisant que le fichier est un PDF/A-3 avec XML EN 16931 intégré
3. Ouvrez Advanced parameters et ajoutez la pièce jointe :
   • Nom Attachments - 1 : ZUGFeRD_ suivi du numéro InvoiceNumber .pdf
   • Contenu Attachments - 1 : le jeton File Content issu de Create ZUGFeRD Invoice
   • Importance: Normal

Send an email (V2) : configuration​

La pièce jointe tire ses octets de l'action qui les a produits, SharePoint n'est donc jamais relu.

Exécutez le flux et vérifiez​

1. Save le flux.
2. Ajoutez une ligne aux ZUGFeRD Requests avec un acheteur, un seul article, les deux dates et une adresse vérifiable.
3. Ouvrez l'historique d'exécution. Les sept actions devraient être validées (niveau vert) et l'exécution complète devrait prendre quelques secondes.
4. Ouvrez la bibliothèque ZUGFeRD Invoices et vérifiez que le fichier s'y trouve sous le numéro de facture.
5. Retournez à la ligne : Status doit indiquer Generated et OutputLink doit ouvrir la facture.
6. Ouvrez la pièce jointe du courriel et vérifiez les deux parties : la page doit afficher les montants corrects et le fichier doit contenir le code XML.

L'exécution de la commande a duré environ quatre secondes, la facture électronique étant générée en une seule seconde. Le fichier résultant, ZUGFeRD_RE-2026-0007.pdf, pèse environ 331 Ko et se présente comme une facture allemande : vendeur : Muster GmbH (Berlin, ID de TVA : DE123456789 ; client Test Kunde AG (Muenchen, type de document : 380 ; ligne : Consulting, TVA : 19 %, montant net : 1 005,00 EUR, TVA : 190,95 EUR, total : 1 195,95 EUR.

Variantes courantes que vous pouvez ajouter sans reconstruction​

Comment cela se compare-t-il aux autres méthodes de production d'une facture ZUGFeRD​

Chaque ligne décrit l'alternative. La dernière ligne correspond à ce flux.

Questions fréquentes​

Qu'est-ce qu'une facture ZUGFeRD ?​

Une facture ZUGFeRD est un fichier unique à double usage. Il s'agit d'un PDF classique, lisible et contenant une pièce jointe XML avec les mêmes données structurées. Le système comptable de l'acheteur lit le fichier XML et enregistre la facture automatiquement, tandis que le service comptabilité fournisseurs conserve une version papier.

Ce format provient de FeRD, le forum allemand pour la facturation électronique, et son équivalent français est Factur-X, qui repose sur le même principe sous un autre nom.

Qu'est-ce que le format ZUGFeRD ?​

Techniquement, il s'agit d'un conteneur PDF/A-3 avec un fichier XML intégré au format Cross Industry Invoice, et un profil indiquant le niveau de complétude des données. Le profil utilisé ici est EN16931, qui correspond à la norme sémantique européenne pour la facturation électronique : l'ensemble des champs définis par EN 16931 comme constituant le cœur d'une facture.

Concrètement, pour une automatisation, le résultat est évalué sur la base du XML, et non de la page. Fournissez les données demandées par le profil et le fichier est validé ; améliorez l’esthétique de la page et rien ne change.

Comment créer une facture ZUGFeRD ?​

Vous avez besoin de trois choses : les données de la facture sous une forme structurée, une page pour la partie humaine et un outil qui écrit le XML dans le PDF en tant que pièce jointe PDF/A-3.

Dans ce flux, les données proviennent d'une ligne SharePoint convertie en JSON, la page est BaseInvoice.pdf, et Create ZUGFeRD Invoice effectue la troisième étape avec Output Mode XmlWithPdf. Si vos données existent déjà au format XML Cross Industry Invoice ou sous forme de ligne CSV, inversez le format d'entrée et utilisez ce format. Le reste du flux demeure inchangé.

Quelle est la différence entre ZUGFeRD et XRechnung ?​

Les deux formats répondent à la même norme européenne ; la différence réside dans leur présentation. ZUGFeRD est un format hybride : un PDF lisible contenant le code XML, adapté aux factures envoyées à des clients susceptibles de les ouvrir manuellement. XRechnung est exclusivement au format XML et correspond au format exigé par les acheteurs du secteur public allemand.

Si vous envoyez des factures à des entreprises, le format hybride est généralement plus sûr, car il est lisible par tous. Si vous facturez une administration publique, vérifiez le format requis avant l'envoi.

Dépannage​

Prochaines étapes​

Le même schéma en sept étapes (une ligne arrive, une facture est décrite comme des données, un fichier est produit, classé, enregistré et envoyé) est ce que chaque mandat de facturation électronique exige réellement, quel que soit le format dont vos acheteurs finissent par avoir besoin.