Come connettere DHL Connect a ShippyPro

Questa guida spiega il processo di integrazione di DHL Connect con ShippyPro. Segui i passi seguenti per stabilire la connessione e accedere alle funzionalità aggiuntive.

Sommario

Prima di iniziare
Configurazione Corriere
Opzioni aggiuntive
Errori & Risoluzioni

1. Prima di iniziare

Per collegare DHL Connect è necessario richiedere le seguenti credenziali per la connessione di ShippyPro al proprio referente DHL Connect:

Account Number
Return Account Number
Client ID
Client Secret
User Identification

2. Configurazione corriere

Una volta ricevuta la conferma da DHL, segui i seguenti passaggi per completare l'integrazione:

Vai nella sezione Corrieri in ShippyPro e clicca sul logo DHL Connect.
Inserisci i seguenti dati:
- Account Number
- Return Account Number
- Client ID
- Client Secret
- User Identification
- Bank Name (per le spedizioni in contrassegno)
- Bank Location
- Bank Account Holder
- IBAN
- BIC
- Direct Injection Country: Inserisci un codice paese a 2 cifre (es. ES, UK, DE).
- Direct Injection City
- Direct Injection Postcode
- Location ID (optional, per ParcelEurope.return.international)
- Label Type: scegli ZPL o PDF.
- Service: Scegli uno dei seguenti servizi:
  - Parcel Connect
  - Parcel Return Connect
  - Parcel Europe Parcel International
  - Parcel Europe Return International
- Sender Address: Aggiungilo nella sezione I miei indirizzi e specifica il tuo Paese d'origine. (optional).
- Origin Country: Inserisci un codice paese a 2 cifre (optional).
- Doorstep: Abilita questa opzione per home delivery.
- Display Reference Number: Aggiunge un codice a barre supplementare sull'etichetta (richiede la pre-autorizzazione di DHL).
  - Il codice a barre codifica il numero d'ordine importato dal tuo canale di vendita.
- Use Marketplace Order Number to Generate Tracking URL: Utilizza il numero d'ordine del marketplace come chiave per l'URL di tracciamento.
- Labelless Return (QR Code): Genera un codice QR che i clienti possono utilizzare per elaborare i loro resi, invece di un'etichetta di reso tradizionale.
- Print Return Label: Stampa un'etichetta di ritorno insieme all'etichetta della spedizione di andata.

📌 Importante per le spedizioni in contrassegno:
Se stai creando una spedizione in contrassegno, assicurati di fornire i seguenti dettagli:

Direct Injection Country: Inserisci un codice paese a 2 cifre (es. ES, UK, DE)
Direct Injection City
Direct Injection Postcode

Per le spedizioni di ritorno tramite API che utilizzano il servizio Connect Return, gli indirizzi del mittente e del destinatario si scambiano automaticamente. Inserisci l'indirizzo del mittente nel campo from_address e l'indirizzo del destinatario nel campo to_address come faresti per una spedizione in uscita. Il servizio gestirà l'inversione.

❗Per il servizio DHL Connect Return International, è disponibile esclusivamente l'emissione di etichette in formato PDF a causa di limitazioni tecniche imposte dal corriere.

3. Opzioni aggiuntive

Destinazioni

National: Germany
International: disponibile

Opzioni

Label PDF: disponibile
Label PDF (dimensions): -
Label ZPL: disponibile
Label EPL: NON disponibile
Track & Trace: NON disponibile
Paperless: NON disponibile
PickUp/DropOff (PUDO): disponibile
Cash On Delivery: NON disponibile
Live Rates: NON disponibile
Return Labels: disponibile
Return Labels (in the box): disponibile
Book/Schedule Pickup: NON disponibile
Address Check: disponibile
Proof of Delivery (POD): NON disponibile
Non-Delivery Options: NON disponibile
Insurance: NON disponibile
Multiparcel: NON disponibile
Delete Shipment (Void): NON disponibile
Closeout: NON disponibile
CN22: NON disponibile
CN23: NON disponibile
Credentials Validation: NON disponibile

Opzione corriere

Name	Slug	Type	Description
Send to point	dhlconnectpoint	checkbox	abilita il pudo point
Point	dhlconnectpointid	drop_off	point id del pudo selezionato
Keyword Id	dhlconnectkeywordid	text	identificativo alternativo per il punto di consegna. è reperibile a questo link

Label Design

PDF A6: disponibile per barcode e text
ZPL: disponibile per barcode e text

Per maggiori info clicca qui.

4. Errori & Risoluzioni

Unauthorized Request:

Se ricevi questo errore nel tentativo di creare una spedizione, contatta il tuo referente commerciale DHL per verificare la correttezza delle credenziali e lo stato del tuo account.
Country Configuration for [VALUE] is not available in CCC Database:

La configurazione del paese per [VALORE] non è disponibile nel database CCC.

In questo caso, il campo Direct Injection Country da Corrieri > DHL Connect non è stato configurato correttamente. Assicurati di fare clic su "Modifica" e di inserire un codice paese a 2 cifre, ES, UK, DE ecc.
Error 1: Error Path: /dataElement/cPAN/addresses/recipient/street1Nr; Error Message:
L'errore si presenta quando il campo "Indirizzo 1" non viene compilato in modo corretto.

Il numero civico deve essere posto nella parte finale dell'indirizzo.
Perché vedo lo stesso numero di tracciamento per spedizioni diverse?

I numeri di tracciamento di DHL Connect sono unici per 13 mesi, dopodiché vengono riutilizzati.
An error occurred while processing. Please reach out to DHL Support team.
Assicurati che il campo account number nella connessione DHL non contenga spazi vuoti.
Perché ho due codici di tracciamento DHL Connect identici?
Se trovi due ordini con lo stesso codice di tracciamento DHL Parcel, non preoccuparti! Chiedi al tuo Account Manager DHL Connect di estendere l’intervallo di tracciamento, così da generare codici diversi per ciascuna spedizione.