Come connettere MyDHL a ShippyPro

MyDHL è un servizio web di DHL, leader nella logistica a livello globale.

In questo articolo imparerai a collegare MyDHL a ShippyPro. Scoprirai anche le funzioni aggiuntive come la creazione di un'etichetta di reso da inserire direttamente nella scatola (return label in the box) e la Paperless Trade (documentazione Paperless). ✨

 

 

Sommario:

1. Prima di iniziare

   1. Registrati al DHL Developer Portal

   2. Compila il modulo DHL

2. Step di connessione
3. Opzioni aggiuntive
4. Spedizioni internazionali
5. Risoluzione di errori

 

1. Prima di iniziare

Registrati al DHL Developer Portal

Per procedere con la connessione è necessario avere una chiave API, un API Secret e un Account Number che puoi recuperare registrandoti al DHL Developer Portal se non ne hai ancora uno.

Compila il modulo DHL

• Vai su APIs > Browse all services

   

  

   

• Clicca su DHL Express - MyDHL API

  

   

• Poi su Get Access:

   

  

   

• Compila i dati inerenti alla tua azienda

• Alla voce "Come vorresti utilizzare l'API?" seleziona l'opzione "Richiedo le credenziali per DHL Express – API MyDHL per un plug-in esistente/piattaforma di ecommerce/soluzione di terze parti" e aggiungi semplicemente ShippyPro.

• Per quanto riguarda la sezione denominata "Servizi richiesti", basterà selezionare tutti i servizi disponibili. Il campo "Volume delle transazioni mensili" è utile a DHL solo a fini statistici, quindi non influenzerà il tuo utilizzo dell'API.

• Dopo qualche ora potrai controllare il tuo profilo DHL Developer dove dovresti essere in grado di visualizzare l'App Status come approvato.

 

• Clicca su DHL EXPRESS - MYDHL API sotto App Name e troverai un pulsante rosso Request Production Access, una volta selezionato riceverai la conferma di invio della richiesta in pochi minuti e sarà il team DHL locale a doverla approvare secondo le loro tempistiche.
  In caso la richiesta resti pendente ti invitiamo a contattare direttamente DHL per velocizzare l'approvazione.

In caso di dubbi o domande, non esitare a dare un'occhiata a questa guida DHL passo-passo.

2. Step di connessione

Ora che tutto è impostato correttamente nel portale MyDHL, potrai collegarti a ShippyPro.

• Vai su Corrieri e clicca su logo MyDHL (digita semplicemente "MyDHL" sulla barra di ricerca per individuarlo immediatamente).

• Se effettua spedizioni in contrassegno, ricordati di contrassegnare la casella "Confermo di essere a conoscenza del messaggio sottostante" (I confirm that I am aware of the below message):

• Inserisci chiave API, API Secret e Account Number

  ❗Assicurati di evitare gli spazi quando copi e incolli, altrimenti ti apparirà il messaggio di errore "Invalid Credentials".

• Scegli il tuo Tipo di etichetta e il codice prodotto. Ricordati di chiedere al tuo Account Manager DHL quali sono i tuoi codici prodotto attivi. Se desideri aggiungere più servizi, dovrai creare una nuova connessione per ognuno di questi.

• Ricorda che il servizio EXPRESS WORLDWIDE NONDOC riguarda solo la merce e il servizio EXPRESS WORLDWIDE DOC riguarda i documenti e non altri tipi di beni fisici.

📌 Se vuoi includere più servizi all'interno della stessa connessione corriere, dovrai selezionare Product Code: ALL SERVICES.

📌Se dopo aver aggiunto le credenziali da Corrieri > Modifica, o dopo aver effettuato la prima spedizione, viene restituito un errore di credenziali non valide, verificare che la richiesta di credenziali sia stata effettuata correttamente e che non vi siano spazi vuoti prima o dopo tutti i dettagli delle credenziali.

 

3. Opzioni aggiuntive

🔁 Stampa etichette di reso

Se vuoi stampare sia l'etichetta di andata che quella di reso con una label in the box, e quindi in una sola volta, aggiungi il tuo Account Number nel campo "Account Number" e il tuo Return Account Number (impex) nel campo "Return Account Number". A questo punto, spunta la voce Enable Return Label in the box in basso e conferma.

Nota: Il formato dell'etichetta sarà quello scelto per le spedizioni in uscita. Non potrà essere cambiato per le etichette di reso.

📌 Se desideri effettuare i Resi separatamente dalla spedizione principale, devi creare una nuova connessione MyDHL: inserisci il tuo Return Account Number (impex) nel campo "Account Number" e il tuo Account Number nel campo "Return Account Number". In pratica, l'esatto opposto della prima configurazione. NON spuntare la voce Enable Return Label in the box. In questo modo puoi creare una spedizione manuale per il Reso: clicca qui per scoprire come.

Cliccando su Fixed Return Receiver Address (Only for 'Enable Return Label in the box'), se l'opzione Enable Return Label in the box è stata spuntata e si seleziona un indirizzo dal menu a tendina, le label in the box non verranno reindirizzate all'indirizzo del mittente, ma all'indirizzo impostato nel menu a tendina.

È possibile aggiungere e modificare gli indirizzi disponibili in qualsiasi momento da Amministrazione > I miei indirizzi e pacchi > I miei indirizzi.

🧾 Generare una fattura in formato DHL

Questa funzione ti permetterà di stampare automaticamente le tue fatture per le spedizioni internazionali (Generat Invoice with DHL format). Puoi scegliere se generare una fattura proforma o commerciale.

Selezionando questa opzione, la fattura verrà generata insieme all'etichetta di spedizione!

🗓 Extend label validity

Questo servizio viene solitamente usato per le label di ritorno, e aggiungerà l'estensione RET sulla label creata da MyDHL.

Selezionando l'opzione Extend label validity, potrai estendere la durata di un LDV senza conoscere la data effettiva di affidamento al Corriere.

🚚 Add freight charges to commercial invoice

Se selezioni questa opzione, le spese di spedizione verranno aggiunte alla fattura commerciale creata.

🧪 Test Mode

Abilita la modalità Test se desideri effettuare spedizioni di prova. Tieni presente che questa opzione deve essere contrassegnata solo se disponi delle credenziali di test, non delle credenziali di produzione!

⚠️ Merce Pericolosa

Per ogni spedizione contenente merce pericolosa dovrai inserire il contentId della merce pericolosa spedita.

Se la spedizione contiene ghiaccio secco UN1845 dovrai inserire il peso del ghiaccio secco trasportato.

Se la merce è in quantità esentata secondo la IATA, dovrai inoltre inserire il codice UNCode della merce pericolosa, disponibile qui.

✍🏻 Etichette personalizzate

Puoi anche creare un'Etichetta Personalizzata per riconoscere immediatamente la connessione tra tutte le altre.

📆 Default amount of additional weekdays required to prepare the shipments

Questo dato serve a DHL per sapere la data pianificata di spedizione, ma non equivale alla richiesta di ritiro (che puoi effettuare così). Il numero predefinito di giorni necessari per la preparazione è 1 giorno, ma è possibile modificarlo a piacere selezionando il numero di giorni dalla modale. Il sistema salta automaticamente i giorni festivi e i fine settimana nel conteggio dei giorni richiesti.

📌Assicurati di eseguire questa operazione su tutte le connessioni myDHL, anche se utilizzate un solo servizio.

📌 Se scegli "same day" chiedi a DHL qual è l'orario entro cui puoi creare le spedizioni, altrimenti potresti riscontrare un errore.

Attivazione del Servizio Service Point

Se desideri utilizzare il Service Point di myDHL, dovrai contattare il tuo referente di verificare l’abilitazione al servizio ODD (necessario per utilizzare questa funzionalità).
​
Una volta attivato il servizio ODD, sarà necessario inviare al reparto tecnico del corriere un screenshot dell'Opzione Corriere dove viene scelto il Service Point, e richiedere l’abilitazione al servizio sul username desiderato.

Sulla label non compare mai il Service Point che invece viene trasmesso elettronicamente al corriere incaricato della consegna.

 

4. Spedizioni internazionali

🌱 Paperless Trade

Puoi decidere di attivare l'opzione Paperless selezionando "Paperless Trade" da Corrieri > MyDHL > Modifica. In questo caso, sarà necessario trasmettere digitalmente al corriere una fattura caricando la fattura ETD dalla pagina Label Creator > Invoice Manager, tramite la chiamata API UploadPaperlessDocumentation, oppure richiedendo a DHL la generazione di una fattura con il loro formato (in questo caso, leggere i punti successivi).

È anche possibile caricare il tipo di dichiarazione doganale da Label Creator > Invoice Manager e decidere di attivare l'opzione Generate Invoice with DHL format da Corrieri > MyDHL > Modifica.

È importante notare che al momento del caricamento della documentazione è necessario selezionare la tipologia corretta, ad esempio "Dichiarazione doganale".

Se selezionate entrambe le opzioni Generate Invoice with DHL format e Paperless da Corrieri > MyDHL > Modifica, e caricate la dichiarazione doganale da Label Creator > Invoice Manager, sia la fattura commerciale che la dichiarazione doganale saranno trasmesse elettronicamente al corriere.
​
​

Alcuni esempi pratici:

• l'opzione "Paperless Trade" è abilitata, ma non è stato né caricato l'ETD per uno specifico ordine, né abilitata l'opzione "Generate Invoice with DHL format": verrà restituito un errore poiché si sta richiedendo l'invio di una fattura paperless, ma nessuna fattura è associata a quell'ordine

• sia l'opzione "Generate Invoice with DHL format" che l'opzione Paperless sono abilitate: in questo modo, si chiede a DHL di generare una fattura e di inviarla in formato digitale senza doverla allegare fisicamente al pacco (Paperless Trade)

• è stato sia caricato il documento ETD sia attivata l'opzione "Generate Invoice with DHL format": verrà restituito un errore perché si sta chiedendo di trasmettere 2 fatture diverse per un unico ordine
  ​

• Non è stata attivata l'opzione "Paperless Trade", ma ha comunque proceduto al caricamento del documento tramite la chiamata "UploadPaperlessDocumentation" o tramite Invoice Manager: la documentazione verrà comunque trasmessa al corriere in modalità Paperless.

5. Risoluzione errori