# Numero di tracking nell'e-mail Spedito: guida completa
> Panoramica Numero di tracking nell'e-mail Spedito aggiunge un blocco Traccia il tuo pacco all'e-mail Spedito di PrestaShop: il corriere, il numero di tracking e un pulsante che apre la pagina…
- Pagina:
- Lingua: it
- Aggiornato il: 2026-11-03
- Altre lingue: [en](https://www.datafirefly.com/en/documentation/dftrackingmail/index.md), [fr](https://www.datafirefly.com/documentation/dftrackingmail/index.md), [es](https://www.datafirefly.com/es/documentation/dftrackingmail/index.md), [de](https://www.datafirefly.com/de/documentation/dftrackingmail/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftrackingmail/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftrackingmail/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftrackingmail/index.md)
- Indice:
## Panoramica
Numero di tracking nell'e-mail Spedito aggiunge un blocco **Traccia il tuo pacco** all'e-mail Spedito di PrestaShop: il corriere, il numero di tracking e un pulsante che apre la pagina di tracciamento del corriere. Il blocco è scritto nella lingua dell'ordine e viene inserito durante l'invio dell'e-mail: i tuoi template e-mail non vengono mai modificati.
Il modulo può anche **trattenere l'e-mail Spedito** quando un ordine viene segnato come spedito prima che sia inserito il suo numero di tracking, e inviarla non appena il numero viene salvato. Mostra un riquadro di tracking nell'account cliente e ti offre un'anteprima in tempo reale, un'e-mail di test, una coda e un registro attività.
Funziona su PrestaShop da 1.7.8 a 9.x con PHP da 7.1 a 8.5, su Classic, Hummingbird e i loro temi figli. Il back office e i testi predefiniti sono disponibili in inglese, francese, spagnolo, tedesco, italiano, polacco, olandese e portoghese.
La scheda Panoramica: stato, indicatori degli ultimi 30 giorni, checklist per iniziare e attività recente.
## Installazione e aggiornamento
1. In **Moduli > Gestione moduli**, clicca su **Carica un modulo** e trascina il file `dftrackingmail-2.0.0.zip`.
2. Clicca su **Configura**. Il modulo è già attivo sull'e-mail Spedito, con testi predefiniti in tutte le lingue installate.
Un messaggio di benvenuto elenca i tre punti da controllare: i link di tracciamento dei tuoi corrieri, i colori del blocco e un'e-mail di test.
**Aggiornamento dalla 1.0:** carica il nuovo zip sopra il vecchio. Impostazioni, testi, colori, link dei corrieri ed e-mail trattenute vengono conservati. Il riquadro nell'account cliente parte disattivato, quindi nulla cambia sul tuo negozio finché non lo attivi.
## Impostazioni
### Attivazione
- **Aggiungi i dettagli di tracking alle e-mail**: se disattivato, ogni e-mail viene inviata esattamente come la crea PrestaShop.
- **Mostra un riquadro di tracking nell'account cliente**: nella pagina dei dettagli dell'ordine e nella pagina di tracciamento ospite.
### E-mail che mostrano il numero di tracking
Lo stato Spedito predefinito invia l'e-mail `shipped`, selezionata per impostazione predefinita. Ogni stato d'ordine che invia un'e-mail è elencato con il suo template, così puoi aggiungere stati personalizzati o l'e-mail `in_transit`.
### Dati e privacy
Scegli per quanto tempo conservare il registro attività e le e-mail inviate (90 giorni per impostazione predefinita). La copia di un'e-mail trattenuta viene eliminata non appena viene inviata o annullata. Con il modulo GDPR ufficiale, i dati dei clienti vengono esportati ed eliminati insieme al resto dell'account.
La scheda Impostazioni: attivazione, e-mail interessate, trattenuta dell'e-mail e conservazione dei dati.
## Trattenere l'e-mail finché non viene inserito il numero di tracking
Se cambi lo stato in Spedito prima di stampare l'etichetta, l'e-mail predefinita parte senza alcun numero. Attiva **Trattieni l'e-mail**: l'e-mail Spedito attende quindi in una coda e parte non appena il numero di tracking viene salvato, nella pagina dell'ordine o da un modulo corriere.
- **Invia comunque dopo**: l'e-mail parte senza numero (o con il messaggio di attesa) dopo questo intervallo, 48 ore per impostazione predefinita.
- **E-mail In transito**: PrestaShop la invia quando viene inserito un numero di tracking. Per impostazione predefinita viene saltata quando l'e-mail Spedito trattenuta è appena partita, così il cliente riceve un'unica e-mail completa invece di due.
- Vengono trattenute solo le e-mail dei corrieri con **Numero di tracking previsto** spuntato nella scheda Corrieri. Il ritiro in negozio e gli altri corrieri senza tracking non vengono mai trattenuti.
Nella pagina dell'ordine, un riquadro mostra i numeri che vedrà il cliente, lo stato dell'e-mail trattenuta e due azioni: **Invia ora senza numero di tracking** e **Non inviare**.
Pagina dell'ordine: l'e-mail Spedito è trattenuta finché non viene inserito il numero di tracking.
### Attività cron
L'attività cron è necessaria solo quando la trattenuta è attiva. Eseguila ogni 15 minuti: invia le e-mail trattenute il cui numero è stato scritto da un modulo corriere o la cui attesa è scaduta, ed elimina le voci vecchie. Copia l'URL dalla scheda Impostazioni (funziona in modalità manutenzione) o usa la riga di comando:
```
php /path/to/prestashop/modules/dftrackingmail/cli/process-queue.php
```
**Genera un nuovo URL** invalida quello precedente.
## E-mail e testi
### Posizione nell'e-mail
- **Dopo il riferimento dell'ordine** (consigliato): subito dopo la frase che indica il riferimento dell'ordine.
- **Subito dopo il saluto**: visibile per primo.
- **Manuale**: il blocco appare solo dove il tuo template contiene `{df_tracking_block}`.
### Stile e colori
Scegli uno stile riquadro, barra colorata o minimale, poi i colori di sfondo, bordo, pulsante e testo del pulsante. Il contrasto del pulsante viene verificato in tempo reale: sotto 4,5:1 il testo è poco leggibile e compare un avviso.
### Contenuto e testi
Mostra o nascondi il nome del corriere e il pulsante di tracciamento, e scegli cosa succede quando l'ordine non ha ancora un numero di tracking: nascondere il blocco o mostrare il messaggio di attesa. I testi si modificano per lingua: titolo, introduzione, etichette del corriere e del numero, testo del pulsante, messaggio di attesa ed etichetta del pacco. L'introduzione accetta `{firstname}`, `{lastname}`, `{order_name}`, `{carrier_name}` e `{tracking_number}`; l'etichetta del pacco accetta `{n}` e `{total}`.
L'anteprima in tempo reale a destra segue le tue modifiche prima del salvataggio, nella lingua selezionata per i testi, su computer o telefono.
La scheda E-mail e testi con l'anteprima in tempo reale.
## Corrieri e link di tracciamento
Il pulsante di tracciamento usa l'URL di tracking impostato in **Spedizione > Corrieri**. Compila il campo di un corriere per sostituirlo solo nelle e-mail. Inserisci `{tracking_number}` (o `@`, la sintassi di PrestaShop) dove va il numero; `{postcode}` e `{country_iso}` vengono compilati dall'indirizzo di consegna per i corrieri che li richiedono.
- Compare un suggerimento quando il nome del corriere viene riconosciuto; **Altri corrieri** elenca 21 link di tracciamento (Colissimo, Chronopost, Mondial Relay, DPD, GLS, UPS, FedEx, DHL, PostNL, bpost, Correos, SEUR, CTT, Poste Italiane, BRT, InPost, Poczta Polska, Royal Mail, USPS, 17TRACK).
- **Test** apre il link con un numero di esempio.
- **Numero di tracking previsto**: deseleziona i corrieri che non hanno mai un numero. La loro e-mail non viene mai trattenuta e non vengono contati tra quelli senza link.
Prova ogni link una volta con un numero reale: i corrieri a volte cambiano l'indirizzo della loro pagina di tracciamento.
Corrieri, link di tracciamento, suggerimenti e pulsante Test.
## Anteprima e test
La scheda Anteprima e test mostra l'intera e-mail, creata a partire dai template del tuo negozio: con dati di esempio fittizi (un pacco, due pacchi o nessun numero per ora) o con un ordine recente. Scegli la lingua e l'e-mail, poi passa dalla versione HTML alla versione testo e alla vista telefono.
**Invia un'e-mail di test** invia l'e-mail selezionata all'indirizzo che inserisci, con **[Test]** nell'oggetto. Il cliente non riceve nulla. Il test usa le impostazioni salvate.
Anteprima dell'e-mail Spedito su un ordine reale ed e-mail di test inviata.
## Cosa ricevono i tuoi clienti
Il blocco mostra il corriere, il numero di tracking in un carattere leggibile e il pulsante di tracciamento. Quando un ordine ha più pacchi, ognuno è numerato e ha il proprio pulsante. La versione testo dell'e-mail contiene le stesse informazioni.
L'e-mail Spedito con il blocco di tracking.
Su un telefono, con due pacchi.
## Account cliente
Quando l'opzione è attiva, la pagina dei dettagli dell'ordine e la pagina di tracciamento ospite mostrano un riquadro di tracking con il corriere, il numero, un pulsante **Copia** e il pulsante di tracciamento. Il riquadro usa i testi del blocco e si adatta a Classic, Hummingbird e ai loro temi figli.
Riquadro di tracking nella pagina dei dettagli dell'ordine.
Lo stesso riquadro su un telefono.
## Coda e attività
La scheda **Coda e attività** elenca le e-mail trattenute con filtri per stato (trattenute, inviate, non riuscite, annullate). **Invia ora** e **Non inviare** agiscono su una singola e-mail; **Elabora la coda ora** esegue subito l'attività cron. Un'e-mail non riuscita viene ritentata automaticamente tre volte e ne viene mostrato il motivo.
Il registro attività annota ogni e-mail: tracking aggiunto, inviata senza numero, trattenuta, e-mail trattenuta inviata, e-mail In transito saltata, e-mail di test.
E-mail trattenute e registro attività.
## Posizione manuale e variabili
Con la posizione manuale, aggiungi queste variabili al tuo template e-mail (Aspetto > Tema e-mail, la cartella mails del tuo tema o un modulo editor di e-mail):
- `{df_tracking_block}`: l'intero blocco, versione HTML.
- `{df_tracking_block_txt}`: l'intero blocco, versione testo.
- `{df_tracking_number}`: i numeri di tracking, separati da virgole.
- `{df_tracking_url}`: il link di tracciamento del primo pacco.
- `{df_carrier_name}`: i nomi dei corrieri.
La scheda Aiuto: come funziona, variabili e domande frequenti.
## Risoluzione dei problemi
### Il cliente ha ricevuto l'e-mail senza numero di tracking
L'ordine è stato impostato su Spedito prima che venisse inserito il numero. Attiva la trattenuta nella scheda Impostazioni. La tabella Attività mostra ogni e-mail con o senza numero.
### Il pulsante di tracciamento non appare
Il corriere non ha un link di tracciamento utilizzabile. Apri la scheda Corrieri, usa un suggerimento o incolla il link del corriere, poi clicca su **Test**.
### Le e-mail trattenute non partono
Il numero è stato scritto da un modulo corriere, o l'attesa è scaduta, ma l'attività cron non viene eseguita. La scheda Panoramica mostra un avviso quando non viene eseguita da più di 2 ore. Configurala con l'URL o la riga di comando, oppure clicca su **Elabora la coda ora**.
### L'e-mail è nella lingua sbagliata
L'e-mail usa la lingua dell'ordine. Se PrestaShop non ha un template in questa lingua, invia la versione nella lingua predefinita: l'anteprima ti indica quale versione viene usata.