Fedex Logo
Developer Portal

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
  • E-mail
  • 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/iniziainizio EDTW data/intervallo di marcatura oraria. Esempio: '2019-05-07T08:00:07'

·        finestra/terminaFine 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
One of
  • Full_Schema_Multiple_Piece_Shipment
  • Minimum_Payload_Track_Multiple_Piece_Shipment
includeDetailedScans
boolean

Indicates if detailed scans are requested or not.
Valid values are True, or False.

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.
Example: STANDARD_MPS
STANDARD_MPS: Single shipment with multiple packages, where tracking number got assigned to all pieces, one tracking number is treated as master tracking number while others are child tracking numbers.
Group MPS: Behavior is just like standard MPS but it’s created differently. The shipper must be enrolled for this by a particular reference type like ‘PO’ (purchase order).Then any package order create on the same day going to the same place that has the reference number will get grouped into GMPS relationships.
OUTBOUND_LINK_TO_RETURN: is an RTRN relationship.Same concept as an MPS.the OUTBOUND_LINK_TO_RETURN is the Master outbound package tracking number, that when tracked with this indicator you can get all the child return pieces.

pagingDetails
object (PagingDetails)

The details about how to retrieve the subsequent pages when there is more than one page in the TrackReply.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/associatedshipments

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/associatedshipments

Production Server

https://apis.fedex.com/track/v1/associatedshipments

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "includeDetailedScans": true,
  • "associatedType": "STANDARD_MPS",
  • "masterTrackingNumberInfo":
    {
    },
  • "pagingDetails":
    {
    }
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  • "customerTransactionId": "AnyCo_order123456789",
  • "output":
    {
    }
}

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
One of
  • Full_Schema_Notification
  • Send_Shipment_Notifications
senderContactName
required
string

Placeholder for Sender contact name.
Example: Sam Smith

senderEMailAddress
required
string

Email address of the sender from which the shipment notification will be sent.
Example: LSR123@gmail.com

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.
Format: YYYY-MM-DD
example:'2019-10-13'

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.
Format: YYYY-MM-DD
example:'2019-10-13'

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/notifications

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/notifications

Production Server

https://apis.fedex.com/track/v1/notifications

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "senderContactName": "Sam Smith",
  • "senderEMailAddress": "Lsr1234@gmail.com",
  • "trackingEventNotificationDetail":
    {
    },
  • "trackingNumberInfo":
    {
    },
  • "shipDateBegin": "2019-10-13",
  • "shipDateEnd": "2019-10-31"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  • "customerTransactionId": "AnyCo_order123456789",
  • "output":
    {
    }
}

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
One of
  • 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
- Either shipper.AccountNumber or Destination.countryCode(and postal for postal aware countries) are required
- If ShipDateRangeBegin and End are not present, shipDateRangeBegin will be set to the current date minus 30 days, and shipDdateRangeEnd will default to current date plus one day.

includeDetailedScans
boolean

Indicates if the detailed scans are being requested or not. If true, the detailed scans will be included in the response returned.
Valid values are True or False.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/referencenumbers

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/referencenumbers

Production Server

https://apis.fedex.com/track/v1/referencenumbers

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "referencesInformation":
    {
    },
  • "includeDetailedScans": "true"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  • "customerTransactionId": "AnyCo_order123456789",
  • "output":
    {
    }
}

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
One of
  • Full_Schema_TCN
  • Minimum_Payload_Track_By_Tracking_Control_Number
tcnInfo
required
object

The information associated with the transportation control number.
Only 1 TCN is supported per request.

includeDetailedScans
boolean

Indicates if detailed scans are requested or not.
Valid values are True, or False.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/tcn

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/tcn

Production Server

https://apis.fedex.com/track/v1/tcn

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "tcnInfo":
    {
    },
  • "includeDetailedScans": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  • "customerTransactionId": "AnyCo_order123456789",
  • "output":
    {
    }
}

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
One of
  • 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.
At least one trackDocumentSpecification is required. Maximum limit is 30.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/trackingdocuments

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/trackingdocuments

Production Server

https://apis.fedex.com/track/v1/trackingdocuments

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "trackDocumentDetail":
    {
    },
  • "trackDocumentSpecification":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  • "customerTransactionId": "AnyCo_order123456789",
  • "output":
    {
    }
}

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
One of
  • Full_Schema_Tracking_Numbers
  • Track_by_Tracking_Number
includeDetailedScans
required
boolean

Indicates if detailed scans are requested or not.
Valid values are True, or False.

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

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /track/v1/trackingnumbers

Sandbox Server

https://apis-sandbox.fedex.com/track/v1/trackingnumbers

Production Server

https://apis.fedex.com/track/v1/trackingnumbers

Request samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "includeDetailedScans": true,
  • "trackingInfo":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  • "customerTransactionId": "AnyCo_order123456789",
  • "output":
    {
    }
}
CLOSE

Response

Copy