Fedex Logo
Developer Portal

FedEx Locations Search API

Bevezetés

A FedEx kirendeltségei a FedEx szállítási szolgáltatói által kezelt átvételi és leadási pontok. Egy csomagot bármelyik FedEx-fuvarozóval elküldhet egy átvételi helyről egy leadási helyre. Ez az API segít a támogatott és elérhető szállítási helyszínek keresésében cím, földrajzi koordináták vagy telefonszám alapján.

A FedEx kirendeltség-kereső API megkeresi, majd megjeleníti a legközelebbi FedEx csomagfeladási helyek címét, beleértve a következőket is: FedEx Office® nyomtatási és szállítási központok, FedEx Drop Box-kirendeltségek a FedEx Express® és FedEx Ground® küldeményleadási kirendeltségei.

A Kirendeltségkereső API részletes adatai

A FedEx kirendeltség-kereső API segítségével FedEx küldeményleadási pontokra kereshet rá cím, földrajzi koordináták vagy telefonszám alapján.

A FedEx kirendeltség-kereső API lehetővé teszi, hogy Ön az alábbiak alapján keressen rá a kirendeltségekre:

  • Megbízott szállítási központok
  • Megbízott leadási központok
  • Kirendeltségen tartandó
  • A Drop box kirendeltségei
  • Olyan kirendeltségek, amelyek elfogadják a veszélyes árukat tartalmazó küldeményeket

A FedEx kirendeltség-kereső API funkciói magukban foglalják a következőket:

  • A legközelebbi FedEx átvételi és leadási kirendeltség megkeresése
  • A kirendeltség részletes címének (beleértve többek között a postai irányítószámot és az országkódot) lekérdezése

A FedEx kirendeltség-kereső API működése

A kirendeltség-kereső API lehetővé teszi az olyan FedEx kirendeltségek lekérdezését, amelyek elérhetők a FedEx Express® és a FedEx Ground® csomagleadásához. Ez a tranzakció megkeresi, majd megjeleníti a legközelebbi FedEx kirendeltség címét. Ezt az API-t továbbá olyan FedEx kirendeltségek keresésére is használhatja, amelyek biztosítják a „kirendeltségen tartandó” szolgáltatást.

Kirendeltségek keresése

Ez a kérés az összes elérhető kirendeltség kilistázására szolgál a megadott adatok alapján. A kérelemhez kapcsolódó legfontosabb beviteli adatok a következők:

  • Kirendeltség címe
  • Távolság (a cím hatótávolságán belüli érték és egységek a FedEx kirendeltségek kereséséhez)

Megjegyzés: A postai szolgáltatásokat támogató országok esetén kötelező a postai irányítószám megadása. A postai szolgáltatásokat nem támogató országok esetén a város és az ország kombinációja adja meg az érvényes FedEx kirendeltségeket.

Ennek a kérésnek az eredménye egy részletes lista az összes elérhető FedEx-átvételi és -leadási helyről, olyan kulcsfontosságú információkkal együtt, mint a távolság, az üzlet nyitvatartási ideje, a fuvarozó adatai, a hétköznapokon elérhető szolgáltatás és lehetőségek, a küldemények leadásának/felvételének lehetősége, a küldemények átvételre való visszatartásának lehetősége stb.

A FedEx kirendeltség-kereső API főbb funkciói

Szűkítse a keresést kirendeltség alapján

Leszűkítheti a keresést a kirendeltség típusa alapján. A keresési kérelemben megadható egy, több vagy az összes felsorolt FedEx kirendeltségtípus:

  • A FedEx hivatalos ShipCenter® szállítási központ kirendeltségei: Hozzáférhet FedEx szállítási hálózatához több mint 5800 független tulajdonú és működtetésű csomagolási és szállítási helyszínen (FASC) szerte az Egyesült Államokban. A FedEx hivatalos ShipCenter szállítási központ programjában részt vevő üzletek más üzleti szolgáltatásokat is nyújtanak. A FedEx hivatalos ShipCenter szállítási központ kirendeltségei további díjakat számíthatnak fel a FedEx nyilvános díjain felül.
  • FedEx ShipCenter®
  • Express-állomás
  • FedEx ShipSite
  • FedEx Office® kirendeltsége
  • A FedEx önkiszolgáló kirendeltsége: FedEx Express és FedEx Ground csomagok leadása (legfeljebb 20” x 12” x 6”) FedEx Express® Drop Box-nál.
  • A „kirendeltségen tartandó” funkció esetén a következő kirendeltségtípusok támogatottak:
    • FedEx OnSite – FedEx Express és FedEx Ground csomagok
    • FedEx Office – FedEx Express és FedEx Ground csomagok
    • Express-állomások – Csak FedEx Express csomagok esetén
    • FedEx Ship centerek – FedEx Express és FedEx Ground csomagok és jóváhagyott veszélyes áruk esetén

A kirendeltség képességei

Ezenkívül a keresési kérelem támogat egy attribútumot annak meghatározására, hogy a helyszínek támogatják-e a FedEx Express vagy FedEx Ground „átirányítás megőrzésre” nevű funkcióját, valamint attribútumokat a helyszín képességeinek meghatározására, mint például:

  • Visszáru-szolgáltatások
  • Ground-leadások
  • Készpénz
  • Csomagolás és feladás
  • Csomagolóanyagok
  • Jelek és feliratok szolgáltatása
  • Sony Picture Station
  • Célzott reklámlevél szolgáltatása
  • Másolási és nyomtatási szolgáltatások
  • Veszélyes áruk szolgáltatása
  • Reptéren található kirendeltség
  • Közjegyzői szolgáltatások
  • A nyári időszámítás betartása
  • Útlevélfotó-szolgáltatások
  • Gyűjtődoboz
  • Belföldi szállítási szolgáltatások
  • Nemzetközi szállítási szolgáltatás

Rendezési eredmények

A FedEx kirendeltség-kereső API segítségével az alábbiak szerint rendezheti az eredményeket:

  • Legkésőbbi FedEx Express leadási idő
  • Legkésőbbi FedEx Ground leadási idő
  • Kirendeltség típusa
  • Távolság szerint növekvő sorrendben
  • Távolság szerint csökkenő sorrendben

További keresési feltételek

Leszűkítheti a keresést az alábbiak alapján is:

  • Szombati szolgáltatás is elérhető.
  • Elérhető csomagolási szolgáltatás (a legtöbb Fedex Office-kirendeltségen): A FedEx becsomagolja Önnek a küldeményét (felárral).
  • Elérhető csomagolóanyagok (bárhol, ahol FedEx Express csomagolóanyagot biztosítanak; nem tartalmazza a FedEx Ground csomagolóanyagot).
  • Legutóbbi FedEx Express-leadási kirendeltségek: Visszaadja az Önhöz közeli helyszíneket a legutóbbi leadási idővel.
  • Express későbbi leadás: Adja le a csomagot egy meghatározott időpont után, például 17:00 órakor. Ezzel az elemmel keresheti meg a 17:00 után nyitva tartó leadási kirendeltségeket.

Megjegyzés: A FedEx kirendeltség-kereső API legfeljebb 75 helyszínt ad vissza az Ön címének 50 mérföldes hatókörében

FedEx kirendeltségek

A FedEx Ship Center® kirendeltségei: Csomagok leadása és szállítási információk lekérése

A FedEx Ship Center kirendeltségein található szállítási specialisták segítenek Önnek kiválasztani a szállítási szolgáltatást, kitölteni a dokumentumokat és feldolgozni a csomagjait. Számos kirendeltség van nyitva sokáig illetve szombaton is annak érdekében, hogy igazodjanak az Ön napirendjéhez.

  • Adja le a küldeményeit, vagy a FedEx alkalmazottai feldolgozzák Önnek azokat a pultnál.
  • Vásároljon dobozokat és egyéb csomagolóanyagot.
  • A FedEx Dropoff Locator oldalán megtekintheti az egyes helyszíneken kínált szolgáltatások, például a szombati szolgáltatás listáját.
  • Terhelheti küldeményeit a FedEx ügyfélszámlájára, vagy használhat csekket, hitelkártyát vagy készpénzt, amelyeket a legtöbb helyen elfogadnak.

Megjegyzés: Rendelkeznie kell egy FedEx ügyfélazonosítóval ahhoz, hogy FedEx International Ground® csomagokat küldhessen egy FedEx Ship Centerben vagy egyéb szállítási kirendeltségünkön.

A FedEx hivatalos ShipCenter szállítási központ® kirendeltségei: független tulajdonú csomagolási és szállítási helyszínek

Látogasson el ezekre a független tulajdonú helyszínekre csomagolási és szállítási szolgáltatásokért. A legtöbbjük faxolást, másolást és egyéb üzleti szolgáltatásokat is kínál.

  • Keresse a pack-and-ship kiskereskedőket, mint pl. AIM Mail Center®, PakMail®, PostalAnnex+®és PostNet®, valamint az Association of Mail és a Business Centers and Retail Shipping Associates szolgáltatásokkal kapcsolatban álló helyeket.
  • Ezen kirendeltségek legtöbbjén szállíthat FedEx Express és FedEx Ground csomagokat is. További tájékoztatásért tekintse meg a FedEx Dropoff Locator oldalát.

Megjegyzés: a csomagok feldolgozásának díja az egyes kirendeltség saját árszabásától függ. Ezek a kirendeltségnek további díjakat számíthatnak fel a FedEx díjain felül.

FedEx ShipSite az Office Depot® és az OfficeMax® kirendeltségein: kényelmes hozzáférés a szállítási szolgáltatásokhoz

A FedEx® szolgáltatásai elérhetők az összes Office Depot- és OfficeMax-kirendeltségen. Ezek a kirendeltségek a FedEx Express és a FedEx Ground amerikai és nemzetközi fuvarozási szolgáltatásait kínálják, így egy helyen leadhatja a csomagokat, vagy feldolgozhatja azokat a pultnál, csomagolóanyagokat vásárolhat, és egyéb üzleti igényeinek is eleget tehet.

A FedEx Drop Box kirendeltségei: több mint 35.000 kirendeltség

Több mint 35.000 drop box található irodaépületekben, bevásárlóközpontokban, reptereken, a FedEx Office kirendeltségein, élelmiszerboltokban és egyéb kényelmes helyszíneken.

  • Adja le a FedEx Express, a FedEx Ground és a FedEx Ground® Economy (korábbi nevén FedEx SmartPost®) küldeményeit. A FedEx Ground küldeményei esetén szükség lehet egy további napra a kézbesítéshez.
  • Minden drop box legfeljebb 20\" x 12\" x 6\" méretű csomagot fogad el (sok drop box legfeljebb 20\" x 12\" x 9\" méretűt fogad el).
  • A legtöbbjük korlátozott mennyiségben rendelkezik FedEx Express légi fuvarlevéllel és csomagolóanyaggal.
  • Mindegyik kínál hétfőtől péntekig tartó átvételt, és néhány még szombatit is.
  • Ne helyezzen FedEx SameDay®  csomagokat a postaládákba.
  • Az IATA II. szakasza szerinti lítiumakkumulátorok és a „B” kategóriájú biológiai anyag (UN 3373) az egyetlen olyan veszélyes áru, amely behelyezhető drop boxba.
  • Készpénzt, csekket vagy hitelkártyát nem fogadunk el.

A FedEx OnSite kirendeltségei: vegye át vagy adja le ott, ahol vásárol

A FedEx OnSite kirendeltségein átveheti vagy leadhatja a FedEx-csomagjait az Önnek legkényelmesebb helyszínen. Közel vannak a munkahelyéhez, lakóhelyéhez vagy sportolási helyéhez, és számos kirendeltség hosszabb nyitvatartási idővel is rendelkezik. A FedExnek közel 9000 Walgreens-kirendeltsége van, valamint bizonyos Dollar General-, Albertsons- és Kroger-üzletben is jelen van az USA-ban és Puerto Ricóban, ahol Ön a következőket teheti:

  • A csomagokat biztonságos helyen tárolja, hogy Ön bármikor átvehesse azokat.
  • Adjon le előre csomagolt és előre címkézett, amerikai és nemzetközi FedEx Express- és FedEx Ground-csomagot. Az egyéni csomagok súlya legfeljebb 55 font lehet, a méretük pedig legfeljebb és legfeljebb 48 hüvelyk hosszú, 25 hüvelyk széles és 25 hüvelyk magas lehet.

Üzleti szabályok

  • A FedEx Office-kirendeltségek, a FedEx OnSite-kirendeltségek és bizonyos FedEx hivatalos ShipCenter szállítási központ-kirendeltségek nem fogadnak el veszélyes árukat, élő állatokat, dohányárut és egyéb, szabályozás alá eső anyagot illetve veszélyes küldeményeket.
  • Súlykorlátozások a kirendeltség típusa szerint
    • A FedEx Office és FedEx Ship Center kirendeltségei nagyobb és nehezebb kirendeltségen tartandó csomagokat fogadhatnak el, mint egyes FedEx hivatalos ShipCenter szállítási központok és FedEx OnSite-kirendeltségek.
    • A FedEx Ship Center kirendeltségei elfogadnak 150 fontot, 119 hüvelyk hosszúságot és/vagy 165\" hosszúságot és kerületet (L+2W+2H) meghaladó csomagokat, amelyek nem szállíthatók más kirendeltségre.
    • A FedEx Office kirendeltségei legfeljebb 150 font súlyú, legfeljebb 119 hüvelyk hosszú és/vagy 165 hüvelyk hosszúságú és kerületű (H+2Sz+2M) csomagokat fogadnak el.
    • A FASC-ok és a FedEx OnSite kirendeltségei legfeljebb 55 font súlyú és legfeljebb 48\" x 25\" x 25\" méretű csomagokat fogadnak el.

JSON API-gyűjtemény

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