Segnaposto: quali esistono e dove valgono
Dopo aver letto questo articolo sai in quali tre punti di Univents esistono i segnaposto, come si scrivono, dove trovi l’elenco completo e perché non puoi crearne di tuoi.
Un segnaposto è un sostituto all’interno del testo: lo scrivi una sola volta in un modello e Univents lo sostituisce, per ogni documento e ogni e-mail, con il valore reale corrispondente. Invece di digitare il nome del cliente in ogni preventivo, nel modello c’è {Customer_Name}: nel PDF finale compare il nome del cliente.
I punti in cui usi i segnaposto sono tre. Si somigliano, ma sono elenchi separati: un segnaposto di un punto non funziona negli altri.
I tre punti in sintesi
| Dove | Scrittura | Esempio | Elenco completo |
|---|---|---|---|
| Modelli per preventivi, fatture, documenti di trasporto (DDT), note di credito (file Word, che diventa PDF) | Una parentesi graffa | {Customer_Name} | Come creo i layout per i documenti finanziari? |
| Modelli e-mail in Impostazioni → Modelli e-mail | Due parentesi graffe | {{customer_name}} | Il pulsante dei segnaposto nell’editor del singolo modello |
| Automazioni (oggetto, variabili del modello, testi delle notifiche) | Due parentesi graffe | {{gross_total}} | Il pulsante dei segnaposto accanto al singolo campo |
Gli elenchi sono separati di proposito, perché dietro ci sono dati diversi: un documento conosce righe, totali e aliquote IVA, un’e-mail conosce il destinatario e il motivo dell’invio, e un’automazione conosce solo ciò che porta con sé il suo trigger.
Modelli di documento: una graffa, nomi fissi
Nel modello Word del tuo layout i segnaposto si scrivono tra parentesi graffe singole. La tabella completa con tutti i nomi e il loro significato (documento, cliente, evento, la tua azienda, totali, tabelle delle righe, testi liberi) la trovi nell’articolo Come creo i layout per i documenti finanziari?.
Tre aspetti che lì si leggono facilmente di sfuggita:
- La scrittura deve essere esatta, maiuscole e minuscole comprese.
{Customer_Name}restituisce il nome del cliente,{customer_name}no. Copia ogni nome esattamente come compare nell’elenco. - Un segnaposto scritto male non si nota sempre. Se lavori con un modello Word, resta visibile nel PDF: lì leggi
{Custmer_Name}e vedi subito l’errore. Nei layout più recenti senza modello Word, invece, il punto resta vuoto. Quindi non contare sul fatto che un refuso si faccia notare da solo. - Un campo vuoto diventa testo vuoto. Se un cliente non ha una partita IVA registrata,
{Customer_Tax_ID}sparisce dal PDF senza lasciare traccia. Un punto vuoto non significa quindi per forza che manchi un dato: senza modello Word dietro può esserci altrettanto bene un refuso.
Modelli e-mail: due graffe, diverse per ogni modello
In Impostazioni → Modelli e-mail apri un modello e, accanto a oggetto e testo, vedi un pulsante con le parentesi graffe. Elenca esattamente le variabili che conosce quel modello: il promemoria fattura conosce {{days_overdue}}, la conferma del turno no.
Se inserisci una variabile che quel modello non conosce, il modello non può essere salvato: Univents segnala «Segnaposto sconosciuti» e indica i nomi interessati. È la protezione che impedisce a un cliente di ricevere un’e-mail con un {{foo}} grezzo.
Alcune variabili, invece, le conoscono tutti i modelli in cui funziona anche {{sender_name}}: {{company_name}}, {{account_name}}, {{sender_name}} e, dal 12/10/2026, {{sender_email}} e {{sender_phone}}. Le due nuove corrispondono all’indirizzo e-mail e al numero di telefono della persona che avvia l’invio: per le e-mail dei documenti inviate dalla casella di posta di un operatore sono i dati di quest’ultimo, altrimenti quelli del tuo workspace.
Alcuni segnaposto esistono solo all’invio di un documento, non nelle automazioni: {{portal_url}} (link al portale clienti), {{view_url}} (documenti nel portale), {{event_url}} e {{messages_url}} (solo se il documento appartiene a un evento), oltre a {{quote_link}} (solo preventivi) e {{invoice_link}} (solo fatture). In un’e-mail di automazione resterebbero non sostituiti. Altro nell’articolo Modelli e-mail e segnaposto.
Automazioni: due graffe, in base al trigger
In un’automazione possono contenere segnaposto Oggetto, variabili del modello (azione «Invia e-mail») nonché Titolo e Messaggio (azione «Notifica utente»). Quali segnaposto sono disponibili dipende dal trigger della regola: una regola su un documento finanziario conosce {{document_number}}, una regola su una richiesta no.
Due eccezioni:
- Il campo A (e-mail) non accetta segnaposto: deve essere un indirizzo fisso.
- Con il trigger E-mail ricevuta non ci sono affatto segnaposto: i contenuti delle e-mail non sono disponibili per motivi di protezione dei dati.
Maggiori informazioni nell’articolo Automazioni: azioni.
Creare segnaposto propri: non si può, ma c’è una soluzione
Non puoi inventare un segnaposto tuo: né un nuovo nome per i documenti né una nuova variabile per un modello e-mail. Entrambi gli elenchi sono fissi.
Per i documenti esistono invece i campi di testo libero: dieci blocchi di testo a libera compilazione per ogni layout, da {custom_text_0} a {custom_text_9}. Cosa scrivere al loro interno lo decidi tu, e puoi rinominare l’etichetta, in modo che nell’editor del documento compaia «Nota di pagamento» invece di «Testo libero 3».
- Apri Impostazioni → Modelli e seleziona il chip di filtro Modello di layout.
- Scegli il tuo layout e apri i Testi liberi.
- Assegna a ogni campo un nome e un testo predefinito.
- Nel singolo documento sovrascrivi il testo nella sezione Campi di testo libero, senza modificare il testo predefinito.
Un testo libero può a sua volta contenere segnaposto: così puoi costruirti, per esempio, un’intestazione personalizzata con {Customer_First_Name} e {Customer_Last_Name}.
Non è possibile aggiungere un undicesimo campo, e il nome tecnico (custom_text_3) resta invariato anche se cambi l’etichetta. Nel modello Word continua quindi a esserci {custom_text_3}.
La via rapida: chiedi all’assistente
Invece di cercare nelle tabelle, puoi chiedere all’assistente IA nell’app: «Quali segnaposto esistono per le fatture?» oppure «Quali variabili conosce il modello per il promemoria fattura?». L’assistente legge lo stesso elenco che Univents usa durante la creazione dei documenti e risponde con nome e significato.
Domande frequenti
Nel mio PDF compare {Foo} al posto di un valore. Cos’è successo? Il segnaposto non è noto a Univents: quasi sempre si tratta di un refuso o di una parentesi graffa di troppo. Se nel PDF leggi il nome sbagliato o vedi soltanto un punto vuoto dipende dal layout: con un modello Word il nome resta visibile, senza modello Word il punto resta vuoto. Controlla subito: il nome è scritto esattamente come nell’elenco, maiuscole e minuscole comprese? Hai usato parentesi graffe singole (documento) invece di doppie (e-mail)? Il segnaposto si trova in una casella di testo o in una forma di Word? Lì i segnaposto non vengono mai sostituiti.
Posso usare il segnaposto di un documento in un modello e-mail? No. I nomi differiscono già nella scrittura ({Customer_Name} rispetto a {{customer_name}}) e provengono da elenchi separati.
Posso rinominare un segnaposto? Solo l’etichetta dei dieci campi di testo libero. Tutti gli altri nomi sono fissi, perché determinano il valore che Univents inserisce.
Perché un segnaposto è rimasto vuoto? Di solito perché il valore non è compilato nel documento, nel contatto o nell’evento. Inseriscilo lì: per esempio il numero fiscale in Impostazioni → Azienda per {workspace_tax_number}. Se lavori con un layout senza modello Word, controlla anche la scrittura: anche lì un nome scritto male resta vuoto.