Hãng vận chuyển GHN và GHTK

Mặc định BayHub dùng hãng mô phỏng. Khi máy chủ có khoá của GHN hoặc GHTK, đơn thật đi hãng đó được đặt vận đơn thật. Đơn thật là đơn do người tạo, do khoá API của thương hiệu gửi, hoặc đến từ website của thương hiệu. Đơn mô phỏng không bao giờ đi tới hãng thật, kể cả khi đã có khoá.

Tình trạng. Bộ kết nối được thử bằng máy chủ giả dựng đúng theo tài liệu chính thức của hãng. Chưa thử bằng tài khoản GHN hoặc GHTK thật của một khách. Trước khi chạy thật, bạn thử trên tài khoản staging của chính mình.

BayHub làm gì

• Lúc đóng gói: đặt vận đơn với hãng, in tem của hãng; mã vận đơn là mã của hãng.
• Trạng thái giao: hãng báo qua webhook hoặc BayHub quét lại mỗi 10 phút. Kiện giao xong được ghi lại; kiện giao không được trở thành kiện hoàn về kho, chờ nhận ở bàn hàng hoàn.
• Gỡ gói: huỷ vận đơn với hãng. Nếu việc đóng gói thất bại sau khi đã đặt vận đơn, BayHub huỷ vận đơn bỏ lại và thử lại cho tới khi hãng nhận.
• Hãng huỷ vận đơn khi kiện còn ở kho: đơn bị giữ lại và hiện trong mục Cần xử lý với nút đặt lại vận đơn.
• Trạng thái cần người xem: hàng thất lạc, hư hỏng hoặc có ngoại lệ do hãng báo hiện trong Cần xử lý.
• Bảng kê COD thật của hãng: BayHub chưa nhập tự động. Cho tới khi có, thương hiệu có kiện COD đi hãng thật bị chặn thanh toán trực tuyến cho tháng đó, và hoá đơn ghi rõ lý do.

Địa chỉ

Từ 1/7/2025 địa chỉ chỉ còn hai cấp (phường/xã, tỉnh/thành) và cả hai hãng cần phường/xã. Đơn thật thiếu phường/xã bị từ chối ở bàn đóng gói, kèm lời nhắn sửa địa chỉ. Địa chỉ sửa được tới lúc đóng gói.

Bạn cần chuẩn bị

Việc đặt các giá trị này vào môi trường máy chủ do bên triển khai làm cùng bạn. Hãng không ký webhook, nên BayHub xác thực bằng khoá bí mật do bạn và hãng cùng giữ.

Chưa có

J&T, Viettel Post và SPX hiện là hãng mô phỏng trong BayHub: bàn giao, giao hàng và bảng kê COD chạy được, nhưng chưa nối với hãng thật.