Come correggere gli errori di MyDHL

Per evitare che le etichette create con MyDHL vadano in errore ci sono alcuni piccoli accorgimenti da adottare.

Vediamo insieme come fare caso per caso! 

:domanda: Come controllare e risolvere un errore nella sezione "Errori"?

Se nella tua dashboard ShippyPro compare un errore, puoi verificarlo e correggerlo direttamente dalla sezione Errori.

Passaggi da seguire

  1. Vai su Ordini > Errori dalla tua dashboard ShippyPro.

  2. Cerca il messaggio di Tipo di errore per capire la causa.

  3. Clicca su Come risolvere? per visualizzare le istruzioni dettagliate.

  4. Usa l’icona della chiave inglese per modificare e correggere i dati della spedizione.

Suggerimento

Dopo aver corretto i dati, assicurati di aggiornare la pagina per verificare che l’errore sia stato risolto correttamente.

 

Perché ricevo l'errore 996: The requested product(s) not available for the requested pickup date. Process ID associated for this transaction ('1384428558') ?

Se il giorno successivo è un festivo, questo errore può comparire perché il sistema sceglie automaticamente il giorno seguente come data di ritiro.

Come risolvere:

  • Vai su Corrieri > myDHL > Modifica.

  • Modifica il valore Select the default amount of additional weekdays required to prepare the shipments in Same Day o in 2 o più giorni.

  • Applica la modifica a tutte le connessioni myDHL (non solo a quella utilizzata per la spedizione specifica).


Ho attivato l'opzione "On Demand Delivery" ma ricevo l'errore: "Element type “ODDLinkReq” must be declared"

Questo errore indica che l’opzione On Demand Delivery è stata abilitata, ma non può essere utilizzata a causa del tipo di contratto o della destinazione.

Come risolvere:

  • Vai su Corrieri > Modifica.

  • Disabilita l’opzione On Demand Delivery.

  • Riprova a elaborare la spedizione.


Non mi fa creare l'etichetta, vedo l'errore 152 : Dutiable segment Declared Amount Conditional Required Error.

Le vendite totali devono essere maggiori di zero oppure il servizio selezionato non è corretto per il Paese di destinazione.

Come risolvere:

  • Verifica il servizio selezionato: se hai impostato EXPRESS WORLDWIDE NONDOC, prova con EXPRESS WORLDWIDE EU o ECONOMY SELECT EU per spedizioni all’interno dell’UE.

  • Assicurati che l’importo dichiarato sia maggiore di zero.


Non riesco a generare l'etichetta con il corriere, ho questo errore Error returned from DHL webservice : SV012a : The system could not verify your shipping account number. Please correct this number and resubmit. For assistance call DHL customer services

Il sistema non riconosce il numero di account di spedizione inserito.

Come risolvere:

  • Contatta direttamente il servizio clienti DHL per verificare il tuo account.


Non riesco a scegliere il corriere: No rates found

Se ricevi questo errore, significa che il sistema non riesce a recuperare tariffe disponibili.

Come risolvere:

  • Verifica che le credenziali siano valide.

  • Rimuovi eventuali spazi nelle credenziali.

  • Seleziona Tutti i servizi sotto Service Type da Corrieri > Modifica.


Sto cercando di usare MyDHL ma non mi fa spedire: Error 400 during shipment creation step (in Excluded carriers section) o Undefined Error. Status Code: 400

L’errore è dovuto a un problema con le credenziali nell’ambiente di produzione.

Come risolvere:

  • Attiva la modalità di prova da Corrieri > MyDHL > Modifica.

  • Se in modalità test funziona, significa che le credenziali non sono abilitate in produzione.

  • Controlla nel tuo profilo sviluppatore DHL (MYDHL API > App Name) e abilita l’ambiente di produzione.


Non mi fa prenotare il ritiro, che devo fare? Error while booking the pickup: Order XY does not belong to configuration #CONFIGNUMBER.

L’errore si verifica quando gli ordini sono stati creati con una connessione MyDHL ma il ritiro è stato prenotato con un’altra connessione.

Come risolvere:

  • Seleziona la stessa connessione MyDHL usata per creare le etichette di spedizione.

  • Ripeti la prenotazione del ritiro.


Che significa l'errore: #/customerDetails/shipperDetails/addressLine1: expected maxLength: 45, actual: XX while creating the shipments ?

L’indirizzo mittente supera la lunghezza massima consentita (45 caratteri).

Come risolvere:

  • Vai su Il mio profilo > Info mittente.

  • Riduci la lunghezza della riga dell’indirizzo.

  • Ricorda che Address Line 1 combina i campi Indirizzo + Numero civico, quindi non deve superare i 45 caratteri (spazi inclusi).


Non riesco ad ausare MyDHL,  che devo fare? #/content/exportDeclaration/lineItems/0: required key [manufacturerCountry] not found

Il campo relativo al Paese di produzione non è stato compilato.

Come risolvere:

  • Riporta l’ordine nella sezione Da Spedire cliccando sulla freccia blu.

  • Compila il modulo CN22 prima di creare spedizioni internazionali.

  • Se spedisci tramite API, includi correttamente il tag CN22 nella richiesta Ship API.

    Cosa sono i moduli CN22 e CN23? Quando vanno utilizzati?

#/content/exportDeclaration/lineItems/[0]/manufacturerCountry value provided is invalid — cosa significa?

Il codice Paese ISO inserito non è valido.

Come risolvere:

  • Se utilizzi le API, inserisci il codice paese ISO corretto a 2 cifre (es. IT per Italia, FR per Francia).

410137: Product filtered out on delivery side because actual delivery time configured in TTS is greater than marketed delivery time configured in GREF, 1/- perché?

Stai cercando di utilizzare un servizio prioritario non disponibile per la destinazione.

Come risolvere:

  • Servizi come Express 9:00, Express 10:30, Express 12 non sono sempre supportati.

  • Rielabora la spedizione scegliendo un servizio Standard.


#/customerDetails/receiverDetails/postalAddress/addressLine3: expected maxLength: 45

Il campo Note Corriere (Carrier Notes) supera i 45 caratteri consentiti.

Come risolvere:

  • Riduci il testo inserito in questo campo.

  • Risalva e ripeti la spedizione.


Q: #/content: required key [declaredValue] not found" error on MyDHL orders with amounts over £1000. -cosa fare?

Il valore dichiarato della merce non è stato registrato correttamente.

Come risolvere:

  • Controlla il valore totale.

  • Usa solo virgola ( , ) o punto ( . ) per i decimali, mai per le migliaia.


8010: The Freight Payer Account is invalid — come risolvere?

Il numero di account del pagatore non è valido.

Come risolvere:

  • Se spedisci con Incoterm EXW, assicurati di aver inserito correttamente il codice cliente terzo al momento della creazione della spedizione.


998: [ISC.0082.9464] Value is shorter than minimum length ----/shipreq:ShipmentRequest/RequestedShipment/Ship/Shipper/Address/StreetLines2'' — cosa significa?

Il campo Address 2 contiene meno caratteri del minimo consentito.

Come risolvere:

  • Verifica che non siano presenti spazi vuoti.

  • Inserisci un numero di caratteri sufficiente per soddisfare i requisiti DHL.


[ISC.0082.9464] Value is shorter than minimum length ------------ /shipreq:ShipmentRequest/RequestedShipment/Ship/Recipient/Address/StreetLines3 — cosa fare?

Questo errore riguarda il campo Address Line 3 (Note Corriere).

Come risolvere:

  • Assicurati che non siano presenti spazi vuoti.

  • Verifica che il numero di caratteri non sia inferiore al minimo richiesto.


#/accounts/0: required key [number] not found, #/accounts/1: required key [number] not found — come correggerlo?

L’errore appare quando selezioni EXW come incoterm senza specificare il numero di account.

Come risolvere:

  • Inserisci sempre l’Account Number quando utilizzi l’incoterm EXW.

    image-Oct-26-2023-12-35-23-9236-PM.png

Requested product not available for pickup date: — cosa significa?

Errore dovuto a una data di ritiro non valida, spesso legata a un giorno festivo.

Come risolvere:

  • Vai su Corrieri > Connessione > myDHL > Modifica.

  • Modifica il valore Select the default amount of additional weekdays required to prepare the shipments in 2 o più giorni.

  • Applica la modifica a tutte le connessioni myDHL.


7008: The requested Special Service Code #/valueAddedServices/0/serviceCode ‘SA' is not available between this origin and destination. Please validate the products and services combination (via the /rates or /products service) or contact our customer service. — perché accade?

Il servizio Delivery Signature non è supportato per quella destinazione.

Come risolvere:

  • Verifica con DHL le destinazioni supportate.

  • Ricorda che:

    • SA = Delivery Signature

    • SF = Direct Signature (servizio diverso).


7008: The requested Special Service Code #/valueAddedServices/0/serviceCode ‘FD' is not available between this origin and destination. Please validate the products and services combination (via the /rates or /products service) or contact our customer service. — come correggerla?

Il servizio GoGreen non è supportato dal tuo contratto DHL.

Come risolvere:

  • Vai su Corrieri > Modifica > Servizi aggiuntivi e disabilita GoGreen.

  • Verifica con DHL quale versione del servizio è attiva sul tuo contratto:

    • FD = Go Green Plus Basic

    • FE = Go Green Plus Customized

    • FT = Go Green Plus Occasionale

 

7008: The requested Special Service Code #/valueAddedServices/0/serviceCode 'AA' is not available between this origin and destination. Please validate the products and services combination (via the /rates or /products service) or contact our customer service. — cosa significa?

Il servizio Saturday Delivery non è disponibile per la destinazione selezionata.

Come risolvere:

  • Scegli un altro servizio DHL.

  • Verifica con DHL le località che supportano la consegna al sabato.


7120: Required either #/outputImageProperties/imageOptions where typeCode=invoice or provide #/documentImages - che fare?

Il sistema richiede la fattura commerciale.

Come risolvere:

  • Vai su Carriers > Connections > Edit.

  • Spunta l’opzione Stampa fattura commerciale.

  • In alternativa, carica manualmente un file ETD (pdf, jpg o png).


100002: Null Validator: SHIPMENT_ID not found in request map., 100002: Null Validator: SHIPMENT_ID_CHECK_DIGIT not found in request map. 

Errore interno DHL che non consente l’assegnazione dei numeri AWB e JJD.

Come risolvere:

  • Di solito è un malfunzionamento temporaneo.

  • Se persiste, contatta il tuo referente DHL.


Q: #/customerReferences/0: required key [value] not found, #/outputImageProperties/customerBarcodes/0: required key [content] not found — perché accade?

L’ID ordine non è stato aggiunto.

Come risolvere:

  • Assicurati di inserire correttamente l’Order ID.

  • Questo campo è obbligatorio per il corriere.


1001: The requested product(s) (P) not available based on your search criteria (409224511) — quale formato usare?

La città di destinazione indicata non è valida (es. "cityName":"NA").

Come risolvere:


1001: The requested product(s) (W) not available based on your search criteria - che fare?

Il servizio selezionato non è disponibile per la spedizione.

Come risolvere:

  • Seleziona un altro servizio DHL.

  • Ripeti la spedizione con le nuove impostazioni.


410138: Requested product(s) not available at payer, H/- perch?

Il Product Code (servizio DHL) non è valido per l’account pagatore.

Come risolvere:

  • Contatta il tuo referente DHL per sapere quale servizio è collegato al tuo codice cliente.


Invalid Credentials // Credenziali non valide  — cosa significa?

Le credenziali di accesso non sono corrette.

Come risolvere:

  • Verifica username e password.

  • Controlla di non aver inserito spazi extra.

  • Puoi modificare le credenziali da Corrieri > Modifica.


Il valore è più corto della lunghezza minima — come correggerla?

Il numero di partita IVA del mittente o il numero IOSS del destinatario non è presente.

Come risolvere:

  • Vai su Il mio profilo.

  • Inserisci i dati fiscali mancanti (Partita IVA o IOSS).


8009: Shipper Billing Country must either be same as Billing Country of Shipment Origin or the Shipper Account must be an Impex Account - come risolvere?

Il Paese di fatturazione del mittente non corrisponde all’origine spedizione, oppure l’account non è un Impex Account.

Come risolvere:

  • Se stai facendo spedizioni di reso, imposta il Return Account Number nella connessione MyDHL.

  • Controlla che l’incoterm sia corretto.

  • Verifica che la connessione al corriere sia quella giusta.

  • Consulta anche la sezione 🔁 Stampa di etichette di reso.



Undefined Error. Status code: 400 - che signifca?

Le credenziali API non sono state attivate da DHL.

Come risolvere:

  • Accedi al portale sviluppatori DHL.

  • Controlla se le credenziali API sono state abilitate per l’ambiente di produzione.

  • Se non sono attive, contatta il tuo referente DHL.


7121: #/content/exportDeclaration is mandatory when provided product is dutiable, please update and try again. - perché ho questo errore?

L’esportazione richiede la dichiarazione doganale.

Come risolvere:

  • Vai su Corrieri > Connessione.

  • Seleziona l’opzione Paperless Trade.

  • Includi tutte le informazioni richieste nel modulo CN22 per le spedizioni internazionali.


#/content: required key [description] not found - che formato usare?

La descrizione del contenuto manca.

Come risolvere:

  • Vai su Il mio profilo > Preferenze.

  • Seleziona Numero ordine ShippyPro come descrizione contenuto.

  • Controlla che non ci siano spazi vuoti nella chiamata API.


Unable to send this shipment with the selected rate. Please try again or use a different rate. - perché accade?

Il sistema non può elaborare la spedizione con la tariffa scelta.

Come risolvere:

  • Riporta l’ordine in Da Spedire e riprocessalo.

  • Se usi le API con ALL SERVICES, recupera il CarrierService e il RateID tramite GetRates, e includili nella Ship API.

  • Selezionando invece un servizio specifico nella connessione, non serve includere il RateID.


Le mie tariffe DHL non vengono visualizzate nella schermata di checkout di Shopify, perché?

Questo accade spesso se l’indirizzo di ritorno è troppo lungo.

Come risolvere:

  • Assicurati che l’indirizzo di ritorno non superi i 45 caratteri.

  • Se necessario, dividi l’indirizzo su due campi.

  • Se il problema persiste, contatta l’assistenza.


Error 420505: The destination location is invalid. Please check - — come correggerlo?

La destinazione non è servita da DHL.

Come risolvere:


8007: Failed to retrieve Shipper Account details - come mai?

L’account del mittente non viene riconosciuto.

Come risolvere:

  • Controlla che l’Account Number inserito in Corrieri sia corretto.

  • Assicurati che non contenga spazi vuoti.


998: The account number is not found or invalid. Please check the account number and retry - che formato usare?

Il numero di account inserito non è valido.

Come risolvere:

  • Verifica che l’Account Number in Corrieri sia corretto e senza spazi.

  • Se l’errore continua, contatta il tuo referente DHL per confermare lo stato dell’account.


7008: The requested Special Service Code #/valueAddedServices/0/serviceCode ‘WY’ is not available between this origin and destination. (oppure The rate you selected does not support Paperless Trade or The rate you selected does not support ETD uploads) - perché accade?

L’opzione Paperless Trade (PLT) non è supportata per questa spedizione.

Possibili cause e soluzioni:

  • Hai selezionato Paperless per una spedizione non tassabile (es. nazionale o intra-UE) → rimuovi l’opzione.

  • L’opzione Paperless non è disponibile per quella destinazione extra-UE. In questo caso:

    • Rimuovi l’opzione Paperless.

    • Rimuovi eventuali ETD caricati in Gestione Fatture.

    • Se vuoi stampare la fattura, attiva Generate Invoice with DHL format nella connessione del corriere.

    • In alternativa, invia direttamente la tua fattura a DHL.


Perché il campo "Contact" è vuoto nell'etichetta di MyDHL?

Il campo “Contact” non viene popolato per motivi di privacy (GDPR).

Dettagli:

  • Il telefono/email sono comunque trasmessi ai corrieri nei dati digitali.

  • Il campo appare solo per i Paesi in cui non è richiesto l’adeguamento al GDPR.



8018: This Operational Country of Shipment Destination can't have Duty and Tax billed outside its Billing Country - come mai succede?

L’incoterm selezionato non è compatibile con la destinazione.

Come risolvere:

  • Verifica l’Incoterm scelto.

  • Assicurati che sia supportato dal corriere per quella specifica destinazione.


410301: Products not available between this origin and destination (network segment) - perché mi compare?

Il servizio selezionato non è disponibile per la combinazione origine/destinazione.

Come risolvere:

  • Controlla se il servizio scelto è compatibile con:

    • origine/destinazione

    • peso

    • dimensioni colli

    • servizi aggiuntivi selezionati

  • Se non lo è, rielabora la spedizione scegliendo un servizio alternativo.


7008: The requested Special Service Code #/valueAddedServices/0/serviceCode 'PT' is not available between this origin and destination. - che cosa fare?

L’opzione Extend label validity duration (Data Staging) causa l’errore.

Come risolvere:

  • Vai su Corrieri > MyDHL > Modifica.

  • Disattiva l’opzione Extend label validity duration.

  • Rielabora le etichette.


ErrorMessage: "#/content/exportDeclaration/lineItems/0: required key [price] not found, #/content: required key [declaredValue] not found - cosa significa?

Il valore merce è impostato a 0, il che non è consentito per spedizioni di beni.

Come risolvere:

  • Aggiungi il campo CustomInfoContentsType nella chiamata API Ship.

  • Questo campo serve a dichiarare la tipologia di prodotto alla dogana.

  • Consulta la documentazione API per maggiori dettagli.


7008: The requested Special Service Code #/valueAddedServices/0/serviceCode 'KB' is not available between this origin and destination.  — cosa significa?

Il servizio Contrassegno non è supportato per la destinazione o per il servizio selezionato.

Come risolvere:

  • Contatta il tuo referente DHL per verificare restrizioni e alternative disponibili.


7008: The requested Special Service Code #/valueAddedServices/0/serviceCode 'DD' is not available between this origin and destination. — come correggerlo?

Il servizio Duties & Taxes Paid (DDP) non è consentito per la spedizione.

Come risolvere:

  • Contatta il tuo referente DHL per verificare eventuali restrizioni sul servizio.


8035 Product code provided not matching the account's network type code. Please update and try again — cosa significa?

Il servizio selezionato non corrisponde ai servizi contrattualizzati.

Come risolvere:

  • Contatta il tuo referente DHL per sapere quali servizi sono inclusi nel contratto.

  • Usa solo i servizi autorizzati per il tuo account.


413 Request Entity Too Large - come risolvere?

Il file ETD caricato è troppo grande oppure c’è stato un blocco temporaneo del server.

Come risolvere:

  • Attendi qualche minuto e riprova.

  • Controlla che il file ETD non superi i limiti consentiti.


Error: 1001: The requested product(s) (Q) not available based on your search criteria. (673f5a5b2c8e3c21a3850907cc7fc174) — come correggerla?

Errore legato al contenuto dichiarato tramite API.

Come risolvere:

  • Se usi le API, rimuovi il campo "CustomInfoContentsType": "documents" dalla chiamata Ship



7024: The Paperless Trade (PLT) image file size of the export documentation is too large. Please ensure that this does not exceed '5MB' and is either a pdf, jpg or png file type. - perché accade?

Il file ETD caricato supera la dimensione massima di 5 MB consentita da DHL.

Come risolvere:

  • Rimuovi i file dalla sezione Gestione fatture.

  • Comprimi i documenti per ridurne la dimensione.

  • Ripeti la procedura di spedizione dall’inizio.


1001: The requested product(s) (D) not available based on your search criteria. - cosa significa?

Il servizio DOC non è disponibile per la destinazione selezionata.

Come risolvere:

  • Contatta DHL per verificare i dettagli del tuo contratto e le opzioni disponibili.


1001: The requested product(s) (H) not available based on your search criteria.  — cosa fare?

Il servizio ECONOMY SELECT NONDOC (ESI) non è valido per questa spedizione.

Come risolvere:

  • Prova a utilizzare un altro servizio, ad esempio ECONOMY SELECT EU (ESU) se la spedizione è all’interno dell’UE.

  • In alternativa, chiedi a DHL quale sia il servizio più appropriato.


#/content/description: string [ x1] does not match pattern ^[^\s]" - come correggerlo?

Il formato scelto per la descrizione non è corretto.

Come risolvere:

  • Vai su Il mio Profilo > Preferenze.

  • Controlla se è selezionata l’opzione “SKU e Quantità” o “Descrizione ordine” per il campo Descrizione contenuto.

  • Se l’ordine non possiede uno SKU, modifica questa impostazione.

  • Dopo aver completato la spedizione, puoi ripristinare la configurazione originale.

    image-Jan-15-2025-01-10-19-6398-PM

7125: Domestic shipment for Mexico is not allowed for your username. Please contact your DHL sales representative. — perché accade?

Non sei abilitato a spedire all’interno del Messico con il tuo account.

Come risolvere:

  • Contatta il tuo referente commerciale DHL per verificare le abilitazioni del tuo account.


#/customerDetails/shipperDetails/contactInformation/phone: string [ ] does not match pattern .\S+. ** - che fare?

Il campo “telefono” del mittente o del destinatario risulta vuoto.

Come risolvere:

  • Inserisci sempre un numero di telefono valido.

  • Includi almeno il prefisso internazionale, ad esempio “+39”.


MYDHL 1001: The requested product(s) (N) not available based on your search criteria. - che significa?

Il servizio selezionato non è disponibile per il tipo di spedizione.

Come risolvere:

  • Assicurati di non aver scelto un servizio domestico per una spedizione internazionale.


#/documentImages/0: required key [content] not found - perché succede?

Manca il contenuto nel documento ETD caricato.

Come risolvere:

  • Controlla i documenti ETD associati alla spedizione.

  • Elimina i file e ricaricali.

  • Ripeti la procedura di spedizione.


Origin country is not allowed - che significa?

Il Paese di origine non è autorizzato per la spedizione.

Come risolvere:

  • Contatta DHL per verificare se sei abilitato a spedire dal Paese indicato.


#/content/description: string [ ] does not match pattern ^[^\s] - perché accade?

La descrizione dell’oggetto non deve iniziare con uno spazio vuoto.

Come risolvere:

  • Rimuovi eventuali spazi prima della prima lettera della descrizione.


MyDHL: To check: 7116: Duplicate values found in #/customerDetails/receiverDetails/registrationNumbers/typeCode — come correggerla?

Sono stati rilevati valori duplicati nei dati di registrazione (IVA/EORI).

Come risolvere:

  • Vai su Il mio Profilo e verifica di aver già inserito partita IVA ed EORI.

  • Evita di reinserire gli stessi dati tramite l’Opzione Corriere, per non duplicarli.


7008: The requested Special Service Code #/valueAddedServices/0/serviceCode 'II' is not available between this origin and destination. Please validate the products and services combination (via the /rates or /products service) or contact our customer service. - che cosa fare?

Il servizio di assicurazione selezionato non è disponibile per la combinazione origine/destinazione scelta.

Come risolvere:

  • Rimuovi l’assicurazione.

  • Rielabora la spedizione senza il servizio non supportato.

 

Errore durante la prenotazione del ritiro: 202115: Ready time cannot be greater than close time 

Come risolvere:
L'orario di preparazione inserito è successivo all'orario di chiusura, il che non è valido.

➡️ Modifica gli orari di ritiro in modo che l'orario di preparazione sia precedente all'orario di chiusura.

5006: Pickup is not allowed

Come risolvere:
Ciò indica un tentativo di ritiro non andato a buon fine a causa di un articolo proibito, documenti incompleti o un altro problema che impedisce al corriere di accettare il pacco.

➡️ Contatta il servizio clienti DHL per confermare il motivo della restrizione e risolverlo.

 

Perché non riesco a spedire i miei ordini extra UE con MyDHL.?

Come risolvere:
Questo errore indica che la spedizione non può essere completata perché la documentazione doganale non è stata associata correttamente in modalità digitale (Paperless). MyDHL richiede infatti che i documenti vengano trasmessi elettronicamente per inviarli in automatico alla dogana del paese di destinazione.

➡️ Controlla che tutti i documenti doganali siano caricati correttamente in formato digitale su MyDHL e riprova a creare la spedizione.