Hướng dẫn › Vận chuyển
Kết nối Giao Hàng Nhanh (GHN)
Dán Token API từ tài khoản GHN của shop để KhoLive gửi đơn, xem phí, in nhãn và theo dõi trạng thái giao. Tiền COD GHN trả thẳng cho shop.
Để làm gì
Nối tài khoản GHN của chính shop vào KhoLive. Sau đó:
- bấm Tạo vận đơn là đơn được gửi sang GHN, có mã vận đơn và phí thật theo hợp đồng của shop;
- in nhãn A5 / 80×80 / 52×70 ngay trong KhoLive;
- trạng thái giao (đang giao, giao thành công, hoàn…) tự cập nhật về đơn.
KhoLive không giữ tiền. Tiền thu hộ (COD) GHN trả thẳng về tài khoản ngân hàng shop đã khai với GHN.
Bạn cần chuẩn bị
- Tài khoản GHN của shop (đăng ký ở khachhang.ghn.vn nếu chưa có).
- Điện thoại nhận được OTP của số đã đăng ký GHN.
- Tài khoản KhoLive là chủ shop (nhân viên không nối được).
Bước 1: Lấy Token API trên GHN
- Đăng nhập khachhang.ghn.vn bằng tài khoản GHN của shop.
- Vào Tài khoản → Bảo mật → Token API & IP tin cậy.
- Bấm xem Token, nhập OTP GHN gửi về điện thoại.
- Bấm sao chép Token.
Token giống như chìa khoá tài khoản GHN. Không gửi Token cho ai qua Zalo / Facebook. Chỉ dán vào KhoLive.
Bước 2: Dán Token vào KhoLive
- Mở Cài đặt → Hãng vận chuyển. Ở thẻ Giao Hàng Nhanh bấm Nối GHN (đã nối rồi thì bấm Sửa).
- Chọn Môi trường: Thật (giao hàng thật).
- Dán Token vào ô Token API.
- Bấm Kiểm tra token → lấy cửa hàng. Đúng Token thì máy báo "✓ Token đúng" và hiện danh sách cửa hàng GHN của shop.
Bước 3: Địa chỉ lấy hàng và mặc định
- Địa chỉ lấy hàng (số 1): nên điền đủ Tỉnh / Huyện / Xã. Để trống thì GHN dùng địa chỉ cửa hàng khai trên GHN. Nhưng nếu địa chỉ đó ghi kiểu mới (không có Quận / Huyện), GHN có thể báo *"không chuyển đổi được địa chỉ gửi"* và không tạo được vận đơn.
- Lưu ý giao hàng: Cho xem hàng không cho thử / Cho thử hàng / Không cho xem hàng.
- Bên trả phí ship cho GHN: *Shop trả* (GHN trừ vào tiền COD) hoặc *Người nhận trả thêm cho shipper*.
- Cân nặng mỗi món (gram) và kích thước gói: dùng để GHN tính phí. Đơn 6 món × 200g = 1,2kg.
Xong: kiểm tra đã nối
Thẻ GHN hiện ● Đã nối, số cửa hàng và 4 số cuối của Token.

Nên vào Cài đặt chung chọn Giao Hàng Nhanh làm hãng mặc định. Xem bài Cài đặt vận chuyển.
Hay gặp
- "Token không đúng": sao chép lại Token (không thừa dấu cách). Bạn vừa đổi Token trên GHN thì Token cũ hết dùng được.
- Không có cửa hàng nào: tạo cửa hàng trên khachhang.ghn.vn trước.
- "Không đọc được địa chỉ lấy hàng" khi tạo vận đơn: điền Địa chỉ lấy hàng ở bước 3 rồi Lưu, sau đó tạo lại.
- Môi trường thử: chỉ dùng để thử. Đơn tạo ở môi trường thử không có shipper đến lấy.
- Ngắt kết nối: bấm Sửa → Ngắt kết nối GHN. Đơn đã tạo vẫn giữ mã vận đơn.

