Fedex Logo
Developer Portal

FedEx Locations Search API

Giới thiệu

Địa điểm FedEx là các điểm lấy hàng và bỏ hàng do nhà cung cấp dịch vụ vận chuyển của FedEx quản lý. Bạn có thể vận chuyển một gói hàng từ địa điểm lấy hàng đến địa điểm bỏ hàng bằng hãng vận tải FedEx bất kỳ. API này giúp bạn tìm kiếm địa điểm vận chuyển được hỗ trợ và có sẵn bằng địa chỉ, tọa độ địa lý hoặc số điện thoại.

API Tìm kiếm địa điểm FedEx tìm kiếm và trả về địa chỉ của địa điểm bỏ gói hàng FedEx gần nhất, bao gồm Trung tâm in ấn và vận chuyển Văn phòng FedEx® và các địa điểm FedEx Drop Box có sẵn để bỏ gói hàng FedEx Express® và FedEx Ground®.

Chi tiết về API Tìm kiếm địa điểm FedEx

API Tìm kiếm địa điểm FedEx cho phép bạn tìm kiếm điểm bỏ hàng của FedEx bằng địa chỉ, tọa độ địa lý hoặc số điện thoại.

API Tìm kiếm địa điểm FedEx cho phép bạn tìm kiếm địa điểm dựa trên:

  • Trung tâm vận chuyển được ủy quyền
  • Trung tâm bỏ hàng được ủy quyền
  • Địa điểm hỗ trợ giữ hàng
  • Địa điểm thùng nhận hàng
  • Địa điểm chấp nhận lô hàng chứa hàng hóa nguy hiểm

Các tính năng của API Tìm kiếm địa điểm FedEx bao gồm:

  • Tìm kiếm địa điểm lấy hàng và bỏ hàng FedEx gần nhất
  • Truy xuất địa chỉ chi tiết của địa điểm, bao gồm cả mã bưu chính, mã quốc gia, v.v.

Phương thức hoạt động của API Tìm kiếm địa điểm FedEx

API Tìm kiếm địa điểm hỗ trợ yêu cầu địa điểm FedEx có sẵn để bỏ gói hàng FedEx Express® và FedEx Ground®. Giao dịch này tìm kiếm và trả về địa chỉ của địa điểm FedEx gần nhất. Bạn cũng có thể sử dụng API này để tìm địa điểm FedEx cung cấp dịch vụ Giữ hàng tại địa điểm.

Tìm địa điểm

Yêu cầu này được sử dụng để trả về danh sách tất cả địa điểm có sẵn dựa trên chi tiết đầu vào. Những thông tin đầu vào quan trọng gắn với yêu cầu này gồm:

  • Địa chỉ địa điểm
  • Khoảng cách (giá trị và đơn vị bán kính quanh địa chỉ để tìm kiếm địa điểm FedEx)

Lưu ý: Cần có mã bưu chính đối với các quốc gia áp dụng mã bưu chính. Đối với các quốc gia không áp dụng mã bưu chính, hãy nhập tổ hợp thành phố và quốc gia để tìm nạp các địa điểm FedEx hợp lệ.

Kết quả của yêu cầu này là danh sách chi tiết tất cả địa điểm lấy hàng và bỏ hàng hiện có của FedEx kèm theo thông tin quan trọng như khoảng cách, giờ mở cửa, chi tiết về hãng vận tải, dịch vụ tại địa điểm và khả năng hỗ trợ vào các ngày trong tuần, khả năng bỏ/lấy lô hàng, khả năng giữ lô hàng để chờ lấy, v.v.

Các tính năng chính của API Tìm kiếm địa điểm FedEx

Thu hẹp phạm vi tìm kiếm theo địa điểm

Bạn có thể thu hẹp phạm vi tìm kiếm theo loại địa điểm. Bạn có thể chỉ định một, nhiều hoặc tất cả loại địa điểm FedEx được liệt kê sau đây trong yêu cầu tìm kiếm:

  • Các địa điểm là Trung tâm vận chuyển được ủy quyền của FedEx®: Tiếp cận mạng lưới vận chuyển của FedEx tại hơn 5.800 điểm đóng gói và vận chuyển được sở hữu và vận hành độc lập (FASC) trên khắp Hoa Kỳ. Các cửa hàng tham gia vào chương trình Trung tâm vận chuyển được ủy quyền của FedEx cũng cung cấp các dịch vụ kinh doanh khác. Bạn có thể phải trả thêm phí ngoài giá cước công bố của FedEx tại các địa điểm là Trung tâm vận chuyển được ủy quyền của FedEx.
  • Trung tâm vận chuyển của FedEx®
  • Trạm Express
  • FedEx ShipSite
  • Địa điểm Văn phòng FedEx®
  • Địa điểm tự phục vụ của FedEx: Bỏ các gói hàng FedEx Express và FedEx Ground (tối đa 20" x 12" x 6") tại Thùng nhận hàng FedEx Express®.
  • Chúng tôi hỗ trợ dịch vụ Giữ hàng tại địa điểm tại các loại địa điểm sau:
    • FedEx OnSite – Các gói hàng FedEx Express và FedEx Ground
    • Văn phòng FedEx – Các gói hàng FedEx Express và FedEx Ground
    • Các trạm Express – Chỉ gói hàng FedEx Express
    • Các trung tâm vận chuyển của FedEx – Các gói hàng FedEx Express và FedEx Ground cũng như hàng hóa nguy hiểm được phê duyệt

Khả năng của địa điểm

Ngoài ra, yêu cầu tìm kiếm hỗ trợ thuộc tính chỉ định các địa điểm hỗ trợ khả năng Chuyển địa điểm giữ hàng cho FedEx Express hoặc FedEx Ground và thuộc tính chỉ định các khả năng hỗ trợ tại địa điểm, như:

  • Dịch vụ trả hàng
  • Bỏ hàng Ground
  • Tiền mặt
  • Đóng gói và vận chuyển
  • Vật tư đóng gói
  • Dịch vụ biển hiệu và biểu ngữ
  • Sony PictureStation
  • Dịch vụ thư tín trực tiếp
  • Dịch vụ sao chép và in
  • Dịch vụ hàng hóa nguy hiểm
  • Địa điểm tại sân bay
  • Dịch vụ công chứng
  • Áp dụng giờ tiết kiệm ánh sáng ban ngày
  • Dịch vụ ảnh hộ chiếu
  • Hộp gửi hàng
  • Dịch vụ vận chuyển nội địa
  • Dịch vụ vận chuyển quốc tế

Sắp xếp kết quả

API Tìm kiếm địa điểm FedEx cho phép bạn sắp xếp kết quả theo:

  • Thời gian bỏ hàng FedEx Express muộn nhất
  • Thời gian bỏ hàng FedEx Ground muộn nhất
  • Loại địa điểm
  • Theo khoảng cách tăng dần
  • Theo khoảng cách giảm dần

Tiêu chí tìm kiếm bổ sung

Bạn cũng có thể thu hẹp phạm vi tìm kiếm theo:

  • Có dịch vụ thứ Bảy.
  • Có dịch vụ đóng gói (tại hầu hết các địa điểm Văn phòng FedEx): FedEx sẽ đóng gói lô hàng cho bạn (bạn sẽ trả thêm phí).
  • Có vật tư đóng gói (mọi địa điểm cung cấp vật tư đóng gói FedEx Express; không bao gồm vật tư FedEx Ground).
  • Các địa điểm bỏ hàng FedEx Express muộn nhất: Trả về địa điểm có thời gian bỏ hàng muộn nhất gần bạn.
  • Bỏ hàng Express sau: Bỏ gói hàng sau một thời gian cụ thể, chẳng hạn như 5 giờ chiều. Sử dụng phần tử này để tìm kiếm địa điểm bỏ hàng hoạt động sau 5 giờ chiều.

Lưu ý: API Tìm kiếm địa điểm FedEx trả về tối đa 75 địa điểm trong bán kính 50 dặm từ địa chỉ của bạn

Địa điểm FedEx

Các địa điểm là Trung tâm vận chuyển của FedEx®: Bỏ gói hàng và xem thông tin vận chuyển

Các chuyên gia vận chuyển tại địa điểm là Trung tâm vận chuyển FedEx có thể giúp bạn chọn dịch vụ vận chuyển, hoàn thành chứng từ và xử lý gói hàng của bạn. Nhiều địa điểm hoạt động muộn và mở vào thứ Bảy để đáp ứng lịch của bạn.

  • Bỏ lô hàng của bạn hoặc FedEx sẽ giúp bạn xử lý lô hàng tại quầy.
  • Mua hộp và vật tư đóng gói khác.
  • Kiểm tra Công cụ tìm nơi bỏ hàng của FedEx để xem danh sách dịch vụ, chẳng hạn như dịch vụ thứ Bảy, được cung cấp ở mỗi địa điểm.
  • Tính phí lô hàng vào tài khoản FedEx của bạn hoặc sử dụng séc, thẻ tín dụng hay tiền mặt vì những phương thức này được chấp nhận ở hầu hết các địa điểm.

Lưu ý: Bạn phải có số tài khoản FedEx để vận chuyển các gói hàng FedEx International Ground® tại Trung tâm vận chuyển của FedEx và các địa điểm vận chuyển khác của chúng tôi.

Các địa điểm là Trung tâm vận chuyển được ủy quyền của FedEx®: Địa điểm đóng gói và vận chuyển được sở hữu độc lập

Hãy ghé qua các địa điểm được sở hữu độc lập này để sử dụng dịch vụ đóng gói và vận chuyển. Hầu hết các địa điểm này cũng cung cấp dịch vụ fax, photocopy và các dịch vụ kinh doanh khác.

  • Tìm các đại lý bán lẻ có dịch vụ đóng gói và vận chuyển như AIM Mail Center®, PakMail®, PostalAnnex+® và PostNet® cũng như các địa điểm liên kết với Hiệp hội Thư tín và trung tâm doanh nghiệp cũng như Hiệp hội vận chuyển bán lẻ.
  • Bạn có thể vận chuyển cả gói hàng FedEx Express và FedEx Ground tại hầu hết các địa điểm này. Để biết thêm thông tin, hãy kiểm tra Công cụ tìm nơi bỏ hàng của FedEx.

Lưu ý: Giá cước xử lý gói hàng phản ánh chính sách giá riêng của mỗi địa điểm. Bạn có thể phải trả thêm phí cùng với giá cước của FedEx tại các địa điểm này.

FedEx ShipSite tại địa điểm Office Depot® và OfficeMax®: Tiếp cận thuận tiện các dịch vụ vận chuyển

Các dịch vụ FedEx® có tại tất cả các địa điểm Office Depot và OfficeMax. Những địa điểm này cung cấp dịch vụ FedEx Express và FedEx Ground Hoa Kỳ cũng như dịch vụ vận chuyển quốc tế, nên bạn có thể bỏ gói hàng hoặc xử lý gói hàng tại quầy, mua vật tư đóng gói và giải quyết các nhu cầu kinh doanh khác tại một nơi duy nhất, vô cùng thuận tiện.

Các địa điểm FedEx Drop Box: Hơn 35.000 địa điểm

Có hơn 35.000 thùng nhận hàng trong các tòa nhà văn phòng, trung tâm mua sắm, sân bay, các địa điểm Văn phòng FedEx, cửa hàng tạp hóa và các địa điểm thuận tiện khác.

  • Bạn có thể bỏ các lô hàng FedEx Express, FedEx Ground và FedEx Ground® Economy (Trước đây gọi là FedEx SmartPost®). Lô hàng FedEx Ground có thể cần thêm một ngày giao.
  • Tất cả các thùng nhận hàng chấp nhận gói hàng có kích thước tối đa 20" x 12" x 6" (nhiều thùng chấp nhận gói hàng có kích thước tối đa 20" x 12" x 9").
  • Hầu hết có một ít vận đơn hàng không FedEx Express và vật tư đóng gói.
  • Tất cả đều cung cấp dịch vụ lấy hàng từ thứ Hai – thứ Sáu và một số hỗ trợ lấy hàng vào thứ Bảy.
  • Không đặt các gói hàng FedEx SameDay® vào thùng nhận hàng.
  • Pin lithium theo Mục II của IATA và Chất sinh học theo danh mục B (UN 3373) là loại hàng hóa nguy hiểm duy nhất có thể cho vào thùng nhận hàng.
  • Không chấp nhận thanh toán bằng tiền mặt, séc hoặc thẻ tín dụng.

Các địa điểm FedEx OnSite: Lấy hàng và bỏ hàng ở nơi bạn mua sắm

Với các địa điểm FedEx OnSite, bạn có thể lấy và bỏ gói hàng FedEx ở nơi thuận tiện nhất cho bạn. Các địa điểm này gần nơi bạn làm việc, sinh sống và vui chơi, thậm chí một số địa điểm còn mở ngoài giờ. FedEx có gần 9.000 địa điểm tại Walgreens và một số địa điểm tại Dollar General, Albertsons và Kroger ở Hoa Kỳ và Puerto Rico, nơi bạn có thể:

  • Được giữ gói hàng ở địa điểm an toàn để bạn đến lấy khi thuận tiện.
  • Bỏ các lô hàng FedEx Express và FedEx Ground Hoa Kỳ cũng như lô hàng quốc tế được đóng gói và dán nhãn sẵn. Các gói hàng lẻ có thể nặng tối đa 55 lb và có kích thước tối đa 48″ chiều dài x 25" chiều rộng x 25" chiều cao.

Quy tắc kinh doanh

  • Các địa điểm Văn phòng FedEx, FedEx OnSite và một số Trung tâm vận chuyển được ủy quyền của FedEx không chấp nhận các lô hàng chứa hàng hóa nguy hiểm, động vật sống, thuốc lá hoặc vật liệu nguy hiểm được quản lý khác.
  • Hạn chế về trọng lượng theo loại địa điểm
    • Các địa điểm Văn phòng FedEx và Trung tâm vận chuyển FedEx có thể chấp nhận các gói hàng Giữ hàng tại địa điểm lớn hơn và nặng hơn so với một số địa điểm Trung tâm vận chuyển được ủy quyền của FedEx và FedEx OnSite.
    • Các địa điểm Trung tâm vận chuyển FedEx chấp nhận các gói hàng vượt quá 150 lb, 119″ chiều dài và/hoặc 165" chiều dài và chu vi (D+2R+2C) không thể giao đến các địa điểm khác.
    • Các địa điểm Văn phòng FedEx chấp nhận gói hàng có trọng lượng tối đa 150 lb, tối đa 119" chiều dài và/hoặc 165" chiều dài và chu vi (D+2R+2C).
    • Các địa điểm FASC và FedEx OnSite (ví dụ: Walgreens) chấp nhận gói hàng có trọng lượng tối đa 55 lb và kích thước tối đa 48" x 25" x 25".

Bộ sưu tập 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