Knowledge base
Guide
Accademia
Tutorial video
Prova a cercare:
Articoli visualizzati di recente:

Sommario

Utilizzo delle variabili nelle notifiche

Le notifiche e-mail sono progettate per fornire informazioni importanti sugli ordini ai clienti e al gestore del negozio. Tali notifiche vengono create con l'aiuto dei tag HTML e Freemarker e utilizzano variabili speciali per visualizzare dati pertinenti agli ordini nelle e-mail.

In questo articolo è riportato l'elenco delle variabili disponibili. È possibile trovare esempi di utilizzo delle variabili nell'articolo Modifica delle notifiche e-mail. Inoltre, è possibile usare le variabili nei codici di tracciamento personalizzati.

Variabili relative ai dati dei clienti

Nome Descrizione
${customer.name} Visualizza il nome del cliente.
${customer.email} Visualizza l'indirizzo e-mail del cliente.
${customer.membershipName} Visualizza il nome del gruppo al quale è assegnato il cliente.
${customer.membershipId} Visualizza l'ID del gruppo al quale è assegnato il cliente.

Variabili relative ai dati degli ordini

Nome Descrizione
<#list order.items as orderItem> </#list> Visualizza l'elenco dei prodotti ordinati.
${orderItem.name} Visualizza il nome del prodotto.
${orderItem.sku} Visualizza il codice articolo del prodotto.
${orderItem.description} Visualizza la descrizione del prodotto.
${orderItem.customerUrl} Richiama l'URL della pagina del prodotto.
${orderItem.imageUrl} Visualizza l'immagine del prodotto.
${orderItem.quantity} Visualizza il numero di articoli ordinati.
${orderItem.price} Visualizza il prezzo del prodotto.
${orderItem.priceWithoutTax} Visualizza il prezzo del prodotto senza tasse.
${orderItem.isShippingRequired}  
${orderItem.weight} Visualizza il peso del prodotto ordinato.
${orderItem.subtotal} Visualizza il subtotale per articolo (prezzo articolo x quantità ordinata).
${orderItem.subtotalWithoutTax} Visualizza il subtotale ordine senza tasse (prezzo articolo senza tasse x quantità ordinata).
<#list orderItem.options as option> </#list> Visualizza l'elenco delle opzioni di prodotto selezionate.
${option.name} Visualizza il nome dell'opzione.
${option.value} Visualizza il valore selezionato per l'opzione.
<#list orderItem.attributes as attribute> </#list> Visualizza l'elenco di tutti gli attributi impostati per il tipo di prodotto dell'articolo in questione.
${attribute.name} Visualizza il titolo dell'attributo.
${attribute.value} Visualizza il nome dell'attributo.
<#list orderItem.visibleAttributes as visibleAttribute> </#list> Visualizza l'elenco di tutti gli attributi visibili per il tipo di prodotto dell'articolo in questione.
${visibleAttribute.name} Visualizza il titolo dell'attributo visibile.
${visibleAttribute.value} Visualizza il nome dell'attributo visibile.
<#list orderItem.files as file> </#list> Visualizza l'elenco dei file allegati al prodotto.
${file.description} Visualizza la descrizione del file.
${file.fileName}  
${file.name} Visualizza il nome del file.
${file.type} Visualizza il tipo del file.
${file.size} Visualizza la dimensione del file.
${file.url} Aggiunge il link per scaricare il file.
<#list orderItem.taxes as tax> </#list> Visualizza l'elenco delle tasse applicabili al prodotto.
${tax.name} Visualizza il nome della tassa.
${tax.percentValue} Visualizza l'aliquota fiscale.
${tax.absoluteValue} Visualizza l'importo della tassa per subtotale prodotto (l'importo della tassa per articolo x numero di articoli ordinati).
${orderItem.taxesTotalPercentValue} Visualizza il totale in percentuale di tutte le aliquote fiscali applicate al prodotto.
${orderItem.taxesTotalAbsoluteValue} Visualizza l'importo totale di tutte le tasse applicate al prodotto.
${order.number} Visualizza il numero dell'ordine.
${order.customerUrl} Aggiunge l'URL del profilo del cliente. Vuoto se l'ordine è stato effettuato in modo anonimo.
<@orderLink/> Aggiunge il numero dell'ordine. Se l'ordine è stato effettuato da un cliente registrato, contiene l'URL della cronologia degli ordini del cliente. Se non si tratta di un cliente registrato, il numero dell'ordine si visualizza come testo normale.
${order.adminUrl} Aggiunge il link della pagina dell'ordine nel pannello di controllo del negozio.
${order.dateCreated} Visualizza la data in cui l'ordine è stato effettuato.
${order.paymentStatus} Visualizza lo stato di pagamento attuale dell'ordine.
<@paymentStatusColor/> Modifica il colore dell'elemento ${order.paymentStatus} a seconda dello stato di pagamento.
${order.extTransactionId}

Visualizza l'ID transazione per l'ordine (se questo ordine ha un ID transazione).

Un esempio di questa variabile nel codice del modello:
<#if order.extTransactionId?has_content>
<p>Transaction ID: ${order.extTransactionId}</p>
</#if>

${order.subtotal} Visualizza il subtotale dell'ordine.
${order.subtotalWithoutTax} Visualizza il subtotale dell'ordine senza tasse (nessun costo di spedizione incluso).
${order.total} Visualizza il totale dell'ordine.
${order.shippingMethod} Visualizza il nome del metodo di spedizione.
${order.shippingCost} Visualizza il costo di spedizione dell'ordine.
${order.weight} Visualizza il peso totale degli articoli ordinati.
<#list order.taxes as tax> </#list> Visualizza l'elenco delle tasse applicate all'ordine.
${tax.name} Visualizza il nome della tassa.
${tax.value} Visualizza il valore della tassa.
<#list order.discounts as discount> </#list> Visualizza l'elenco degli sconti applicati all'ordine.
${discount.name} Visualizza il nome dello sconto.
${discount.value} Visualizza il valore dello sconto.
${order.couponPercent} Visualizza la percentuale del coupon sconto applicato all'ordine.
${order.couponName} Visualizza il nome del coupon sconto.
${order.couponCode} Visualizza il codice del coupon sconto.
${order.totalDiscount} Visualizza il valore totale dello sconto applicato all'ordine.
${order.isShippingRequired}  
${order.shippingAddress} Visualizza l'indirizzo di spedizione completo dell'ordine. È possibile anche visualizzare separatamente ciascun elemento dell'indirizzo di spedizione.
${order.shippingAddress.name} Visualizza il nome del cliente.
${order.shippingAddress.companyName} Visualizza il nome dell'azienda specificata nell'indirizzo di spedizione.
${order.shippingAddress.street} Visualizza la via specificata nell'indirizzo di spedizione.
${order.shippingAddress.city} Visualizza la città specificata nell'indirizzo di spedizione.
${order.shippingAddress.country} Visualizza il Paese specificato nell'indirizzo di spedizione.
${order.shippingAddress.countryCode} Visualizza il codice del Paese specificato dal cliente nell'indirizzo di spedizione.
${order.shippingAddress.postalCode} Visualizza il codice postale (CAP) specificato nell'indirizzo di spedizione.
${order.shippingAddress.state} Visualizza lo stato specificato nell'indirizzo di spedizione.
${order.shippingAddress.stateCode} Visualizza il codice dello stato specificato dal cliente nell'indirizzo di spedizione.
${order.shippingAddress.phone} Visualizza il numero telefonico del cliente.
${order.shippingAddress.province} Visualizza la provincia specificata nell'indirizzo di spedizione.
${order.shippingAddress.provinceCode} Visualizza il codice della provincia specificata dal cliente nell'indirizzo di spedizione.
${order.shipping.cost} Visualizza il costo di spedizione con tasse incluse.
${order.shipping.costWithoutTax} Visualizza il costo di spedizione al netto delle tasse.
${order.shipping.taxesTotalPercentValue} Visualizza il totale in percentuale di tutte le tasse sulla spedizione.
${order.shipping.taxesTotalAbsoluteValue} Visualizza l'importo totale di tutte le tasse sulla spedizione.
<#list order.shipping.taxes as shippingTax> </#list> Visualizza l'elenco delle tasse sulla spedizione applicate all'ordine
${shippingTax.name} Visualizza il nome di una tassa sulla spedizione.
${shippingTax.percentValue} Visualizza l'aliquota percentuale della tassa sulla spedizione.
${shippingTax.absoluteValue} Visualizza l'importo della tassa sulla spedizione.
${order.billingAddress} Visualizza l'indirizzo di fatturazione completo dell'ordine. È possibile anche visualizzare separatamente ciascun elemento dell'indirizzo di fatturazione.
${order.billingAddress.name} Visualizza il nome del cliente.
${order.billingAddress.companyName} Visualizza il nome dell'azienda specificata nell'indirizzo di fatturazione.
${order.billingAddress.street} Visualizza la via specificata nell'indirizzo di fatturazione.
${order.billingAddress.city} Visualizza la città specificata nell'indirizzo di fatturazione.
${order.billingAddress.country} Visualizza il Paese specificato nell'indirizzo di fatturazione.
${order.billingAddress.countryCode} Visualizza il codice del Paese specificato dal cliente nell'indirizzo di fatturazione.
${order.billingAddress.postalCode} Visualizza il codice postale (CAP) specificato nell'indirizzo di fatturazione.
${order.billingAddress.state} Visualizza lo stato specificato nell'indirizzo di fatturazione.
${order.billingAddress.stateCode} Visualizza il codice dello stato specificato dal cliente nell'indirizzo di fatturazione.
${order.billingAddress.phone} Visualizza il numero telefonico specificato nell'indirizzo di fatturazione.
${order.billingAddress.province} Visualizza la provincia specificata nell'indirizzo di fatturazione.
${order.billingAddress.provinceCode} Visualizza il codice della provincia specificata dal cliente nell'indirizzo di fatturazione.
${order.pickupTime} Visualizza l'orario di ritiro scelto dal cliente.
${order.isPaid}  
${order.paymentMethod} Visualizza il titolo "Metodo di pagamento:" e il nome del metodo di pagamento.
${order.paymentMethod.isOnline}  
${order.paymentMethod.instructionsTitle} Visualizza il titolo delle istruzioni per il pagamento.
${order.paymentMethod.instructions} Visualizza il contenuto delle istruzioni per il pagamento.
${order.paymentMethod.name} Visualizza il nome del metodo di pagamento.
${order.orderComments} Visualizza i commenti all'ordine.
${order.privateAdminNotes} Visualizza le note per lo staff aggiunte all'ordine dal titolare del negozio.
${order.isPaymentStatusUpdated}  
${order.isFulfillmentStatusUpdated}  
${order.fulfillmentStatus} Visualizza lo stato di evasione dell'ordine.
${order.trackingNumber} Visualizza il numero di tracciamento dell'ordine, se abilitato.
${order.trackingUrl} Aggiunge l'URL della pagina di tracciamento dell'ordine per le opzioni di spedizione calcolate dal vettore.
${order.affiliateID} Visualizza l'ID partner dell'ordine.
${order.extraFields}  
<#list order.extraFields as extraField> </#list> Visualizza l'elenco dei campi aggiuntivi dell'ordine.
${extraField.key} Visualizza la chiave del campo aggiuntivo.
${extraField.value} Visualizza il valore del campo aggiuntivo.
${extraField.title} Opzionale. Visualizza il titolo del campo aggiuntivo.
${extraField.orderDisplaySection} Opzionale. Visualizza il titolo del campo aggiuntivo.
${extraField.type} Visualizza il tipo del campo aggiuntivo.
<#list order.surcharges as surcharge> Visualizza l'elenco dei supplementi applicati all'ordine.
${surcharge.id} Visualizza l'ID del supplemento.
${surcharge.totalValue} Visualizza il valore del supplemento.
${surcharge.type} Indica se il supplemento è espresso in percentuale o come valore assoluto
${surcharge.description} Visualizza la descrizione del supplemento
${surcharge.taxable} Indica se il supplemento è soggetto a imposte
${surcharge.showZeroSurchargeInTotal} Visualizza un supplemento totale pari a zero

Funzioni utili per lavorare con i campi aggiuntivi negli ordini

Nome Descrizione
getOrderExtraField(key) Ritorna l'intero oggetto ExtraField (con i campi chiave, valore, titolo, ecc.)
getOrderExtraFieldValue(key) Ritorna il campo valore dell'oggetto ExtraField

Variabili relative ai dati dei prodotti

Nome Descrizione
${product.name} Visualizza il nome del prodotto.
${product.sku} Visualizza il codice articolo del prodotto.
${product.quantity} Visualizza la quantità del prodotto.
${product.adminUrl} Visualizza l'URL della pagina del prodotto nel pannello di controllo.
${product.customerUrl} Aggiunge l'URL della pagina del prodotto.
${product.imageUrl} Visualizza l'immagine del prodotto.
${product.warningLimit} Visualizza il valore impostato come soglia per attivare l'invio della "Notifica di scorte in esaurimento".
${product.options}  
<#list product.options as option> </#list> Visualizza l'elenco delle opzioni del prodotto.
${option.name} Visualizza il nome dell'opzione.
${option.value} Visualizza il valore selezionato per l'opzione.
${product.attributes}  
<#list product.attributes as attribute> </#list> Visualizza l'elenco di tutti gli attributi nascosti impostati per il prodotto.
${attribute.name} Visualizza il titolo dell'attributo nascosto.
${attribute.value} Visualizza il nome dell'attributo nascosto.
<#list product.visibleAttributes as visibleAttribute> </#list> Visualizza l'elenco di tutti gli attributi visibili impostati per il prodotto.
${visibleAttribute.name} Visualizza il titolo dell'attributo visibile.
${visibleAttribute.value} Visualizza il nome dell'attributo visibile.

Variabili relative ai dati del negozio

Nome Descrizione
${store.id} Visualizza l'ID del negozio.
${store.name} Visualizza il nome del negozio.
${store.logoUrl} Richiama l'URL del logo del negozio.
<@storeLogo/> Visualizza il logo del negozio. Se il logo non è specificato, visualizza il nome del negozio.
${store.storeUrl} Richiama l'URL della prima pagina del negozio.
${store.companyEmail} Visualizza l'indirizzo e-mail dell'azienda specificato nelle impostazioni del negozio.
${store.customerOrdersPageUrl} Richiama l'URL della pagina della cronologia degli ordini del cliente.
<#list store.legalPages as page> </#list> Visualizza l'elenco delle pagine contenenti informazioni legali.
${page.name} Visualizza il nome di una determinata pagina con informazioni legali.
${page.url} Richiama l'URL di una determinata pagina con informazioni legali.
<@legalPages/> Visualizza l'elenco delle pagine legali in una sola stringa.
${store.controlPanelUrl} Aggiunge l'URL del pannello di controllo del negozio.
${store.egoodsLinkLifetime} Visualizza la scadenza dei link dei prodotti digitali.
${store.egoodsMaxDownloadAttempts} Visualizza il numero massimo di tentativi per scaricare i prodotti digitali.
${store.officeAddress} Visualizza l'indirizzo fisico del negozio specificato nelle impostazioni del negozio.
${store.resetPasswordUrl} Aggiunge l'URL per reimpostare la password utente.
${store.businessRegistrationID} Visualizza l'ID di registrazione dell'azienda (Partita IVA).

Variabili relative al marchio aziendale

Nome Descrizione
${brand.name} Visualizza il nostro nome.
${brand.logoUrl} Richiama l'URL del nostro logo.
Questo articolo ti è stato utile?

Fantastico! Grazie per il tuo feedback!

Grazie per il tuo feedback!

Ci dispiace molto! Cosa è andato storto?
Utenti che ritengono sia utile: 20 su 38
10
Utilizziamo i cookie e tecnologie simili per ricordare le tue preferenze, misurare l'efficacia delle nostre campagne e analizzare i dati non personalizzati per migliorare le prestazioni del nostro sito. Scegliendo "Accetta", acconsenti all'utilizzo dei cookie.
Accetta i cookie Rifiuta