Connessione
      Torna alla home page
      1. ShippyPro Help Center
      2. Corrieri
      3. Connessione

      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

      1. Prima di iniziare
      2. Configurazione Corriere
      3. Opzioni aggiuntive
      4. 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:

      1. Vai nella sezione Corrieri in ShippyPro e clicca sul logo DHL Connect.
      2. 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.
        • 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

      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.