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

Bản miễn phí cũ đã ngừng hỗ trợ, chỉ chạy PHP 7.x; tài liệu này dành cho bản Pro (PHP 7.2 – 8.x). Bản Pro dùng cùng thư mục plugin với bản cũ nên cài đè được. Cách cài đè xem ở bài cài đặt.

WooCommerce 5.6 trở lên (plugin đã kiểm tới WooCommerce 10.9.4), PHP 7.2 – 8.x và ionCube Loader đã bật. Plugin hỗ trợ HPOS (màn hình đơn hàng mới của WooCommerce). Thiếu ionCube thì plugin chỉ hiện thông báo lỗi và không có trang cấu hình — xem bài cài đặt.

License chưa kích hoạt hoặc đang không hợp lệ. Dán mã vào tab License rồi bấm Active License. Các tab còn lại (Cài đặt chung, Cập nhật trạng thái tự động) vẫn mở được bình thường.

Không nên. Mỗi dòng trong đó là một thiết lập WooCommerce mà thiếu nó thì GHN không tính được cước: khối lượng sản phẩm, đơn vị gram và cm, địa chỉ cửa hàng. Xem bài cài đặt. Nút Đã xong chỉ ẩn thông báo, không sửa gì cả.

Theo giao diện khachhang.ghn.vn tháng 10/2026: đăng nhập khachhang.ghn.vn, bấm tên tài khoản → Thông tin tài khoản → tab Bảo mật → Token API & IP tin cậy → Quản lý. Ô Token API đang ẩn, bấm biểu tượng con mắt để xem (tài liệu GHN nói sẽ hỏi OTP). Cách thứ hai theo tài liệu GHN: Developer Portal → Quản lý token. Chi tiết ở Kết nối API.

Token Key sai, chưa bấm Lưu thay đổi, hoặc đang chọn nhầm môi trường so với token đang dùng. Token của Product và Test là hai tài khoản khác nhau. Xem Kết nối API.

Khi danh sách IP được phép sử dụng có từ một IP trở lên, GHN chỉ nhận yêu cầu từ các IP trong danh sách. Thêm IP máy chủ đang chạy website vào đó (hỏi hosting nếu chưa biết), hoặc xoá hết để mọi IP đều gọi được.

Trên khachhang.ghn.vn. Tab Cửa hàng/Kho của plugin chỉ đồng bộ và hiển thị kho; sửa xong trên GHN thì bấm Đồng bộ kho hàng từ GHN để website nhận thay đổi.

Được, đó là cách thiết kế. Các plugin vận chuyển DevVN dùng chung một module trang thanh toán: bản nạp trước chạy, các bản sau tự nhường. Bạn khai cấu hình trang thanh toán một lần là đủ.

Kiểm theo đúng thứ tự này:

1. License có đang hợp lệ không — license lỗi thì phí GHN biến mất hẳn, không còn cả dòng "báo sau". Xem câu hỏi ngay dưới.
2. Sản phẩm trong giỏ đã khai khối lượng chưa — đây là nguyên nhân hay gặp.
3. Đơn vị khối lượng có phải gram, kích thước có phải cm không.
4. Ô Kích hoạt ở WooCommerce → Cài đặt → Vận chuyển → Giao hàng nhanh (GHN) có đang bật không. GHN không cần thêm vào khu vực giao hàng, phí tự hiện.
5. Đã bấm Đồng bộ kho hàng từ GHN ở tab Cửa hàng/Kho và có kho chưa.
6. Khách đã chọn đủ địa chỉ chưa: Tỉnh + Phường/Xã với địa chỉ 2 cấp, Tỉnh + Quận/Huyện với địa chỉ 3 cấp (thêm Phường/Xã nếu bật Có hàng nặng?).

Nguyên nhân thường gặp: license bị lỗi hoặc không xác thực được. Khi đó plugin ngừng tính phí, phương thức GHN biến mất khỏi trang thanh toán (không còn cả dòng "Phí vận chuyển sẽ báo sau."), và mở tab Cài đặt GHN sẽ bị chuyển về tab License. Chuyện này có thể xảy ra cả khi mã vẫn đúng, nếu đúng lúc plugin kiểm tra định kỳ mà hosting không kết nối được tới máy chủ bản quyền.

Cách xử lý: vào tab License, bấm Active License để kích hoạt lại. Vẫn không được thì liên hệ hỗ trợ qua Zalo 0965 419 096 kèm tên miền website.

GHN không trả được giá cho tuyến đó, nên plugin hiện dòng dự phòng giá 0đ để khách vẫn đặt được hàng (dòng này tự ẩn nếu website còn phương thức vận chuyển khác). Thường vì sản phẩm thiếu khối lượng, địa chỉ nhận chưa đủ, kho gửi chưa được kích hoạt, hoặc tài khoản GHN đang giới hạn IP. Cần xem GHN trả lời gì thì bật Debug ở tab Cài đặt GHN, làm lại thao tác, đọc ghn_log.txt, rồi tắt Debug và lưu lại ngay để file bị xoá — file đó chứa Token Key.

Ô Có hàng nặng? không lọc gói cước, nên tích hay không không quyết định chuyện này. Kiểm khối lượng và kích thước sản phẩm có khai đúng không (theo tài liệu GHN: tối đa 50 kg, mỗi chiều tối đa 200 cm). Ở địa chỉ 3 cấp mà đang bật Có hàng nặng? thì khách phải chọn cả Phường/Xã mới thấy phí. Muốn khách thấy cả gói Hàng nặng lẫn Hàng nhẹ thì đổi Loại phí ship sang "Hiện cả 2 dịch vụ hàng nặng - hàng nhẹ".

Phí plugin hiện là số GHN trả về cho đúng tuyến, khối lượng và kích thước đó. Hay gặp ba lý do: khai giá (đơn COD tự khai giá theo tiền hàng; theo ghn.vn tháng 10/2026, trên 1.000.000đ thì thu 0,5% giá trị khai báo — bật Khai giá hàng hoá thì đơn chuyển khoản cũng bị tính), khối lượng quy đổi theo kích thước lớn hơn cân nặng thật (GHN tính theo số lớn hơn), và giá riêng theo hợp đồng của bạn với GHN.

Đang để Loại phí ship là "Hiện dịch vụ rẻ tiền nhất". Đổi sang "Hiện cả 2 dịch vụ hàng nặng - hàng nhẹ" ở tab Cài đặt GHN.

Ô Tiêu đề đó không hiện ra cho khách. Khách thấy tên gói GHN trả về như Hàng nhẹ, Hàng nặng. Muốn đổi tên thì dùng filter ghn_service_name, ví dụ ở bài Hook.

Không. Ô đó dành cho hãng khác, với GHN bật hay tắt đều như nhau: khách đã chọn Phường/Xã thì plugin luôn gửi Phường/Xã sang GHN, đổi Phường/Xã là phí được tính lại.

Ô đang bị ẩn. Mở Tuỳ chọn hiển thị ở góc trên bên phải trang sửa đơn và tích lại. Nút Tạo vận đơn GHN cũng có ngay trong danh sách đơn (giao diện danh sách kiểu mới, mặc định bật).

License không hợp lệ. Vào tab License bấm Active License lại; không được thì nhắn hỗ trợ kèm tên miền.

Sản phẩm chưa khai khối lượng, hoặc đơn vị không phải gram. Điền tay ô Khối lượng trong hộp thoại cho đơn này, rồi khai cân nặng cho sản phẩm để lần sau khỏi phải sửa. Đơn do addon đăng tự động thì dùng Khối lượng mặc định ở tab addon khi sản phẩm thiếu cân nặng.

Vận đơn để Người nhận trả phí nhưng Tiền thu hộ (COD) vẫn là tổng đơn đã gồm phí ship. Hộp thoại không tự trừ phí ship khi đổi người thanh toán — chọn Người nhận thì phải sửa Tiền thu hộ thành tổng đơn trừ phí ship. Xem bài tạo vận đơn.

Phiếu in hiện ngay trong hộp nhỏ trên trang (không mở cửa sổ mới), sau khi bạn chọn một khổ: A5, 52 x 70 mm hoặc 80 x 80 mm. Hộp trống hoặc báo lỗi thường do vận đơn đã bị huỷ bên GHN, hoặc môi trường đang chọn (Product/Test) khác với lúc tạo vận đơn.

GHN chỉ cho huỷ khi trạng thái vận đơn còn cho phép, thường là trước khi shipper lấy hàng. Đã lấy rồi thì phải liên hệ trực tiếp GHN.

Addon chưa cài hoặc chưa kích hoạt, hoặc plugin GHN Pro đang tắt. Thấy tab mà không có ô cài đặt nào thì chưa kích hoạt mã bản quyền riêng của addon — nhập mã ngay ở tab đó.

Kiểm: đã tích Kích hoạt chưa (mặc định tắt), mốc Tự động khi nào? có khớp trạng thái thật của đơn không (mặc định là Khi đơn chuyển sang Hoàn thành), đơn đã có mã vận đơn chưa. Addon ghi kết quả và câu báo lỗi ngay trong ô GHN của đơn — đọc ở đó trước. Gặp "Không tìm thấy kho" thì xem bài đăng đơn tự động.

Webhook chưa được khai. Ở tab Cập nhật trạng thái tự động, bấm Lưu thay đổi rồi chép Webhook URL. Theo tài liệu GHN tháng 10/2026, dán đường dẫn vào mục Cấu hình webhook (tab Order) trên Developer Portal của GHN, khoảng 15 phút có hiệu lực; nếu tài khoản chưa thấy mục này thì gửi đường dẫn cho GHN qua CSKH để được khai giúp.

Bình thường. Webhook chỉ đổi trạng thái đơn khi vận đơn bị huỷ (sang Đã huỷ) hoặc giao thành công (sang Hoàn thành). Các bước khác hiện ở dòng Trạng thái trong ô GHN của đơn.

Bạn vừa làm mới Webhook URL mà chưa khai lại với GHN, hoặc website vừa đổi tên miền. Bấm Làm mới Webhook URL, Lưu thay đổi, rồi khai đường dẫn mới với GHN.

Người thanh toán phí ship ở tab addon đang để Người nhận. Đổi sang Người gửi.

Chưa chọn trang đó ở ô Tracking trong tab Cài đặt GHN — plugin chỉ bật shortcode khi đã chọn trang. Chọn đúng trang, lưu, rồi lưu lại permalink. Xem bài email và tra cứu.

Chưa lưu lại permalink sau khi chọn trang tracking. Vào Cài đặt → Đường dẫn tĩnh bấm Lưu thay đổi một lần.

Email báo mã mặc định tắt — kiểm ô Kích hoạt trong khối Email thông báo đã chọn Có chưa. Sau đó kiểm Spam, rồi cài một plugin SMTP và gửi thư qua tài khoản mail của chính tên miền.

Chưa chọn trang ở ô Tracking, hoặc trang đó chưa có shortcode [ghn_tracking].

ID đơn hoặc email không khớp — form tra cứu không hiện thông báo lỗi mà chỉ hiện lại. Khách phải nhập đúng email đã dùng khi đặt, hoặc bấm liên kết tra cứu trong email (không cần nhập email). Khách có tài khoản thì xem hành trình ngay trong Tài khoản → Đơn hàng.