Nel corso di questi mesi sono stati sviluppati alcuni nuovi servizi che consentono ai clienti BRT di affidare spedizioni con soluzioni diverse rispetto al passato e tecnologicamente moderne. Tale soluzione prende il nome di Brt Shipment Rest Api.

A chi sono dedicati i servizi Brt Shipment Rest Api

L’utilizzo di Brt Shipment Rest Api è da consigliare a tutti i clienti che vogliono adottare la soluzione DISK B sequenziale e consente di lavorare in due diverse modalità:

• Auto conferma: con questa modalità operativa, nel momento in cui il cliente ci affida spedizioni, queste spedizioni sono direttamente confermabili dalla filiale di gestione.
• Conferma esplicita: con questa modalità operativa, il cliente ci invia i dati ed in un secondo momento dovrà invocare nuovamente un servizio per confermarci l’effettivo affidamento delle spedizioni. Solo le spedizioni confermate da questo secondo passaggio saranno visibili alla “conferma bolle” della filiale di gestione, mentre quelle non confermate saranno eliminate dopo 15 gg.

La modalità di lavoro AutoConferma o Conferma Esplicita deve essere decisa in fase di analisi preliminare con il cliente, in base alla sua operatività. Tale modalità vale per tutto il traffico del cliente e non può essere variato per singola spedizione.

In ognuna delle precedenti modalità, il cliente avrà la possibilità di ricevere le etichette in formato ZPL o PDF oppure solo le informazioni necessarie per produrre in autonomia la propria etichetta.

Modalità di utilizzo dei servizi

Di seguito si riporto una schematizzazione delle possibili chiamate che possono essere eseguite per modalità operativa:

AutoConferma & Etichetta personalizzata

Il cliente che decide di lavorare in questa modalità per ogni chiamata deve eseguire una invocazione del metodo Create. In caso di risultato positivo la spedizione viene creata ed è immediatamente disponibile alla bollettazione. Tra i valori di ritorno sono presenti tutti i parametri necessari al cliente per produrre in autonomia la propria etichetta.

AutoConferma & Etichetta BRT

Il cliente che decide di lavorare in questa modalità per ogni chiamata deve eseguire una invocazione del metodo Create. In caso di risultato positivo la spedizione viene creata ed è immediatamente disponibile alla bollettazione. Tra i valori di ritorno sarà presente lo stream della etichetta (o etichette) nel formato richiesto durante l'invocazione del servizio.

Conferma Esplicita & Etichetta personalizzata

Il cliente che decide di lavorare in questa modalità per ogni chiamata deve eseguire una invocazione del metodo Create specificando il parametro isLabelRequired = 0. In caso di risultato positivo la spedizione viene creata nel sistema BRT ma non è ancora in alcun modo visibile dalla filiale. L'invocazione restituisce tutte le informazioni necessarie per poter produrre l'etichetta personalizzata. Solo quando il cliente è certo delle spedizioni che effettivamente intende affidarci, dovrà eseguire l'invocazione del rest Confirm (tecnicamente devono trascorrere almeno 5 minuti della invocazione del servizio Create).

Conferma Esplicita & Etichetta Brt

Il cliente che decide di lavorare in questa modalità per ogni chiamata deve eseguire una invocazione del metodo Create specificando il parametro isLabelRequired = 1. In caso di risultato positivo la spedizione viene creata nel sistema BRT ma non è ancora in alcun modo visibile dalla filiale. L'invocazione restituisce lo stream dell'etichetta del formato indicato. Solo quando il cliente è certo delle spedizioni che effettivamente intende affidare BRT, dovrà eseguire l'invocazione del rest Confirm (tecnicamente devono trascorrere almeno 5 minuti della invocazione del servizio Create).

Cancellazione Spedizione

Questo servizio esegue la cancellazione di una spedizione precedente creata o confermata. Un spedizione risulta cancellabile, indipendetemente dalla modalità operativa AutoConferma/ConfermaEsplicita, fino al momento in cui la spedizione viene presa in gestione dalla filiale BRT. Nel caso in cui si tenti cancellare una spedezione già inn gestione alla filiale, il rest restiuirà un codice di errore.

Tracking

Servizio che prevede la possibilità di avere il tracking della spedizione partendo dal segnacollo (parcelID) restituito dal servizion di create.  Le informazioni di tracking saranno disponibili solo quanto i dati della spedizione sono presi in gestione della filiale.

Principali differenze rispetto al servizio BRT_ShipmentWS

Brt Shipment Rest Api è stata sviluppata utilizzando tecnologia REST che rappresenta la naturale evoluzione della tecnologia SOAP utilizzata nel precedente ws BRT_ShipmentWS. E’ bene precisare che questa nuova soluzione non è in alcun modo legato ai vecchi ws. Brt Shipment Rest Api è stato pensato per semplificare l’integrazione da parte cliente. In particolare:

• sono stati rivisti il tipo ed il numero dei parametri che il cliente deve fornirci per creare una spedizione nel nostro sistema
• molto dati ora sono ricavati dalle anagrafiche presenti nel nostro sistema ( es serie, trattamento merce,…).
• è possibile abilitare un codice cliente unificante e tutti i suoi figli saranno automaticamente abilitati.
• sono stati utilizzati nomi più “parlanti” rispetto ai nomi utilizzati nel file VAB, che comunque rimangono indicati in documentazione per facilitare chi già conosce questa codifica.
• utilizzo di standard ISO per nazioni, codice pagamento (PORTO), data, etc.
• assegnazione del segnacollo SOLO automatica da parte di BRT, ricavata dalla serie attribuita al cliente in fase attivazione di un nuovo codice cliente
• etichette: in formato etichette ZPL (base64) e PDF. Al momento non sono più disponibili ZPL asci, TIFF e JPG in quanto non utilizzate
• sono gestite solo le etichette a livello di segnacollo e non a livello di spedizione
• ogni servizio Rest gestisce una sola una singola spedizione

In generale, le diverse operazioni che potevano essere eseguite con il precedente ws BRT_V_ShipmentWS (FEATURE_CODE) ora saranno disponibili tramite servizi autonomi (per i dettagli si veda a documentazione linkata):

• Create: crea una singola spedizione e stampa (se richiesto) le etichette
• Routing: calcola l’instradamento BRT
• Confirm: conferma di una spedizione precedentemente creata

Disponibilità e limitazioni del servizio

L'utilizzo di questi servizi deve essere concordato con la filiale di riferimento BRT

BRT si riserva la facoltà di effettuare verifiche sull'utilizzo di tali servizi e di adottare le necessarie contromisure tecniche restrittive per garantire la costante e corretta erogazione del servizio nel interesse generale di tutti i clienti.

Limiti Applicativi

Protocolli supportati TLS

TLS 1.3

TLS_AES_128_GCM_SHA256 (0x1301)　　　

TLS_AES_256_GCM_SHA384 (0x1302)　　　

TLS_CHACHA20_POLY1305_SHA256 (0x1303)　　　

TLS 1.2

TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (0xc02f)　　　

TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (0xc030)　　

TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 (0xcca8)