Webhook là hàm callback HTTPS cho phép giao tiếp gọn nhẹ liên quan đến sự kiện giữa ứng dụng của người gửi và người nhận. Trong trường hợp này, đó là FedEx và ứng dụng của bạn. Việc sử dụng webhook giúp bạn nắm được thông tin cập nhật gần thời gian thực về các sự kiện mà bạn muốn biết. Để tìm hiểu thêm về webhook, hãy tìm hiểu phần Webhook là gì?

Không, webhook của FedEx là bộ sơ đồ kỹ thuật được cung cấp cùng với tài liệu và các ví dụ, từ đó bộ phận hỗ trợ CNTT của bạn có thể kết hợp nhiều chức năng của FedEx vào hệ thống nội bộ. Để biết các giải pháp sẵn có, hãy tìm hiểu giải pháp FedEx^®Compatible.

Có hai cách để đăng ký thuê bao Webhook theo dõi:

1. Người dùng có thể đăng ký thuê bao để Theo dõi sự kiện bằng cách đăng ký vào các Số tài khoản FedEx gồm 9 chữ số. Người dùng có thể chủ động theo dõi mọi lô hàng nhập và lô hàng xuất, cũng như các lô hàng của bên thứ ba được lập hóa đơn cho Số tài khoản tương ứng.
2. Webhook dựa trên số theo dõi, trong đó người dùng có thể đăng ký thuê bao bằng Số theo dõi FedEx và nhận thông tin giống như trên FedEx.com. PII (Thông tin nhận dạng cá nhân) không được gửi qua webhook số theo dõi.

       LƯU Ý: Webhook dựa trên số theo dõi hiện không khả dụng.

Webhook theo dõi của FedEx cập nhật thông tin theo dõi lô hàng FedEx Ground, FedEx Ground Economy, FedEx Express và FedEx Freight (chỉ số tài khoản 9 chữ số).

GHI CHÚ:

      ●   Webhook theo dõi của FedEx chỉ hỗ trợ tài khoản vận tải hàng nặng 9 chữ số dành cho doanh nghiệp.

      ●   Webhook theo dõi của FedEx không hỗ trợ tài khoản vận tải hàng nặng LTL 9 chữ số.

      ●   Vui lòng liên hệ Bộ phận hỗ trợ khách hàng của FedEx để biết cách chuyển tài khoản vận tải hàng nặng LTL sang tài khoản doanh nghiệp.

Webhook theo dõi hỗ trợ thông báo đẩy theo thời gian thực về các sự kiện theo dõi lô hàng đang vận chuyển, từ "Tạo nhãn" đến "Đã giao", bao gồm cả Hình ảnh dùng làm bằng chứng giao hàng.

Khách hàng có thể định cấu hình webhook để chọn danh mục sự kiện theo dõi phù hợp với nhu cầu kinh doanh của mình. Ví dụ: Nếu bạn định sử dụng sự kiện "Đã giao hàng" để kích hoạt thông báo "Đã giao gói hàng" cho khách hàng, bạn có thể chọn "Thông báo giao hàng" nhưng bỏ qua các danh mục khác. Nhấp vào đây để xem danh sách tất cả sự kiện.

1.  Tạo Thông tin đăng nhập người dùng trên FedEx Developer Portal.
2.  Tạo Hồ sơ của tổ chức trên FedEx Developer Portal.
3.  Thêm số tài khoản Thanh toán và Vận chuyển đủ điều kiện tại Hoa Kỳ vào hồ sơ tổ chức.
4.  Định cấu hình công cụ nghe webhook (URL đích/call back và mã thông báo bảo mật) chấp nhận thông báo phần tải JSON.
5.  Xác thực công cụ nghe webhook bằng giao thức xác thực HMAC. (Vui lòng xem lại quy trình xác thực ở đây)

Chúng tôi cung cấp hai cấp độ hỗ trợ: tư vấn và trợ giúp khắc phục sự cố chung. Vui lòng liên hệ với bộ phận dịch vụ khách hàng để tìm hiểu thêm.

Để sử dụng webhook của FedEx, bạn phải đọc và chấp nhận Thỏa thuận cấp phép FedEx Developer Portal (FPDLA) khi tạo webhook. Ngoài FDPLA, công ty của bạn phải thực hiện Thỏa thuận cấp phép người dùng cuối cho tài khoản vận chuyển được thêm vào tổ chức của bạn.

Webhook hiện chỉ được cung cấp cho khách hàng ở Hoa Kỳ.

Để xác nhận rằng chúng tôi đang gửi dữ liệu đến đúng URL đích (call back), FedEx thực hiện quy trình xác thực dựa trên chữ ký của URL call back. Quy trình này được thực hiện khi nhận được yêu cầu "Tạo".

Quy trình xác thực HMAC cho URL đích (call back) nhất định sẽ kích hoạt cho mọi yêu cầu tạo, cập nhật và tiếp tục webhook.

Cách thử nghiệm loại dữ liệu theo dõi được trả về URL đích (call back) của bạn. Sử dụng tính năng "DÙNG THỬ WEBHOOK NÀY" để gửi yêu cầu thử nghiệm. Thao tác này giúp xác thực URL của bạn và xử lý thông báo phần tải sao chép webhook trước khi tạo Webhook theo dõi.

Vui lòng tham khảo Hướng dẫn bắt đầu để biết thêm chi tiết.

Webhook chỉ chấp nhận các kết nối HTTPS hợp lệ hỗ trợ chứng nhận TLS (Phiên bản 1.2 trở lên) hợp lệ do Cơ quan cấp chứng chỉ (CA) uy tín cấp. Vui lòng không sử dụng tên miền hoặc địa chỉ IP của FedEx khi thiết lập URL đích (call back). Tham khảo phần phương thức tối ưu để biết thêm chi tiết.

Đối với Webhook dựa trên số theo dõi, vui lòng thêm số theo dõi của những lô hàng đang giữ tại FedEx hoặc sẽ được giữ tại FedEx trong 24 giờ tới. Vui lòng không thêm số theo dõi trước khi giao gói hàng cho FedEx. Thao tác này sẽ tạo ra lệnh tra cứu trống trong hệ thống của FedEx. Mà lệnh tra cứu thì rất tốn kém!!

Bất cứ khi nào phần tải sự kiện không được ghi nhận ở máy chủ nhận, logic thử lại và gửi lại sẽ được kích hoạt. FedEx sẽ thử lại nhiều lần trong khoảng thời gian 6 giờ với mức giảm theo cấp số nhân đối với bậc cơ bản và trong khoảng thời gian 25 giờ đối với bậc nâng cao. Mọi sự kiện bị bỏ lỡ sẽ bị thanh lọc SAU thời gian gửi lại.

Trong trường hợp xảy ra lỗi liên tục, FedEx sẽ gửi thông báo qua email và nếu lỗi vẫn tiếp diễn thì webhook sẽ bị tạm dừng và email thông báo cuối cùng về việc tạm dừng sẽ được gửi đi. Vui lòng tham khảo phần thử lại để biết thêm chi tiết.

Người dùng có thể định cấu hình cho webhook nhận dữ liệu sự kiện theo dõi thuộc các danh mục cụ thể (chẳng hạn như sự kiện vận chuyển, đang vận chuyển, ngoại lệ hoặc giao hàng). Người dùng cũng có thể chọn nhận toàn bộ lịch sử của từng sự kiện hoặc dữ liệu cụ thể về sự kiện mới nhất. Để biết thêm chi tiết, hãy tham khảo phần tùy chọn cấu hình.

Hãy đưa vào danh sách cho phép các địa chỉ IP sau đây, chính là địa chỉ IP gửi các yêu cầu webhook của FedEx (lưu ý các môi trường khác nhau):

Phát triển/Beta:
169.63.102.107
169.59.163.56
150.239.215.211

Sản xuất:
150.239.111.98
169.63.176.128
150.239.210.140

Vui lòng xem hướng dẫn tham khảo về Các trạng thái Webhook theo dõi và mã trạng thái.

LƯU Ý: FedEx không đảm bảo các sự kiện được gửi theo đúng thứ tự tạo.

• Khách hàng có thể bắt đầu tạo webhook mới và lưu chi tiết đã nhập trong khoảng thời gian 90 ngày.
• Nếu khách hàng không tạo xong webhook đã lưu trong 90 ngày thì webhook đó sẽ bị Xóa (và cổng thông tin sẽ không có siêu dữ liệu).
• Nếu quy trình tạo Webhook được kích hoạt nhưng việc tạo webhook diễn ra không thành công thì webhook sẽ ở trạng thái không thành công (Khách hàng có thể thử tạo lại). Mọi webhook không thành công sẽ bị xóa sau 30 ngày nếu không có hành động nào.
• Nếu khách hàng tạo xong webhook:
  • Webhook sẽ ở trạng thái đang hoạt động (quá trình khớp lô hàng diễn ra và dữ liệu được gửi đến khách hàng)
  • Khách hàng có thể tạm dừng webhook để bảo trì hoặc ngừng hoạt động theo kế hoạch (quá trình khớp lô hàng tạm dừng và không có dữ liệu nào được gửi cho khách hàng). Webhook tạm dừng sẽ tự động bị Hủy sau 30 ngày nếu không được kích hoạt lại.
  • Siêu dữ liệu của Webhook đã hủy vẫn có trên FDP trong khoảng thời gian 90 ngày và không thể kích hoạt lại.
  • Mọi Webhook đã hủy sẽ tự động bị xóa sau 90 ngày.

Trên trang Dự án của tôi, chọn "Hủy" trong menu thả xuống (có hình dấu 3 chấm dọc) bên cạnh webhook có trạng thái Đang hoạt động hoặc Đã tạm dừng mà bạn muốn hủy.

• Trong mỗi hồ sơ Tổ chức, bạn chỉ có thể tạo tối đa 100 webhook.
• Trong mỗi webhook dựa trên số tài khoản, bạn có thể thêm tối đa 1000 số tài khoản.
• Đối với webhook dựa trên số theo dõi, bạn có thể thêm tối đa 1000 số theo dõi trong mỗi yêu cầu.

OK, bây giờ bạn đã hiểu rõ về webhook, vui lòng đăng ký trên cổng thông tin của chúng tôi (chúng tôi gọi đây là bước tạo hồ sơ Tổ chức) và tham khảo hướng dẫn bắt đầu để bắt đầu sử dụng Webbook.

Số tài khoản FedEx hợp lệ (gồm 9 chữ số) phải được liên kết với một hoặc nhiều dự án trả phí trên FedEx Developer Portal để phục vụ mục đích thanh toán. Bạn phải thêm tài khoản vào tổ chức của mình trước khi liên kết tài khoản với dự án trả phí. Hóa đơn thường được gửi qua đường bưu điện đến địa chỉ thanh toán trên tài khoản. Bạn nên tạo Số tài khoản mới để thanh toán cho các dịch vụ trả phí trên FedEx Developer Portal nhằm giúp bạn quản lý hóa đơn, khoản phí cho các dịch vụ API, tách biệt với phí vận chuyển.  

Cả hai đều là Tài khoản FedEx được tạo trên fedex.com nhưng khác nhau về chức năng. Khách hàng có thể sử dụng Số tài khoản được thêm để thanh toán của tổ chức trên FedEx Developer Portal để thanh toán cho các dịch vụ trả phí trên FedEx Developer Portal. Khách hàng không bắt buộc phải duy trì một Số tài khoản riêng để thanh toán. Bạn luôn có lựa chọn sử dụng một trong các Tài khoản vận chuyển hiện có để thanh toán cho các dịch vụ trả phí trên FedEx Developer Portal. Vui lòng đảm bảo địa chỉ thanh toán trên Số tài khoản là chính xác trước khi liên kết với dự án trả phí. Bạn nên tạo Số tài khoản mới để thanh toán cho các dịch vụ trả phí trên FedEx Developer Portal nhằm giúp bạn quản lý hóa đơn, khoản phí cho các dịch vụ API, tách biệt với phí vận chuyển. 

Bạn có thể tạo Số tài khoản FedEx mới trên fedex.com.

Có. Tốt nhất bạn nên sử dụng một Số tài khoản FedEx (gồm 9 chữ số) để thanh toán cho các dịch vụ trả phí trên FedEx Developer Portal. Số tài khoản (gồm 9 chữ số) này được đặt làm mặc định để thanh toán, bất cứ khi nào bạn tạo dự án trả phí mới.

Hóa đơn giấy sẽ được gửi cho bạn qua đường bưu điện trong tuần đầu tiên của mỗi tháng, nếu có (chỉ dành cho khách hàng ở Hoa Kỳ). Hóa đơn được gửi qua Dịch vụ bưu chính Hoa Kỳ và dự kiến được giao trong vòng 3 – 7 ngày làm việc, tùy thuộc vào nơi bạn sống tại Hoa Kỳ. Vui lòng tham khảo trang thông tin sản phẩm tương ứng để biết chi tiết về mức giá.

Chu kỳ thanh toán kết thúc vào ngày cuối cùng của mỗi tháng, lúc 00:00 (giờ UTC). Kỳ thanh toán luôn bắt đầu vào ngày đầu tiên và kết thúc vào ngày cuối cùng của mỗi tháng theo lịch. Hóa đơn được gửi trong tuần đầu tiên của tháng để thanh toán phí trên mức sử dụng của tháng trước.

Hóa đơn của bạn có chi tiết về các khoản phí bạn phải chịu theo bậc giá áp dụng cho bạn. Mỗi hàng trong hóa đơn cho biết mức giá của từng dịch vụ trả phí được cung cấp trên FedEx Developer Portal. Các chi tiết có thể bao gồm mọi khoản chiết khấu được áp dụng cho tổ chức của bạn.

Hóa đơn sẽ được gửi đến địa chỉ tổ chức của bạn trong Cơ sở dữ liệu khách hàng. Nếu bạn có thắc mắc về địa chỉ hoặc muốn cập nhật địa chỉ, vui lòng đăng nhập vào fedex.com để quản lý số tài khoản.  Bạn cũng có thể đăng nhập vào công cụ FedEx Billing Online để thanh toán hóa đơn. Hóa đơn này được liên kết với số tài khoản dùng để thanh toán.

Chúng tôi hiện gửi tất cả hóa đơn qua đường bưu điện. Nếu bạn cần xác minh hoặc cập nhật địa chỉ gửi thư, vui lòng đăng nhập vào fedex.com để quản lý tài khoản.

Có. Bạn cần có ID người dùng và mật khẩu FedEx để đăng nhập vào FedEx Developer Portal. Đây chính là ID người dùng và mật khẩu mà bạn có thể sử dụng tại fedex.com. Nếu không có ID người dùng và mật khẩu thì bạn có thể đăng ký ở đây.

Có. Quản trị viên FedEx Developer Portal phải liên kết tài khoản FedEx với tổ chức của họ để thực hiện các giao dịch. Bạn có thể tạo tài khoản cá nhân hoặc doanh nghiệp bất cứ lúc nào. Việc mở tài khoản là miễn phí.

●   Truy cập fedex.com để Đăng ký hoặc Đăng nhập

●   Chọn Hồ sơ của tôi trong menu thả xuống

●   Chọn Quản lý tài khoản để xem số tài khoản của bạn

Có, mỗi tổ chức có thể thêm số lượng tài khoản tùy ý. Bạn cần có ít nhất một tài khoản để chuyển các dự án API sang khâu sản xuất.

Chỉ quản trị viên của tổ chức mới có thể thêm và xác minh tài khoản FedEx cho tổ chức đó trên FedEx Developer Portal. Người đóng góp và người xem trong tổ chức sẽ không thể thêm tài khoản.

Không. FedEx Developer Portal sẽ chỉ định các tài khoản sandbox dựa trên một hoặc nhiều địa điểm được chọn khi tạo dự án. Những tài khoản này có thể được sử dụng để thử nghiệm.

Có, vui lòng tìm hiểu Hướng dẫn về phương thức tối ưu của chúng tôi để biết thêm chi tiết.

Có. Chúng tôi cung cấp cả môi trường thử nghiệm cũng như môi trường sản xuất.

Mã lập trình mẫu viết bằng một số ngôn ngữ lập trình khác nhau có ở các trang tài liệu dành cho từng giải pháp phần mềm.

Có. Bạn có thể tìm hiểu hướng dẫn Quản lý đánh số phiên bản và điều chỉnh API FedEx và hướng dẫn Hạn mức giao dịch và giới hạn tốc độ để biết chi tiết.

Có, bạn có thể theo dõi tối đa 30 lô hàng trong một giao dịch bằng tính năng theo dõi hàng loạt.

FedEx Web Services bao gồm các hệ thống tuân theo tiêu chuẩn SOAP WSDL để giao tiếp với các hệ thống xử lý của FedEx. FedEx đã lựa chọn đặt cơ sở các tích hợp trong tương lai trên các API REST mới này để cải thiện độ tin cậy và hiệu suất. Để tìm hiểu thêm về những điểm khác biệt này và lợi ích của việc chuyển, vui lòng truy cập trang Vì sao nên chuyển.

API FedEx sẽ không ảnh hưởng đến các giải pháp tích hợp hiện có được dựng bằng FedEx Web Services. Tuy nhiên, đối với các giải pháp tích hợp trong tương lai, FedEx Web Services sẽ không hỗ trợ tất cả các tính năng mới. Để tìm hiểu thêm về lợi ích của việc chuyển, vui lòng truy cập trang Vì sao nên chuyển.

Nếu chưa sẵn sàng chuyển thì bạn vẫn có thể truy cập vào Developer Resource Center.

Có, có nhiều cách để thực hiện việc này. Vui lòng liên hệ với bộ phận Hỗ trợ để tìm hiểu cách thức.

Vùng đệm nhãn là chuỗi được mã hóa Base64. Bạn sẽ cần phải giải mã Base64 để xem vùng đệm nhãn theo định dạng bạn đã chọn trong yêu cầu.

Rất tiếc là không. Chất lượng của nhãn gửi qua fax dưới mức tiêu chuẩn đánh giá có thể chấp nhận được, khiến chúng tôi không thể đánh giá để phê duyệt.

Có sẵn bốn trường tham chiếu: tham chiếu, hóa đơn, phòng ban và số PO. Trên máy chủ thử nghiệm, FedEx có quyền trả về giá trị cố định trong trường tham chiếu. Ba trường tham chiếu khác có thể dùng để thử nghiệm giá trị của bạn.

Địa chỉ email có thể có nhiều ID người dùng nhưng tại một thời điểm, mỗi ID người dùng chỉ có thể liên kết với một tổ chức. Nếu cần tham gia một tổ chức khác thì bạn có hai lựa chọn:

1. Bạn có thể tạo ID người dùng mới để liên kết với tổ chức mới.

2. Rời khỏi tổ chức hiện tại:

●   Nếu bạn là Quản trị viên: trên trang Quản lý tổ chức, hãy chọn tab Người dùng, sau đó chọn mục Xóa bên cạnh tên của bạn           

●   Nếu bạn là Người đóng góp hoặc Người xem: hãy đến phần Cài đặt, sau đó chọn Rời khỏi tổ chức

API chỉ là cửa ngõ giữa ứng dụng kinh doanh hiện tại của bạn và các giải pháp logistics của FedEx hỗ trợ hoạt động của doanh nghiệp FedEx toàn cầu. Bạn có thể sử dụng cửa ngõ này để đưa thông tin mới từ các giải pháp FedEx này vào các ứng dụng của riêng bạn. Để tìm hiểu thêm về API, vui lòng xem trang "API là gì?".

Không. Chúng tôi cung cấp miễn phí các API, tài liệu, mã lập trình mẫu và mọi nội dung khác có trong Cổng thông tin dành cho nhà phát triển FedEx cho các doanh nghiệp và nhà phát triển, tuân theo các điều khoản sử dụng.

Ứng dụng của bạn giao tiếp với các hệ thống xử lý của FedEx bằng cách gửi yêu cầu qua internet và đổi lại, nhận thông tin theo thời gian thực có thể được trình bày cho khách hàng của bạn một cách thống nhất.

API FedEx có chứa chức năng có thể hỗ trợ nhập đơn hàng, dịch vụ khách hàng, logistics ngược và các hoạt động thanh toán cũng như vận chuyển. Ví dụ ảnh hưởng đến mục nhập đơn hàng, giao dịch xác minh địa chỉ có thể được sử dụng trong giỏ hàng hoặc sử dụng bởi nhân viên sử dụng điện thoại để xác minh Địa chỉ giao hàng để tránh các khoản phí do sửa địa chỉ. Tính năng này hoàn toàn tách biệt với hoạt động vận chuyển và có thể ngăn ngừa những sai lầm gây tổn hại đến nhận thức của khách hàng về doanh nghiệp của bạn. Hãy khám phá các API như Xác thực địa chỉ, Giá cước, Theo dõi, v.v. trong Danh mục API của chúng tôi.

Điều này phụ thuộc vào nhiều yếu tố, chẳng hạn như: Bạn sẽ triển khai bao nhiêu chức năng? Có bao nhiêu lập trình viên được phân công? Dự án tích hợp FedEx ở ví trí nào trong danh sách ưu tiên của bạn? Lập trình viên của bạn đã thành thạo trong việc triển khai API FedEx chưa? Có thể mất ít nhất vài tuần đến vài tháng, tùy thuộc vào các yếu tố trên.

Không, API FedEx là bộ sơ đồ kỹ thuật được cung cấp cho khách hàng cùng với tài liệu và các ví dụ, từ đó đội ngũ CNTT của khách hàng có thể kết hợp nhiều chức năng của FedEx vào hệ thống nội bộ của họ. Để biết các giải pháp sẵn có, hãy xem FedEx^® Compatible.

Rất tiếc là không. Vì việc lập trình sẽ được thực hiện trên hệ thống nội bộ của khách hàng chứ không phải phần cứng do FedEx cung cấp, nên chúng tôi không hỗ trợ lập trình. FedEx có thể hỗ trợ trong việc tìm hiểu tài liệu API của FedEx, thông báo lỗi, ví dụ, v.v.

Không. Vì giải pháp này chỉ đơn giản là bộ sơ đồ kỹ thuật để thuận tiện cho bạn, không có yêu cầu về doanh thu.

Có. Chúng tôi cung cấp cả môi trường thử nghiệm cũng như môi trường sản xuất.

Tùy thuộc vào API bạn đang sử dụng, bạn có thể cần gửi dự án của mình để được Chứng nhận cơ bản, Chứng nhận nhãn hoặc không cần chứng nhận.

Có. API FedEx là giải pháp toàn cầu hoạt động tốt bên ngoài Hoa Kỳ. Để biết khả năng áp dụng trong khu vực của bạn, vui lòng xem trang Hỗ trợ.

Có hai cấp độ hỗ trợ - tư vấn và trợ giúp khắc phục sự cố chung. Vui lòng xem trang Hỗ trợ để tìm hiểu thêm.

Dịch vụ web FedEx bao gồm các hệ thống tuân theo tiêu chuẩn SOAP WSDL để giao tiếp với các hệ thống xử lý của FedEx. FedEx đã lựa chọn đặt cơ sở các tích hợp trong tương lai trên các API REST mới này để cải thiện độ tin cậy và hiệu suất. Để biết thêm thông tin về những khác biệt này và tìm hiểu lí do bạn nên di dời, vui lòng xem trang Tại sao nên di dời.

Nếu công ty của bạn chưa sẵn sàng di chuyển từ Dịch vụ web và FedEx Ship Manager® Server, bạn vẫn sẽ có quyền truy cập vào Developer Resource Center.