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 
2. Configurazione corriere
3. Opzioni aggiuntive
4. Errori & Risoluzioni

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. Configurazione corriere

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

3. Opzioni aggiuntive

Destinazioni

• National: Disponibile
• International: Disponibile

Opzioni

• Label PDF: Disponibile

• Label PDF (dimensions): A4 & A6

• Label ZPL: Disponibile

• Label EPL: NO

• Track & Trace: Disponibile

• Paperless: Disponibile

• PickUp/DropOff (PUDO): Disponibile

• Cash On Delivery: Disponibile

• Live Rates: Disponibile

• Return Labels: Disponibile

• Return Labels (in the box): Disponibile

• Book/Schedule Pickup: Disponibile

• Address Check: NO

• Carrier Options: Disponibile

• Proof Of Delivery (POD): Disponibile

• Insurance: Disponibile

• Multiparcel: Disponibile

• Delete Shipment (Void): NO

• CloseOut: NO

• CN22: NO

• CN23: NO

• Credentials Validation: NO

• IOSS: Disponibile

• Dynamic sender: Disponibile

• After Ship ETD: Disponibile

Servizi

Opzioni corriere

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.

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.

Merce pericolosa supportata dall'integrazione MyDHL:

• PDF 10 x 20 - disponibile per barcode e text

• ZPL - disponibile per barcode e text (N.B. non è disponible per ZPL 10x15)

Per maggiori info clicca qui.

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.

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.

Spedizioni internazionali

Generare una fattura in formato DHL

Questa funzione ti permetterà di stampare automaticamente le tue fatture per le spedizioni internazionali (Generate 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!

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 > Gestione fatture, 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 > Gestione fatture 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 > Gestione fatture, 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

4. Errori & Risoluzioni