Tuỳ chọn vận đơn và phí ship
Năm ô nhỏ nằm trong tab Cài đặt GHN, nhưng chúng quyết định khách thấy mấy lựa chọn giao hàng, đơn nào được khai giá, và vận đơn gửi sang GHN ghi hàng hoá ra sao.
Năm tuỳ chọn
Vào WooCommerce → Cài đặt GHN, tab Cài đặt GHN, kéo xuống dưới ô Token Key.
- Debug — ghi lại mọi lần plugin gọi API GHN vào file
ghn_log.txttrong thư mục plugin. Chỉ bật khi đang tìm lỗi; đọc kỹ cảnh báo bên dưới trước khi bật. - Danh sách sp trong đơn hàng — bật thì vận đơn gửi kèm danh sách từng sản phẩm (tên, số lượng, kích thước, cân nặng) thay cho một dòng nội dung chung. Tắt thì vận đơn vẫn có tên hàng trong ô nội dung hàng hoá. Gói Hàng nặng luôn gửi danh sách sản phẩm, bật hay tắt ô này đều vậy.
- Khai giá hàng hoá — khai giá trị hàng để được GHN đền khi mất, hỏng. Không tích: đơn COD vẫn khai giá bằng tiền hàng, đơn đã thanh toán trước khai giá 0. Tích: mọi đơn đều khai giá, kể cả đơn chuyển khoản.
- Loại phí ship — "Hiện dịch vụ rẻ tiền nhất" (mặc định) chỉ đưa cho khách một dòng có phí thấp hơn; "Hiện cả 2 dịch vụ hàng nặng - hàng nhẹ" hiện mọi gói GHN trả về để khách tự chọn.
- Có hàng nặng? — chỉ có tác dụng khi trang thanh toán dùng địa chỉ 3 cấp: bật thì ô Phường/Xã thành bắt buộc và plugin chờ khách chọn Phường/Xã rồi mới tính phí. Ô này không lọc gói cước, và ở chế độ 2 cấp thì không đổi gì.
Bấm Lưu thay đổi ở cuối trang.
Theo ghn.vn (tháng 10/2026), giá trị khai báo tới 1.000.000đ thì GHN không thu phí khai giá; trên mức đó GHN thu 0,5% giá trị khai báo. Đơn COD đã tự khai giá theo tiền hàng. Tích ô này cho mọi đơn nghĩa là cả đơn đã chuyển khoản cũng gánh thêm khoản đó. Phí khai giá cộng thẳng vào phí ship khách thấy ở trang thanh toán; khách đổi hình thức thanh toán thì phí được tính lại.
Debug: dùng thế nào cho an toàn
Bật Debug xong, plugin ghi mọi lần gọi API vào ghn_log.txt — liên kết mở file nằm ngay dưới ô tích. Trong đó có cả dữ liệu gửi đi lẫn câu trả lời của GHN. Khi tạo vận đơn báo lỗi mà thông báo trên màn hình quá ngắn gọn, đây là chỗ biết GHN thật sự nói gì.
Mỗi lần ghi, log lưu cả Token Key của bạn, dữ liệu đơn gửi đi (họ tên, số điện thoại, địa chỉ khách khi tạo vận đơn) và IP người thao tác. File nằm trong thư mục plugin, ai biết đường dẫn là mở được; có token là tạo và huỷ được vận đơn trên tài khoản GHN của bạn.
Chỉ bật Debug khi cần, làm lại đúng thao tác lỗi, đọc xong là tắt. Tắt Debug rồi bấm Lưu thay đổi ngay sau đó: mỗi lần tab Cài đặt GHN được lưu với thay đổi, plugin xoá file ghn_log.txt.
Không gửi nguyên file log cho ai, kể cả khi nhờ hỗ trợ. Chỉ chép đoạn báo lỗi của GHN, xoá dòng chứa Token và thông tin khách trước khi gửi.
Kể cả khi Debug tắt, plugin vẫn ghi vào file này khi đồng bộ kho bị lỗi (câu trả lời lỗi của GHN và IP, không có token). Thấy file ghn_log.txt còn nằm trong thư mục wp-content/plugins/devvn-woo-ghn/ mà bạn không cần nữa thì xoá nó qua trình quản lý file của hosting.
Cách kiểm tra đã đúng chưa
- Thêm một sản phẩm có khai khối lượng vào giỏ, vào trang thanh toán, chọn địa chỉ đầy đủ.
- Chọn "Hiện dịch vụ rẻ tiền nhất" thì khách thấy một dòng phí; chọn "Hiện cả 2 dịch vụ" thì thấy mọi gói GHN trả về cho tuyến đó.
- Đổi hình thức thanh toán giữa COD và chuyển khoản — phí có thể đổi vì phần khai giá đổi theo.
- Cần xem GHN trả lời gì: bật Debug, làm lại thao tác, đọc
ghn_log.txt, rồi tắt Debug và lưu lại ngay.
Lỗi thường gặp
| Hiện tượng | Cách xử lý |
|---|---|
| Hàng nặng không hiện phí ship | Kiểm khối lượng, kích thước sản phẩm (theo tài liệu GHN: tối đa 50 kg, mỗi chiều tối đa 200 cm). Ở chế độ 3 cấp có bật Có hàng nặng? thì khách phải chọn cả Phường/Xã mới thấy phí. |
| Khách chỉ thấy một dịch vụ dù muốn nhiều | Đang để "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ẹ". |
| Phí đơn chuyển khoản cao hơn dự kiến | Đang tích Khai giá hàng hoá cho mọi đơn. Bỏ tích để chỉ đơn COD khai giá. |
| Muốn vận đơn liệt kê từng sản phẩm | Bật Danh sách sp trong đơn hàng. Tắt thì vận đơn vẫn có tên hàng, chỉ gộp thành một dòng nội dung. |
File ghn_log.txt phình to hoặc vẫn còn sau khi gỡ lỗi | Debug chưa tắt, hoặc tắt mà chưa lưu. Tắt Debug, bấm Lưu thay đổi để plugin xoá file. |
Tiếp theo: cấu hình trang thanh toán.