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!

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 richiedergliele o richiedi l'attivazione a Shippypro se non l'hai ancora fatto, seguendo queste istruzioni.

 

Error 500

Ti è capitato di riscontrare l'errore seguente?

 

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

 

Niente panico! 🙌

 

In caso di Error 500 per le proprie spedizioni BRT si potrebbe trattare di:

 

  • Credenziali BRT non valide - se nel frattempo hai cambiato le tue credenziali BRT, assicurati di aggiornarle anche dalla sezione Corrieri > BRT > Modifica per poter generare correttamente le etichette di spedizione

  • un problema temporaneo sul server del Corriere

In questo caso, puoi correggere i tuoi ordini contemporaneamente da Ordini Spediti > Tasto Azioni > Rimetti ordini in lavorazione in bulk > Seleziona le date di tuo interesse

 

Così facendo tutti gli ordini per le date inserite verranno riprocessati con lo stesso corriere e l'errore dovrebbe essere corretto automaticamente.

 

 

Errore in calcolo instradamento Unable to calculate exact routing

Questo errore si presenta quando il Network selezionato nel profilo BRT API non è quello dell’indirizzo di destinazione.
Verifica pertanto da Corrieri > Modifica se è selezionato un Network in linea con la destinazione.

Se il Network è corretto verifica la giusta corrispondenza tra CAP e indirizzo inseriti.

 

 

Errore in calcolo instradamento Unable to ship to chosen Network/destination

Verifica che la destinazione sia supportata dal Network selezionato e che ci sia corrispondenza tra la città e il cap inserito. E' 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.

L'errore può anche indicare che la destinazione potrebbe essere temporaneamente non raggiungibile per qualche motivo di causa maggiore (es. eventi atmosferici), in questo caso verifica con la filiale di riferimento.

 

Errore in calcolo instradamento The network is not available for the chosen weight/volume/number of parcels

L'errore indica che il network utilizzato non consente il peso / volume / numero colli dichiarato. Consigliamo di modificare questi dati ed eventualmente verificare le specifiche con il referente BRT.

Se utilizzi DPD network, si prega di notare che il Network DPD prevede 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

 

Errore in calcolo instradamento Wrong ZIP code

Questo errore indica che il formato del cap inserito è errato.


Se stai cercando di spedire in Irlanda, inserisci la parola Eire nel campo CAP/zip code del destinatario.

Se stai cercando di spedire in Portogallo, il formato corretto del codice postale per BRT è: XXXXXXX.


​Se stai spedendo in Slovacchia, verifica che non ci sia lo spazio tra le cifre del codice postale.

Errore in calcolo instradamento Nonexistent district

Se ottieni questo errore verifica di aver inserito la sigla corretta per la Provincia nel campo corrispondente.

 


WRONG OR INCONSISTENT DATA pricingConditionCode campo

In questo caso il campo Codice Tariffa da Corrieri > Modifica non è stato valorizzato oppure lato BRT il Codice Tariffa non supporta il tipo di spedizione o Network selezionato.

 

 

High-order nibble of the byte at array offset 248 is not valid. Byte value: 00

In questo caso si tratta di un errore generico restituito dal Corriere, puoi provare ad aggiornare gli ordini entro qualche minuto da Ordini Spediti > Tasto Azioni > Rimetti ordini in lavorazione in bulk > Seleziona le date di tuo interesse:

 

La spedizione non è stata mai creata oppure creata oltre 40 giorni prima Shipment is not found with used references

Questo errore indica che il Riferimento Ordine è stato modificato dopo la trasmissione dell'ordine, non essendo supportata questa possibilità è quindi necessario riportare l'ordine in Da Spedire o creare nuovamente la spedizione.

 

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

In questo caso si tratta di un errore temporaneo restituito dal Corriere, puoi provare ad aggiornare gli ordini entro qualche minuto da Ordini Spediti > Tasto Azioni > Rimetti ordini in lavorazione in bulk > Seleziona le date di tuo interesse.

 

La spedizione in elaborazione, ritentare Shipment is still in processing, retry

Questo tipo di errore si deve ad un rallentamento temporaneo lato BRT

E' possibile risolvere esclusivamente cliccando su Correggi Ordine, sarà poi necessario ristampare l'etichetta.

 

BRT error: "Unable to raise new parcel number"

Significa che il range lato BRT è esaurito, in questo caso contatta il tuo referente per aggiungere nuovo range.

 

Malformed UTF-8 characters, possibly incorrectly encoded

Ci potrebbero essere caratteri speciali o accenti nel modulo di spedizione. Clicca su "correggi ordine", controlla tutti i campi ed elimina i caratteri accentati. Salva le modifiche e rimetti l'ordine in elaborazione, l'etichetta verrà quindi stampata.

BRT doesn't support selected COD Type

In caso riscontrassi questo errore tieni a mente che BRT accetta COD Type con valore 0, 1, oppure 2 non 3.
0 = Contanti (impostazione predefinita), 1 = Assegno circolare, 2 = Assegno, 3 = Tutti i metodi di pagamento.

 

WRONG OR INCONSISTENT DATA DeliveryFreightTypeCode must be DAP or EXW

Quest'errore è dovuto al fatto che BRT non accetta DDP come Incoterm. Vengono accettati solamente DAP (Porto Franco) oppure EXW (Porto Assegnato).

 

Errore in calcolo instradamento DEPOT not served

BRT non è in grado di raggiungere quella destinazione per qualche motivo di causa maggiore (scioperi, eventi atmosferici avversi, ecc.). Ti consigliamo di contattare direttamente la tua filiale di riferimento per maggiori informazioni.

 

The place is nonexistent at this ZIP code / Errore in calcolo instradamento Nonexistent ZIP code

Questo errore si riferisce al cap o alla località errata. Attenzione che nel campo "città" non sia inserita una frazione o un quartiere, poichè BRT riconosce solo il comune di riferimento.
​💡 Trick: inserisci le prime cifre del cap nell'ordine e ti apparirà la lista delle città associate:

 

 

Errore in stampa etichetta Err retrieve file 2

L'errore è legato ad un problema di server lato corriere. Solitamente si risolve velocemente e in automatico, riconfermando l'ordine.

 

Cannot book pickup: a branch mail address was not set

Se riscontri questo errore in fase di prenotazione ritiro, controlla la connessione corriere da Connessioni>Corrieri>BRT>Modifica e verifica che la mail della tua filiale BRT sia stata correttamente inserita nell’apposito campo, in questo modo potremo inviare loro la richiesta di ritiro:

 

Errore in calcolo instradamento Wrong (o Nonexistent) ZIP code:

  • per spedizioni verso l'Irlanda, ricordati di aggiungere nel campo Zip Code il valore EIRE, potrai inserire il vero Zip Code nel campo Indirizzo 2.

  • per spedizioni verso Monaco, assicurati di aver inserito Monaco (e non Francia) come Nazione di destinazione.

 

  • Ricorda, le spedizioni tramite DPD (BRT EU) possono essere esclusivamente monocollo.

    Sarà pertanto necessario, in caso di ordini con pacchi multipli, creare più spedizioni o chiamate API.

    Per Euroexpress sono invece disponibili le chiamate Multicollo sino ad un massimo di 5 pacchi.

     

  • Lato BRT, le spedizioni trasmesse ma non affidate rimarranno in memoria per un periodo massimo di 7gg solari, compreso il giorno di creazione.

    Dopodiché il Corriere le cancellerà dai loro sistemi, quindi in caso di pacco ancora presso Mittente sarà necessario creare una nuova label.

    ⚠️ Dalle 02:00 alle 06:30 della domenica è possibile che il Corriere effettui manutenzione sui propri server, quindi potrebbe non essere possibile creare spedizioni.

    Per ulteriori info a proposito puoi contattare il tuo referente commerciale BRT.

     

     
  • Se il campo Ragione Sociale viene valorizzato, questo sovrascriverà il campo Nome e il nome del cliente non sarà visibile sull'etichetta. Il nome del destinatario verrà comunque inviato al corriere, ma non sarà visibile sull'etichetta di spedizione.

  • N.B. BRT non effettua alcun controllo sui dati inseriti in Indirizzo 1 e Indirizzo 2, per cui, qualsiasi informazione presente in questi campi verrà trasmessa al corriere senza restituire alcun errore. BRT effettua controlli solamente sui seguenti campi: Città, CAP, Provincia.

  • Se dovessi ricevere una nostra mail che ti indica di trasmettere i tuoi ordini al corriere effettuando il fine giornata, ma sei sicuro di averlo già fatto, è possibile che tu abbia profili ShippyPro distinti connessi allo stesso account BRT. Se così fosse, devi controllare il tipo di conferma (automatica oppure esplicita) impostata all'interno dei relativi modali di connessione in tutti i tuoi account ShippyPro. Se uno di questi ha ordini da trasmettere manualmente, l'email di notifica viene inviata a tutti gli account indistintamente. Consigliamo anche di contattare il tuo referente BRT e di verificare il metodo di chiusura spedizioni per tutti i profili e che non vi siano spedizioni da chiudere.

     

  • Se utilizzi i servizi BRT diskB via FTP tramite il portale Amazon, ricorda che non è possibile utilizzare le API (questo significa che il corriere non riceverà i dati di spedizione).

 

Length of data corresponding to field 'notes' in client request is not valid

Il campo "notes" (corrispondente a Carrier Notes) ha un limite max di 70 caratteri per BRT.

 

Errore in numerazione pacco The max number of parcels allowed is 30

Ogni spedizione può contenere fino a un massimo di 30 pacchi. In caso di spedizione con quantità superiori a 30, occorre suddividerla in 2 o più spedizioni.

 

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

I caratteri nel campo Nome Destinatario superano quelli consentiti da BRT.

 

La spedizione è già presa in gestione dalla filiale - Shipment has been processed

L'errore può presentarsi a seguito di un tentativo, anche involontario, di modifica dell'ordine dopo la trasmissione del Fine Giornata. Non è possibile rimuovere l'errore ma è possibile archiviare l'ordine, in modo tale da non visualizzare l'avviso di errore in piattaforma.
Se la spedizione è stata trasmessa a BRT, ma non è più possibile stampare l'etichetta a causa dell’errore, contatta il corriere per averla, oppure crea una nuova spedizione cancellando quella in errore.

 

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

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

 

The order have a cash on delivery value but this carrier doesn't support this option.

Se riscontri questo errore vai nella sezione Corrieri> Modifica prezzi e abilita "Questo corriere supporta i contrassegni":

 

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.



WRONG OR INCONSISTENT DATA Direct Infeed DPD not allowed for SenderCustomerCode

Se ricevete 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.

 

Mancata trasmissione Fine Giornata

Se il corriere non sta ricevendo correttamente le chiusure degli ordini verifica con il tuo referente BRT che il tipo di trasmissione da loro configurata e la stessa indicata nella modale di connessione ShippyPro: Corrieri>BRT>Modifica.
Se il tipo di trasmissione concordato con il corriere è Automatico, ti preghiamo di verificare con il tuo referente BRT se la trasmissione dei dati è stata disabilitata lato loro per qualche motivo.

 

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.

 

The shipment is a triangulation but this carrier doesn't support this option.

Se riscontri questo errore vai nella sezione Corrieri > Modifica prezzi e abilita l'opzione "Questo corriere supporta le triangolazioni".

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.