Giải đáp thắc mắc

Bạn không phải thêm GHTK vào khu vực giao hàng — phí tự hiện. Kiểm theo thứ tự này:

1. Token Key đã nhập đúng và lưu chưa, có đang bật nhầm Sandbox không.
2. Địa chỉ kho lấy hàng đã khai đủ tỉnh, quận chưa.
3. Sản phẩm trong giỏ đã khai cân nặng chưa.
4. Ô Kích hoạt ở WooCommerce → Cài đặt → Vận chuyển → Giao hàng tiết kiệm (GHTK) có bị tắt không — mặc định là bật, xem Phí vận chuyển GHTK.

Nghĩa là plugin gọi sang GHTK nhưng không nhận được giá. Khách vẫn đặt hàng được, bạn báo phí sau. Để biết nguyên nhân, bật Debug ở tab Cài đặt GHTK rồi xem WooCommerce → Trạng thái → Nhật ký, GHTK sẽ nói rõ lý do trong đó.

Khách đang nhận phí từ một phương thức Đồng giá nằm trong khu vực giao hàng, chứ không phải từ GHTK. Vào WooCommerce → Cài đặt → Vận chuyển → Khu vực giao hàng, mở khu vực đang áp dụng rồi xoá hoặc tắt phương thức Đồng giá đó đi.

Dùng phương thức Giao hàng miễn phí có sẵn của WooCommerce, đặt điều kiện giá trị đơn tối thiểu. Rồi bật Ẩn phương thức khi có free-shipping ở tab Cài đặt chung để các dòng GHTK tự ẩn đi khi khách đủ điều kiện.

Đường bay chỉ hiện khi kho và khách khác tỉnh. Cùng tỉnh thì plugin tự ẩn đi vì gửi máy bay trong cùng tỉnh không có ý nghĩa.

Bộ dữ liệu tỉnh/huyện/xã của website đang lệch với bộ GHTK dùng. Vào tab Cài đặt chung → Công cụ, chọn đúng phiên bản Đơn vị hành chính rồi bấm Cập nhật database. Nhớ sao lưu cơ sở dữ liệu trước.

Cũng có thể do ô Tên thôn/ấp/xóm/tổ trong hộp thoại bị xoá trắng — GHTK bắt buộc phải có địa chỉ cấp 4, không biết thì để chữ Khác.

Thường là lỗi JavaScript do giao diện hoặc một plugin khác gây ra. Mở Console của trình duyệt (phím F12) xem báo lỗi gì; hoặc tạm tắt lần lượt các plugin khác để tìm thủ phạm.

Hai chỗ quyết định con số này: lựa chọn Phí ship — Khách trả / Shop trả, và ô tích Khách đã chuyển khoản thì thu hộ = 0. Với đơn thanh toán online plugin tự đặt thu hộ về 0. Bạn vẫn sửa tay được trước khi bấm Đăng ngay.

Khi shipper đã lấy hàng thì GHTK không cho huỷ qua kết nối tự động nữa. Gọi tổng đài GHTK hoặc nhắn nhân viên phụ trách shop để xử lý.

Bật Sandbox trong tab Cài đặt GHTK và thay bằng token của tài khoản thử nghiệm đăng ký tại khachhang-staging.ghtklab.com. Token thật và token sandbox là hai token khác nhau. Tập xong nhớ tắt Sandbox và trả lại token thật.

Nếu chưa đăng ký webhook thì trạng thái không tự về, phải bấm Check đơn hàng trong từng đơn. Đăng ký webhook một lần là xong chuyện này mãi mãi.

Đã đăng ký rồi mà vẫn không cập nhật thì kiểm tra: website có chạy trên tên miền công khai không, và tường lửa hay Cloudflare có chặn admin-ajax.php không.

Bạn không tự bật được, phải nhờ GHTK. Chép đường dẫn trong khối Webhook ở tab Cài đặt GHTK (nhớ bấm Lưu thay đổi trước), rồi dùng chính email đã đăng ký tài khoản GHTK gửi tới b2c@ghtk.vn kèm mã SHOP. Chi tiết ở bài Webhook và đồng bộ trạng thái.

Xem lại bảng Cài đặt trạng thái đơn hàng ở tab Cài đặt GHTK. Dòng nào không muốn ảnh hưởng tới đơn thì chọn Không đồng bộ trạng thái.

Máy chủ chưa bật ionCube Loader — trên trang quản trị sẽ có một cảnh báo màu vàng nhắc điều này. Báo hosting bật giúp, đúng phiên bản PHP mà website đang chạy.

Plugin chưa được kích hoạt bản quyền. Nhập mã ở tab License, xem License và cập nhật.

Thử đổi Hình thức tải địa chỉ ở tab Cài đặt chung sang Tải bằng admin-ajax.php. Nguyên nhân hay gặp nhất là hosting chặn đọc file json trong thư mục plugin, hoặc bộ nhớ đệm đang giữ file json cũ.

Nếu vẫn không được, kiểm tra bộ dữ liệu đơn vị hành chính: vào Cài đặt chung → Công cụ, chọn đúng phiên bản rồi bấm Cập nhật database.

Vào tab Cài đặt chung → Công cụ, chọn bộ Đơn vị hành chính khớp với bộ GHTK đang dùng rồi bấm Cập nhật database. Lưu ý đơn hàng cũ lưu mã đơn vị theo bộ dữ liệu cũ nên có thể hiển thị khác đi — hãy sao lưu trước khi đổi.

Gần như luôn là do sitekey và secretkey không cùng một cặp, hoặc lẫn khoá v2 với v3. Vào trang quản trị reCAPTCHA lấy lại đúng cặp khoá, kiểm tra cả tên miền đã khai. Chưa xử lý ngay được thì tạm chọn KHÔNG kích hoạt để khách đặt hàng bình thường.

Trước hết kiểm tra website có gửi được email nói chung không — thử đặt lại mật khẩu tài khoản để xem. Không nhận được thì cần cài một plugin SMTP, đây là vấn đề của website chứ không riêng plugin này.

Cũng cần kiểm tra ô Kích hoạt trong khối email đã bật chưa, và khách có nhập email lúc đặt hàng không.

Sau khi chọn trang Tracking bạn phải vào Cài đặt → Đường dẫn tĩnh bấm Lưu thay đổi một lần. Đây là lỗi hay gặp nhất ở bước này.

Trình duyệt đang chặn cửa sổ bật lên — cho phép rồi thử lại. Nếu vẫn trắng thì mã vận đơn có thể đã bị huỷ bên GHTK, bấm Check đơn hàng để xem tình trạng thật.