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.
- Đặt một chuỗi bí mật bất kỳ vào trường
webhook_tokencủa carrier (Cập nhật hãng vận chuyển). - 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-Tokenvới đúng giá trịwebhook_tokenở bước 1.
- URL:
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.
- Đặt chuỗi bí mật vào trường
webhook_tokencủa carrier ViettelPost. - Trên tài khoản Partner ViettelPost, khai URL webhook
https://api.hubport.vn/v1/shippingcarrierwebhooks/viettelpostvớ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ỳ.