Fedex Logo
Developer Portal

Freight LTL API

Introduzione

L'API Freight TLT consente di creare spedizioni a carico parziale (LTL). Le spedizioni LTL Freight sono troppo grandi per essere spedite come pacchi ma non abbastanza per riempire un camion intero.

Qui potete ottenere stime sulle tariffe, creare etichette di spedizione per le singole unità di gestione e polizze di carico (ove richieste), prenotare ritiri e monitorare lo stato della spedizione, verificare la disponibilità al ritiro e prenotarne. Ciò significa una maggiore efficienza per le spedizioni più grandi e più pesanti.

Le spedizioni LTL con FedEx Freight offrono monitoraggio a livello di unità e visibilità per le spedizioni con più unità di gestione, ma anche per le spedizioni nazionali prive, nella maggior parte dei casi, di polizza di carico (BOL). Quando richiesto, può essere creata una polizza di carico. Anche se tutte le unità di gestione hanno un numero di tracciabilità univoco, la spedizione si muove su una polizza di carico, ricevuta di consegna ed estratto conto.

Dettagli dell'API Freight LTL

L'API Freight LTL consente di effettuare le spedizioni LTL e di creare i documenti necessari come polizze di carico (ove richiesto), etichette di spedizione FedEx Freight e altri documenti di spedizione di diverso tipo. Nelle spedizioni Freight LTL, l'etichetta principale va sulla prima unità di gestione mentre quella secondaria è applicata alla seconda e alle successive unità di gestione. Le etichette secondarie hanno il proprio numero di monitoraggio univoco, ma fanno riferimento a quello principale. È possibile creare un'unica polizza di carico per spedizione costituita da tutte le unità di gestione e dai colli.

Ogni unità di gestione può essere associata a un numero di monitoraggio; l'etichetta è simile a un'etichetta FedEx Ground o Express Parcel, con l'eccezione di una F, che indica spedizione Freight.

Massimi per unità di gestione e colli per unità di gestione:

  • Il numero massimo di colli per unità di gestione è – 9.999
  • Numero massimo colli – 200 (se si stampano le etichette una alla volta)
  • Numero massimo colli – 40 (se si stampano le etichette contemporaneamente) 

Le spedizioni FedEx LTL Freight sono disponibili in tutti i 50 stati, oltre che a Porto Rico, nelle Isole Vergini americane, in Canada e Messico. Alcune spedizioni richiedono una polizza di carico oltre alle etichette di spedizione. Un esempio di queste spedizioni sono quelle contenenti materiali pericolosi.

FedEx Freight® sta cambiando il settore delle LTL velocizzando le spedizioni di merci e rendendole più economiche servendosi di una rete LTL semplificata.

Di seguito vengono descritte le funzioni disponibili nell'API:

  • Gestione ritiro LTL Freight

    Questa funzione consente di ottenere i luoghi di ritiro di LTL, programmare il ritiro della spedizione e annullare eventuali ritiri già programmati.

  • Calcolo delle tariffe Freight LTL

    Questa funzione consente di calcolare la tariffa di una spedizione LTL sulla base dei luoghi e delle opzioni di servizio selezionate.

  • Invio di spedizioni Freight LTL

    Questa funzione consente di creare una spedizione LTL.

L'API Freight LTL presenta le seguenti funzioni:

  • Spedizione di una singola unità di una spedizione multicollo per tutti i tipi di servizio, con conseguente creazione di etichette di spedizione o di una polizza di carico (se richiesta).
  • Creare una spedizione con più unità di gestione e tenere traccia di ciascuna unità di gestione singolarmente.
  • Creazione di spedizioni LTL per l'uso dei servizi FedEx Freight Priority e Freight Economy.
    • Comunicazione al destinatario di informazioni come numero di account, referente e indirizzo.
    • Comunicazione di marcatura oraria, tipo di imballaggio, peso totale e altri dettagli richiesti come da schema dell'endpoint.
  • Fornitura di un'etichetta FedEx con marchio standard e supporto delle dimensioni specificate per le etichette termiche.
  • Ricezione di notifiche via email o SMS durante le fasi di spedizione, ad esempio:
    • Notifica di spedizione
    • Consegna stimata
    • Notifica di ritiro
  • Generazione di documenti di spedizione come:
    • Etichette di spedizione per le singole unità di gestione
    • Polizza di carico
    • Fattura commerciale
    • Fattura per la dogana canadese
  • Creazione di spedizioni e stampa di etichette un'unità di gestione alla volta o elaborazione di tutte le unità di gestione contemporaneamente.
  • Recupero di tariffe per una spedizione con un unico collo o multicollo, per tutti i tipi di servizio.
  • Verifica della disponibilità di ritiro, programmazione ed eventuale annullamento del ritiro.
  • Creazione e programmazione del ritiro con Codici Cliente di terze parti per un indirizzo di fatturazione alternativo.

C.O.D. per spedizioni di merci pesanti o voluminose: cessazione del servizio

Il Vettore non fornisce più il servizio C.O.D. (Pagamento in contrassegno) ai Clienti. Il Vettore non è responsabile del ritiro dell'importo del C.O.D. poiché questo non è un servizio fornito dal Vettore. Tutte le spese di deposito, riconsegna e per spedizioni di merci pesanti o voluminose verranno applicate alle spedizioni contrassegnate con C.O.D.

Servizi di spedizione Freight LTL

Sono disponibili i seguenti servizi di spedizione Freight LTL:

FedEx Freight® Priority

Grazia alla puntualità e ai tempi di transito migliori della categoria, FedEx Freight® Priority consegna le vostre spedizioni in modo veloce e affidabile. Potete affidarvi al nostro servizio regionale per consegne ai vostri clienti entro il giorno successivo o due giorni successivi, garantite da una garanzia di rimborso gratuita. *

Funzioni del servizio FedEx Freight® Priority:

  • Tempi di transito veloci e servizio con consegna il giorno successivo per destinazioni entro i 965 km ed entro due giorni per destinazioni entro i 2.500 km
  • Consegna diretta verso ogni codice di avviamento postale negli Stati Uniti, in Canada e in Messico.
  • Affidabilità costante in termini di puntualità
  • Garanzia di rimborso gratuita*
  • Tecnologia all'avanguardia con visibilità della spedizione dall'inizio alla fine
  • Team dedicato di professionisti per dare assistenza nell'abito di tutte le spedizioni regionali

*Tutti i servizi sono soggetti ai termini e alle condizioni delle regole tariffarie della serie FXFR 100.

FedEx Freight Economy

FedEx Freight® Economy offre consegne a carico parziale (LTL) economiche, focalizzate sulle vostre esigenze di spedizione base. Grazie ai servizi di consegna FedEx LTL, il servizio clienti può contare su puntualità affidabile e e un'attenta gestione.

FedEx Freight® Economy offre:

  • Soluzioni di spedizione economiche
  • Maggiore risparmio per le consegne non urgenti che richiedono comunque una consegna affidabile
  • Affidabilità costante in termini di puntualità
  • Consegna diretta verso ogni codice di avviamento postale negli Stati Uniti, in Canada, Messico e Porto Rico.
  • Tecnologia all'avanguardia con visibilità della spedizione dall'inizio alla fine
  • Visibilità migliorata grazie a un monitoraggio della spedizione dall'inizio alla fine

FedEx International Deferred Freight (FDF)

FedEx International Deferred Freight (FDF) è un servizio di spedizione Air Freight globale per effettuare spedizioni internazionali Air Freight con tempi di consegna/transito prolungati a tariffe economiche. FDF è inoltre disponibile per i servizi di consegna Airport-to-Airport, Door-to-Airport, Airport-to-Door e Door-to-Door.

Nota:

  • Attualmente, questo servizio è disponibile solo per tratte selezionate da Paese a Paese.
  • Le Merci pericolose (MP) e le Merci soggette a restrizioni non sono consentite. Esempio: ghiaccio secco, batterie agli ioni di litio. Contattate l'assistenza clienti FedEx per ulteriori informazioni.
  • Le spedizioni nazionali statunitensi e le spedizioni nazionali non statunitensi non sono consentite.

Funzionamento dell'API Freight LTL

Questa sezione descrive gli endpoint e gli elementi chiave richiesti dall'API FedEx Freight LTL.

Il vostro account FedEx Freight LTL deve essere abilitato all'utilizzo dell'API FedEx Freight LTL. Per elaborare le spedizioni LTL, le informazioni chiave richieste sono il/i numero/i di account FedEx Freight e l'indirizzo di posta corretto dell'account.

Di seguito vengono descritti gli endpoint disponibili nell'API:

Spedizioni Freight LTL

Usate questo endpoint per la convalida e la creazione di spedizioni FedEx Freight LTL.

Le informazioni di input richieste associate a questa richiesta sono:

  • Codice account Freight
  • Indirizzo di posta dell'account
  • Spedizione Freight richiesta
  • Opzioni per le etichette – Etichette fornite sotto forma di codice o URL.
  • Dettagli di monitoraggio master – Solo in caso di elaborazione di spedizione multicollo e di stampa delle etichette una alla volta e non insieme (quando non compare l'elemento singleShotMPS oppure se compare con valore false).

L'esito positivo a questa richiesta genera una spedizione LTL, offre dettagli di monitoraggio e di allerta. In caso di anomalia, genera anche messaggi di errore e le relative descrizioni.

Nota: l'indirizzo di posta può essere diverso dall'indirizzo di spedizione effettivo.

Verifica della disponibilità del ritiro della spedizione LTL Freight

Questo endpoint viene utilizzato per richiedere l'elenco di tutti i luoghi di ritiro disponibili con i relativi dettagli di pianificazione del ritiro, come il vettore, l'ultimo orario disponibile per il ritiro, l'ultimo orario disponibile di default, la disponibilità di ritiro, l'orario in cui la spedizione è pronta al ritiro, l'indicazione di indirizzo di residenza, l'orario dopo il quale non è più possibile il ritiro e l'accesso al ritiro della spedizione da parte dell'autista.

Le informazioni di input richieste associate a questa richiesta sono:

  • Indirizzo di ritiro/dettagli postali.
  • Tipo di richiesta di ritiro (ad esempio stesso giorno/giorno futuro).
  • Ritiro nazionale/internazionale.

Nota: usate un indirizzo di ritiro valido e corretto. 

L'esito positivo di questa richiesta offrirà l'elenco di tutti i luoghi di ritiro disponibili, il giorno di consegna, la disponibilità (spunta), la data di ritiro, l'orario massimo di ritiro, la disponibilità di un indirizzo di residenza (spunta), l'orario di chiusura (spunta) e l'ora locale. In caso di anomalia, genera anche messaggi di errore e le relative descrizioni.

Creazione ritiro LTL Freight

Questo endpoint serve a creare e programmare il ritiro di una spedizione.

Le informazioni di input richieste associate a questa richiesta sono:

  • Codice account Freight intestatario della fattura di ritiro.
  • Dettagli sull'origine (indirizzo, luogo e tipo di indirizzo di ritiro, ad esempio account/mittente/altro).
  • Dettagli dell'indirizzo dell'account associato.

L'esito positivo della richiesta di ritiro genera un numero di conferma per il ritiro, una notifica di ritiro e il codice del luogo di ritiro programmato. In caso di anomalia, genera anche messaggi di errore e le relative descrizioni.

Nota: usare un indirizzo valido e corretto per il ritiro e fornire anche l'indirizzo corretto del Codice Cliente per programmare il ritiro. L'orario e la data di programmazione del ritiro non possono essere un orario già passato o una data troppo avanti nel tempo. I ritiri anonimi non sono consentiti. È possibile programmare il ritiro per Codici Cliente di terze parti fornendo dettagli di indirizzo alternativi validi.

Annullamento ritiro LTL Freight

Questo endpoint serve ad annullare eventuali richieste di ritiro di una spedizione LTL già programmate. In caso di esito positivo dell'annullamento del ritiro, verrà fornito un numero di conferma e un messaggio di conferma dell'annullamento del ritiro.

Le informazioni di input richieste associate a questa richiesta sono:

  • Codice di conferma del ritiro (si ottiene nell'ambito della richiesta di ritiro)
  • Data programmata (data di ritiro della spedizione)
  • Luogo (filiale FedEx Express responsabile dell'elaborazione della richiesta di ritiro)

L'esito positivo della richiesta genera un numero di conferma per il ritiro, una notifica di ritiro e il codice del luogo di ritiro programmato. In caso di anomalia, genera anche messaggi di errore e le relative descrizioni.

Nota: per annullare un ritiro programmato sono necessari il numero di conferma del ritiro e il codice del luogo corrispondente (solo per FDXE). Il numero di conferma di ritiro e il codice del luogo corrispondente (solo per FDXE) vengono comunicati all'invio di una richiesta di ritiro. Per annullare il ritiro, è necessario anche l'indirizzo corretto dell'account. Nel caso in cui si cerchi di annullare il ritiro dopo la partenza del vettore FedEX verso il luogo di ritiro, sarà inviata una notifica di errore

Tariffe LTL Freight

Questo endpoint serve per richiedere l'elenco di tutte le tariffe Freight e le informazioni di transito opzionali sulla base dei dettagli inseriti. Le tariffe ottenute si basano sull'origine, la destinazione e le altre informazioni relative alla spedizione. Le informazioni aggiuntive, come il codice vettore, il tipo o l'opzione di servizio, possono servire per ottenere risultati più accurati.

Le informazioni di input richieste associate a questa richiesta sono:

  • Codice account Freight
  • Spedizione Freight richiesta.

L'esito positivo della richiesta genera un elenco di tutte le tariffe disponibili e il codice del luogo del ritiro programmato. In caso di anomalia, genera anche messaggi di errore e le relative descrizioni.

Spedizione multicollo (MPS) Freight LTL

Una spedizione multicollo comprende due o più colli spediti allo stesso indirizzo destinatario. Il primo collo della richiesta di spedizione è considerato quello principale (master).

Per creare una spedizione multicollo effettuate la seguente procedura.

  • Inserite le informazioni a livello di spedizione come serviceType, packagingType, totalWeight, totalPackageCount, freightShipmentDetail e requestedPackageLineItems. [Nota: il valore sequenceNumber del collo principale deve essere pari a 1.]
  • Per stampare l'etichetta di ogni unità di gestione, indicate i dettagli di monitoraggio principale alla voce masterTrackingId per tutte le unità di controllo successive.

Di seguito vengono riportate le opzioni di elaborazione della spedizione multicollo disponibili in questa API.

Stampa singola delle etichette dell'unità di gestione

Quest'API permette di elaborare le spedizioni multicollo e ottenere le etichette una alla volta.

Quando è necessario usufruire di questa spedizione, oltre a tutti gli elementi MPS richiesti, fornite anche l'elemento oneLabelAtATime as true nell'ambito della richiesta.

L'output della prima richiesta dovrebbe generare l'etichetta e il numero di monitoraggio, che è il numero di monitoraggio principale. Indicate questo numero nella voce masterTrackingId per elaborare le successive richieste di spedizione e generare etichette con numeri di monitoraggio (numeri di monitoraggio figli) per il numero complessivo di colli (totalPackageCount).

Nota: il numero massimo di unità di gestione consentite è 200.

Stampa simultanea delle etichette dell'unità di gestione

Quest'API permette di elaborare le spedizioni multicollo e ottenere le etichette tutte insieme. Si tratta di un metodo di elaborazione ideale quando la spedizione è composta da massimo 40 unità di gestione (totalPackageCount<=40) destinate a un unico indirizzo di destinazione.

Impostate oneLabelAtATime as false nella richiesta di spedizione indicando al massimo 40 unità di gestione e generate le etichette istantaneamente.

Nota: il limite massimo di 40 unità di gestione è indicativo e non è un limite fisso. Il limite dipende anche dalla combinazione del numero di unità di gestione e dalle merci. Contattate il vostro referente FedEx per maggiori informazioni.

Esempio: se la richiesta di spedizione contiene 10 unità di gestione, una volta inoltrata creerà 10 etichette e verranno forniti gli URL delle etichette o le etichette codificate come richiesto.

FedEx Freight Direct

Questo servizio offre al cliente un'esperienza superiore per la consegna di merci di grandi dimensioni e pallettizzate, compresa la consegna di spedizioni pesanti e ingombranti all'interno delle case o delle aziende dei clienti.

Il servizio offre opzioni come comunicazioni proattive, opzioni di consegna flessibili e tariffe a pacchetto che includono supplementi di servizio.

Di seguito sono elencate alcune delle caratteristiche incluse in questo servizio:

  • Consente la creazione di spedizioni FedEx Freight Direct di base, di base per appuntamento, di consegna standard e premium e di spedizioni/ritiri di base negli Stati Uniti continentali, in Alaska e nelle Hawaii.
  • Include la possibilità di ottenere una stima completa delle tariffe per una spedizione FedEx Freight Direct utilizzando un codice cliente FedEx Freight Direct e la possibilità di annullare un ritiro FedEx Freight Direct.
    • Le tariffe stimate per l'Alaska e le Hawaii non verranno restituite. Per richiedere un preventivo per questi stati, contattate il Servizio Clienti FedEx.
    • Per annullare un ritiro programmato per lo stesso giorno, il cliente deve chiamare il servizio clienti FedEx.
  • Consente di inviare notifiche via email al mittente/destinatario originale in modo che il cliente possa:
    • Programmare una consegna
    • Ricevere la conferma della consegna e/o del ritiro
    • Ricevere la notifica della consegna e/o del ritiro
    • Ricevere notifiche in itinere
    • Consultare dei sondaggi tra i clienti per le spedizioni consegnate
  • Le regole aziendali di convalida del CAP, dimensioni, peso del collo e peso dell'unità di gestione saranno applicabili a FedEx Freight Direct per determinare la corretta combinazione dei servizi di trasporto di linea e di first/last-mile.

FedEx Freight Direct offre diversi tipi di servizio tra cui scegliere.

Questa API offre le seguenti funzionalità con il servizio Freight Direct:

Calcolo delle tariffe Freight Direct

Utilizzate questo endpoint per ottenere le tariffe e i supplementi di Freight Direct per le seguenti opzioni speciali del servizio Freight Direct: Servizio di base, Servizio di base per appuntamento, Servizio standard, Servizio premium.

Di seguito sono riportati i dettagli necessari da allegare alla richiesta di tariffa utilizzando l'endpoint Rate Freight LTL:

  • Tipo di Freight Direct (BASE, BASE_PER_APPUNTAMENTO, PREMIUM, STANDARD)
  • Tipo di Trasporto Freight Direct (CONSEGNA, RITIRO)
  • Tipo di numero di telefono se fornito (CASA, MOBILE, LAVORO)
  • Peso
  • Dimensioni (lunghezza, larghezza e altezza non negative)

Creare una spedizione Freight Direct

Utilizzate questo endpoint per spedire un collo singolo o una spedizione multicollo per le seguenti opzioni speciali del servizio Freight Direct: Servizio di base, Servizio di base per appuntamento, Servizio standard, Servizio premium e ottenete un'etichetta di spedizione o una bolla di carico, compresa la documentazione necessaria per l'elaborazione di una spedizione Freight Priority.

Di seguito sono riportati i dettagli necessari da allegare alla richiesta di spedizione tramite l'endpoint Ship Freight LTL:

  • Tipo di Freight Direct (BASE, BASE_PER_APPUNTAMENTO, PREMIUM, STANDARD)
  • Tipo di Trasporto Freight Direct (CONSEGNA, RITIRO)
  • Indirizzo email, numero di telefono e tipo di telefono
  • Peso
  • Dimensioni (lunghezza, larghezza e altezza non negative)

La polizza di carico in uscita conterrà i nomi dei nuovi servizi Freight Direct. Di seguito sono riportati i valori stampati sulla polizza di carico a seconda della selezione del servizio:

  • CONSEGNA DIRECT BASE
  • CONSEGNA PER APPUNTAMENTO DIRECT BASE
  • CONSEGNA DIRECT PREMIUM
  • CONSEGNA DIRECT STANDARD
  • RITIRO DIRECT BASE
  • RITIRO PER APPUNTAMENTO DIRECT BASE
  • RITIRO DIRECT PREMIUM
  • RITIRO DIRECT STANDARD

Ritiro Freight Direct

Utilizzate questo endpoint per controllare la disponibilità del servizio di ritiro Freight LTL Freight Direct, creare una richiesta di ritiro per un collo da ritirare o annullare una richiesta di ritiro esistente.

Di seguito sono riportati i dettagli necessari da allegare alla richiesta di ritiro tramite l'endpoint Verifica disponibilità per il ritiro Freight LTL, Crea un ritiro Freight LTL e Annulla ritiro Freight LTL.

  • Tipo di Freight Direct (BASE, BASE_PER_APPUNTAMENTO, PREMIUM, STANDARD)
  • Tipo di Trasporto Freight Direct (CONSEGNA, RITIRO)
  • Indirizzo email (Creazione di una richiesta di ritiro)
  • Numero di telefono e tipo di telefono (Creazione di una richiesta di ritiro)
  • Peso

Regole aziendali

  • Un numero di monitoraggio principale (Pro) viene assegnato alla prima unità di gestione di una spedizione Freight LTL, mentre quelli secondari vengono assegnati a ciascuna unità di gestione successiva.
  • È possibile tenere traccia di ciascuna unità di gestione della spedizione singolarmente o come parte dell'intera spedizione.
  • Altri documenti possono essere applicati a spedizioni specifiche (ad es. Trasporto di materiali pericolosi [HazMat] e spedizioni internazionali).
  • I Codici Cliente solo LTL Freight e con fatturazione a LTL Freight non possono essere aggiunti al FedEx Developer Portal.
  • Il cliente può utilizzare il singolo codice cliente LTL a lungo termine o il codice cliente FedEx Freight Direct per utilizzare i servizi Freight Direct.
  • Le funzionalità di valutazione di FedEx Freight Direct sono disponibili solo nella normale API LTL.
  • Tutti i nuovi errori/messaggi saranno solo in lingua inglese.
  • Durante la creazione delle spedizioni, l'indirizzo e-mail e il telefono sono richiesti come parte della richiesta dell'opzione di servizio FedEx Freight Direct.

Freight LTL API (1.0.0)

Rate Freight LTL

This endpoint providess the ability to retrieve rate quotes and optionall transitt informationnnn. The rate is calculated based on the origin and destination of the shipment. Additional information such as carrier code, service type, or service option can be used to filter the results. Applicable operating company is FedEx Freight.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.


EXPAND ALLCOLLAPSE ALL
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
  • FullSchema
  • MinimumSamplePayload
accountNumber
required
object (LTLRootAccountNumber)

This is the Account number details.
Note:

  • In case if this is shipping account number, do use the account number used for creating Auth Token.

rateRequestControlParameters
object (LTLRateRequestControlParameters)

These are various parameters you can provide for filtering and sorting capability in the response, such as transit time and commit data, rate sort order etc.

freightRequestedShipment
required
object (LTLRequestedShipment)

This contains shipment data describing the shipment for which a freight rate quote (or rate-shopping comparison) is desired.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /rate/v1/freight/rates/quotes

Sandbox Server

https://apis-sandbox.fedex.com/rate/v1/freight/rates/quotes

Production Server

https://apis.fedex.com/rate/v1/freight/rates/quotes

Request samples - Rate Freight LTL

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "accountNumber":
    {
    },
  • "rateRequestControlParameters":
    {
    },
  • "freightRequestedShipment":
    {
    }
}

Response samples - Rate Freight LTL

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

Ship Freight LTL

This endpoint helps you to create a Freight LTL Shipment request with the required Freight LTL Shipment information, and to retrieve information for an already in process shipment. It also allows you to confirm and validate your shipment.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.


EXPAND ALLCOLLAPSE ALL
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
  • FullSchema-FreightShipment
  • FreightShipment_ShipTo_Freight_Account
  • FreightShipment_BillTo_Freight_Account
  • FreightShipment_International_SingleShot_MPS_ShipTo_Freight_Account
  • FreightShipment_OneLabelAtATime_MPS_Master_ShipTo_Freight_Account
  • FreightShipment_OneLabelAtATime_MPS_Child_ShipTo_Freight_Account
freightRequestedShipment
required
object (FreightRequestedShipment_Freight2020)

The descriptive data for the FreightShipment being tendered to FedEx.

labelResponseOptions
required
string
Enum: "URL_ONLY" "LABEL"

If the value is LABEL, the encoded label will be included in the response and if the value is URL_ONLY, the response will include the URLs.

Note: With URL_ONLY option, the URL once created will be active for 24 hours.

accountNumber
required
object (ShipperAccountNumber)

The account number associated with the shipment.

oneLabelAtATime
boolean

If the value is false, it uses single shot MPS shipments where in all the packages are processed in the same transaction and can generate number of labels for the handling units all at once. If the value is true, the MPS shipment processes packages and labels one at a time. Default value is false.
Example: true or false

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /ship/v1/freight/shipments

Sandbox Server

https://apis-sandbox.fedex.com/ship/v1/freight/shipments

Production Server

https://apis.fedex.com/ship/v1/freight/shipments

Request samples - Ship Freight LTL

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "freightRequestedShipment":
    {
    },
  • "labelResponseOptions": "LABEL",
  • "accountNumber":
    {
    },
  • "oneLabelAtATime": true
}

Response samples - Ship Freight LTL

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

Check Freight LTL Pickup Availability

This endpoint allows you to check the availability of an Freight LTL pickup service. The pickup availability depends on two factors, the cut off time and the access time.

Cut off time - The latest time allowed for a pickup to be scheduled. The time is local to the pickup postal code.

Access time - The time between the pickup ready time (when the package is ready to be picked) and the time when the driver is ready to pick up the package.

Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.


EXPAND ALLCOLLAPSE ALL
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
  • FullSchema-FreightPickupAvailability
  • MinimumSamplePayload-FreightPickupAvailability
pickupAddress
required
object (PickupAddress)

The address for which pickup availability inquiry is made.

packageReadyTime
string

The time that the package will be ready for pickup. The time format is HH:MM:SS and it refers to the local timezone. The driver should pick up the package/shipment by the given pickup time.

customerCloseTime
string

The latest time the driver gets access to pick up the package. The time format is in HH:MM:SS and it refers to the local timezone. The driver should pick up the package by the given pickup time.

shipmentAttributes
object (ShipmentAttributes)

Indicates the shipment details such as service type, packaging type, weight and dimensions.

freightPickupSpecialServiceDetail
object (FullSchemaFreightPickupAvailability_freightPickupSpecialServiceDetail)
dispatchDate
string

Indicates the date, the package is to be picked up. The format is YYYY-MM-DD. If the field is left blank, the system considers current date as dispatch date.

numberOfBusinessDays
integer <int32>

Number of business days to consider when checking availability.
For example if you are indicating pickupDate as Saturday and you indicate 3, Saturday, Sunday and Monday will be considered.
Example: 3

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /pickup/v1/freight/pickups/availabilities

Sandbox Server

https://apis-sandbox.fedex.com/pickup/v1/freight/pickups/availabilities

Production Server

https://apis.fedex.com/pickup/v1/freight/pickups/availabilities

Request samples - Check Freight LTL Pickup Availability

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "pickupAddress":
    {
    },
  • "packageReadyTime": "15:30:00",
  • "customerCloseTime": "18:00:00",
  • "shipmentAttributes":
    {
    },
  • "freightPickupSpecialServiceDetail":
    {
    },
  • "dispatchDate": "2019-10-14",
  • "numberOfBusinessDays": 1
}

Response samples - Check Freight LTL Pickup Availability

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

Create Freight LTL Pickup

This endpoint helps you to create a freight pickup request for a package to be picked up.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.


EXPAND ALLCOLLAPSE ALL
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
  • FullSchema-CreatePickup
  • MinimumSamplePayload-CreateFreightPickup
  • MinimumSamplePayload-FreightBillToPickup
associatedAccountNumber
required
object

The associated account number, which is invoiced for the freight pickup.

originDetail
required
object

The origin address if different than the one associated with the shipper account. This element value is required when the package is to be picked up from an address other than the shipper account address.

totalWeight
Array of objects (TotalWeight)

The total weight of the packages for the pickup. Unit of measure is LB and KG.

packageCount
integer <int32>

The total number of packages for the pickup.
Example: 5

remarks
string

This is a placeholder for any message to be passed to the FedEx pickup. courier.
Example: Please ring bell at loading dock.

countryRelationships
string
Enum: "DOMESTIC" "INTERNATIONAL"

Describes the country relationship among the shipments being picked up.
'DOMESTIC' indicates intra-country shipping; origin and destination country are the same.
'INTERNATIONAL' indicates inter-country shipping; origin and destination countries are different.
Not applicable for FedEx Ground shipments
Example: DOMESTIC

trackingNumber
string

This is a tracking number for FedEx packages used for tracking a single package or group of packages.
Example: XXXX0365XXXX

commodityDescription
string

Description of the commodity being shipped.
Example:This field contains CommodityDescription

freightPickupDetail
required
object

This provides the Freight LTL pickup detailed information.

oversizePackageCount
integer <int32>

The number of oversize packages that are tendered to FedEx Ground.

pickupNotificationDetail
object

This object allows user to request for pickup confirmation email. User can specify upto 5 email addresses.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /pickup/v1/freight/pickups/

Sandbox Server

https://apis-sandbox.fedex.com/pickup/v1/freight/pickups/

Production Server

https://apis.fedex.com/pickup/v1/freight/pickups/

Request samples - Create Freight LTL Pickup

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "associatedAccountNumber":
    {
    },
  • "originDetail":
    {
    },
  • "totalWeight":
    [
    ],
  • "packageCount": 5,
  • "remarks": "Please ring bell at loading dock.",
  • "countryRelationships": "DOMESTIC",
  • "trackingNumber": "795803657326",
  • "commodityDescription": "This field contains CommodityDescription",
  • "freightPickupDetail":
    {
    },
  • "oversizePackageCount": 2,
  • "pickupNotificationDetail":
    {
    }
}

Response samples - Create Freight LTL Pickup

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

Cancel Freight LTL Pickup

Use this endpoint to cancel the already scheduled freight pickup request. Note a failure notification will be sent if you attempt to cancel a pickup after the FedEx courier has been dispatched to the pickup location.
Note: FedEx APIs do not support Cross-Origin Resource Sharing (CORS) mechanism.


EXPAND ALLCOLLAPSE ALL
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
  • FullSchema-CancelFreightPickup
  • MinimumSamplePayload-FreightCancel
associatedAccountNumber
required
object (AccountNumber_2)

Specify the FedEx Account number.
Example: Your account number

pickupConfirmationCode
required
string

The confirmation number provided by FedEx to the customer when the pickup was scheduled or requested.
Example: XXXX1007MEM62XXXX.

remarks
string

Specify the additional information to be passed on the pickup courier.

reason
required
string

Specify the reason for cancellation of pickup.

contactName
required
string

Specify the contact name.

scheduledDate
string

Specifies the date when pickup dispatch occurs.
Format YYYY-MM-DD
Example: 2019-10-15

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

put /pickup/v1/freight/pickups/cancel/

Sandbox Server

https://apis-sandbox.fedex.com/pickup/v1/freight/pickups/cancel/

Production Server

https://apis.fedex.com/pickup/v1/freight/pickups/cancel/

Request samples - Cancel Freight LTL Pickup

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "associatedAccountNumber":
    {
    },
  • "pickupConfirmationCode": "20201007MEM628005",
  • "remarks": "This is my remarks",
  • "reason": "This is my reason",
  • "contactName": "This is my contactName",
  • "scheduledDate": "2019-10-15"
}

Response samples - Cancel Freight LTL Pickup

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

Response

Copy