Kết nối tài khoản GHTK

Tab này bắt buộc. Nhập Token Key và mã SHOP để website nói chuyện được với GHTK, rồi khai địa chỉ kho lấy hàng. Xong hai việc này là website đã tính được phí ship và đẩy được đơn.

Bắt buộc Bước 3–4 / 10 Cập nhật 13.10.2026
Kết nối Giao Hàng Tiết Kiệm (GHTK) với WooCommerce trong 4 bước
Video bắt đầu ở 1:01, đúng phần nhập token và kho lấy hàng của trang này. Tua về 0:22 để xem cách tạo token trên GHTK.

Mở tab Cài đặt GHTK

Thanh tab của trang Cài đặt GHTK, tab Cài đặt GHTK được đánh số 1
Tab nằm giữa, giữa Cài đặt chung và License. Bấm vào ảnh để phóng to.
  1. Bấm tab Cài đặt GHTK. Chưa kích hoạt license thì bấm vào đây sẽ bị đẩy ngược sang tab License.

Thông tin cửa hàng

Khối Cài đặt thông tin cửa hàng với sáu chấm số: Token Key, Mã SHOP, Sandbox, BBS, Debug, Tracking
Khối thông tin cửa hàng. Token và mã shop trong ảnh là dữ liệu mẫu.
  1. Ô Token Key giữ mã để website gọi sang GHTK. Tạo token trong tài khoản GHTK ở mục Thông tin tài khoản → Cấu hình API, bấm + Token, tick đủ 5 quyền Tính phí, Tạo đơn hàng, Trạng thái đơn hàng, Huỷ đơn hàng, In nhãn đơn hàng. Token có ngày hết hạn, tới hạn thì tạo token mới và dán lại vào đây. Token sai hoặc hết hạn thì website không tính được phí, không đăng được đơn.
  2. Ô Mã SHOP là mã cửa hàng của bạn trên GHTK, dạng S611269. Đăng nhập GHTK sẽ thấy ngay chỗ dòng chào “Xin chào! …”. Mã này dùng để tra cứu vận đơn.
  3. Ô Sandbox là chế độ chạy thử. Bật lên thì đơn gửi đi không được xử lý thật, dùng khi bạn muốn tập đăng đơn. Token của sandbox khác token thật, đăng ký riêng tại khachhang-staging.ghtklab.com. Bán hàng thật thì phải tắt.
  4. Bật ô BBS (Hàng nặng) nếu bạn bán hàng cồng kềnh. Đơn từ 20kg trở lên sẽ được tính theo bảng giá hàng nặng của GHTK thay vì bảng giá thường.
  5. Ô Debug ghi lại toàn bộ nội dung trao đổi với GHTK vào WooCommerce → Trạng thái → Nhật ký. Chỉ bật khi đang tìm lỗi, xong thì tắt cho nhẹ máy chủ.
  6. Ở ô Tracking, chọn trang dùng làm trang tra cứu vận đơn. Cách tạo trang này xem bài Trang tra cứu vận đơn.
Token Key là mật khẩu, đừng đưa cho ai

Ai có token là tạo được vận đơn dưới tên cửa hàng bạn. Khi chụp màn hình gửi đi nhờ hỗ trợ, nhớ che ô Token Key lại. Lỡ lộ thì vào tài khoản GHTK tạo token mới rồi dán lại vào đây.

Địa chỉ lấy hàng

Đây là nơi shipper GHTK tới lấy hàng, đồng thời là điểm gốc để tính phí ship. Khai sai địa chỉ thì phí ship hiện cho khách cũng sai theo.

Khối Địa chỉ lấy hàng với các chấm số ở tên chủ shop, số điện thoại, tỉnh thành, địa chỉ, ô kho chính và nút thêm kho
Khai một kho hàng. Ảnh đã ẩn bớt bảng chọn tỉnh thành cho gọn.
  1. Ô Tên chủ SHOP (bắt buộc) là tên người shipper liên hệ khi tới lấy hàng.
  2. Ô Số điện thoại SHOP (bắt buộc) là số shipper sẽ gọi. Nên dùng số luôn có người nghe.
  3. Chọn lần lượt Tỉnh thành, Quận/huyện, Xã/Phường/thị trấn. Tỉnh và quận là bắt buộc.
  4. Ô Địa chỉ ghi số nhà, tổ, ngách, ngõ. Ví dụ: nhà số 5, tổ 3, ngách 11, ngõ 45. Chỉ ghi phần chi tiết, không lặp lại tên phường, quận, tỉnh ở đây.
  5. Ô Cửa hàng/kho chính đánh dấu kho mặc định dùng cho mọi đơn. Có nhiều kho thì chỉ một kho được đánh dấu là chính.
  6. Bấm Thêm cửa hàng/kho khi có kho thứ hai, thứ ba. Mỗi kho mới hiện ra một khối giống hệt khối này.

Khi bạn có nhiều kho

Dưới mỗi kho có bảng Khu vực bán hàng liệt kê các tỉnh thành. Chỉ dùng tới khi bạn có nhiều kho và muốn chia vùng: tích các tỉnh mà kho đó phụ trách, plugin sẽ tự chọn kho phụ trách tỉnh của khách để tính phí và lấy hàng. Chỉ có một kho thì bỏ trống toàn bộ.

Kho nào cũng phải có trong hợp đồng GHTK

GHTK chỉ nhận lấy hàng ở địa chỉ đã đăng ký với họ. Mở kho mới thì báo GHTK trước, rồi mới thêm vào đây, không thì đơn sẽ bị từ chối lúc đăng.

Kiểm tra đã đúng chưa

  1. Bấm Lưu thay đổi ở cuối trang.
  2. Mở một sản phẩm bất kỳ ở ngoài website, thêm vào giỏ rồi vào trang thanh toán.
  3. Chọn Tỉnh/Quận/Phường của một địa chỉ bất kỳ. Nếu phần vận chuyển hiện dòng GHTK kèm số tiền là token đã đúng.

Chưa thấy dòng GHTK nào thì thường là chưa bật phương thức vận chuyển. Xem bài Phí vận chuyển GHTK.

Lỗi thường gặp

Tình huốngNguyên nhân và cách xử lý
Không tính được phí ship, ô vận chuyển trốngToken sai, đã hết hạn, thiếu quyền Tính phí, hoặc còn đang bật Sandbox mà lại dùng token thật. Kiểm tra lại cả bốn.
Phí ship hiện ra cao bất thườngĐịa chỉ kho đang khai sai tỉnh/quận, GHTK tính như gửi liên tỉnh. Xem lại khối Địa chỉ lấy hàng.
Đăng đơn báo địa chỉ lấy hàng không hợp lệĐịa chỉ kho chưa được GHTK duyệt, hoặc ô Địa chỉ đang ghi lặp cả tên phường/quận. Ghi gọn lại phần số nhà thôi.
Lưu xong quay lại thì mất Token KeyThường do một plugin bảo mật chặn ký tự lạ khi lưu. Tạm tắt plugin bảo mật, lưu lại rồi bật lên.

Tab này còn ba khối nữa: Webhook và trạng thái đơn hàng, và In hoá đơn cùng email báo mã vận đơn. Trước mắt hãy sang Phí vận chuyển GHTK để khách thấy được phí ship.

Hỗ trợ Zalo