Come connettere BRT a ShippyPro
Questa guida ti spiega come collegare il tuo account BRT a ShippyPro. Trovi tutti i campi della finestra di connessione: cosa significano, se ti servono e dove trovare il valore. Prima raccogli tutto quello che c’è nella checklist: poi la connessione richiede pochi minuti.
Panoramica:
ShippyPro si collega a BRT tramite le API REST di BRT. Per usarle ti servono un contratto BRT attivo e le credenziali API REST, che BRT attiva per te. Se non le hai ancora, puoi richiederle da ShippyPro (vedi Non hai ancora le credenziali API?).
Cosa ti serve
Per collegare BRT ti servono questi tre dati. Dovresti averli già ricevuti da BRT, ma possono avere un nome diverso, quindi ecco dove trovarli. Gli altri campi dipendono dai servizi del tuo contratto e sono spiegati in 2. Configurazione del corriere.
| Campo in ShippyPro | Dove trovarlo |
|---|---|
| Codice cliente BRT | In alto a sinistra su ogni fattura BRT. È anche nell’email che BRT ti invia quando attiva il tuo accesso API. |
| Password API (password API REST) | Nell’email che BRT ti invia quando attiva il tuo accesso API. NON è la password dell’area clienti di brt.it. |
| Deposito di partenza | Le prime tre cifre del tuo codice cliente. Esempio: 0123456 → 012. |
💡 Non sai chi è il tuo referente BRT? Chiama la tua filiale BRT. Su brt.it vai su Assistenza › Cerca una filiale, scegli regione e provincia: vedrai ogni filiale con il suo numero di telefono.
Inizia a collegare BRT
- Nel menu a sinistra vai su Integrazioni › Corrieri e clicca su + Aggiungi connessione.
- In Seleziona un corriere cerca BRT e clicca sul suo logo.
- Scegli come vuoi proseguire:
- Ho già le mie credenziali API: vai a 2. Configurazione del corriere.
- Non ho ancora le mie credenziali API: vedi Non hai ancora le credenziali API? qui sotto.
Non hai ancora le credenziali API? Richiedile
Se BRT non ha ancora attivato l’accesso API sul tuo account, ShippyPro può inviare la richiesta a BRT al posto tuo.
- Vai su Integrazioni › Corrieri, clicca su + Aggiungi connessione, seleziona BRT e scegli Non ho ancora le mie credenziali API.
- Compila il modulo:
- Indirizzo email del tuo referente del corriere: l’email del tuo commerciale BRT. La richiesta di attivazione viene inviata a questo indirizzo. Se non sai chi è il tuo referente, chiama la tua filiale BRT (vedi il suggerimento qui sopra).
- Codice cliente: il codice che BRT ti assegna quando attiva il contratto. Lo trovi in alto a sinistra su ogni fattura BRT.
- Deposito di partenza: le prime tre cifre del tuo codice cliente (esempio: 0123456 → 012).
- Trasmissione: come vengono confermate le tue spedizioni a BRT. BRT configura il tuo account con l’opzione che scegli qui.
- Automatica: i dati della spedizione vengono inviati a BRT appena crei l’etichetta. La Fine Giornata viene creata automaticamente.
- Manuale (esplicita): i dati della spedizione vengono inviati a BRT più tardi, quando chiudi tu la giornata lavorativa.
- Clicca su Invia. ShippyPro invia la richiesta di attivazione al tuo referente BRT e ti mette in copia. Controlla la tua casella email e attendi la conferma di BRT.
- Quando BRT attiva il tuo accesso API, ricevi le credenziali via email. Seleziona di nuovo BRT da Integrazioni › Corrieri, scegli Ho già le mie credenziali API e segui 2. Configurazione del corriere.
2. Configurazione Corriere
Quando hai ricevuto da BRT le credenziali API via email, vai su Integrazioni › Corrieri, clicca su + Aggiungi connessione, seleziona BRT e scegli Ho già le mie credenziali API. Poi compila i campi come spiegato qui sotto.
⚠️ Rispetta il tuo contratto. Seleziona solo i servizi e le opzioni concordati nel contratto con BRT. Sceglierne altri qui non cambia il tuo contratto e può far fallire le spedizioni.
Step 1: Credenziali
- Codice cliente BRT (obbligatorio): il tuo codice cliente BRT. Lo trovi in alto a sinistra su ogni fattura BRT e nell’email con cui BRT ti invia la password API.
- Password API (obbligatorio): la password API REST che BRT ti invia via email quando attiva il servizio API sul tuo account. Arriva nella stessa email del codice cliente. NON è la password dell’area clienti BRT su brt.it. Incollala senza spazi.
- Deposito di partenza (obbligatorio): le prime tre cifre del tuo codice cliente BRT. Esempio: codice cliente 0123456 → deposito di partenza 012.
- Modalità test (facoltativo): BRT può darti credenziali di test pensate per provare la connessione. Se le hai, spunta Modalità test per creare spedizioni di prova. Quando ti colleghi con le credenziali reali, lasciala non spuntata.
Step 2: Servizio ed etichetta
- Tipo di etichetta: il formato dei file delle tue etichette. Scegli quello adatto alla tua stampante:
- PDF A4: un PDF su foglio A4. Funziona con qualsiasi stampante da ufficio o di casa: ritaglia l’etichetta e attaccala al pacco.
- ZPL: per le stampanti termiche (ad es. Zebra) che stampano senza inchiostro su rotoli di etichette adesive. Più veloce per grandi volumi. La tua stampante deve supportare il linguaggio ZPL (controlla il manuale o le impostazioni).
- DP5: solo per le spedizioni sulla rete DPD (DPD Direct Infeed). BRT ti chiede di usarlo quando attiva Direct Infeed sul tuo account. È un formato termico, quindi ti serve una stampante termica, e richiede una connessione dedicata con Rete impostata su DPD.
- DPH
- Tipo di servizio: il servizio di consegna BRT usato per le tue spedizioni. Scegli quello previsto dal tuo contratto BRT:
- Servizio Standard (BRT Express): consegna standard in 24/48 ore in tutta Italia, senza limiti di peso o di numero di colli.
- Servizio Priority: consegna entro le 12:00 del giorno successivo al ritiro, in circa 3.000 località italiane. Le consegne in Calabria, Sicilia e Sardegna richiedono un po’ più di tempo.
- Servizio 10:30: consegna entro le 10:30 del giorno successivo al ritiro, in circa 1.500 città grandi e medie. Ogni spedizione può pesare fino a 100 kg e misurare fino a 0,5 m³.
- Servizio Distribuzione
- Codice servizio (facoltativo): un servizio BRT aggiuntivo. Lascia Nessuno, a meno che BRT non ti abbia attivato uno di questi:
- Return From Shop: per i resi. Il tuo cliente consegna il pacco di reso in un qualsiasi BRT-fermopoint (negozio convenzionato) invece di aspettare il corriere. BRT deve abilitarlo sul tuo account e darti un codice Deposito resi, da inserire nel campo Deposito resi.
⚠️Limiti: niente contrassegno, meno di 20 kg e 0,2 m³, e serve l’email o il cellulare del mittente del reso. - Servizio Fresco (BRT fresh): consegna refrigerata di alimenti freschi confezionati a 0–4 °C (niente surgelati), solo nelle città in cui BRT fresh è attivo. Ogni spedizione richiede la data di scadenza del prodotto nel formato A-m-g, ad es. 2026-11-30.
- Return From Shop: per i resi. Il tuo cliente consegna il pacco di reso in un qualsiasi BRT-fermopoint (negozio convenzionato) invece di aspettare il corriere. BRT deve abilitarlo sul tuo account e darti un codice Deposito resi, da inserire nel campo Deposito resi.
- Configura preferenze di stampa: queste impostazioni sono salvate nel tuo profilo, non nella connessione BRT. Il link nello Step 2 le apre in una nuova scheda. Lì scegli il formato pagina delle etichette (A4 o A6 ZPL) e quali documenti stampare subito dopo le etichette, come scheda articoli, scheda indirizzo, packing slip, riepilogo ordine o fattura.
Step 3: Opzioni aggiuntive
- Rete (predefinita: Italia): la rete BRT che trasporta la spedizione. Scegli quella coperta dal tuo contratto BRT per questa connessione:
- Italia: spedizioni nazionali in Italia (anche San Marino).
- DPD: la rete europea di BRT per piccoli pacchi verso i paesi UE. In ShippyPro ogni spedizione DPD può contenere un solo collo, quindi spedisci un ordine con più colli come spedizioni separate.
- EuroExpress: la rete europea di BRT per spedizioni con più colli (fino a 5 colli per spedizione in ShippyPro) e merce più voluminosa o pesante.
- DPD - Fuori Europa: destinazioni fuori dalla copertura europea standard, come le Isole Canarie.
- Codice tariffa: il tuo codice tariffa BRT a tre cifre per la rete selezionata sopra. BRT ti dà un codice per ogni rete insieme alle credenziali API, ad esempio 000 per Italia, 004 per EuroExpress, 301 per DPD. I tuoi codici potrebbero essere diversi. Se non ce l’hai, chiedi il tuo “codice tariffa” alla tua filiale BRT.
- Trattamento merci: il codice trattamento merci di BRT, un codice di due caratteri che BRT assegna quando la tua merce richiede un accordo di gestione specifico (ad esempio 7Q). Compilalo solo se BRT te ne ha dato uno.
- Conferma spedizione (predefinita: Manuale): come vengono confermate le spedizioni a BRT.
- Automatica: ogni spedizione viene confermata a BRT appena crei l’etichetta (BRT la chiama autoconferma). È il metodo più semplice e veloce, ma dopo non puoi più modificare la spedizione.
- Manuale: le spedizioni vengono inviate a BRT solo quando chiudi la giornata lavorativa (Fine Giornata).
⚠️ La Conferma spedizione deve corrispondere alla configurazione BRT. Scegli la modalità che BRT ha attivato per il tuo accesso API (quella che hai scelto in Trasmissione, se hai richiesto l’attivazione tramite ShippyPro). Se le tue spedizioni restano con la clessidra in Ordini spediti, di solito la causa è una mancata corrispondenza qui.
- Invia SMS ed email al destinatario: BRT invia al destinatario aggiornamenti via email e SMS sulla consegna, usando l’email e il cellulare presenti nell’ordine, quindi assicurati che i tuoi ordini li contengano. Nel tuo contratto BRT potrebbe essere un servizio a pagamento: verifica con BRT.
- Capovolgi verticalmente l’orientamento dell’etichetta: ruota l’etichetta di 180 gradi. Attivalo solo se le tue etichette escono capovolte.
- Invia a BRT il mittente originale (indirizzo mittente dell’ordine): attivalo se spedisci per conto di altri (ad esempio come operatore logistico, o per più marchi) e vuoi che etichetta e lettera di vettura mostrino il mittente dell’ordine invece della ragione sociale registrata presso BRT. Prima chiedi al tuo referente BRT di abilitare il mittente originale sul tuo account, altrimenti BRT continua a stampare la tua ragione sociale registrata.
- Codice cliente ritiro: serve solo per prenotare i ritiri BRT da ShippyPro. È il tuo codice cliente ritiro BRT: il tuo codice cliente seguito da un numero di tre cifre (ad es. 0123456001). Chiedilo alla tua filiale BRT.
- Host SFTP POD: solo se vuoi che ShippyPro recuperi le prove di consegna (POD) di BRT, cioè le immagini delle consegne firmate. Prima chiedi al tuo referente BRT di abilitare l’invio dei POD via SFTP sul tuo account. BRT ti darà poi i dati di accesso SFTP: inserisci qui l’host SFTP (indirizzo del server).
- Inserisci l’indirizzo IP o il nome host senza il protocollo. Per usare una porta diversa da quella predefinita, aggiungi :tua-porta dopo l’host.
- Username SFTP (obbligatorio): lo username SFTP.
- Password SFTP (obbligatorio): la password SFTP.
- Cartella SFTP: la cartella sul server SFTP in cui BRT mette i tuoi file POD, se BRT te ne ha indicata una.
- Estensione file POD (obbligatorio): il formato dei file POD di BRT: JPG, TIFF o PDF. Scegli il formato che ti invia BRT.
Ti serve più di una connessione BRT?
Una connessione usa una sola rete e un solo codice tariffa. Crea una connessione BRT separata quando ti servono:
- più reti (ad esempio Italia ed EuroExpress);
- il tipo di etichetta DP5, che richiede una connessione dedicata sulla rete DPD;
- più listini BRT.
Ripeti i passaggi qui sopra per ciascuna connessione.
3. Opzioni aggiuntive
Destinazioni
- National: Disponibile (Italia)
- International: Disponibile
Opzioni
- Label PDF A4, A6
- Label ZPL Disponibile
- Label EPL Non Disponibile
- DP5 (only with ZPL and DPD network)
- Track & Trace Disponibile
- Paperless Non Disponibile
- PickUp/DropOff (PUDO) Disponibile
- Cash On Delivery Disponibile
- Live Rates Non Disponibile
- Return Labels Non Disponibile
- Return Labels (in the box) Non Disponibile
- Book/Schedule Pickup Disponibile
- Address Check Non Disponibile
- Carrier Options Disponibile
- Proof Of Delivery (POD) Disponibile
- Insurance Disponibile
- Multiparcel Disponibile
- Delete Shipment (Void) Disponibile
- CloseOut Disponibile
- CN22 Non Disponibile
- CN23 Non Disponibile
Opzioni Corriere
- pin_code (text) – PIN Code Authorization
- delivery_date (text) – Required Delivery Date
- authorized_neighbor (text) – Neighbor Mandatory Authorization
- floor_delivery (checkbox) – Consegna al piano
- appointment_delivery (checkbox) – Consegna su appuntamento
- assegnoadata (checkbox) – Assegno a Data
- pointid (text) – BRT Point ID
- pallet_type1 (select) – Pallet Type
- Valori disponibili: EPAL e EUR
- Invia le informazioni sul tipo di pallet a BRT per via elettronica, poiché le richieste cartacee non sono più accettate. In caso contrario, BRT non accetterà i pallet.
- pallet_type1_number (text) – Numero di pallet del tipo selezionato
- various_particularities_management_code (text) – Various Particularities Management Code
- particularities_delivery_management_code (text) – Particularities Delivery Management Code: usa questa opzione se desideri creare una spedizione con Ritiro Contestuale, previa abilitazione del Corriere, potrai valorizzare l’Opzione Corriere particularitiesDeliveryManagementCode inserendo il codice “RC”:
- particularities_hold_on_stock_management_code (text) – Particularities Hold On Stock Management Code: usa questa opzione per fornire istruzioni specifiche su come gestire le stock holdings con il corriere inserendo il codice causale desiderato:
- cod_type (select) – BRT COD Type Valori disponibili:
- BM – Assegno Bancario intestato al mittente
- BP – Assegno al mittente non postali
- CM – Assegno Circolare intestato al mittente
- OC – Assegno circolare intestato al mittente originale
- OM – Assegno intestato al mittente originale
- TM – Assegno a data
- expiry_date (text) – Data di scadenza - Obbligatoria per servizi Fresh - Formato Y-m-d
- Packing List PDF Name
- Packing List
Come gestire la spedizione con Fermo Deposito BRT
Attualmente, nelle opzioni corriere non è possibile selezionare il Fermo Deposito come destinazione. Questo perché il servizio webservice di BRT non supporta questa funzione.
Per ovviare al problema, ti consigliamo di procedere così:
- Sostituisci l'indirizzo del destinatario con quello della filiale BRT dove il pacco sarà ritirato.
- Inserisci il nome del cliente che ritirerà il pacco nei dati del destinatario.
- Specifica “Fermo Deposito” nel campo “Note corriere”, così sarà chiaro per il corriere.
Label design
- DP5 - disponibile per barcode e text
- ZPL - disponibile per barcode, text, second_text, logo_url
Per maggiori info clicca qui.
BRT recupera le informazioni del mittente in automatico dal proprio portale. Se hai necessità di modificare un’informazione relativa ai tuoi dati, scrivi al tuo refente commerciale.
Opzioni di stampa delle etichette
Stampa BRT A4 8 etichette
È possibile stampare 8 etichette BRT su un singolo foglio A4 selezionando gli ordini dalla sezione Ordini spediti e cliccando su Stampa BRT A4 8 etichette.
Inoltre è possibile selezionare da quale posizione iniziare la stampa (da 1 a 8), in modo da poter riutilizzare i fogli parzialmente utilizzati invece di sprecare etichette.
Come funziona:
- Il layout rispecchia il formato reale del foglio: 2 colonne × 4 righe (posizione 1 = in alto a sinistra, posizione 8 = in basso a destra)
- La posizione iniziale predefinita è 1
- Le etichette vengono quindi stampate in sequenza a partire dalla posizione scelta
Al momento BRT non offre la possibilità di aggiungere un campo Note sull'etichetta.
Il campo Indirizzo 1 ha un limite di 35 caratteri.
Resi
Per procedere con i resi, seleziona prima l'opzione Return From Shop dal menu dei servizi aggiuntivi in Corrieri> BRT > Modifica.
Aggiungi quindi il codice Return Depot che ti è stato fornito da BRT.
A questo punto puoi iniziare a spedire i tuoi resi seguendo i passi di questa guida.
📌 Se l'etichetta generata presenta il nome del mittente duplicato, contatta il tuo referente BRT per chiedere che il nome del mittente sull'etichetta venga recuperato dall'originalSenderCompanyName quando si utilizza il reso dal negozio.
Come può il cliente prenotare il ritiro di una spedizione di reso?
Se nelle regole di reso di Easy Return hai scelto di addebitare le spese di rientro merce alla tua azienda e non al cliente finale, è possibile mostrare il pulsante per prenotare il ritiro nell'email con le istruzioni di reso. Basta andare su Easy Return > Template Email > Venditore addebitato e cliccare su "Mostra Pulsante per Prenotare Pickup"
Se l'opzione è flaggata il cliente compila un modulo di richiesta reso che arriva direttamente a BRT, se non è flaggata al cliente finale sarà richiesto di chiamare BRT per prenotare il ritiro.
Reso da Fermopoint
Per utilizzare il servizio è necessario che il Corriere sia abilitato. Una volta accertato, potrai selezionare il servizio dall'elenco di BRT da Corrieri > BRT > Modifica "Return from Shop" e dovrai inserire il "Deposito di reso" concordato con il Corriere.
Ecco alcune regole da considerare per spedire da e verso Fermopoints:
- Peso inferiore a 20 kg
- Volume inferiore a 0,2 m3 (lato più lungo inferiore a 1m)
- Le spedizioni non devono essere in contrassegno o con fattura ritirata
- Non devono avere istruzioni particolari per la consegna (es. contatti telefonici)
- Sono richiesti l'e-mail o il numero di telefono cellulare del destinatario o del mittente del reso.
In caso di Resi, non è necessario selezionare preventivamente il punto di ritiro richiesto dal cliente in fase di creazione dell’etichetta. Una volta munito dell’etichetta, il cliente potrà recarsi direttamente presso il punto di ritiro a lui più comodo e consegnare il pacco.
BRT PUDO FermoPoint
La soluzione Fermo Point di BRT è disponibile su ShippyPro ed è supportata esclusivamente con l’integrazione BRT REST API.
Come aggiungo un Fermo Point BRT alle mie spedizioni?
Puoi selezionare il Fermo Point in due modi, a seconda di come crei le spedizioni.
1. Da piattaforma
Puoi selezionare il Fermo Point quando crei la spedizione dalla sezione Da Spedire:
- Apri l’ordine da spedire.
- Prima di spedirlo, clicca su Aggiungi opzioni.
- Seleziona Point.
- Scegli il punto di ritiro desiderato.
- Procedi con la spedizione.
2. Via API
Se crei le spedizioni tramite le API di ShippyPro, inserisci l’ID del Fermo Point nel parametro CarrierOptions della chiamata Ship.
📌 L'etichetta FermoPoint contiene il nome della società e non il nome del destinatario.
Ricorda che le spedizioni tramite FermoPoint hanno le seguenti restrizioni:
- Massimo chilogrammi effettivi supportati: 20 kg
- Volume massimo supportato: 0.2 m3
- Lunghezza lato maggiore inferiore di 100cm
- Il contrassegno non è supportato
- Il numero di telefono del destinatario è obbligatorio
BRT PUDO FermoPoint non è ancora disponibile per spedizioni internazionali con network europeo.
Ritiri
Per poter effettuare un ritiro con BRT occorre andare in Corrieri > BRT > Modifica e inserire in modale di connessione il Codice Cliente Ritiro (Pickup Account Number), il quale viene fornito da BRT.
Si tratta di un codice composto dal tuo codice cliente + un progressivo di 3 cifre.
Una volta aggiornata la modale di connessione, segui questa guida per procedere alla creazione del ritiro.
Tariffe
BRT non trasmette le tariffe in tempo reale a ShippyPro. Se sei interessato a confrontare i prezzi, è quindi obbligatorio inserire le zone, i pesi e i listini.
ShippyPro inserisce automaticamente le zone principali, i pesi generici e aggiunge i prezzi in quantità 0 (zero). Potrai spedire con BRT anche lasciando i prezzi a 0, questo non influirà sul vostro contratto con il corriere.
Segui i passi successivi solo nel caso in cui si desideri confrontare i prezzi con altri corrieri.
Segui attentamente i passaggi indicati in questa guida: Come impostare le tariffe dei corrieri
Se utilizzi più di un listino BRT, nessun problema! Potrai aggiungere una nuova connessione per ogni tariffa.
Per farlo, non è necessario aggiungere nuovamente le credenziali BRT.
Clicca un'altra volta sull'icona di BRT per connetterlo. All'interno del pop up, clicca sulla barra di ricerca: Seleziona da un corriere già inserito e scegli la connessione con le stesse credenziali che hai precedentemente connesso.
Se desideri modificare i tempi di consegna stimati mostrati al momento della scelta Corriere, potrai farlo modificando i valori dei campi "Delivery days - min" e "Delivery days - max" da Corrieri > BRT > Modifica Prezzi.
Tracking
L'etichetta BRT API produrrà un Parcel ID: una volta che l'etichetta è stata letta e confermata dal Corriere, questo creerà il tracking finale che verrà acquisito automaticamente da ShippyPro tramite API.
Riceviamo prima un codice di tracciamento a 18 cifre, poi un codice aggiornato a 12 cifre. (Esiste anche un codice intermedio di 15 cifre). 1. "ManoMano", "Privalia", "eDock" --> supportano solo un singolo aggiornamento (una singola trasmissione del codice di tracciamento). Per questi marketplace, sarà necessario :- disattivare l'aggiornamento automatico da Marketplace > Modifica
- NON inviare l'aggiornamento manuale dopo questa azione!
Nota Bene💡
- Gli ordini uniti tramite Unisci Ordini non potranno ricevere il tracking serale.
- Il tracking DPD per le spedizioni in Europa non può essere ottenuto tramite API. Ma non preoccuparti! Con il tracking BRT è possibile tracciare anche le spedizioni effettuate con la rete DPD.
- Magento non supporta i nostri aggiornamenti Track & Trace, per questo motivo non saranno riportati sul marketplace.
- Se lo stato delle tue spedizioni già affidate continua a risultare “Unknown” (o “No Events Yet”, “Nessun Evento”) in piattaforma, controlla che le credenziali inserite nella connessione BRT siano corrette e che la scelta Fine Giornata sia allineata con quanto previamente stabilito con il Corriere (Manuale o Automatico)
- Il codice di tracking da 14 cifre rappresenta il parcelNumberGeoPost di BRT: questo viene fornito come codice tracking aggiuntivo (ma non tracciato) in interfaccia e in API response solo quando restituito lato corriere.
Il codice mostrato in Ordini Spediti rappresenta l'ID collo da 15 digit, prodotto automaticamente dal Corriere.
Il numero di tracking trasmesso tramite le nostre email è composto da 18 caratteri.
BRT genera prima un codice a 18 cifre e in un secondo momento aggiorna il tracking ad un codice a 12 cifre. Questo comportamento spiega la differenza fra le informazioni disponibili nel loro sito e ShippyPro.
Se l'ordine non è presente sul nostro portale e non c'è un marketplace collegato, non sarà possibile aggiornarlo con il secondo numero di tracking. In questo caso, dovresti creare il marketplace sulla piattaforma, importare gli ordini (o crearli con la API PutOrder) e poi spedirli usando il numero ordine del marketplace.
Sponda idraulica
Per richiedere il servizio il corriere richiede che nel campo note corriere venga indicata la dicitura "cons. con sponda idraulica" o altre abbreviazioni, purché sia chiaro il significato. Questo campo può contenere un massimo di 70 caratteri, permettendo così di aggiungere eventuali note di consegna supplementari, se necessario.4. Errori & Risoluzioni
Stai riscontrando un errore in fase di connessione o durante la creazione di un'etichetta con BRT? Visita questo link per una lista aggiornata delle problematiche più comuni:
Come risolvere gli errori per le spedizioni con BRT