• Không thể sử dụng một số tài khoản vận chuyển trong nhiều Advanced Integrated Visibility.
• URL đích/điểm cuối do khách hàng tạo phải:
  
  • Là máy chủ HTTPS.
    
  • Phản hồi các yêu cầu POST và phân tích phần tải JSON.
  • Giới hạn là 200 ký tự
  • URL của bạn sẽ bị chặn nếu bao gồm:
    • Không gian IP RFC1918
    • fedex.com hoặc miền phụ tương ứng
    • Địa chỉ IP trong URL này (kể cả localhost 127.0.0.1)

• Bảo mật Advanced Integrated Visibility: Chỉ hỗ trợ các kết nối HTTPS sử dụng phiên bản giao thức TLS (SSL) 1.2 trở lên có cấu hình bao gồm một chứng chỉ của cơ quan phát hành chứng chỉ (CA) hợp lệ. Hãy đưa các địa chỉ IP dưới đây vào danh sách cho phép để nhận thông tin cập nhật từ máy chủ FedEx mà không bị gián đoạn:
  

  Sản xuất
  Khách hàng có thể đưa vào danh sách cho phép: "nat.fxconnect.eastus2.heap-prod.fedex.io"
  Bằng cách sử dụng CIDR "20.65.16.22/31"

• Đôi khi, khách hàng có thể nhận được thông tin cập nhật về sự kiện không theo thứ tự và phải theo dõi dấu thời gian của sự kiện quét để biết thứ tự đúng.
• Xóa tài khoản trong FedEx Developer Portal:
  • Người dùng/Khách hàng không thể xóa tài khoản:
    1. Nếu tài khoản đó liên kết với bất kỳ Advanced Integrated Visibility nào đang hoạt động.
       
    2. Nếu tài khoản đó đang được sử dụng hoặc liên kết với một dự án, và
    3. Nếu đó là tài khoản duy nhất trong một dự án/Advanced Integrated Visibility.
       
       Lưu ý: Người dùng/Khách hàng cần loại bỏ tài khoản khỏi dự án/Advanced Integrated Visibility trước khi xóa khỏi tổ chức.
  • Người dùng/khách hàng có thể xóa tài khoản với điều kiện:
    1. Tài khoản phải thuộc về cùng một tổ chức.
    2. Người dùng/Khách hàng phải là quản trị viên thì mới xóa được tài khoản khỏi tổ chức.

Hạn chế chung

• Có thể sử dụng Webhook cho tất cả lô hàng của khách hàng gắn với số tài khoản FedEx 9 chữ số của các công ty kinh doanh – FedEx Express®, FedEx Ground® và FedEx Ground® Economy (trước đây là FedEx SmartPost®) bất kể nơi nhận hàng hoặc nơi gửi hàng (nhập, xuất, quốc tế, nội địa, v.v.).
• Webhook Advanced Integrated Visibility chỉ hỗ trợ tài khoản gửi kiện hàng/tài khoản doanh nghiệp gồm 9 chữ số. Tài khoản doanh nghiệp cho phép tạo lô hàng liên kết với tất cả các công ty kinh doanh thuộc tập đoàn FedEx, bao gồm cả FedEx Express và FedEx Ground.


Lưu ý: Không hỗ trợ các tài khoản 9 chữ số chỉ vận chuyển hàng nặng LTL. Nếu muốn thêm tài khoản vận chuyển hàng nặng LTL, bạn phải liên hệ với bộ phận hỗ trợ khách hàng để chuyển tài khoản LTL sang tài khoản doanh nghiệp.
• Khách hàng phải quản lý thứ tự các sự kiện theo dõi lô hàng mà họ nhận được.
• Thông báo tự động qua email được gửi bất cứ khi nào có hoạt động (Đã lưu/Không thành công/Tạo/Cập nhật/Hủy/Xóa) trên webhook Advanced Integrated Visibility đã đăng ký nhận thông tin.
• Bản dịch:
  • Nội dung dịch phần tải theo dõi hỗ trợ 41 ngôn ngữ.(Sắp ra mắt)
    Nhấp vào đây để xem danh sách ngôn ngữ được hỗ trợ.
  • Hiện tại, tính năng dịch phần tải theo dõi hỗ trợ tiếng Anh (Mỹ).
  • Bản dịch thông báo qua email chỉ có bằng ngôn ngữ được hỗ trợ trong khu vực Hoa Kỳ. (Ngôn ngữ: en-US, es-US)

Các vai trò người dùng trong FedEx Developer Portal:

Trong FedEx Developer Portal, bạn có thể thực hiện các chức năng cụ thể dựa trên vai trò được đặt cấu hình.
Để tìm hiểu thêm về FedEx Developer Portal, hãy tham khảo Hướng dẫn quản trị tổ chức.

MAC/HMAC là gì và được dùng như thế nào trong quy trình xác thực?

Mã xác thực thông báo (MAC) là cách thức kiểm tra tính toàn vẹn của thông tin được truyền qua hoặc lưu trữ trong phương tiện không tin cậy, dựa trên một khóa bí mật. Thông thường, MAC được dùng giữa hai bên có chung một khóa bí mật để xác thực thông tin truyền giữa hai bên này.

Cơ chế của MAC dựa trên hàm băm mật mã được gọi là HMAC. Có thể dùng HMAC với mọi hàm băm mật mã (ví dụ: SHA256) cùng với khóa bí mật dùng chung. HMAC được nêu cụ thể trong RFC 2104. Webhook Advanced Integrated Visibility của FedEx sẽ sử dụng HMAC SHA256.

SHA256 (mã thông báo bảo mật + phần tải) = fdx-signature được mã hóa Base 64 thành một phần của tiêu đề phần tải

Tính toán độ trễ

Thời gian tạo sự kiện biểu thị thời điểm một sự kiện thực tế diễn ra trong mạng lưới.
Cho đến khi sự kiện được ghi lại vào hệ thống (thể hiện bằng Dấu thời gian tạo tin nhắn), cả webhook hay bất kỳ hệ thống nào khác đều không thể xử lý hoặc gửi sự kiện đó.

Đề xuất

Khách hàng nên sử dụng Dấu thời gian tạo tin nhắn để đo độ trễ, vì thông tin này thể hiện rõ nhất thời điểm sự kiện khả dụng cho các hệ thống kỹ thuật số. Dấu thời gian này gần như trùng khớp với thời điểm cập nhật kỹ thuật số của FedEx và thường nhanh hơn hoặc gần như trùng khớp với nội dung cập nhật hiển thị trên fedex.com.

Quy tắc xác thực: 

• Tên webhook Advanced Integrated Visibility phải là duy nhất.
• URL đích của webhook Advanced Integrated Visibility phải ở định dạng Cú pháp chuẩn hóa.
• Tất cả các trường bắt buộc cho việc tạo webhook Advanced Integrated Visibility không được để trống.
• Ít nhất một số tài khoản vận chuyển FedEx hiện có phải được liên kết để tạo webhook Advanced Integrated Visibility.
• Đối với tác vụ xác thực Thành công:
  • Khi webhook Advanced Integrated Visibility được tạo thành công, khách hàng sẽ nhận được thông báo xác nhận.

    Mẫu thông báo xác nhận: Đã tạo thành công <<Tên webhook Advanced Integrated Visibility>>. Các thay đổi có thể mất tối đa 10 phút mới có hiệu lực.

• Đối với tác vụ xác thực Không thành công/Thất bại:
  • Nếu FedEx nhận được phản hồi không phải là 200 (OK) hoặc 202 (Đã chấp nhận), thì tác vụ xác thực URL đích của webhook Advanced Integrated Visibility sẽ được coi là thất bại.

• Không thể sử dụng một số tài khoản vận chuyển trong nhiều Advanced Integrated Visibility.
• URL đích/điểm cuối do khách hàng tạo phải:
  
  • Là máy chủ HTTPS.
    
  • Phản hồi các yêu cầu POST và phân tích phần tải JSON.
  • Giới hạn là 200 ký tự
  • URL của bạn sẽ bị chặn nếu bao gồm:
    • Không gian IP RFC1918
    • fedex.com hoặc miền phụ tương ứng
    • Địa chỉ IP trong URL này (kể cả localhost 127.0.0.1)

• Bảo mật Advanced Integrated Visibility: Chỉ hỗ trợ các kết nối HTTPS sử dụng phiên bản giao thức TLS (SSL) 1.2 trở lên có cấu hình bao gồm một chứng chỉ của cơ quan phát hành chứng chỉ (CA) hợp lệ. Hãy đưa các địa chỉ IP dưới đây vào danh sách cho phép để nhận thông tin cập nhật từ máy chủ FedEx mà không bị gián đoạn:
  

  Sản xuất
  Khách hàng có thể đưa vào danh sách cho phép: "nat.fxconnect.eastus2.heap-prod.fedex.io"
  Bằng cách sử dụng CIDR "20.65.16.22/31"

• Đôi khi, khách hàng có thể nhận được thông tin cập nhật về sự kiện không theo thứ tự và phải theo dõi dấu thời gian của sự kiện quét để biết thứ tự đúng.
• Xóa tài khoản trong FedEx Developer Portal:
  • Người dùng/Khách hàng không thể xóa tài khoản:
    1. Nếu tài khoản đó liên kết với bất kỳ Advanced Integrated Visibility nào đang hoạt động.
       
    2. Nếu tài khoản đó đang được sử dụng hoặc liên kết với một dự án, và
    3. Nếu đó là tài khoản duy nhất trong một dự án/Advanced Integrated Visibility.
       
       Lưu ý: Người dùng/Khách hàng cần loại bỏ tài khoản khỏi dự án/Advanced Integrated Visibility trước khi xóa khỏi tổ chức.
  • Người dùng/khách hàng có thể xóa tài khoản với điều kiện:
    1. Tài khoản phải thuộc về cùng một tổ chức.
    2. Người dùng/Khách hàng phải là quản trị viên thì mới xóa được tài khoản khỏi tổ chức.