MyDHL

All’interno della schermata di configurazione del modulo MyDHL è possibile impostare tutto quello che serve per far funzionare correttamente le spedizioni DHL dal tuo back office PrestaShop.

Ricorda che per poter utilzzare e configurare il modulo dovrai disporre di credenziali API (API key e API secret), verifica l’apposita sezione della guida per maggiori informazioni.

Vediamo insieme, punto per punto, cosa significano le varie opzioni e come impostarle al meglio.

👤 Abilita il modulo per i seguenti impiegati

Scegli quali dipendenti possono usare il modulo (cioè creare etichette DHL e vedere l’interfaccia nel back office).
Seleziona uno o più utenti dall’elenco dei dipendenti backoffice attivi.

🌍 Ambiente

Puoi scegliere se lavorare in modalità Sandbox (test) o Production (live).

Sandbox: utile per testare il modulo senza spedire davvero, il modulo mostrerà tutte le funzionalità ma genererà etichette di test.
Production: modalità reale per spedire con DHL.

🐞 Modalità Debug

Serve per abilitare i log estesi del modulo, utili in fase di sviluppo o per risolvere problemi mediante il supporto tecnico.
✔️ Attivalo se qualcosa non funziona e devi capire cosa succede dietro le quinte, il modulo genererà log giornalieri di tutte le comunicazioni con DHL all’interno della cartella /logs/ del modulo.
❌ Tienilo spento in produzione se tutto gira regolarmente.

🔐 Credenziali DHL

API Key e API Secret: li ottieni dal tuo account DHL. Servono per connettere PrestaShop al servizio.
Account spedizione mittente: il tuo codice cliente DHL.

⚠️ Tutti e tre i campi sono obbligatori per far funzionare il modulo.

🧾 Formato etichetta

Scegli in quale formato vuoi scaricare le etichette:

PDF: standard, leggibile su tutti i dispositivi.
PNG: immagine dell’etichetta.
ZPL (Zebra): per stampanti termiche professionali.

Se scegli ZPL, appariranno altri campi da configurare (vedi sotto) per poter stampare direttamente le etichette sulla stampante Zebra.

Per la stampa diretta in formato ZPL con il modulo, è necessario installare e configurare correttamente Zebra Browser Print sul computer utilizzato per la stampa.

Zebra Browser Print è un’applicazione desktop fornita da Zebra Technologies che consente al browser web di comunicare direttamente con le stampanti Zebra collegate al computer, sia via USB che in rete. Questo permette la stampa immediata di etichette ZPL direttamente dal back office di PrestaShop, senza dover scaricare file o utilizzare software esterni.

Affinchè il modulo funzioni correttamente la stampante da utilizzare dovrà essere correttamente rilevata da Browser Print

Se sono collegate più stampanti Zebra, al primo utilizzo verrà visualizzato un popup per la selezione della stampante desiderata. La scelta effettuata verrà memorizzata dal browser. Per modificare questa selezione in futuro, sarà sufficiente cancellare la cache del browser in uso.

🖨️ Template etichetta ZPL (solo se usi ZPL)

Scegli il layout che preferisci per le etichette stampate su stampante Zebra.
Ogni modello ha dimensioni diverse. L’impostazione di default ECOM26_A6_001 prevede l’utilizzo di etichette in formato 10.5 x 15 cm.

E’ importante verificare, in fase di stampa, che l’etichetta generata sia completa e mostri tre codici a barre nella parte inferiore.

📦 Stampa da lista ordini (solo se usi ZPL)

Se attivo, potrai stampare l’etichetta direttamente dalla lista degli ordini, senza entrare nei dettagli.

Questa modalità permette la generazione e la stampa di etichette con un click, dopo aver selezionato l’imballo da utilizzare per la spedizione.

Qui avrai la possibilità di configurare:

Selettore CSS per tasto etichette nella lista ordini (selettore CSS del bottone)
Classi CSS per tasto etichette nella lista ordini (classe CSS del bottone)

⚠️Queste opzioni sono per utenti avanzati o per chi necessita di mostrare il tasto di stampa rapida in moduli lista ordini di terze parti.
Non dovrai modificare i valori di default se utilizzi la lista ordini classica di Prestashop.

Codice prodotto DHL per la stampa dalla lista ordini (codice prodotto DHL predefinito per queste etichette)

📊 Dashboard spedizioni

Ti permette di attivare una dashboard riassuntiva sulle spedizioni direttamente nel back office (si veda apposita sezione della documentazione)

📦 Codici prodotto DHL preferiti

Inserisci qui i codici dei servizi DHL che vuoi usare, separati da virgola (es: P,E,N) in ordine di priorità.
Il modulo , durante la creazione di una spedizione all’interno dell’ordine, selezionerà sempre il servizio prioritario al momento della richiesta dei servizi disponibili.
⚠️Questa opzione NON si applica per la stampa dalla lista ordini, che prevede un solo codice prodotto selezionabile nella configurazione “Codice prodotto DHL per la stampa dalla lista ordini”
👉 Chiedi al tuo referente DHL quali codici usare se non li conosci.

📝 Descrizione spedizione predefinita

Comparirà come descrizione doganale nel caso non venga specificata altrove.
(es: “Accessori moto” o “Ricambi elettronici”)

🔢 HS Code e Paese di produzione

Codice doganale di default: codice doganale di default (8 cifre). Obbligatorio per l’export extra UE.
Sarà sempre possibile modificarlo per ciascun prodotto durante la compilazione della dichiarazione doganale all’interno dell’odine.
Codice ISO paese produttore di default: codice ISO del paese (es: IT per Italia), usato se il prodotto non lo ha.

📎 Invio automatico della fattura PrestaShop come documento doganale

Se questa opzione è attiva e se è disponibile al momento della generazione etichetta,
la fattura PDF di PrestaShop sarà allegata automaticamente alla spedizione come documento digitale “paperless”.

📐 Salva misure del pacco nel prodotto

Quando attivo, se spedisci un ordine con un solo prodotto senza misure impostate, il modulo userà la dimensione del pacco selezionato per aggiornare automaticamente
le dimensioni Prestashop del prodotto.

🚚 Corriere da aggiornare dopo creazione etichetta

Puoi scegliere se assegnare un corriere PrestaShop specifico dopo che viene generata con successo l’etichetta di spedizione.

📦 Stati ordine personalizzati

Il modulo è in grado di avanzare automaticamente lo stato di un ordine al verificarsi di questi eventi:

Etichetta generata: Si attiva dopo la creazione di un’etichetta andata a buon fine.
Spedito: Si attiva mediante cron o tasto di richiesta aggiornamento tracking, dopo che il tracking diventa tracciabile lato DHL.
Consegnato: Si attiva mediante cron o tasto di richiesta aggiornamento tracking, quando la spedizione risulta consegnata.

Per ciascuno di questi eventi è possibile evitare l’avanzamento di stato selezionando “Non modificare lo stato ordine”.

Stati ordine per contrassegno: seleziona gli stati d’ordine validi per il contrassegno, questo permetterà l’applicazione automatica dell’importo dell’ordine come contrassegno da riscuotere.

💡Non avanzare automaticamente lo stato dell’ordine se si trova in questi stati

Potrebbe risultare utile evitare che l’avanzamento automatico degli stati ordini avvenga in determinate condizioni (es. ordini con problemi, ordini parziali etc.).
In questo menu è possibile selezionare uno o più stati che, se assegnati all’ordine, bloccheranno qualsiasi avanzamento automatico da parte del modulo.

🛡️ Assicurazione automatica ordini

Lascia vuoto = nessuna assicurazione.
Scrivi 0 = assicurazione sempre attiva.
Oppure, inserisci una cifra per assicurare solo gli ordini sopra quella soglia (es: 200).

🧑 Impiegato predefinito

Scegli il dipendente backoffice di default per il modulo (usato per operazioni di cambio status automatiche / tramite cron).

✉️ Dettagli Mittente

In questa sezione imposti le informazioni del mittente, cioè chi spedisce fisicamente la merce. Questi dati vengono usati da DHL per compilare le etichette e per tutte le comunicazioni doganali.

Compila tutti i campi con attenzione:

Nome azienda: la tua ragione sociale o nome commerciale.
Nome completo: nome e cognome del referente (es. “Mario Rossi”).
E-mail: email da usare per notifiche o contatti DHL.
Telefono: un numero raggiungibile in caso di problemi (meglio se mobile).
Indirizzo linea 1 / 2: la via, numero civico, eventuale scala, interno, ecc.
Codice postale: ZIP code o CAP della sede di spedizione.
Città: la località del mittente.
Codice ISO paese: sigla internazionale a 2 lettere (es. IT per Italia, FR per Francia).
Numero di registrazione azienda: può essere la partita IVA, il codice EORI o qualsiasi riferimento doganale ufficiale richiesto per esportazioni.

👉 Queste informazioni devono corrispondere a quelle registrate con DHL per il tuo codice cliente (Shipper Account Number), altrimenti le spedizioni potrebbero venire rifiutate o bloccate in dogana.

📦 Imballi

In questo tab puoi configurare tutti i tipi di pacco (box) che usi abitualmente per le spedizioni. È una funzionalità comoda per non dover inserire ogni volta le misure a mano.

📋 Come funziona:

Inserisci un nome descrittivo del pacco (es: “Scatola piccola”, “Box A4”, “Cartone 60×40”).
Specifica le dimensioni interne:
- Lunghezza (cm)
- Larghezza (cm)
- Altezza / profondità (cm)
Spunta l’opzione “Default” se vuoi che questo pacco venga proposto di default nella creazione etichetta.

🛠️ Pulsanti disponibili:

Aggiungi imballo: per creare una nuova riga nella tabella.
Salva imballi: per confermare le modifiche.

🌍 Paesi con dogana

Questa sezione serve al modulo per capire in quali paesi è necessario compilare una dichiarazione doganale durante la creazione di una spedizione.

Quando abiliti un paese in questo elenco, stai dicendo al modulo:

“Le spedizioni verso questo paese richiedono una dichiarazione doganale.”

Di conseguenza, quando creerai una spedizione verso uno di questi paesi, ti verrà automaticamente mostrata la sezione doganale da compilare (contenuto, valore, origine della merce, ecc.).

✅ Come funziona

Spunta i paesi dove la dogana è necessaria (tipicamente tutti quelli extra-UE).
Per ciascun paese abilitato puoi anche impostare eventuali regole di esclusione per codici postali.

📌 Regole esclusione CAP

In alcuni paesi (es. Irlanda del Nord), non tutte le aree prevedono dogana in export. Se vuoi escludere alcune aree, puoi usare questo campo, che bypasserà la dogana se il CAP contiene i caratteri inseriti.

🧠 Esempi validi:

001 esclude tutti i CAP che iniziano per 001
BT esclude tutti i CAP che iniziano per BT

💡 Se un codice postale rientra tra quelli esclusi, non verrà proposta la dichiarazione doganale anche se il paese è abilitato.

💾 Salvataggio

Dopo aver selezionato i paesi e impostato eventuali regole ZIP, clicca su “Salva impostazioni” in fondo alla tabella.

📁 Documenti doganali

Questa sezione ti permette di caricare e gestire PDF personalizzati (es: fatture pro forma, certificati, dichiarazioni di origine) che possono essere allegati automaticamente alle spedizioni internazionali.

📤 Per caricare un documento:

Nome interno: un’etichetta che ti aiuta a riconoscere il file (es. “Dichiarazione venditore”).
Tipo documento: scegli tra le opzioni disponibili (saranno usate per invio via API).
(Facoltativo) Spunta “Allega automaticamente a spedizioni doganali” se vuoi che venga allegato a tutte le spedizioni doganali.
Seleziona il file: deve essere un PDF.
Clicca su “Upload”.

Il file comparirà nella tabella in basso, dove potrai:

Scaricarlo
Eliminarlo
Vedere se è stato marcato come allegato automatico

📌 I file caricati qui sono riutilizzabili per tutte le spedizioni, senza doverli ricaricare ogni volta. È l’ideale per chi fa molte export extra-UE.

Configurazione del modulo