Come connettere DHL Freight a ShippyPro

Sommario:

1. Prima di iniziare
2. Configurazione del corriere
3. Funzionalità aggiuntive
4. Risoluzione dei problemi ed errori

1. Prima di iniziare

DHL Freight non è un corriere per pacchi: una spedizione è un insieme di pallet descritti da peso, volume e metri di carico, e dovrai scegliere un prodotto freight che sia domestico oppure internazionale.

Per configurare DHL Freight, hai bisogno di:

• Un'applicazione registrata sul Portale Sviluppatori DHL — nota che la registrazione per DHL Freight richiede un modulo di onboarding specifico, poiché la registrazione generica del portale sviluppatori non attiva l'accesso a Freight
• Un Account Number (AccountID) e, se vuoi utilizzare le Tariffe in tempo reale, un eID Username/Password — questi vengono rilasciati dal tuo referente commerciale DHL Freight, non dal portale sviluppatori

Se non hai ancora queste credenziali, contatta il tuo referente DHL Freight per richiedere l'accesso.

2. Configurazione del corriere

Segui questi passaggi per connettere DHL Freight al tuo account ShippyPro:

1. Accedi al tuo account ShippyPro
2. Vai su Connessioni > Corrieri
3. Scorri verso il basso e clicca sul logo DHL Freight
4. Apparirà una finestra di connessione. Compila i campi richiesti:
   • Client ID: Inserisci l'API Key della tua applicazione dal Portale Sviluppatori DHL
   • Client Secret: Inserisci l'API Secret della stessa applicazione
   • Account Number: Inserisci il tuo AccountID DHL Freight (formato: 12345678.IT0001)
   • eID Username / eID Password: Opzionale, richiesto solo se vuoi utilizzare le Tariffe in tempo reale
   • Delivery Terms (Payer Code): Seleziona DAP, DDP, EXW o CPT
   • Service: Seleziona il tuo prodotto freight (deve corrispondere alla tua tratta di spedizione — vedi Tipi di servizio qui sotto)
   • Label format: Seleziona PDF A4, PDF A6, o ZPL 203 DPI
5. Clicca su Salva per stabilire la connessione

ShippyPro validerà automaticamente le tue credenziali. Se l'operazione ha successo, DHL Freight apparirà come corriere attivo nel tuo account.

Configurazione opzionale:

• Modalità Test: Attiva questa opzione se vuoi utilizzare l'ambiente sandbox per scopi di test

3. Funzionalità aggiuntive

Destinazioni

Nazionali: Le spedizioni domestiche richiedono che mittente e destinatario si trovino nello stesso paese, servite da un prodotto freight domestico

Internazionali: 40+ paesi europei, secondo la copertura di DHL Freight. Le spedizioni oltre l'Europa non sono supportate per il freight.

Funzionalità

• Tipo di etichetta: PDF (A4, A6), ZPL
• Track & Trace: Disponibile
• Paperless: Non disponibile
• PickUp/DropOff (PUDO): Non disponibile
• Contrassegno: Disponibile (EUR, CZK, PLN, HUF, TRY, RSD, RON, CHF, GBP — SEK non supportato)
• Tariffe in tempo reale: Disponibile (richiede credenziali eID; i preventivi sono indicativi e non vincolanti)
• Etichette di reso: Non disponibile
• Etichette di reso (nella scatola): Non disponibile
• Prenota/Programma ritiro: Disponibile (come opzione della spedizione, non come servizio autonomo — vedi sotto)
• Verifica indirizzo: Non disponibile
• Prova di consegna (POD): Disponibile
• Opzioni di mancata consegna: Non disponibile
• Assicurazione: Disponibile (valute COD più DKK, MAD, NOK — SEK non supportato)
• Multicollo: Disponibile (fino a 999 colli)
• Annulla spedizione (Void): Non disponibile tramite API — le cancellazioni devono passare attraverso il Servizio Clienti DHL
• Chiusura: Non disponibile
• CN22: Non disponibile
• CN23: Non disponibile
• Validazione credenziali: Disponibile

Tipi di servizio

• DHL Road Freight Standard Domestic: Trasporto stradale standard domestico
• DHL Road Freight Standard International: Trasporto stradale standard internazionale
• DHL Road Freight Priority Domestic: Trasporto stradale prioritario domestico
• DHL Road Freight Priority International: Trasporto stradale prioritario internazionale
• DHL Standard Pallet Domestic: Servizio pallet standard, domestico
• DHL Standard Pallet International: Servizio pallet standard, internazionale
• DHL Premium Pallet Domestic: Servizio pallet premium, domestico
• DHL Premium Pallet International: Servizio pallet premium, internazionale
• DHL Home Delivery Domestic: Consegna a domicilio per destinatario privato, domestico
• DHL Home Delivery International: Consegna a domicilio per destinatario privato, internazionale

Nota: il tuo contratto DHL Freight determina quali di questi prodotti puoi effettivamente utilizzare — un prodotto domestico non può essere utilizzato su una tratta internazionale, e viceversa.

Spedizioni multicollo

DHL Freight supporta fino a 999 colli per spedizione. Ogni collo riceve il proprio codice di tracciamento (SSCC), oltre al numero di tracciamento principale della spedizione.

Assicurazione

DHL Freight offre assicurazione basata sul valore dichiarato della tua merce. Le valute supportate includono tutte le valute COD più DKK, MAD e NOK (SEK non è supportato). DHL documenta un massimale di €100.000 per spedizione.

Tariffe in tempo reale

Puoi ottenere tariffe di spedizione indicative da DHL Freight, a condizione di aver configurato il tuo Username e Password eID. Senza queste credenziali, le Tariffe in tempo reale non saranno disponibili, ma spedizioni, etichette e tracciamento continueranno a funzionare normalmente.

Prenota/Programma ritiro

DHL Freight non ha un endpoint dedicato per la prenotazione del ritiro — invece, il ritiro viene richiesto come opzione "Time Slot Booking At Pickup" sulla spedizione stessa. Le finestre orarie fisse non possono essere specificate; si tratta di una semplice richiesta sì/no affinché il corriere organizzi il ritiro.

Delivery Terms (Payer Code)

Dovrai selezionare uno dei seguenti termini di consegna durante la configurazione del corriere:

• DAP (Delivered At Place)
• DDP (Delivered Duty Paid)
• EXW (Ex Works)
• CPT (Carriage Paid To)

Questo determina quale parte (mittente o destinatario) è associata al tuo account DHL Freight ai fini della fatturazione.

Opzioni corriere

DHL Freight offre un set completo di opzioni per singola spedizione:

Formati etichetta

DHL Freight supporta i seguenti formati di etichetta:

• PDF A4: 210×297mm verticale, due etichette per foglio
• PDF A6: 95×152mm, dimensione standard adesivo termico 4×6"
• ZPL: 203 DPI, stessa dimensione del PDF A6

Assicurati che la tua stampante di etichette sia compatibile con il formato selezionato.

4. Risoluzione dei problemi ed errori

Problemi comuni:

❓ Perché non riesco a registrarmi per DHL Freight tramite il portale sviluppatori DHL standard?

A: DHL Freight richiede un processo di onboarding specifico separato dalla registrazione generica MyDHL developer. Contatta il tuo rappresentante commerciale DHL Freight per il processo di registrazione corretto, poiché le credenziali del portale generico non attiveranno l'accesso a Freight.

❓ Perché il servizio che ho selezionato restituisce un errore?

A: Il tuo contratto DHL Freight determina quali prodotti freight puoi utilizzare. Se ricevi un errore che indica che non è stato trovato alcun prodotto valido, di solito significa che il tuo contratto non include quel servizio specifico — contatta il tuo referente commerciale DHL Freight per verificare i tuoi prodotti contrattualizzati.

❓ Perché le Tariffe in tempo reale non funzionano?

A: Le Tariffe in tempo reale richiedono un Username e Password eID validi, separati dal tuo Client ID/Secret API e rilasciati dal tuo referente commerciale DHL Freight specificamente per i prezzi. Senza questi, il calcolo tariffe è semplicemente non disponibile — spedizioni ed etichette continueranno a funzionare normalmente.

❓ Come posso programmare un ritiro?

A: Non esiste una funzionalità dedicata di prenotazione ritiro. Invece, attiva l'opzione corriere "Time Slot Booking At Pickup" sulla tua spedizione, che richiede a DHL di organizzare una fascia oraria di ritiro. Le finestre orarie fisse non possono essere specificate tramite questa opzione.

❓ Perché la mia autenticazione sta fallendo?

A: Verifica di aver inserito correttamente tutte le credenziali:

• Client ID
• Client Secret
• Account Number (nel formato corretto, es. 12345678.IT0001)

Se continui ad avere problemi, contatta il supporto DHL Freight per la verifica del tuo accesso API.

❓ Posso spedire verso paesi al di fuori dell'Europa?

A: No, la rete di trasporto stradale di DHL Freight copre solo destinazioni europee.

❓ Perché la mia opzione "Delivery After 12:00" è stata rifiutata?

A: Questa opzione è disponibile solo se specificamente abilitata sul tuo contratto DHL Freight. Per impostazione predefinita, viene rifiutata sui prodotti road-freight standard.