Fedex Logo

Cách thức hoạt động của Advanced Integrated Visibility

Webhook Advanced Integrated Visibility cho phép FedEx gửi thông tin cập nhật an toàn và gần như theo thời gian thực về sự kiện theo dõi đến URL cụ thể. Những thông tin cập nhật này áp dụng cho các lô hàng liên kết với một hoặc nhiều số tài khoản FedEx. Để sử dụng tính năng này, bạn cần tạo một dự án webhook Advanced Integrated Visibility.

Cách thức truy cập trang Advanced Integrated Visibility

Bạn có thể truy cập vào trang thiết lập Advanced Integrated Visibility theo hai cách:

Cách 1: Qua mục Dự án của tôi

    1. Vào mục Dự án của tôi ở bảng điều hướng bên trái.

    2. Nhấp vào tab Webhook.

    3. Chọn + TẠO DỰ ÁN WEBHOOK.

Cách 2: Qua Danh mục API

    1. Mở Danh mục API từ bảng điều hướng bên trái.

    2. Tìm kiếm Advanced Integrated Visibility.

    3. Sử dụng bộ lọc WEBHOOK để tìm đúng thẻ.

    4. Trên thẻ:

  •  Nhấp vào Tổng quan rồi nhấp vào nút Tài liệu, sau đó chọn + TẠ0 DỰ ÁN WEBHOOK.
  •  Hoặc truy cập mục TÀI LIỆU rồi nhấp vào + TẠO DỰ ÁN WEBHOOK.

 

Bước 1: Chọn loại hình công ty

Nhấp vào + TẠO DỰ ÁN và chọn loại hình công ty của bạn từ danh sách thả xuống:

    1. Vận chuyển qua FedEx và cần tích hợp webhook của FedEx vào hệ thống.

    2. Bán hoặc cung cấp giải pháp phần mềm sử dụng dữ liệu của FedEx và không phải là nhà cung cấp FedEx Compatible được chứng nhận.

    3. Là một nhà cung cấp FedEx Compatible được chứng nhận.

 

Tiếp theo, hãy chọn Gói thanh toán định kỳ Advanced Integrated Visibility dựa trên số theo dõi làm loại gói thanh toán định kỳ của bạn.

Tạo Gói thanh toán định kỳ Advanced Integrated Visibility dựa trên số theo dõi

Bạn có thể thiết lập Gói thanh toán định kỳ Advanced Integrated Visibility dựa trên số theo dõi để nhận thông tin cập nhật an toàn và gần như theo thời gian thực về sự kiện theo dõi cho một hoặc nhiều số theo dõi FedEx. Những thông tin cập nhật này được gửi đến URL đích mà bạn chỉ định.

 

Các bước để tạo gói thanh toán định kỳ

Quá trình này bao gồm bốn bước chính:

    1. Định cấu hình dự án

    2. Nhập chi tiết dự án

    3. Xác nhận chi tiết và chấp nhận điều khoản

    4. Thêm số theo dõi

 

Hướng dẫn từng bước

    1. Trên trang Định cấu hình webhook:

         Kiểm tra Số tài khoản thanh toán

         Số tài khoản thanh toán mặc định của tổ chức bạn sẽ được hiển thị.

         Cách thay đổi số tài khoản:

  •  Nhấp vào THÊM TÀI KHOẢN THANH TOÁN VÀO TỔ CHỨC (nếu bạn chỉ có một tài khoản) hoặc
  •  Nhấp vào CHỌN TÀI KHOẢN THANH TOÁN KHÁC (nếu bạn có nhiều tài khoản).

 

Lưu ý: Để biết chi tiết về giá, hãy truy cập trang Tổng quan về Advanced Integrated Visibility.

 

2. Chọn tính năng

  •  Chọn các tính năng bạn cần dùng.
  •  Nhấp vào Tiếp theo để tiếp tục.

Mẹo: Để tìm hiểu thêm về từng tính năng, hãy nhấp vào biểu tượng trợ giúp (?) bên cạnh tính năng.

Mô tả tính năng

Tên trường Mô tả
Bằng chứng giao hàng Xác nhận rằng lô hàng đã được giao thành công. Bao gồm:
  • Hình ảnh bằng chứng giao hàng (PPODA): Cung cấp ảnh cho thấy địa điểm giao hàng chính xác.
  • Bằng chứng giao hàng có chữ ký (SPOD): Cung cấp hình ảnh chữ ký và tên của người nhận cùng ngày, giờ và địa điểm giao hàng.
Giao hàng ước tính Giúp người nhận lập kế hoạch bằng cách cung cấp:
  • Ngày giao hàng ước tính (EDD)
  • Khung thời gian giao hàng ước tính (EDTW)
Sự kiện theo dõi Cho phép chọn một hoặc nhiều danh mục sự kiện để nhận thông báo:
  • Vận chuyển
  • Đang vận chuyển
  • Giao hàng
  • Ngoại lệ

 

Trên trang Nhập chi tiết, hãy cung cấp thông tin sau:

Tên trường Mô tả
Tên dự án Webhook Tên không trùng lặp, không để trống cho dự án webhook của bạn. Tên được đề xuất sẽ tự động điền nhưng bạn có thể chỉnh sửa tên này. Bạn không được sử dụng lại tên này trong bất kỳ webhook nào khác.
URL đích Điểm cuối HTTPS an toàn, nơi FedEx sẽ gửi dữ liệu về sự kiện theo dõi.
Yêu cầu:
  • Phải hợp lệ và đang hoạt động
  • Phải tuân theo cú pháp chuẩn hóa
  • Không được bao gồm fedex.com hay các miền phụ của miền này
  • Có thể sử dụng lại trên nhiều webhook
Tham khảo phần Quy tắc kinh doanh và phương thức tối ưu để biết thêm chi tiết.
Mã thông báo bảo mật Mã bí mật dùng chung được sử dụng để xác thực và kiểm tra phản hồi của webhook thông qua HMAC.
Yêu cầu:
  • 26 – 100 ký tự
  • Phải bao gồm ít nhất 1 ký tự viết hoa, 1 ký tự viết thường và 1 ký tự số
  • Có thể sử dụng lại trên nhiều webhook
Ngôn ngữ (quốc gia) cho phần tải Chọn ngôn ngữ ưu tiên cho bản dịch dữ liệu theo dõi trong danh sách thả xuống.
Loại theo dõi Chọn cách thức cung cấp dữ liệu theo dõi:
  • Theo dõi chi tiết – Toàn bộ lịch sử sự kiện
  • Theo dõi sự kiện cụ thể – Chỉ sự kiện gần đây nhất
Địa chỉ email Cung cấp địa chỉ email hợp lệ để nhận thông báo.
Ngôn ngữ email (Quốc gia) Chọn ngôn ngữ ưu tiên để nhận thông báo qua email.
Lưu ý: Chỉ hỗ trợ ngôn ngữ của Hoa Kỳ (ví dụ: en-US, es-US).

3. Trên trang Xác nhận chi tiết:

  •  Xem lại thông tin chi tiết về dự án webhook.
  •  Kiểm tra và chấp nhận các Điều khoản và điều kiện.
  •  Nhấp vào Tạo để hoàn tất quá trình thiết lập dự án webhook.

4. Sau khi yêu cầu của bạn được gửi đi thành công:

  •  FedEx sẽ tạo một Dự án webhook mới.
  •  Bạn sẽ nhận được mã khóa sản xuất cho Advanced Integrated Visibility Tracking Number Subscription API.
  •  Bạn có thể sử dụng API này để liên kết số theo dõi với dự án của mình.

Để tìm hiểu thêm, hãy tham khảo trang tài liệu về Advanced Integrated Visibility Tracking Number Subscription API.

Cách thêm số theo dõi vào webhook

Để thêm số theo dõi vào gói thanh toán định kỳ webhook của bạn bằng Advanced Integrated Visibility Tracking Number Subscription API, hãy làm theo các bước sau:

 

Quy trình từng bước

1. Tạo Dự án gói thanh toán định kỳ

· Làm theo các bước trong phần trước hoặc tham khảo Hướng dẫn bắt đầu.

2. Tạo Mã thông báo OAuth

  •  Bạn cần có mã thông báo OAuth để thực hiện các lệnh gọi API.
  •  Sử dụng Authorization API để tạo mã thông báo.
  •  Vui lòng tham khảo tài liệu về Authorization API trong Danh mục API để biết các bước chi tiết.

3. Truy cập tài liệu API

  • Trong menu điều hướng bên trái, nhấp vào Chi tiết dự án.
  • Trong tab Mã khóa sản xuất, cuộn để tìm tài liệu về Advanced Integrated Visibility Tracking Number Subscription API.

Tổng quan về điểm cuối API

Điểm cuối Mục đích
Liên kết số theo dõi Thêm hoặc xóa số theo dõi khỏi gói thanh toán định kỳ webhook. Đây là một công việc không đồng bộ. ID công việc sẽ được trả về trong phản hồi.
Chi tiết công việc dựa trên số theo dõi Cung cấp thông tin chi tiết cho ID công việc cụ thể, chẳng hạn như số lượng số theo dõi đã được thêm thành công hoặc vẫn đang được xử lý.
Trạng thái công việc dựa trên số theo dõi Trả về bản tóm tắt tất cả các công việc hiện đang được xử lý.

 

Sử dụng mã thông báo OAuth từ Bước 2 với điểm cuối Liên kết số theo dõi để thêm số theo dõi vào webhook.

Quy tắc xác thực

  •  Tên webhook không được trùng lặp.
  •  URL đích phải tuân theo định dạng cú pháp chuẩn.
  •  Phải điền tất cả các trường bắt buộc.
  •  Phải liên kết ít nhất một số tài khoản vận chuyển FedEx hợp lệ.

 

Kết quả xác thực

Trạng thái Chi tiết
Thành công Thông báo xác nhận sẽ hiển thị:
"Đã tạo thành công <>. Các thay đổi có thể mất tối đa 10 phút mới có hiệu lực".
Không thành công Nếu FedEx nhận được bất kỳ phản hồi nào khác ngoài 200 (OK) hoặc 202 (Đã chấp nhận) thì việc xác thực URL đích của webhook sẽ bị coi là thất bại.
CLOSE

Response

Copy