Ngày 12 tháng 8 năm 2025
Cải tiến FedEx Advanced Integrated Visibility trong tháng 7 năm 2025 và các bản phát hành sắp tới
Trong nỗ lực không ngừng cải thiện sản phẩm Webhook, giúp khách hàng nắm rõ hơn cũng như cải thiện trải nghiệm tích hợp, chúng tôi sắp đưa ra và đã triển khai một số cập nhật chính được liệt kê dưới đây.
Ngày phát hành: Ngày 31 tháng 7 năm 2025
- Khả năng thêm các số tài khoản vận chuyển giống nhau vào nhiều đăng ký Webhook trong một tổ chức.
- Các trang tài liệu về webhook được thiết kế mới cho dễ đọc hơn.
- Sửa lỗi – Xóa bỏ các URL Sandbox khỏi API Đăng ký dựa trên số tài khoản và các API Đăng ký dựa trên số theo dõi. Các URL sản xuất được hiển thị theo mặc định.
- Sửa lỗi – Khắc phục các sự cố giao diện người dùng trên bảng điều khiển Webhook để cho phép người dùng xem và tìm kiếm thông qua lượng lớn số tài khoản vận chuyển.
Cải tiến sắp tới – Tháng 9 năm 2025
- Chuẩn hóa mô tả sự kiện (xóa bỏ dấu chấm).
- Xóa bỏ các trường đã bỏ dùng trong lược đồ theo dõi.
- Thêm thông tin chi tiết về địa chỉ, loại cơ sở trong các nút Giữ hàng tại địa điểm, Lấy hàng.
Thông tin chi tiết bổ sung:
Vui lòng xem xét thông tin chi tiết về bản phát hành dưới đây để đảm bảo các thay đổi sắp tới không ảnh hưởng tiêu cực đến tích hợp webhook của bạn.
Bản phát hành ngày 31 tháng 7 năm 2025 – Ghi chú chi tiết
1. Thêm tài khoản vận chuyển trùng lặp vào các đăng ký webhook
Khách hàng thêm cùng một số tài khoản vận chuyển cho nhiều ID đăng ký trong quá trình tạo hoặc cập nhật webhook trong cùng một tổ chức, không áp dụng hạn chế về quốc gia.
Trường hợp ví dụ:
- Số tài khoản vận chuyển: ABC123456
- Các ID đăng ký: SubscriptionID-001, SubscriptionID-002, SubscriptionID-003
Từ giờ, bạn có thể thêm ABC123456 vào cả ba đăng ký trong quá trình tạo hoặc cập nhật webhook, hỗ trợ theo dõi và xử lý sự kiện nhất quán trên toàn bộ các hệ thống của tổ chức.
Tài liệu cập nhật về webhook
Hiện tại, trang tài liệu về webhook có phần mô tả rõ ràng hơn, chi tiết hơn với định dạng cải tiến và phương tiện trực quan để hỗ trợ các nhà phát triển.
Sửa lỗi
- Trong bản phát hành này, chúng tôi sẽ chỉ chia sẻ các URL máy chủ sản xuất trong tài liệu về Điểm cuối API cho cả API Đăng ký dựa trên số tài khoản và API Đăng ký dựa trên số theo dõi. Điều này nhằm đảm bảo sự rõ ràng, giảm bớt sự nhầm lẫn và hỗ trợ triển khai hệ thống sẵn sàng đưa vào sản xuất.
- Chúng tôi đã giải quyết sự cố khiến người dùng gặp phải lỗi khi tìm cách tạo webhook trên FedEx Developer Portal (FDP) bằng số lượng lớn tài khoản vận chuyển. Lỗi này xảy ra do không thể tải hoặc hiển thị đầy đủ danh sách tài khoản trong quá trình thiết lập webhook. Từ giờ, người dùng có thể xem và chọn thành công tất cả các tài khoản khi đặt cấu hình webhook bằng nhiều tài khoản vận chuyển.
Thông tin chi tiết về bản phát hành sắp tới – Tháng 9 năm 2025
Chúng tôi cung cấp thông tin chi tiết về các bản phát hành sắp tới ở bên dưới để bạn xem xét. Sau khi hoàn tất công việc phát triển cần thiết, chúng tôi sẽ nhanh chóng chia sẻ lịch phát hành chi tiết.
1. Chuẩn hóa mô tả sự kiện trong dữ liệu Webhook
Để đảm bảo tính nhất quán giữa các hệ thống và tích hợp, chúng tôi sẽ xóa bỏ dấu chấm (.) khỏi mô tả sự kiện. Thay đổi này áp dụng cho mọi loại sự kiện và giúp duy trì định dạng đồng bộ trên các nền tảng.
Điều này có ý nghĩa gì với tích hợp webhook của bạn?
Nếu các hệ thống của bạn phụ thuộc vào định dạng mô tả sự kiện chính xác (ví dụ: để phân tích hoặc so khớp), đây có thể là thay đổi gây lỗi.
Dưới đây là danh sách đầy đủ các mô tả sự kiện bị ảnh hưởng.
| Mô tả sự kiện hiện tại (Trước) | Mô tả sự kiện mới (Sau) |
|---|---|
| Dữ liệu bản kê hàng hóa tại sân bay. | Dữ liệu bản kê hàng hóa tại sân bay |
| Đã thông quan hải quan ở chỗ nhà môi giới hải quan. | Đã thông quan hải quan ở chỗ nhà môi giới hải quan |
| Đã đến chỗ nhà môi giới hải quan. | Đã đến chỗ nhà môi giới hải quan |
| Trì hoãn thông quan ở chỗ nhà môi giới hải quan. | Trì hoãn thông quan ở chỗ nhà môi giới hải quan |
| Đã đến cơ sở nơi nhận hàng của FedEx. | Đã đến cơ sở nơi nhận hàng của FedEx |
| Ở cơ sở nơi nhận hàng của FedEx. | Ở cơ sở nơi nhận hàng của FedEx |
| Đến cơ sở nơi nhận hàng của FedEx đúng giờ. | Đến cơ sở nơi nhận hàng của FedEx đúng giờ |
| Đến cơ sở nơi nhận hàng của FedEx từ sớm. | Đến cơ sở nơi nhận hàng của FedEx từ sớm |
| Sẵn sàng để lấy hàng ở cơ sở nơi nhận hàng của FedEx. | Sẵn sàng để lấy hàng ở cơ sở nơi nhận hàng của FedEx |
| Ngoại lệ giao hàng ở cơ sở nơi nhận hàng của FedEx. | Ngoại lệ giao hàng ở cơ sở nơi nhận hàng của FedEx |
| Trì hoãn ở cơ sở nơi nhận hàng của FedEx. | Trì hoãn ở cơ sở nơi nhận hàng của FedEx |
| Giữ hàng ở cơ sở nơi nhận hàng của FedEx. | Giữ hàng ở cơ sở nơi nhận hàng của FedEx |
| Đã đến địa điểm giao hàng. | Đã đến địa điểm giao hàng |
| Ngoại lệ giao hàng ở địa điểm giao hàng. | Ngoại lệ giao hàng ở địa điểm giao hàng |
| Đến địa điểm giao hàng đúng giờ. | Đến địa điểm giao hàng đúng giờ |
| Đến địa điểm giao hàng từ sớm. | Đến địa điểm giao hàng từ sớm |
| Trì hoãn giao hàng ở địa điểm giao hàng. | Trì hoãn giao hàng ở địa điểm giao hàng |
| Yêu cầu tùy chọn giao hàng bị hủy ở điểm giữa chặng. | Yêu cầu tùy chọn giao hàng bị hủy ở điểm giữa chặng |
| Đến điểm giữa chặng từ sớm. | Đến điểm giữa chặng từ sớm |
| Đến điểm giữa chặng đúng giờ. | Đến điểm giữa chặng đúng giờ |
| Trì hoãn lấy hàng ở điểm giữa chặng. | Trì hoãn lấy hàng ở điểm giữa chặng |
| Đã thông quan hải quan ở điểm giữa chặng. | Đã thông quan hải quan ở điểm giữa chặng |
| Trì hoãn giao hàng ở điểm giữa chặng. | Trì hoãn giao hàng ở điểm giữa chặng |
| Đã thông quan hải quan ở cơ sở của FedEx. | Đã thông quan hải quan ở cơ sở của FedEx |
| Trì hoãn thông quan ở cơ sở của FedEx. | Trì hoãn thông quan ở cơ sở của FedEx |
| Ở cơ sở của FedEx. | Tại cơ sở của FedEx |
| Đã khởi hành từ cơ sở của FedEx. | Đã khởi hành từ cơ sở của FedEx |
| Đã đến cơ sở của FedEx. | Đã đến cơ sở của FedEx |
| Đang tiến hành thông quan ở cơ sở của FedEx. | Đang tiến hành thông quan ở cơ sở của FedEx |
| Đến cơ sở của FedEx đúng giờ. | Đến cơ sở của FedEx đúng giờ |
| Đến cơ sở của FedEx từ sớm. | Đến cơ sở của FedEx từ sớm |
| Đã đến cơ sở nơi gửi hàng của FedEx. | Đã đến cơ sở nơi gửi hàng của FedEx |
| Trì hoãn ở cơ sở của FedEx. | Trì hoãn ở cơ sở của FedEx |
| Đã khởi hành từ cơ sở nơi gửi hàng của FedEx. | Đã khởi hành từ cơ sở nơi gửi hàng của FedEx |
| Đang được FedEx giữ ở cơ sở của FedEx. | Đang được FedEx giữ ở cơ sở của FedEx |
| Chuyển hàng ở cơ sở của FedEx. | Chuyển hàng ở cơ sở của FedEx |
| Xử lý theo yêu cầu ở cơ sở của FedEx. | Xử lý theo yêu cầu ở cơ sở của FedEx |
| Đến cơ sở nơi gửi hàng của FedEx đúng giờ. | Đến cơ sở nơi gửi hàng của FedEx đúng giờ |
| Đến cơ sở nơi gửi hàng của FedEx từ sớm. | Đến cơ sở nơi gửi hàng của FedEx từ sớm |
| Trì hoãn thông quan ở cơ sở nơi gửi hàng của FedEx. | Trì hoãn thông quan ở cơ sở nơi gửi hàng của FedEx |
| Đã thay đổi địa điểm ở cơ sở nơi gửi hàng của FedEx. | Đã thay đổi địa điểm ở cơ sở nơi gửi hàng của FedEx |
| Đã thông quan hải quan ở cơ sở nơi gửi hàng của FedEx. | Đã thông quan hải quan ở cơ sở nơi gửi hàng của FedEx |
| Chuyển hàng ở cơ sở nơi gửi hàng của FedEx. | Chuyển hàng ở cơ sở nơi gửi hàng của FedEx |
| Đến địa điểm lấy hàng đúng giờ. | Đến địa điểm lấy hàng đúng giờ |
| Đến địa điểm lấy hàng từ sớm. | Đến địa điểm lấy hàng từ sớm |
| Đang được FedEx giữ ở địa điểm lấy hàng. | Đang được FedEx giữ ở địa điểm lấy hàng |
| Đến chỗ xe từ sớm. | Đến chỗ xe từ sớm |
| Đến chỗ xe đúng giờ. | Đến chỗ xe đúng giờ |
| Đã khởi hành từ nơi nhận hàng. | Đã khởi hành từ nơi nhận hàng |
| Đã đến nơi nhận hàng. | Đã đến nơi nhận hàng |
| Đến nơi nhận hàng từ sớm. | Đến nơi nhận hàng từ sớm |
| Đến nơi nhận hàng đúng giờ. | Đến nơi nhận hàng đúng giờ |
| Đã đến địa điểm lấy hàng. | Đã đến địa điểm lấy hàng |
| Trì hoãn lấy hàng ở địa điểm lấy hàng. | Trì hoãn lấy hàng ở địa điểm lấy hàng |
2. Dọn dẹp lược đồ và xóa bỏ trường
Để giảm bớt sự dư thừa và tinh giản phần tải, các trường sau đây sẽ bị xóa bỏ khỏi lược đồ phản hồi theo dõi:
- scanEvent/eventAdditionalInfo/employeeId
- scanEvent/previousEvents/[Array]/eventAdditionalInfo/employeeId
- trackResult/documents/[Array]/systemId
- trackResult/documents/[Array]/lineNbr
- trackResult/documents/[Array]/recordId
- trackResult/documents/[Array]/folderId
Đây không còn là các trường bắt buộc và sẽ bị bỏ dùng trong các bản phát hành sắp tới.
3. Cải tiến các sự kiện Giữ hàng tại địa điểm, Sẵn sàng để lấy hàng
Chúng tôi sẽ thêm thông tin chi tiết về địa điểm. Trước đây, sự kiện giữ hàng sẽ hiển thị là:
Giữ hàng tại <Facility>
Từ giờ, cách hiển thị thay thế là:
Giữ hàng tại <Address> (<Facility Type>)
Thay đổi này giúp khách hàng nắm rõ hơn về địa điểm chính xác đang giữ gói hàng để họ lấy hàng, từ đó cải thiện trải nghiệm giao hàng tổng thể.
Sự kiện "Sẵn sàng để lấy hàng" hiển thị và thêm dòng địa chỉ trực tiếp vào mô tả sự kiện. Cải tiến này cho phép khách hàng thấy ngay được địa điểm có thể lấy gói hàng của mình mà không cần tham khảo các trường bổ sung.
Ví dụ:
Trước:
Lấy hàng tại Văn phòng FedEx
Sau:
Sẵn sàng cho người nhận lấy hàng
(Có thể lấy gói hàng tại Văn phòng FedEx – 610.9TH ST), DURHAM, NC
Điều này giúp khách hàng biết chính xác địa điểm cần đến để lấy gói hàng của họ, đặc biệt hữu ích khi có nhiều địa điểm FedEx lân cận.
