Prodotti multipli in un documento (Line Itemizer)
Vediamo come usare lo strumento Line Itemizer del Formatter di Zapier per inserire più prodotti in un unico documento Fattura24 tramite l'azione Create Document.
Questa guida approfondisce con un caso pratico quanto introdotto in Inserire step aggiuntivi. Per l'elenco completo dei campi dell'azione Create Document consulta Crea un documento.
Il problema
Il tuo Zap deve creare UN SOLO documento Fattura24 che elenchi PIÙ prodotti, ognuno con cinque informazioni: nome, prezzo, aliquota IVA, natura IVA e quantità.
La maggior parte dei trigger, però, restituisce questi dati come un unico testo non strutturato, ad esempio:
"Consulenza, 150.00, 22%, 1, Licenza software, 89.00, 22%, 2 ..."
Un testo di questo tipo non è utilizzabile così com'è: Fattura24 richiede un insieme di prodotti già suddiviso riga per riga (line item), non un'unica stringa.
La soluzione: il Line Itemizer del Formatter
Il Line Itemizer è uno strumento incluso in Formatter by Zapier (categoria Utilities) che prende più elenchi separati da virgola — nome, prezzo, aliquota IVA, natura IVA, quantità — e li combina in un unico insieme di prodotti abbinati, pronto per essere inviato a Fattura24.
Pensalo come una cerniera lampo: allinea ogni elenco, posizione per posizione, in un prodotto per posizione.
Passo 1 — Aggiungi lo step Formatter
Inseriscilo tra il tuo trigger e l'azione Create Document.
Trigger
Nuovo ordine / nuova richiesta di documento
Formatter — Utilities
Transform: Line Itemizer (Create)
Create Document
Azione Fattura24
- Nell'editor dello Zap, clicca sul + tra il trigger e Create Document.
- Cerca e seleziona Formatter by Zapier.
- Imposta Action Event su Utilities, poi clicca su Continue.
- Imposta Transform su Line Itemizer (Create / Append / Prepend).
Passo 2 — Mappa ogni informazione come un elenco
Un campo per ogni dettaglio del prodotto: i valori vanno separati da virgola, sempre nello stesso ordine.
| Proprietà | Valori separati da virgola (1 per prodotto) |
|---|---|
| Descrizione | Consulenza, Licenza software, Servizio export (UE) |
| Prezzo | 150.00, 89.00, 60.00 |
| Aliquota IVA | 22%, 22%, 0% |
| Natura IVA | –, –, N3.2 |
| Quantità | 1, 2, 1 |
Ogni elenco deve avere lo stesso numero di valori, nello stesso ordine di prodotto: è quello che tiene abbinato il prezzo #2 alla descrizione #2.
Esempio: tre prodotti, un solo set di campi
| Prodotto A | Prodotto B | Prodotto C | |
|---|---|---|---|
| Descrizione | Consulenza | Licenza software | Servizio export (UE) |
| Prezzo | 150.00 | 89.00 | 60.00 |
| Aliquota IVA | 22% | 22% | 0% |
| Natura IVA | – | – | N3.2 |
| Quantità | 1 | 2 | 1 |
Il Formatter trasforma questi dati in 3 line item strutturati, come vediamo nel prossimo paragrafo.
Cosa restituisce il Line Itemizer
Esegui un test sullo step Formatter: otterrai un line item per ogni prodotto, ciascuno con tutte e cinque le proprietà.
Item 1
- Descrizione: Consulenza
- Prezzo: 150.00
- Aliquota IVA: 22%
- Natura IVA: –
- Quantità: 1
Item 2
- Descrizione: Licenza software
- Prezzo: 89.00
- Aliquota IVA: 22%
- Natura IVA: –
- Quantità: 2
Item 3
- Descrizione: Servizio export (UE)
- Prezzo: 60.00
- Aliquota IVA: 0%
- Natura IVA: N3.2
- Quantità: 1
I 3 line item generati da questo step sono pronti per essere mappati in blocco in qualsiasi campo prodotto a valle, come il campo Products di Fattura24.
Passo 3 — Mappa il campo Descrizione, passo per passo
Esempio: colleghiamo il campo Product Name di Create Document all'output del Line Itemizer.
- Clicca sul campo — clicca nel campo vuoto Product Name per aprire il selettore dati.
- Scegli la fonte — apri il selettore dati del campo e scegli Line Itemizer → Descrizione.
- Verifica la pillola — comparirà una pillola tipo "2. Descrizione" con lo stato Mapped: rappresenta TUTTI i valori restituiti dal Line Itemizer, uno per prodotto, in automatico.
Passo 4 — Mappa gli altri campi allo stesso modo
Ripeti la stessa selezione per prezzo, aliquota IVA, natura IVA e quantità:
| Fattura24 — Create Document → Products | Valore mappato |
|---|---|
| Product Name (required) | 2. Descrizione (fatto al passo 3) |
| Product Price (required) | 2. Prezzo |
| Product Vat Value | 2. Aliquota IVA |
| Product Vat Nature | 2. Natura IVA |
| Product Quantity | 2. Quantità |
Poiché il Line Itemizer ha generato un gruppo di line item, Zapier ripete questa mappatura automaticamente per ogni prodotto: ogni campo va mappato una sola volta, non una volta per prodotto.
Per la lista dei codici natura IVA validi e i controlli automatici sul campo Product Vat Nature, consulta Impostare il campo Natura IVA.
Consigli per evitare errori
I quattro errori più comuni con il Line Itemizer, e come evitarli.
1. Mantieni l'ordine coerente
L'elemento #2 nel Prezzo deve essere l'elemento #2 anche in Descrizione, Aliquota IVA, Natura IVA e Quantità, sempre.
2. Mantieni il conteggio coerente
3 prezzi richiedono esattamente 3 descrizioni, 3 aliquote IVA, 3 nature IVA e 3 quantità.
3. Attenzione alle virgole
Una virgola dentro un singolo valore (ad esempio in una descrizione) lo spezzerà in un elemento extra, non corretto.
4. Fai un'anteprima prima di pubblicare
Usa il Test/Preview dello step Formatter per controllare i line item generati prima di attivare lo Zap.
Riepilogo rapido
- Aggiungi uno step Formatter (Utilities → Line Itemizer) tra il trigger e Create Document.
- Mappa ogni dettaglio del prodotto come un proprio elenco separato da virgola: stesso ordine, stesso conteggio.
- Controlla l'output: un line item strutturato per prodotto, nel pannello di test dello step Formatter.
- In Create Document → Products, clicca su ogni campo e seleziona la proprietà corrispondente del Line Itemizer.
- Fai un test con Preview, poi attiva lo Zap.
Per qualsiasi difficoltà nella configurazione consulta la pagina Risoluzione dei problemi o contatta il nostro staff tramite il servizio di ticketing da Fattura24.