Giao Hàng Nhanh (GHN) cho WooCommerce
Plugin nối website WooCommerce của bạn với GHN. Khách thấy phí ship GHN lúc đặt hàng, bạn tạo vận đơn ngay trong trang đơn hàng (hoặc tự động, nếu mua thêm addon), in phiếu theo mẫu GHN, và trạng thái huỷ hay giao xong tự về website. Trang này là lộ trình từ lúc mới cài cho tới khi chạy đều.
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.
Plugin làm được những gì
- Tính phí ship GHN ở trang thanh toán — khách chọn địa chỉ, plugin hỏi GHN rồi hiện phí theo gói Hàng nhẹ / Hàng nặng. Chọn được hiện một gói rẻ hơn hay hiện mọi gói GHN trả về. GHN không trả được giá thì hiện dòng "Phí vận chuyển sẽ báo sau." để khách vẫn đặt được hàng.
- Tạo vận đơn ngay trong đơn hàng — nút Tạo vận đơn GHN có ở trang sửa đơn và ngay trong danh sách đơn. Hộp thoại điền sẵn địa chỉ, khối lượng, tiền thu hộ, kho và gói cước; bạn sửa được trước khi gửi.
- Huỷ và in vận đơn — huỷ vận đơn bên GHN bằng một nút; in phiếu theo mẫu GHN ở khổ A5, 52 x 70 mm hoặc 80 x 80 mm (hai khổ nhỏ cho máy in nhiệt), in từng đơn.
- Đăng đơn tự động và hàng loạt — addon mua thêm, không có sẵn trong plugin chính (xem addon). Đơn tới mốc bạn chọn thì tự đẩy sang GHN, hoặc tích nhiều đơn rồi đăng một lượt. Xem bài đăng đơn tự động.
- Nhiều cửa hàng/kho — đồng bộ danh sách kho từ tài khoản GHN, chọn kho chính và chia khu vực bán hàng (theo tỉnh) cho từng kho. Thêm hay sửa kho thì làm trên khachhang.ghn.vn rồi đồng bộ lại.
- Trạng thái tự cập nhật qua webhook — gửi Webhook URL của website cho GHN khai. GHN huỷ vận đơn thì đơn chuyển Đã huỷ, giao xong thì chuyển Hoàn thành; các trạng thái khác hiện trong ô GHN của đơn. Xem bài webhook.
- Email báo mã và trang tra cứu — khách nhận email có mã vận đơn (bật trong cài đặt, mặc định tắt) và tự xem hành trình trên website bạn, ở trang tra cứu hoặc trong Tài khoản → Đơn hàng.
- Trường địa chỉ tiếng Việt — mặc định khi mới cài là dữ liệu 3 cấp cũ (Tỉnh → Quận/Huyện → Phường/Xã). Muốn 2 cấp Tỉnh/Thành → Phường/Xã sau sáp nhập thì vào tab Cài đặt chung, khối Công cụ, chọn "Mới nhất" rồi bấm Cập nhật database.
Đang cân nhắc giữa nền tảng có sẵn, tự code API hay dùng plugin? Xem bài 3 cách kết nối GHN với website.
Cần chuẩn bị gì
- WordPress đã cài WooCommerce 5.6 trở lên (plugin đã kiểm tới WooCommerce 10.9.4, có hỗ trợ HPOS — màn hình đơn hàng mới).
- Hosting chạy PHP 7.2 – 8.x và đã bật ionCube Loader. Thiếu ionCube thì plugin chỉ hiện thông báo lỗi và không chạy.
- Tài khoản GHN tại khachhang.ghn.vn — nơi lấy Token API (plugin gọi là Token Key).
- Một cửa hàng/kho trở lên đã khai trên tài khoản GHN.
- Sản phẩm có khối lượng (và kích thước nếu hàng cồng kềnh) — không có thì GHN không tính được cước.
- Mã License plugin đã mua tại levantoan.com.
Plugin hiện sẵn một bảng lưu ý ngay đầu trang cấu hình, và nó không phải cho vui: đơn vị khối lượng phải là gram, kích thước phải là cm, cửa hàng phải khai Quốc gia/Thành phố ở Việt Nam, và địa chỉ khách mặc định để là địa chỉ cửa hàng. Sai một trong bốn thì phí ship lệch hoặc không tính được. Xem bài cài đặt.
Lộ trình 8 bước
Năm bước đầu là bắt buộc, làm xong là bán hàng được. Các bước sau bật dần tuỳ nhu cầu.
Kiểm tra ionCube, tải zip, kích hoạt và làm theo bảng lưu ý.
Chưa kích hoạt thì không có phí ship GHN và không tạo được vận đơn.
Chọn môi trường và dán Token Key.
Đồng bộ kho từ GHN, chọn kho chính, chia khu vực.
Loại phí ship, khai giá, hàng nặng.
Đẩy đơn sang GHN, in phiếu A5 hoặc khổ máy in nhiệt.
Để đơn tự chuyển Đã huỷ / Hoàn thành theo GHN.
Addon mua thêm. Không phải bấm tay từng đơn nữa.
Các tab cấu hình
Toàn bộ nằm ở WooCommerce → Cài đặt GHN, thanh tab ngang trên đầu trang:
| Tab | Lo việc gì |
|---|---|
| Cài đặt chung | Trường địa chỉ tiếng Việt ở trang thanh toán. Đây là module dùng chung của mọi plugin vận chuyển DevVN — sửa ở đâu cũng ra cùng kết quả. |
| Cài đặt GHN | Môi trường, Token Key, ghi chú bắt buộc, tuỳ chọn vận đơn, trang tracking và email báo mã. |
| Cửa hàng/Kho | Đồng bộ kho từ GHN, kho chính và khu vực bán hàng. |
| Cập nhật trạng thái tự động | Webhook URL để GHN báo trạng thái về website. |
| Cài đặt đăng đơn tự động/hàng loạt | Chỉ hiện khi đã cài addon đăng đơn tự động (mua thêm). |
| License | Mã bản quyền. |
Được. Các plugin vận chuyển DevVN được thiết kế để cài chung trên một website — GHTK, SPX, ViettelPost, VNPost đều dùng chung một module trang thanh toán, bản nào nạp trước thì 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à đủ.
Bắt đầu từ Cài đặt plugin.