Fedex Logo

Giới thiệu

API Yêu cầu lấy hàng cho phép bạn kiểm tra khả năng lấy hàng, lên lịch để nhân viên chuyển phát lấy hàng và hủy yêu cầu đến lấy hàng.

API Yêu cầu lấy hàng áp dụng cho các gói hàng mới hoặc trước đây từng xử lý ở mọi khu vực đối với lô hàng FedEx Express và FedEx Ground (trả lại và xuất). Tài liệu hướng dẫn chi tiết này sẽ cung cấp cho bạn thông tin mới nhất và giúp bạn tìm hiểu mọi điều cần biết về API Yêu cầu lấy hàng.

Chi tiết về API Yêu cầu lấy hàng

Sau đây là các tính năng quan trọng liên kết với API Yêu cầu lấy hàng:

Khả năng lấy hàng

Với tính năng khả năng lấy hàng, bạn có thể kiểm tra tính sẵn có của dịch vụ lấy hàng dựa trên yêu cầu đầu vào. Khả năng lấy hàng phụ thuộc vào hai yếu tố: thời gian chốt sổ lấy hàng và thời gian tiếp cận.

Thời gian chốt sổ lấy hàng - Thời gian muộn nhất bạn có thể lên lịch lấy hàng. Thời gian tính theo giờ địa phương của mã bưu chính nơi lấy hàng.

Thời gian tiếp cận - Thời gian tính từ lúc sẵn sàng lấy hàng (khi gói hàng sẵn sàng để lấy) đến lúc tài xế sẵn sàng lấy gói hàng.

Tạo yêu cầu lấy hàng

Tùy chọn này cho phép bạn lên lịch lấy hàng, áp dụng cho các lô hàng FedEx Express® và FedEx Ground® nội địa và quốc tế. API Yêu cầu lấy hàng FedEx Ground và Express sẽ trả về số xác nhận lấy hàng, ngoài ra còn trả về mã địa điểm cho yêu cầu lấy hàng Express đã lên lịch. Bạn cũng có thể lên lịch lấy hàng cho lô hàng trả lại bằng API này.

Dòng địa chỉ người nhận bổ sung (Dòng địa chỉ 3) cho phép bạn cung cấp chi tiết đầy đủ và chính xác hơn về địa điểm, giúp cho việc giao lô hàng FedEx Express® nhanh hơn. Bạn có thể tiết kiệm thời gian và công sức bằng cách lên lịch để nhân viên chuyển phát của FedEx lấy lô hàng từ địa điểm của bạn hoặc từ địa điểm khác (mất thêm phí).

Hủy lấy hàng

Tùy chọn này cho phép bạn hủy yêu cầu lấy hàng đã lên lịch. Tùy chọn này áp dụng cho các lô hàng FedEx Express và FedEx Ground nội địa và quốc tế. Các yêu cầu lấy hàng FedEx Express nội địa và quốc tế có thể hủy trong cùng ngày. Các yêu cầu lấy hàng FedEx Ground nội địa và quốc tế có thể hủy trong 24 giờ sau khi bạn gửi yêu cầu. Nếu lô hàng của bạn đã được lấy, vui lòng liên hệ với bộ phận Dịch vụ khách hàng FedEx theo số 800 FedEx (800 3339) để tiến hành hủy.

Chi tiết về yêu cầu lấy hàng

Yêu cầu lấy hàng FedEx Express

  • Thời gian gói hàng của bạn sẵn sàng để lấy không được muộn hơn thời gian chốt sổ lấy hàng theo mã bưu chính ở địa điểm của bạn. Bạn có thể truy xuất thời gian chốt sổ lấy hàng bằng yêu cầu về Khả năng lấy hàng.
  • Khoảng thời gian từ khi gói hàng của bạn sẵn sàng đến thời điểm nhân viên chuyển phát không thể vào địa điểm để lấy gói hàng nữa không được ngắn hơn "thời gian tiếp cận". Bạn cũng có thể truy xuất thời gian tiếp cận bằng yêu cầu về Khả năng lấy hàng.
  • Ví dụ: "PT4H0M" cho biết thời gian lấy hàng là 4 giờ 0 phút.

  • Bạn có thể lên lịch lấy hàng FedEx Express trong ngày hiện tại hoặc ngày làm việc tiếp theo.
  • Số lượng gói hàng tối đa cho một yêu cầu lấy hàng là 99.
  • Nếu bạn đã có một yêu cầu lấy hàng theo lịch thường xuyên, bạn không cần lên lịch yêu cầu lấy hàng một lần hay thêm yêu cầu lấy hàng theo lịch thường xuyên khác.
  • Bạn không thể thay đổi yêu cầu lấy hàng. Để thay đổi yêu cầu, bạn phải hủy yêu cầu ban đầu và nhập yêu cầu mới.
  • Giờ đây, hệ thống FedEx hỗ trợ chức năng Lấy hàng trong nội địa Vương quốc Anh.

Yêu cầu lấy hàng FedEx Ground

  • Bạn có thể lên lịch lấy hàng cho ngày làm việc tiếp theo hoặc ngày làm việc bất kỳ trước tối đa 2 tuần.
  • Số lượng gói hàng tối đa cho một yêu cầu lấy hàng là 99.
  • Nếu bạn đã có một yêu cầu lấy hàng theo lịch thường xuyên, bạn không cần lên lịch yêu cầu lấy hàng một lần hay thêm yêu cầu lấy hàng theo lịch thường xuyên khác.
  • Có tùy chọn lấy hàng tại nơi cư trú (tính thêm phụ phí).
  • Bạn không thể thay đổi yêu cầu lấy hàng. Để thay đổi yêu cầu, bạn phải hủy yêu cầu ban đầu và nhập yêu cầu mới.

Các loại dịch vụ của API Yêu cầu lấy hàng

Nhận hàng FedEx Express

Áp dụng phí nhân viên chuyển phát lấy hàng khi bạn yêu cầu Lấy hàng FedEx Express, bao gồm cả yêu cầu được tạo thông qua fedex.com và bộ phận Dịch vụ khách hàng FedEx.

Nhận hàng FedEx Ground

FedEx Ground cung cấp dịch vụ lấy hàng theo yêu cầu có tính thêm phí. Với khách hàng lấy hàng theo lịch thường xuyên, chúng tôi sẽ áp dụng phí lấy hàng mỗi tuần cho số tài khoản liên kết với dịch vụ lấy hàng theo lịch thường xuyên.

  • Với khách hàng không sử dụng dịch vụ lấy hàng theo lịch thường xuyên, chúng tôi sẽ áp dụng phí lấy hàng theo lượt gọi trên mỗi gói hàng. Phí lấy hàng theo lượt gọi sẽ không áp dụng nếu bạn bỏ gói hàng tại một địa điểm vận chuyển của FedEx. Ngoài ra, phí lấy hàng theo lượt gọi không áp dụng cho việc lấy hàng FedEx Ground® Economy (Trước đây gọi là FedEx SmartPost®) Nhãn trả hàng bản in FedEx Ground® Economy (Trước đây gọi là FedEx SmartPost®) Nhãn trả hàng điện tử và Chương trình chuyển hoàn gói hàng FedEx Ground®.
  • Với khách hàng lấy hàng theo lịch thường xuyên, FedEx Ground cung cấp dịch vụ lấy hàng theo yêu cầu từ một địa chỉ không phải địa điểm vận chuyển của số tài khoản FedEx Ground. Phí tính thêm cho dịch vụ lấy hàng tại địa chỉ thay thế được tính hằng tuần cho mỗi địa chỉ độc nhất.

FedEx Extra Hours

Các dịch vụ FedEx Extra Hours áp dụng cho yêu cầu lấy hàng có thể vận chuyển qua đêm trong 1 ngày từ thứ Hai đến thứ Sáu, cho phép đại lý bán lẻ hoàn thành đơn đặt hàng buổi tối bằng dịch vụ giao hàng tại địa phương vào ngày tiếp theo của FedEx Express.

Để biết thêm thông tin về các dịch vụ có sẵn, hãy truy cập fedex.com.

Phương thức hoạt động của API Yêu cầu lấy hàng

Sau đây là các tùy chọn lấy hàng có sẵn với API Yêu cầu lấy hàng:

Kiểm tra khả năng lấy hàng

Điểm cuối này dùng để yêu cầu thông tin chi tiết hiện có về lịch lấy hàng.

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ỉ lấy hàng/chi tiết thông tin bưu chính.
  • Loại yêu cầu lấy hàng (ví dụ: trong ngày/ngày trong tương lai).
  • Hãng vận tải vận chuyển của FedEx để lấy hàng (ví dụ: Express/Ground).
  • Yêu cầu lấy hàng này là nội địa/quốc tế.

Phản hồi thành công cho yêu cầu này sẽ trả về các thông tin chi tiết hiện có về lịch lấy hàng, chẳng hạn như thời hạn chốt lấy hàng, ngày lấy hàng, thời gian ra vào lấy hàng, thời gian sẵn sàng mặc định cũng như các chi tiết khác về khả năng đến lấy hàng theo lịch. Phản hồi cũng trả về các lỗi và phần mô tả trong trường hợp có lỗi.

Tạo yêu cầu lấy hàng

Điểm cuối này dùng để tạo yêu cầu lấy hàng cho một gói hàng chờ lấy.

Những thông tin đầu vào quan trọng gắn với yêu cầu này gồm:

  • Số tài khoản FedEx sẽ được lập hóa đơn cho yêu cầu lấy hàng.
  • Chi tiết về nơi gửi hàng (địa chỉ, địa điểm và loại địa chỉ lấy hàng, chẳng hạn tài khoản/người gửi/khác).
  • Hãng vận tải vận chuyển của FedEx để lấy hàng (Express/Ground).
  • Chi tiết địa chỉ của tài khoản liên kết.

Yêu cầu lấy hàng thành công sẽ trả về số xác nhận lấy hàng, thông báo lấy hàng và mã địa điểm cho lần lấy hàng đang được lên lịch. Phản hồi cũng trả về các lỗi và phần mô tả trong trường hợp có lỗi.

Hủy đến lấy hàng

Sử dụng yêu cầu này để hủy yêu cầu lấy gói hàng đã lên lịch.

Những thông tin đầu vào quan trọng gắn với yêu cầu này gồm:

  • Mã xác nhận lấy hàng (nhận được khi gửi yêu cầu lấy hàng)
  • Hãng vận tải vận chuyển của FedEx để lấy hàng (Express/Ground)
  • Ngày được lên lịch (Ngày điều phối lấy hàng)
  • Địa điểm (Địa điểm FedEx Express chịu trách nhiệm xử lý yêu cầu lấy hàng)

Yêu cầu hủy lấy hàng thành công sẽ trả về số xác nhận và lời nhắn xác nhận hủy lấy hàng. Phản hồi cũng trả về các lỗi và phần mô tả trong trường hợp có lỗi.

Lưu ý: Gửi số xác nhận lấy hàng và mã địa điểm tương ứng (chỉ áp dụng cho FDXE) để hủy yêu cầu lấy hàng đã lên lịch. Bạn nhận được thông tin về số xác nhận lấy hàng và mã địa điểm tương ứng (chỉ áp dụng cho FDXE) khi gửi yêu cầu lấy hàng. Thông báo thất bại sẽ được gửi nếu bạn tìm cách hủy yêu cầu lấy hàng sau khi nhân viên chuyển phát của FedEx đã được điều phối đến địa điểm lấy hàng

Quy tắc kinh doanh 

  • Để yêu cầu lấy hàng ở một quốc gia khác, hãy bổ sung phần tử quốc gia cùng mã quốc gia tương ứng của nơi bạn muốn FedEx đến lấy lô hàng.
  • FedEx sẽ trả về số xác nhận điều phối cho một yêu cầu điều phối thành công. Các yêu cầu điều phối phải giới hạn trong một yêu cầu mỗi ngày, trừ phi bạn thêm các gói hàng vượt quá kích thước hoặc trọng lượng trong yêu cầu ban đầu.
  • Các yêu cầu điều phối có thể thất bại nếu bạn nhập khung thời gian không đủ giữa thời gian gói hàng sẵn sàng và thời gian đóng cửa doanh nghiệp. Nếu bạn có thắc mắc về thời gian lấy hàng, hãy liên hệ Đường dây nóng hỗ trợ FedEx tại khu vực.
  • API Yêu cầu lấy hàng hỗ trợ các loại trọng lượng như "LB" và "KG". Đơn vị trọng lượng của gói hàng và hàng hóa phải giống nhau, nếu không yêu cầu sẽ gặp lỗi.
  • Nếu bạn cần lên lịch lấy hàng cho cả gói hàng FedEx Express (bao gồm cả vận chuyển trong Mexico) và FedEx Ground, bạn cần lên lịch lấy hàng riêng cho mỗi hãng vận tải.
  • Nếu địa điểm lấy hàng của bạn ở khu vực xa xôi, hãy đảm bảo gói hàng của bạn sẵn sàng sớm hơn để phù hợp với lịch lấy hàng ở xa.
  • Luôn đưa vào thời gian muộn nhất để lấy gói hàng của bạn (hoặc thời gian đóng cửa công ty).
  • Dịch vụ lấy hàng thứ Bảy được cung cấp ở một số địa điểm trên thế giới đối với gói hàng FedEx Express. Dịch vụ bỏ hàng thứ Bảy cũng có sẵn tại nhiều địa điểm FedEx. Sử dụng điểm cuối Dịch vụ địa điểm để nhận danh sách các địa điểm bỏ hàng thứ Bảy.
  • Với các yêu cầu lấy hàng FedEx Ground và FedEx Express, bạn có thể yêu cầu địa chỉ lấy hàng thay thế không phải địa điểm vận chuyển gắn với số tài khoản FedEx của bạn.
  • Nếu bạn muốn sử dụng dịch vụ lấy hàng FedEx Express hoặc FedEx Ground thường xuyên, hãy liên hệ với nhân viên kinh doanh của FedEx.
  • Bạn chỉ có thể hủy yêu cầu lấy hàng FedEx Express hoặc FedEx Ground nếu:
    • Chưa đến thời gian gói hàng sẵn sàng trong yêu cầu, và
    • Nhân viên chuyển phát chưa được điều phối.

Bộ sưu tập API JSON

CLOSE

Response

Copy