Fattura elettronica ZUGFeRD da Airtable in Zapier: filtra le righe, crea il JSON, invia il PDF ibrido via email

PDF4me Create ZUGFeRD Invoice è un'azione Zapier che converte i dati strutturati di una fattura in una fattura elettronica ibrida PDF/A-3. Leggendo una riga Airtable, trasforma un oggetto JSON in XML EN 16931 incorporato in un PDF leggibile, riscrive il file nel record e lo invia via email all'acquirente.

Le normative sulla fatturazione elettronica si presentano come un problema di formato file e vengono risolte come un problema di approvvigionamento: scegliere una piattaforma, pagare per documento, migrare i dati al suo interno. Questa soluzione è ragionevole su larga scala, ma assurda per un team che emette venti fatture al mese utilizzando un database già in uso. L'alternativa non è scrivere manualmente il codice XML, bensì descrivere la fattura in formato JSON e lasciare che sia un sistema esterno a generare il file conforme.

Domande e risposte basate sul "perché"​

Cosa riceverai​

Input: una riga Airtable con il numero di fattura, le date, un blocco venditore con partita IVA, un blocco acquirente, una voce e i totali, con Status impostato su New. Output: un PDF/A-3 ZUGFeRD relativo a tale record e nella casella di posta dell'acquirente.

Una riga per fattura. Ogni colonna qui diventa una chiave nel JSON inviato da Zap.

L'acquirente vede una fattura. Il suo sistema contabile vede il codice XML al suo interno.

Di cosa hai bisogno​

Zap in sintesi​

1. New Record (Airtable) viene attivato per ogni nuova riga nelle ZUGFeRD Requests.
2. Filter conditions (Filter by Zapier) continuano solo quando Status è esattamente New.
3. Create ZUGFeRD Invoice (PDF4me) converte il file JSON in un PDF ibrido.
4. Update Record (Airtable) scrive il file, lo stato e un collegamento alla riga.
5. Send Email (Gmail) recapita la fattura elettronica all'acquirente.

Panoramica completa di Zap​

Stessa struttura a cinque fasi dello Swiss QR Zap. Solo la fase centrale, quella relativa PDF4me è diversa.

Passaggio 1: Come si attiva uno Zap da una nuova riga Airtable?​

Flusso finora: ancora niente, questo è il trigger.

1. Crea uno Zap e seleziona Airtable > New Record.
2. Seleziona Automazioni Live Base PDF4me Live Automations e la Table ZUGFeRD Requests.
3. Test. Zapier segnala di aver trovato 1 nuovo record in Airtable e le colonne diventano disponibili a valle.

Il badge del seggio elettorale riporta la dicitura 2 min, che proviene dal piano e non da questa specifica fase.

Passaggio 2: Come si impedisce a Zap di fatturare una riga non completata?​

Flusso finora: il trigger Airtable.

1. Aggiungi Filter by Zapier > Only continue if...
2. Crea una regola: 1. Status / (Testo) Exactly matches / New.
3. Provalo.

Configurazione Filter conditions​

Il riquadro verde indica il campo che ha permesso al record di passare. Il riquadro giallo corrispondente indica quello che lo ha bloccato.

Passaggio 3: Come si trasforma la riga in una fattura ZUGFeRD?​

Flusso finora: il trigger e il filtro.

1. Aggiungi PDF4me > Create ZUGFeRD Invoice.
2. Imposta le opzioni di output:
   • File Name: ZUGFeRD_ seguito dal Invoice Number e dall'estensione .pdf
   • Input Format: JSON
   • Output Mode: XmlWithPdf
   • Zugferd Version: 2+
   • Conformance Level: EN16931
   • Render Invoice On Pdf: True
   • Lascia File vuoto a meno che tu non stia fornendo la tua carta intestata.
3. Incolla l'oggetto in Invoice Json Data e mappa ogni campo Airtable al suo interno:

{
  "InvoiceId": "{{Invoice Number}}",
  "TypeCode": "380",
  "InvoiceType": "RECHNUNG",
  "IssueDate": "{{Invoice Date}}T00:00:00",
  "DeliveryDate": "{{Invoice Date}}T00:00:00",
  "IsTest": false,
  "Seller": {
    "Name": "{{Seller Name}}",
    "VatId": "{{Seller VATID}}",
    "Address": {
      "Street": "{{Seller Street}}",
      "PostalCode": "{{Seller Postal Code}}",
      "City": "{{Seller City}}",
      "Country": "{{Seller Country}}"
    }
  },
  "Buyer": {
    "Name": "{{Buyer Name}}",
    "Address": {
      "Street": "{{Buyer Street}}",
      "PostalCode": "{{Buyer Postal Code}}",
      "City": "{{Buyer City}}",
      "Country": "{{Buyer Country}}"
    }
  },
  "LineItems": [
    {
      "ProductName": "{{Item Description}}",
      "Quantity": {{Quantity}},
      "UnitCode": "C62",
      "UnitPrice": {{Unit Price}},
      "LineTotal": {{Net Total}}
    }
  ],
  "Totals": {
    "Currency": "{{Currency}}",
    "LineTotal": {{Net Total}},
    "TaxBasisTotal": {{Net Total}},
    "TaxPercent": {{VAT Rate}},
    "TaxTotal": {{VAT Amount}},
    "GrandTotal": {{Gross Total}},
    "ChargeTotal": 0,
    "AllowanceTotal": 0
  },
  "Payment": {
    "Currency": "{{Currency}}",
    "PaymentReference": "{{Invoice Number}}",
    "DueDate": "{{Due Date}}T00:00:00"
  }
}

Ci sono tre elementi su cui vale la pena soffermarsi. TypeCode 380 è il codice per una fattura commerciale ed è fisso. UnitCode C62 è il codice UN/ECE per "un'unità di qualcosa", che è quello che serve per ore o unità di servizio. Infine, PaymentReference nel blocco Payment è il testo che l'acquirente inserisce al momento del pagamento, che in questo caso è semplicemente il numero di fattura.

Create ZUGFeRD Invoice​

Ogni valore rappresenta un token Airtable. Si noti VAT Amount 190,95 e Gross Total a 1195,95, sebbene la griglia li visualizzi come 191 e 1196.

Ciò che decide ogni impostazione​

Passaggio 4: Come si registra nuovamente la fattura?​

Flusso finora: tutto attraverso il passaggio PDF4me.

1. Aggiungi Airtable > Update Record.
2. Specificare:
   • Base PDF4me Live Automations, Tavolo ZUGFeRD Requests
   • Record: l' ID del trigger
   • Append attachments: False
   • Document: l' File Url dal passaggio 3
   • Status: Generated
3. Lascia vuoti tutti gli altri campi in modo che nulla venga sovrascritto.

Update Record​

L'avviso in alto è quello che vale la pena leggere. Tutto ciò che segue è volutamente vuoto.

Passaggio 5: Come si invia la fattura elettronica all'acquirente?​

Flusso finora: tutto attraverso l'aggiornamento del record.

1. Aggiungi Gmail > Send Email.
2. Specificare:
   • To: la colonna Email dal trigger
   • Subject: Your e-invoice e il Invoice Number
   • Body type: Html
   • Body: un breve saluto che nomina l'acquirente, il numero della fattura e il totale
   • Attachments: l' File Url dal passaggio 3

Configurazione Send Email​

L'allegato è lo stesso File Url che il passaggio 4 ha scritto su Airtable, quindi il record e l'e-mail contengono sempre lo stesso file.

Esegui Zap e verifica​

1. Publish lo Zap.
2. Aggiungi una riga alle ZUGFeRD Requests con un venditore, un acquirente, una voce, entrambe le date e Status New.
3. Attendi il risultato del sondaggio. Tutti e cinque i passaggi dovrebbero essere positivi.
4. Apri la riga: Document dovrebbe contenere un file PDF denominato con il numero della fattura e Status dovrebbe essere Generated.
5. Apri l'allegato. Dovresti visualizzare una pagina di fattura leggibile e un validatore ZUGFeRD dovrebbe trovare il codice XML EN 16931 all'interno dello stesso file.
6. Aggiungi una riga con Status Generated e conferma che lo Zap si ferma al passaggio 2.

Nell'esecuzione acquisita, la versione 1 è stata completata con successo il 24 ottobre 2026 alle 00:09:01, producendo ZUGFeRD_RE-2026-0011.pdf per una fattura da Muster GmbH di Berlin a Test Kunde AG di Muenchen, dieci unità di Consulting da 100,50, per un totale di 1195,95 EUR.

Varianti comuni che puoi aggiungere senza dover ricostruire​

Come si confronta questo metodo con le altre modalità di emissione di una fattura elettronica?​

Ogni riga descrive l'alternativa. L'ultima riga è questo Zap.

Abbiamo anche costruitothe identical flow in Make Le differenze sono piccole ma reali: Make filtra all'interno del trigger gratuitamente, laddove Zapier impiega un passaggio, Make necessita parseNumber attorno a ogni valore monetario, laddove Zapier li mappa direttamente, e Make carica il file come byte, laddove Zapier fornisce Airtable un URL.

Domande frequenti​

Che cos'è la fatturazione elettronica?​

La fatturazione elettronica significa emettere una fattura come dati strutturati leggibili da una macchina, anziché come immagine di una pagina. Il sistema contabile dell'acquirente la analizza e la registra senza che nessuno debba riscriverla, ed è proprio questo il punto: il risparmio è per chi riceve la fattura, non per voi.

Un numero crescente di giurisdizioni ora lo richiede per gli scambi commerciali tra imprese e settore pubblico.European standard EN 16931 definisce l'insieme principale dei campi, e formati come ZUGFeRD lo implementano.

Che cos'è la fatturazione elettronica?​

La stessa cosa. "Fatturazione elettronica" è generalmente il termine utilizzato nella legislazione, mentre "e-invoicing" è il termine usato nel marketing dei prodotti; entrambi indicano dati di fatturazione strutturati e leggibili da una macchina, anziché un PDF allegato a un'e-mail.

È bene chiarire cosa non è considerato valido: una fattura cartacea scansionata non è una fattura elettronica, così come non lo è un normale PDF. Senza dati strutturati incorporati, il destinatario deve comunque leggerla.

Airtable è in grado di creare fatture?​

Non conformi. Airtable memorizza i dati e può disporli in un'interfaccia o in una visualizzazione stampabile, ma non può produrre un PDF/A-3 con XML conforme alla norma EN 16931, che è ciò che richiede un mandato.

La suddivisione utilizzata da questo Zap è quella più pratica: Airtable è il record, PDF4me produce il file e quest'ultimo torna al record come allegato.

Come funziona l'automazione della contabilità fornitori?​

Tre fasi: acquisizione, estrazione e registrazione. L'acquisizione raccoglie i documenti in un unico luogo, l'estrazione li trasforma in campi, la registrazione scrive questi campi nel libro mastro, con un processo di approvazione preliminare.

Le fatture elettroniche ibride eliminano la parte intermedia. Quando l'XML è già presente all'interno del file, l'estrazione avviene tramite analisi sintattica anziché riconoscimento, ed è per questo che le normative continuano a spingere in questa direzione. Questo Zap rappresenta la parte di invio di tale sistema.

Risoluzione dei problemi​

Prossimi passi​

Un mandato può sembrare un problema di formato, ma in realtà è un problema di dati. Se la fattura esiste già in righe, gran parte del lavoro è già fatto.