Come risolvere gli errori per le spedizioni con BRT

Hai riscontrato alcuni errori in fase di generazione delle spedizioni con BRT?

Continua a leggere per scoprire come risolverne alcuni dei più comuni!

❓ Cosa significa “Login fallito”?

Le credenziali BRT che hai inserito nella sezione Corrieri di Shippypro sono errate, scadute o non ancora attive.
Contatta il tuo referente BRT per richiederle o chiedi a Shippypro l’attivazione seguendo le istruzioni.


❓ Perché vedo l’errore:

BRT https://api.brt.it/rest/v1/shipments/shipment resulted in a 500 Internal Server Error?

Può trattarsi di:

  • Credenziali BRT non valide: aggiorna i dati da Corrieri > BRT > Modifica.

  • Un problema temporaneo lato server del corriere.

Puoi rimettere in lavorazione gli ordini da Ordini Spediti > Azioni > Rimetti ordini in lavorazione in bulk.


❓ Perché compare l’errore: “Errore in calcolo instradamento Unable to calculate exact routing”?

Il Network selezionato nel profilo BRT API non corrisponde a quello della destinazione.
Verifica in Corrieri > Modifica e controlla la corrispondenza tra CAP e indirizzo.


❓ Cosa significa l’errore: “Unable to ship to chosen Network/destination”?

Può accadere perché:

  • La destinazione non è supportata dal Network selezionato. È anche possibile che, da sistemi BRT, il CAP specifico non sia censito dal Network indicato: verifica in questo caso con BRT il CAP più vicino selezionabile.

  • La città e il CAP non corrispondono.

  • La destinazione è temporaneamente non raggiungibile (es. eventi atmosferici), in questo caso verifica con la filiale di riferimento.

  • Stai spedendo alle Isole Canarie senza avere attivo il servizio DPD - Out of Europe.

  • L’indirizzo non è raggiungibile: prova un Punto di Ritiro.


❓ Perché ricevo: “Errore in calcolo instradamento The network is not available for the chosen weight/volume/number of parcels”?

  • Il Network scelto non supporta peso, volume o numero colli indicati.
    Verifica i dati con il tuo referente BRT.
    Nota: con DPD è possibile solo spedizioni monocollo, questo significa che in caso di un DDT da 3 colli sarà necessario creare 3 spedizioni da un collo: Come creare una Spedizione Manuale

❓ Cosa significa “Errore in calcolo instradamento Wrong ZIP code”?

Indica che il CAP non è valido. Alcuni esempi:

  • Irlanda: inserisci Eire nel campo CAP.

  • Portogallo: il formato corretto è XXXXXXX.

  • Slovacchia: rimuovi eventuali spazi.

  • Malta: niente spazi interni.

  • Puoi controllare la validità del CAP da questo link: https://www.brt.it/it/online-shipping/parcel


❓ Perché vedo “Errore in calcolo instradamentoNonexistent district”?

La sigla della Provincia inserita non è corretta. Controlla di averla scritta correttamente.


❓ Cosa indica “WRONG OR INCONSISTENT DATA pricingConditionCode campo”? 

Il campo Codice Tariffa non è stato valorizzato o non è supportato dal tipo di spedizione/Network scelto.


❓ Perché ricevo: “High-order nibble of the byte at array offset 248 is not valid. Byte value: 00”?

È un errore generico del corriere. Riprova ad aggiornare gli ordini da Ordini Spediti > Azioni > Rimetti ordini in lavorazione in bulk.


❓ Cosa significa: “La spedizione non è stata mai creata oppure creata oltre 40 giorni primaShipment is not found with used references”?

Vuol dire che il Riferimento Ordine è stato modificato dopo la trasmissione. Devi riportare l’ordine in Da Spedire o crearne uno nuovo.


❓ Perché compare: cURL error 56: OpenSSL SSL_read: Connection reset by peer, error 104 (see https://curl.haxx.se/libcurl/c/libcurl-errors.html) for https://api.brt.it/rest/v1/shipments/shipment?

Si tratta di un errore temporaneo lato corriere. Riprova dopo qualche minuto rimettendo l’ordine in lavorazione.


❓ Cosa vuol dire “La spedizione in elaborazione, ritentare  Shipment is still in processing, retry”?

È un rallentamento temporaneo di BRT.
Clicca su Correggi Ordine e ristampa l’etichetta.


❓ Perché ottengo: “BRT error: "Unable to raise new parcel number”?

Il range di numerazione è esaurito lato BRT. Contatta il tuo referente per farne aggiungere uno nuovo.


❓ Cosa significa “Malformed UTF-8 characters, possibly incorrectly encoded”?

Ci sono caratteri speciali o accenti nell’ordine.
Apri Correggi Ordine, rimuovi gli accenti, salva e rimetti l’ordine in lavorazione.


❓ Perché compare: “BRT doesn't support selected COD Type”?

BRT accetta solo valori COD Type:

  • 0 = Contanti

  • 1 = Assegno circolare

  • 2 = Assegno

Il valore 3 non è supportato.


❓ Cosa significa: “WRONG OR INCONSISTENT DATA DeliveryFreightTypeCode must be DAP or EXW”?

BRT non accetta DDP come Incoterm. Sono validi solo DAP o EXW.


❓ Perché ricevo: “Errore in calcolo instradamento DEPOT not served”?

La destinazione non è raggiungibile per cause maggiori (scioperi, maltempo, ecc.). Contatta la filiale BRT.


❓ Cosa significa: “The place is nonexistent at this ZIP code” o “Nonexistent ZIP code”?

  • Il CAP o la città sono errati.
  • Assicurati che nel campo “Città” non ci siano frazioni o quartieri, ma solo il comune.
  • Rimuovi eventuali accenti.
  • Puoi verificare i CAP su: https://www.brt.it/it/online-shipping/parcel

❓ Perché vedo: “Errore in stampa etichetta Err retrieve file 2”?

È un errore server temporaneo. Riconferma l’ordine e dovrebbe risolversi.


❓ Perché compare: “Cannot book pickup: a branch mail address was not set”?

La mail della tua filiale BRT non è stata inserita nella connessione corriere. Aggiungila in Corrieri > BRT > Modifica.


❓ Cosa significa “Errore in calcolo instradamento Wrong (o Nonexistent) ZIP code”?

  • Per spedizioni verso l’Irlanda, inserisci EIRE nel campo CAP, mentre il vero codice postale va nel campo Indirizzo 2.

  • Per spedizioni verso Monaco, seleziona come Nazione Monaco (non Francia).


❓ Cosa significa: “Length of data corresponding to field 'notes' in client request is not valid”?

Il campo notes (corrispondente a Carrier Notes) ha un limite massimo di 70 caratteri per BRT.
Accorcia il testo delle note per poter generare la spedizione.


❓ Cosa significa: “The max number of parcels allowed is 30”?

Ogni spedizione può avere al massimo 30 pacchi.
Se superi questo limite, dividi la spedizione in più invii.


❓ Perché ricevo:

ERROR [shipments][Create]: Length of data corresponding to field 'consigneeContactName' in client request is not valid?

Il nome del destinatario supera la lunghezza consentita. Accorcialo per generare l’etichetta.


❓ Perché compare: “La spedizione è già presa in gestione dalla filiale - Shipment has been processed”?

L’ordine è già stato trasmesso a BRT. Non puoi modificarlo, ma puoi archiviare l’errore o creare una nuova spedizione.


❓ Cosa significa:

Response data corresponding to field 'departureDepot' is not valid. The field may not be initialized?

Ci sono rallentamenti lato server BRT. Riprova a correggere la spedizione più tardi.


❓ Perché vedo: “The order have a cash on delivery value but this carrier doesn't support this option”?

Devi abilitare i contrassegni in Corrieri > Modifica prezzi > Questo corriere supporta i contrassegni.


❓Cosa significa "Errore in calcolo instradamento the network is not available for the chosen country."? 

Controlla la connessione BRT scelta per la spedizione e assicurati che il servizio/network selezionato sia corretto per il tipo di destinazione.

 


❓Cosa significa "WRONG OR INCONSISTENT DATA Direct Infeed DPD not allowed for SenderCustomerCode"?

Se ricevi questo errore applicando il formato ZPL DP5 nella vostra connessione DPD, è possibile che questa opzione non sia presente nel vostro contratto BRT. Verificate pertanto insieme al vostro referente BRT se il servizio è attivo. Ricordate che questa opzione è valida solo per il formato di stampa ZPL.

 


❓ Cosa significa: "Errore in calcolo instradamento The district does not match the ZIP code"?

Lo Stato/Provincia è errato. Verifica che la provincia inserita sia corretta oppure lascia il campo vuoto.


❓ Cosa significa: “The shipment is a triangulation but this carrier doesn't support this option”?

Attiva l’opzione Questo corriere supporta le triangolazioni in Corrieri > Modifica prezzi.


❓ Perché ricevo tracking a 18 cifre e non a 12?

BRT ci invia prima un codice di tracciamento di 18 cifre e poi verso sera ci invia il codice aggiornato a 12 cifre.

I marketplace "ManoMano", "Privalia" ed "eDock" supportano un solo aggiornamento (una sola trasmissione del codice di tracking).
Per questi marketplace, dovrai:

  • disattivare l’aggiornamento automatico da Marketplace > Modifica

  • non inviare manualmente un nuovo aggiornamento dopo questa azione

I marketplace Amazonv2, eBay, Etsyv3, Magento, Odoo, Prestashop, Shopify, Storeden, WooCommerce, GrouponGoods, BindCommerce, OsCommerce, OpenCart, RealDe, KauflandDe, Spartoo, ShipEdge, PriceMinister, WiziShop, Lengow, Bricoprive, ShowroomPrivee, Onbuy, Bigcommerce, Bolv2, Holded, Katana, Leclerc, Sprinter, ConradElectronic, TrendyFoods, MediaMarktSaturn, RueDuCommercev2, Pixmaniav2, LeroyMerlin, Decathlon, Yoox, ElCorteInglesv2, Refurbedv2, MaisonsDuMonde, But, Kaufland, Octopia supportano più aggiornamenti.
Per questi Marketplace dovrai:

  •  Attivare l’aggiornamento automatico verso il marketplace, invieremo un primo tracking quando le spedizioni vengono create, e poi l’aggiornamento automatico con il nuovo tracking di 12 cifre in serata.

Per Amazon l’aggiornamento avviene immediatamente con il codice da 15 cifre.


Se vuoi ricevere solo il secondo tracking da 12 cifre, puoi contattare il nostro Team di Supporto e provvederemo ad attivare la funzionalità.

 


❓Come faccio a trasmettere al Marketplace solo il codice da 15 cifre di BRT e non da 18?

Se utilizzi uno dei seguenti Marketplace: Shopify, Prestashop, Newcart, Backmarket, ePrice, cDiscountv1 puoi contattare il nostro Team di Supporto e provvederemo ad attivare la funzionalità.

Per tutti gli altri Marketplace suggeriamo di rimuovere l’update automatico del marketplace da Marketplace > Modifica

image-20241029-082508

E inserire un Cron Job per l'aggiornamento dello store la sera dopo le 22:00 da Strumenti > Task Scheduler così da trasmettere direttamente il tracking definitivo.


❓ Cosa significa: “WRONG OR INCONSISTENT DATA actualSender”?

Accade con spedizioni di reso.
Verifica che l’indirizzo mittente sia corretto e riconosciuto su Google Maps e che il CAP sia valido.

 

❓Cosa significa se spedendo verso San Marino riscontro l'errore "The place is nonexistent at this ZIP code"

Segui questi passaggi:

  • Seleziona "Italia" come paese invece di "San Marino";

  • Lascia il campo "Stato/Provincia" vuoto;

  • Utilizza il network/servizio di BRT per le spedizioni domestiche/nazionali


❓ Perché vedo: ERROR [shipments][Create]: Invocation of program failed.
MCH3402: Si è tentato di fare riferimento ad un oggetto, o ad una parte di un oggetto, che non esiste più ?

Si tratta di errori server temporanei del corriere. Riprova dopo qualche minuto.

 


❓ Cosa significa "Unexpected response type. Expected string or ResponseInterface, NULL given" ?

Si tratta di un momentano errore server del corriere, attendi qualche minuto e riprova a rielaborare le spedizioni


❓ Cosa significa: “WRONG OR INCONSISTENT DATA Invalid Return Depot”?

Il Deposito di Reso inserito nella connessione non è valido. Controlla e correggi.


❓ Perché compare: “Failed to parse time string (…) at position (…): Unexpected character”?

 Questo errore indica che il formato della data inserita non è valido e contiene un carattere non previsto.

Soluzione consigliata:
Verifica che il campo contenente la data rispetti un formato corretto, ad esempio:

  • GG-MM-AAAA oppure AAAA-MM-GG

  • Evita di inserire numeri troppo brevi o senza separatori (es. 250626 non è valido)

  • Utilizza solo numeri e separatori standard come / o -

Dopo aver corretto il formato, prova nuovamente a rielaborare l’ordine.


❓ Perché vedo: ERROR [shipments][Create]: Length of data corresponding to field 'actualSenderAddress' in client request is not valid.

L’indirizzo del mittente supera i 30 caratteri (somma di Indirizzo1 + Indirizzo2). Accorcialo.


❓Voglio cambiare la mia Ragione Sociale in etichetta ma, anche modificando i dati dell’ordine, la Ragione Sociale non cambia, come faccio?

Tieni presente che BRT recupera le informazioni del mittente in automatico dal proprio portale. Se hai bisogno di modificare le informazioni relative ai tuoi dati, ti consigliamo di entrare in contatto con il tuo referente commerciale BRT.



Cosa devo fare in caso di Mancata trasmissione Fine Giornata?

 

Se il corriere non riceve correttamente le chiusure degli ordini / fine giornata:

Verifica con il tuo referente BRT che il tipo di trasmissione configurata sia la stessa indicata in Corrieri > BRT > Modifica su ShippyPro.

Se il tipo di trasmissione concordato con BRT è Automatico, controlla con il tuo referente se la trasmissione dati è stata disabilitata lato loro per qualche motivo.


❓ Posso creare spedizioni multicollo con BRT EU (DPD)?

No, le spedizioni tramite DPD (BRT EU) possono essere solo monocollo.
Se hai ordini con più pacchi, devi creare più spedizioni o chiamate API distinte.
Con Euroexpress, invece, sono disponibili spedizioni multicollo fino a un massimo di 5 pacchi.


❓ Cosa succede alle spedizioni trasmesse ma non affidate?

Le spedizioni inviate a BRT ma non ancora affidate restano in memoria per un massimo di 7 giorni solari (incluso quello di creazione).
Dopo questo periodo vengono cancellate dai sistemi BRT.
Se il pacco è ancora presso il mittente, dovrai creare una nuova label.


❓ Perché non riesco a creare spedizioni la domenica mattina?

⚠️ Dalle 02:00 alle 06:30 della domenica, BRT può eseguire manutenzione sui server.
In quelle ore non è garantita la possibilità di creare spedizioni.
Per chiarimenti puoi contattare il tuo referente commerciale BRT.


❓ Cosa succede se valorizzo il campo “Ragione Sociale”?

Se inserisci una Ragione Sociale, questa sovrascriverà il campo Nome.
Il nome del destinatario viene comunque inviato al corriere, ma non sarà visibile sull’etichetta.


 

❓ BRT controlla tutti i campi dell’indirizzo?

No.
BRT non effettua controlli sui campi Indirizzo 1 e Indirizzo 2: qualunque testo venga inserito verrà trasmesso così com’è.
I controlli vengono fatti solo su: Città, CAP e Provincia.


❓ Perché ricevo una mail che mi chiede di fare il fine giornata anche se l’ho già fatto?

Potresti avere più profili ShippyPro collegati allo stesso account BRT.
In questo caso:

  • Controlla il tipo di conferma impostata (automatica o manuale) nei vari moduli di connessione.

  • Se anche solo un profilo ha spedizioni da trasmettere manualmente, l’email di notifica arriva a tutti gli account collegati.

Consigliamo di contattare il tuo referente BRT e verificare il metodo di chiusura spedizioni per tutti i profili.


❓ Posso usare API se utilizzo i servizi BRT diskB via FTP con Amazon?

No.
Se usi BRT diskB via FTP tramite il portale Amazon, non puoi utilizzare le API.
In questo caso, il corriere non riceverà i dati di spedizione tramite ShippyPro.