API
Dopo aver creato il tuo account, avrai una chiave API. Puoi raggiungerlo attraverso la tua dashboard sotto la sezione ShipsGo Integration nella barra laterale sinistra. Puoi considerare questa chiave come un codice di comunicazione tra la tua azienda e ShipsGo.
Grazie a questa chiave, quando il cliente invia la richiesta di tracciamento, il sistema ShipsGo riconosce il nome dell'azienda e memorizza la richiesta sull'account aziendale. Quindi, il nostro sistema invia l'e-mail di notifica a te e ai tuoi clienti con il tuo logo e l'indirizzo e-mail se lo desideri.
Inoltre, utilizziamo questa chiave per calcolare anche il consumo dei tuoi crediti.
No, non vi è alcuna limitazione per la pubblicazione di richieste di monitoraggio; o effettuare una chiamata per ottenere i dati di viaggio. Il limite di chiamata API è limitato solo all'importo del credito nei tuoi account. Puoi scoprire il nostro servizio API qui.
Certo che puoi.
È sufficiente creare una funzione GET con API e aggiungere "&mapPoint=true " alla fine dell'URL della richiesta. Poi vedrete le coordinate della nave.
Non ci sono costi aggiuntivi per le chiamate API, l'integrazione e il supporto tecnico per API.
Il nostro servizio funziona con i crediti. Non importa se si traccia con un numero di contenitore o il numero BL è necessario 1 credito per ogni traccia. Questo credito 1 include tutte le notifiche, le ricerche sulla mappa in tempo reale e le chiamate API fino alla fine del viaggio.
ShipsGo API fornisce la situazione attuale della spedizione, quindi i dati storici non sono disponibili per ora. Tuttavia, con ShipsGo Analytics360, i nostri utenti possono raggiungere le statistiche performative comparative in base ai loro dati storici combinati con il database ShipsGo.
Pagamento
Puoi utilizzare Visa e Master Cards e -metodi di bonifico bancario- per gli acquisti dal nostro sistema. È un servizio prepagato.
Si prega di notare che le carte AMEX non sono accettate per ora.
Non esitare a scriverci dalla Live Chat o a support@shipsgo.com se hai bisogno di ulteriore assistenza.
ShipsGo utilizza un sistema 3D Secure.
3D Secure ti protegge da transazioni online non autorizzate poiché ti verrà richiesto di inserire una password monouso che verrà inviata al tuo numero di cellulare e indirizzo e-mail prima di poter completare la transazione online.
Questa ulteriore fase di autorizzazione garantisce che solo tu, in qualità di titolare della carta, avrai la password richiesta per completare la transazione.
Prezzi
Il sistema ShipsGo funziona con i crediti. Ogni richiesta di tracciamento (caricando una spedizione su ShipsGo una volta) consuma 1 credito. Quindi, avrai query illimitate per le spedizioni caricate e non spenderà i tuoi crediti.
Puoi tracciare la tua spedizione con il numero del container, il numero della polizza di carico principale (B/L) o il numero di prenotazione. Indipendentemente da quanti contenitori ha il tuo B/L, quando monitori con un numero B/L, verrà consumato solo 1 credito.
Non c'è nessuna data di scadenza per i tuoi crediti. Il costo per credito (CPC) cambia in base al volume di acquisti. Poiché otterrai crediti bonus all'aumentare del volume degli acquisti, il tuo CPC diminuirà.
Puoi calcolare il tuo CPC e il costo totale utilizzando il nostro Calcolatrice.
Alcuni utenti sono preoccupati per i loro crediti quando tracciano con un numero di polizza di carico perché, la maggior parte delle volte, B/L contiene più di un contenitore.
Ecco la regola: 1 tracking equivale a 1 credito.
Per favore non preoccuparti perché indipendentemente da quanti contenitori ha il tuo B/L, quando monitori con un numero B/L, verrà consumato solo 1 credito.
Sottoscrizione
Non c'è nessun limite di tempo per il tuo periodo di prova. Avrai 5 crediti di prova gratuiti per il monitoraggio quando crei il tuo account. Dopo averli consumati, dovrai acquistare altri crediti per continuare a utilizzare il nostro servizio di tracciamento.
Monitoraggio del contenitore
SÌ. Grazie alla nostra funzione Live Map, puoi vedere la posizione della tua spedizione. Utilizzando Live Map, puoi accedere alle informazioni sui porti di carico e scarico, la data di arrivo della nave, la compagnia di navigazione e il nome della nave. Puoi anche integrare la nostra Live Map nel tuo sito web e i tuoi clienti possono monitorare le loro spedizioni direttamente attraverso il tuo sito web.
Vai su ShipsGo Homepage e seleziona l'armatore. Quindi, inserisci il tuo numero di container, prenotazione o BL e fai clic sul pulsante Traccia spedizione. Dovresti "creare un account" e ricevere notifiche sulla tua spedizione facilmente!
Puoi provare il nostro sistema di tracciamento dei container con i cinque crediti che ti diamo gratuitamente dopo la registrazione. Avrai cinque crediti di prova gratuiti per il monitoraggio quando crei il tuo account. Una volta consumati i tuoi crediti gratuiti, dovrai acquistarne altri per continuare a utilizzare il nostro servizio di tracciamento.
Sì, ShipsGo traccia anche i container refrigerati. Per il sistema è sufficiente che l'utente abbia il numero del contenitore. Finché ShipsGo ha il numero del container e il vettore fornisce i dati di viaggio di esso ShipsGo traccia anche il container refrigerato.
La maggior parte delle compagnie di navigazione ha formato i numeri della polizza di carico principale come SCAC + numero della polizza di carico principale. Se il tuo numero di polizza di carico non segue questo formato, potrebbe trattarsi di un numero di polizza di carico della casa e non del comandante.
Purtroppo. Solo la polizza di carico principale, il numero di prenotazione o il numero del container sono accettati per avviare il monitoraggio.
Il numero "house bill of lading" è il numero dei documenti di trasporto via mare emessi dagli spedizionieri per i loro clienti. Quindi non è possibile trovare dati di viaggio quando i trigger vengono effettuati sul sito Web della compagnia di navigazione quando si esegue la query con il numero della "house bill of lading".
ShipsGo fornisce supporto per il monitoraggio dei container per oltre 100 compagnie di navigazione. Puoi vedere tutti i corrieri a cui forniamo supporto per il monitoraggio facendo clic sul link sottostante.
L'elenco dei corrieri è qui. 👈🏿
Il Riferimento Spedizione è il tuo riferimento su cui puoi inserire qualsiasi informazione e ti aiuterà a capire su quali spedizioni stai lavorando.
Sei libero di usare numeri, lettere o combinazioni di entrambi. Digita tutto ciò che desideri, ma assicurati di non superare i 200 caratteri.
Riferimento spedizione è anche il titolo delle e-mail di notifica.
Alcuni esempi; Track1, Shipment35, ShipsGoTrack1875, 6756799, ecc.
Il "First ETA" (Estimated Time of Arrival) è la prima data di arrivo pianificata che il nostro sistema ha ottenuto dal database delle compagnie di navigazione. Lo scostamento tra il primo ETA e la data di arrivo effettiva indica il numero di giorni in cui il container è arrivato in anticipo o in ritardo.
Sfortunatamente, questo accade a volte perché il sistema di tracciamento della linea di spedizione non è disponibile o le informazioni sul numero del container/numero BL potrebbero essere errate. Si prega di verificare e riprovare.
Se una linea di spedizione non fornisce informazioni sulla tua spedizione, la spedizione non è tracciabile. Pertanto, invieremo e-mail di notifica etichettando il contenitore come "Untracked", il che indica che il monitoraggio di questo contenitore non è possibile.
In questo caso, dovresti contattare il tuo operatore per telefono o e-mail.
Sì, puoi tracciare il tuo container con il numero del container, il numero di prenotazione o il numero Master BL. Tuttavia, è necessario disporre di un account ShipsGo per questo servizio. Puoi crearlo gratuitamente qui.
La nostra linea guida dashboard spiega brevemente come tracciare le tue spedizioni con Master BL Number.
Dopo aver inviato una richiesta di tracciamento, riceverai varie notifiche da ShipsGo agli indirizzi e-mail di tua scelta per mantenere te o i tuoi clienti aggiornati sulle spedizioni.
Queste notifiche sono; notifica di partenza, notifiche di ritardo, avviso di arrivo puntuale, avviso di rilascio del container e conferma di uscita del container.
Riceverai e-mail di notifica contenenti:
+Il nome dei porti di carico, scarico e trasbordo,
+Il nome della compagnia di navigazione, i nomi delle navi,
+Le date di carico, scarico e gate-out,
+Il tempo di transito totale,
+Giorni di ritardo della spedizione.
Queste e-mail di notifica conterranno anche un collegamento che ti mostrerà l'effettiva posizione in tempo reale del tuo container su una mappa.
Sì, puoi tenere traccia di più di un contenitore contemporaneamente utilizzando i metodi Carica Excel o Integrazione API. Devi creare un account GRATUITO. Puoi utilizzare il metodo API con i tuoi 5 crediti gratuiti. Vedi tutti i dettagli sulla nostra API qui.. Puoi provare il metodo Carica Excel quando aggiorni il tuo account dopo aver consumato 5 crediti gratuiti, le nostre linee guida sulla dashboard ti aiuteranno.
Prezzi
Il sistema ShipsGo funziona con i crediti. Ogni richiesta di tracciamento (caricando una spedizione su ShipsGo una volta) consuma 1 credito. Quindi, avrai query illimitate per le spedizioni caricate e non spenderà i tuoi crediti.
Puoi tracciare la tua spedizione con il numero del container, il numero della polizza di carico principale (B/L) o il numero di prenotazione. Indipendentemente da quanti contenitori ha il tuo B/L, quando monitori con un numero B/L, verrà consumato solo 1 credito.
Non c'è nessuna data di scadenza per i tuoi crediti. Il costo per credito (CPC) cambia in base al volume di acquisti. Poiché otterrai crediti bonus all'aumentare del volume degli acquisti, il tuo CPC diminuirà.
Puoi calcolare il tuo CPC e il costo totale utilizzando il nostro Calcolatrice.
Alcuni utenti sono preoccupati per i loro crediti quando tracciano con un numero di polizza di carico perché, la maggior parte delle volte, B/L contiene più di un contenitore.
Ecco la regola: 1 tracking equivale a 1 credito.
Per favore non preoccuparti perché indipendentemente da quanti contenitori ha il tuo B/L, quando monitori con un numero B/L, verrà consumato solo 1 credito.
Dovrete spendere 2 crediti per ogni richiesta di tracciamento di una spedizione aerea. Il motivo principale per cui la tracciatura di una spedizione aerea richiede due crediti è che, rispetto alla tracciatura dei container, comporta aggiornamenti molto più frequenti e l'elaborazione dei dati in tempo reale a causa del rapido movimento dei carichi aerei (in alcuni casi con trasporti multipli, che chiamiamo split shipments).
Monitoraggio del contenitore
ShipsGo fornisce supporto per il monitoraggio dei container per oltre 100 compagnie di navigazione. Puoi vedere tutti i corrieri a cui forniamo supporto per il monitoraggio facendo clic sul link sottostante.
L'elenco dei corrieri è qui. 👈🏿
Purtroppo. Solo la polizza di carico principale, il numero di prenotazione o il numero del container sono accettati per avviare il monitoraggio.
Il numero "house bill of lading" è il numero dei documenti di trasporto via mare emessi dagli spedizionieri per i loro clienti. Quindi non è possibile trovare dati di viaggio quando i trigger vengono effettuati sul sito Web della compagnia di navigazione quando si esegue la query con il numero della "house bill of lading".
Purtroppo. Solo la polizza di carico principale, il numero di prenotazione o il numero del container sono accettati per avviare il monitoraggio.
Il numero "house bill of lading" è il numero dei documenti di trasporto via mare emessi dagli spedizionieri per i loro clienti. Quindi non è possibile trovare dati di viaggio quando i trigger vengono effettuati sul sito Web della compagnia di navigazione quando si esegue la query con il numero della "house bill of lading".
La maggior parte delle compagnie di navigazione ha formato i numeri della polizza di carico principale come SCAC + numero della polizza di carico principale. Se il tuo numero di polizza di carico non segue questo formato, potrebbe trattarsi di un numero di polizza di carico della casa e non del comandante.
Sì, ShipsGo traccia anche i container refrigerati. Per il sistema è sufficiente che l'utente abbia il numero del contenitore. Finché ShipsGo ha il numero del container e il vettore fornisce i dati di viaggio di esso ShipsGo traccia anche il container refrigerato.
Puoi provare il nostro sistema di tracciamento dei container con i cinque crediti che ti diamo gratuitamente dopo la registrazione. Avrai cinque crediti di prova gratuiti per il monitoraggio quando crei il tuo account. Una volta consumati i tuoi crediti gratuiti, dovrai acquistarne altri per continuare a utilizzare il nostro servizio di tracciamento.
Vai su ShipsGo Homepage e seleziona l'armatore. Quindi, inserisci il tuo numero di container, prenotazione o BL e fai clic sul pulsante Traccia spedizione. Dovresti "creare un account" e ricevere notifiche sulla tua spedizione facilmente!
SÌ. Grazie alla nostra funzione Live Map, puoi vedere la posizione della tua spedizione. Utilizzando Live Map, puoi accedere alle informazioni sui porti di carico e scarico, la data di arrivo della nave, la compagnia di navigazione e il nome della nave. Puoi anche integrare la nostra Live Map nel tuo sito web e i tuoi clienti possono monitorare le loro spedizioni direttamente attraverso il tuo sito web.
Sì, puoi tenere traccia di più di un contenitore contemporaneamente utilizzando i metodi Carica Excel o Integrazione API. Devi creare un account GRATUITO. Puoi utilizzare il metodo API con i tuoi 5 crediti gratuiti. Vedi tutti i dettagli sulla nostra API qui.. Puoi provare il metodo Carica Excel quando aggiorni il tuo account dopo aver consumato 5 crediti gratuiti, le nostre linee guida sulla dashboard ti aiuteranno.
Riceverai e-mail di notifica contenenti:
+Il nome dei porti di carico, scarico e trasbordo,
+Il nome della compagnia di navigazione, i nomi delle navi,
+Le date di carico, scarico e gate-out,
+Il tempo di transito totale,
+Giorni di ritardo della spedizione.
Queste e-mail di notifica conterranno anche un collegamento che ti mostrerà l'effettiva posizione in tempo reale del tuo container su una mappa.
Dopo aver inviato una richiesta di tracciamento, riceverai varie notifiche da ShipsGo agli indirizzi e-mail di tua scelta per mantenere te o i tuoi clienti aggiornati sulle spedizioni.
Queste notifiche sono; notifica di partenza, notifiche di ritardo, avviso di arrivo puntuale, avviso di rilascio del container e conferma di uscita del container.
Sfortunatamente, questo accade a volte perché il sistema di tracciamento della linea di spedizione non è disponibile o le informazioni sul numero del container/numero BL potrebbero essere errate. Si prega di verificare e riprovare.
Se una linea di spedizione non fornisce informazioni sulla tua spedizione, la spedizione non è tracciabile. Pertanto, invieremo e-mail di notifica etichettando il contenitore come "Untracked", il che indica che il monitoraggio di questo contenitore non è possibile.
In questo caso, dovresti contattare il tuo operatore per telefono o e-mail.
Il "First ETA" (Estimated Time of Arrival) è la prima data di arrivo pianificata che il nostro sistema ha ottenuto dal database delle compagnie di navigazione. Lo scostamento tra il primo ETA e la data di arrivo effettiva indica il numero di giorni in cui il container è arrivato in anticipo o in ritardo.
Il Riferimento Spedizione è il tuo riferimento su cui puoi inserire qualsiasi informazione e ti aiuterà a capire su quali spedizioni stai lavorando.
Sei libero di usare numeri, lettere o combinazioni di entrambi. Digita tutto ciò che desideri, ma assicurati di non superare i 200 caratteri.
Riferimento spedizione è anche il titolo delle e-mail di notifica.
Alcuni esempi; Track1, Shipment35, ShipsGoTrack1875, 6756799, ecc.
Pagamento
Puoi utilizzare Visa e Master Cards e -metodi di bonifico bancario- per gli acquisti dal nostro sistema. È un servizio prepagato.
Si prega di notare che le carte AMEX non sono accettate per ora.
Non esitare a scriverci dalla Live Chat o a support@shipsgo.com se hai bisogno di ulteriore assistenza.
ShipsGo utilizza un sistema 3D Secure.
3D Secure ti protegge da transazioni online non autorizzate poiché ti verrà richiesto di inserire una password monouso che verrà inviata al tuo numero di cellulare e indirizzo e-mail prima di poter completare la transazione online.
Questa ulteriore fase di autorizzazione garantisce che solo tu, in qualità di titolare della carta, avrai la password richiesta per completare la transazione.
API
ShipsGo API fornisce la situazione attuale della spedizione, quindi i dati storici non sono disponibili per ora. Tuttavia, con ShipsGo Analytics360, i nostri utenti possono raggiungere le statistiche performative comparative in base ai loro dati storici combinati con il database ShipsGo.
Non ci sono costi aggiuntivi per le chiamate API, l'integrazione e il supporto tecnico per API.
Il nostro servizio funziona con i crediti. Non importa se si traccia con un numero di contenitore o il numero BL è necessario 1 credito per ogni traccia. Questo credito 1 include tutte le notifiche, le ricerche sulla mappa in tempo reale e le chiamate API fino alla fine del viaggio.
Certo che puoi.
È sufficiente creare una funzione GET con API e aggiungere "&mapPoint=true " alla fine dell'URL della richiesta. Poi vedrete le coordinate della nave.
No, non vi è alcuna limitazione per la pubblicazione di richieste di monitoraggio; o effettuare una chiamata per ottenere i dati di viaggio. Il limite di chiamata API è limitato solo all'importo del credito nei tuoi account. Puoi scoprire il nostro servizio API qui.
Dopo aver creato il tuo account, avrai una chiave API. Puoi raggiungerlo attraverso la tua dashboard sotto la sezione ShipsGo Integration nella barra laterale sinistra. Puoi considerare questa chiave come un codice di comunicazione tra la tua azienda e ShipsGo.
Grazie a questa chiave, quando il cliente invia la richiesta di tracciamento, il sistema ShipsGo riconosce il nome dell'azienda e memorizza la richiesta sull'account aziendale. Quindi, il nostro sistema invia l'e-mail di notifica a te e ai tuoi clienti con il tuo logo e l'indirizzo e-mail se lo desideri.
Inoltre, utilizziamo questa chiave per calcolare anche il consumo dei tuoi crediti.
API_DOC
No, Dal momento che ShipsGo sta raccogliendo informazioni pubblicamente disponibili, l'autorizzazione non è necessaria. Puoi monitorare la tua spedizione in qualsiasi momento purché la tua linea di spedizione sia una delle linee di spedizione supportate e tu abbia una chiave API.
Si prega di notare che:
Qualsiasi interazione con l'API richiederà sempre la tua CHIAVE API. Sarà disponibile sul cruscotto quando si dispone di un account.
La nostra documentazione API può fornire informazioni più dettagliate sulla creazione di una nuova richiesta.
L'API ShipsGo ha 2 metodi: Post e Get.
Poiché alcune informazioni come {containerNumber}, {blContainersRef}, {emailAddress} ecc. sono necessari per avviare il monitoraggio, il primo passo è creare la richiesta di monitoraggio. La richiesta di tracciamento viene creata utilizzando il metodo Post con il contenitore, la polizza di carico principale o il numero di prenotazione.
Il {requestId} restituisce con il "Codice di stato OK 200" ai client se la richiesta è stata creata e pubblicata su ShipsGo correttamente e ciò significa che la richiesta ha raggiunto il server.
Se il POST fallisce, ritorna il "Error Message". L'elenco delle risposte di errore per il metodo può essere trovato qui.
Il client può eseguire il "metodo GET" per chiamare i dati di viaggio utilizzando {containerNumber} o {requestId} dopo che il messaggio di successo è stato restituito
Si prega di tenere presente che il metodo POST è idempotente. È sufficiente eseguire POST per ogni traccia per una volta. Tuttavia, il client può effettuare chiamate GET quanto necessario.
SUGGERIMENTO:
Dal momento che ogni spedizione viene aggiornato 3 volte al giorno per ogni spedizione 3 chiamate GET sono altamente sufficienti.
Cautela:
L'API ShipsGo fornisce dati provenienti dal viaggio attivo o più recente di un container.
Il tracciamento della "Hause Bill of Lading " non è supportato. Viene accettato solo il numero della polizza di carico principale.
È sufficiente eseguire POST per ogni traccia per una volta.
I dati del viaggio vengono aggiornati 3 volte al giorno. Quindi, puoi impostare la tua funzione GET in modo che venga attivata 3 volte al giorno.
Sì, forniamo API. Puoi trovare tutti i dettagli su API qui.
Se hai bisogno di supporto tecnico o di ulteriori informazioni relative all'integrazione API, non esitare a scriverci dalla Live Chat o support@shipsgo.com.
Dopo aver creato il tuo account, avrai una chiave API. Puoi raggiungerlo attraverso la tua dashboard sotto la sezione ShipsGo Integration nella barra laterale sinistra. Puoi considerare questa chiave come un codice di comunicazione tra la tua azienda e ShipsGo.
Grazie a questa chiave, quando il cliente invia la richiesta di tracciamento, il sistema ShipsGo riconosce il nome dell'azienda e memorizza la richiesta sull'account aziendale. Quindi, il nostro sistema invia l'e-mail di notifica a te e ai tuoi clienti con il tuo logo e l'indirizzo e-mail se lo desideri.
Inoltre, utilizziamo questa chiave per calcolare anche il consumo dei tuoi crediti.
Certo che puoi.
È sufficiente creare una funzione GET con API e aggiungere "&mapPoint=true" alla fine dellURL della richiesta. Poi vedrete le coordinate della nave.
No, non vi è alcuna limitazione per la pubblicazione di richieste di monitoraggio; o effettuare una chiamata per ottenere i dati di viaggio. Il limite di chiamata API è limitato solo all'importo del credito nei tuoi account. Puoi scoprire il nostro servizio API qui.
Quando utilizzi l'integrazione API, ottieni informazioni sul viaggio in formato XML o JSON. Una delle prime cose che vedrai nel file XML OR JSON è lo "status". Questo "status" indica lo stato delle spedizioni.
I significati degli stati sono i seguenti;
InProgress (StatusId = 20): la linea di spedizione non ha ancora rilasciato alcuna informazione sul container.
Booked (StatusId = 30): la compagnia di navigazione ha condiviso le informazioni sul viaggio relative a questa spedizione. Non è ancora salpato.
Loaded (StatusId = 35): la spedizione è caricata sulla nave ma la nave non è ancora salpata da POL.
Sailing (StatusId = 40): il container è in viaggio.
Arrived (StatusId = 45): la nave è arrivata al POD ma la spedizione è in attesa di essere scaricata
Discharged (StatusId = 50): il contenitore è stato scaricato alla porta di scarico.
Untracked (StatusId = 60): non è possibile tracciare il container perché la compagnia di navigazione responsabile del trasporto del container non dispone di un servizio di tracciamento online
Dopo che la tua richiesta di tracciamento ci ha raggiunto, il nostro sistema controlla il sito Web del vettore per compilare il modulo XML.
1. Se il tuo sistema chiama i dati prima che il sistema raccolga i dati dal sito Web del vettore, puoi avere una risposta dati vuota. Molto probabilmente, al secondo tentativo di chiamata, avrai i dati.
2. Se il vettore non fornisce ancora i dati del viaggio, la risposta XML sarà semplicemente vuota. Tuttavia, il nostro sistema controlla il sito Web del corriere 3 volte al giorno e riceve i dati quando è pronto. Quello che dovresti fare è impostare la tua chiamata GET in modo che venga eseguita 3 volte al giorno e, alla fine della giornata, avrai tutti i dati disponibili. Lo stato di questo tipo di dati è "In Progress".
3. A volte, tuttavia, le spedizioni non sono affatto tracciabili. Lo stato di questo tipo di spedizione è "Untracked". La spedizione può non essere tracciabile se la linea di spedizione non dispone di alcun sistema di tracciabilità o se il numero del contenitore non può essere assegnato a nessuna linea di spedizione.
Esempio di dati completi XML: https://drive.google.com/file/d/1_yHhrFHOMcBBjGUgWgAH53oxGoiNEZze/view?usp=sharing
Esempio di dati completi JSON: https://drive.google.com/file/d/167S4Ljoo_Op8u3J5k74c-_5In2hGUbOt/view?usp=sharing
Sfortunatamente, la nostra API attuale ti consente di interrogare ogni spedizione separatamente.
Per ottenere i dati da ShipsGo, inizialmente, devi inviare i dati al nostro sistema utilizzando la funzione POST della nostra API. Dopo il post, la tua richiesta dovrebbe pervenirci con successo. Quindi puoi estrarre i dati del viaggio con il metodo GET dell'API.
Se i tuoi dati ci raggiungono correttamente, viene restituito un ID richiesta come risposta. Questi ID sono univoci per ogni tua richiesta di tracciamento e differiscono da spedizione a spedizione. La funzione più importante di questo ID è che quando ottieni questo ID, sarai già sicuro che il tuo POST ci ha raggiunto con successo. È un messaggio di conferma da ShipsGo, per così dire.
Esempio di ID risposta riuscita 1-534567
Tuttavia, il tuo POST non è riuscito se ricevi le seguenti risposte invece di request-id. È necessario correggere i dati in base alle spiegazioni e inviare nuovamente la richiesta.
Risposta: "The Field (Code) Value (test1234) is not in a valid format"
Il numero del contenitore deve essere composto da 11 caratteri: 4 lettere seguite da 7 numeri EX. AAAA1234567
Risposta: "The Field (Code) Value (EGHU9483781) is not valid"
Il formato del numero del contenitore è vero, tuttavia il numero non è valido. Sarebbe EGHU948378-8 a causa delle regole di creazione del numero di contenitore
Risposta: "The shipping line field is required"
È necessario inserire il nome della linea di spedizione in base all'elenco delle linee di spedizione ShipsGo
Risposta: "The Entered Value (support@gmaıl.com) In Field (Email) Is Not A Valid Email Address"
Hai sbagliato a digitare l'indirizzo email. Si prega di controllare la digitazione
Risposta: "No Active Subscription Or It Is Expire"
Probabilmente i tuoi crediti si sono esauriti o il tuo account era inattivo per qualche altro motivo. Si prega di contattare il team ShipsGo quando è successo
Dopo aver completato correttamente il POST, puoi eseguire il metodo GET seguendo le regole. Potresti incontrare alcuni messaggi di errore durante l'esecuzione di GET. Eccoli e il loro significato:
Messaggio di errore: "Invalid Authentication Code"
Stai utilizzando una chiave API non valida o il tuo account non può utilizzare la connessione API
Messaggio di errore: "No Active Subscription Or It Is Expire"
Probabilmente i tuoi crediti si sono esauriti o il tuo account era inattivo per qualche altro motivo.
Messaggio di errore: "There Are No Data Related To Requested Id"
Stai inserendo il numero del container/ID della richiesta errato. Oppure cerchi di ottenere i dati del container di cui non ci hai POST la richiesta di tracciamento.
Puoi trovare tutti i dettagli sulle pietre miliari qui.
No. L'unica cosa che devi fare è inviare il numero BL. Il sistema attiverà i container sotto il BL con i dati di viaggio e li renderà pronti in XML/JSON.
Ogni spedizione viene aggiornata ogni 8 ore dopo l'ora di creazione, quindi il tempo di aggiornamento varia da spedizione a spedizione in base all'ora di creazione. Tuttavia, puoi impostare la funzione GET 3 volte al giorno mattina, mezzogiorno e sera. Quindi, alla fine della giornata, avrai tutti gli aggiornamenti per tutte le tue spedizioni
Quando pubblichi la spedizione su ShipsGo, ricevi un ID richiesta se il POST va a buon fine. Dopo aver ottenuto l'ID richiesta, puoi effettuare una chiamata immediatamente. Avrai una risposta. Tuttavia, i dati potrebbero non essere disponibili in quel momento e il file XML potrebbe essere nullo perché la disponibilità dei dati è a carico del vettore. Se i dati sono disponibili sul sito Web dell'operatore, il tempo medio di risposta è in secondi.
Se desiderate disattivare la barra di ricerca della soluzione Live Map che state utilizzando sui vostri siti web, potete utilizzare i codici iframe riportati di seguito.
<iframe
src="http://shipsgo.com/iframe/where-is-my-container/TEST1234567?tags=hide-search-box"
id="IframeShipsgoLiveMap"
style="height: 550px;width: 100%;"></iframe>
<script>
if (window.addEventListener)
window.addEventListener("message", ShipsgoMessagesListener);
function ShipsgoMessagesListener() {
if (event.data.Action === "LoadNewContainerCode")
document.getElementById("IframeShipsgoLiveMap").src =
"http://shipsgo.com/iframe/where-is-my-container/" +
event.data.Parameters.ContainerCode + '?tags=hide-search-box';
}
var urlParams = new URLSearchParams(window.location.search);
var defaultQuery = urlParams.get('query');
if (defaultQuery === undefined || defaultQuery === null)
defaultQuery = "default-container-code";
document.getElementById("IframeShipsgoLiveMap").src =
"http://shipsgo.com/iframe/where-is-my-container/" +
defaultQuery + '?tags=hide-search-box';
</script>
Nota importante: se si desidera nascondere sia la barra di ricerca che la finestra dei movimenti, è possibile farlo; basta applicare entrambe le soluzioni al codice.
Se desiderate disattivare la finestra dei movimenti sulla soluzione Live Map che state utilizzando sui vostri siti web, potete utilizzare i codici seguenti.
<iframe
src="http://shipsgo.com/iframe/where-is-my-container/TEST1234567?movements=hide"
id="IframeShipsgoLiveMap"
style="height: 550px;width: 100%;"></iframe>
<script>
if (window.addEventListener)
window.addEventListener("message", ShipsgoMessagesListener);
function ShipsgoMessagesListener() {
if (event.data.Action === "LoadNewContainerCode")
document.getElementById("IframeShipsgoLiveMap").src =
"http://shipsgo.com/iframe/where-is-my-container/" +
event.data.Parameters.ContainerCode + '?movements=hide';
}
var urlParams = new URLSearchParams(window.location.search);
var defaultQuery = urlParams.get('query');
if (defaultQuery === undefined || defaultQuery === null)
defaultQuery = "default-container-code";
document.getElementById("IframeShipsgoLiveMap").src =
"http://shipsgo.com/iframe/where-is-my-container/" +
defaultQuery + '?movements=hide';
</script>
Nota importante: se si desidera nascondere sia la barra di ricerca che la finestra dei movimenti, è possibile farlo; basta applicare entrambe le soluzioni al codice.
Se volete disattivare la finestra dei movimenti e la barra di ricerca che si trovano sulla Live Map che state utilizzando sui vostri siti web, potete utilizzare i codici seguenti.
<iframe
src="http://shipsgo.com/iframe/where-is-my-container/TEST1234567?movements=hide&tags
=hide-search-box" id="IframeShipsgoLiveMap"
style="height: 550px;width: 100%;"></iframe>
<script>
if (window.addEventListener)
window.addEventListener("message", ShipsgoMessagesListener);
function ShipsgoMessagesListener() {
if (event.data.Action === "LoadNewContainerCode")
document.getElementById("IframeShipsgoLiveMap").src =
"http://shipsgo.com/iframe/where-is-my-container/" +
event.data.Parameters.ContainerCode +
'?movements=hide&tags=hide-search-box';
}
var urlParams = new URLSearchParams(window.location.search);
var defaultQuery = urlParams.get('query');
if (defaultQuery === undefined || defaultQuery === null)
defaultQuery = "default-container-code";
document.getElementById("IframeShipsgoLiveMap").src =
"http://shipsgo.com/iframe/where-is-my-container/" +
defaultQuery + '?movements=hide&tags=hide-search-box';
</script>