TẠO
WEBHOOK QUẢN LÝ WEBHOOK

Các loại webhook Advanced Integrated Visibility

Webhook Advanced Integrated Visibility cho phép FedEx gửi dữ liệu sự kiện theo dõi bảo mật, gần như tức thì về lô hàng được liên kết với số tài khoản FedEx cụ thể đến URL đích.

Bạn có thể tạo dự án webhook Advanced Integrated Visibility trên FedEx Developer Portal, rồi liên kết dự án đó với một hoặc nhiều số tài khoản FedEx hoặc số theo dõi FedEx, dựa trên loại gói đăng ký đã chọn.

Chuyển đến:

GÓI ĐĂNG KÝ ADVANCED INTEGRATED VISIBILITY DỰA TRÊN SỐ TÀI KHOẢN hoặc GÓI ĐĂNG KÝ ADVANCED INTEGRATED VISIBILITY DỰA TRÊN SỐ THEO DÕI và xem các bước tạo webhook Advanced Integrated Visibility tương ứng.

Tổng quan về FedEx Advanced Integrated Visibility

Khách hàng của FedEx có thể đăng ký Số tài khoản hoặc Số theo dõi để nhận thông báo gần như tức thì về các sự kiện gắn với lô hàng đang vận chuyển, từ tạo nhãn cho đến bằng chứng giao gói hàng, bao gồm cả bằng chứng giao hàng có hình ảnh.

Loại gói đăng ký

Khách hàng của FedEx có thể đăng ký nhận thông tin từ Advanced Integrated Visibility theo các tùy chọn sau:

Bằng số tài khoản – Đăng ký Số tài khoản FedEx để nhận thông tin cập nhật về các lô hàng tương ứng với tài khoản đó.
Bằng Số theo dõi – Đăng ký Số theo dõi FedEx để nhận thông tin cập nhật về các lô hàng tương ứng với số theo dõi được chỉ định thông qua điểm cuối API.

Lưu ý: Hiện tại, các gói đăng ký yêu cầu phải có tài khoản FedEx 9 chữ số tại Hoa Kỳ để thanh toán và khách hàng sẽ phải trả một khoản phí hằng tháng dựa trên số lượng Số theo dõi. Để tìm hiểu thêm về giá của Advanced Integrated Visibility, vui lòng tham khảo Hướng dẫn về giá trong Tổng quan về Advanced Integrated Visibility.

Nếu bạn đăng ký bằng Số tài khoản thì hiện tại, Gói đăng ký yêu cầu sử dụng tài khoản vận chuyển FedEx 9 chữ số tại Hoa Kỳ.

Bảng dưới đây cung cấp thông tin về các tính năng của gói đăng ký Advanced Integrated Visibility dựa trên số tài khoản và dựa trên số theo dõi

Tính năng	Gói đăng ký dựa trên số tài khoản	Gói đăng ký dựa trên số theo dõi
Phản hồi	Dữ liệu bảo mật gồm Thông tin nhận dạng cá nhân (PII), dữ liệu về người gửi và người nhận, Bằng chứng giao hàng có chữ ký (SPOD), Tùy chọn giao hàng thuận tiện (CDO)/phản hồi	Dữ liệu ẩn danh (Bao gồm thông tin Lô hàng, thông tin cập nhật Quá trình vận chuyển, không bao gồm Thông tin nhận dạng cá nhân (PII)/phản hồi
Liên kết	Liên kết theo số tài khoản nghĩa là liên kết đồng thời tất cả các số theo dõi được liên kết	Liên kết số theo dõi
Quyền sở hữu	Số tài khoản phải do chính người dùng sở hữu	Số theo dõi không cần phải do chính người dùng sở hữu
Lọc	Có khả năng lọc sự kiện theo lô hàng nhập, lô hàng xuất và lô hàng của bên thứ ba	Không thể lọc sự kiện
Tích hợp	Liên kết các số tài khoản thông qua UI	Liên kết các số theo dõi thông qua điểm cuối API
Hạn chế	Có thể thêm tối đa 100 số tài khoản	Có thể thêm tối đa 1000 số theo dõi cho mỗi yêu cầu
Trường hợp sử dụng phù hợp	Khách hàng bên thứ nhất – Nếu khách hàng sở hữu số tài khoản	Khách hàng bên thứ ba – Nếu khách hàng có số theo dõi thuộc về khách hàng bên thứ nhất

FedEx Integrated Visibility – So sánh tính năng theo loại gói đăng ký

Tính năng/Phần tử dữ liệu	Gói đăng ký dựa trên số theo dõi	Gói đăng ký dựa trên số tài khoản	Ghi chú
SPOD (Bằng chứng giao hàng có chữ ký)	Không có	Có sẵn (cần đặt cấu hình)	Hình ảnh chữ ký ở định dạng TIFF, được cung cấp trong phần tải
PPOD (Bằng chứng giao hàng có hình ảnh)	Có sẵn (cần đặt cấu hình)	Có sẵn (cần đặt cấu hình)	Hình ảnh JPEG về vị trí giao hàng, được mã hóa base64
PPODA (Bằng chứng đưa hàng đi giao có hình ảnh)	Có sẵn (cần đặt cấu hình)	Có sẵn (cần đặt cấu hình)	Đối với các lần đưa hàng đi giao, hình ảnh JPEG được cung cấp
Tọa độ theo GPS (gpsPodCoordinates)	Không có	Khả dụng	Bị ẩn trong các gói đăng ký dựa trên số theo dõi
Thông tin liên hệ (Tên, Số điện thoại, Công ty)	Bị ẩn	Khả dụng	Áp dụng cho người gửi, người nhận, nơi gửi hàng, nơi nhận hàng, nhà môi giới, v.v.
Địa chỉ cụ thể và mã bưu chính	Bị ẩn	Khả dụng	streetLines và postalCode bị ẩn trong phần tải dựa trên số theo dõi
Số tài khoản	Bị ẩn	Khả dụng	Bao gồm các giá trị tài khoản thanh toán, người nhận và người gửi
Thông tin tài chính của gói hàng (ví dụ: declaredValue, codAmount)	Bị ẩn	Khả dụng	Giá trị hải quan, COD và khai báo đều bị ẩn
Chi tiết truy vấn và trả hàng (Mã truy vấn, Lý do trả hàng)	Bị ẩn	Khả dụng	Toàn bộ chi tiết chỉ hiển thị cho người đăng ký nhận thông tin dựa trên số tài khoản
Dữ liệu hàng hóa và thành phần	Bị ẩn	Khả dụng	Bao gồm mã linh kiện, nội dung mô tả và số lượng
ID nhân viên (ví dụ: nhân viên sự kiện)	Bị ẩn	Không có	Bị ẩn trong cả hai trường hợp vì lý do bảo mật
Thông báo sự kiện và EDD/EDTW	Khả dụng	Khả dụng	Tính năng ngày/giờ giao hàng ước tính được hỗ trợ cho cả hai gói đăng ký
Lô hàng nhiều kiện (MPS)	Khả dụng	Khả dụng	Với thông tin theo dõi bổ sung
Chỉ số độ tin cậy và nguy cơ giao hàng ước tính	Khả dụng	Khả dụng	Chỉ có ở Bậc cao cấp

Trường dữ liệu bị ẩn đối với Gói đăng ký Advanced Integrated Visibility dựa trên số theo dõi

Tóm tắt

Khi khách hàng đăng ký nhận thông tin cập nhật theo dõi lô hàng sử dụng Gói đăng ký Advanced Integrated Visibility dựa trên số theo dõi thay vì Gói đăng ký Advanced Integrated Visibility dựa trên số tài khoản, các trường dữ liệu nhất định sẽ được ẩn nhằm bảo vệ quyền riêng tư của khách hàng và tuân thủ các chính sách bảo mật dữ liệu.

Việc ẩn dữ liệu này đảm bảo rằng chỉ bên được ủy quyền mới có thể truy cập các thông tin nhạy cảm như chi tiết liên hệ cá nhân, địa chỉ và giá trị tài chính. Khách hàng sử dụng Gói đăng ký Advanced Integrated Visibility dựa trên số tài khoản sẽ nhìn thấy "XXXXX" ở những trường dữ liệu bị ẩn được liệt kê dưới đây, mặc dù dữ liệu này có thể truy cập được thông qua Gói đăng ký Advanced Integrated Visibility dựa trên số theo dõi.

Việc ẩn dữ liệu này có những hệ quả sau:

Chi tiết về nơi gửi hàng/nơi nhận hàng và các bên liên quan sẽ hạn chế hiển thị.
Không có thông tin nhận dạng cá nhân (ví dụ: tên, số điện thoại) và dữ liệu tài chính hoặc liên quan đến hải quan.
Nhằm bảo vệ thông tin độc quyền hoặc nhạy cảm về lô hàng vì lý do bảo mật và tuân thủ quy định.

Khách hàng cần truy cập các trường bị ẩn này để phục vụ mục đích vận hành hoặc kinh doanh nên đăng ký bằng Số tài khoản.

Các điểm dữ liệu bị ẨN trong Gói đăng ký Advanced Integrated Visibility dựa trên số theo dõi:

Sự kiện quét

scanEvent/location/locationContactAndAddress/address/streetLines
scanEvent/location/locationContactAndAddress/contact/phoneNumber
scanEvent/location/locationContactAndAddress/contact/companyName
scanEvent/location/locationContactAndAddress/contact/personName
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/address/streetLines
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/phoneNumber
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/companyName
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/personName

Thông tin về hãng vận chuyển

trackResult/shipperInfo/contactAndAddress/address/postalCode
trackResult/shipperInfo/contactAndAddress/address/streetLines
trackResult/shipperInfo/contactAndAddress/contact/phoneNumber
trackResult/shipperInfo/contactAndAddress/contact/companyName
trackResult/shipperInfo/contactAndAddress/contact/personName
trackResult/shipperInfo/account/value

Thông tin về người nhận

trackResult/recipientInfo/contactAndAddress/address/postalCode
trackResult/recipientInfo/contactAndAddress/address/streetLines
trackResult/recipientInfo/account/value
trackResult/recipientInfo/contactAndAddress/contact/phoneNumber
trackResult/recipientInfo/contactAndAddress/contact/companyName
trackResultecipientInfo/contactAndAddress/contact/personName

Địa điểm gửi hàng và nhận hàng

trackResult/originLocation/locationDetail/locationContactAndAddress/contact/personName
trackResult/originLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/originLocation/locationDetail/locationContactAndAddress/contact/companyName
trackResult/originLocation/locationDetail/locationContactAndAddress/address/streetLines
trackResult/originLocation/locationDetail/locationContactAndAddress/address/postalCode
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/personName
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/companyName
trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/streetLines
trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/postalCode

Chi tiết giao hàng và thay đổi địa chỉ

trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/streetLines
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/postalCode
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/gpsPodCoordinates
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/personName
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/companyName
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/streetLines
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/postalCode
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/personName
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/companyName

Thông tin nhà môi giới

trackResult/broker/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/broker/locationDetail/locationContactAndAddress/contact/companyName
trackResult/broker/locationDetail/locationContactAndAddress/contact/personName
trackResult/broker/locationDetail/locationContactAndAddress/address/streetLines
trackResult/broker/locationDetail/locationContactAndAddress/address/postalCode

Chi tiết gói hàng và tài chính

trackResult/packageDetail/customsValue/value
trackResult/packageDetail/declaredValue/value
trackResult/packageDetail/originalTransportationCharge/value
trackResult/codDetail/codAmount/value

Thông tin truy vấn và hàng hóa

trackResult/inquiries/[Array]/categoryCode
trackResult/inquiries/[Array]/code
trackResult/inquiries/[Array]/createTime
trackResult/inquiries/[Array]/statusCode
trackResult/commodityInfo/[Array]/description
trackResult/commodityInfo/[Array]/code

Thành phần gói hàng và lý do trả hàng

trackResult/contents/[Array]/partNumber
trackResult/contents/[Array]/partCode
trackResult/contents/[Array]/description
trackResult/contents/[Array]/quantity
trackResult/returnReason/[Array]/code
trackResult/returnReason/[Array]/description

Thông tin thanh toán

trackResult/billToParties/[Array]/billToParty/accountNumber

Lợi ích dành cho khách hàng:

Cải thiện sự tin cậy của người nhận bằng thông báo chủ động về các thay đổi trong quá trình vận chuyển, về Ngày giao hàng ước tính và Khoảng thời gian giao hàng.
Giảm chi phí với bộ phận dịch vụ khách hàng cho các cuộc gọi WISMO (Đơn hàng của tôi ở đâu) cũng như khiếu nại về giao hàng nhờ việc cung cấp Bằng chứng giao hàng có hình ảnh của FedEx.
Nâng tầm trải nghiệm của khách hàng bằng cách cung cấp thông báo gần như tức thì về trạng thái lô hàng.
Nâng cao hiệu quả hoạt động bằng cách nhận thông tin cập nhật tức thì về các lô hàng, thay vì phải liên tục kiểm tra để cập nhật thông tin theo dõi mỗi lô hàng.

Các tính năng và sự kiện theo dõi

Sự kiện theo dõi

Tính năng này cho phép theo dõi trạng thái của lô hàng và chủ động thông báo cho khách hàng về những thông tin cập nhật khác nhau trong vòng đời của lô hàng. Khách hàng có thể lựa chọn giai đoạn xử lý/sự kiện lô hàng mà họ muốn nhận thông báo/cảnh báo. Các sự kiện vận chuyển hiện có bao gồm:

Vận chuyển: Tùy chọn này cung cấp thông báo khi sự kiện của lô hàng đã chọn xảy ra. Ví dụ: Đã tạo nhãn, Lấy hàng, v.v.
Đang vận chuyển: Tùy chọn này cung cấp thông báo về sự kiện vận chuyển lô hàng. Ví dụ: Đang vận chuyển, mặt hàng được giữ tại văn phòng giao hàng, v.v.
Giao hàng: Tùy chọn này cung cấp thông báo về sự kiện giao lô hàng. Ví dụ: xuất để giao hàng, đã giao hàng, v.v.
Ngoại lệ: Tùy chọn này cung cấp thông báo về ngoại lệ giao hàng. Ví dụ: trì hoãn thông quan, v.v.
Tùy chọn giao hàng thuận tiện: Chọn tùy chọn này để nhận thông báo về một số sự kiện theo dõi theo yêu cầu cá nhân. Ví dụ: đã chấp nhận yêu cầu giữ hàng tại địa điểm.

Để biết thêm thông tin về các tùy chọn hiện có liên quan đến sự kiện lô hàng, hãy tham khảo bảng Trạng thái và mã trạng thái cho sự kiện theo dõi của Advanced Integrated Visibility.

Bằng chứng giao hàng

Tính năng này dùng để xác nhận đơn hàng đã đến nơi nhận hàng dự kiến thành công. Những thông tin này bao gồm:

Bằng chứng giao hàng có hình ảnh (PPOD): PPOD cho phép khách hàng nhận hình ảnh cho thấy địa điểm chính xác của gói hàng sau khi gói hàng được giao đến tận nhà.
Advanced Integrated Visibility cung cấp hình ảnh PPOD trong phần tải JSON ở định dạng base64. Sau đó, bạn có thể chuyển đổi hình ảnh sang định dạng JPEG.

Lưu ý:
Hình ảnh bằng chứng đưa hàng đi giao (PPODA): PPODA cho phép khách hàng nhận hình ảnh cho thấy địa điểm chính xác của nơi gói hàng sẽ được giao, trong trường hợp không thể hoàn tất việc giao hàng. Advanced Integrated Visibility cung cấp hình ảnh PPODA trong phần tải JSON ở định dạng base64. Sau đó, bạn có thể chuyển đổi hình ảnh sang định dạng JPEG.

Bằng chứng giao hàng có chữ ký (SPOD): SPOD cho phép khách hàng nhận hình ảnh chữ ký của người nhận cũng như tên của họ, ngày, giờ và địa điểm giao hàng. Thông tin về SPOD sẽ được thể hiện thành mảng byte mà không phải bằng hình ảnh. Mảng byte là một chuỗi được mã hóa base64, phải giải mã để có được hình ảnh chữ ký cuối cùng ở định dạng PNG

Bằng chứng giao hàng theo GPS (GPSPOD):
- GPS POD cho phép khách hàng nhận được tọa độ địa lý của địa điểm giao hàng.
  
  Lưu ý: Theo mặc định, GPSPOD có ở gói đăng ký Advanced Integrated Visibility dựa trên số tài khoản.

Sự kiện về khoảng thời gian và ngày giao hàng ước tính

Tính năng này cung cấp ngày và/hoặc khoảng thời gian giao lô hàng, giúp người nhận lô hàng bố trí lịch trình. Những thông tin này bao gồm:

Ngày giao hàng ước tính (EDD): Tùy chọn này cung cấp cho người nhận ngày ước tính giao lô hàng. Ví dụ: ngày 20 tháng 11 năm 20XX.
Khung thời gian giao hàng ước tính (EDTW): Tùy chọn này cung cấp cho người nhận khoảng thời gian ước tính giao lô hàng vào ngày giao hàng thực tế. Ví dụ: 14:00 – 18:00.

Lọc theo sự kiện

Tính năng này cho phép khách hàng sắp xếp dự án webhook dựa trên phương thức thanh toán lô hàng. Các tùy chọn bao gồm:

Nhập: chọn tùy chọn này cho lô hàng sẽ được giao đến bạn và do bạn thanh toán với tư cách người nhận.
Xuất: chọn tùy chọn này cho lô hàng do bạn gửi và thanh toán với tư cách người gửi.
Bên thứ ba: chọn tùy chọn này cho lô hàng xuất và nhập mà bạn được lập hóa đơn với tư cách người thanh toán bên thứ ba.

Lưu ý: Số tài khoản FedEx của bạn sẽ được dùng để lập hóa đơn hoặc thanh toán lô hàng. Với trường hợp người thanh toán bên thứ ba, bạn có thể không phải là người gửi hay người nhận, nhưng số tài khoản FedEx của bạn vẫn sẽ bị tính phí.

Chính sách thử lại

Tính năng này ngăn FedEx gửi dữ liệu sự kiện theo dõi trong trường hợp có sự cố phía máy khách. FedEx sẽ giữ lại dữ liệu và cố gắng gửi lại trong 3 lần thử cách nhau 5 phút.

Nếu không nhận được phản hồi thành công trong khoảng thời gian đã xác định, FedEx sẽ dừng việc gửi lại sự kiện đó. Tuy nhiên, khách hàng có thể yêu cầu gửi lại các sự kiện đã bỏ lỡ trong 7 ngày vừa qua bằng cách bấm vào nút "THỬ LẠI" trên trang Chi tiết của dự án webhook Advanced Integrated Visibility.

Để biết thêm thông tin về chính sách thử lại, hãy tham khảo phần Cơ chế thử lại.

Request
Response

Response

Copy

TẠO WEBHOOK QUẢN LÝ WEBHOOK