Fedex Logo
Developer Portal

FedEx Locations Search API

Introducere

Locațiile FedEx sunt puncte de ridicare și predare administrate de furnizorii de servicii de expediere FedEx. Puteți expedia un colet de la o locație de ridicare către o locație de predare folosind orice transportator FedEx. Acest API vă ajută să căutați locații de expediere acceptate și disponibile prin utilizarea unei adrese, a unor coordonate geografice sau a unui număr de telefon.

API-ul de căutare a locațiilor FedEx caută și returnează adresele celor mai apropiate locații de predare a coletelor FedEx, inclusiv centre de tipărire și expediere FedEx Office® și locații FedEx Drop Box disponibile pentru predarea coletelor FedEx Express® și FedEx Ground®.

Detaliile API-ului de căutare a locațiilor FedEx

API-ul de căutare a locațiilor FedEx vă permite să căutați locații de predare FedEx în funcție de adresă, coordonate geografice sau număr de telefon.

API-ul de căutare a locațiilor FedEx vă permite să căutați locații pe baza următoarelor criterii:

  • Centre de expediere autorizate
  • Centre de predare autorizate
  • Locații Păstrare în locație
  • Locații Drop Box
  • Locații care acceptă expedieri de bunuri/mărfuri periculoase

Funcțiile API-ului de căutare a locațiilor FedEx includ:

  • Căutarea celei mai apropiate locații de ridicare și predare FedEx
  • Regăsirea adresei detaliate a locației, inclusiv codul poștal, codul de țară etc.

Cum funcționează API-ul de căutare a locațiilor FedEx

API-ul de căutare a locațiilor facilitează solicitarea locațiilor FedEx disponibile pentru predarea coletelor FedEx Express® și FedEx Ground®. Această tranzacție caută și afișează adresele celei mai apropiate locații FedEx. Puteți utiliza acest API inclusiv pentru a găsi locațiile FedEx care oferă serviciul Păstrare în locație.

Găsirea locațiilor

Această solicitare este utilizată pentru returnarea unei liste cu toate locațiile disponibile pe baza detaliilor introduse. Informațiile cheie de introdus asociate cu această interogare sunt următoarele:

  • Adresa locației
  • Distanța (valoarea și unitățile de măsură pentru raza din jurul adresei unde se caută locații FedEx).

Notă: Codul poștal este obligatoriu pentru țările care utilizează astfel de coduri. Pentru țările care nu au astfel de coduri, trebuie introduse orașul și țara pentru obținerea locațiilor FedEx valide.

Rezultatul acestei solicitări este o listă detaliată a tuturor locațiilor FedEx, disponibile pentru ridicarea și predarea expedierilor, împreună cu informații cheie, cum ar fi distanța, programul de funcționare, detaliile transportatorului, serviciile și capacitățile locației disponibile în zilele lucrătoare, capacitatea de a preda/prelua expedieri, capacitatea de a păstra expedierile până la ridicare etc.

Funcțiile principale ale API-ului de căutare a locațiilor FedEx

Restrângeți căutarea după locație

Puteți restrânge căutarea după tipul de locație. În solicitarea de căutare se poate specifica unul, mai multe sau toate tipurile de locații FedEx enumerate:

  • Locații FedEx Authorized ShipCenter®: Accesați rețeaua de transport FedEx în peste 5.800 de locații de ambalare și expediere (FASC) deținute și operate în mod independent în SUA. Magazinele care participă la programul FedEx Authorized ShipCenter oferă și alte servicii comerciale. Locațiile FedEx Authorized ShipCenterx pot aplica taxe suplimentare față de tarifele publicate de FedEx.
  • FedEx ShipCenter®
  • Punct Express
  • FedEx ShipSite
  • Locație FedEx Office®
  • Locație FedEx cu autoservire: predare de colete FedEx Express și FedEx Ground (maximum 50,8 x 30,48 x 15,24 cm) la un Drop Box FedEx Express®;
  • Pentru serviciul Păstrare în locație sunt acceptate următoarele tipuri de locații:
    • FedEx OnSite – colete FedEx Express și FedEx Ground
    • FedEx Office – colete FedEx Express și FedEx Ground
    • Puncte Express – numai colete FedEx Express
    • Locații FedEx Ship Center – colete FedEx Express și FedEx Ground și bunuri/mărfuri periculoase aprobate.

Capacitățile din locații

În plus, solicitarea de căutare acceptă un atribut pentru a specifica faptul că locațiile acceptă capacitatea Redirecționare către stație de păstrare pentru colete FedEx Express sau FedEx Ground și atribute pentru a specifica capacitățile din locație, cum ar fi:

  • Servicii de retur
  • Predări Ground
  • Numerar
  • Ambalare și expediere
  • Materiale de ambalare
  • Serviciu de semne și bannere
  • Sony PictureStation
  • Servicii de publicitate prin poștă
  • Servicii de copiere și imprimare
  • Servicii pentru bunuri/mărfuri periculoase
  • Locația este în aeroport
  • Servicii notariale
  • Se respectă orele de vară
  • Servicii de fotografii pentru pașaport
  • Drop box
  • Servicii de expediere internă
  • Servicii de expediere internațională

Sortarea rezultatelor

API-ul de căutare a locațiilor FedEx vă permite să sortați rezultatele după:

  • Ora limită de predare FedEx Express
  • Ora limită de predare FedEx Ground
  • Tipul de locație
  • Distanță, în ordine crescătoare
  • Distanță, în ordine descrescătoare

Criterii de căutare suplimentare

Vă puteți restrânge căutarea inclusiv în funcție de următoarele aspecte:

  • Disponibilitatea serviciului sâmbăta.
  • Disponibilitatea serviciului de ambalare (majoritatea locațiilor Birou FedEx): FedEx va ambala în locul dvs. coletul de expediat (contra cost).
  • Disponibilitatea consumabilelor pentru ambalare (oriunde sunt furnizate materiale de ambalare FedEx Express; nu include materiale FedEx Ground).
  • Locații de predare FedEx Express cu oră limită: locații de retur cu oră limită de predare din apropierea ta.
  • Predare Express după: predați un colet după o anumită oră, de exemplu, 17:00. Utilizați acest element pentru a căuta locații de predare deschise după ora 17:00.

Notă: API-ul de căutare a locațiilor FedEx returnează până la 75 de locațiile aflate pe o rază de 50 mile (80,46 km) în jurul adresei dvs.

Locații FedEx

Locațiile FedEx Ship Center®: Predați pachete și obțineți informații privind expedierea

Specialiștii în expedieri din locațiile FedEx Ship Center vă pot ajuta să alegeți un serviciu de livrare, să completați documentația și să vă procesați coletele. Multe locații sunt deschise până târziu și sâmbăta pentru a se adapta la programul dvs.

  • Predați coletele de expediat sau FedEx le va procesa în locul dvs. la ghișeu.
  • Achiziționați cutii și alte materiale de ambalare.
  • Utilizați instrumentul FedEx de localizare a punctelor de predare pentru a vedea lista de servicii, precum serviciu de lucru sâmbăta, oferite în fiecare locație.
  • Încărcați expedierile în contul dvs. FedEx sau folosiți cecuri, carduri de credit sau numerar care sunt acceptate în majoritatea locațiilor.

Notă: Trebuie să aveți un număr de cont FedEx pentru a expedia colete FedEx International Ground® la un centru FedEx Ship Center și în celelalte locații de expediere ale noastre.

Locații FedEx Authorized ShipCenter®: Locații de ambalare și expediere deținute independent

Treceți pe la aceste locații deținute independent pentru a beneficia de servicii de ambalare și expediere. Cele mai multe oferă și servicii de fax, copiere și alte servicii profesionale.

  • Căutați comercianți cu amănuntul care oferă servicii de ambalare și expediere, cum ar fi AIM Mail Center®, PakMail®, PostalAnnex+®și PostNet®, precum și locațiile afiliate la Association of Mail and Business Centers și la Retail Shipping Associates.
  • În majoritatea acestor locații puteți expedia colete atât FedEx Express, cât și FedEx Ground. Pentru mai multe informații, utilizați instrumentul FedEx de localizare a punctelor de predare.

Notă: Tarifele pentru procesarea coletelor reflectă politica de prețuri a fiecărei locații. Aceste locații pot aplica taxe suplimentare față de tarifele FedEx.

Servicii FedEx ShipSite în locații Office Depot® și OfficeMax®: Acces convenabil la servicii de expediere

Serviciile FedEx® sunt disponibile în toate locațiile Office Depot și OfficeMax. Aceste locații oferă servicii de expediere FedEx Express și FedEx Ground în SUA și la nivel internațional, astfel încât puteți să predați coletele sau să le procesați la ghișeu, să achiziționați consumabile pentru ambalare și să vă ocupați de alte activități profesionale, toate într-un singur loc convenabil.

Locații FedEx Drop Box: Peste 35.000 de locații

Există peste 35.000 de locații Drop Box în clădiri de birouri, centre comerciale, aeroporturi, locații FedEx Office, magazine alimentare și alte locații convenabile.

  • Predați expedierile FedEx Express, FedEx Ground și FedEx Ground® Economy (denumit anterior FedEx SmartPost®). Este posibil ca pentru expedierile FedEx Ground să fie nevoie de o zi în plus pentru livrare.
  • În toate cutiile de predare sunt acceptate colete cu dimensiunea maximă 50,8 x 30,48 x 15,24 cm (multe acceptă colete cu dimensiunea maximă 50,8 x 30,48 x 22,86 cm).
  • Multe au o cantitate limitată de foii de expediție aeriană FedEx Express și de consumabile.
  • Toate oferă servicii de preluare de luni până vineri, iar unele oferă servicii de preluare inclusiv sâmbăta.
  • Nu plasați colete FedEx SameDay®  în cutiile de predare.
  • Bateriile cu litiu menționate la secțiunea II din IATA și substanțele biologice de categorie B (ONU 3373) sunt singurele bunuri/mărfuri periculoase care pot fi plasate în cutii de predare.
  • Nu se acceptă plăți cu numerar, cecuri sau carduri de credit.

Locațiile FedEx OnSite: Ridicați și predați colete acolo unde vă faceți cumpărăturile

Datorită locațiilor FedEx OnSite, puteți să preluați și să predați colete FedEx acolo unde vă este cel mai convenabil. Acestea sunt aproape de locul în care lucrați, locuiți și vă distrați, iar unele sunt deschise chiar și cu program prelungit. FedEx are aproape 9.000 de locații Walgreens și anumite locații Dollar General, Albertsons și Kroger în SUA și Puerto Rico, unde puteți:

  • să păstrați pachetele într-o locație securizată pentru a le putea ridica când vă convine;
  • să predați expedieri FedEx Express și FedEx Ground preambalate și preetichetate pentru SUA și străinătate. Pachetele individuale pot cântări până la 25 kg și măsura până la 122 cm lungime x 63,5 cm lățime x 63,5 cm înălțime.

Reguli pentru afaceri

  • Locațiile FedEx Office, locațiile FedEx OnSite și anumite locații FedEx Authorized ShipCenter nu acceptă bunuri/mărfuri periculoase, animale vii, tutun sau alte materiale reglementate și expedieri periculoase.
  • Restricții de greutate în funcție de tipul de locație
    • Locațiile FedEx Office și FedEx Ship Center pot accepta colete cu Păstrare în locație mai mari și mai grele decât anumite locații FedEx Authorized ShipCenter și locații FedEx OnSite.
    • Locațiile FedEx Ship Center acceptă colete care depășesc 68 kg, 302,26 cm lungime și/sau 419,1 cm lungime și circumferință (L+2l+2h) și care nu pot fi livrate în alte locații.
    • Locațiile FedEx Office acceptă colete cu o greutate maximă de 68 kg, cu o lungime maximă de 302,26 cm și/sau cu o lungime și circumferință maximă de 419,1 (L+2l+2h).
    • Locații FASC și FedEx OnSite (de exemplu, Walgreens) acceptă pachete cu o greutate maximă de 25 kg și cu o dimensiune maximă de 122 x 63,5 x 63,5 cm.

Colecție de API-uri 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