Quali variabili si possono utilizzare nel modello di fattura?

Questo articolo elenca i segnaposto/le variabili disponibili per personalizzare il layout del modello di fattura.

Nota sui blocchi condizionali: i segnaposto nella forma {#has...}{/...} permettono una visualizzazione condizionale. Vengono quindi visualizzati solo se esiste un valore corrispondente.

Importante: tenga presente che per tutte le variabili le maiuscole e le minuscole devono essere rispettate esattamente come indicato.

Variabili della data della fattura

• {date} 18.08.2025
• {dateDay} 18
• {dateMonth} 8
• {dateYear} 2025
• {dateMonthName} agosto
• {dateMonthNameShort} ago
• {dateMonthYearDisplay} agosto 2025
• {dateWithMonthName} 18 agosto 2025

Informazioni generali della fattura

• {number} Numero della fattura
• {poNumber} Numero dell'ordine d'acquisto
• {#hasPoNumber}{/hasPoNumber} Numero dell'ordine d'acquisto (condizionale, visualizzato solo se esiste)
• {location} Luogo della fattura
• {currentDate} Data completa nel formato GG.MM.AAAA (ad es. 08.07.2025)
• {currentDateDay}.{currentDateMonth}.{currentDateYear} (ad es. 8.7.2025)
  • {currentDateDay} Giorno del mese della data attuale (ad es. 8)
  • {currentDateMonth} Mese della data attuale (numerico, senza zero iniziale) (ad es. 7)
  • {currentDateYear} Anno a quattro cifre (ad es. 2025)
• {sender} Nome e indirizzo dell'emittente della fattura (su più righe)
• {senderLine} Come {sender}, ma su una sola riga
• {vatNumber} Partita IVA
• {receiver} Nome e indirizzo del destinatario della fattura (su più righe).
• Se desidera rimuovere un elemento dal segnaposto su più righe {receiver}, deve scomporre la variabile nelle sue singole parti e utilizzare solo gli elementi di cui ha bisogno.
  • {#receiverName}{receiverName}{/}: nome
  • {receiverAddress}: riga dell'indirizzo 1
  • {#receiverZip}{receiverZip}{/} {#receiverCity}{receiverCity}{/}: riga dell'indirizzo 2
  • {#receiverCountry}{receiverCountry}{/}: paese
• {subject} Titolo della fattura
• {description} Testo della fattura
• {#hasDescription}{/hasDescription} Testo della fattura (condizionale, visualizzato solo se esiste)
• {bankDetails} Informazioni di pagamento (su più righe)
• {dueDate} Data di scadenza
• {customDueDate} Data di scadenza se sono state definite condizioni di pagamento personalizzate; altrimenti uguale a {dueDate}
• {epcreference} Numero di riferimento QR per le fatture QR in Svizzera
• {qr} Codice QR per la fattura QR SEPA

Variabili del progetto

• {projects[0].name} Nome del progetto
• {projects[0].notes} Osservazioni sul progetto
• {projects[0].referenceNumber} Numero di riferimento
• {projects[0].customfield} Campo personalizzato a livello di progetto (sostituisca «customfield» con il nome del campo personalizzato, ad esempio: {projects[0].contactperson})

Nel blocco {#projects}{/projects} può utilizzare anche i seguenti segnaposto per visualizzare informazioni specifiche del progetto:

• {name} Nome e periodo del progetto
• {nameWithNoPeriod} Nome del progetto senza il periodo tra parentesi. Esempio: «Progetto Alfa (1234)» diventa «Progetto Alfa».
• {total} Importo totale del progetto
• {referenceNumber} Numero di riferimento del progetto
• {leaderName} Nomi dei capi progetto (separati da virgole)
• {leaderEmail} Indirizzi e-mail dei capi progetto (separati da virgole)
• {notes} Osservazioni sul progetto
• {#hasNotes}{/hasNotes} Osservazioni sul progetto (condizionale, visualizzato solo se esistono)
• {totalCount} Numero totale di ore o di unità del progetto (formattato con due decimali)
• {rate} Tariffa oraria o prezzo unitario del progetto
• {expensesFlatrate} Descrizione delle spese forfettarie, ad es. «Spese forfettarie 10 %»
• {expensesFlatrateAmount} Importo delle spese forfettarie.
• {expensesFlatrateApplyTax} Indica se alle spese forfettarie vengono applicate imposte
• {expensesFlatrateApplyDiscount} Indica se alle spese forfettarie vengono applicati sconti

Nel blocco {#entries}{/entries} può utilizzare i seguenti segnaposto aggiuntivi per visualizzare informazioni per ogni voce di progetto.

• {name} Descrizione della voce di progetto
• {count} Quantità della voce
• {rate} Tariffa della voce
• {amount} Importo totale della voce
• {countHHMM} Durata della voce nel formato ore:minuti

Pagamenti anticipati

Nel blocco {#advancePayments}{/advancePayments} può utilizzare i seguenti segnaposto per visualizzare informazioni per ogni pagamento anticipato.

• {date} Data del pagamento anticipato (nel formato GG.MM.AAAA)
• {amount} Importo del pagamento anticipato

Importi della fattura, imposte e sconti

• {totalBeforeTaxWithoutExpensesFlatRateAmount} Importo della fattura al netto delle imposte, dedotte le spese forfettarie.
• {totalExpensesFlatRateAmount} Importo totale delle spese forfettarie
• {discountableAmount} Importo al quale viene applicato lo sconto
• {totalBeforeDiscount} Totale della fattura prima degli sconti
• {discount} Sconto in %
• {#hasDiscount}{/hasDiscount} Sconto in % (condizionale, visualizzato solo se esiste)
• {discountAmount} Importo dello sconto
• {totalBeforeTax} Totale della fattura IVA esclusa
• {#hasTax}{/hasTax} Imposta in % (condizionale, visualizzata solo se esiste)
• {tax} Imposta in %
• {taxAmount} Importo dell'imposta
• {total} Importo della fattura, imposte e sconti inclusi
• {%logo} Logo della società
• {currency} Valuta della fattura
• {text.*} Testo tradotto. Sostituisca «*» con il nome di una voce in «Impostazioni» -> «Traduzioni»
• {totalCount} Totale delle ore (mostra il totale del progetto all'interno dei progetti e il totale generale al di fuori dei progetti)

Intervalli di tempo e periodi

• {yearPeriod} Anno del periodo di fatturazione
• {fromPeriod} Data di inizio del periodo di fatturazione (nel formato GG.MM.AAAA)
• {toPeriod} Data di fine del periodo di fatturazione (nel formato GG.MM.AAAA)
• {fromPeriodWithFirstDayOfMonth} Primo giorno del mese della data di inizio (nel formato GG.MM.AAAA)
• {toPeriodWithLastDayOfMonth} Ultimo giorno del mese della data di fine (nel formato GG.MM.AAAA)
• {fromPeriodFirstDay} Giorno numerico (1–31) della data di inizio
• {toPeriodLastDay} Giorno numerico (1–31) della data di fine
• {fromPeriodFirstMonth} Mese numerico (1–12) della data di inizio
• {toPeriodLastMonth} Mese numerico (1–12) della data di fine
• {fromPeriodFirstYear} Anno della data di inizio
• {toPeriodLastYear} Anno della data di fine
• {fromPeriodMonthName} Nome del mese della data di inizio, localizzato secondo la lingua del cliente
• {toPeriodMonthName} Nome del mese della data di fine, localizzato secondo la lingua del cliente
• {periodMonthYearDisplay} Periodo formattato, ad es. «gennaio 2025 – marzo 2025»