Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Come si crea una fattura ZUGFeRD in Power Automate? Un flusso di lavoro passo passo con Dropbox e JSON.

· 16 minuti di lettura
Sankalp Mishra
SEO and Content Writer

Questa guida mostra un completo Power Automate flusso di lavoro che legge un PDF di base E fattura JSON da Dropbox, genera un ZUGFeRD/Factur-X fattura utilizzando PDF4me crea la fattura ZUGFeRDe riscrive il file finale su Dropbox.

La sequenza di schermate utilizza questi percorsi di esempio:

  • PDF di base: /blog data/zugferd invoice/simplepdf.pdf
  • JSON: /blog data/zugferd invoice/sample-invoice.json
  • Cartella di output: /dati del blog/fattura Zugferd/output
Download (file di esempio)
La versione breve

1. Avvia manualmente il flusso → 2. Scarica il file PDF di base (Dropbox) → 3. Scarica il file JSON (Dropbox) → 4. Crea fattura ZUGFeRD (PDF4me, Formato di input = JSON, Modalità di output = PDF con XML) → 5. Crea il file (cartella di output di Dropbox).

Ricordatelo quando configuri il passaggio 4

Impostato Formato di input = JSON, quindi mappa solo Dati JSON della fattura. Mantenere Dati XML della fattura E Dati della fattura in formato CSV vuoto in questa corsa. Per PDF con XML, Contenuto del file PDF è richiesto e deve provenire dalla fase PDF di base.

Cosa stai costruendo​

Tu produci un fattura dell'affilatoio in PDF A partire da un modello PDF e dati JSON strutturati, l'output è adatto a team che necessitano di un file PDF leggibile con dati di fatturazione leggibili automaticamente e impacchettati secondo le convenzioni ZUGFeRD/Factur-X.

In sintesi: tutti e cinque i passaggi​

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

Perché questo schema di flusso di lavoro funziona​

Ingressi separati

I file PDF e JSON vengono recuperati in modo indipendente, quindi è possibile aggiornare i file di payload senza modificare il flusso del modello PDF visivo.

Passo di generazione singola

Crea fattura ZUGFeRD Riceve entrambe le fonti di contenuto in un unico punto e restituisce un file di output utilizzabile direttamente da Dropbox. Crea file.

Facile da ramificare in seguito

Dopo la generazione, è possibile aggiungere convalida, notifiche, invio tramite ERP/API o instradamento di archiviazione senza dover ristrutturare il flusso principale.

Prima di iniziare​

Lista di controllo
  • Power Automate ambiente con autorizzazione a creare flussi cloud.
  • Chiave API di PDF4me. Configurazione iniziale: Collega PDF4me a Power Automate.
  • Connessione a Dropbox con accesso in lettura ai file sorgente e accesso in scrittura alla cartella di output.
  • Un payload JSON di fattura valido e un file PDF di base disponibili su Dropbox.

File di input utilizzati in questa guida​

Anteprima del documento PDF di base utilizzata come input PDF per l'azione Crea fattura ZUGFeRD

File di input PDF di base.

Contenuto del payload JSON della fattura che mostra i campi della fattura mappati alla generazione ZUGFeRD

Input del payload JSON della fattura.

Il flusso in sintesi (cinque fasi)​

  1. Avviare manualmente un flusso: Esegui su richiesta durante la configurazione.
  2. Scarica il file PDF di base (Dropbox): Legge i byte del modello PDF.
  3. Ottieni il file JSON (Dropbox): Legge i byte/il contenuto JSON della fattura.
  4. Crea fattura ZUGFeRD (PDF4me): Combina gli input utilizzando la modalità JSON.
  5. Crea file (Dropbox): memorizza l'output generato nella cartella di destinazione.

Panoramica del flusso​

Flusso Power Automate: Attiva manualmente un flusso, Ottieni file PDF di base, Ottieni file JSON, Crea fattura ZUGFeRD, Crea file

Catena di flusso completa utilizzata per questo schema di generazione ZUGFeRD.

Passaggio 1: Scarica il file PDF di base (Dropbox)​

Flusso finora: Attiva → Ottieni il file PDF di base.

  1. Aggiungere Dropbox Azione per recuperare il contenuto del file tramite percorso.
  2. Impostato Percorso del file al modello base PDF (esempio: /blog data/zugferd invoice/simplepdf.pdf).
  3. Nelle opzioni avanzate, mantieni Deduzione del tipo di contenuto = Sì.
  4. Salva e testa questo passaggio; assicurati che restituisca il contenuto del file/l'output binario.
Dropbox Ottieni file PDF di base azione che mostra il percorso del file blog dati zugferd fattura simplepdf.pdf e deduci tipo di contenuto Sì

Screenshot del passaggio 1: percorso PDF di base e inferenza del contenuto configurati.

Passaggio 2: Scarica il file JSON (Dropbox)​

Flusso finora: Attiva → Ottieni PDF di base → Ottieni file JSON.

  1. Aggiungi un'altra azione relativa al contenuto dei file di Dropbox.
  2. Impostato Percorso del file ai dati della fattura in formato JSON (esempio: /blog data/zugferd invoice/sample-invoice.json).
  3. Mantenere Deduzione del tipo di contenuto = Sì.
  4. Salva e testa; verifica che il contenuto JSON sia disponibile per la mappatura nel passaggio 3.
Azione Dropbox Ottieni file JSON che mostra il percorso del file dati del blog zugferd invoice sample-invoice.json e deduci il tipo di contenuto Sì

Screenshot del passaggio 2: file sorgente JSON da Dropbox.

Passaggio 3: Crea la fattura ZUGFeRD (PDF4me)​

Flusso finora: Attiva → Ottieni PDF di base → Ottieni JSON → Crea ZUGFeRD.

Specificare PDF4me, crea fattura ZUGFeRD come mostrato:

  1. Nome del file: nome del PDF di origine (esempio: Test.pdf).
  2. Contenuto del file PDF: mappa da Scarica il file PDF di base.
  3. Nome del file di output: nome del file di output desiderato (esempio: Fattura Zugferd.pdf).
  4. Formato di input: impostato su JSON.
  5. Modalità di uscita: impostato su PDF con XML.
  6. Dati JSON della fattura: mappa da Ottieni il file JSON.
  7. Livello di conformità: esempio: DI BASE.
  8. Versione ZUGFeRD: esempio: 1.0 (o la versione da voi richiesta).
  9. Genera fattura in formato PDF: esempio: SÌ.
Crea un'azione di fattura ZUGFeRD che mostra il nome del file, il contenuto del file PDF, il nome del file di output, il formato di input JSON, la modalità di output PDF con XML, i dati JSON della fattura, la conformità BASIC, la versione ZUGFeRD 1.0, il rendering della fattura in PDF Sì

Screenshot del passaggio 3: mappatura completa dei parametri per la generazione di ZUGFeRD basata su JSON.

Passaggio 4: Creare il file (Dropbox)​

Flusso finora: Attiva → Leggi PDF + JSON → Genera ZUGFeRD → Salva file.

  1. Aggiungere Dropbox: crea file.
  2. Percorso cartella: cartella di destinazione dell'output (esempio: /dati del blog/fattura Zugferd/output).
  3. Nome del file: nome del file di output della mappa da Crea fattura ZUGFeRD.
  4. Contenuto del file: contenuto del file generato dalla mappa Crea fattura ZUGFeRD.
  5. Salva ed esegui l'intero flusso.
Dropbox Crea azione file con percorso cartella dati blog zugferd output fattura e nome file mappato e contenuto file da Crea fattura ZUGFeRD

Screenshot del passaggio 4: scrittura del file di output su Dropbox.

Garanzia di output​

Esempi di output aperti
Output visivo PDF della fattura ZUGFeRD generato dopo l'azione Crea fattura ZUGFeRD

Fattura generata in formato PDF.

L'output si è aperto con un pannello di allegati che mostra i dati XML incorporati nel PDF della fattura ZUGFeRD generata.

Visualizzazione dell'allegato con i dati strutturati della fattura incorporati.

Riferimento rapido​

#Fare un passoMappatura chiave
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

Riferimenti dettagliati ai parametri: Crea fattura ZUGFeRD, Convalida PDF.

Risoluzione dei problemi​

La generazione fallisce a causa della mappatura dell'input

Se Formato di input = JSONsolo mappa Dati JSON della fatturaCancella i campi XML/CSV per questa esecuzione.

Mancata corrispondenza della modalità di uscita

Con PDF con XML, mancante Contenuto del file PDF causa errori. Mappa i byte del file dalla fase PDF di base.

Errori 401, 402 o problemi di connessione.

Vedere Risoluzione dei problemi di PDF4me per la verifica della chiave API, dei crediti e dell'autorizzazione del connettore.

Cosa provare dopo?​

Indurimento opzionale: aggiungi un Condizione Dopo il passaggio 3, per verificare la presenza dell'output, si passa alle notifiche di successo/fallimento prima della scrittura finale del file.

Power Automate

Ottieni la chiave API

Crea fattura ZUGFeRD (documentazione)

Convalida PDFA (documenti)