Fedex Logo
Developer Portal

FedEx Locations Search API

Giriş

FedEx şubeleri, FedEx gönderi sağlayıcılarının yönettiği alım/şubeye bırakma noktalarıdır. Herhangi bir FedEx taşıyıcısını kullanarak bir paketi alım noktasından şubeye bırakma noktasına gönderebilirsiniz. Bu API, desteklenen ve kullanılabilir gönderi şubelerini, adres, coğrafi koordinatlar veya telefon numarasıyla aramanızı sağlar.

FedEx Şube Arama API'si, FedEx Office® Baskı ve Gönderi Merkezleri ile FedEx Express® ve FedEx Ground® paketlerinin bırakılması için kullanılabilecek FedEx Drop Box şubeleri dahil olmak üzere en yakın FedEx paket bırakma şubelerinin adreslerini arar ve getirir.

FedEx Şubesi Arama API'si Ayrıntıları

FedEx Şubesi Arama API'si, FedEx paket bırakma şubelerini adrese, coğrafi koordinatlara ve telefon numarasına göre aramanızı sağlar.

FedEx Şubesi Arama API'si, şubeleri şunlara göre aramanıza olanak tanır:

  • Yetkili gönderi merkezleri
  • Yetkili paket bırakma merkezleri
  • Bekletme Şubeleri
  • Posta bırakma kutusu şubeleri
  • Tehlikeli madde gönderileri kabul eden şubeler

FedEx Şubesi Arama API'sinin özellikleri şunları içerir:

  • En yakın FedEx paket alım ve bırakma şubesini ara
  • Şubenin posta kodu, ülke kodu vs. içeren ayrıntılı adresini al

FedEx Şubesi Arama API'si Nasıl Çalışır?

Şube Arama API'si, FedEx Express® ve FedEx Ground® paket bırakma için kullanılabilecek şubelerin talep edilmesini sağlar. Bu işlem, en yakın FedEx şubesinin adresini arar ve getirir. Bu API'yi kullanarak Şubede Bekletme hizmeti sağlayan FedEx şubelerini de bulabilirsiniz.

Şubeleri Bul

Bu istek, girdi ayrıntılarına göre tüm uygun şubelerin bir listesini almak için kullanılır. Bu istekle ilişkili önemli girdi bilgileri aşağıdaki gibidir:

  • Yer adresi
  • Mesafe (FedEx şubelerinin aranacağı adresin çevresindeki yarıçapın değeri ve birimi)

Not: Posta kodu kabul edilen ülkeler için posta kodu zorunludur. Posta kodu kabul edilmeyen ülkeler için şehir ve ülkenin birlikte girilmesi durumunda geçerli FedEx şubeleri getirilir.

Bu talebin sonucu, tüm kullanılabilir FedEx alma ve bırakma şubelerinin yanı sıra mesafe, çalışma saatleri, taşıyıcı ayrıntıları, konum hizmeti ve haftanın günleri için sunulan işlevler, gönderileri bırakma/alma olanağı, gönderileri alım için bekletme olanağı vs. gibi önemli bilgilerdir.

FedEx Şubesi Arama API'si'nin Önemli Özellikleri

Aramanızı şubeye göre daraltma

Aramanızı şube türüne göre daraltabilirsiniz. Arama talebinde FedEx şube türlerinden biri, birden fazlası veya tümü belirtilebilir:

  • FedEx Authorized ShipCenter® şubeleri: ABD genelinde 5.800'ü aşkın bağımsız sahibi ve işletmecisi olan paketle ve gönder şubesine (FASC) erişin. FedEx Yetkili Gönderi Merkezi programına katılan şubeler, başka iş hizmetleri de sağlar. FedEx Yetkili Gönderi Merkezi şubeleri, FedEx'in ilan ettiği ücretlere ek ücretler uygulayabilir.
  • FedEx ShipCenter®
  • Ekspres Merkezi
  • FedEx ShipSite
  • FedEx Office® şubesi
  • FedEx self servis şubesi: FedEx Express ve FedEx Ground paketlerini (en fazla 20" x 12" x 6") bir FedEx Express® Posta Bırakma Kutusuna bırakın.
  • Şubede Bekletme hizmeti için şu şube türleri desteklenir:
    • FedEx OnSite – FedEx Express ve FedEx Ground paketleri
    • FedEx Office – FedEx Express ve FedEx Ground paketleri
    • Ekspres merkezleri – Yalnızca FedEx Express paketleri
    • FedEx Gönderi merkezleri – FedEx Express ve FedEx Ground paketleri ile onaylı tehlikeli maddeler

Şube İşlevleri

Arama talebi ayrıca, şubelerin FedEx Express veya FedEx Ground Şubede Bekletme Yönlendirmesi işlevini belirtme ve şubede şunlar gibi işlevleri belirtme özniteliğini destekler.

  • İade hizmetleri
  • Ground paket bırakma
  • Nakit
  • Paketle ve gönder
  • Ambalaj gereçleri
  • İmzalar ve reklamlar
  • Sony PictureStation
  • Direkt posta hizmetleri
  • Kopyalama ve yazdırma hizmetleri
  • Tehlikeli madde hizmetleri
  • Şube havalimanında
  • Noter hizmetleri
  • Yaz saatini gözetir
  • Pasaport fotoğraf hizmetleri
  • Posta bırakma kutusu
  • Yurtiçi gönderi hizmetleri
  • Uluslararası gönderi hizmetleri

Sonuçları Sıralama

FedEx Şube Arama API'si, sonuçları şunlara göre sıralamanızı sağlar:

  • En Geç FedEx Express paket bırakma saati
  • En Geç FedEx Ground paket bırakma saati
  • Şube türü
  • Mesafeye göre artan sıralamayla
  • Mesafeye göre azalan sıralamayla

Ek Arama Kriterleri

Aramanızı şu kriterlerle de daraltabilirsiniz:

  • Cumartesi günleri hizmet verir.
  • Paketleme hizmeti verir (çoğu FedEx Ofis şubesi): FedEx gönderinizi sizin adınıza (ücreti karşılığında) paketler.
  • Paketleme malzemeleri mevcut (FedEx Express paketleme malzemelerinin sağlandığı her yeri ifade eder; FedEx Ground malzemelerini içermez).
  • En Geç FedEx Express paket bırakma şubeleri: Yakınınızda en geç paket bırakma saatlerine sahip şubeleri getirir.
  • Şu saatten sonra Express paket bırakma: 5 p.m. gibi belirli bir saatten sonra paket bırakabilmenizi sağlar. Bu öğeyi kullanarak 5 p.m. sonrası saatlerde açık paket bırakma yerlerini arayabilirsiniz.

Not: FedEx Şube Arama API'si, adresinizin 50 mil çevresinde bulunan en fazla 75 şubeyi görüntüler.

FedEx Şubeleri

FedEx Gönderi Merkezi® şubeleri: Paket bırakın ve gönderi bilgileri edinin

FedEx Gönderi Merkezi şubelerinde bulunan gönderi uzmanları; teslimat hizmeti seçmenize, belgeleri doldurmanıza ve paketlerinizi işleme almanıza yardımcı olabilir. Programınıza uymak için birçok şube geç saatlere kadar ve cumartesi günleri hizmet verir.

  • Gönderilerinizi bırakabilir veya FedEx'in gönderileri sizin adınıza bankoda işlemesine izin verebilirsiniz.
  • Kutu ve başka paketleme malzemeleri alabilirsiniz.
  • Her şubede sunulan, Cumartesi hizmeti gibi hizmetlerin listesi için FedEx Paket Bırakma Şubesi Bulucuya göz atın.
  • Gönderilerinizi FedEx hesabınıza faturalandırabilir veya çoğu şubede kabul edilen çek, kredi kartı veya nakit gibi ödeme araçlarını kullanabilirsiniz.

Not: FedEx Gönderi Merkezleri ve diğer gönderi şubelerinde FedEx International Ground® paketlerini göndermek için FedEx hesap numaranız olmalıdır.

FedEx Yetkili Gönderi Merkezi® şubeleri: Bağımsız olarak paketle ve gönder şubeleri

Paketleme ve gönderi hizmetleri için bağımsız kişilerin sahip olduğu bu şubelere uğrayabilirsiniz. Bu şubelerin çoğu faks, fotokopi ve başka iş hizmetleri de sunar.

  • AIM Mail Center®, PakMail®, PostalAnnex+®and PostNet® gibi paketle ve gönder şubelerinin yanı sıra Posta ve İş Merkezleri Birliği ve Perakende Gönderi Ortaklarına bağlı şubeleri arayın.
  • Bu şubelerin çoğundan FedEx Express ve FedEx Ground paketlerinizi gönderebilirsiniz. Daha fazla bilgi için FedEx Paket Bırakma Yeri Bulucuyu inceleyin.

Not: Paket işleme ücretleri, her şubenin fiyatlandırma politikasına bağlıdır. Bu şubeler, FedEx ücretlerine ek ücretler uygulayabilir.

Office Depot® ve OfficeMax® içerisinde bulunan FedEx ShipSite şubeleri: Gönderi hizmetlerine kolay erişim

FedEx® Hizmetleri tüm Office Depot ve OfficeMax şubelerinde mevcuttur. Bu şubelerin FedEx Express, FedEx Ground ABD ve uluslararası gönderi hizmetleri sağlaması sayesinde tek bir yerde paketlerinizi bırakabilir veya bankoda işleyebilir, paketleme malzemeleri alabilir ve diğer iş ihtiyaçlarınızı karşılayabilirsiniz.

FedEx Drop Box şubeleri: 35.000'den fazla şube

Ofis binaları, alışveriş merkezleri, havaalanları, FedEx Office şubeleri, marketler ve kolayca erişebileceğiniz diğer birçok yerde 35.000'den fazla posta bırakma kutusu vardır.

  • FedEx Express, FedEx Ground ve FedEx Ground® Economy (eski adı FedEx SmartPost®) gönderilerinizi şubeye bırakın. FedEx Ground gönderilerinin teslim edilmesi bir gün fazla sürebilir.
  • Posta bırakma kutuları, 20\" x 12\" x 6\" ölçülerine kadar paketleri kabul eder (birçoğu 20\" x 12\" x 9\" ölçülerine kadar paketleri de kabul eder).
  • Şubelerin çoğunda sınırlı miktarda FedEx Express konşimentosu ve paketleme malzemesi bulunur.
  • Tüm şubeler pazartesi​–​cuma arası paket alım hizmeti sunarken, bazıları cumartesi günleri de paket alır.
  • FedEx SameDay® paketlerini posta bırakma kutusuna koymayın.
  • Posta bırakma kutularına tehlikeli madde olarak yalnızca IATA Bölüm II kapsamındaki lityum piller ve B Kategorisindeki (UN 3373) Biyolojik Maddeler bırakılabilir.
  • Nakit, çek veya kredi kartı ile ödeme kabul edilmez.

FedEx OnSite şubeleri: Paketlerinizi, alışveriş yaptığınız yerlerde alın veya bırakın

FedEx Onsite şubeleriyle, FedEx paketlerinizi size en uygun konumlarda alabilir ve bırakabilirsiniz. Çalıştığınız, yaşadığınız ve eğlendiğiniz yerlere yakın olan bu şubelerin bazıları, geç saatlere kadar hizmet vermektedir. FedEx'in ABD ve Porto Riko'da Walgreens, seçili Dollar General, Albertsons ve Kroger mağazalarında hizmet veren yaklaşık 9.000 şubesi vardır. Bu şubelerde yapabilecekleriniz şunlardır:

  • Paketlerinizin, kolayca teslim alacağınız zamana kadar güvenli bir yerde olmasını sağlayabilirsiniz.
  • Önceden paketlenmiş ve etiketlenmiş FedEx Express ve FedEx Ground ABD ve uluslararası gönderilerini bırakabilirsiniz. Paketlerin ağırlığı en fazla 55 lbs olmak üzere 48" uzunluk, 25\" genişlik ve 25\" yükseklik ölçülerine kadar izin verilir.

İş Kuralları

  • FedEx Office şubeleri, FedEx OnSite şubeleri ve seçili FedEx Yetkili Gönderi Merkezi şubelerine tehlikeli madde, canlı hayvan, tütün veya yönetmeliklere tabi diğer yurt içi tehlikeli gönderilerin bırakılmasına izin verilmez.
  • Konum Türüne Göre Ağırlık Kısıtlamaları
    • FedEx Office ve FedEx Ship Center şubeleri, seçili FedEx Yetkili Gönderi Merkezi şubelerinden ve Fedex OnSite şubelerinden daha büyük ve ağır Şubede Beklet paketleri kabul edebilir.
    • FedEx Gönderi Merkezi şubeleri, diğer şubelere teslim edilemeyecek, 150 lbs ağırlık, 119" uzunluk ve(ya) 165\" uzunluk ve çevre ölçüsü (Uzunluk + 2 Genişlik + 2 Yükseklik) ölçülerinden büyük paketleri kabul eder.
    • FedEx Office şubeleri maksimum 150 lbs ağırlığa, 119″ ve/veya 165″ uzunluğa ve çevre ölçüsüne (Uzunluk + 2 Genişlik + 2 Yükseklik) sahip gönderileri kabul eder.
    • FASC ve FedEx OnSite (ör. Walgreens) şubeleri, ağırlığı en fazla 55 lbs, boyutu en fazla 48\" x 25\" x 25\" olan paketleri kabul eder.

JSON API Koleksiyonu

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