Qualche tempo fa mi sono messo alla ricerca di uno standard API/EDI unificato per il trasporto che fosse utilizzato da diverse aziende logistiche. Sicuramente al giorno d'oggi deve esistere qualcosa del genere, giusto? Un formato API di spedizione universale?
Beh, per farla breve, non esiste.
La cosa più simile che si può trovare è qualche fornitore di API che ha costruito molte connessioni API con i vettori e poi offre il proprio endpoint API per accedere a diversi fornitori di servizi di trasporto.
In questo articolo, esaminerò alcune diverse API dei vettori, descriverò brevemente le loro capacità e discuterò i modi per implementarle.
NB! Se stai solo cercando un protocollo API di trasporto universale, ecco un link dove puoi prenotare una rapida chiamata con me.
Comunque, iniziamo con un…
Esempio di caso reale
Prima di tutto, definiamo l'obiettivo.
Consideriamo un produttore medio con clienti e fornitori sia nazionali che internazionali. Le merci devono essere ritirate dai fornitori e consegnate al sito di produzione, mentre i prodotti finiti devono essere spediti ai clienti.
Per stabilire una catena di approvvigionamento affidabile, un tipico produttore di medie dimensioni avrebbe bisogno di 10-20 partner di trasporto:
- Un set per pacchi nazionali
- Un altro set per pallet nazionali
- Un partner di trasporto che offre prezzi competitivi per i paesi confinanti a nord potrebbe non offrire la stessa proposta per altre direzioni o distanze più lunghe.
- Lo stesso vale per groupage, LTL o carichi completi (FTL)
- Per i clienti oltremare, potrebbe essere necessario un set completamente diverso di partner
- … e così via.
Gestire tutte queste relazioni è già abbastanza complesso. Ma il vero divertimento inizia quando si cerca di integrare i loro sistemi IT! (dato che non esiste un protocollo API di trasporto unificato)
In secondo luogo, dobbiamo concordare sull'ambito.
Non tutte le aziende logistiche offrono lo stesso livello di servizio. Alcune hanno API molto sofisticate che forniscono prezzi di trasporto istantanei, prenotazioni, etichette, tracciamento, richieste di corriere, ecc., mentre altre potrebbero avere solo un portale dove puoi accedere e inviare una prenotazione. Alcune non hanno affatto sistemi IT, solo email. Per il nostro scenario target, manteniamo le cose semplici e puntiamo solo a:
- Inviare un ordine di trasporto
- Ricevere le etichette di trasporto
- Magari ottenere il prezzo di trasporto stimato se siamo fortunati!
Sembra abbastanza semplice, vero? Oh, se solo fosse così...
Connessioni con i vettori – benvenuti nella giungla
Il modo manuale di gestire le cose, che sembra essere lo standard del settore per la maggior parte delle aziende, implica l'uso di portali dei vettori ove possibile e la comunicazione via email con il resto dei partner di trasporto. Nel nostro esempio, supponiamo che i listini prezzi di trasporto, gli orari, i tempi di consegna e la gestione delle fatture siano gestiti separatamente. Per l'invio delle prenotazioni, miriamo a costruire una connessione API dal nostro sistema ERP.
Supponiamo di aver selezionato il seguente elenco di aziende di trasporto e di dover costruire una connessione API diretta ai loro sistemi dal nostro software ERP. Questa selezione è casuale e copre solo una frazione delle diverse API dei vettori disponibili.
DHL Express – utilizza un portale chiamato MyDHL, che ha anche capacità API. Tuttavia, utilizza API diverse per i rami Freight, Express e Global Forwarding, e approcci API diversi in varie regioni. L'accesso al servizio web richiede un protocollo SOAP, servizi RESTful o XML semplice, e gli sviluppatori dovrebbero avere familiarità con XML/JSON e una comprensione di base dei servizi web. La specifica API da sola è lunga 457 pagine. È approfondita, ma il tuo sviluppatore ti addebiterà le ore spese solo per leggerla. Una volta implementata, dovresti attivare una media di 5-12 richieste per spedizione, partendo dall'autenticazione fino alle convalide degli indirizzi, ai controlli di disponibilità e alle richieste di etichette.
Schenker – utilizza soluzioni API/EDI diverse in varie regioni. Più comunemente, utilizza un protocollo SOAP con un formato XML. Il messaggio stesso è semplice, a condizione che tutti i possibili errori siano gestiti correttamente. Gli sviluppatori hanno bisogno di un accesso personalizzato per implementare l'API. A seconda della tua posizione, potrebbe essere richiesto di implementare una soluzione EDIFACT invece, che tratterò più avanti.
DSV – si è recentemente spostato sul loro portale con capacità API chiamato MyDSV. Dato che l'API è abbastanza nuova, sfrutta alcuni degli approcci più recenti e moderni nel mondo delle API. Nonostante la complessità durante l'autenticazione e la navigazione nel loro catalogo prodotti, l'approccio è semplice. Ancora una volta, a seconda della tua posizione, EDIFACT potrebbe essere preferito.
FedEx e TNT – questo può essere divertente. Prima, devi determinare se stai utilizzando i servizi TNT o FedEx. Anche se dovrebbero essere la stessa azienda da diversi anni, la migrazione è ancora in sospeso. Se il tuo contratto è con TNT, molto probabilmente ti verrà chiesto di implementare l'API TNT Express Connect. L'implementazione stessa è di complessità media. Lo svantaggio è che questa API è considerata obsoleta e alla fine verrà chiusa. L'API FedEx, d'altra parte, è più complessa e offre diverse opzioni a seconda della regione in cui ti trovi. In Cargoson, abbiamo implementato l'API FedEx Compatible, che fornisce alcune funzionalità aggiuntive molto interessanti ma è disponibile solo per i partner FedEx Compatible.
UPS – utilizza un'API basata su JSON e OAuth per l'autenticazione, il che significa che ci sono diverse richieste che dovresti attivare prima di far passare la tua prenotazione e ricevere le etichette.
Poi abbiamo EDIFACT, utilizzato da molte aziende di trasporto come DSV, Maersk, DB Schenker, Kuehne + Nagel, C.H. Robinson, CEVA Logistics, ecc. È uno standard molto vecchio, e anche se potrebbe sembrare che potresti cavartela con un'integrazione API per diverse aziende logistiche, ripensaci. Il più grande svantaggio è che si tratta di una connessione basata sullo scambio di file, il che significa che dovresti generare un file fisico effettivo, poi trasmetterlo via FTP e letteralmente sperare che vada tutto bene perché c'è un feedback molto complicato sugli errori e gli avvisi.
Simile a EDIFACT è FORTRAS, una connessione basata su file con gli stessi svantaggi. È più in uso in Germania e nei paesi vicini. Non solo lo scambio di file è impegnativo, ma il formato del file stesso è difficile da leggere e, quindi, richiede molto tempo per il debug degli errori. Alcune aziende ben note che lo utilizzano includono Dachser, Schenker, Kuehne + Nagel, Hellmann Worldwide Logistics, GLS, Hermes, Gebrüder Weiss, ecc.
Anche dopo aver implementato tutte le integrazioni menzionate sopra, rimane la domanda:
Cosa fai con le aziende di trasporto che non hanno alcun sistema IT o portale, per non parlare di un'API per accettare ordini di trasporto?
La soluzione più semplice è inviare una semplice email. Anche se questo potrebbe sembrare semplice, approfondiamo. Impostare la connessione tecnica al tuo server di posta è una cosa, ma cosa dire dei contatti? Normalmente, direzioni diverse sono gestite da persone di contatto diverse, e le persone cambiano posizione. Quindi, dovresti costruire una matrice di contatti piuttosto completa nel tuo ERP.
Quindi, quali sono le alternative alla lotta con API dei vettori disparate e protocolli EDI?
Un'opzione da considerare è una API multi-vettore. Essenzialmente, si tratta di un fornitore di servizi che ha costruito tutte le connessioni dei vettori, che siano API moderne, vecchi protocolli EDI basati su EDIFACT o FORTRAS o integrazioni email, e le ha rese disponibili tramite la propria API di spedizione standardizzata. Invece di implementare varie API dei vettori e mantenerle aggiornate, puoi implementare solo uno standard API multi-vettore e attivare tutti i tuoi ordini di trasporto attraverso di esso.
Ma siamo andati anche oltre.
Software multi-vettore – migliorare i tuoi vettori esistenti?
Diverse aziende logistiche offrono livelli di servizio variabili. Alcune forniscono un'API di prenotazione, mentre altre no; alcune offrono capacità di tracciamento, mentre altre mancano di questa funzionalità. In Cargoson, abbiamo implementato tutte le funzionalità che colmano le lacune per ogni azienda di trasporto.
Per esempio, quando un vettore non offre la prenotazione online, forniamo un portale per quello. Se mancano di tracciamento, lo aggiungiamo. Abbiamo sistemi per caricare la prova di consegna (POD) e altri documenti, API multi-vettore complete di funzionalità, stime ETA, calcoli dei prezzi di trasporto, statistiche sulle prestazioni e persino cifre sulle emissioni di CO2 del trasporto. In pratica, qualunque cosa manchi a un vettore, l'abbiamo costruita noi così non devi preoccuparti delle differenze di livello IT o di servizio tra i tuoi vettori.
Ecco un esempio del mondo reale: grandi player come FedEx, TNT e DHL Express offrono un'API di prezzi. Ciò significa che quando attivi una richiesta di prezzo da Cargoson, i prezzi vengono estratti direttamente dal sistema del vettore. Tuttavia, nei casi in cui un'azienda come DSV non fornisce un'API di prezzi, il listino prezzi Excel o PDF fornito da DSV viene caricato su Cargoson, e il calcolo del prezzo viene eseguito all'interno del nostro sistema. Abbiamo un potente motore di caricamento e calcolo dei prezzi di trasporto per questo. Lo stesso approccio può essere applicato a tutte le altre aziende di trasporto ed è applicabile anche ad altre funzionalità.
Il nostro obiettivo è semplice: darti un'esperienza coerente e di alta qualità con tutti i vettori, anche se non tutti partono con le stesse capacità. Uno standard API dei vettori universale de facto e una piattaforma multi-vettore in uno.
Se stai cercando un modo migliore per gestire le tue integrazioni con i vettori, Cargoson può aiutarti. La nostra piattaforma fornisce una singola API di trasporto standardizzata che ti collega a tutti i tuoi vettori, indipendentemente dalle loro capacità individuali. Ciò significa che puoi accedere a tutti i tuoi servizi di spedizione attraverso un'interfaccia unificata, senza preoccuparti delle differenze tecniche sottostanti.
Vuoi vedere come potrebbe funzionare per la tua azienda? Facciamo una rapida chiamata per discutere della tua configurazione attuale e delle sfide specifiche di integrazione. Possiamo esaminare alcuni esempi del mondo reale di come Cargoson ha aiutato aziende in casi simili al tuo: