Fedex Logo
Developer Portal

FedEx Locations Search API

Introduzione

Le filiali FedEx sono punti di ritiro e consegna gestiti dai fornitori di servizi di spedizione FedEx. Potete spedire un collo da una filiale di ritiro a una di consegna utilizzando qualsiasi vettore FedEx. Questa API vi aiuta a trovare filiali supportate e disponibili utilizzando l'indirizzo, le coordinate geografiche o il numero di telefono.

L'API ricerca filiali FedEx cerca e restituisce gli indirizzi delle filiali di consegna FedEx più vicine, tra cui FedEx Office® Print and Ship Center e filiali FedEx Drop Box disponibili per consegne di colli FedEx Express® e FedEx Ground®.

Dettagli API ricerca filiali FedEx

L'API vi consente di cercare le filiali di consegna FedEx tramite indirizzo, coordinate geografiche o numero di telefono.

Consente di cercare le filiali in base a quanto segue.

  • Centri di spedizione autorizzati
  • Centri di consegna autorizzati
  • Fermo deposito
  • Filiali con cassetta di consegna
  • Filiali che accettano spedizioni di merci pericolose

Le funzioni dell'API ricerca filiali FedEx sono le seguenti.

  • Trovare la filiale di ritiro e consegna FedEx più vicina
  • Ottenere i dettagli dell'indirizzo, tra cui codice postale, codice del Paese ecc., della filiale

Come funzione l'API ricerca filiali FedEx

L'API ricerca filiali vi aiuta a individuare le filiali FedEx disponibili per la consegna di colli FedEx Express® e FedEx Ground®. Questa transazione cerca e restituisce gli indirizzi delle filiali FedEx più vicine. Potete usare l'API anche per trovare le filiali FedEx che forniscono il servizio di fermo deposito.

Trova filiali

Questa richiesta è utilizzata per restituire un elenco di filiali disponili in base ai dettagli di input. Le informazioni di input chiave associate a questa richiesta sono le seguenti.

  • Indirizzo
  • Distanza (valore e unità del raggio intorno all'indirizzo per cercare le filiali FedEx)

Nota: il codice postale è obbligatorio per i Paesi che lo prevedono. Per gli altri, la combinazione di città e Paese indica le filiali FedEx valide.

Il risultato di questa richiesta è un elenco dettagliato di tutti i punti di ritiro e consegna FedEx disponibili, insieme a informazioni chiave come la distanza, gli orari del punto vendita, i dettagli del vettore, i servizi e le capacità disponibili per i giorni della settimana, la possibilità di consegnare/ritirare le spedizioni, di effettuare un fermo per il ritiro delle spedizioni ecc.

Caratteristiche principali API ricerca filiali FedEx

Restringi la ricerca per filiale

Potete restringere la ricerca per tipo di filiale. Nella richiesta è possibile specificare uno, vari o tutti i tipi di filiali FedEx elencate.

  • Filiali FedEx Authorized ShipCenter®: accedete alla rete di trasporto FedEx in oltre 5.800 centri imballa e spedisci (FASC) di proprietà e indipendenti in tutti gli Stati Uniti. I punti vendita che partecipano al programma FedEx Authorized ShipCenter forniscono anche altri servizi commerciali. Le filiali FedEx Authorized ShipCenter possono applicare costi aggiuntivi rispetto alle tariffe pubblicate da FedEx.
  • FedEx ShipCenter®
  • Express Station
  • FedEx ShipSite
  • Filiale FedEx Office®
  • Filiale self-service FedEx: consegnate i colli FedEx Express e FedEx Ground (fino a 50,8 x 30,48 x 15,24 cm) in una cassetta di consegna FedEx Express®.
  • Le seguenti tipologie di filiali supportano il fermo deposito.
    • FedEx OnSite – Colli FedEx Express e FedEx Ground
    • FedEx Office – Colli FedEx Express e FedEx Ground
    • Express Station – Solo colli FedEx Express
    • FedEx Ship Center – Colli FedEx Express e FedEx Ground e merci pericolose approvate

Capacità delle filiali

Inoltre, la richiesta di ricerca supporta un elemento che specifica se le filiali supportano la funzionalità FedEx Express o FedEx Ground Redirect to Hold nonché elementi per specificare le capacità delle filiali, tra cui i seguenti.

  • Servizi di reso
  • Consegne via terra
  • Contanti
  • Imballa e spedisci
  • Forniture per imballaggio
  • Servizio per simboli e banner
  • Sony PictureStation
  • Servizi di direct mail
  • Servizi di copia e stampa
  • Servizi per merci pericolose
  • Filiale in aeroporto
  • Servizi di notaio
  • Ora legale
  • Servizi per foto per passaporto
  • Drop Box
  • Servizi di spedizione nazionale
  • Servizi di spedizione internazionale

Ordinare i risultati

LAPI ricerca filiali FedEx vi consente di ordinare i risultati in base a quanto segue.

  • Ultimo orario di consegna FedEx Express
  • Ultimo orario di consegna FedEx Ground
  • Tipo di filiale
  • Per distanza in ordine crescente
  • Per distanza in ordine decrescente

Ulteriori criteri di ricerca

Potete inoltre restringere la ricerca in base a quanto segue.

  • Disponibilità del servizio il sabato
  • Disponibilità del servizio di imballaggio (la maggior parte delle filiali FedEx Office): FedEx imballa la spedizione per conto vostro (a pagamento)
  • Disponibilità del materiale d'imballaggio (ovunque viene fornito il materiale d'imballaggio FedEx Express; non include il materiale FedEx Ground)
  • Filiali di consegna FedEx Express con ultimo orario di consegna: restituisce le filiali vicino a voi con l'ultimo orario di consegna
  • Consegna Express dopo: consegnate un collo dopo un'ora specifica, come le 17:00. Usate questo elemento per cercare filiali di consegna aperte dopo le 17:00

Nota: l'API ricerca filiali FedEx restituisce fino a 75 filiali in un raggio di 32 km dal vostro indirizzo

Filiali FedEx

Filiali FedEx Ship Center®: consegnate i colli e ricevete informazioni sulla spedizione

Gli specialisti delle spedizioni nelle filiali FedEx Ship Center possono aiutarvi a scegliere il servizio di consegna, a compilare la documentazione e a elaborare i colli. Molte filiali sono aperte fino a tardi e il sabato per tener conto dei vostri impegni.

  • Consegnate le spedizioni o FedEx le elaborerà per voi al banco.
  • Acquistate scatole e altro materiale d'imballaggio.
  • Consultate il FedEx Dropoff Locator per l'elenco dei servizi, come servizio il sabato, offerti in ogni filiale.
  • Addebitate le spedizioni sul vostro codice cliente FedEx, oppure usate assegni, carte di credito o contanti, che sono accettati nella maggior parte delle filiali.

Nota: è necessario un codice cliente FedEx per spedire i colli FedEx International Ground® presso un FedEx Ship Center e gli altri centri di spedizione.

Filiali FedEx Authorized ShipCenter®: filiali imballa e spedisci indipendenti

Recatevi in queste filiali indipendenti per servizi di imballaggio e spedizione. La maggior parte offre anche servizi di fax, fotocopiatura e altri servizi commerciali.

  • Cercate punti vendita imballa e spedisci come AIM Mail Center®, PakMail®, PostalAnnex+®e PostNet®, nonché filiali associate alla Association of Mail and Business Centers e Retail Shipping Associates.
  • Nella maggior parte di queste filiali è possibile spedire sia colli FedEx Express che FedEx Ground. Per maggiori informazioni consultate il FedEx Dropoff Locator.

Nota: le tariffe per l'elaborazione dei colli riflettono le politiche tariffarie di ogni filiale. Queste filiali possono applicare supplementi alle tariffe FedEx.

Filiali FedEx ShipSite at Office Depot® e OfficeMax®: pratico accesso a servizi di spedizione

I servizi FedEx® sono disponibili in tutte le sedi Office Depot e OfficeMax. Queste sedi offrono servizi di spedizione USA e internazionale FedEx Express e FedEx Ground, per cui potete consegnare i colli o gestirli direttamente al banco, acquistare materiale d'imballaggio e gestire altre esigenze aziendali, il tutto in un unico luogo.

Filiali FedEx Drop Box: più di 35.000 filiali

Esistono più di 35.000 cassette di consegna in uffici, centri commerciali, aeroporti, filiali FedEx Office, negozi di alimentari e altri pratici luoghi.

  • Inviate le vostre spedizioni FedEx Express, FedEx Ground e FedEx Ground® Economy (in precedenza FedEx SmartPost®). Le spedizioni FedEx Ground possono richiedere un giorno in più per la consegna.
  • Tutte le cassette accettano colli fino a 50,8 x 30,48 x 15,24 cm (molte accettano colli fino a 50,8 x 30,48 x 22,86).
  • La maggior parte ha una quantità limitata di lettere di vettura FedEx Express e di materiale d'imballaggio.
  • Tutte offrono il ritiro dal lunedì al venerdì e alcune anche il sabato.
  • Non utilizzate le cassette di consegna per i colli FedEx SameDay® .
  • Le batterie al litio IATA Sezione II e le sostanze biologiche Categoria B (UN 3373) sono le uniche merci pericolose che possono essere inserite nelle cassette di consegna.
  • Non si accettano pagamenti in contanti, assegni o carte di credito.

Filiali FedEx OnSite: ritirate e consegnate laddove fate acquisti

Grazie alle filiali FedEx OnSite, potete ritirare e consegnare i colli FedEx dove vi è più comodo. Queste filiali sono vicine ai luoghi in cui lavorate, vivete e vi divertite, e alcune hanno persino un orario di apertura prolungato. FedEx è presente in quasi 9.000 punti vendita Walgreens e in alcuni punti vendita Dollar General, Albertsons e Kroger negli Stati Uniti e a Porto Rico dove è possibile fare quanto segue.

  • Depositare i colli in un luogo sicuro per poterli ritirare a vostro piacimento
  • Consegnare spedizioni USA e internazionali preconfezionate e preetichettate FedEx Express e FedEx Ground. Il peso massimo dei singoli colli è 25 kg e le dimensioni massime sono 121 cm di lunghezza, 63 cm di larghezza e 63 cm di altezza.

Regole aziendali

  • Le filiali FedEx Office, FedEx OnSite e alcuni FedEx Authorized ShipCenter non accettano merci pericolose, animali vivi, tabacco o altri materiali regolamentati e spedizioni pericolose.
  • Limiti di peso per tipo di filiale
    • Le filiali FedEx Office e FedEx Ship Center possono accettare colli in fermo deposito più grandi e pesanti rispetto alle filiali FedEx Authorized ShipCenter e FedEx OnSite.
    • Le filiali FedEx Ship Center accettano colli che superano i 68 kg di peso, i 302 cm di lunghezza e/o i 419 cm di larghezza e circonferenza (lunghezza + 2 x larghezza + 2 x altezza) che non possono essere consegnati ad altre filiali.
    • Le filiali FedEx Office accettano colli con un peso massimo di 68 kg, una lunghezza massima di 302 cm e/o 419 cm di larghezza e circonferenza (lunghezza + 2 x larghezza + 2 x altezza).
    • Le filiali FASC e FedEx OnSite (ad es. Walgreens) accettano colli con un peso massimo di 25 kg e dimensioni massime di 121 x 63 x 63 cm.

Ritiro API JSON

Documentation Powered by ReDoc

FedEx Location Search API (1.0.0)

Find Locations

Use this endpoint to search for nearest FedEx locations by address, geographicccc coordinates, or phone numberrrr. You can also narrow your search by type of location and services offered. It returns up to 75 locations within a 50-mile radius for the address used in the search criteria. Results are based on current date and time. Supports all FedEx operating companies and countries, dependent upon being able to get a valid geolocation for a given set of criteria.
Note: You must specify landline numbers only, when searching for the nearest FedEx locations using phone 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_Find_Location
  • Search_Location_for_Postal_Aware_Country
  • Search_Location_for_Non_Postal_Aware_Country
  • Search_Location_by_US_domestic_Postal_Address
  • Search_Location_by_International_Postal_Address
  • Search_Location_by_Geographic_Coordinates
  • Search_Location_by_Phone_Number
  • Search_Location_HOLD_AT_LOCATION
  • Search_Location_OFFICE_AND_ONSITE
  • Search_Location_by_RETURNS_SERVICES
locationsSummaryRequestControlParameters
object

Use this object to specify all the inputs to get the locations details.

constraints
object

Specify the constraints to be applied to the location attributes.

locationSearchCriterion
string
Enum: "ADDRESS" "GEOGRAPHIC_COORDINATES" "PHONE_NUMBER"

Specify the criteria to be used to search for FedEx locations. Default value is ADDRESS if no value is passed.

Valid values:

  • ADDRESS – Search by address. Location detail data is required.
  • GEOGRAPHIC_COORDINATES – Search by geocodes. Location geocodes are required.
  • PHONE_NUMBER – Search by phone number. Location Phone number is required.

Note: Country code is REQUIRED when searching by any of the LocationsSearchCriterion, even PhoneNumber and GeorgraphicCoordinates.

location
required
object

Based on the locationSearchCriterion value specified, the location element specifies the minimum requirement for address search like postalCode, countryCode, GeoCodes or city.Location phone number is required. Only landline number is allowed.

Note: Country code is REQUIRED for the search.

phoneNumber
string

Specify the phone number(Only LandLine allowed) if the locationSearchCriterion is set to 'PHONE_NUMBER'.Given that is the case, the location search will be made based on the phone number value and the location object(postalCode&countryCode) will be completely ignored.
Example: 9015551234

multipleMatchesAction
string
Enum: "RETURN_ALL" "RETURN_ERROR" "RETURN_FIRST"

Specify the criterion to be used to return location results when there are multiple matches.
Valid values: RETURN_ALL,RETURN_ERROR, RETURN_FIRST.

Note: The 'maxResults' value takes precedence over RETURN_ALL value.

sort
object (Sort)

Specifies how the location search results will be sorted in the reply.

trackingInfo
object (TrackingInfo)

Information uniquely identifying a shipment such as Tracking number, ShipDate, and Tracking number uniqueId. This tracking information helps to return the correct list of locations when REDIRECT_TO_HOLD_AT_LOCATION is requested

sameState
boolean

Filter to display locations within the same state as the search criteria.
Valid values: True, False.

sameCountry
boolean

Filter to display locations within the same country as the search criteria.
Valid values: True, False.

redirectToHoldType
string
Enum: "FEDEX_EXPRESS" "FEDEX_GROUND" "FEDEX_GROUND_HOME_DELIVERY"

Specify the type of service supported by a FedEx location for redirect to hold.

locationAttrTypes
Array of strings
Items Enum: "ACCEPTS_CASH" "FEDEX_RETURNS_TECHNOLOGY" "ALREADY_OPEN" "COPY_AND_PRINT_SERVICES" "DANGEROUS_GOODS_SERVICES" "DIRECT_MAIL_SERVICES" "LOCATION_IS_IN_AIRPORT" "NOTARY_SERVICES" "OPEN_TWENTY_FOUR_HOURS" "PACK_AND_SHIP" "PACKAGING_SUPPLIES" "PASSPORT_PHOTO_SERVICES" "RETURNS_SERVICES" "SIGNS_AND_BANNERS_SERVICE" "SONY_PICTURE_STATION" "DROP_BOX" "DOMESTIC_SHIPPING_SERVICES" "INTERNATIONAL_SHIPPING_SERVICES" "CLEARANCE_SERVICES"

Specify attributes to filter location types. If more than one value is specified, only those locations that have all the specified attributes will be returned.
Note: In order to filter for DROP_BOX location, need to add locationTypes as FEDEX_SELF_SERVICE_LOCATION

locationCapabilities
Array of objects (LocationCapabilities)

Specify to filter the locations based on their capabilities.

packageAttributes
Array of objects (PackageAttribute)

Specify location supported package constraints to narrow the search.

For example, a package weighing more than 151 pounds may not be supported at all location types. Drop box location would be excluded.

Note: The package attributes inputs are only recognized/supported for FedEx OnSite Locations.

locationTypes
Array of strings
Items Enum: "FEDEX_AUTHORIZED_SHIP_CENTER" "FEDEX_OFFICE" "FEDEX_SELF_SERVICE_LOCATION" "FEDEX_ONSITE" "FEDEX_EXPRESS_STATION" "FEDEX_SHIPSITE" "FEDEX_SHIP_AND_GET"

Results filter which narrows the search to specific types of FedEx Locations.

includeHoliday
boolean

Indicates true if the location holiday list is desired in the results; otherwise false
Valid values: True, False.

dropoffTime
string

Specifies the latest time by which you can drop-off a package at a location to process the shipment the same day. This limits the results to locations that support a specific drop-off time. The format is an ISO 8601 string in which only the time portion is used.
Example: 16:00:00

dropOffServiceType
string

The drop-off service types supported by the specified location. If sort criteria is given as LATEST_EXPRESS_DROPOFF_TIME and dropoffservicetype is GROUND then backend will take the SORT_BY_LATEST_GROUND_TIME as sort criteria.
Example: FedEx Ground.

carrierCodes
Array of strings
Items Enum: "FDXE" "FDXG"

Unique code to identify the transporter.

getCall
boolean

Get a call.
Valid values: True, False.

Responses

200

Success

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Failure

503

Service Unavailable

post /location/v1/locations

Sandbox Server

https://apis-sandbox.fedex.com/location/v1/locations

Production Server

https://apis.fedex.com/location/v1/locations

Request samples

Content type
application/json
Example
Full_Schema_Find_Location
Copy
 Expand all Collapse all
{
  • "locationsSummaryRequestControlParameters":
    {
    },
  • "constraints":
    {
    },
  • "locationSearchCriterion": "ADDRESS",
  • "location":
    {
    },
  • "phoneNumber": "9015551234",
  • "multipleMatchesAction": "RETURN_ALL",
  • "sort":
    {
    },
  • "trackingInfo":
    {
    },
  • "sameState": true,
  • "sameCountry": true,
  • "redirectToHoldType": "FEDEX_GROUND",
  • "locationAttrTypes":
    [
    ],
  • "locationCapabilities":
    [
    ],
  • "packageAttributes":
    [
    ],
  • "locationTypes":
    [
    ],
  • "includeHoliday": true,
  • "dropoffTime": "09:30:00",
  • "dropOffServiceType": "GROUND",
  • "carrierCodes":
    [
    ],
  • "getCall": false
}

Response samples

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

Response

Copy