Hướng dẫn từng bước
Đơn vị vận chuyển: kết nối hãng để tạo vận đơn từ đơn hàng
Kết nối đơn vị vận chuyển để cơ sở tạo vận đơn ngay từ đơn hàng. Bài này chỉ nói về màn kết nối trong Cài đặt; cách tạo vận đơn ở bài Vận chuyển.
Khi nào dùng
- Bắt đầu bán online và cần gửi hàng qua hãng.
- Đổi kho lấy hàng hoặc số điện thoại lấy hàng.
- Thay token khi hãng cấp lại token mới.
- Muốn chuyển GHN từ chạy thử sang chạy thật (chỉ chủ shop).
Các bước
Vào Cài đặt → Đơn vị vận chuyển. Dòng phụ đề cho biết số hãng đã kết nối (ví dụ 2 / 3 đơn vị đã kết nối). Hãng chưa kết nối hiện Chưa kết nối kèm nút Kết nối; hãng đã kết nối hiện thông tin và nút Sửa.

Kết nối Giao Hàng Nhanh
Bấm Kết nối ở dòng Giao Hàng Nhanh. Trong hộp Kết nối tài khoản GHN, dán API Token GHN (lần đầu bắt buộc; sau đó để trống là giữ token cũ), nhập Shop ID và chọn Kho lấy hàng (tỉnh, quận, phường nơi GHN đến lấy hàng, dùng để tính phí và tạo vận đơn). Bấm Lưu.
Kết nối Giao Hàng Tiết Kiệm
Bấm Kết nối ở dòng Giao Hàng Tiết Kiệm, hộp Kết nối tài khoản GHTK. Dán API Token GHTK (lấy trong tài khoản GHTK của cửa hàng ở mục API/Tích hợp), rồi điền Tên người lấy hàng, Địa chỉ chi tiết, Tỉnh/thành, Quận/huyện, SĐT lấy hàng và Phường/xã (tuỳ chọn). Bấm Lưu: hệ thống gọi thử GHTK để kiểm tra địa chỉ lấy hàng rồi mới lưu.
Kết nối Viettel Post
Bấm Kết nối ở dòng Viettel Post, hộp Kết nối tài khoản Viettel Post. Dán token từ viettelpost.vn, điền Tên người gửi, Địa chỉ người gửi, Số điện thoại người gửi, cùng Mã Tỉnh/Thành, Mã Quận/Huyện, Mã Phường/Xã. Đây là mã trong hệ thống Viettel Post, không phải tên. Bấm Lưu.
Chạy thật cho GHN (chỉ chủ shop)
Hãng GHN mới kết nối luôn ở chế độ thử, dòng trạng thái hiện Chạy thử và câu Đang chạy thử: đơn đẩy sang GHN chỉ là giả lập. Bấm Chuyển sang chạy thật, đọc hộp Bật GHN thật? rồi bấm Bật chế độ thật. Muốn quay lại thử, bấm Chuyển về chạy thử (không cần xác nhận).
Quyền, chạy thử và giới hạn
| Việc | Ai làm được |
|---|---|
| Kết nối, sửa token, sửa kho lấy hàng | Người có quyền sửa cài đặt: Chủ shop (và Quản trị viên cũ) |
| Bật chế độ GHN thật | Chỉ chủ shop. Người khác chỉ thấy dòng Chỉ chủ cửa hàng mới chuyển sang chạy thật. |
- Người không có quyền sửa thấy dòng Chỉ quản trị viên mới cấu hình được đơn vị vận chuyển. và không có nút.
- Chế độ chạy thử/chạy thật chỉ có ở GHN. GHTK và Viettel Post không có, kết nối xong là chạy thật.
- Muốn chạy thật, GHN phải có token đã lưu, nếu chưa màn hiện Lưu API Token GHN trước khi chạy thật.
- Token được mã hoá khi lưu và không bao giờ hiển thị lại.
- Viettel Post: kết nối lưu được, nhưng tạo vận đơn và báo cước Viettel Post từ đơn hàng chưa mở. Ô Đơn vị giao trên đơn chỉ có GHN, GHTK và Tự giao.
- Quyền tạo vận đơn ở trang đơn hàng (GHN: chủ shop, quản lý, kho/giao vận; GHTK: chỉ chủ shop và cần bật tính năng cho cơ sở) xem ở bài Vận chuyển.
Lỗi thường gặp
| Thông báo | Nguyên nhân | Cách xử lý |
|---|---|---|
| Cần nhập API Token GHN khi cấu hình lần đầu. (tương tự GHTK, VTP) | Lần đầu mà để trống token | Dán token của hãng |
| Shop ID bắt buộc. | Bỏ trống Shop ID của GHN | Nhập Shop ID lấy từ GHN |
| Token GHTK không hợp lệ — kiểm tra lại token. | Token GHTK sai hoặc hết hạn | Lấy lại token ở tài khoản GHTK |
| GHTK không nhận địa chỉ lấy hàng — kiểm tra tên tỉnh/huyện. | Tên tỉnh hoặc huyện không khớp | Sửa cho đúng tên hành chính |
| Không kết nối được tới GHTK để kiểm tra địa chỉ — thử lại. | Mất kết nối khi gọi thử | Bấm Lưu lại sau |
| Cần nhập API Token GHN trước khi bật chế độ thật. | Bật chạy thật khi chưa lưu token | Lưu token trước |
| Chỉ chủ cửa hàng (owner) mới được bật/tắt chế độ GHN thật. | Không phải chủ shop | Nhờ chủ shop |
| Bạn không có quyền cấu hình đơn vị vận chuyển. | Vai trò không có quyền sửa cài đặt | Nhờ chủ shop |
Xem thêm
Câu hỏi thường gặp
Chạy thử khác chạy thật thế nào?
Chỉ Giao Hàng Nhanh có chế độ này. Ở chế độ chạy thử, đơn đẩy sang GHN chỉ là giả lập. Chuyển sang chạy thật thì mỗi vận đơn là vận đơn thật và phát sinh cước thật. Chỉ chủ shop bật được.
GHTK và Viettel Post có chế độ chạy thử không?
Không. Cấu hình xong là chạy thật ngay.
Kết nối Viettel Post rồi có tạo vận đơn được không?
Chưa. Màn này lưu được kết nối Viettel Post, nhưng tạo vận đơn và báo cước Viettel Post từ đơn hàng chưa mở.
Ai kết nối được đơn vị vận chuyển?
Người có quyền sửa cài đặt: Chủ shop (và Quản trị viên cũ). Quản lý, Kho/Giao vận không vào được màn Cài đặt này.
Cập nhật 30/09/2026