Track API
Introduzione
Il numero di monitoraggio è un numero univoco assegnato a ogni collo, che permette di monitorare il movimento di un collo tra Paesi o anche all'interno di un Paese. Le opzioni di monitoraggio FedEx forniscono informazioni di monitoraggio accurate e tempestive per le spedizioni FedEx Express®, FedEx Ground®, FedEx Home Delivery®, FedEx Freight® e FedEx Ground® Economy (in precedenza noto come FedEx SmartPost®).
Dettagli dell'API Track (Monitoraggio)
Le opzioni di monitoraggio FedEx vi indicano la posizione delle spedizioni. Potete richiedere di riceve sul vostro indirizzo email o sul cellulare vari tipi di notifiche di monitoraggio.
Potete inoltre seguire lo stato delle spedizioni utilizzando un numero di riferimento, come il numero dell'ordine di acquisto (PO), il riferimento del cliente, la fattura, la polizza di carico (BOL), il codice articolo o il numero di controllo del trasporto (TCN). Per effettuare il monitoraggio utilizzando un elemento diverso da un numero di monitoraggio è necessario indicare il codice cliente del mittente e un contenuto di monitoraggio sicuro.
Approfittate degli aggiornamenti dettagliati sullo stato delle spedizioni, delle capacità di ricerca e di altri strumenti che vi aiutano a gestire le spedizioni.
- Monitorate fino a 30 numeri di monitoraggio di spedizioni/ordini FedEx Express, FedEx Ground, FedEx Home Delivery, FedEx Freight, FedEx Ground® Economy e FedEx Office.
- Inviate richieste di notifica e ricevete notifiche sullo stato di spedizioni/ordini via email.
- Esaminate gli aggiornamenti dello stato in un calendario o in un elenco in modo che la vostra pianificazione sia più efficiente.
- Filtrate per numero di riferimento, data di spedizione, nome dell'azienda e altre variabili.
- Visualizzate la stampa o inviate tramite email documenti di prova di consegnata firmata FedEx. Anche se la firma non è disponibile, potrete sempre visualizzare/stampare d inviare tramite email o fax i dati disponibili relativi alla prova di consegna. L'opzione fax non è disponibile per più richieste di prova di consegna firmata.
- Richiedete che un collo idoneo al servizio sia trattenuto per il ritiro presso una filiale FedEx (solo negli USA).
- Monitorate il programma di consegna del collo, ovvero se la consegna avverrà nei tempi previsti, in anticipo o se ci sono eventuali ritardi, con i dettagli
Metodi di monitoraggio FedEx
Per aiutarvi a effettuare spedizioni in tutta tranquillità, FedEx vi fornisce varie modalità per monitorare la posizione approssimativa delle spedizioni.
Di seguito vengono indicati i metodi di monitoraggio.
Monitorare tramite il numero di monitoraggio
Questa opzione si applica alle spedizioni FedEx Express, FedEx Ground e FedEx Ground® Economy (in precedenza noto come FedEx SmartPost®). Con questo metodo potete monitorare qualsiasi collo spedito da FedEx.
Potete inserire qualsiasi combinazione di numeri di monitoraggio FedEx Express, FedEx Ground, FedEx Home Delivery, FedEx Ground® Economy, o FedEx Custom Critical®, fino a un massimo di 30. Controllate di avere inserito un solo numero di monitoraggio per riga.
Nota: il servizio FedEx Ground® è disponibile solo negli Stati Uniti e in Canada. I servizi FedEx Home Delivery, FedEx Ground® Economy e FedEx Custom Critical sono disponibili solo negli Stati Uniti.
Monitorare per numero di avviso di tentata consegna
Questa opzione è disponibile per spedizioni FedEx Express e FedEx Ground in USA e Canada. Consente di monitorare lo stato della spedizione utilizzando il numero dell'avviso di tentata consegna FedEx. Tale avviso viene lasciato all'indirizzo del destinatario qualora sia assente quando viene consegnato il collo. In FedEx l'avviso di tentata consegna è collegato al numero di monitoraggio originale del collo.
Questa modalità permette di effettuare il monitoraggio utilizzando unicamente il numero dell'avviso di tentata consegna senza richiedere il numero di monitoraggio associato. Non vengono richiesti ulteriori elementi di ricerca. Con il numero di avviso di tentata consegna potete richiedere informazioni di monitoraggio per qualsiasi collo spedito da FedEx.
I numeri degli avvisi di tentata consegna iniziano con le lettere "DT", seguite da 12 numeri. Per ottenere maggiori dettagli potete inserire nella richiesta più di un numero di avviso di tentata consegna, fino a un massimo di 30 alla volta, inserendone uno per riga.
Monitorare tramite il numero d'ordine di FedEx Office
Potete inserire un massimo di 30 numeri d'ordine FedEx Office contemporaneamente, facendo attenzione a inserirne uno solo per riga. Non sono ammessi trattini e spazi tra i numero d'ordine.
Nota: gli ordini FedEx Office sono disponibili solo negli Stati Uniti.Quando il monitoraggio è effettuato tramite un elemento diverso dal numero di monitoraggio, si parla di monitoraggio per numero di riferimento. Può essere considerato un numero di riferimento: il numero dell'ordine di acquisto (PO), il riferimento cliente, la fattura, la polizza di carico (BOL, Bill of Lading) o il codice articolo. Questa opzione si applica a FedEx Express, FedEx Ground, e FedEx Ground® Economy.
Nota: i numeri di avviso di tentata consegna sono disponibili solo negli Stati Uniti e in Canada.
Monitorare tramite il numero di riferimento
Quando il monitoraggio è effettuato tramite un elemento diverso dal numero di monitoraggio, si parla di monitoraggio per numero di riferimento. Può essere considerato un numero di riferimento: il numero dell'ordine di acquisto (PO), il riferimento cliente, la fattura, la polizza di carico (BOL, Bill of Lading), il numero del pezzo. Questa opzione si applica a FedEx Express, FedEx Freight, FedEx Ground, e FedEx Ground® Economy.
Monitoraggio attraverso Transportation Control Number (TCN)
Monitorate gli ordini del governo inserendo il numero TCN (Transportation Control Number).
Nota: non fate precedere il numero da alcuno spazio né dalle lettere "TCN".
Richiesta di prova di consegna firmata (SPOD)
Utilizzate questa opzione per ottenere un'immagine della firma del destinatario (se disponibile) dopo che la spedizione è stata consegnata. L'opzione è disponibile per spedizioni FedEx Express e FedEx Ground fino a 16 mesi dalla data di consegna. Oltre all'immagine della firma sono incluse le informazioni sulla spedizione associate. L’immagine della firma e le informazioni aggiuntive sul destinatario potrebbero non essere disponibili per tutti i Paesi, il che è indicato nella SPOD se del caso.
L'informazione sulla prova di consegna firmata (SPOD) sarà presentata con un array di byte al posto di un'immagine. L'array di byte è una stringa codificata base64 che deve essere decodificata per avere l'immagine della firma definitiva in formato PDF o PNG.
Monitorare tramite il numero di monitoraggio di spedizioni multiple
Questa opzione è disponibile per FedEx Express U.S. e spedizioni multicollo (MPS) internazionali, spedizioni FedEx Ground U.S. e spedizioni multicollo internazionali, spedizioni multicollo FedEx Express International C.O.D., FedEx Freight e spedizioni multicollo FedEx International C.O.D.
L'opzione MPS (multi-piece shipment, spedizione multicollo) vi consente di monitorare tramite il numero di monitoraggio principale della spedizione oppure tramite uno dei numeri di monitoraggio secondari associati a quello principale.
- Il monitoraggio per numero di monitoraggio principale restituisce i dati di monitoraggio di tutti i numeri di monitoraggio secondari associati.
- Il monitoraggio tramite il numero di monitoraggio secondario restituisce i dettagli specifici del collo ad esso associato.
Per monitorare spedizioni multicollo, utilizzate il numero di monitoraggio principale e impostate Package Identifier Type su STANDARD_MPS.
Come funziona l'API Track
L'API Track fornisce le seguenti opzioni per monitorare attivamente le spedizioni.
Monitorare tramite il numero di monitoraggio
Questa opzione può essere utilizzata in vari servizi di spedizione per monitorare i colli in base al numero di monitoraggio o all'avviso di tentata consegna (numero di Door Tag) o al numero di ordine FedEx Office per vari servizi di spedizione.
Le informazioni di input chiave associate a questa richiesta sono le seguenti.
- Numero di monitoraggio (sono consentiti al massimo 30 numeri di monitoraggio)
- Scansioni dettagliate da includere (True/False)
L'esito di questa richiesta fornisce i risultati di monitoraggio per tutti i numeri di monitoraggio inseriti insieme a informazioni chiave come stato più recente, ultimo aggiornamento della destinazione/posizione, distanza dalla destinazione, qualsiasi dettaglio in merito a un'eventuale gestione speciale, eventi di scansione e informazioni di reso in caso di spedizione di reso.
Monitorare tramite i riferimenti
Potete utilizzare questa opzione per monitorare i colli in base a riferimenti alternativi diversi dal numero di monitoraggio, come i numeri di riferimento del cliente, ecc.
Le informazioni di input chiave associate a questa richiesta sono le seguenti.
- Tipo di riferimento e valore correlato (BILL OF LADING, CUSTOMER_REFERENCE, INVOICE, PURCHASE_ORDER)
- Codice Cliente FedEx
- Scansioni dettagliate da includere (True/False)
L'esito di questa richiesta fornisce i risultati di monitoraggio per tutti i numeri di riferimento inseriti insieme a informazioni chiave come informazioni dettagliate di monitoraggio, stato più recente, ultimo aggiornamento della destinazione/posizione, distanza dalla destinazione, qualsiasi dettaglio in merito a un'eventuale gestione speciale, eventi di scansione e informazioni di reso in caso di spedizione di reso.
Monitoraggio attraverso Transportation Control Number (TCN)
Questa opzione può essere utilizzata per monitorare i colli in base al numero di controllo del monitoraggio.
Le informazioni di input chiave associate a questa richiesta sono le seguenti.
- Numero di controllo del trasporto (N552428361Y555XXX) – Per ogni richiesta è possibile immettere sono 1 TCN.
- Scansioni dettagliate da includere (True/False)
L'esito di questa richiesta fornisce i risultati di monitoraggio per il numero di controllo del monitoraggio inserito insieme a informazioni chiave come informazioni dettagliate di monitoraggio, stato più recente, ultimo aggiornamento della destinazione/posizione, distanza dalla destinazione, qualsiasi dettaglio in merito a un'eventuale gestione speciale, eventi di scansione e informazioni di reso in caso di spedizione di reso.
Monitorare spedizioni multicollo
Potete utilizzare questa opzione per monitorare spedizioni multicollo, spedizioni multicollo di gruppo o una spedizione in uscita correlata a una spedizione di reso.
Le informazioni di input chiave associate a questa richiesta sono le seguenti.
- Numero di monitoraggio principale
- Tipo di spedizione associata – Spedizione multicollo, spedizione multicollo di gruppo o spedizione in uscita correlata a una spedizione di reso (esempio: STANDARD_MPS)
- Scansioni dettagliate da includere (True/False)
L'esito di questa richiesta fornisce i risultati di monitoraggio per il numero di monitoraggio principale insieme a informazioni chiave come informazioni dettagliate di monitoraggio, stato più recente, ultimo aggiornamento della destinazione/posizione, distanza dalla destinazione, qualsiasi dettaglio in merito a un'eventuale gestione speciale, eventi di scansione e informazioni di reso in caso di spedizione di reso.
Documento di monitoraggio
Potete utilizzare questa opzione per richiedere uno qualsiasi dei seguenti documenti:
- Prova di consegna firmata (SPOD)
- Polizza di carico (BOL)
- Fattura spedizioni di merci pesanti o voluminose -Freight (FBD)
Le informazioni di input chiave associate a questa richiesta sono le seguenti.
- Tipo di documento (SIGNATURE_PROOF_OF_DELIVERY, BILL_OF_LADING or FREIGHT_BILLING_DOCUMENT)
- Numero di monitoraggio
- Formato del documento (PDF/PNG)
Se avete selezionato SPOD come tipo di documento, riceverete l'immagine della firma del destinatario (se la firma è disponibile) una volta che la spedizione è stata consegnata.
Se avete selezionato BOL come tipo di documento, riceverete un documento contenente i dettagli della vostra spedizione e il contratto di trasporto con Termini e Condizioni.
Se avete selezionato FBD come tipo di documento, riceverete la fattura della spedizione.
Inviare notifiche
Potete utilizzare questa opzione per impostare e personalizzare le notifiche degli eventi di monitoraggio di una spedizione.
Utilizzatela per far sì che FedEx notifichi automaticamente a voi e/o al vostro cliente e/o a un'altra terza parte via email gli eventi significativi della spedizione, come ritardi per operazioni di sdoganamento, tentativi di consegna, consegne e pre-avvisi.
FedEx invia notifiche via email per creazione della spedizione, consegna stimata, consegna presentata, qualsiasi eccezione e consegna.
Potete specificare gli indirizzi di posta elettronica dei destinatari nella richiesta di spedizione e utilizzare uno o tutti questi tipi di notifica se desiderate che i destinatari ricevano una notifica via email. Questa opzione si applica a FedEx Express, FedEx Freight, FedEx Ground, e FedEx Ground® Economy. FedEx offre inoltre una nuova notifica via email per consegna stimata che attiva un'email alla data di consegna.
Le informazioni di input chiave associate a questa richiesta sono le seguenti.
- Nome del mittente
- Eventi di notifica (ON_DELIVERY, ON_ESTIMATED_DELIVERY, ON_EXCEPTION, ON_TENDER.)
- Numero di monitoraggio
L'esito positivo di questa richiesta imposta le notifiche in merito agli eventi indicati che saranno inviate all'indirizzo di posta elettronica indicato al momento in cui si verifica l'evento.
Risultati sintetici del monitoraggio
Quando si monitorano più spedizioni contemporaneamente, la schermata dei risultati sintetici mostra data/ora, stato, destinazione per le spedizioni FedEx e/o numero d'ordine, stato dell'ordine, data/ora per gli ordini FedEx Office.
Per ottenere i dettagli del monitoraggio della spedizione, inviate la richiesta di monitoraggio con il numero di monitoraggio e/o il numero d'ordine FedEx.
Potete inoltre ottenere tramite email le lettere della prova di consegna firmata per tutte le spedizioni FedEx Express, FedEx Ground e FedEx Freight già consegnate e da voi selezionate. Vogliate notare che la prova di consegna firmata non è disponibile per le spedizioni FedEx Ground® Economy.
Monitoraggio del programma di consegna (in orario/ritardato)
È possibile ottenere in tempo reale le stime relative al programma di consegna della spedizione singola/multicollo, come ritardi nella consegna, puntualità e consegna anticipata. Ciò si applica quando si monitorano i colli per numero di monitoraggio, per numero di riferimento o codice di controllo del monitoraggio (TCN).
Se la consegna di un collo rientra nei tempi previsti o dovrebbe avvenire in anticipo, allora l'elemento di risposta di tracciamento trackResults\scanEvents\delayDetail\status avrà valore ON_TIME e EARLY, rispettivamente.
Se i vostri colli sono in ritardo per qualsiasi motivo, la risposta di monitoraggio fornirà i dettagli del ritardo richiesti (se presenti) e il motivo. In questo caso, l'elemento di risposta di monitoraggio trackResults\scanEvents\delayDetail\status avrà valore DELAYED insieme alla categoria di ritardo (tipo) che ne è la causa, come WEATHER (meteo) e una categoria di ritardo aggiuntiva (subType) come ad esempio dovuto a SNOW (neve).
Finestra oraria della consegna stimata FedEx
La finestra oraria della consegna stimata FedEx aiuta i destinatari a pianificare i loro programmi fornendo un intervallo di tempo per le consegne delle spedizioni basato sui dati storici delle spedizioni consegnate nella località richiesta dal cliente.
Nota: Il tempo di consegna stimato può variare in base a determinate località di consegna.
Le finestre orarie della consegna stimata FedEx sono disponibili per le seguenti regioni e società operative:
- Regioni: colli destinati ai seguenti Paesi:
- USA
- Canada
- Belgio
- Germania
- Paesi Bassi
- Società operative: I seguenti sono i servizi che forniscono la funzionalità di finestra oraria di consegna stimata:
- FedEx Express
- FedEx Ground
- Servizi FedEx Home Delivery (FHD)
Nota: i dettagli relativi alla finestra oraria della consegna stimata FedEx non sono disponibili per tutti i numeri di monitoraggio a causa di vari motivi e gestione dei colli, quali: Richiesta di appuntamento, Data certa o Consegna serale per spedizioni FHD o modifica della consegna con l'opzione di fermo deposito FedEx (HAL) per il ritiro presso il più vicino centro autorizzato FedEx Ship Center (FASC), Ship Center con personale FedEx (solo colli Express), FedEx Office e sedi FedEx OnSite. Contattate il vostro referente Commerciale FedEx per maggiori informazioni.
Informazioni tecniche relative alla finestra oraria della consegna stimata FedEx:
Nessun input specifico da includere nelle richieste di monitoraggio poiché la maggior parte dei numeri di tracciamento restituirà informazioni relative alla finestra oraria della consegna stimata FedEx in base agli eventi di spedizione.
Le seguenti informazioni nell'output/risposta del monitoraggio possono essere utilizzate per ottenere la finestra oraria della consegna stimata FedEx:
Dovreste usare gli elementi sottostanti nell'oggetto estimatedDeliveryTimeWindow restituito nella risposta di monitoraggio sotto output/completeTrackResults/trackResults:
· finestra/inizia – inizio EDTW data/intervallo di marcatura oraria. Esempio: '2019-05-07T08:00:07'
· finestra/termina – Fine EDTW data/intervallo di marcatura oraria. Esempio: '2019-05-15T15:00:07'
Vantaggi della finestra oraria della consegna stimata FedEx:
I seguenti sono i vantaggi della finestra oraria della consegna stimata FedEx:
- L'integrazione della soluzione di finestra oraria della consegna stimata FedEx riduce il tempo impiegato per la risoluzione dei ritardi di spedizione.
- Niente più tempi di attesa per le chiamate per richiedere informazioni sui tempi di consegna dei colli.
- Rischio ridotto di colli danneggiati e portata ristretta di eventuali furti.
Prova di consegna firmata
Dopo che la spedizione è stata consegnata e se si ottiene la firma, quest'ultima verrà restituita con la spedizione (a seconda della disponibilità) quando si effettua la richiesta attraverso monitoraggio protetto. Questa opzione è disponibile solo per spedizioni FedEx Express e FedEx Ground.
Per confermare che una spedizione è stata ricevuta e firmata, potete anche utilizzare la nostra opzione di prova di consegna firmata per ottenere questa lettera online, stamparla, inviarla tramite email o fax.
Ecco alcuni consigli utili.
- Differenza tra monitoraggio e prova di consegna firmata
Potete utilizzare il monitoraggio per controllare lo stato della vostra spedizione in qualsiasi momento, durante ed entro 90 giorni dalla data di consegna. Potete utilizzare l'opzione prova di consegna firmata per visualizzare un’immagine della firma del destinatario (se disponibile) dopo che la spedizione è stata consegnata.
- Disponibilità dei dati utili per la prova di consegna firmata
La prova di consegna firmata è disponibile per un massimo di 16 mesi per le spedizioni FedEx Express e FedEx Ground. Questo comprende l'immagine della firma e le informazioni sulla spedizione associate. L’immagine della firma e le informazioni aggiuntive sul destinatario potrebbero non essere disponibili per tutti i Paesi/territori. Questo verrà indicato nella prova di consegna firmata, laddove applicabile.
- Richieste di più prove di consegna firmate
Potete richiedere fino a 30 lettere di prova di consegna firmata contemporaneamente.
- Le lettere di prova di consegna firmata associate a varie richieste potrebbero richiedere un tempo d'elaborazione di alcuni minuti.
- Attenzione – L'opzione fax non è disponibile per varie richieste di prova di consegna firmata.
- Le lettere di prova di consegna firmata saranno fornite solo per le spedizioni consegnate. Per le spedizioni ancora in transito non saranno fornite finché queste non verranno consegnate.
Tipi di firma
Di seguito vengono indicati i tipi di firma e le caratteristiche supportate dalle spedizioni FedEx.
- Richiesta firma indiretta
FedEx fa firmare la persona presente all'indirizzo di consegna: un vicino, il custode o chi abita alla porta accanto; oppure il destinatario può lasciare un'autorizzazione di avviso di tentata consegna FedEx per la consegna della spedizione anche in sua assenza. Questa opzione è disponibile unicamente per la consegna a indirizzi privati.
- Richiesta firma diretta
FedEx richiede la firma di una persona presente all'indirizzo di consegna. Laddove non sia disponibile nessuno per la firma, FedEx proverà a riconsegnare il collo in un’altra data.
- Richiesta firma di un adulto
FedEx fa firmare qualcuno presente all'indirizzo di consegna che abbia almeno 18 anni (e sia in possesso del necessario documento d'identità con foto). Se non trova alcun destinatario idoneo all'indirizzo, riprova a effettuare la consegna.
- Nessuna firma richiesta
Anche se la firma non è disponibile, potrete sempre visualizzare/stampare e inviare tramite email o fax i dati disponibili relativi alla prova di consegna. Se dopo sette giorni lavorativi non è disponibile alcuna firma, contattate il Servizio Clienti FedEx. Vogliate notare che la firma potrebbe non essere disponibile anche se è stata apposta (il mittente o il destinatario ha firmato un accordo per il rilascio della firma).
- Sommario prova di consegna firmata
Potete ottenere una prova di consegna firmata con un riepilogo dei dati senza fornire il codice cliente FedEx a 9 cifre del mittente o del pagante. La lettera contiene alcune informazioni sulla spedizione, come la città, lo Stato/la provincia e il Paese del mittente e del destinatario. La visualizzazione della firma potrebbe non essere disponibile in tutti i Paesi. Questo verrà indicato nella lettera di prova di consegna firmata ladove applicabile.
- Dettagli della prova di consegna firmata
È possibile ottenere una prova di consegna firmata con informazioni dettagliate fornendo il codice cliente FedEx a 9 cifre o accedendo a fedex.com. Se il codice cliente FedEx o il vostro accesso corrisponde al mittente o a chi paga la spedizione, potrete visualizzare la prova di consegna firmata con i dati dettagliati, quali il nome del contatto, il nome della società, l'indirizzo, la città, lo Stato/la provincia, il CAP e il paese, sia per il mittente che per il destinatario (se disponibili).
Nota: l’immagine della firma e le informazioni aggiuntive sul destinatario potrebbero non essere disponibili per tutti i Paesi. Questo verrà indicato nella lettera di prova di consegna firmata laddove applicabile. - Destinatario
Potete aggiungere i dati del destinatario per la lettera della prova di consegna.
- Vostre note in merito alla spedizione
Potete aggiungere note personali relative a un numero di monitoraggio per ricordarvi alcuni dettagli importanti della spedizione. Le note sono visibili solo al mittente e possono essere utilizzate per effettuare ricerche di monitoraggio FedEx.
Monitorare tramite il numero di riferimento
Potete monitorare i colli tramite un numero di riferimento inserito durante l'operazione di spedizione.
Questa opzione si applica alle spedizioni FedEx Express, FedEx Freight e FedEx Ground. Potete monitorare i colli tramite un numero di riferimento inserito durante l'operazione di spedizione.
Per il monitoraggio tramite il numero di riferimento è possibile usare le seguenti fonti.
- Riferimento cliente/mittente
Nota: con una spedizione FedEx Express, FedEx Freight e FedEx Ground, il numero di riferimento del cliente è codificato come Shipper Reference (Riferimento mittente) e Customer Reference (Riferimento cliente). - Numero fattura
- PO
- Reparto (non disponibile per FedEx Ground® Economy)
- Numero del pezzo (non disponibile per FedEx Ground® Economy)
- Autorizzazione alla restituzione del prodotto (RMA) (non disponibile per FedEx Freight®)
- TCN (non disponibile per FedEx Freight e FedEx Ground® Economy)
- BOL (non disponibile per FedEx Ground® Economy)
Nota:
- Se nella richiesta inserite un numero di monitoraggio, questo ha sempre la precedenza su eventuali numeri di riferimento. Pertanto, se inserite un numero di monitoraggio per una spedizione che non include i dati di riferimento che avete richiesto, il numero di monitoraggio viene restituito senza alcun messaggio di errore. Per limitare il numero di risposte di monitoraggio per un riferimento specifico, potete inserire un intervallo di date per questa ricerca.
- Il codice cliente della spedizione non è richiesto, ma facilita il monitoraggio tramite riferimento. Se il codice cliente della spedizione non viene specificato, è necessario indicare il codice postale di destinazione e il codice Paese nonché l'intervallo di date di spedizione (data di inizio e di fine).
Riferimento con un codice cliente
Potete effettuare il monitoraggio tramite un codice cliente. Le informazioni minime per questa richiesta sono valore di riferimento, codice cliente, data di inizio e fine della spedizione. Saranno visualizzate tutte le spedizioni associate al Codice Cliente FedEx e ai riferimenti.
Riferimento senza un codice cliente
Potete effettuare il monitoraggio senza utilizzare un codice cliente. Le informazioni minime per questa richiesta sono valore di riferimento, destinationPostalCode, destinationCountryCode, data di inizio e fine della spedizione. Inserite la data di spedizione (+/- 15 giorni), il Paese e il codice postale di destinazione. Non tutti i Paesi hanno un codice postale. Per stabilire se occorre o meno un codice postale, selezionate prima il Paese di destinazione.
Nota: quando il monitoraggio è effettuato tramite il numero di riferimento e senza il Codice Cliente FedEx, sono visualizzate solo le corrispondenze univoche. Se per lo stesso numero di riferimento si ha più di un risultato, dovete selezionare un servizio FedEx prima di cliccare Rinvia tutto. Se non è stata trovata nessuna corrispondenza univoca, il sistema vi chiederà di inserire un Codice Cliente.
Monitoraggio spedizioni associate
FedEx offre pratiche informazioni di monitoraggio sullo stato delle spedizioni multicollo. Ciascuna spedizione di una spedizione multicollo è collegata alle altre come spedizione associata (monitorate lo stato di una spedizione e accederete alle informazioni su tutte le spedizioni associate dall'invio multicollo).
Numero di monitoraggio master: il primo numero di monitoraggio di una spedizione multicollo che associa tutti i numeri di monitoraggio della spedizione.
Monitorare lotti
Il servizio di monitoraggio lotti consente di inviare più numeri di monitoraggio per monitorare le spedizioni. Per gli elementi di richiesta e risposta sono necessarie informazioni aggiuntive sui lotti.
Ad esempio, per il monitoraggio dei lotti all'interno di una richiesta è possibile avere più occorrenze dell'elemento Request Selection Details. Il numero massimo di colli in una singola transazione di monitoraggio è 30.
Ogni livello di notifiche all'interno della nuova risposta di monitoraggio si presenta nel seguente modo.
- L'elemento Reply’s Notifications fornisce lo stato complessivo della transazione.
- L'elemento Reply’s Completed Tracking Details>>Notifications fornisce lo stato della singola richiesta di monitoraggio.
- L'elemento Reply’s Completed Tracking Details>>Tracking Details>>Notification fornisce lo stato del numero di monitoraggio specifico.
Nota:
- In caso di notifica di errore a livello di metodo (Reply>>Notifications), ignorate la risposta/il carico utile rimanente.
- In caso di notifica di errore a livello di singola notifica di risposta, ignorate la risposta/il carico utile rimanente.
Monitoraggio di colli internazionali
Il monitoraggio di colli internazionali è disponibile su richiesta. Potete inoltre monitorare lo stato delle spedizioni utilizzando un numero di riferimento, come il numero dell'ordine di acquisto (PO), il riferimento del cliente, la fattura, la polizza di carico (BOL), il codice articolo o il numero di controllo del trasporto (TCN). In tal caso per monitorare un collo vengono utilizzati elementi come il codice del vettore, le coordinate geografiche, la società operativa, l'identificativo del collo e così via.
Per monitorare i colli internazionali potete utilizzare uno dei seguenti metodi.
- L'opzione di monitoraggio tramite il numero di monitoraggio fornisce al cliente informazioni di monitoraggio in base al numero di monitoraggio per vari servizi di spedizione.
- L'opzione di monitoraggio tramite il numeri di controllo del monitoraggio restituisce informazioni di monitoraggio in base al numero di controllo del monitoraggio, Opco: FedEx Cargo, Custom Critical, Express e Ground Shipment.
- L'opzione di monitoraggio tramite numero di monitoraggio di spedizioni multiple vi consente di monitorare tramite il numero di monitoraggio principale o uno dei numeri di monitoraggio sequenziali associati per i colli child. Per monitorare spedizioni multicollo, utilizzate il numero di monitoraggio principale e impostate PackageIdentifier /Type su STANDARD_MPS.
- L'opzione di monitoraggio tramite riferimenti restituisce informazioni di monitoraggio in base a riferimenti alternativi diversi dal numero di monitoraggio, come i numeri di riferimento del cliente, ecc. In tal caso è necessario specificare shipper.AccountNumber o Destination.countryCode (e il codice postale per i Paesi che lo richiedono).
- Ordinate per documento per richiedere uno qualsiasi dei documenti seguenti: Prova di consegna firmata, Polizza di carico o Fattura spedizioni di merci pesanti o voluminose (Freight).
- L'opzione di monitoraggio tramite il numero di monitoraggio fornisce al cliente informazioni di monitoraggio in base al numero di monitoraggio per vari servizi di spedizione.
- L'opzione di monitoraggio tramite avviso di tentata consegna permette di monitorare lo stato delle spedizioni tramite un numero di avviso di tentata consegna FedEx. Tale avviso viene lasciato all'indirizzo del destinatario qualora sia assente quando viene consegnato il collo. Questa opzione è disponibile per spedizioni FedEx Express e FedEx Ground in USA e Canada.
Nota:
- Per effettuare il monitoraggio utilizzando un elemento diverso da un numero di monitoraggio è necessario indicare il codice cliente del mittente e un contenuto di monitoraggio sicuro.
- Le spedizioni FedEx Express supportano le spedizioni nazionali in Messico per la prova di consegna firmata (SPOD).
- La prova di consegna firmata (SPOD) per FedEx Express e FedEx Groundè disponibile per 16 mesi dalla data di spedizione.
Per monitorare il collo, è necessario disporre delle seguenti informazioni quando si chiama il Servizio Clienti FedEx.
- Numero della lettera di trasport aereo
- Data della spedizione
- Nome e indirizzo del destinatario
- Numero di colli e peso totale della spedizione
- Contenuto e valore della spedizione
- Il vostro nome e numero di telefono
Richiedere notifiche
FedEx fornisce pratiche email di notifica (solo testo o HTML) che potete utilizzare per informare fino a 4 destinatari. Potete anche aggiungere un messaggio personale facoltativo (non disponibile in caratteri diversi dall'inglese). I tipi di notifica includono quanto segue.
- Notifica dello stato attuale – Comunica i risultati dettagliati del monitoraggio corrente.
- FedEx ha ricevuto il collo – Avvisa quando una spedizione entra in possesso di FedEx.
- Si è verificata un'eccezione di consegna – Avvisa quando si verificano ritardi per operazioni di sdoganamento o un'eccezione di consegna (eventi imprevisti che potrebbero interrompere il movimento o la consegna del collo). In caso di ritardi per operazioni di sdoganamento, viene inviata un'altra notifica automatica nel momento in cui la spedizione internazionale viene sdoganata.
- Aggiornamenti sulla consegna stimata –Invia un promemoria il giorno prima della consegna programmata e il giorno della consegna. Avvisa anche quando FedEx aggiorna la data e/o l'ora di consegna programmata.
- La consegna è stata effettuata –Avvisa quando una spedizione è stata consegnata.
Regole aziendali
- Limitate il numero di numeri di monitoraggio in una singola richiesta di monitoraggio a 30. Ciò diminuirà la mole delle risposte e ridurrà il tempo di risposta della transazione.
- Limitate il numero di volte in cui un collo/ordine è monitorato a quelle necessarie per i bisogni aziendali.
- Per il monitoraggio di un lotto, rimuovete dal lotto ogni collo/ordine che ha restituito come stato di monitoraggio "consegnato".
- La mancanza di record di monitoraggio deriva solitamente dall'aver inserito un numero di monitoraggio/ordine errato fornito. Si consiglia di verificare con il mittente in caso di dubbi sul numero di monitoraggio/ordine. Tenete conto, inoltre, che occorrono fino a 24 ore perché un nuovo collo/ordine appaia nel sistema.
- Le informazioni di monitoraggio sono disponibili fino a 90 giorni dopo la consegna per FedEx Express, FedEx Ground e FedEx Custom Critical.
- Per effettuare il monitoraggio tramite riferimento è necessario il codice cliente, il codice postale di destinazione o i dettagli del Paese.
- La data di consegna stimata verrà fornita solo dopo la consegna del collo a FedEx.
Ritiro API JSON
Track API (1.0.0)
Track Multiple Piece Shipment
This endpoint returns tracking information for multiplee piece shipments, Group MPS, or an outbounddd shipment which is linked to a return shipment.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- Full_Schema_Multiple_Piece_Shipment
- Minimum_Payload_Track_Multiple_Piece_Shipment
includeDetailedScans | boolean Indicates if detailed scans are requested or not. |
masterTrackingNumberInfo required | object (MasterTrackingInfo) The detailed master tracking details for the shipment to be tracked. |
associatedType required | string Enum: "OUTBOUND_LINK_TO_RETURN" "STANDARD_MPS" "GROUP_MPS" The associated shipment type, such as MPS, Group MPS, or an outbound shipment which is linked to a return shipment. |
pagingDetails | object (PagingDetails) The details about how to retrieve the subsequent pages when there is more than one page in the TrackReply. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "includeDetailedScans": true,
- "associatedType": "STANDARD_MPS",
- "masterTrackingNumberInfo": {
- "shipDateEnd": "2018-11-03",
- "shipDateBegin": "2018-11-01",
- "trackingNumberInfo": {
- "trackingNumberUniqueId": "245822~123456789012~FDEG",
- "carrierCode": "FDXE",
- "trackingNumber": "858488600850"
- "pagingDetails": {
- "resultsPerPage": 56,
- "pagingToken": "38903279038"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "completeTrackResults": [
- {
- "trackingNumber": "123456789012",
- "trackResults": [
- {
- "trackingNumberInfo": {
- "trackingNumber": "128667043726",
- "carrierCode": "FDXE",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "additionalTrackingInfo": {
- "hasAssociatedShipments": false,
- "nickname": "shipment nickname",
- "packageIdentifiers": [
- {
- "type": "SHIPPER_REFERENCE",
- "value": "ASJFGVAS",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "shipmentNotes": "shipment notes"
- "distanceToDestination": {
- "units": "KM",
- "value": 685.7
- "consolidationDetail": [
- {
- "timeStamp": "2020-10-13T03:54:44-06:00",
- "consolidationID": "47936927",
- "reasonDetail": {
- "description": "Wrong color",
- "type": "REJECTED"
- "packageCount": 25,
- "eventType": "PACKAGE_ADDED_TO_CONSOLIDATION"
- "meterNumber": "8468376",
- "returnDetail": {
- "authorizationName": "Sammy Smith",
- "reasonDetail": [
- {
- "description": "Wrong color",
- "type": "REJECTED"
- "serviceDetail": {
- "description": "FedEx Freight Economy.",
- "shortDescription": "FL",
- "type": "FEDEX_FREIGHT_ECONOMY"
- "destinationLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationType": "FEDEX_SHIPSITE"
- "latestStatusDetail": {
- "scanLocation": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "code": "PU",
- "derivedCode": "PU",
- "ancillaryDetails": [
- {
- "reason": "15",
- "reasonDescription": "Customer not available or business closed",
- "action": "Contact us at <http://www.fedex.com/us/customersupport/call/index.html> to discuss possible delivery or pickup alternatives.",
- "actionDescription": "Customer not Available or Business Closed"
- "statusByLocale": "Picked up",
- "description": "Picked up",
- "delayDetail": {
- "type": "WEATHER",
- "subType": "SNOW",
- "status": "DELAYED"
- "serviceCommitMessage": {
- "message": "No scheduled delivery date available at this time.",
- "type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
- "informationNotes": [
- {
- "code": "CLEARANCE_ENTRY_FEE_APPLIES",
- "description": "this is an informational message"
- "error": {
- "code": "TRACKING.TRACKINGNUMBER.EMPTY",
- "parameterList": [
- {
- "value": "value",
- "key": "key"
- "message": "Please provide tracking number."
- "specialHandlings": [
- {
- "description": "Deliver Weekday",
- "type": "DELIVER_WEEKDAY",
- "paymentType": "OTHER"
- "availableImages": [
- {
- "size": "LARGE",
- "type": "BILL_OF_LADING"
- "deliveryDetails": {
- "receivedByName": "Reciever",
- "destinationServiceArea": "EDDUNAVAILABLE",
- "destinationServiceAreaDescription": "Appointment required",
- "locationDescription": "Receptionist/Front Desk",
- "actualDeliveryAddress": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "deliveryToday": false,
- "locationType": "APARTMENT_OFFICE",
- "signedByName": "Reciever",
- "officeOrderDeliveryMethod": "Courier",
- "deliveryAttempts": "0",
- "deliveryOptionEligibilityDetails": [
- {
- "option": "INDIRECT_SIGNATURE_RELEASE",
- "eligibility": "INELIGIBLE"
- "scanEvents": [
- {
- "date": "2018-02-02T12:01:00-07:00",
- "derivedStatus": "Picked Up",
- "scanLocation": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationId": "SEA",
- "locationType": "CUSTOMS_BROKER",
- "exceptionDescription": "Package available for clearance",
- "eventDescription": "Picked Up",
- "eventType": "PU",
- "derivedStatusCode": "PU",
- "exceptionCode": "A25",
- "delayDetail": {
- "type": "WEATHER",
- "subType": "SNOW",
- "status": "DELAYED"
- "dateAndTimes": [
- {
- "dateTime": "2007-09-27T00:00:00",
- "type": "ACTUAL_DELIVERY"
- "packageDetails": {
- "physicalPackagingType": "BARREL",
- "sequenceNumber": "45",
- "undeliveredCount": "7",
- "packagingDescription": {
- "description": "FedEx Pak",
- "type": "FEDEX_PAK"
- "count": "1",
- "weightAndDimensions": {
- "weight": [
- {
- "unit": "LB",
- "value": "22222.0"
- "dimensions": [
- {
- "length": 100,
- "width": 50,
- "height": 30,
- "units": "CM"
- "packageContent": [
- "wire hangers",
- "buttons"
- "contentPieceCount": "100",
- "declaredValue": {
- "currency": "USD",
- "value": 56.8
- "goodsClassificationCode": "goodsClassificationCode",
- "holdAtLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationType": "FEDEX_SHIPSITE"
- "customDeliveryOptions": [
- {
- "requestedAppointmentDetail": {
- "date": "2019-05-07",
- "window": [
- {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "description": "Redirect the package to the hold location.",
- "type": "REDIRECT_TO_HOLD_AT_LOCATION",
- "status": "HELD"
- "estimatedDeliveryTimeWindow": {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "pieceCounts": [
- {
- "count": "35",
- "description": "picec count description",
- "type": "ORIGIN"
- "originLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "recipientInformation": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "standardTransitTimeWindow": {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "shipmentDetails": {
- "contents": [
- {
- "itemNumber": "RZ5678",
- "receivedQuantity": "13",
- "description": "pulyurethane rope",
- "partNumber": "RK1345"
- "beforePossessionStatus": false,
- "weight": [
- {
- "unit": "LB",
- "value": "22222.0"
- "contentPieceCount": "3333",
- "splitShipments": [
- {
- "pieceCount": "10",
- "statusDescription": "status",
- "timestamp": "2019-05-07T08:00:07",
- "statusCode": "statuscode"
- "reasonDetail": {
- "description": "Wrong color",
- "type": "REJECTED"
- "availableNotifications": [
- "ON_DELIVERY",
- "ON_EXCEPTION"
- "shipperInformation": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "lastUpdatedDestinationAddress": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
Send Notification
This endpoint helps you setup up, customize the tracking event notifications to be received for a shipment.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- Full_Schema_Notification
- Send_Shipment_Notifications
senderContactName required | string Placeholder for Sender contact name. |
senderEMailAddress required | string Email address of the sender from which the shipment notification will be sent. |
trackingEventNotificationDetail required | object (TrackingEventNotificationDetail) Object for holding tracking event Notification details. |
trackingNumberInfo required | object (TrackingNumberInfo) Information uniquely identifying a shipment such as Tracking number, ShipDate, and Tracking number uniqueId. |
shipDateBegin | string ShipDateBegin and ShipDateEnd are recommended to narrow the search, reduce lookup time, and avoid duplicates when searching for a specific tracking number in a specific time range. |
shipDateEnd | string ShipDateBegin and ShipDateEnd are recommended to narrow the search, reduce lookup time, and avoid duplicates when searching for a specific tracking number in a specific time range. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "senderContactName": "Sam Smith",
- "senderEMailAddress": "Lsr1234@gmail.com",
- "trackingEventNotificationDetail": {
- "trackingNotifications": [
- {
- "notificationDetail": {
- "localization": {
- "languageCode": "en",
- "localeCode": "US"
- "emailDetail": {
- "emailAddress": "p1@fedex.com",
- "name": "Preethi"
- "notificationType": "HTML"
- "role": "SHIPPER",
- "notificationEventTypes": [
- "ON_DELIVERY",
- "ON_EXCEPTION",
- "ON_ESTIMATED_DELIVERY"
- "currentResultRequestedFlag": true
- "personalMessage": "Personal message content",
- "supportHTML": null
- "trackingNumberInfo": {
- "trackingNumber": "128667043726",
- "carrierCode": "FDXE",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "shipDateBegin": "2019-10-13",
- "shipDateEnd": "2019-10-31"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "TrackingNumberInfo": {
- "trackingNumber": "128667043726",
- "carrierCode": "FDXE",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "destinationAddress": {
- "classification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "recipientDetails": [
- [
- "[\"ON_ESTIMATED_DELIVERY\"]"
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
Track by References
This endpoint returns tracking information based on alternate references other than Tracking Number such as Customer reference numbers, etc.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- Full_Schema_Tracking_References
- Track_by_References_using_accountNumber
- Track_by_References_using_destination
referencesInformation required | object (ReferenceInformation) Specifies the reference details for the tracked shipment. The following rules apply |
includeDetailedScans | boolean Indicates if the detailed scans are being requested or not. If true, the detailed scans will be included in the response returned. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "referencesInformation": {
- "type": "BILL_OF_LADING",
- "value": "56754674567546754",
- "accountNumber": "XXX61073",
- "carrierCode": "FDXE",
- "shipDateBegin": "2019-02-13",
- "shipDateEnd": "2019-02-13",
- "destinationCountryCode": "US",
- "destinationPostalCode": "75063"
- "includeDetailedScans": "true"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "cxsErrors": [
- {
- "code": "TRACKING.TRACKINGNUMBER.EMPTY",
- "parameterList": [
- {
- "value": "value",
- "key": "key"
- "message": "Please provide tracking number."
- "completeTrackResults": [
- {
- "trackingNumber": "123456789012",
- "trackResults": [
- {
- "trackingNumberInfo": {
- "trackingNumber": "128667043726",
- "carrierCode": "FDXE",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "additionalTrackingInfo": {
- "hasAssociatedShipments": false,
- "nickname": "shipment nickname",
- "packageIdentifiers": [
- {
- "type": "SHIPPER_REFERENCE",
- "value": "ASJFGVAS",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "shipmentNotes": "shipment notes"
- "distanceToDestination": {
- "units": "KM",
- "value": 685.7
- "consolidationDetail": [
- {
- "timeStamp": "2020-10-13T03:54:44-06:00",
- "consolidationID": "47936927",
- "reasonDetail": {
- "description": "Wrong color",
- "type": "REJECTED"
- "packageCount": 25,
- "eventType": "PACKAGE_ADDED_TO_CONSOLIDATION"
- "meterNumber": "8468376",
- "returnDetail": {
- "authorizationName": "Sammy Smith",
- "reasonDetail": [
- {
- "description": "Wrong color",
- "type": "REJECTED"
- "serviceDetail": {
- "description": "FedEx Freight Economy.",
- "shortDescription": "FL",
- "type": "FEDEX_FREIGHT_ECONOMY"
- "destinationLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationType": "FEDEX_SHIPSITE"
- "latestStatusDetail": {
- "scanLocation": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "code": "PU",
- "derivedCode": "PU",
- "ancillaryDetails": [
- {
- "reason": "15",
- "reasonDescription": "Customer not available or business closed",
- "action": "Contact us at <http://www.fedex.com/us/customersupport/call/index.html> to discuss possible delivery or pickup alternatives.",
- "actionDescription": "Customer not Available or Business Closed"
- "statusByLocale": "Picked up",
- "description": "Picked up",
- "delayDetail": {
- "type": "WEATHER",
- "subType": "SNOW",
- "status": "DELAYED"
- "serviceCommitMessage": {
- "message": "No scheduled delivery date available at this time.",
- "type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
- "informationNotes": [
- {
- "code": "CLEARANCE_ENTRY_FEE_APPLIES",
- "description": "this is an informational message"
- "error": {
- "code": "TRACKING.TRACKINGNUMBER.EMPTY",
- "parameterList": [
- {
- "value": "value",
- "key": "key"
- "message": "Please provide tracking number."
- "specialHandlings": [
- {
- "description": "Deliver Weekday",
- "type": "DELIVER_WEEKDAY",
- "paymentType": "OTHER"
- "availableImages": [
- {
- "size": "LARGE",
- "type": "BILL_OF_LADING"
- "deliveryDetails": {
- "receivedByName": "Reciever",
- "destinationServiceArea": "EDDUNAVAILABLE",
- "destinationServiceAreaDescription": "Appointment required",
- "locationDescription": "Receptionist/Front Desk",
- "actualDeliveryAddress": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "deliveryToday": false,
- "locationType": "APARTMENT_OFFICE",
- "signedByName": "Reciever",
- "officeOrderDeliveryMethod": "Courier",
- "deliveryAttempts": "0",
- "deliveryOptionEligibilityDetails": [
- {
- "option": "INDIRECT_SIGNATURE_RELEASE",
- "eligibility": "INELIGIBLE"
- "scanEvents": [
- {
- "date": "2018-02-02T12:01:00-07:00",
- "derivedStatus": "Picked Up",
- "scanLocation": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationId": "SEA",
- "locationType": "CUSTOMS_BROKER",
- "exceptionDescription": "Package available for clearance",
- "eventDescription": "Picked Up",
- "eventType": "PU",
- "derivedStatusCode": "PU",
- "exceptionCode": "A25",
- "delayDetail": {
- "type": "WEATHER",
- "subType": "SNOW",
- "status": "DELAYED"
- "dateAndTimes": [
- {
- "dateTime": "2007-09-27T00:00:00",
- "type": "ACTUAL_DELIVERY"
- "packageDetails": {
- "physicalPackagingType": "BARREL",
- "sequenceNumber": "45",
- "undeliveredCount": "7",
- "packagingDescription": {
- "description": "FedEx Pak",
- "type": "FEDEX_PAK"
- "count": "1",
- "weightAndDimensions": {
- "weight": [
- {
- "unit": "LB",
- "value": "22222.0"
- "dimensions": [
- {
- "length": 100,
- "width": 50,
- "height": 30,
- "units": "CM"
- "packageContent": [
- "wire hangers",
- "buttons"
- "contentPieceCount": "100",
- "declaredValue": {
- "currency": "USD",
- "value": 56.8
- "goodsClassificationCode": "goodsClassificationCode",
- "holdAtLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationType": "FEDEX_SHIPSITE"
- "customDeliveryOptions": [
- {
- "requestedAppointmentDetail": {
- "date": "2019-05-07",
- "window": [
- {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "description": "Redirect the package to the hold location.",
- "type": "REDIRECT_TO_HOLD_AT_LOCATION",
- "status": "HELD"
- "estimatedDeliveryTimeWindow": {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "pieceCounts": [
- {
- "count": "35",
- "description": "picec count description",
- "type": "ORIGIN"
- "originLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "recipientInformation": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "standardTransitTimeWindow": {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "shipmentDetails": {
- "contents": [
- {
- "itemNumber": "RZ5678",
- "receivedQuantity": "13",
- "description": "pulyurethane rope",
- "partNumber": "RK1345"
- "beforePossessionStatus": false,
- "weight": [
- {
- "unit": "LB",
- "value": "22222.0"
- "contentPieceCount": "3333",
- "splitShipments": [
- {
- "pieceCount": "10",
- "statusDescription": "status",
- "timestamp": "2019-05-07T08:00:07",
- "statusCode": "statuscode"
- "reasonDetail": {
- "description": "Wrong color",
- "type": "REJECTED"
- "availableNotifications": [
- "ON_DELIVERY",
- "ON_EXCEPTION"
- "shipperInformation": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "lastUpdatedDestinationAddress": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable",
- "successful": true
Track by Tracking Control Number
Use this endpoint to return tracking information based on a Tracking Control Number.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- Full_Schema_TCN
- Minimum_Payload_Track_By_Tracking_Control_Number
tcnInfo required | object The information associated with the transportation control number. |
includeDetailedScans | boolean Indicates if detailed scans are requested or not. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "tcnInfo": {
- "value": "N552428361Y555XXX",
- "carrierCode": "FDXE",
- "shipDateBegin": "2019-02-13",
- "shipDateEnd": "2019-02-13"
- "includeDetailedScans": true
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "completeTrackResults": [
- {
- "trackingNumber": "123456789012",
- "trackResults": [
- {
- "trackingNumberInfo": {
- "trackingNumber": "128667043726",
- "carrierCode": "FDXE",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "additionalTrackingInfo": {
- "hasAssociatedShipments": false,
- "nickname": "shipment nickname",
- "packageIdentifiers": [
- {
- "type": "SHIPPER_REFERENCE",
- "value": "ASJFGVAS",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "shipmentNotes": "shipment notes"
- "distanceToDestination": {
- "units": "KM",
- "value": 685.7
- "consolidationDetail": [
- {
- "timeStamp": "2020-10-13T03:54:44-06:00",
- "consolidationID": "47936927",
- "reasonDetail": {
- "description": "Wrong color",
- "type": "REJECTED"
- "packageCount": 25,
- "eventType": "PACKAGE_ADDED_TO_CONSOLIDATION"
- "meterNumber": "8468376",
- "returnDetail": {
- "authorizationName": "Sammy Smith",
- "reasonDetail": [
- {
- "description": "Wrong color",
- "type": "REJECTED"
- "serviceDetail": {
- "description": "FedEx Freight Economy.",
- "shortDescription": "FL",
- "type": "FEDEX_FREIGHT_ECONOMY"
- "destinationLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationType": "FEDEX_SHIPSITE"
- "latestStatusDetail": {
- "scanLocation": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "code": "PU",
- "derivedCode": "PU",
- "ancillaryDetails": [
- {
- "reason": "15",
- "reasonDescription": "Customer not available or business closed",
- "action": "Contact us at <http://www.fedex.com/us/customersupport/call/index.html> to discuss possible delivery or pickup alternatives.",
- "actionDescription": "Customer not Available or Business Closed"
- "statusByLocale": "Picked up",
- "description": "Picked up",
- "delayDetail": {
- "type": "WEATHER",
- "subType": "SNOW",
- "status": "DELAYED"
- "serviceCommitMessage": {
- "message": "No scheduled delivery date available at this time.",
- "type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
- "informationNotes": [
- {
- "code": "CLEARANCE_ENTRY_FEE_APPLIES",
- "description": "this is an informational message"
- "error": {
- "code": "TRACKING.TRACKINGNUMBER.EMPTY",
- "parameterList": [
- {
- "value": "value",
- "key": "key"
- "message": "Please provide tracking number."
- "specialHandlings": [
- {
- "description": "Deliver Weekday",
- "type": "DELIVER_WEEKDAY",
- "paymentType": "OTHER"
- "availableImages": [
- {
- "size": "LARGE",
- "type": "BILL_OF_LADING"
- "deliveryDetails": {
- "receivedByName": "Reciever",
- "destinationServiceArea": "EDDUNAVAILABLE",
- "destinationServiceAreaDescription": "Appointment required",
- "locationDescription": "Receptionist/Front Desk",
- "actualDeliveryAddress": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "deliveryToday": false,
- "locationType": "APARTMENT_OFFICE",
- "signedByName": "Reciever",
- "officeOrderDeliveryMethod": "Courier",
- "deliveryAttempts": "0",
- "deliveryOptionEligibilityDetails": [
- {
- "option": "INDIRECT_SIGNATURE_RELEASE",
- "eligibility": "INELIGIBLE"
- "scanEvents": [
- {
- "date": "2018-02-02T12:01:00-07:00",
- "derivedStatus": "Picked Up",
- "scanLocation": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationId": "SEA",
- "locationType": "CUSTOMS_BROKER",
- "exceptionDescription": "Package available for clearance",
- "eventDescription": "Picked Up",
- "eventType": "PU",
- "derivedStatusCode": "PU",
- "exceptionCode": "A25",
- "delayDetail": {
- "type": "WEATHER",
- "subType": "SNOW",
- "status": "DELAYED"
- "dateAndTimes": [
- {
- "dateTime": "2007-09-27T00:00:00",
- "type": "ACTUAL_DELIVERY"
- "packageDetails": {
- "physicalPackagingType": "BARREL",
- "sequenceNumber": "45",
- "undeliveredCount": "7",
- "packagingDescription": {
- "description": "FedEx Pak",
- "type": "FEDEX_PAK"
- "count": "1",
- "weightAndDimensions": {
- "weight": [
- {
- "unit": "LB",
- "value": "22222.0"
- "dimensions": [
- {
- "length": 100,
- "width": 50,
- "height": 30,
- "units": "CM"
- "packageContent": [
- "wire hangers",
- "buttons"
- "contentPieceCount": "100",
- "declaredValue": {
- "currency": "USD",
- "value": 56.8
- "goodsClassificationCode": "goodsClassificationCode",
- "holdAtLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationType": "FEDEX_SHIPSITE"
- "customDeliveryOptions": [
- {
- "requestedAppointmentDetail": {
- "date": "2019-05-07",
- "window": [
- {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "description": "Redirect the package to the hold location.",
- "type": "REDIRECT_TO_HOLD_AT_LOCATION",
- "status": "HELD"
- "estimatedDeliveryTimeWindow": {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "pieceCounts": [
- {
- "count": "35",
- "description": "picec count description",
- "type": "ORIGIN"
- "originLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "recipientInformation": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "standardTransitTimeWindow": {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "shipmentDetails": {
- "contents": [
- {
- "itemNumber": "RZ5678",
- "receivedQuantity": "13",
- "description": "pulyurethane rope",
- "partNumber": "RK1345"
- "beforePossessionStatus": false,
- "weight": [
- {
- "unit": "LB",
- "value": "22222.0"
- "contentPieceCount": "3333",
- "splitShipments": [
- {
- "pieceCount": "10",
- "statusDescription": "status",
- "timestamp": "2019-05-07T08:00:07",
- "statusCode": "statuscode"
- "reasonDetail": {
- "description": "Wrong color",
- "type": "REJECTED"
- "availableNotifications": [
- "ON_DELIVERY",
- "ON_EXCEPTION"
- "shipperInformation": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "lastUpdatedDestinationAddress": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
Track Document
This endpoint helps you to request a letter that includes the recipient's signature as a proof of delivery.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- Full_Schema_SPOD
- Minimum_Payload_Track_Document
- Minimum_Sample_Payload_BOL
- Minimum_Sample_Payload_FBD
trackDocumentDetail required | object This object specifies the tracking document details such as types of documents, for example, SIGNATURE_PROOF_OF_DELIVERY and also the format of tracking document. Supported values are PDF and PNG. Default is PDF. |
trackDocumentSpecification required | Array of objects (TrackDocumentSpecification) This is the placeholder for document specification details required to identify the shipment being tracked. This includes tracking information such as tracking qualifier, carrier code, and tracking number. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "trackDocumentDetail": {
- "documentType": "SIGNATURE_PROOF_OF_DELIVERY",
- "documentFormat": "PNG"
- "trackDocumentSpecification": [
- {
- "trackingNumberInfo": {
- "trackingNumber": "128667043726",
- "carrierCode": "FDXE",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "shipDateBegin": "2020-03-29",
- "shipDateEnd": "2020-04-01",
- "accountNumber": "XXX61073"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "localization": {
- "languageCode": "en",
- "localeCode": "US"
- "documentType": "string",
- "documentFormat": "PNG",
- "document": [
- "string"
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
Track by Tracking Number
This endpoint provides customers package tracking information based on a tracking number for various shipping services.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.
header Parameters
x-customer-transaction-id | string Example: 624deea6-b709-470c-8c39-4b5511281492 This element allows you to assign a unique identifier to your transaction. This element is also returned in the reply and helps you match the request to the reply. |
content-type required | string Example: application/json This is used to indicate the media type of the resource. The media type is a string sent along with the file indicating format of the file. |
x-locale | string Example: en_US This indicates the combination of language code and country code. Click here to see Locales |
authorization required | string Example: Bearer XXX This indicates the authorization token for the input request. |
Request Body schema: application/json
- Full_Schema_Tracking_Numbers
- Track_by_Tracking_Number
includeDetailedScans required | boolean Indicates if detailed scans are requested or not. |
trackingInfo required | Array of objects (TrackingInfo) The tracking information of the shipment to be tracked. At least one occurrence of TrackingInfo is required. Maximum limit is 30. |
Responses
Success
Bad Request
Unauthorized
Forbidden
Not Found
Failure
Service Unavailable
Sandbox Server
Production Server
Request samples
- Payload
- C#
- JAVA
- JAVASCRIPT
- PHP
- PYTHON
- RUST
- SWIFT
- "includeDetailedScans": true,
- "trackingInfo": [
- {
- "shipDateBegin": "2020-03-29",
- "shipDateEnd": "2020-04-01",
- "trackingNumberInfo": {
- "trackingNumber": "128667043726",
- "carrierCode": "FDXE",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
- 503
- "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
- "customerTransactionId": "AnyCo_order123456789",
- "output": {
- "completeTrackResults": [
- {
- "trackingNumber": "123456789012",
- "trackResults": [
- {
- "trackingNumberInfo": {
- "trackingNumber": "128667043726",
- "carrierCode": "FDXE",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "additionalTrackingInfo": {
- "hasAssociatedShipments": false,
- "nickname": "shipment nickname",
- "packageIdentifiers": [
- {
- "type": "SHIPPER_REFERENCE",
- "value": "ASJFGVAS",
- "trackingNumberUniqueId": "245822~123456789012~FDEG"
- "shipmentNotes": "shipment notes"
- "distanceToDestination": {
- "units": "KM",
- "value": 685.7
- "consolidationDetail": [
- {
- "timeStamp": "2020-10-13T03:54:44-06:00",
- "consolidationID": "47936927",
- "reasonDetail": {
- "description": "Wrong color",
- "type": "REJECTED"
- "packageCount": 25,
- "eventType": "PACKAGE_ADDED_TO_CONSOLIDATION"
- "meterNumber": "8468376",
- "returnDetail": {
- "authorizationName": "Sammy Smith",
- "reasonDetail": [
- {
- "description": "Wrong color",
- "type": "REJECTED"
- "serviceDetail": {
- "description": "FedEx Freight Economy.",
- "shortDescription": "FL",
- "type": "FEDEX_FREIGHT_ECONOMY"
- "destinationLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationType": "FEDEX_SHIPSITE"
- "latestStatusDetail": {
- "scanLocation": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "code": "PU",
- "derivedCode": "PU",
- "ancillaryDetails": [
- {
- "reason": "15",
- "reasonDescription": "Customer not available or business closed",
- "action": "Contact us at <http://www.fedex.com/us/customersupport/call/index.html> to discuss possible delivery or pickup alternatives.",
- "actionDescription": "Customer not Available or Business Closed"
- "statusByLocale": "Picked up",
- "description": "Picked up",
- "delayDetail": {
- "type": "WEATHER",
- "subType": "SNOW",
- "status": "DELAYED"
- "serviceCommitMessage": {
- "message": "No scheduled delivery date available at this time.",
- "type": "ESTIMATED_DELIVERY_DATE_UNAVAILABLE"
- "informationNotes": [
- {
- "code": "CLEARANCE_ENTRY_FEE_APPLIES",
- "description": "this is an informational message"
- "error": {
- "code": "TRACKING.TRACKINGNUMBER.EMPTY",
- "parameterList": [
- {
- "value": "value",
- "key": "key"
- "message": "Please provide tracking number."
- "specialHandlings": [
- {
- "description": "Deliver Weekday",
- "type": "DELIVER_WEEKDAY",
- "paymentType": "OTHER"
- "availableImages": [
- {
- "size": "LARGE",
- "type": "BILL_OF_LADING"
- "deliveryDetails": {
- "receivedByName": "Reciever",
- "destinationServiceArea": "EDDUNAVAILABLE",
- "destinationServiceAreaDescription": "Appointment required",
- "locationDescription": "Receptionist/Front Desk",
- "actualDeliveryAddress": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "deliveryToday": false,
- "locationType": "APARTMENT_OFFICE",
- "signedByName": "Reciever",
- "officeOrderDeliveryMethod": "Courier",
- "deliveryAttempts": "0",
- "deliveryOptionEligibilityDetails": [
- {
- "option": "INDIRECT_SIGNATURE_RELEASE",
- "eligibility": "INELIGIBLE"
- "scanEvents": [
- {
- "date": "2018-02-02T12:01:00-07:00",
- "derivedStatus": "Picked Up",
- "scanLocation": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationId": "SEA",
- "locationType": "CUSTOMS_BROKER",
- "exceptionDescription": "Package available for clearance",
- "eventDescription": "Picked Up",
- "eventType": "PU",
- "derivedStatusCode": "PU",
- "exceptionCode": "A25",
- "delayDetail": {
- "type": "WEATHER",
- "subType": "SNOW",
- "status": "DELAYED"
- "dateAndTimes": [
- {
- "dateTime": "2007-09-27T00:00:00",
- "type": "ACTUAL_DELIVERY"
- "packageDetails": {
- "physicalPackagingType": "BARREL",
- "sequenceNumber": "45",
- "undeliveredCount": "7",
- "packagingDescription": {
- "description": "FedEx Pak",
- "type": "FEDEX_PAK"
- "count": "1",
- "weightAndDimensions": {
- "weight": [
- {
- "unit": "LB",
- "value": "22222.0"
- "dimensions": [
- {
- "length": 100,
- "width": 50,
- "height": 30,
- "units": "CM"
- "packageContent": [
- "wire hangers",
- "buttons"
- "contentPieceCount": "100",
- "declaredValue": {
- "currency": "USD",
- "value": 56.8
- "goodsClassificationCode": "goodsClassificationCode",
- "holdAtLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "locationType": "FEDEX_SHIPSITE"
- "customDeliveryOptions": [
- {
- "requestedAppointmentDetail": {
- "date": "2019-05-07",
- "window": [
- {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "description": "Redirect the package to the hold location.",
- "type": "REDIRECT_TO_HOLD_AT_LOCATION",
- "status": "HELD"
- "estimatedDeliveryTimeWindow": {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "pieceCounts": [
- {
- "count": "35",
- "description": "picec count description",
- "type": "ORIGIN"
- "originLocation": {
- "locationId": "SEA",
- "locationContactAndAddress": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "recipientInformation": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "standardTransitTimeWindow": {
- "description": "Description field",
- "window": {
- "begins": "2021-10-01T08:00:00",
- "ends": "2021-10-15T00:00:00-06:00"
- "type": "ESTIMATED_DELIVERY"
- "shipmentDetails": {
- "contents": [
- {
- "itemNumber": "RZ5678",
- "receivedQuantity": "13",
- "description": "pulyurethane rope",
- "partNumber": "RK1345"
- "beforePossessionStatus": false,
- "weight": [
- {
- "unit": "LB",
- "value": "22222.0"
- "contentPieceCount": "3333",
- "splitShipments": [
- {
- "pieceCount": "10",
- "statusDescription": "status",
- "timestamp": "2019-05-07T08:00:07",
- "statusCode": "statuscode"
- "reasonDetail": {
- "description": "Wrong color",
- "type": "REJECTED"
- "availableNotifications": [
- "ON_DELIVERY",
- "ON_EXCEPTION"
- "shipperInformation": {
- "address": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "lastUpdatedDestinationAddress": {
- "addressClassification": "BUSINESS",
- "residential": false,
- "streetLines": [
- "1043 North Easy Street",
- "Suite 999"
- "city": "SEATTLE",
- "stateOrProvinceCode": "WA",
- "postalCode": "98101",
- "countryCode": "US",
- "countryName": "United States"
- "alerts": "TRACKING.DATA.NOTFOUND - Tracking data unavailable"
Response