Vận chuyển

Webhook hãng vận chuyển

URL webhook shop cần khai trong trang quản trị của hãng (chỉ khi tự cấu hình)

Hubport nhận cập nhật trạng thái vận đơn từ hãng qua webhook để vận đơn và đơn bán được cập nhật ngay, không phải chờ đồng bộ định kỳ. Trong đa số trường hợp shop không cần cấu hình gì. Shop chỉ phải tự khai webhook trên trang quản trị của hãng trong các trường hợp dưới đây.

GHN (kết nối bằng token)

Áp dụng khi carrier GHN dùng connect_mode = token (shop tự dán token). Kết nối bằng OTP không cần cấu hình.

  1. Đặt một chuỗi bí mật bất kỳ vào trường webhook_token của carrier (Cập nhật hãng vận chuyển).
  2. Trên trang quản trị GHN, mục cấu hình Webhook cho đơn hàng:
    • URL: https://api.hubport.vn/v1/shippingcarrierwebhooks/ghn
    • Thêm Custom header X-Hubport-Webhook-Token với đúng giá trị webhook_token ở bước 1.

ViettelPost (tài khoản Partner riêng của shop)

Chỉ áp dụng khi shop tự cấu hình webhook trên tài khoản Partner ViettelPost của chính mình. Kết nối thông thường qua Hubport để trống webhook_token và không cần cấu hình.

  1. Đặt chuỗi bí mật vào trường webhook_token của carrier ViettelPost.
  2. Trên tài khoản Partner ViettelPost, khai URL webhook https://api.hubport.vn/v1/shippingcarrierwebhooks/viettelpost với TOKEN trùng giá trị webhook_token.

Bản cài đặt riêng

Shop dùng bản cài đặt riêng (dedicated) thay https://api.hubport.vn bằng domain API của mình.

Lưu ý

Giữ bí mật webhook_token. Webhook gửi sai token bị từ chối. Các hãng khác (GHTK, J&T Express, Ahamove, BeDelivery) được cập nhật trạng thái bằng đồng bộ định kỳ.

On this page